1

ややタイポグラフィに執着しているので、興味があります: オンラインとオフラインの両方で、コードを提示する最良の方法は何ですか。特に、次のことに興味があります。

  • オンラインとオフラインで最適な書体とサイズは? コードにプロポーショナル フォントを使用する方がよいでしょうか (たとえば、「The C++ Programming Language」で Stroustrup が使用するように)? セリフ、サンセリフ、または混合？
  • コードにどのように注釈を付ける必要がありますか? 通常の// commentマークアップを使用するか、単に別の書体 (およびコメント タグを使用しない) を使用するか?
  • コードのさまざまなブロックが互いにどのように関連しているかを示すために、矢印 (または同様のもの) を描く価値はありますか?
  • コードを複数の列に並べて表示することはまったく機能しますか?
  • 行番号付け、行の変更などが必要な人はいますか?
4

5 に答える 5

1

さて、BS が TC++PL で使用しているように、プロポーショナル フォントに反対票を投じさせてください。それは本当に私を夢中にさせます！同様に、Effective STL の Soctt Meyers には、いくつかの厄介なハイライトの恐怖が追加されています。

私にとって、プログラミングに関する古典的な本は常に K&R です。だから私はそれを奴隷的にコピーすることをお勧めします。

于 2009-07-03T11:15:05.883 に答える
1

テキストにダミー コードを記述するときは、拡張文字セットを使用するのが好きです。コードおよび数学マークアップ用のLaTeXフォントは適切に機能します。

良い例は、代入またはバインドに ではなく左矢印を使用することです=。私が見た本のコードの最も良い例は、Dragon Book や TAOCP のようなものです。これらの文字を表現する能力による数学的語源と、一般的な構文との関係がうまく混ざり合っていると思います。

通常の固定クーリエ タイプのフォントと、LaTeX の Computer Modern で利用できる高度な数学マークアップの混合物は、数学的な気質の読者に適していると思います...そしてとても見栄えがします。

于 2009-07-03T11:15:30.517 に答える
1

私の頭をよぎるいくつかのこと：

  • 行数を最小限に抑える
  • 必要な場合のみの行番号
  • 確かに異なるフォントを使用できますが、異なる背景はどうでしょうか? ライトグレーみたいな？コードをボックス化します。ボックスを 2 つ並べても問題ないと思います。
  • コストにもよりますが、ほとんどの IDE のように、特定の要素に色を付けることはどうでしょうか?
  • 動作する現実世界のコードを書きましょう! したがって、別のフォントだけでなく、通常の // コメント スタイルを使用することをお勧めします。
于 2009-07-03T11:17:15.690 に答える
1
  • Consolas のようなモノペース フォントを使用します。
  • コメントは通常、(少なくとも私が見た IDE では) 別の色で表示されるので、そのままにしておきます。
  • 「ブロックが互いにどのように関係しているかを示す」とはどういう意味ですか? 関数、if ステートメントなどの開始点と終了点を示しますか? もしそうなら、それは役に立つかもしれません。正直わかりません。
  • コードのいくつかのチャンクを比較して、あるものでは機能しないが別のものでは機能する微妙な違いを示す場合は機能する可能性がありますが、それ以上の用途はあまりありません。
  • 「前のコード サンプルの XYZ 行に移動」などの参照を作成すると、行番号が役立つ場合があります。
于 2009-07-03T11:18:36.093 に答える
1

これはほとんどの質問に正確に答えているわけではありませんが、Literate Programmingについて読むことに興味があるかもしれません。その要点は、コードとドキュメントを同じドキュメントに記述し、Web や印刷などに合わせてフォーマットすることです。ここでドキュメンテーションと言うとき、それは通常、ドキュメンテーションの 1 行のスニペットではなく、プログラムで何が起こっているかを説明する段落全体またはページ全体です。

于 2009-07-03T11:12:20.913 に答える