教程

Hugo

hugo是由Go语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署。主要用于个人Blog、项目文档、初创公司站点构建。 1、结构 命令：hugo new site blog blog ├── archetypes ├── config.toml ├── content ├── data ├── layouts ├── static ├── themes └── public archetypes 在通过hugo new xxx 创建内容页面的时候，默认情况下hugo会创建date、title等front matter，可以通过在archetypes目录下创建文件，设置自定义的front matter。 config.toml 所有的hugo站点都有一个全局配置文件，用来配置整个站点的信息，hugo默认提供了跟多配置指令。 content 站点下所有的内容页面，也就是我们创建的md文件都在这个content目录下面。 data data目录用来存储网站用到一些配置、数据文件。文件类型可以是yaml|toml|json等格式。 layouts 存放用来渲染content目录下面内容的模版文件，模版.html格式结尾，layouts可以同时存储在项目目录和themes//layouts目录下。layouts目录格式如下： layouts ├── _default ├── partials ├── shortcodes ├── taxonomy └── section section指的是content目录下面的section，如果在layouts目录下设置了section，会优先选择section下面的模版。 static 用来存储图片、css、js等静态资源文件。 themes 用来存储主题，主题可以方便的帮助我们快速建立站点，也可以方便的切换网站的风格样式。 public hugo编译后生成网站的所有文件都存储在这里面，把这个目录放到任意web服务器就可以发布网站成功。 2、内容 Page Bundles hugo中的内容组织是依赖Page Bundles来管理的。Page Bundles包括Leaf Bundle（没有子节点）和Branch Bundle（home page, section, taxonomy terms, taxonomy list）两类。

Docdock

文档类主题模版 主题特性 支持搜索 无限级菜单 嵌入式页面全屏（Reveal Js） 支持附件文件 显示子页面 可以在其他页面引用当前页面的一部分内容 自动支持上一页、下一页面 图表绘制 提供图标、按钮、提示、通知、面板等多种工具 图片缩放、阴影显示 可自定制外观 page front matter title = "Test page" description = "" date = "2017-04-24T18:36:24+02:00" creatordisplayname = "Valere JEANTET" creatoremail = "valere.jeantet@gmail.com" lastmodifierdisplayname = "Valere JEANTET" lastmodifieremail = "valere.jeantet@gmail.com" tags = ["tag1","tag2"] categories = ["cat1","cat2"] weight = 90 title：首字母必须大写，页面才会在目录结构中显示； weight：表示页面在当前目录的显示顺序，数字越小显示越靠前 date：当前页面的更新时间 pre：菜单图标，pre ="<i class='fa fa-vcard-o' ></i> " tags: 标签，由hugo默认提供 categories:分类，由hugo默认提供