安装hugo
建议到如下链接下载对应文件,使用go get挺慢的。
https://github.com/gohugoio/hugo/releases
- 安装hugo
- 生成site并且clone 对应皮肤的Git
- 调试 :hugo server --theme=hyde --buildDrafts
- 打开http://localhost:1313 实时调试
- 生成部署:hugo --theme=hyde
- 上传到git :git push -u origin master
实例皮肤:redlougue
hugo链接:
https://github.com/tmaiaroto/hugo-redlounge
路径解释
-
config.toml
站点全局的参数配置文件 -
archetypes
Hugo的markdown文件中前置数据Front Matter定义的结构,默认使用的是default.md文件,可以自定义,然后在config.toml中指定自定义的结构文件,打开default.md文件。
至于喜欢哪种格式,可以在config.toml中进行配置,默认使用的是yaml格式。通过执行hugo new 命令生成的markdown文件,头部默认会有这段渲染之后的Front Matter,一般我们会把draft属性去掉,draft草稿的意思,有这个属性的md文件不会渲染输出, 当然通过hugo –buildDrafts可以强制输出。 -
content
存放网页内容的目录,即我们编写的markdown文件都存放在此目录,此目录是Hugo的默认源目录,在E:/website/second-blog下执行命令 hugo new post/hugo_introduce.md之后, 则会在content目录下生成子目录post,post中有一个hugo_introduce.md文件。 -
data
data目录用来存放数据文件,一般是json文件,Hugo提供了相关命令可以从data目录下读取相关的文件数据,然后渲染到HTML页面中,将业务数据与模板分离。 -
layouts
存放自定义的模板文件,Hugo优先使用layouts目录下的模板,未发现再去themes目录下查找。 -
static
存放静态文件,比如css、js、img等文件目录,Hugo在渲染时,会直接将static目录下的文件直接复制到public目录下,不会做任何渲染。 -
themes
存放网站主题,可以下载多个主题,themes目录下的每个子目录代表了一个主题,可以通过在config.toml中通过参数theme指定主题,即theme目录下的子目录名字, 也可以在执行hugo命令渲染时通过增加flag参数–theme=xx指定。
添加代码高亮
ZIP工具包路径:https://highlightjs.org/
工具包目录
▸ styles/
CHANGES.MD
highlight.pack.js
LICENSE
README.md
README.ru.md
styles目录下有很多不同类型的高亮方式,都是css文件。
接下来把highlight.js
文件放到site/themes/hyde/static/js/
目录下,没有目录自己建;
把需要的哪种风格的css文件放到site/themes/hyde/static/css
目录下。
接着在site/themes/hyde/layouts/partials/head.html
文件中插入如下内容:
<!-- Highlight.js and css -->
<script src="{
{ .Site.BaseURL }}js/highlight.pack.js">
</script><link rel="stylesheet" href="{
{ .Site.BaseURL }}css/monokai.css">
<script>hljs.initHighlightingOnLoad();</script>
因为个人比较喜欢monokai风格,所以用了monokai.css,相应的要把monokai.css复制到刚刚说的css目录下,你也可以根据自己的喜好选择其他的风格。
当你再次调试站点查看时如果内容中有代码可以发现代码已经被着色,更加清楚明了。
修改字体
进入 hugo-redlounge/static/css 文件夹,用编辑器打开 theme.css 文件
编辑如下代码中的 font-family 值,将需要的字体替换
body
{
background-color: #fff;
font-family: "Hannotate SC", Meiryo, sans-serif;
/*font-family: "Hiragino Kaku Gothic ProN", Meiryo, sans-serif;*/
font-size: 14px;
color: #666;
line-height: 1.6em;
letter-spacing: 0.5px;
}
字体对照表->中英文字体名称对照
添加国内社交账号
进入 angels-ladder/layouts/partials/文件夹,用编辑器打开header.html文件
编辑如下代码中的 ul 内的内容;
另外 Site.Params.xx 需要在 hugo 网站根目录中的 config.toml 文件中定义
<header role="banner">
<div class="row gutters">
<div id="site-title" class="col span_6">