From mboxrd@z Thu Jan 1 00:00:00 1970 From: tsd@tsdye.com (Thomas S. Dye) Subject: Re: [RFC] Standardized code block keywords Date: Sun, 23 Oct 2011 06:09:01 -1000 Message-ID: References: <87pqhrih3s.fsf@gmail.com> <87wrby5mus.fsf@gmail.com> <201110231420.26758.DanielBausch@gmx.de> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([140.186.70.92]:38004) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RI0bi-00074a-J4 for emacs-orgmode@gnu.org; Sun, 23 Oct 2011 12:09:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RI0bh-0002zX-8I for emacs-orgmode@gnu.org; Sun, 23 Oct 2011 12:09:06 -0400 Received: from oproxy4-pub.bluehost.com ([69.89.21.11]:53997) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1RI0bg-0002zT-RN for emacs-orgmode@gnu.org; Sun, 23 Oct 2011 12:09:05 -0400 In-Reply-To: <201110231420.26758.DanielBausch@gmx.de> (Daniel Bausch's message of "Sun, 23 Oct 2011 14:20:26 +0200") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Daniel Bausch Cc: emacs-orgmode@gnu.org Daniel Bausch writes: > Am Freitag, 21. Oktober 2011, 21:10:27 schrieb Thomas S. Dye: >> Eric Schulte writes: >> >>> I'm confused by [3] so I will say nothing for now, except to ask some >> >>> questions: are we talking about what a human would use to label a piece >> >>> of data for consumption by a block (including perhaps the future >> >>> possibilities of lists and paragraphs that Tom brought up)? what babel >> >>> would use to label a results block (possibly so that it could be >> >>> consumed by another block in a chain)? both? would that mean >> >>> that #+tblname would go the way of the dodo and that tables would be >> >>> labelled with #+data (or #+object or whatever else we come up with)? >> >> >> >> +1 (Confused, too) >> > >> > well, I guess it is good that this discussion has begun if only to clear >> > up this lingering uncertainty. >> > >> >> I wasn't even aware of #+DATA. Does it do anything TBLNAME and SRCNAME >> >> don't? >> > >> > from the prospective of code blocks it is exactly synonymous with >> > tblname. Srcname is different in that it labels code blocks. >> > >> >> A reason to keep TBLNAME is that it's also used by the spreadsheet >> >> remote references. If Babel looked for DATA instead, a table that is >> >> both a remote reference for another spreadsheet and a data source for >> >> a src block would need both TBLNAME and DATA, which seems redundant. >> > >> > agreed, I'm thinking that tblname will at least remain an option no >> > matter what decision is made. >> > >> >> As for labeling lists and paragraphs, I recall from the list that >> >> Nicolas Goaziou is working on a generalized way to set captions, >> >> labels and attributes for various kinds of Org block, as is possible >> >> now for tables and images. I thought that sounded promising. I don't >> >> know if he planned for block names, too (currently we have tblname but >> >> no imgname), but that could make sense. In which case it might be a >> >> good idea to coordinate. >> > >> > Agreed, I was not aware of this work. Thanks for sharing. In this vein >> > I would like to voice my desire to be able to add captions to code >> > blocks, the lack of this feature has bitten me in the past. >> >> Hi Eric, >> >> For LaTeX export, the listings package has support for code block >> captions. > > Not in org AFAIK, org only supports these for my use cases not very useful > "function name = " exports. I patched org to produce real captions instead, > but my changes are not that well tested and required some changes in the > central export logic. If there is interest I could share what I have so far. > The code quality is a mess, as I do not really know elisp. > > Daniel > > Yes, source code block captions currently have to be handled outside the usual Org-mode mechanism. If you use org-special-blocks and the listings package, then the following template will give you floating code block listings with captions in LaTeX export. : #+BEGIN_listing : : #+LATEX: \caption[The short caption]{The long caption.}\ref{fig:src_blk} : #+END_listing This doesn't do anything for export to other formats, but it works well for LaTeX export. There is even \listoflistings command to produce a list of source code listings in the front matter. All the best, Tom -- Thomas S. Dye http://www.tsdye.com