我正在为我们的 API 用户编写教程,并希望合并代码片段和完整文件以用于示例目的。我可以将整个目录结构公开为 git,供人们下载;没问题。但我想以我可以通过要点的方式在相关页面上嵌入特定代码。
为此,我将每个文件复制到 gist 中,按“嵌入”,然后将生成的链接复制到我的教程页面中。
但是,使用完整文件设置一个 git repo 似乎很浪费,然后必须为每个文件复制它。有一个更好的方法吗?
(或者,如果有办法从 git 嵌入对特定文件的引用,我也可以这样做——这里的用例是说,“这是完整的示例文件”,所以我可以把它方法。)
谢谢。