きれいな LaTeX を書くための良い実践ルールはありますか? Python の PEP8 のようなもの。例:
- スペースまたはタブ(荒らしではありません);
- 折り返す前の列数 (PEP8 準拠の Python の場合は 80) ;
- コメントについて;
- 等
答え1
ここでの短い答えは簡単です。「いいえ、PEP8 やそれに類似したルールはありません」。
より長い回答を得るには、LaTeX ソースを 2 つのタイプに分ける価値があるかもしれません。
- ドキュメント(ほとんどの人にとって仕事の大部分を占める)
- パッケージとその他の「コード」
もちろん、プリアンブルで「すぐにコーディングする」必要がある場合があるため、重複する部分もありますが、ソース ファイルの「性質」は通常、大まかにどちらかのケースになります。
文書の場合、著者の数はこれまでソースは小さく、重要なターゲットはタイプセットされた出力です。したがって、入力をどのようにレイアウトするかは、実際には関係者次第です。
「コード」については、少なくともソースのより広い読み取り/再利用の可能性があるため、少し異なる結果になると主張する人もいるかもしれません。しかし、実際の経験から、ほとんどのパッケージでは、広く使用されている素材であっても、実際にコードを書いているのは 1 人だけであることがわかっています。例外がある場合 (最も明らかなのはカーネルですが、 や などbeamer
) biblatex
、「チーム サイズ」は小さい傾向があり、非公式の合意が通常可能です。(通常、1 人の人物が物事を開始しているため、その人物が行ったことに基づいて何らかの立場が合意されます。) ここでは、もちろん、.dtx
コードの形式を使用する可能性があり、ソースがはパッケージ (etoolbox
たとえば、カーネルと を比較してください)。
コードのスタイルガイドがある唯一の場所はexpl3
: チームはコードの傾向に基づいて書かれたものしかし、それでも、これらのルールに従わないコードが「悪い」という感覚はありません。コンテンツ。
TeXはマクロ拡張言語であり、自動チェッカーの実装が困難または不可能であることを覚えておくことが重要です。 LaTeX の自動スタイル ガイド?。