GitHub Wiki中的ToC或补充工具栏
如何在GitHub Wiki中创建ToC或侧边栏菜单？
我看到一些提及它和gollum后端似乎支持它,但我如何在当前的GitHub项目中做到这一点？
它应该最好基于我在页面中的标题自动.
这些链接都提到了它,但没有说明如何做到这一点:
- https://gist.github.com/379469 - 一些JavaScript黑客攻击
https://github.com/blog/774-git-powered-wikis-improved - GitHub提到它:
"GitHub Wiki对于页脚和侧边栏有一些记录不足的能力,这是我们的一些基于git的Wiki作者所熟悉的内容.新的Wiki编辑器为您提供有限的基于Web的页面编辑,包括您在网站上的页脚和侧边栏. "
nic*_*bot 76
虽然您的解决方案有效,但使用GitHub的Web界面可以更轻松地完成此操作.您只需创建一个名为_Sidebar和/或的页面即可_Footer.
请参阅Github Wiki侧栏菜单构建器中的详细说明.
编辑原始文章已经消失,我无法在缓存中找到它,所以我更新了链接.
- @CodeSherpa可以通过`https://github.com/ [user]/[repo]/wiki/_Sidebar/_edit`和`https://github.com/[user]/[repo]/wiki/_Footer访问它们/ _edit` (7认同)
- 那个链接坏了 (3认同)
- @Pithikos是Github Markdown说的.这些说明不适合教你Markdown.他们在那里解释侧边栏. (3认同)
- @nicerobot和解释某事的最好方法是使用一个具体的例子.. (2认同)
wol*_*lle 24
好的.让我看看我是否理解正确:
- 克隆你的GitHub维基.(wiki中有一个Git部分.你可以查看类似wiki的代码.)
- 创建
_Sidebar.md - 在普通的wiki页面中,
[[link]]用于侧边栏 - 提交并推回GitHub
这个过程是一个痛苦的屁股.我很惊讶这个"gollum"维基有任何接受.
另外: _Sidebar.md因此对所有页面都是全局的.我必须将我的wiki组织到文件夹中,这样我就可以为不同的页面定义不同的侧边栏.
- 根据文档,您可以为不同的文件夹添加不同的侧边栏:"侧边栏会影响其目录中的所有页面以及任何没有自己的侧边栏文件的子目录." 请参阅:https://github.com/github/gollum (2认同)
Pit*_*kos 22
当您在项目的Wiki中时,有一个链接添加自定义侧边栏.点击它.
现在,您可以编辑一个页面,就像编辑任何其他Markdown页面一样.要制作目录,您必须手动完成.没有自动化方法(截至2014年8月).例如:
# My menu
* [Home][home]
* [Technical documentation][techdocs]
* [User manual][usermanual]
[home]: https://github.com/myproject/wiki/Home
[techdocs]: https://github.com/myproject/wiki/Technical-documentation
[usermanual]: https://github.com/myproject/wiki/User-manual
小智 10
请注意,原始问题是关于创建侧栏(简单,在答案中解决)或实际目录(未回答).
我可以说的一件事是gollum 2.1 wiki语法允许[[_TOC_]]标记,但是GitHub wiki不会识别(但是？).
- 你有运气吗？来自Trac的所有这些事情都很容易完成,这非常令人沮丧. (4认同)