emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Nick Dokos <nicholas.dokos@hp.com>
To: "Thomas S. Dye" <tsd@tsdye.com>
Cc: nicholas.dokos@hp.com, emacs-orgmode list <emacs-orgmode@gnu.org>
Subject: Re: Emphasis etc. in #+CAPTION:
Date: Sun, 28 Mar 2010 21:14:37 -0400	[thread overview]
Message-ID: <32037.1269825277@gamaville.dokosmarshall.org> (raw)
In-Reply-To: Message from "Thomas S. Dye" <tsd@tsdye.com> of "Sun\, 28 Mar 2010 09\:14\:05 -1000." <A349A9C9-FBEB-40C6-813B-5C0C9E408E9D@tsdye.com>

Thomas S. Dye <tsd@tsdye.com> wrote:

> I see in the Org Manual that:
> 
>     You can make words *bold*, /italic/, _underlined_, =code= and
>     ~verbatim~, and, if you must, ‘+strike-through+’. Text in the code
>     and verbatim string is not processed for Org-mode specific syntax,
>     it is exported verbatim.
> 
> So a caption like this doesn't export italicized a, b, c, and d
> (presumably because this is a code string):

Hi Tom,

IIUC, it's not because it's a code string but simply because the caption
is not processed for emphasis (or anything else for that matter - see
below). I think the above text in the manual covers the generic case,
but captions were probably added afterwards and they didn't get the
emphasis treatment.

> 
>     #+CAPTION: Pumice collected from pāhoehoe flows at Manini`ōwali:
>     /a/, pieces that sink in fresh water; /b/, pieces without obvious
>     crystallization or coating (Category A); /c/, pieces with obvious
>     crystallization but no coating (Category B); /d/, pieces with
>     obvious coating (Category C).  The scale is 1 cm.
> 
> Is there a common work-around for this that will produce correct LaTeX
> and HTML using the org-mode exporters?
> 

Can't think of any workaround within org-mode. Post-processing the
output to replace /a/ with \emph{a} for LaTeX and <i>a</i> for HTML,
perhaps restricted to captions, seems possible (but ugly).

> And, this is just a question and not a feature request or a request
> for changes to org-mode, would it be hard to change org-mode's
> behavior so that markup like /a/ in the #+CAPTION: string exports
> correctly marked-up text to LaTeX and HTML?
> 

I think this is the way it works currently:

in org-exp.el:org-export-attach-captions-and-attributes() sets  text properties
on the following line (the first line of a table or the line containing a link)
as follows:

        ...
	(add-text-properties (point-at-bol) end
			     (list 'org-caption cap
				   'org-attributes attr
				   'org-label label))

The various exporters then retrieve the caption with something like the
following code (this is one of the three calls in org-latex.el; the
other calls in this exporter, and the other exporters as well, are
similar):

    (let*
        ...
        (caption (org-find-text-property-in-string 'org-caption raw-path))
        ...

This just gets the value of the given text property without further
elaboration. So I'd guess it's possible to change these calls so that
these values are passed through various filters (emphasis is one of
them, but maybe there are others?) before the exporters get them, but it
is not done today.

But maybe I'm full of it, and somebody will come up with a better idea.

Cheers,
Nick

  reply	other threads:[~2010-03-29  2:15 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-03-28 19:14 Emphasis etc. in #+CAPTION: Thomas S. Dye
2010-03-29  1:14 ` Nick Dokos [this message]
2010-03-29  4:52   ` Thomas S. Dye
2010-03-29 12:20   ` Carsten Dominik

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=32037.1269825277@gamaville.dokosmarshall.org \
    --to=nicholas.dokos@hp.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=tsd@tsdye.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
Be sure your reply has a Subject: header at the top and a blank line before the message body.
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).