From: "Charles C. Berry" <ccberry@ucsd.edu>
To: Brett Viren <bv@bnl.gov>
Cc: "emacs-orgmode@gnu.org" <emacs-orgmode@gnu.org>
Subject: Re: Overriding org-html-headline or other export functions?
Date: Mon, 29 May 2017 10:38:06 -0700 [thread overview]
Message-ID: <alpine.OSX.2.20.1705291012091.772@charles-berrys-macbook.local> (raw)
In-Reply-To: <8637bn3l9o.fsf@bnl.gov>
On Mon, 29 May 2017, Brett Viren wrote:
> Hi,
>
> I am writing a manual in Org which gets exported/published to HTML and
> styled with org-html-themes. I want the HTML to include a little icon
> next to each headline which is a direct link to the headline itself.
> Basically, I want to rip off what GitHub does when it renders Org.
>
> First, is there some way to achieve this headline link without
> explicitly adding it in the Org text or diving into Org Elisp?
>
> I couldn't find one so I took the latter route by copying out the whole
> of org-html-headline into the Emacs init Elisp file I used for
> publishing and fiddle with it until I got more or less what I wanted.
> Here are the lines tweaked:
>
> https://github.com/WireCell/wire-cell-docs/blob/master/manuals/publish.el#L69
>
> Here is an example of the result:
>
> http://www.phy.bnl.gov/~bviren/wirecell.github.io/manual.html
>
> Is this copy+hack the proper way to tweak the exporting in this case?
> In particular, I worry about my copy of org-html-headline diverging from
> the real.
>
>
> I read about export filters and extending an existing back-end, but I
> think these do not apply, but maybe I have that wrong.
>
You do have that wrong. This is exactly what export filters and derived
backends are for. In fact, you can use both. For an example, see
http://orgmode.org/worg/exporters/filter-markup.html
You will want to change `latex' to `html' in the
`(org-export-define-derived-backend ...)'
call and delete all filters except for `:filter-headline'. And revise
`ox-mrkup-filter-headline' accordingly.
And of course, you will want to look at
http://orgmode.org/worg/dev/org-export-reference.html
HTH,
Chuck
next prev parent reply other threads:[~2017-05-29 17:38 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-05-29 12:22 Overriding org-html-headline or other export functions? Brett Viren
2017-05-29 17:38 ` Charles C. Berry [this message]
2017-05-29 18:20 ` Brett Viren
2017-05-29 20:34 ` Brett Viren
2017-05-29 20:35 ` Charles C. Berry
2017-05-29 18:33 ` Marcin Borkowski
2017-05-29 19:14 ` Brett Viren
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=alpine.OSX.2.20.1705291012091.772@charles-berrys-macbook.local \
--to=ccberry@ucsd.edu \
--cc=bv@bnl.gov \
--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).