github船舰新文件夹_Hugo+GitHub 搭建个人Blog

http://TecWriterWang.github.io

安装步骤如下

先下载hugo安装包，直接在github (https://github.com/gohugoio/hugo/releases) 可以下载最新的安装包。安装参考:https://gohugo.io/getting-started/

1. 下载压缩包后解压到任意目录。

2. 在你准备运行Hugo的位置新建Hugo文件夹，在新建的Hugo目录下分别新建bin文件夹和Sites文件夹，将解压后的所有文件复制到bin目录下。

3. **配置PATH路径**。将bin目路的径添加到系统变量的PATH下。设置完成后，打开cmd命令行运行下面的命令来查看是否配置好，若配置成功后则会显示hugo版本。

```cmd

hugo version

```

4. **创建新的bolg文件夹**。通过cmd命令进入Sites文件夹，使用下面的命令在Sites目录下创建一个blog文件夹。

```cmd

cd Sites文件夹位置

hugo new site filename(文件夹名)

```

5. **新建一个blog文章**。cmd先进入新建的blog文件夹中，使用下面命令创建一个md文件(使用floder/file.md 表示在post目录下新建一个file.md文件，新建的folder文件夹默认存储在新建的blog文件夹下的content文件夹内)

```cmd

hugo new floder/file.md

```

```content guide

打开file.md会看到 两条 --- 间的信息是文章的配置信息，有的信息是自动生成的 (如：title、date 等)，简单介绍以下各项配置,以下项目是自动生成的:

title: # 文章标题

date: # 写作时间

draft: # 是否为草稿，如果为 true ,则需要在cmd命令中加入 --buildDrafts 参数才会生成这个文档，改为false，就不需要以下项目需要自行添加.

description: # 描述

tags: # 标签，用于文章分类

```

6. 下载theme，theme地址链接： ，然后在hugo的github官网找到想要的theme，然后复制其链接，在cmd中先进入themes文件夹，然后使用下面命令，即可自动下载AllinOne主题。(下载完成后现将下载的主题文件夹名更改成主题名字，有些下载的主题文件夹会自动带上hugo)git clone https://github.com/orianna-zzo/AllinOne.git

```cmd

cd themes文件夹地址

git clone URL

```

7. github的pages设置，新建一个仓库命名为自己的username.github.io 并设置github pages(这一步可以使仓库直接作为网页来访问，)将生成的网址复制到config.toml文件中 的baseurl。

8. 配置config.toml文件，使用vscode打开该文件，将github生成的网址复制到(baseurl：)项目后，(theme：)填写主题文件夹名称，默认情况下会有draft，将其改为false，或者直接删除。其他属性的自行参考官网文档。(**可以直接将下载的themes中examplesite文件夹下config.toml复制到网站根目录下。**)

9. cmd进入到该blog根目录下，将主题应用到网站并且可以查看，只能在本地地址1313访问新建的.md blog。关闭hugo server后就不能继续访(必须先将新建的blog先打开设置表头，将draft设置为 false，这一步是不将blog设置为草稿)。

```cmd

cd C:HugoSitesTest-blog

hugo server -t themename

```

10. 还是在网站根目录下，cmd运行hugo，则会在blog文件夹下生成public文件夹。若想在远程也访问，只需在public文件夹下运行git bash，(参考)将public文件夹设为git本地仓库，最后再与github的对应仓库远程连接，就实现了github+hugo组成的一个个人网页blog。

11. blog目录下的config.toml，配置用于blog网页排版，涉及的内容较多需要查看文档以了解具体语法。