Tag: wiki

你的团队使用什么工具编写用户手册？: 基本要求是：人类可读/文本格式（便于版本控制）在线（用于协作）容易格式化（markdown ok，html太多了）严格的格式（所以作者不发明新的标题，子弹等types）可导出为PDF，HTML 容易的备份和部署（所以我们可以“只”部署到客户站点作为只读版本）我们正在考虑使用某种wiki引擎，但是它需要使用文件进行存储，或者有其他的方式来“部署”给客户，并且易于安装/维护。此外，它将不得不免费/便宜（合stream是太昂贵）有什么build议么？编辑：我不是在寻找工具来logging代码，我们有覆盖使用沙堡。

如何将GitHub wiki集成到主项目中: 我想保留我所有的源代码和文档在一个单一的git仓库。我已经把github页面集成到了我的主项目中，现在我想要和github wiki一样。我知道github wiki是纯粹的git仓库。我的计划是将维基添加到我的主库中，并将所有内容保存在一个地方。然而，在维基回购一切都在根目录，因此会混乱我的主要项目。有没有人试过这个？处理这个问题的最好方法是什么？

任何更好的方式来创buildMediaWiki编号列表？: 当使用MediaWiki的标记语言时，唯一令我讨厌的是创build编号列表。我知道创build列表的唯一方法是做这样的事情： #Item1 #Item2 但是，如果我想在这些行之间添加空格或其他文本，编号就会丢失。例如，下面将创build具有两个第一项的文本： #Item1 Somestuff #Item2 有没有什么办法解决这个问题，或者我应该只使用项目符号？我刚才注意到，stackoverflow系统不允许这样的编号，你必须手动完成。

最有用的Rails插件，Ruby库和Rubygem？: 我看到很多网站提供了Rails plugins ， Ruby libraries和Ruby gems的完整列表，但是我们很less使用它们，有些可能不适合我们的需求，我们花费了大量的时间来寻找适合我们需求的有用的Plugins 。我创build了这个民意调查，人们可以发布他们遇到的有用的图书馆， gems and plugins 。这对于像我这样的新手和整个Ruby on Rails community将是非常有帮助的。注意：要保持这个民意调查尽可能有用，请记住：每个答案只发布一个图书馆，gem或插件提到你认为有用的图书馆，gem或插件的名称。资源位置的URL 我们不想要重复的答案，所以在发布之前请检查图书馆是否已被提及。编辑：任何新的插件/gem的Rails 3？谢谢

GitHub wiki目录: 安装了GitHub仓库的wiki是否支持目录？我们的wiki杂乱无章，我们正在寻找一种更好地组织它们的方法。我们尝试了回购，创build本地目录和移动东西，但是当提交时，维基并没有拿起这些变化。

ToC或GitHub Wiki中的边栏: 如何在GitHub Wiki中创buildToC或侧边栏菜单？我看到了一些提及，gollum后端似乎支持它，但是我怎样在当前的GitHub项目中做到这一点？它应该最好基于我自动在页面中的标题。这些链接都提到它，但不显示如何做到这一点： https://gist.github.com/379469 – 一些JavaScript黑客入侵 https://github.com/blog/774-git-powered-wikis-improved – GitHub提到它： “GitHub Wiki对脚注和侧边栏有一些logging的function，这是我们一些基于git的Wiki作者所熟悉的。这个新的Wiki编辑器为您提供了有限的基于网页的页脚编辑function。 “

编号列表中的代码块（Wiki语法）: 在MediaWiki（维基百科）的wiki语法中，有没有一种方法可以在中间有一个代码块的编号列表？例如：＃ 1号＃ 2号缩进部分将成为一个代码块＃3号＃数字4 在MediaWiki中会发生什么，你会得到这样的结果： 1.数字1 2.数字2 缩进部分将成为一个代码块 1.数字3 2.数字4 （请注意“Number 3”和“Number 4”是如何重置为1和2 …看起来像StackOverflow比MediaWiki聪明得多，我不得不把我的例子放在PRE标记中，以使它搞砸！）我知道你可以使用“＃：”语法缩进文本… ＃ 1号＃ 2号＃：仅缩进的缩进部分＃3号＃数字4 …但我真的想为我的代码获取相同的可视CSS类，即使它在一个编号列表中。它嵌套列表变得更有趣。这个语法… ＃MainEntry 1 ＃＃ 1号＃＃ 2号＃MainEntry 2 ＃＃ 1号＃＃ 2号缩进部分将成为一个代码块 ##数字3 ##数字4 … …变 1. MainEntry 1 1.数字1 2.数字2 2. MainEntry 2 […]

在GitHub wiki（gollum）存储库中embedded图像？: Github wiki由单独的git存储库和主项目存储库提供支持。 Github团队发布的这篇文章听起来像是应该能够链接到wiki标记中存储在wiki库中的图像。图像和文件夹您现在可以引用Git存储库内托pipe的图像。我已经检出了我的维基库，并把一个资源文件夹和一个图像放到里面。我的问题是，我怎么去使用这个图像？这是甚至可能或者我误解了一些东西？

如何拉请求GitHub上的维基页面？: 我在GitHub上看到一个不能打开的维基页面。然后，我分出了这个项目，编辑了“我的结局”，并试图做出一个拉动请求。事实certificate，这个wiki不在这个项目中，也没有办法对它进行修改。除了电子邮件，如果我想在这种情况下build议对wiki进行更改，是否有办法继续？在这一点上，我发现似乎是 “类似标题的问题”下的替代scheme ，但是我还是无法完成拉取请求，所以我不确定子模块是否是达到此目的的好方法。我现在看到我可能可以用它来分支它…所以这是要走的路吗？