什么是编程教程的好wiki软件？

Question

我注意到我的母语（拉脱维亚语）中有很少的编程教程。其中一个最好的似乎最近已经永久离线。因此，我更倾向于开始编写自己的编程教程。

由于我不是作家而且空闲时间很少，所以我想把它变成一个维基。这样，其他感兴趣的爱好者（我已经知道一些）也可以轻松加入。

问题是 - 哪个wiki软件最适合这样的任务？我有一些关键功能可以很好用，我会在这里列出：

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

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

已添加：好吧，似乎真的只有两个好的候选人--DokuWiki和MediaWiki。两者都具有已经具有拉脱维亚本地化的强大功能。我会选择MediaWiki，因为它似乎至少有一个主要优势 - 附件版本化。 （毫无疑问，这是世界上经过最佳测试的wiki系统）但是，如果对于这样一个小项目而言，它不会过于强大。对此有何评论？

Answer 1

DokuWiki符合您的许多要求。

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

它原本打算作为代码文档维基。我不确定是否会将整个内容自动编译成电子书。但是，插件很容易编写。

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

Answer 2

维基软件的王者是MediaWiki。它支持您指定的所有功能，包括：

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

此外，我相信该软件在维基百科的Linux上运行，所以它已经在Linux平台上进行了全面测试。安装起来并不困难，但可能存在太多功能的风险。

Answer 3

听起来像是Dokuwiki的理想工作。

更新：如果您问自己（或我们）Mediawiki对您的项目是否有点太大，也许您应该只考虑其他因素。

• Dokuwiki应该可以运行在几乎任何类型的硬件上。我很少看到一种感觉不快且性能良好的安装。 Mediawiki很难说同样的话。
• 安装Dokuwiki是一件轻而易举的事。你应该在30分钟内启动并运行。
• 支持。我不知道这与Mediawiki有什么关系，但dokuwiki邮件列表上的人非常有帮助和友好。

PS：我有偏见吗？非常好！

Answer 4

MoinMoin非常好，并具有幻灯片放映功能。

Answer 5

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

• 适用于美观代码段的Google代码插件
• 语言切换器插件您可以使用不同的语言轻松编写，并在您的博客中指定语言标签，例如[lang_en]英语[/ lang_en] [lang_de] deutsche sprache hier [/ lang_de]
• 版本控制

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

Answer 6

感谢您这样做。我相信我们需要更多的资源，而不是英语。

然而，当你在这里时，你还应该提供用英语或其他语言写的文章的链接，这些文章阐述了你用拉脱维亚语撰写的文章。这样，您的读者将获得拉脱维亚语中的所有可用内容，但仍然可以找到也可用的非拉脱维亚语内容。

Answer 7

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

但是，您可能希望转到Literate Programs Wiki。 Literate Programming是教学编程的一种伟大的方式，Literate Programs Wiki将MediaWiki Wiki软件与noweb Literate Programming系统结合在一起。

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

Answer 8

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

Answer 9

对TWiki的任何评论？ Dokuwiki看起来简单易用，而Twiki在搜索引擎中排名很高，看起来有更多功能，此外，上面提到的Confluence非常好！

Answer 10

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

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