Mẫu / gói quy ước đánh máy

Question

Tôi đang tìm một cách (có thể nó hoạt động hiệu quả) hoặc gói để tạo một trang cho các quy ước được sử dụng trong một tờ báo. Cho đến nay, tìm kiếm của tôi chỉ mang lại kết quả về các quy ước kiểu chữ trong LaTeX chứ không phải cách tạo chúng ...

Đây là một ví dụ về cách nó có thể trông như thế nào (từ đây ):

Tôi không chắc đây sẽ là một itemizehay một tabularmôi trường (có thể là môi trường sau do nhiều dòng) mà tôi đã bắt đầu tabularvà đây là mã:

\documentclass{article}

% surround the \dotfill by a bit of blank space
\newcommand{\spaceddotfill}{\phantom{i}\dotfill\phantom{e}}

\begin{document}
    \begingroup
    \setlength\tabcolsep{0pt}
    \begin{tabular}{p{3.2cm}p{8.8cm}}
        \textsf{package}\spaceddotfill & Paketbezeichner verwenden zur Darstellung die Schriftart \textsf{Sans Serif}. \\[1em]
        \texttt{file}\spaceddotfill & Datei- und Programmnamen verwenden zur Darstellung die Schriftart \texttt{Typewriter}. \\[1em]
        \texttt{\textbackslash{}macro}\spaceddotfill & Makros, respektive Kommandos, werden mit einem umgekehrten Schrägstrich (backslash) eingeleitet und verwenden zur Darstellung die Schriftart \texttt{Typewriter}.\\[1em]
        \texttt{environment}\spaceddotfill & Umgebungen verwenden zur Darstellung die Schriftart \texttt{Typewriter}. \\[1em]
        \texttt{option}\spaceddotfill & Optionen verwenden zur Darstellung die Schriftart \texttt{Type\-writer}. \\[1em]
        \textit{defval}\spaceddotfill & Standardwerte verwenden zur Darstellung die Schriftart \textit{Italics}. \\[1em]
        \textit{$\langle meta \rangle$}\spaceddotfill & Metadaten, also Platzhalter für Informationen jeglicher Art, verwenden zur Darstellung die Schriftart \textit{Italics} und sind zusätzlich noch in spitzen Klammern eingeschlossen. \\[1em]
        \ttfamily$\{$\textit{$\langle mustarg \rangle$}$\}$\spaceddotfill & Pflichtparameter werden in geschweiften Klammern einge\-schlossen und verwenden zur Formatierung der Daten die Darstellung \textit{$\langle meta \rangle$}. \\[1em]
        {[\textit{$\langle optarg \rangle$}]}\spaceddotfill & Optionale Parameter werden in eckigen Klammern einge\-schlossen und verwenden zur Formatierung der Daten die Darstellung \textit{$\langle meta \rangle$}. \\[1em]
    \end{tabular}
    \endgroup
\end{document}

Đang tự hỏi liệu có cách nào tốt hơn để làm điều này không.

Answer 1

Phần sau chứa một số gợi ý về cách một người có thể cải thiện mã của bạn. Tôi đã loại bỏ tất cả \spaceddotfillcác lệnh và thêm nó trực tiếp vào định nghĩa cột. Thay vì lặp lại [1em], tôi đã sử dụng \setlength\extrarowheight{1em}và để đảm bảo bảng vừa với chiều rộng văn bản, tôi đã tính toán chiều rộng của cột thứ hai và thêm vào \noindentngay trước đầu bảng. Cuối cùng, tôi cũng đã sử dụng \lstinlinetừ listingsgói cho các đoạn mã:

\documentclass{article}
\usepackage{array}
% surround the \dotfill by a bit of blank space
\newcommand{\spaceddotfill}{\phantom{i}\dotfill\phantom{e}}
\usepackage{listings}
\lstset{basicstyle=\itshape}
\begin{document}
 
    \begingroup
    \setlength\extrarowheight{1em}
    \setlength\tabcolsep{0pt}
    \noindent
    \begin{tabular}{p{3.2cm}<{\spaceddotfill}p{\dimexpr\textwidth-3.2cm}}
        \textsf{package} & Paketbezeichner verwenden zur Darstellung die Schriftart \textsf{Sans Serif}. \\
        \texttt{file} & Datei- und Programmnamen verwenden zur Darstellung die Schriftart \texttt{Typewriter}. \\
        \texttt{\textbackslash{}macro} & Makros, respektive Kommandos, werden mit einem umgekehrten Schrägstrich (backslash) eingeleitet und verwenden zur Darstellung die Schriftart \texttt{Typewriter}.\\
        \texttt{environment} & Umgebungen verwenden zur Darstellung die Schriftart \texttt{Typewriter}. \\
        \texttt{option} & Optionen verwenden zur Darstellung die Schriftart \texttt{Type\-writer}. \\
        \textit{defval} & Standardwerte verwenden zur Darstellung die Schriftart \textit{Italics}. \\
        \lstinline|<meta>| & Metadaten, also Platzhalter für Informationen jeglicher Art, verwenden zur Darstellung die Schriftart \textit{Italics} und sind zusätzlich noch in spitzen Klammern eingeschlossen. \\
        \lstinline|{<mustarg>}| & Pflichtparameter werden in geschweiften Klammern einge\-schlossen und verwenden zur Formatierung der Daten die Darstellung \lstinline|<meta>|. \\
        \lstinline|[<optarg>]| & Optionale Parameter werden in eckigen Klammern einge\-schlossen und verwenden zur Formatierung der Daten die Darstellung \lstinline|<meta>|. \\
    \end{tabular}
    \endgroup
\end{document}