问题 使用哪种Wiki文本语法或Markdown?


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

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

  • 当我开始新的东西时,我应该使用什么维基文本版本或Markdown(方言)? (即文档项目和维基类型)。
  • 什么是最被使用/认可的?
  • 工具支持(编辑器和/或库)最好的位置在哪里?有关的前卫。语言是Java,Ruby,Scala。

11405
2018-01-11 09:53


起源

来吧伙计们,我相信这里有一些维基出口;-) - Peter Kofler
我们真的需要一个最终将它们统一起来的Wiki标准: xkcd.com/927 - Heinzi


答案:


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

克里奥尔语 是一种“在不同的Wiki上使用通用wiki标记语言”的努力。规范的版本1.0和几个 维基和维基引擎 实现它。 MediaWiki没有实现它。

降价 有大量的实现,似乎使用了很多。

由于没有商定的标准,可能会根据选择语言 功能和可用的实现 视用例而定。


12
2018-03-12 22:15





(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/


2
2018-02-18 17:22





不幸的是,wiki世界中的格式标准化很少,尽管有些wiki(特别是Atlassian的 合流,商业产品)正朝着XHTML发展。

使用最广泛的Wiki软件是 链接到MediaWiki (维基百科成名)。 Mediawiki的标记很难解析,但它已经存在并且被广泛使用,以至于有很多 现有工具 用于转换MediaWiki格式和从MediaWiki格式转换,以及编辑具有许多不同在线和离线编辑器的内容。

MediaWiki还有一个功能齐全的API,包含许多各种编程语言的客户端库(参见 客户代码),包括例如。 链接到MediaWiki ::网关 对于Ruby。


1
2018-06-06 04:32



因此,对于一个新项目,它使用Wiki语法,例如模板或内容,你会推荐MediaWiki格式吗? - Peter Kofler
您的项目有多大,您确定首先需要维基吗?对于大多数低技术项目而言,启用了更改跟踪的Google Docs实际上会做得更好。 - jpatokal
我想将文档保存为某种标准格式,机器可读性很好,但仍然是纯文本,并且在用户的文本编辑器中非常易读。这是markdown(即wiki语法)。应该是一些知识管理工具(开发中)的基础。 - Peter Kofler