footnotes as [references]?

footnotes as [references]?

[Stefan Vollmar]

Hello,

we want to have a "traditional" reference section in a software  
documentation we are currently writing using org-mode. Org's Footnote  
feature is almost perfect for the job, however, I prefer the "[123]"- 
type of reference rather than the superscript notation org generates  
for HTML-export. Is there a way to change the appearance of footnotes  
(still hyperlinked, of course) to the square-bracket version in HTML  
output?

Many thanks in advance.

Warm regards,
  Stefan
-- 
Dr. Stefan Vollmar, Dipl.-Phys.
Max-Planck-Institut für neurologische Forschung
Gleuelerstr. 50, 50931 Köln, Germany
Tel.: +49-221-4726-213  FAX +49-221-4726-298
Tel.: +49-221-478-5713  Mobile: 0160-93874279
Email: vollmar@nf.mpg.de   http://www.nf.mpg.de

Re: footnotes as [references]?

[Bastien]

Hi Stefan,

Stefan Vollmar <vollmar@nf.mpg.de> writes:

> we want to have a "traditional" reference section in a software
> documentation we are currently writing using org-mode. Org's Footnote
> feature is almost perfect for the job, however, I prefer the "[123]"- 
> type of reference rather than the superscript notation org generates for
> HTML-export. Is there a way to change the appearance of footnotes
> (still hyperlinked, of course) to the square-bracket version in HTML
> output?

Now there is a new option `org-export-html-footnote-format'.

You can set this to " [%s]" and the references will be in the format 
you describe.

Thanks for this idea,

-- 
 Bastien

Re: footnotes as [references]?

[Stefan Vollmar]

Dear Bastien,

On 27.07.2009, at 05:35, Bastien wrote:

>> we want to have a "traditional" reference section in a software
>> documentation we are currently writing using org-mode. Org's Footnote
>> feature is almost perfect for the job, however, I prefer the "[123]"-
>> type of reference rather than the superscript notation org  
>> generates for
>> HTML-export. Is there a way to change the appearance of footnotes
>> (still hyperlinked, of course) to the square-bracket version in HTML
>> output?
>
> Now there is a new option `org-export-html-footnote-format'.
>
> You can set this to " [%s]" and the references will be in the format
> you describe.
>
> Thanks for this idea,


EXCELLENT, thank you!

Small things:

(1) Using the "fn:" style of footnotes, org generates a "Footnotes:"  
section in HTML export. In org-footnote.el I found that I might need  
to set
org-footnote-tag-for-non-org-mode-files to change "Footnotes" to  
"References" (or some other name), however,
(setq org-footnote-tag-for-non-org-mode-files "References")
does not seem to work for me.

(2) If, with
(setq org-export-html-footnote-format " [%s]")
we now have a "[123]"-style of footnotes (that works great!), the list  
of footnotes/references at the end of the document should also have  
the square-bracket-notation.

(3) I believe that the square-bracket-style might be of interest to  
many users and maybe there should be a #+options-switch to toggle  
superscript- and square-bracket-style.

Warm regards,
  Stefan
-- 
Dr. Stefan Vollmar, Dipl.-Phys.
Max-Planck-Institut für neurologische Forschung
Gleuelerstr. 50, 50931 Köln, Germany
Tel.: +49-221-4726-213  FAX +49-221-4726-298
Tel.: +49-221-478-5713  Mobile: 0160-93874279
Email: vollmar@nf.mpg.de   http://www.nf.mpg.de

Re: footnotes as [references]?

[Bastien]

Hi Stefan,

Stefan Vollmar <vollmar@nf.mpg.de> writes:

> Small things:
>
> (1) Using the "fn:" style of footnotes, org generates a "Footnotes:"
> section in HTML export. In org-footnote.el I found that I might need  to
> set
> org-footnote-tag-for-non-org-mode-files to change "Footnotes" to
> "References" (or some other name), however,
> (setq org-footnote-tag-for-non-org-mode-files "References")
> does not seem to work for me.

I think you're looking for `org-export-language-setup'.

`org-footnote-tag-for-non-org-mode-files' is only useful for non-org
files -- see the docstring.

> (2) If, with
> (setq org-export-html-footnote-format " [%s]")
> we now have a "[123]"-style of footnotes (that works great!), the list
> of footnotes/references at the end of the document should also have  the
> square-bracket-notation.

Fixed, thanks!

> (3) I believe that the square-bracket-style might be of interest to many
> users and maybe there should be a #+options-switch to toggle
> superscript- and square-bracket-style.

Why not, let's see if people would find this useful.

best,

-- 
 Bastien