防止org-mode将注释转换为itemize环境

时间:2012-03-12 09:39:01

标签: latex org-mode listings

我有一个org-mode文档,我想将其导出为PDF格式。我正在使用LaTeX列表包生成格式良好的代码清单,在org中看起来像这样:

#+BEGIN_LaTeX
\begin{lstlisting}[language=Java]
    /** Comment comment comment
     * 
     * blah blah blah
     * 
     * @return comment
     */
    public void foo() {
        return;
    }
\end{lstlisting}
#+END_LaTeX

Javadoc评论由org翻译为LaTeX itemize环境,如下所示:

\begin{lstlisting}[language=Java]
    /** Comment comment comment
\begin{itemize}
\item 
\item blah blah blah
\item 
\item @return comment
\end{itemize}
     */
    public void foo() {
        return;
    }
\end{lstlisting}

如何防止这种情况发生并保留Javadoc,因为我最初编写它?如果我使用#+BEGIN_SRC而不是#+BEGIN_LaTeX我得到的是verbatim环境,但我想坚持使用列表而不是verbatim或者铸造,因为我已经制作了努力为它设置一套漂亮的造型。

1 个答案:

答案 0 :(得分:6)

你最终想要的是literal example。基本上你想要导出代码,但是要完成。您需要告诉org-mode在导出时使用列表(或铸造)。这可以在 .emacs 文件中完成:

;; tell org to use listings with colors                                                     
(setq org-export-latex-listings t)
(add-to-list 'org-export-latex-packages-alist '("" "listings"))
(add-to-list 'org-export-latex-packages-alist '("" "color"))

此外,使用此功能,您无需在文档的标头参数中指定listings包。现在,源代码块将在适当的lstlistings环境中导出:

#+begin_src java                                                                
  /** Comment comment comment                                                   
   *                                                                            
   * blah blah blah                                                             
   * @return comment                                                            
   */                                                                           
  public void foo() {                                                           
    return;                                                                   
  }                                                                             
#+end_src

的形式导出到LaTeX
\lstset{language=java}
\begin{lstlisting}
/** Comment comment comment
 *
 * blah blah blah
 * @return comment
 */
public void foo() {
    return;
}
\end{lstlisting}

我不太确定为什么,当你在你的例子中使用#+begin_latex ... #+end_latex块时,事情会被奇怪地解析。原则上,人们希望将LaTeX块中的任何内容按原样传递给 .tex 文件。