emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Alex Fu" <alexfu@arcor.de>
To: emacs-orgmode@gnu.org
Subject: Re: Org-mode version 4.68
Date: Mon, 19 Mar 2007 10:21:25 -0400	[thread overview]
Message-ID: <op.tpfwtz1c1wjnvxafu@pc3> (raw)
In-Reply-To: <b21e6a719e5c39840831e1ecd328e4a4@science.uva.nl>

Dear all,

On Fri, 16 Mar 2007 13:08:33 -0400, Carsten Dominik  
<dominik@science.uva.nl> wrote:

>> * Exporting text before the first heading ?
>>
>>   It seems that text before the first heading is not exported.  Using
>>   #+TEXT: might help, but #+TEXT: does not understand links.  Is that
>>   intentional ?
>
> I guess this is not very well though-out, and maybe it would be good
> to simply export the text before the first heading.
> That TEXT is not HTML processed I would also consider as
> a bug, but I know that some have made clever use of this bug
> to insert custom HTML into a file.  This is now no loger
> necessary since you can embed protected HTML with special commands.

Note that the #+HTML: and #+BEGIN_HTML...#+END_HTML directives are not  
(yet) a replacement for inserting literal html as it can be done using  
#+TEXT:.  As far as I've noticed, #+TEXT: inserts html (or any other text)  
before the first heading (before the <h2> in the resulting html file),  
something the #+HTML directives can't do, since the effect of placing it  
before the first heading is null, as it is not exported.

I don't expect to use Org as a full-featured publishing engine.  Still,  
the following example represents a very specific use of #+TEXT: that I  
need for implementing file-specific site navigation (as opposed to  
project-specific, which in this case is configured using :preamble in  
`org-publish-project-alist').  These are the relevant lines in the org  
file:

-----
   #+TEXT: @</p>@<p class="marginpar">@<a href="intro.html">Return to  
introduction@</a>@<p>
   * Sonata for Unaccompanied Achilles
     ^ will be exported as <h2> after <p class="marginpar">...
-----

AFAIK, I can't use #+HTML: to insert that snippet before the <h2>, or  
first level 'org' heading, which is what I need.

> Hmmm, not clear to me how exactly this should be done.  Should we
> cast a vote for exporting text before the first heading?

This is my idea: if the text before the first heading were exported and  
that included the #+HTML: directives, it would be one way (out of perhaps  
a handful) to avoid having to use the #+HTML: and #+TEXT: directives for  
the same purpose -- exporting literal html.  In the end, for literal html  
we'd just use #+HTML: anywhere in the file, while #+TEXT: could be  
reserved for a different purpose.

Vote: +1

But the final decision should consider other (broader) aspects...

Kind regards.

-- 
Alex Fu

  parent reply	other threads:[~2007-03-19 14:22 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2007-03-13  4:31 Org-mode version 4.68 Carsten Dominik
2007-03-16 11:11 ` Bastien
2007-03-16 17:08   ` Carsten Dominik
2007-03-16 18:39     ` Bastien
2007-03-18  7:00       ` Carsten Dominik
2007-03-17 11:38     ` David O'Toole
2007-03-31 21:58       ` T. V. Raman
2007-05-21  6:36         ` Carsten Dominik
2007-03-19 14:21     ` Alex Fu [this message]
2007-03-20 12:14       ` Carsten Dominik
2007-03-21  6:59   ` Carsten Dominik
2007-03-21  8:58     ` Bastien
2007-03-22  8:25 ` Leo

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=op.tpfwtz1c1wjnvxafu@pc3 \
    --to=alexfu@arcor.de \
    --cc=emacs-orgmode@gnu.org \
    /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).