15

处理我的个人知识库...我想格式化我的文档，甚至在本地硬盘上以 wiki 语法。有时我会将它们上传到（企业）wiki，有时我会从那里下载它们。计划使用一些工具来支持此流程并在以后搜索我的知识库（文档）。显然，我希望降价与大多数兼容，最大限度地减少转换工作。

所以我的问题类似于这个相关的问题，但是

  • 当我开始新事物时，我应该使用什么 wiki 文本版本或 Markdown（方言）？（即文档项目和维基类型）。
  • 什么是最广泛使用/公认的？
  • 工具支持（编辑器和/或库）在哪里最好？关注编。语言有 Java、Ruby、Scala。
4

3 回答 3

15

维基百科说没有普遍接受的标准维基文本语言。

克里奥尔语是“用于不同 Wiki 的通用 Wiki 标记语言”的一项努力。该规范有一个 1.0 版本，并且有几个wiki 和 wiki 引擎实现了它。MediaWiki 没有实现它。

Markdown有大量的实现，似乎用的也不少。

由于没有商定的标准，因此可以根据功能和可用的实现来选择语言，具体取决于用例。

于 2012-03-12T22:15:23.087 回答
3

(1)虽然有很多 wiki 标记，但我建议坚持使用定义明确的标记语言。

只有3 个具有明确规范的纯文本标记：

  • CommonMark试图定义强大的语法并标准化流行 MarkDown 的常见扩展。都喜欢它。非常面向 HTML。
  • reStructuredText是一致的标记框架和完善的项目（从 2001 年开始！！）。如果您需要在核心规范中内置可扩展性、内联外来标记、生成 HTML/PDF/docbook/等，这是您的选择。通过reStructuredText记录了几本书和许多软件项目。检查https://readthedocs.org/使用Sphinx发布软件，您可以使用离线JS 搜索构建 HTML ！
  • AsciiDoc与reStructuredText具有竞争力，但缺乏内置的可扩展性。它非常面向 DocBook。有几本书是用AsciiDoc编写的。

Textile标记没有获得明确定义的规范，并且周围社区薄弱。我建议改为考虑以上 3 个选项。

(2)你绝对应该坚持纯文本文件。

支持所有上述格式的软件，能够为打印和在线出版产生高质量的输出。

我坚持使用 RST，因为我需要可扩展性和内联外来标记的能力（使用 LaTeX 进行数学计算，使用 graphviz/dot 绘制图形，使用 imagemagic 绘图等）

我在Emacs编辑器或bash/grep中搜索个人提示。出于广告目的，我在网上发布我的提示，例如：http ://tips.defun.work/

于 2016-02-18T17:22:05.750 回答
1

不幸的是，尽管一些 wiki（特别是 Atlassian 的Confluence，一种商业产品）正在转向 XHTML ，但在 wiki 世界中几乎没有格式标准化。

使用最广泛的 Wiki 软件是MediaWiki（以 Wikipedia 闻名）。Mediawiki 的标记以难以解析而著称，但它已经存在并被广泛使用，以至于有许多现有的工具可以在 MediaWiki 格式之间进行转换，以及使用许多不同的在线和离线编辑器来编辑内容。

MediaWiki 还有一个功能齐全的 API，其中包含各种编程语言的大量客户端库（请参阅客户端代码），包括例如。MediaWiki:: Ruby 的网关。

于 2011-06-06T04:32:36.637 回答