15

個人的なナレッジ ベースに取り組んでいます... ローカル ハードディスク上にあるドキュメントを wiki 構文でフォーマットしたいと考えています。(企業の) wiki にアップロードすることもあれば、そこからダウンロードすることもありました。このフローをサポートし、後で自分のナレッジ ベース (ドキュメント) を検索するためのいくつかのツールが計画されています。明らかに、変換作業を最小限に抑えて、マークダウンがほとんどのものと互換性があることを望んでいます。

したがって、私の質問はこの関連する質問に似ていますが、

  • 何か新しいことを始めるときは、どの wiki テキスト バージョンまたは Markdown (方言) を使用すればよいですか? (つまり、ドキュメンテーション プロジェクトと一種の wiki)。
  • 最も広く使用/認識されているものは何ですか?
  • また、ツールのサポート (エディターやライブラリー) はどこが最適ですか? 気になるプログ。言語は Java、Ruby、Scala です。
4

3 に答える 3

15

ウィキペディアによると、一般的に受け入れられている標準的なウィキテキスト言語はありません。

クレオールは、「異なるWikiで使用される共通のWikiマークアップ言語」の1つの取り組みです。仕様にはバージョン1.0があり、いくつかのwikiとwikiエンジンがそれを実装しています。MediaWikiはそれを実装していません。

Markdownには多数の実装があり、かなり多く使用されているようです。

合意された標準がないため、使用例に応じて、機能や使用可能な実装に応じて言語が選択される場合があります。

于 2012-03-12T22:15:23.087 に答える
3

(1) wiki マークアップはたくさんありますが、明確に定義されたマークアップ言語に固執することをお勧めします。

明確に定義された仕様を持つ 3 つのプレーン テキスト マークアップのみがあります。

  • CommonMark は、強力な構文を定義し、一般的なMarkDownの一般的な拡張機能を標準化しようとしています。すべてが大好きです。非常に HTML 指向。
  • reStructuredTextはマークアップ用の一貫したフレームワークであり、確立されたプロジェクト (2001 年から開始!!) です。コア仕様に組み込まれた拡張性、インラインの外部マークアップ、HTML/PDF/docbook/etc の生成が必要な場合は、それを選択してください。reStructuredTextを介して、いくつかの本と多くのソフトウェア プロジェクトが文書化されました。https://readthedocs.org/を確認してください。Sphinxパブリッシングソフトウェアを使用すると、オフラインのJS 検索で HTML を構築できます。
  • AsciiDocはreStructuredTextと競合しますが、組み込みの拡張性がありません。非常に DocBook 指向です。AsciiDocで書かれた本がいくつかあります。

テキスタイルのマークアップは、明確に定義された仕様を獲得しておらず、弱いコミュニティしかありません。代わりに、上記の 3 つのオプションを検討することをお勧めします。

(2)プレーン テキスト ファイルに固執する必要があります。

印刷およびオンライン出版用に高品質の出力を生成できる、上記のすべての形式をサポートするソフトウェア。

拡張性と外部マークアップをインライン化する機能 (LaTeX を使用した数学、graphviz/dot を使用したグラフ、imagemagic を使用したプロットなど) が必要なため、私は RST にこだわります。

Emacsエディター内またはbash/grep内で個人的なヒントを検索します。広告目的で、オンラインでヒントを公開しています。たとえば、http: //tips.defun.work/です。

于 2016-02-18T17:22:05.750 に答える
1

残念ながら、Wiki の世界では形式の標準化がほとんど行われていませんが、一部の Wiki (特に商用製品である Atlassian のConfluence ) は XHTML に移行しています。

最も広く使用されているウィキ ソフトウェアはMediaWiki (ウィキペディアで有名) です。MediaWiki のマークアップは解析が難しいことで知られていますが、MediaWiki 形式との間で変換したり、さまざまなオンライン エディターやオフライン エディターでコンテンツを編集したりするための既存のツールが多数存在するほど広く使用されています。

MediaWiki には、さまざまなプログラミング言語 (「クライアント コード」を参照) の多数のクライアント ライブラリを備えたフル機能の API もあります。MediaWiki:: Ruby のゲートウェイ。

于 2011-06-06T04:32:36.637 に答える