自己闲来无事记录和分享下下生活,通常用blog。搭建blog常见的wordpress基于php,皮肤好看配置也多。但是购入云服务太贵了,自己的服务器还有随时被刷的可能不好维护。那为啥不尝试下github.io 和 hugo ? 静态界面,而且仓库托管方便维护。
什么是 hugo ?
他是一个基于go语言开发的,可以编写文档的模板翻译软件,通常搭配模板主题使用。可以把你markdown 文件,按照需要生成静态html文件。在javascript 中经常有这样的软件 ,比如webpack算一种吗?不太懂。但是hugo也不要你知道它是如何运行,你只要按照配置和规划放置文件位置即可 。Hugo项目地址 上面有对其的详细介绍。
安装hugo
这里我使用scoop安装。还没有用上好用scoop软件管理工具,我建议先看我的以前教程 Scoop搭建来快速安装hugo。也可以在github的发行中下载二进制文件。
scoop search hugo
scoop install hugo-extended
我们这里安装hugo扩展。这样可以支持功能更广。有些hugo的主题框架要求安装hugo-extended
图片展示

找一个hugo主题
你可以在Hugo官网中可以找到相应主题。如下图:

比如我使用的主题 : paperMod 。在github上也可找到相应的开源仓库。 paperMod仓库地址
我们来到PaperMod 开源仓库的主页,我们可以看到它的Demo和样例站点文件,他会教会我们如何快速搭建。
图示:

搭建hugo主题站点
到这一步,我认为你已经基本阅读完了paperMod的Demo中示例文章和markdown语法。
我们先克隆下hugo的exampleSite 。在themes的文件夹中包含其他的项目模块。所以我们使用–recursive克隆全部模块。
git clone --recursive -b exampleSite https://github.com/adityatelange/hugo-PaperMod.git
我们删除这里的.git和.github 文件。用vscode打开。并删除post下的内容。

然后删除post中的内容,因为有可能会有大陆访问不了的资源链接导致构建失败。我们在终端运行:
hugo server
这样你就有了一个博客模板了。

撰写markdown并生成静态文件
我们先在vscode中安装辅助编辑的插件,注意这个插件会和通常写html:5冲突,如果你在用vscode编辑html:5页面。我建议先关闭hugo language插件。

在post中建立一个文件夹做为一篇博客的工作目录,接下来就和你平常的记录markdown文件一样了,比如目前我的博客的结构。

其中index.xx.md表示国际化在那个界面。如果全语言界面显示就用index.md。当然你的config.yml中也要配置好国际化。相信你在papermod的项目主页介绍中已经学会了。这里简单展示我的yaml配置:

好了,现在我们就用
hugo
来生成静态文件,生成的文件默认放在public文件夹下。

部署上github.io来展示。
前排提醒, github.io 不是图床,不是云盘,不是cdn,初心是用于项目展示和组织介绍使用。 github.io 有仓库大小和流量使用的规范。在薅羊毛时候请用持续发展的方式对待。
我们建立一个仓库,必须要是用<githubName>.github.io命令,必须选着public 公开仓库。

然后我们就可以吧文章push到这个仓库,使用<githubName>.github.com 访问。
如果还有小伙伴不熟悉git?下面是模板:
在public的文件夹中。
git init
git remote add origin xxxxxxxx
git commit -m 'xxxxx'
git push origin main/master
完成上传,或者在github网页上上传。完成效果?本网页就是哈 :P
结束语
摸鱼中!橙汁龙快来摸鱼。别卷我了。