From mboxrd@z Thu Jan  1 00:00:00 1970
From: "Eric Schulte" <schulte.eric@gmail.com>
Subject: Re: Re: Feature request: org-export-format-source-code-or-example
 and srcname
Date: Tue, 05 Jan 2010 08:56:23 -0700
Message-ID: <87bph81r6g.fsf@gmail.com>
References: <51b0095d0912020941i4e461639m78b01316810c07c2@mail.gmail.com>
	<CF929305-F0B7-4196-ADE7-01FE9CAA202B@gmail.com>
	<87vdg6m02o.fsf@mundaneum.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1NSBm0-00067e-2q
	for emacs-orgmode@gnu.org; Tue, 05 Jan 2010 10:56:44 -0500
Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1NSBlv-000645-Dl
	for emacs-orgmode@gnu.org; Tue, 05 Jan 2010 10:56:43 -0500
Received: from [199.232.76.173] (port=54933 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1NSBlv-00063s-8o
	for emacs-orgmode@gnu.org; Tue, 05 Jan 2010 10:56:39 -0500
Received: from mail-bw0-f215.google.com ([209.85.218.215]:37306)
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <schulte.eric@gmail.com>) id 1NSBlu-0007AD-2S
	for emacs-orgmode@gnu.org; Tue, 05 Jan 2010 10:56:38 -0500
Received: by bwz7 with SMTP id 7so11186030bwz.26
	for <emacs-orgmode@gnu.org>; Tue, 05 Jan 2010 07:56:31 -0800 (PST)
In-Reply-To: <87vdg6m02o.fsf@mundaneum.com> (=?utf-8?Q?=22S=C3=A9bastien?=
	Vauban"'s message of "Thu, 17 Dec 2009 10:17:19 +0100")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: =?utf-8?Q?S=C3=A9bastien?= Vauban <wxhgmqzgwmuf@spammotel.com>
Cc: emacs-orgmode@gnu.org

Hi,

A first pass at this functionality has just been deployed.  The current
solution is very simple, but from here it should be relatively easy to
improve the look and feel of the exported names.

As described here [1], when exporting to html the source-name will be
included in a <label> element immediately preceding the <pre> block
containing the code, so

#+source: square
#+begin_src emacs-lisp :var input=3D1
  (* input input)
#+end_src

will export to

<label class=3D"org-src-name">square</label>
<pre class=3D"src src-emacs-lisp">
<span style=3D"color: #7f7f7f;">(</span>* input input<span style=3D"color: =
#7f7f7f;">)</span>
</pre>

and in LaTeX the source-name will be added as a listings title element,
so the above block will export to the following LaTeX.

\lstset{language=3DLisp}\begin{lstlisting}[title=3D{square}]
(* input input)
\end{lstlisting}

Please let me know how this should be improved.

Thanks -- Eric

S=C3=A9bastien Vauban <wxhgmqzgwmuf@spammotel.com> writes:

> Hi Carsten and Nicolas,
>
> (BTW, Nicolas, excellent modifications made to the agenda look & feel!)
>
> Carsten Dominik wrote:
>>> when using the listings LaTeX package, it would be very useful if the
>>> value of srcname was added to the output. For instance,
>>>
>>> #+srcname: my_code_chunk
>>> #+begin_src latex :results latex :exports code :tangle no
>>> \usepackage{fontspec,xunicode,xltxtra}
>>> #+end_src
>>>
>>> would give:
>>>
>>> \lstset{language=3DTeX}[caption=3D{my\_code\_chunk}]
>>> \begin{lstlisting}
>>> \usepackage{fontspec,xunicode,xltxtra}
>>> \end{lstlisting}
>>>
>>> (note the added "[caption=3D{my\_code\_chunk}]")
>>
>> Is there anyone besides Nicolas what would like to see the source name in
>> the exported listing?
>
> Yes! This is not only desired, but -- for me -- completely required: with=
out
> it, you simply can't do real literate programming documentation...
>
> An example of how it would be nice to be (using NoWeb):
>
>     http://www.mygooglest.com/sva/ecm-noweb.pdf
>
> See my (unanswered) thread of 2009-12-04 at 12:13: "[babel] Org-babel vs =
NoWeb
> (and the like)".
>
>
>> Is that something that should be done in org-babel, or in the normal exp=
ort
>> stuff?
>
> I would answer Org-babel, but if there is one thing I'm sure of, is that I
> don't understand all the implications of my answer. So, take it with low
> consideration.
>
> Best regards,
>   Seb

Footnotes:=20
[1]  http://eschulte.github.com/babel-dev/STARTED-Suitable-export-of-%23%2B=
srcname-and-%23%2Bresname-lines.html