博客生成工具 Hugo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

wget https://github.com/gohugoio/hugo/releases/download/v0.92.0/hugo_extended_0.92.0_Linux-64bit.tar.gz  #在命令窗口直接下载hugo(下载建议的extended版本)  
tar -xzvf hugo_extended_0.92.0_Linux-64bit.tar.gz  #解压到当前文件夹
sudo mv hugo /usr/local/bin/ #将hugo移到本地应用程序目录  
sudo gedit /etc/profile      #编辑系统环境变量,在文件最后加入内容：export PATH=$PATH:/usr/local/bin (备注:实际是系统默认路径,可以不加) 
source /etc/profile          #使能系统环境变量。  
hugo version                 #查看版本,验证安装是否成功  
  
#不需要安装go,忽略下面两行内容
#sudo apt install golang-go  #安装go  
#go version                  #查看版本,验证安装是否成功  

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

########建网站########
hugo new site mysite        #新建名为“mysite”的网站  
cd mysite                   #进入网站“mysite”根目录  
                            #下载官方(Casper)主题到./themes/，并且重命名为:casper  
git clone https://github.com/vjeantet/hugo-theme-casper.git themes/casper  

########加博文########
hugo new post/first.md      #新建一篇文章（实际目录在:./content/post/）  
                            #使用Markdown语法随便添加几行内容（用于展示）  

hugo server -t casper -D    #指定主题“casper”编译并启动服务器（-t 因为配置文件没绑定主题,所以这里需要指定）（-D 表示草稿也编译）  
                            #根据提示用浏览器打开网址预览网站：http://localhost:1313/  

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

#########建站#########
hugo new site mywebsite     #新建网站:“mywebsite”
cd mywebsite                #进入网站根目录
git init                    #初始化网站根仓库。把主题(LoveIt)(v0.2.10)添加到子仓库：
git submodule add https://github.com/dillonzq/LoveIt.git themes/LoveIt

#########配置##########
#(1)                        #复制作者提供的示例：将 mywebsite/themes/LoveIt/exampleSite/ 里面的文件(夹)全复制到 mywebsite/ 根目录下
#(2)                        #删除编译异常文件夹：删 mywebsite/content/posts/theme-documentation-built-in-shortcodes 文件夹；
#(3)                        #再执行下面相关指令：
gedit ./config.toml         #打开文件编辑，将里面的 themesDir = "../.." 修改为 themesDir = "themes/"
                            #　　　　　　　　　以及 enableGitInfo = true  改为 enableGitInfo = false
hugo server                 #编译并启动服务器（如果要在本地使能评论系统则修改代码和改用下行命令───────┐
#hugo serve -e production   #编译并启动服务器←(先参考:https://lewky.cn/posts/hugo-4.html/)────┘）

#########补充##########
#取消多国语言只保留中文：
#(1)                        #修改配置：
gedit ./config.toml         #打开文件编辑，将里面的 defaultContentLanguage = "en" 修改为 defaultContentLanguage = "zh-cn"
                            #　　　　　　　以及屏蔽 [languages.en] 和 [languages.fr] 各约200行的非中文语言菜单配置
#(2)                        #屏蔽文件：
                            #将 mywebsite/content 目录下所有文件名为 index.en.md 改为 #index.en.md （注：实际是要删除文件(夹)的，只因为目前还需要作为参考之用）
                            #将 mywebsite/content 目录下所有文件名为 index.fr.md 改为 #index.fr.md （注：实际是要删除文件(夹)的，只因为目前还需要作为参考之用）
#(3)                        #重新编译：
hugo server                 #重新编译并启动服务器
                            #此时即可根据提示用浏览器打开网址预览网站：http://localhost:1313/

1
2
3
4
5

########加博文########
mkdir content/posts/test                   #创建博文专题文件夹（必须含有主页《例如中文为:index.zh-cn.md》，否则不支持文章封面）
hugo new content/posts/test/index.zh-cn.md #在网站根目录运行命令添加博文主页（主页文件名称须固定,不能其它，否则不支持文章封面）
                                           #也可不用建文件夹直接在 content/posts/ 目录下创建博文(如：xxxx.zh-cn.md 文件)，但不支持多语言及文章封面
                                           #实际上直接创建md文件并编写即可，无须`hugo new`命令创建，文件头信息则要按标准写。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

---
weight: 1
hiddenFromHomePage: false
title: "第一篇文章主题"
date: 2020-03-06T21:40:32+08:00
lastmod: 2020-03-06T21:40:32+08:00
draft: false
author: "文章作者"
authorLink: "https://o2ospring.github.io"
description: "文章封面描述"
resources:
- name: "文章封面名称"
  src: "featured-image.jpg"

tags: ["文章标签/关键词-1", "文章标签/关键词-2"]
categories: ["文章分类-1", "文章分类-2(可关联多个分类)"]

lightgallery: true

toc:
  auto: false
---

### markdown 章节 1

* `weight`后面的编号表示专题主页在博客首页的排序编号
* `hiddenFromHomePage`如果设为`true`，这篇文章将不会显示到博客首页上
* `date`和`lastmod`为文章创建及修改时间
* `authorLink`文章作者主页链接
* `draft`表示草稿，发布文章必定是设置为`false`
* `src`为主题主页封面图片，在自己文件夹下且名称为`featured-image.xxx`，可以是`jpg`、`png`等图片格式
* `lightgallery`如果设为`true`，点击文章中的图片将可以按照画廊形式呈现，前提：图片在自己专题文件夹里

### markdown 章节 2

* markdown 选项 2-1
* markdown 选项 2-2

1

npm install atomic-algolia --save

1
2
3
4
5
6

{
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "algolia": "atomic-algolia"
  }
}

1
2
3
4

ALGOLIA_APP_ID=你的应用ID
ALGOLIA_INDEX_NAME=你的索引名称
ALGOLIA_INDEX_FILE=public/index.json
ALGOLIA_ADMIN_KEY=你的索引主键

1
2
3
4
5
6

hugo                         #【构建】HTML 静态网页，文件保存在"public"目录中
npm run algolia              #【上传】索引文件（public/index.json）
cd public                    #【进入】"public"目录。
git add --all                #【添加】工作区所有文件到【暂存区】
git commit --amend --no-edit #【提交】暂存区所有文件到【本地库】（更新博客且不用版本管理）
git push -f origin master    #【推送】本地仓库到【远程仓库】（强制推送，因为版本没有更新）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

######初次发布######
gedit ./config.toml          #【修改博客网址】打开文件编辑，将里面的 baseURL = "https://example.com" 改为你的博客网址 baseURL = "https://o2ospring.github.io"
hugo                         #【构建】HTML 静态网页，文件保存在"public"目录中（强烈建议：删除除了仓库[.git、.gitignore、README.md]外的所有文件，再运行构建）
cd public                    #【进入】"public"目录，为建git本地仓库准备
git init                     #【创建+初始化】Git本地仓库
git add .                    #【添加】工作区所有文件到【暂存区】
git commit -m "first commit" #【提交】暂存区所有文件到【本地库】
                             #【关联】github远程仓库(使用HTTP协议方式)(使用仓库默认名称:origin)
git remote add origin https://github.com/o2ospring/o2ospring.github.io.git
git push -u origin master    #【推送】本地仓库到【远程仓库】(仓库默认名称:origin)（之后提示输入仓库托管网站账号和token密码）
                             # -u 刚创建这个远程仓库时首次push才加此选项。
######之后发布######
hugo                         #【构建】HTML 静态网页，文件保存在"public"目录中（强烈建议：删除除了仓库[.git、.gitignore、README.md]外的所有文件，再运行构建，
cd public                    #【进入】"public"目录。                           因为构建只会增加覆盖文件，之前的垃圾文件不会删除，发布会多出一些未知文件或文章）
git add .                    #【添加】工作区所有文件到【暂存区】
git commit --amend --no-edit #【提交】暂存区所有文件到【本地库】（更新博客且不用版本管理）
git push -f origin master    #【推送】本地仓库到【远程仓库】（强制推送，因为版本没有更新）