From mboxrd@z Thu Jan  1 00:00:00 1970
From: Brett Viren <bv@bnl.gov>
Subject: Overriding org-html-headline or other export functions?
Date: Mon, 29 May 2017 08:22:43 -0400
Message-ID: <8637bn3l9o.fsf@bnl.gov>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:51100)
	by lists.gnu.org with esmtp (Exim 4.71) (envelope-from <bv@bnl.gov>)
	id 1dFK9N-00048h-EB
	for emacs-orgmode@gnu.org; Mon, 29 May 2017 08:51:58 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <bv@bnl.gov>) id 1dFK9J-0005I2-I5
	for emacs-orgmode@gnu.org; Mon, 29 May 2017 08:51:57 -0400
Received: from smtpgw.bnl.gov ([2620:10a:0:3::30]:20008 helo=smtpout4.bnl.gov)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_ARCFOUR_SHA1:16) (Exim 4.71)
	(envelope-from <bv@bnl.gov>) id 1dFK9I-0005Hg-BR
	for emacs-orgmode@gnu.org; Mon, 29 May 2017 08:51:53 -0400
Received: from localhost ([127.0.0.1] helo=hal)
	by hierocles.phy.bnl.gov with esmtp (Exim 4.86_2)
	(envelope-from <bv@bnl.gov>) id 1dFJh5-0008rl-ED
	for emacs-orgmode@gnu.org; Mon, 29 May 2017 08:22:43 -0400
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: "emacs-orgmode@gnu.org" <emacs-orgmode@gnu.org>

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.

Thanks for any suggestions!

-Brett.