[Orgmode] Re: Org-special-blocks for code chunks
Hi Chris,
Chris Gray wrote:
Sébastien Vauban wrote:
I have a problem exporting code chunks to LaTeX (beamer, in fact -- but
that does not change anything to the problem) that contain underscores.
I can't get a properly outputted underscore in my slide.
Any idea or workaround?
Is lstlisting like a verbatim environment?
Yes, it is. What's extra is the highlight of keywords, contextual for every
programming language.
I think you might be able to just use \begin{lstlisting}
and \end{lstlisting} in that case. Org does not interpret anything inside
such blocks, which is why org-special-blocks was created in the first place.
OK. That works.
Though, I'm lost about choosing the best representation for code chunks (I
don't even speak here of literate programming) to be shown in slides or
documents.
Look, I've done an ECM with the different ways I currently see for Org-mode:
--8---cut here---start-8---
* Org
*** A. To escape the \_
* 1. No marking at all
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
* 2. Literal LaTeX code
#+LaTeX: \begin{lstlisting}
months_employed(?applicant, ?months)
#+LaTeX: \end{lstlisting}
* 3. Lines between markers
#+BEGIN_LaTeX
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
#+END_LaTeX
* 4. Org-special-blocks
#+BEGIN_lstlisting
months_employed(?applicant, ?months)
#+END_lstlisting
*** B. Or not to escape the _?
* 1. No marking at all
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
* 2. Literal LaTeX code
#+LaTeX: \begin{lstlisting}
months\_employed(?applicant, ?months)
#+LaTeX: \end{lstlisting}
* 3. Lines between markers
#+BEGIN_LaTeX
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
#+END_LaTeX
* 4. Org-special-blocks
#+BEGIN_lstlisting
months\_employed(?applicant, ?months)
#+END_lstlisting
--8---cut here---end---8---
Without org-special-blocks, I have such LaTeX generated:
--8---cut here---start-8---
% Created 2009-08-13 Thu 12:07
\documentclass[final]{mcreport}
\usepackage[utf8x]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{graphicx}
\usepackage{longtable}
\usepackage{hyperref}
\usepackage{xcolor}
\usepackage{listings}
\title{ecm-escape}
\author{Fabrice Niessen}
\date{13 August 2009}
\begin{document}
\maketitle
\setcounter{tocdepth}{3}
\tableofcontents
\vspace*{1cm}
\section{Org}
\label{sec-1}
\subsection{A. To escape the \_}
\label{sec-1.1}
\subsubsection{1. No marking at all}
\label{sec-1.1.1}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{2. Literal \LaTeX{} code}
\label{sec-1.1.2}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{3. Lines between markers}
\label{sec-1.1.3}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{4. Org-special-blocks}
\label{sec-1.1.4}
months$_{\mathrm{employed}}$(?applicant, ?months)
\subsection{B. Or not to escape the _?}
\label{sec-1.2}
\subsubsection{1. No marking at all}
\label{sec-1.2.1}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{2. Literal \LaTeX{} code}
\label{sec-1.2.2}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{3. Lines between markers}
\label{sec-1.2.3}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{4. Org-special-blocks}
\label{sec-1.2.4}
months\_employed(?applicant, ?months)
\end{document}
--8---cut here---end---8---
With org-special-blocks turned on, I have:
--8---cut here---start-8---
% Created 2009-08-13 Thu 12:10
\documentclass[final]{mcreport}
\usepackage[utf8x]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{graphicx}
\usepackage{longtable}
\usepackage{hyperref}
\usepackage{xcolor}
\usepackage{listings}
\title{ecm-escape}
\author{Fabrice Niessen}
\date{13 August 2009}
\begin{document}
\maketitle
\setcounter{tocdepth}{3}
\tableofcontents
\vspace*{1cm}
\section{Org}
\label{sec-1}
\subsection{A. To escape the \_}
\label{sec-1.1}
\subsubsection{1. No marking at all}
\label{sec-1.1.1}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{2. Literal \LaTeX{} code}
\label{sec-1.1.2}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{3. Lines between markers}
\label{sec-1.1.3}
\begin{\LaTeX{}}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\end{\LaTeX{}}
\subsubsection{4. Org-special-blocks}
\label{sec-1.1.4}
\begin{lstlisting}
months$_{\mathrm{employed}}$(?applicant, ?months)
\end{lstlisting}
\subsection{B. Or not to escape the _?}
\label{sec-1.2}
\subsubsection{1. No marking at all}
\label{sec-1.2.1}
\begin{lstlisting}
[Orgmode] Re: Org-special-blocks for code chunks
Hi Seb, Thanks for testing things so extensively. Look, I've done an ECM with the different ways I currently see for Org-mode: I've never seen the term ECM before. What does it mean? Conclusions? - Org-special-blocks seems to misbehave in cases A3/B3 (adding an unsound environment) and A4 (letting the underscore being converted); I would argue that it is only misbehaving in A3 and B3, since the whole point of org-special-blocks is that org-style interpretation of your text is happening inside the blocks. In this sense, it was never really meant to be used with verbatim-type environments. (I use it mainly for things like lemma and proof environments). I think that A3/B3 show a bug, though, so that should be fixed. (Either with a special case in org-special-blocks or by moving the hook around in org-exp-latex). I will try to have a look at this later. - Though, case A1 is not very friendly: nothing tells I'm inline LaTeX code (what about other exports, as HTML and the like?) I'm not sure, but I think it sends the whole thing to latex and then renders the output as an image. Cheers, Chris ___ Emacs-orgmode mailing list Remember: use `Reply All' to send replies to the list. Emacs-orgmode@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-orgmode
[Orgmode] Re: Org-special-blocks for code chunks
Hi Chris, Chris Gray wrote: Thanks for testing things so extensively. No prob. Trying to fully understand all sides of the problem. Look, I've done an ECM with the different ways I currently see for Org-mode: I've never seen the term ECM before. What does it mean? ECM is French for Exemple Complet Minimal (= Minimal Complete Example). Conclusions? - Org-special-blocks seems to misbehave in cases A3/B3 (adding an unsound environment) and A4 (letting the underscore being converted); I would argue that it is only misbehaving in A3 and B3, since the whole point of org-special-blocks is that org-style interpretation of your text is happening inside the blocks. About A4: maybe you're right, yes. In this sense, it was never really meant to be used with verbatim-type environments. (I use it mainly for things like lemma and proof environments). I think that A3/B3 show a bug, though, so that should be fixed. (Either with a special case in org-special-blocks or by moving the hook around in org-exp-latex). I will try to have a look at this later. OK. Thanks. - Though, case A1 is not very friendly: nothing tells I'm inline LaTeX code (what about other exports, as HTML and the like?) I'm not sure, but I think it sends the whole thing to latex and then renders the output as an image. Never using HTML... But when it comes to make a choice for my whole life ;-), I must take this into account... Best regards, Seb -- Sébastien Vauban ___ Emacs-orgmode mailing list Remember: use `Reply All' to send replies to the list. Emacs-orgmode@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-orgmode
Re: [Orgmode] Re: Org-special-blocks for code chunks
Sébastien Vauban wxhgmqzgw...@spammotel.com writes:
[...]
Look, I've done an ECM with the different ways I currently see for Org-mode:
I haven't followed this whole thread, so please forgive me if I'm
duplicating information. With the latest Org-mode from git, regular
source-code blocks can be exported into the lstlisting LaTeX
environment. I mention this because it does not appear as an option in
your ECM. For instructions see
http://orgmode.org/worg/org-faq.php#fontified_source_code_w_latex
-- Eric
* Org
*** A. To escape the \_
* 1. No marking at all
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
* 2. Literal LaTeX code
#+LaTeX: \begin{lstlisting}
months_employed(?applicant, ?months)
#+LaTeX: \end{lstlisting}
* 3. Lines between markers
#+BEGIN_LaTeX
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
#+END_LaTeX
* 4. Org-special-blocks
#+BEGIN_lstlisting
months_employed(?applicant, ?months)
#+END_lstlisting
*** B. Or not to escape the _?
* 1. No marking at all
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
* 2. Literal LaTeX code
#+LaTeX: \begin{lstlisting}
months\_employed(?applicant, ?months)
#+LaTeX: \end{lstlisting}
* 3. Lines between markers
#+BEGIN_LaTeX
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
#+END_LaTeX
* 4. Org-special-blocks
#+BEGIN_lstlisting
months\_employed(?applicant, ?months)
#+END_lstlisting
Without org-special-blocks, I have such LaTeX generated:
% Created 2009-08-13 Thu 12:07
\documentclass[final]{mcreport}
\usepackage[utf8x]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{graphicx}
\usepackage{longtable}
\usepackage{hyperref}
\usepackage{xcolor}
\usepackage{listings}
\title{ecm-escape}
\author{Fabrice Niessen}
\date{13 August 2009}
\begin{document}
\maketitle
\setcounter{tocdepth}{3}
\tableofcontents
\vspace*{1cm}
\section{Org}
\label{sec-1}
\subsection{A. To escape the \_}
\label{sec-1.1}
\subsubsection{1. No marking at all}
\label{sec-1.1.1}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{2. Literal \LaTeX{} code}
\label{sec-1.1.2}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{3. Lines between markers}
\label{sec-1.1.3}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{4. Org-special-blocks}
\label{sec-1.1.4}
months$_{\mathrm{employed}}$(?applicant, ?months)
\subsection{B. Or not to escape the _?}
\label{sec-1.2}
\subsubsection{1. No marking at all}
\label{sec-1.2.1}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{2. Literal \LaTeX{} code}
\label{sec-1.2.2}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{3. Lines between markers}
\label{sec-1.2.3}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{4. Org-special-blocks}
\label{sec-1.2.4}
months\_employed(?applicant, ?months)
\end{document}
With org-special-blocks turned on, I have:
% Created 2009-08-13 Thu 12:10
\documentclass[final]{mcreport}
\usepackage[utf8x]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{graphicx}
\usepackage{longtable}
\usepackage{hyperref}
\usepackage{xcolor}
\usepackage{listings}
\title{ecm-escape}
\author{Fabrice Niessen}
\date{13 August 2009}
\begin{document}
\maketitle
\setcounter{tocdepth}{3}
\tableofcontents
\vspace*{1cm}
\section{Org}
\label{sec-1}
\subsection{A. To escape the \_}
\label{sec-1.1}
\subsubsection{1. No marking at all}
\label{sec-1.1.1}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{2. Literal \LaTeX{} code}
\label{sec-1.1.2}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{3. Lines between markers}
\label{sec-1.1.3}
\begin{\LaTeX{}}
\begin{lstlisting}
months_employed(?applicant, ?months)
\end{lstlisting}
\end{\LaTeX{}}
\subsubsection{4. Org-special-blocks}
\label{sec-1.1.4}
\begin{lstlisting}
months$_{\mathrm{employed}}$(?applicant, ?months)
\end{lstlisting}
\subsection{B. Or not to escape the _?}
\label{sec-1.2}
\subsubsection{1. No marking at all}
\label{sec-1.2.1}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{2. Literal \LaTeX{} code}
\label{sec-1.2.2}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\subsubsection{3. Lines between markers}
\label{sec-1.2.3}
\begin{\LaTeX{}}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\end{\LaTeX{}}
\subsubsection{4. Org-special-blocks}
\label{sec-1.2.4}
\begin{lstlisting}
months\_employed(?applicant, ?months)
\end{lstlisting}
\end{document}
Conclusions?
- Org-special-blocks seems
[Orgmode] Re: Org-special-blocks for code chunks
Sébastien Vauban wrote:
I have a problem exporting code chunks to LaTeX (beamer, in fact -- but that
does not change anything to the problem) that contain underscores.
[snip]
So, I can't get a properly outputted underscore in my slide.
Any idea or workaround?
Hi Seb,
Is lstlisting like a verbatim environment? I think you might be able to
just use \begin{lstlisting} and \end{lstlisting} in that case. Org does
not interpret anything inside such blocks, which is why
org-special-blocks was created in the first place.
Cheers,
Chris
___
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode
