When mentioning names of programs or LaTeX 2e-packages or document classes or files within questions/answers—what is the best way of typesetting/emphasizing them?
I often see such names emphasized by means of backtick escapes in situations where they are not (parts of) a snippet of code.
I tend to refrain from using backtick escapes in such situations.
Is it sufficient in such situations to turn such names into links that point to resources where more information about the programs/packages/document classes/files in question can be found?
Should emphasizing in such situations be done by means of italic ?
Should emphasizing in such situations be done by means of bold?
E.g., the following phrase does not exhibit whatsoever code but it refers to the document class article:
"The document class article does not provide means for dividing documents into chapters."
E.g., the following phrases do also exhibit snippets of code:
"The document class article does not provide means for dividing documents into chapters. You can have LaTeX 2e load that document class by placing the command \documentclass{article}
into the preamble of the source code of your document."
\usepackage{siunitx}
the name is clearlysiunitx
. Granted, in package documentation I'd use\textsf
, but that's not an option here ... – Joseph Wright♦ May 25 '19 at 15:01article
does not have the\chapter
-command." works just as well. – Werner May 25 '19 at 16:05\chapter
" can be taken for a snippet of code. – Ulrich Diez May 25 '19 at 16:11article
and some times article. I could agree with using italics as well but not with bold (I think it's too much and would be distracting). And I think that providing links for each package mentioned in an answer would be tiresome. I do so only when I feel that it's necessary, like a little known, or recently released package. – Phelype Oleinik May 25 '19 at 20:33\documentclass{article}
. In a similar way, one would probably useieeetran
compared to IEEE Transactions document class/template;elsarticle
compared to Elsevier journal article class. – Werner May 25 '19 at 20:56\textsf
for package names, but that's in a roman body text situation.) – Joseph Wright♦ May 27 '19 at 10:16