注意:
- 此IETF GitHub文稿模板主要支持MacOS/Linux,Windows目前仅支持创建此仓库和简单内容提交。
- Mac/Linux方式假设使用者有一定的git和翻墙能力。在国内使用代理和换源等有不少问题需要处理。
- Windows方式也可以免命令行实现仓库创建和内容提交, 但
make
命令行不可用。
更新:
- 2.17:增加了Windows用户和非命令行方法使用此模板创建仓库和提交简单内容的步骤
简介:
IETF标准文稿的成功需要漫长的公开-评论-修改-再公开的过程。使用Github仓库可以使文稿更易接受公开评论、提出修改和接受修改,在用于管理多方合作的文稿时格外高效。


示例:使用模板的SCITT架构文稿的仓库页
所以,IETF社区(RFC8874的作者Martin Thomson)开发了一套模板,可帮助你为你的文稿创建一个上述的GitHub Repository。
在此Repo创建之后,可以通过命令行make
在本地实现以下操作(make命令仅mac/linux可用,windows只能git提交内容):
- 编译文稿(.md -> .xml, .html, .txt)
- markdown语法清洁和自动修正(后续还会有yang清洁)
- 检查idnits
- 利用GitHub Pages发布和host当前文稿的网页预览
- 利用API向Datatracker系统提交文稿