En textos científicos (artículos; propuestas), ¿cuál es la convención para formatear lo siguiente?
- sistemas operativos: Android; Linux; Microsoft Windows
- software (suite), por ejemplo: LibreOffice; oficina de microsoft
- componentes: Escritor (LibreOffice); Word (MS Office)
- plataformas, por ejemplo: Apache Solr; Citoscape; plataforma java
- marcos, por ejemplo: PostgreSQL; mysql
- bibliotecas, por ejemplo: jQuery (JS); Matplotlib (Python); NetworkX (Python); NumPy (Python)
- lenguajes de marcado, por ejemplo: HTML
- lenguajes de programación, por ejemplo: C; Java; JavaScript; PHP; PSQL; Pitón; R
- entorno de ejecución: nodo
- administrador de paquetes: npm
- hojas de estilo, por ejemplo: CSS
- estructuras de datos, por ejemplo: JSON; XML
No estoy seguro de dónde trazar la línea: es decir, diseñar todas las menciones programáticas o excluir algunas comunes (¿HTML?).
Además, el uso preferente para aquellos estilos de teletipo es:\texttt{}
o (porhttps://tex.stackexchange.com/a/620961/171556) Letras minúsculas: \textsc{}
?
Encontré esto que ofrece alguna orientación:
- Tipografía O'Reilly y convenciones de fuentes:https://oreillymedia.github.io/production-resources/styleguide/#typography_and_font_conventions
Respuesta1
En lugar de marcar elementos usando \texttt{}
o \textsc{}
, recomiendo usar marcado semántico para que puedas modificar fácilmente el formato si descubres que quieres o necesitas algo diferente.
Básicamente, esto implica crear un montón de envoltorios simples en su preámbulo, como
\NewDocumentCommand \os {m} {\textsf{#1}}
\NewDocumentCommand \suite {m} {\texttt{#1}}
\NewDocumentCommand \suitecomp {m} {\texttt{#1}}
\NewDocumentCommand \langacro {m} {\textsc{\texttt{#1}}}
etcétera. Luego utiliza estos envoltorios, en lugar de marcado explícito, en su documento,
\os{Linux} distributions package \suite{LibreOffice}, which includes \suitecomp{Writer} and \suitecomp{Calc}.
La documentación para eldoc
paquete puede resultar útil, al igual que la abundancia depaquetes para componer documentación de paquetes en CTAN.