Mathematica のドキュメント センターのような純粋なコードではなく、明示的な例と結果を示す LaTeX/パッケージの包括的なチュートリアル/マニュアル

Mathematica のドキュメント センターのような純粋なコードではなく、明示的な例と結果を示す LaTeX/パッケージの包括的なチュートリアル/マニュアル

私は LaTeX でいくつかのパッケージを使用したいので、そのパッケージのマニュアルを探します。しかし、これらのマニュアルはすべてコードと説明のみで、明確な例や結果の提示はありません。私はコンピューター サイエンティストではありません。このパッケージの使用方法を理解するためにプレーン テキストをすべて読むのは、私にとってはかなり退屈で非効率的です。私のようなアマチュアがすべてのパッケージのマニュアルを見つけられる場所はありますか? このマニュアル/ノート (パッケージの作成者が書いたものである必要はありません) には、次のような特性が必要です。

  1. フレームワークを紹介するために簡単な例をいくつか選ぶだけのような、あまり大ざっぱなものは避けてください。包括的で、そのパッケージ内のすべての関数、メソッド、またはパラメーターの詳細をすべて教えてくれるものがほしいです。

  2. 私にとって最も重要なのは、すべての関数/メソッド/パラメータに明示的な例と表示される結果があることです。そうすれば、表示された結果をすばやく調べることができ、ああ、これが私が望んでいたものなんだ、とわかります。

追記: LaTeX が有料ソフトウェアではないことは理解しています。パッケージの作者には、とにかく好きなように書く権利があります。オリジナルの無味乾燥なマニュアルを熟読し、表面をなぞるだけの初心者に優しい方法で教えるような優れたインストラクターがいるかどうか疑問に思います。私が求めているのは、次のようなものです。Wolfram Mathematica のドキュメント センター

答え1

いいえ、そのようなサイトは存在しませんし、マニュアルが退屈だからといって、誰もあなたのためにサイトを作成してくれるわけではありません。

Mathematica はプロプライエタリなアプリケーションであり、パッケージのドキュメント化方法を制御できます。Python はオープンソースですが、コミュニティの倫理観が強く、「方法は 1 つ、できれば 1 つだけ」という点にほぼ全員が同意しています。そのため、優れたドキュメント化は文化の一部です。LaTeX はどちらでもありません。

一部のパッケージのドキュメントは非常に優れているというコメントに同意します。 tikzそして、pgfplots私のお気に入りの1つです。そして、ほとんどのドキュメントは悪い; ただ、それを使ってやりたいことのすべてを詳しく説明しているわけではないかもしれません。

しかし、LaTeX (および ConTeXt、コア TeX) のさまざまな使用例に関する回答済みの質問の膨大なリソースを探している場合は、すでに見つけているかもしれません。TeX.SE の質問は、使用されているパッケージによってタグ付けされているため、多くの例を参照および検索できます。TeX.SE のページは簡単に見つけることができます。通常、私は「latex (やりたいこと)」を Google で検索するだけで、トップの結果は通常このサイトのページです。そして、欲しいものが見つからない場合は、質問してください。

答え2

申し訳ありませんが、あなたの要求はあまりにも野心的すぎると思います。しかし、LaTeX コンパニオンシリーズ (LaTeX コンパニオンLaTeX グラフィック コンパニオンそしてLaTeX ウェブコンパニオン、すべて Addison Wesley から出版) は、あなたの要求を満たすのに大いに役立っています。個々のパッケージ/クラスに関しては、開発者/著者が重要と考えるドキュメントを提供する必要があります。ほとんどの場合、彼ら (そしてもちろん私も) は、読者が LaTeX についてある程度の知識を持っており、基本的な要素を繰り返す必要はないと想定していたと思います。

memoir私はこのクラス ( )のオリジナル開発者で、> texdoc memoir約 540 ページからなるマニュアルを読みました。このマニュアルには、クラス内のすべてのマクロの 40 ページのインデックスが含まれています。これらのマクロはすべて、マニュアルの本文で多かれ少なかれ説明されています。主要なマクロを使用した結果の例が示されています。クラス内のすべてのマクロの使用例をすべて含めると、マニュアルのサイズが 3 倍になると思われます。誰がそんなものを読むでしょうか。私が書くはずがありません。

自分が見たいものについてのアイデアはおありなので、理解したパッケージのアマチュアレベルのドキュメントを書いて、CTAN に提出し、一般配布していただけますか?

ゴム

関連情報