内容格式
您可以在/content
目录中放入任何文件类型,但是如果设置了markup
的front matter值或文件扩展名(见下表中的“标记标识符”),Hugo将确定是否需要处理标记,例如:
- Markdown转换为HTML
- 处理短代码
- 应用布局
内容格式列表
Hugo当前支持的内容格式列表如下:
名称 | 标记标识符 | 注释 |
---|---|---|
Goldmark | markdown, goldmark | 请注意,您可以将md 和markdown 的默认处理程序设置为其他值,参见配置标记。 |
Emacs Org-Mode | org | 参见go-org。 |
AsciiDoc | asciidocext, adoc, ad | 需要安装Asciidoctor。 |
RST | rst | 需要安装RST。 |
Pandoc | pandoc, pdc | 需要安装Pandoc。 |
HTML | html, htm | 如果要将其视为一个包含布局、短代码等内容的文件,则必须有front matter。否则,它将被原样复制。 |
标记标识符
既可以从front matter中的markup
变量获取,也可以从文件扩展名获取。有关与标记相关的配置,请参见配置标记。
外部辅助程序
表格中的某些格式需要在您的个人计算机上安装外部辅助程序。例如,对于AsciiDoc文件,Hugo将尝试调用asciidoctor
命令。这意味着您需要在您的计算机上安装相关工具才能使用这些格式。
Hugo默认为这些外部辅助程序传递合理的默认参数:
asciidoctor
:--no-header-footer -
rst2html
:--leave-comments --initial-header-level=2
pandoc
:--mathjax
Asciidoctor
Asciidoctor社区提供了一整套用于AsciiDoc格式的工具,可以额外安装到Hugo上。请参阅Asciidoctor文档以获取安装说明。如果需要,请确保还安装了所有可选扩展,如asciidoctor-diagram
或asciidoctor-html5s
。
Hugo中可以自定义一些Asciidoctor参数。请参阅详细信息。
学习Markdown
Markdown语法足够简单,在短时间内就可以掌握。以下是一些优秀的资源,可以帮助您快速入门: