Photo by Lee Campbell / Unsplash

技术分享 - Vol.02:在macOS下使用hugo制作导航站

Tech 2023年2月23日

最近想做一个导航站,发现一个不错的开源项目WebStack

并且有各种衍生的版本,因为要考虑SEO,所以选择了使用hugo来部署,这里要非常感谢shenweiyan 大神,他制作并开源了hugo版的WebStack导航,并贴心地在语雀分享了安装过程。链接如下:

https://www.yuque.com/shenweiyan/cookbook/webstack-hugo

在这里我简单记录一下在macOS平台上进行安装和打包的流程,便于有相似需求的小伙伴可以参考。

0 准备

确保你的mac上有git和brew,这里暂不做过多介绍

1 安装hugo

终端内输入:
brew install hugo

待安装成功后,在终端输入:
hugo version

如果有类似这样的输出,则说明已经安装成功:
hugo v0.101.0+extended darwin/arm64 BuildDate=unknown

2 创建新站点目录

在终端里cd到你的开发目录,如developer 文件夹、workspace文件夹等,
输入:
hugo new site YOURBLOGNAME

其中YOURBLOGNAME是自己的网站名称

然后在finder中将刚创建的这个站点文件夹打开,长这样:

3 下载hugo版的webstack

github地址: https://github.com/shenweiyan/WebStack-Hugo

可以直接download zip,随后解压,你会得到一个“WebStack-Hugo-main”文件夹,重命名为"WebStack-Hugo",随后移动到站点文件夹的themes文件里

接着,将 themes/WebStack-Hugo/exampleSite 目录下的所有文件复制到 hugo 站点根目录

4 运行hugo server

终端定位到站点根目录下,输入:

hugo server

如果看到"Web Server is available at...",则表示此时hugo服务启动成功。打开对应的本地地址,则可在浏览器上进行预览。

此时你可以对站点内容进行修改,hugo server会检测变化并且热更新。

5 打包生成静态内容,用于部署

可以通过下面的命令,生成(构建)静态页面内容。

hugo -D 或者 hugo --minify

这个命令会默认在docs/ 目录中生成您的网站,当然您可以通过改变站点配置中的publishDir 选项来配置这个输出目录。

随后把生成的 docs/ 静态内容目录上传到 GitHub,开启 GitHub/Gitee Pages,并且绑定 cname 域名即可。这部分暂时不作详细介绍。

Tags

leitures

坐标南京,缺offer,求前端大佬收留。 微信号: leitures