跳至主要內容
EasyLaTeXDocs

腳註、邊注與程式碼排版

腳註用於補充但不打斷正文的資訊,邊注用於短提示,程式碼應按長度選擇行內等寬字型、原樣環境或帶高亮的程式碼塊。三者都應節制使用,避免壓縮正文的閱讀空間。

EasyLaTeX 編譯器設定:XeLaTeX + ctex;邊注示例使用 marginnote,程式碼塊使用 listings。listings 對中文原始碼支援有限,含中文註解的程式碼可改用 verbatim 或專用高亮方案。

新增腳註

在需要補充說明的位置使用 \footnote{...}:

LaTeX
該術語採用行業常見定義\footnote{不同標準的表述可能略有差異。}。

LaTeX 會自動編號並把腳註排到頁面底部。腳註應補充來源、例外或簡短解釋,不應承載一段新的論證。

拆分腳註標記和文字

表格、標題等不能直接使用普通腳註的地方,可拆分標記和文字:

LaTeX
表格標題\footnotemark...\footnotetext{該資料經過四捨五入。}

兩個指令需要處於同一頁附近,並按出現順序配對。複雜表格腳註應優先遵循目標模板或使用表格專用方案。

新增邊注

\marginpar 是 LaTeX 內建邊注,\marginnote 更適合在當前位置放置短註解:

LaTeX
\usepackage{marginnote}​這個結論需要複核。\marginnote{待補充來源}

邊注會佔用頁邊距空間,雙面文件還要考慮它出現在哪一側。長邊注會與頁首、腳註或其他邊注衝突,因此只放簡短關鍵詞。

排版行內程式碼

短指令、檔名或變數使用 \texttt:

LaTeX
主檔案通常命名為 \texttt{main.tex}。

需要逐字顯示且內容不含分隔符時可用 \verb|...|:

LaTeX
\verb|\section{標題}|

\verb 不能放在移動參數中,例如章節標題、圖題和腳註;這些位置使用 \texttt 或專用套件指令。

排版程式碼塊

少量原樣文字使用 verbatim:

LaTeX
\begin{verbatim}main.texfigures/result.pdf\end{verbatim}

需要編號、自動換行或語法高亮時使用 listings:

LaTeX
\usepackage{listings}\usepackage{xcolor}\lstset{  basicstyle=\ttfamily\small,  frame=single,  breaklines=true}​\begin{lstlisting}[language=Python]total = sum(values)print(total)\end{lstlisting}

程式碼塊應保留原有縮排,並在正文中說明它的輸入、輸出或作用,而不是隻貼出一段無法執行的程式碼。

常見問題

腳註跑到下一頁

這是頁底空間不足的正常排版結果。縮短腳註、調整正文結構或讓相關句子換頁;不要用大量負間距強行拉回腳註。

邊注與正文或其他邊注重疊

縮短邊注,減少同頁數量,或改用腳註。邊注不適合密集註解和關鍵正文資訊。

listings 中中文亂碼

listings 對 Unicode 和中文註解支援有限。英文程式碼可繼續使用它;含中文的原樣內容使用 verbatim,或採用專案模板已經配置的程式碼高亮工具。

完整示例

LaTeX
\documentclass[UTF8,a4paper,12pt]{ctexart}\ctexset{contentsname={目錄},listfigurename={插圖目錄},listtablename={表格目錄},figurename={圖},tablename={表}}\usepackage{marginnote}\usepackage{listings}\usepackage{xcolor}\lstset{basicstyle=\ttfamily\small, frame=single, breaklines=true}​\begin{document}​使用 \texttt{main.tex} 作為主檔案\footnote{專案的唯一編譯入口。}。\marginnote{編譯前檢查引擎}​\begin{lstlisting}[language=Python]total = sum(values)print(total)\end{lstlisting}​\end{document}