當包含文件中的原始程式碼時（為了使其自動保持最新），無法透過編輯原始碼來影響格式。當文件中的某個段落發生變更時，清單可能會變得難以閱讀。
這是因為原始程式碼通常被組織成“段落”（例如下面的函數簽名及其註釋），我不想破壞它們。有沒有辦法強制 lstlisting 只在空行上分頁？下面是一個簡單的例子lstinputlisting：
\RequirePackage{filecontents}
\begin{filecontents*}{stack.mli}
(***********************************************************************)
(* *)
(* OCaml *)
(* *)
(* Xavier Leroy, projet Cristal, INRIA Rocquencourt *)
(* *)
(* Copyright 1996 Institut National de Recherche en Informatique et *)
(* en Automatique. *)
(* *)
(* All rights reserved. This file is distributed under the terms of *)
(* the GNU Lesser General Public License version 2.1, with the *)
(* special exception on linking described in the file LICENSE. *)
(* *)
(***********************************************************************)
(** Last-in first-out stacks.
This module implements stacks (LIFOs), with in-place modification.
*)
type 'a t
(** The type of stacks containing elements of type ['a]. *)
exception Empty
(** Raised when {!Stack.pop} or {!Stack.top} is applied to an empty stack. *)
val create : unit -> 'a t
(** Return a new stack, initially empty. *)
val push : 'a -> 'a t -> unit
(** [push x s] adds the element [x] at the top of stack [s]. *)
val pop : 'a t -> 'a
(** [pop s] removes and returns the topmost element in stack [s],
or raises {!Empty} if the stack is empty. *)
val top : 'a t -> 'a
(** [top s] returns the topmost element in stack [s],
or raises {!Empty} if the stack is empty. *)
val clear : 'a t -> unit
(** Discard all elements from a stack. *)
val copy : 'a t -> 'a t
(** Return a copy of the given stack. *)
val is_empty : 'a t -> bool
(** Return [true] if the given stack is empty, [false] otherwise. *)
val length : 'a t -> int
(** Return the number of elements in a stack. Time complexity O(1) *)
val iter : ('a -> unit) -> 'a t -> unit
(** [iter f s] applies [f] in turn to all elements of [s],
from the element at the top of the stack to the element at the
bottom of the stack. The stack itself is unchanged. *)
val fold : ('b -> 'a -> 'b) -> 'b -> 'a t -> 'b
(** [fold f accu s] is [(f (... (f (f accu x1) x2) ...) xn)]
where [x1] is the top of the stack, [x2] the second element,
and [xn] the bottom element. The stack is unchanged.
@since 4.03 *)
\end{filecontents*}
\documentclass{article}
\usepackage{listings}
\begin{document}
\section{Stack}
\lstset{
basicstyle={\ttfamily\lst@ifdisplaystyle\footnotesize\fi},
language=[Objective]Caml
}
\lstinputlisting{stack.mli}
\end{document}
在上面的例子中，我在copy和 它的註釋之間得到了一個休息，儘管提前一行會好得多。
答案1
根據https://tex.stackexchange.com/a/73305/89417防止清單中分頁的解決方案是使用minipage.因此，將每個程式碼段落放在單獨的小頁面中會在段落之間中斷。您可以使用任何腳本語言輕鬆自動化此操作，例如perl：
print "\\noindent\\begin{minipage}{\\linewidth}\\begin{lstlisting}\n";
while(<>){
print $_ eq "\n" ? "\\end{lstlisting}\\end{minipage}\n\n\\noindent\\begin{minipage}{\\linewidth}\\begin{lstlisting}\n" : $_;
}
print "\\end{lstlisting}\\end{minipage}\n";
該腳本將空白行轉換為小型頁面的結尾和開頭，並添加額外的開頭和結尾以匹配第一個和最後一個段落。
然後，在 LaTeX 中，您可以呼叫此腳本（假設是 Linux，使用 運行--shell-escape）：
\documentclass{article}
\usepackage{listings}
\usepackage[margin=1.5in]{geometry} % make OCaml comment block fit on a line
\begin{document}
\section{Stack}
\lstset{
basicstyle={\ttfamily\lst@ifdisplaystyle\footnotesize\fi},
language=[Objective]Caml
}
\input{|"perl format_listing.pl < stack.mli"}
\end{document}
結果：
答案2
如果只有一個分頁符，一個簡單的方法是使用\enlargethispage.
這會將val copy行移動到下一頁。
\documentclass{article}
\usepackage{listings}
\begin{document}
\section{Stack}
\lstset{
basicstyle={\ttfamily\lst@ifdisplaystyle\footnotesize\fi},
language=[Objective]Caml
}
\enlargethispage{-\baselineskip}
\lstinputlisting{stack.mli}
\end{document}
