emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed

From: tsd@tsdye.com (Thomas S. Dye)
To: Bastien <bzg@altern.org>
Cc: emacs-orgmode@gnu.org, Giles Chamberlin <giles.chamberlin@cisco.com>
Subject: Re: src blocks, listings package and captions
Date: Thu, 25 Aug 2011 05:47:42 -1000	[thread overview]
Message-ID: <m18vqhijc1.fsf@tsdye.com> (raw)
In-Reply-To: <87ei0ac4ko.fsf@gnu.org> (Bastien's message of "Thu, 25 Aug 2011 09:50:47 +0200")

Bastien <bzg@altern.org> writes:

> Hi Giles,
>
> Giles Chamberlin <giles.chamberlin@cisco.com> writes:
>
>> I'm using the listings package and org-version 7.4 to generate latex/pdf
>> output including source snippets.  I'd like to add captions: "Figure 1:
>> My code" and tried with the following to no avail:
>>
>> #+caption: My code
>> #+begin_src clojure
>>  ;; stuff
>> #+end_src
>>
>> Do I have to wrap this in \begin{figure}\caption{} or is there a simpler
>> way?
>
> Since captions make sense for figures, I think you have to wrap this
> in \begin{figure}\caption{}.  But maybe there is a way to automatically
> wrap source blocks into a caption-aware LaTeX environment -- Eric might
> give a more useful answer.
>
> Thanks,

Aloha Giles,

A caption-aware LaTeX environment is provided by the minted package.
If you use org-special-blocks, then you can wrap your source block in
#+BEGIN_listing ... #+END_listing.  You can get a caption and label by
also including something like this within the special block:

#+LATEX: \caption{The caption.}\label{fig:src_blk}

If you want to stick with the listings package, then you will need to
define a listing environment that mimics what the minted package does.
There are at least two ways to do this in LaTeX (and probably others).
One way is to use the float package and then do something like this:

    {\newfloat{listing}{h}{lol}
    \newcommand\listingscaption{Listing}
    \floatname{listing}{\listingscaption}
    \newcommand\listoflistingscaption{List of Listings}
    \providecommand\listoflistings{\listof{listing}{\listoflistingscaption}}
    \floatplacement{listing}{htb!}

hth,
Tom

-- 
Thomas S. Dye
http://www.tsdye.com

next prev parent reply	other threads:[~2011-08-25 15:47 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-08-24 15:58 src blocks, listings package and captions Giles Chamberlin
2011-08-25  7:50 ` Bastien
2011-08-25 15:47   ` Thomas S. Dye [this message]
2011-08-31 14:44     ` Giles Chamberlin
2011-08-25 15:11 ` Eric Schulte

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=m18vqhijc1.fsf@tsdye.com \
    --to=tsd@tsdye.com \
    --cc=bzg@altern.org \
    --cc=emacs-orgmode@gnu.org \
    --cc=giles.chamberlin@cisco.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).