https://docs.njet.org.cn/contrib/v1.0/compose/index.html 创建文档 Caution 创建文档需要利用hugo 命令创建md文件，以增加必要的front matter信息 hugo new content "xxxx.md" 或 hugo new content "{sec}/xxxx.md" 前者在content下创建，后者在content/sec下创建 Caution 1 创建文档后，如果hugo serve不渲染出来，则可能是frontmatter中的draft = true， 默认hugo 是不会渲染草稿的 2 创建文档时，用英文名称 编写内容 编写内容使用markdown语法及扩展，相信格式需参考：relearning markdown 语法参考 Hugo zh https://docs.njet.org.cn/contrib/v1.0/compose/pictures/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://docs.njet.org.cn/contrib/v1.0/compose/pictures/index.html Caution 创建文档时尽量不要粘帖图片，而是以codeblock的形式显示执行的命令，结果。 图表、架构图可以mermaid代码块，实现自动渲染出图片 通过相对路径使用文档仓库中的文件 图片存储 图片应该存储到使用它的md文档相同的目录 v1/content/compse picture.md picture njet-logo.png 如上图所显示，picture.md中如使用njet-logo.png,则需要创建该md文件同名的目录，如上面的/picture，把图片放大该目录 图片引用 使用标准的md语法  njet logo: leafbundle的文档 图片文件可以直接存储在和index.md相同的目录下 https://docs.njet.org.cn/contrib/v1.0/compose/attach/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://docs.njet.org.cn/contrib/v1.0/compose/attach/index.html 可以在编写的md文件中嵌入附件链接，从而在产生的页面中提供下载 文档创建 如果一个文档包括附件下载，则不应创建独立的md文件，而是创建为leafbundle hugo new content compose/attach/index.md 该方式要描述的文档为一个目录，可下载的附件存放到该目录中，如下图 content/compose attach index.md njet-logo.png 通过在md文件中增加下面的短代码，可以直接输出附件列表 {{% resources sort="asc" %}} 更相信的附件控制，参考https://mcshelby.github.io/hugo-theme-relearn/shortcodes/resources/index.html Attachments njet-logo.png (19 KB)