在我的个人知识库上工作...我想格式化我的文档,甚至在wiki语法的本地硬盘上。有时我会将它们上传到(公司)维基,有时我会从那里下载它们。计划的是一些工具来支持这个流程并搜索我的知识库(文档)以供日后使用。显然,我希望降价与大多数兼容,最大限度地减少转换工作。
所以我的问题类似于 这个相关的问题但是
- 当我开始新的东西时,我应该使用什么维基文本版本或Markdown(方言)? (即文档项目和维基类型)。
- 什么是最被使用/认可的?
- 工具支持(编辑器和/或库)最好的位置在哪里?有关的前卫。语言是Java,Ruby,Scala。
维基百科说 没有普遍接受的标准wiki文本。
克里奥尔语 是一种“在不同的Wiki上使用通用wiki标记语言”的努力。规范的版本1.0和几个 维基和维基引擎 实现它。 MediaWiki没有实现它。
降价 有大量的实现,似乎使用了很多。
由于没有商定的标准,可能会根据选择语言 功能和可用的实现 视用例而定。
(1) 虽然有很多维基标记我建议坚持 定义良好的标记语言。
有 只有3个纯文本标记,具有明确定义的规范:
- CommonMark 尝试定义强大的语法并标准化流行的MarkDown的常见扩展。所有人都喜欢它。非常面向HTML。
- reStructuredText的 是标记和完善项目的一致框架(从2001年开始!!)。如果您需要内置于核心规范,内联外部标记,生成HTML / PDF / docbook /等的可扩展性,那么它是您的选择。通过记录了几本书和许多软件项目 reStructuredText的。检查 https://readthedocs.org/ 同 狮身人面像 发布您可以用HTML构建HTML的软件 离线 JS搜索!!
- AsciiDoc 是有竞争力的 reStructuredText的 但缺乏内置的可扩展性。它非常以DocBook为导向。写了好几本书 AsciiDoc。
纺织品 标记没有获得明确的规范,而且社区也很薄弱。我建议考虑以上3个选项。
(2) 你绝对应该坚持使用纯文本文件。
支持所有上述格式的软件,可以为打印和在线发布生成高质量的输出。
我坚持使用RST,因为我需要可扩展性和内联外部标记的能力(使用LaTeX进行数学运算,使用graphviz / dot绘图,使用imagemagic进行绘图等)
我在里面搜索个人提示 Emacs的编辑或内部 庆典/ grep的。出于广告目的,我在线发布我的提示,例如: http://tips.defun.work/
不幸的是,wiki世界中的格式标准化很少,尽管有些wiki(特别是Atlassian的 合流,商业产品)正朝着XHTML发展。
使用最广泛的Wiki软件是 链接到MediaWiki (维基百科成名)。 Mediawiki的标记很难解析,但它已经存在并且被广泛使用,以至于有很多 现有工具 用于转换MediaWiki格式和从MediaWiki格式转换,以及编辑具有许多不同在线和离线编辑器的内容。
MediaWiki还有一个功能齐全的API,包含许多各种编程语言的客户端库(参见 客户代码),包括例如。 链接到MediaWiki ::网关 对于Ruby。