![018c875e4a493c7cc3e479d513e7b93f.png](https://img-blog.csdnimg.cn/img_convert/018c875e4a493c7cc3e479d513e7b93f.png)
Hugo logo
安装 hugo
安装 hugo 最通用的方法是到 github hugo-release 下载编译好的二进制文件,下载完后解压即可使用。hugo 首页。
在 Linux 系统中,可以将 hugo 二进制文件拷贝到 /usr/local/bin/文件夹下,这样就可以在命令行中直接运行 hugo。
在 Windows 系统中,可以将 hugo 二进制文件的路径添加到 PATH 环境遍历中。
运行 hugo
只需几步就可以让博客跑起来。
第一步,创建新的网站,hugo new site projectName。运行完后,就会在当前目录中新建一个文件夹 projectName,里面又包含多个文件夹,常用的有以下几个。
- content:包含待渲染的文件,比如会将 Markdown 文件放入 post 文件夹中
- static:存储 Markdown 或其他文件中包含的静态文件,比如图片等
- themes:存储主题的文件夹,会把网上的主题下载到该文件夹里
- archetypes:包含多个文件模板,比如 Markdown 文件头部包含一些配置项
第二步,下载主题并修改配置文件。
- 先在 hugo 主题网站上找一个中意的主题,我们以 aether 为例。先进入 themes 文件夹中,然后运行 git clone https://github.com/josephhutch/aether.git,可以把主题文件夹名称修改为 aether,方便配置。
- 之后,打开项目文件夹 projectName 下的 config.toml 文件,在文件末尾添加一行:theme = "aether"。更详细的配置选项可以查看主题的主页或者 hugo 的文档(有些功能复杂点的主题还需要配置其他选项才能正常跑起来)
第三步,新建文件。
- 首先,进入到项目文件夹 projectName 里,然后运行 hugo new post/filename.md。hugo 就会根据 aether 主题中的archetypes文件夹里的模板新建一个 Markdown 文件,文件存在 content/post/ 目录下。
- 需要打开 filename.md 文件,把文件头部的 draft 设置为 false,这样 hugo 才会渲染。
第四步,跑起来。
- 进入项目文件夹,运行 hugo server,hugo 的 Web 服务器就跑起来了。
- 接下来,根据命令行输出的提示,在浏览器中输入 http://localhost:1313/ 就可以查看了。
生成静态网页
hugo 更常用于生成静态网页,生成的内容可以直接放到 tomcat 项目中。
在项目文件夹下,直接运行 hugo。我没打错,就是直接运行命令,不用任何参数。hugo 就会把生成的静态网页和依赖的文件打包到项目文件夹下的 public 文件夹中。你就可以把 public 文件夹拷到 tomcat 的 webapps 文件夹下。