10

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

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

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

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

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

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

4

10 回答 10

5

DokuWiki满足您的许多要求。

  • 统一码
  • 修订记录
  • 匿名和经过身份验证的访问
  • 多种语言的语法高亮，通过Geshi
  • 自动目录
  • 图表和公式（通过插件）
  • PHP，所以它可以在任何地方运行

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

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

于 2009-03-10T13:39:34.803 回答
5

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

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

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

于 2009-03-10T13:39:43.040 回答
3

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

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

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

PS：我有偏见？太厉害了！

于 2009-03-10T13:38:34.353 回答
0

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

于 2009-03-10T13:39:34.367 回答
0

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

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

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

于 2009-03-10T13:40:08.860 回答
0

谢谢你这样做。我相信我们需要更多英语以外的语言资源。

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

于 2009-03-10T13:45:29.033 回答
0

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

但是，您可能想前往Literate Programs Wiki。Literate Programming 是教授编程的好方法，Literate Programs Wiki 结合了 MediaWiki Wiki 软件和 noweb Literate Programming 系统。

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

于 2009-03-10T15:45:16.890 回答
0

为了支持数学公式，MoinMoin 提供了乳胶（该网站以个性化的主题运行 moinmoin）。

于 2009-12-19T13:20:27.893 回答
0

对TWiki有任何评论吗？Dokuwiki看起来简单易用，而 Twiki 在搜索引擎中排名很高，看起来更有特色，另外，上面提到的Confluence真的很棒！

于 2011-06-24T04:32:24.340 回答
-1

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

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

于 2009-03-10T13:56:13.873 回答