Skip to content

deepin-community/sig-dde-porting

Repository files navigation

dde 移植小组信息公示

本仓库主要用于 dde 移植的成果展示,活动记录和教程文档。

由 deepin SIG 公开模板生成。

为了方便各个小组进行小组活动的信息公示,我们使用了 HUGO 作为文章平台工具,进行博客文章的静态生成,并最终利用 GitHub Pages 呈现网页,为小组提供了一个单独的页面来展示呈现所需要公示的各种信息。故整个过程你只需按照 HUGO 的正常使用方式进行使用即可。

若未安装 HUGO,您可以从 HUGO 官方 GitHub 仓库的 Release 页面获取适用于您设备的 HUGO 版本,并放置其于 PATH 内以便调用。

安装就绪后,大致常用命令如下(在此源码仓库的根目录下执行):

$ hugo server # 启动一个本地服务器,预览目前状态下的网站内容
$ hugo new posts/my-post.md # 创建一篇新文章,以便进行编辑
$ hugo server -D # 启用本地服务器,并且能够预览状态为草稿(`draft: true`)的文章
$ hugo -D # 生成静态页面(如果需要),生成的文件将位于 public 目录下

创建文章时,创建格式为 <分类>/<文件名>.<格式>,上面给出的例子中,分类为 posts,文件名为 my-post,格式为 md (markdown)。创建文章后,默认会使用 YAML front-matter 标记文章的一些元信息,请留意 draft 草稿状态的文章最终不会显示。

若要获取 HUGO,请参考官方文档给出的安装方式

文章内容指导建议

您可以根据您小组的需求,在此博客中编写博文来分享文章,下面为文章内容方面相关的指导意见。

在发布您的文章时,建议使用标签来标记您文章所相关的主题,以便读者更方便的查阅您的文章。例如 tags: ["成果公示"]tags: ["指南文档", "CMake"]

由于绝大多数情况下,每篇文章均仅代表自己的个人观点,故也强烈建议在文章的元信息中附带作者信息,例如 authors: ["张三"](可为多人)。