什么是编程教程的好 wiki 软件？ [关闭]答案

【问题标题】：What is a good wiki software for programming tutorials? [closed]什么是编程教程的好 wiki 软件？ [关闭]
【发布时间】：2010-10-12 10:12:26
【问题描述】：

我注意到以我的母语（拉脱维亚语）编写的编程教程非常少。最好的之一似乎最近永久离线。因此，我更倾向于开始编写自己的编程教程。

由于我不是作家，空闲时间很少，所以我想把它做成一个 wiki 的东西。这样其他感兴趣的爱好者（我已经认识几个）也可以轻松加入。

问题是 - 哪款 wiki 软件最适合这样的任务？ 我想到了一些很高兴拥有的关键功能，我将在此处列出它们：

完全支持 Unicode，因为拉脱维亚语中有一些非标准字符；
修订控制；
访问控制（支持匿名访问）；
代码语法着色，最好是可扩展的，以便制作不同编程语言的教程；
从所有页面自动生成 TOC 会很好（但也可以手动完成）；
对图表和数学公式的支持会很好（但也可以通过图片上传来完成）；
为页面提供“可打印”版本的功能非常棒，更不用说将整个内容编译成可下载的电子书了。

我的服务器上有 Linux，所以最好没有 ASP/ASP.NET - 但如果真的需要，也可以安排。

补充：好吧，似乎真的只有两个不错的候选者——DokuWiki 和 MediaWiki。两者都具有拉脱维亚本地化的重要特征。我会选择 MediaWiki，因为它似乎至少有一个主要优势——附件的版本控制。（加上毫无疑问是世界上测试最好的 wiki 系统）但是对于这样一个小项目来说，我担心它是否功能过于丰富。有这方面的cmet吗？

【问题讨论】：

MoinMoin（已在至少一个答案中提到）符合您的要求。目前，您可能不再寻找这个问题的答案。尽管如此，我喜欢 MoinMoin 的一些原因是： - 包括拉脱维亚本地化 - 请参阅 moinmo.in/LatvianTranslation - ACL 和您要求的所有其他内容（有些像数学公式不是内置的，但可作为模块使用） - 用Python 并且易于扩展、创建模块等。这里的拉脱维亚本地化是一个使用它的 wiki 示例 - semweb.mii.lu.lv/wiki

标签： wiki-engine

【解决方案1】：

TWiki 有任何联系方式吗？ Dokuwiki看起来简单易用，而Twiki在搜索引擎中排名靠前，看起来更有特色，另外上面提到的Confluence真的很不错！

【讨论】：

【解决方案2】：

对于数学公式的支持，MoinMoin does latex（该网站以个性化主题运行 moinmoin）。

【讨论】：

【解决方案3】：

听起来是Dokuwiki 的理想工作。

更新：如果您问自己（或我们）Mediawiki 对于您的项目来说是否有点太大，也许您应该简单地考虑所涉及的其他因素。

Dokuwiki 几乎可以在任何类型的硬件上运行。我很少见过感觉不快速且性能不佳的安装。对于 Mediawiki，很难说同样的话。
安装 Dokuwiki 轻而易举。您应该会在 30 分钟内启动并运行。
支持。我不知道 Mediawiki 的情况如何，但 dokuwiki 邮件列表中的人非常乐于助人和友好。

PS：我有偏见？太棒了！

【讨论】：

可惜了，比allclaws早了一分钟，但他的文字更多：D

【解决方案4】：

不幸的是，我认为没有一个 Wiki 特别适合包含大量源代码的文章。

但是，您可能想前往Literate Programs Wiki。 Literate Programming 是一种伟大的编程教学方式，Literate Programs Wiki 结合了 MediaWiki Wiki 软件和 noweb Literate Programming 系统。

也许您可以请他们帮助您设置自己的版本。或者你可以直接使用他们的 Wiki，毕竟 MediaWiki 支持多种语言。

【讨论】：

也许...看起来很有趣...虽然到目前为止我所看到的 LP 示例实际上看起来 /less/ 可读然后简单的代码 sn-ps。不过我可能只是不习惯。
我真的同意你的看法。然而，这与正常的活生生的、不断发展的 Wiki 不同于一本死书一样不同。我认为，这个版本的 LP（Wiki+Code 而不是 TeX+Code）远远优于传统版本。

【解决方案5】：

您可以使用 zoho wiki。 http://wiki.zoho.com

我们将它用于我们的内部开发文档。它有你想要的一切。 https://zohowikihelp.wiki.zoho.com/

【讨论】：

【解决方案6】：

感谢您这样做。我相信我们需要更多非英语语言的资源。

但是，您还应该提供指向用英语或其他语言撰写的文章的链接，这些链接说明您正在用拉脱维亚语撰写的文章。这样，您的读者将获得所有可用的拉脱维亚语内容，但仍能找到同样可用的非拉脱维亚语内容。

【讨论】：

当然，为什么不呢？尽管有如此丰富的英语教程，一个简单的谷歌查询已经产生了压倒性的结果。但这个想法很有用。特别是因为很大一部分目标受众听不懂英语，并且更喜欢其他俄语来源。

【解决方案7】：

我对 Wordpress 有很好的经验，但它需要一些插件。

Google-Code 插件，用于漂亮的代码 sn-ps
语言切换器插件，您可以通过在您的博客中指定语言标签（例如 [lang_en]english language here[/lang_en] [lang_de]deutsche sprache hier[/lang_de]）轻松地用不同的语言编写
修订控制

如果你需要一些特殊的，它与其他系统相比并不难扩展或编写一些自己的插件。

【讨论】：

【解决方案8】：

wiki 软件的金刚是MediaWiki。它支持您指定的所有功能，包括：

Unicode（维基百科使用 Mediawiki，跨越数百个不同的国家和语言）
修订控制（包括回滚、查看修订之间的差异等）
访问控制（不同用户级别、匿名读/写等）
通过extension 突出显示语法
如果页面中的标题超过 3 个，则生成 TOC
通过 LaTex 标记的图表和公式
打印 CSS 样式，打印页面选项

此外，我相信该软件在 Wikipedia 上的 Linux 上运行，因此它已经在 Linux 平台上进行了全面测试。它安装起来并不难，但可能会有太多功能的风险。

【讨论】：

是的，“功能太多”也是我害怕的。该项目仍然很小。 :) 但它确实比 DokuWiki 有一个优势 - 附件的修订控制......
我们在工作中使用 mediawiki 作为一个相对较小的内部 wiki，并且在使用它和添加插件方面没有任何问题。它也比 DokuWiki 有更好的支持，因为使用它的人要多得多。

【解决方案9】：

DokuWiki 满足您的许多要求。

Unicode
修订历史
匿名和经过身份验证的访问
多种语言的语法突出显示，通过Geshi
自动目录
图表和公式（通过插件）
PHP，所以它可以在任何地方运行

它最初的目的是作为代码文档 wiki。我不确定是否会自动将整个内容编译成电子书。但是，插件很容易编写。

编辑 - 有用于从您的页面生成 PDF 和其他文档格式的插件，因此一种可能性是使用网络爬虫将内容拼凑在一起。

【讨论】：

DokuWiki 最好的特性之一是它将所有内容存储在人类可读的平面文本文件中，这意味着自己制作解析器以将文件处理成所需的任何形式并不难。
是的。但我仍然无法在 MediaWiki 和 DokuWiki 之间做出决定。 MediaWiki 的一个论点是它还保留附件的修订版本。而且它有点支持所有相同的东西......我有点倾向于 MediaWiki。
几年前我为 MediaWiki 制作了一个插件，让它在标题中注入 javascript 是一场噩梦。如果这没有改变，我会选择 doku。

【解决方案10】：

MoinMoin 非常棒，而且有幻灯片放映功能。

【讨论】：