科学的なテキスト(論文、提案)では、次のような書式設定の規則は何ですか?
- オペレーティングシステム: Android、Linux、Microsoft Windows
- ソフトウェア(スイート)、例:LibreOffice、Microsoft Office
- コンポーネント: Writer (LibreOffice)、Word (MS Office)
- プラットフォーム、例: Apache Solr、Cytoscape、Java プラットフォーム
- フレームワーク、例: PostgreSQL、MySQL
- ライブラリ、例: jQuery (JS); Matplotlib (Python); NetworkX (Python); NumPy (Python)
- マークアップ言語、例: HTML
- プログラミング言語、例: C、Java、JavaScript、PHP、PSQL、Python、R
- ランタイム環境: ノード
- パッケージマネージャー: npm
- スタイルシート、例: CSS
- データ構造、例: JSON、XML
どこで線を引くべきかわかりません。つまり、すべてのプログラム的な言及にスタイルを設定するのか、それとも一般的な言及の一部を除外するのか (HTML でしょうか)。
また、これらのスタイルには、テレタイプ:\texttt{}
または (perhttps://tex.stackexchange.com/a/620961/171556) 小さな帽子:\textsc{}
?
私はいくつかのガイダンスを提供しているこれを見つけました:
- O'Reilly のタイポグラフィとフォント規則:https://oreillymedia.github.io/production-resources/styleguide/#typography_and_font_conventions
答え1
\texttt{}
またはを使用して項目をマークアップするのではなく\textsc{}
、セマンティック マークアップを使用することをお勧めします。そうすれば、何か別のものが必要になった場合に簡単に書式を変更できます。
基本的に、これはプリアンブルに次のような単純なラッパーをいくつか作成することを意味します。
\NewDocumentCommand \os {m} {\textsf{#1}}
\NewDocumentCommand \suite {m} {\texttt{#1}}
\NewDocumentCommand \suitecomp {m} {\texttt{#1}}
\NewDocumentCommand \langacro {m} {\textsc{\texttt{#1}}}
などです。そして、明示的なマークアップではなく、これらのラッパーを文書内で使用します。
\os{Linux} distributions package \suite{LibreOffice}, which includes \suitecomp{Writer} and \suitecomp{Calc}.
パッケージのドキュメントはdoc
役に立つかもしれないし、CTAN の組版パッケージドキュメント。