From: Matthew Lundin <mdl@imapmail.org>
To: Scot Becker <scot.becker@gmail.com>
Cc: Paul R <paul.r.ml@gmail.com>, emacs-orgmode@gnu.org
Subject: Re: Re: Footnotes and org-export, revisited
Date: Wed, 17 Dec 2008 14:54:18 -0600 [thread overview]
Message-ID: <87myeu4j5x.fsf@fastmail.fm> (raw)
In-Reply-To: <e0e1fe620812170759q715cae29u2f38c9fe840a06ea@mail.gmail.com> (Scot Becker's message of "Wed\, 17 Dec 2008 15\:59\:42 +0000")
I was away from my computer for a few hours and was delighted to
discover this thread. This truly is an amazing mailing list.
"Scot Becker" <scot.becker@gmail.com> writes:
> I'm torn.
>
> Usage 1 is harder to read. My footnotes, for example, are very long
> compared to your example. Of course, within emacs, this could be made
> much less severe with a little syntax coloring. It has the advantage
> that it never gets lost or otherwise mangled without your knowledge,
> and you don't have to wonder whether you used 'kenpo' as a reference
> already, and just what might be the consequences if you did. It's
> only liability is readability.
I would agree that anonymous foonotes are more stable and reliable for
authors, since they're embedded in the text and are easy to move
(consisting as they do of only one part). I really like how elegant
footnote markup is in LaTeX. AUCTeX solves readability problems by
allowing the user to fold footnote macros and by indenting the text of
footnotes when filling paragraphs. I wonder whether something similar
could be implemented in in org-mode (perhaps akin to the way org-mode
already hides links).
>
> Usage 2 is easier to read, which is the trend in plain-text markup
> these days. Pandoc, Multi-Markdown and ReST all do it this way,
> which isn't to say that we should. It is a little more fragile,
> since I might move the paragraph and forget its accompanying
> footnote, and it leaves the user to come up with an original
> reference name, which could get to be burdensome in if you try to
> write in an academic field which averages 3-5 footnotes per page (1
> per 75 words or so). It's also more typing work.
I once played around with ReST, footnote export was fairly finicky.
(I'm more than willing to attribute this to my own lack of
understanding). It can be tricky to think of unique labels for each
footnote and to keep references in order. As I understand it, the
primary rationale for labelled footnotes in simple markup is to create
a source text that someone unfamiliar with the markup can read easily.
Since org-mode has ASCII export capabilities and can hide markup when
displaying text (e.g., hyperlinks, drawers), I wonder whether these
legibility issues are quite so crucial.
Best,
Matt
next prev parent reply other threads:[~2008-12-17 20:54 UTC|newest]
Thread overview: 26+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-12-17 12:52 Footnotes and org-export, revisited Scot Becker
2008-12-17 13:28 ` Paul R
2008-12-17 13:31 ` Carsten Dominik
2008-12-17 15:29 ` Paul R
2008-12-17 15:59 ` Scot Becker
2008-12-17 20:54 ` Matthew Lundin [this message]
2008-12-17 22:23 ` Scot Becker
2008-12-17 16:08 ` Carsten Dominik
2008-12-17 16:32 ` Paul R
2008-12-17 16:58 ` Carsten Dominik
2008-12-17 17:25 ` Paul R
2008-12-17 17:18 ` Sivaram Neelakantan
2008-12-18 8:08 ` Carsten Dominik
2008-12-18 17:13 ` Sivaram Neelakantan
2008-12-18 10:34 ` Peter Frings
2008-12-18 10:55 ` Peter Frings
2008-12-17 14:04 ` Jörg Hagmann
2009-01-01 9:07 ` Carsten Dominik
2009-01-01 16:48 ` Matthew Lundin
2009-01-01 17:10 ` Carsten Dominik
2009-01-02 15:10 ` Matthew Lundin
2009-01-03 8:17 ` Carsten Dominik
2009-01-03 22:53 ` Matthew Lundin
2009-01-04 7:39 ` Carsten Dominik
2009-01-12 11:29 ` Scot Becker
2009-01-12 14:21 ` Paul R
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=87myeu4j5x.fsf@fastmail.fm \
--to=mdl@imapmail.org \
--cc=emacs-orgmode@gnu.org \
--cc=paul.r.ml@gmail.com \
--cc=scot.becker@gmail.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).