博客与建站

Hugo学习笔记一，初步运行一遍

安装hugo
  1. 官网地址： https://gohugo.io/
  2. github官网地址：https://github.com/gohugoio/hugo，进入后再进入release页，然后下载 linux的安装文件，安装之。
初步使用
  1. 生成hugo 博客目路并自动初始化
1
2
3
$ mkdir myblog
$ cd myblog
$ hugo new site myhugo #在当前目录下创建myweb站点目录，生成的目录结构如下：

archetypes 目录中定义了Hugo创建markdown文件的模板。
content 存放markdown文件。
data 存放数据文件。
layouts 存放模板文件。
static 存放静态文件。
themes 存放主题。
config.toml 配置文件。

  1. 下载主题，并使用之
1
2
3
4
5
6
$ cd ~/myblog/myhugo
$ git clone https://github.com/dillonzq/LoveIt.git themes/LoveIt  # 下载LoveIt主题
$ git clone https://github.com/panr/hugo-theme-terminal.git themes/terminal # 下载terminal主题
$ git clone https://github.com/wowchemy/starter-hugo-research-group themes/research-group

$ hugo server -t LoveIt  # 运行hugo，并采用LoveIt主题。这只是初步使用，可通过设置，不用在命令行来指定
  1. 采用下载的主题范例
    以 hugo-serif-theme主题为例
1
2
3
4
5
6
$ cd myblog/themes/hugo-serif-theme/ #进入主题目录
$ cp -r exampleSite ../../  # 把主题的范例目录copy到myblog目录下
$ cd ~/myblog/  # 回到myblog目录
$ mv exampleSite serif # 给范例目录改名
$ hugo server --source=serif # 指定文件的目录名进行编译
# 如果出错，修改 serif目录下的config.toml文件，把主题目录改成正确的就行
  1. 修改 ~/myblog/myhugo/config.toml文件，增加
    theme = “XXXX”,可指定默认主题
编写第一个文章
  1. 生成文档
1
$ hugo new posts/first_post.md # 在content下生成posts目录，并生成first_post.md文档
  1. 内容
1
2
3
4
5
6
7
8
9
10
---
title: "Hugo学习笔记一，初步运行一遍"
date: 2022-11-18T11:40:38+08:00
tags: ["Hugo"]
categories: ["stucy"]
toc:
  enable: true
description: 学习hugo的笔记1,初接触
draft: true
---
  1. 一些经验
    其实 hugo 在新建文章时，不一定要 hugo new posts/xxxx.md。

可以 hugo new xxxx.md，这样会在 content 目录下新建文件 xxxx.md，网站中可以通过 /xxxx 来访问。

还可以 hugo new /xxxx.md，这样会在 content 目录下的 目录下新建文件 xxxx.md（若文件夹 不存在则会自动新建），网站中可以通过 //xxxx 来访问。此时，在网站中访问 / 即可显示目录下所有文章的列表，实现文章聚合。

对于每一个 的聚合，我们可以在网站目录下的 archetypes 目录中，新建一个 .md 文件，则可创建该类聚合的模板，后续的每一次 hugo new /xxxx.md 都会以 .md 为模板。

在本地启动网站
1
$ hugo server -D --bind "0.0.0.0" # 浏览器中用http://0.0.0.0:1313/查看
部署到GitHub
  1. 在github上建立自己的仓库，比如 laoshiren，那么未来你的主页就会是laoshiren.github.io
  2. 修改 ~/myblog/myhugo/config.toml文件
    修改config.toml文件中的baseURL为https://laoshiren.github.io
  3. 执行
1
2
3
4
5
6
7
cd public
git init
git remote add origin https://github.com/GitHub账号名/laoshiren.github.io.git
#此URL可在你的repo中找到
git add .
git commit -m "updated %date%,%time%"
git push origin master