Skip to content

content-guide.md

Latest commit

 

History

History
83 lines (62 loc) · 2.55 KB

content-guide.md

File metadata and controls

83 lines (62 loc) · 2.55 KB
Raw

内容管理指南

本站除主页外的所有内容都是用 Markdown 格式文档编写，然后由 Hugo 渲染出 HTML 页面。所有的 Markdown 内容都保存在 content 目录下。

Markdown规则与翻译规范参考Markdown 语法规范。

默认模板

创建博客的默认模版位于 archetypes/default.md。

title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
banner: "https://ws1.sinaimg.cn/large/00704eQkgy1frk001fkixj30rs0ku4qp.jpg"
author: "N/A"
authorlink: ""
translator: ""
translatorlink: ""
reviewer: [""]
reviewerlink: ""
summary: "文章摘要。"
tags: [""]
categories: [""]
keywords: [""]

其中包含了博客文章的一些元数据。

  • title：文章标题，中文和英文间不加空格，中文的破折号用—，即减少一横
  • date：博客文章创建时间，hugo new命令自动生成，默认最新生成的文章将优先显示
  • draft：是否是草稿，设置为 false 才会发布出去，默认是 true
  • banner：“最新文章”一栏下的博客横幅，1000*750像素
  • author：文章作者
  • authorlink：原文链接或者作者的个人链接地址
  • translator：译者名字，若为翻译的文章可以不填
  • translatorlink：译者的链接
  • reviewer：审校者，可以是多个
  • reviewerlink：审校者的链接，可以是多个，与 reviewer 的顺序相同
  • summary：文章摘要，会在“最新文章”一栏显示
  • tags：标签，可以写多个
  • categories：分类，可以写多个，页面上显示第一个，一般写一个就行
  • keywords: 关键字

下图是以上元数据对应的单个博客页面上的地方。

注意：页面右侧的“分类”和“标签“显示的是所有博客的，而非当前博客页面的”分类“和”标签“。

创建新的博客

如果需要创建新的博客，只需要运行下面的命令：

mkdir content/blog/new-blog/
touch content/blog/new-blog/index.md

打开 Markdown 文件，修改文档的元数据，然后就可以欢快的编辑内容了。

创建新的 tab 页面

使用下面的命令创建新的 tab 页面：

hugo new new-tab.md

新的页面文件位于 content/new-tab.md。

在 config.toml 中增加一个 tab 配置：

[[menu.main]]
    name = "新的页面"
    url = "/new-tab/"
    weight = 6
  • name：tab 显示在主页上的名称
  • url：对应于新的 tab 页面的文件名
  • weight：在主页上的排列顺序