用hugo建博客的记录 · 老张不服老

Posted 2021-03-13 lijianming180

前后累计折腾近6个小时，总算把搭建hugo静态博客的整个过程搞清楚了。为什么用了这么久？主要还是想偷懒，不喜欢读英文说明。那就用中文记录一下过程吧。还是中文顺眼啊。

某日发现自己有展示些东西给外网的需求，又不想通过DDNS在本地电脑上架设服务器，于是决定建一个免费网站。以前帮朋友们建过几个免费网站，知道免费空间大多有种限制或者要有广告。但我只需要展示一两个静态网页就足够，为此还要接受广告心里不爽。在各种搜索下，终于确定github page就是最合适的方案。

不想自己手动逐项设置，打算找一个工具。大部分静态博客生成器都需要依赖环境，唯有hugo只需要一个可执行文件就够，深得我心，况且据说它的性能远超侪辈，得，就它了。现在开始！

必须步骤

下载与安装

对hugo来说，这几乎不需要任何说明。下载到的是一个exe单文件，不需要安装，随便扔到哪个目录下就可以运行。为了不用每次都输入绝对路径，最好把它添加到系统环境路径PATH中。 下载页面

选择或创建放置博客的目录

Windows 命令行下使用 mkdir 目录名 。
当然也可以在窗口中创建。但既然 hugo 是命令行程序，索性都在命令行下完成。

创建博客目录结构

最好先切换 大专栏  用hugo建博客的记录 · 老张不服老到创建的目录下。

    cd 目录名
    hugo new site 目录名

下载皮肤模板

通常是使用 git 下载皮肤模板，但其实也可以直接下载后解压到相应的目录。 这里可以查看一些皮肤模板。

使用 git 下载全部皮肤模板。不易成功，最好选择其中一个皮肤模板下载。

    git clone --recursive https://github.com/spf13/hugoThemes themes

设置皮肤模板

大概看了一下其他皮肤模板，几乎所有皮肤模板都是复制皮肤模板下的配置文件覆盖到根目录下就可以使用了。有个别皮肤模板的具体细节要对照皮肤模板的说明。

新建一篇博客

新建文件的命令默认会将文件放到 content 文件夹下。一般使用 content 文件夹下的 post 文件夹放置要发表的博客。hugo 称这样的文件夹为 section 。

    hugo new posthelloWorld.md

使用自己喜爱的编辑器编辑此文件即可。可以使用预览功能实时查看格式。运行下面的命令即可在 http://localhost:1313 预览。

    hugo server

生成页面

前面虽然已经可以预览，但并未生成相关网页。要发布前必须先生成一下。生成的网站放在 public 目录下。直接运行 hugo 即可生成。速度飞快。

同步到托管网站