-
-
Notifications
You must be signed in to change notification settings - Fork 117
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Footnotes #342
Comments
I've made extensive use of footnotes in Markdown. I place the footnote text near the Admittedly my footnotes are typically very short, nothing longer than a paragraph1. They may contain a LaTeX formula or a Markdown style referernce like When converting Markdown to PDF the footnotes appear at the bottom of the corresponding page. When converting to ePub they appear at the end of the chapter. In either case the export tool makes the footnote a link so a click on the footnote sends you to its text. The export tool also places a reverse link at the end of the footnote text to send you back to the reference. Footnotes
|
That seems to be in the context of technical writing, or non-fiction at least. It makes sense to use footnotes there. It's not very common in fiction, but for instance Terry Pratchett does it quite a lot. It would be nice to have the option, and it is, as you say, supported by ePub. Spreading them around or collecting them in dedicated files makes no difference to the way it would be implemented in the code. I would just have the indexer class collect them like it does for the synopsis. It's mostly an issue of how to indicate that a set of paragraphs belong to a single footnote without relying on indents as in kramdown. It's not a high priority feature, and I may just leave this Issue here in case there is a request for it. |
Most definitely! (BTW, I'm interested in fiction, not technical writing). I just came across novelWriter, went through its currently available features -- and was very impressed! -- and concluded that it's missing one, very important, thing: footnotes (and endnotes)! |
Thanks for your feedback :) I absolutely see the value in adding footnotes for fiction-writing, so I'll tag this issue for the version 1.1 release since there is interest in it. I'll add it as soon as I'm done with 1.0, maybe before, but if so, it'll be in the |
Possible notation for this proposed in #1337. |
Following from #1337, I think the following notation may work:
I'm not sure if I'm also not sure if I want to distinguish between footnotes and endnotes in the syntax, and instead make it an option in the build tool. How they are treated is somewhat dependent on output format. Footnotes don't make sense on formats without pages. There they become chapter notes or endnotes anyway. |
How about doing it like Latex does? That would mean The reason for defining it in the middle of the text is that the footnote is defined where it's relevant, not at some external location, so things are easier when editing later (i.e. you don't have to reference another document when editing, but the relevant information is right there. |
For short footnotes, that is fine. However, I would like a way to refer to a footnote as well. This is useful if you refer to the same footnote more than once, or want a footnote that is longer, or rendered as an endnote. So you could have the option to:
I think it should be possible to implement both. |
In any case, since you can define the |
Looking at the history here, I like @johnblommers suggestion. I will just use a syntax that is more consistent with the shortcodes already implemented. |
Footnotes have finally been added in #1832. This was a huge patch, so it was only worth the effort because the framework added for footnotes can also be used for adding annotations/comments to text segments and also for the story feature (#1784). After all, footnotes are not very common in fiction. Since the syntax for footnotes is a bit cumbersome to manually type, there is an "Insert Footnote" menu entry that inserts the marker, generates a unique footnote key, and creates the special comment where the footnote text goes, and move the cursor to this location so the user can start typing the footnote right away. |
Add footnote support using the kramdown mrkdown syntax of
[^label]
to point to a labelled footnote, and the footnote being specified with the[^label]:
syntax where the footnote text are the following indented paragraphs.See kramdown docs
Since novelWriter doesn't necessarily use a fixed width font, indentation as group indicator isn't ideal. Some solutions may be:
I'm leaning towards the fourth option. Footnotes are defined in files with the
FOOTNOTE
layout. Each footnote contains all text following a label definition until a new one is defined, or the end of the file is reached. Multiple footnote files are allowed.Distinguishing between page notes, chapter notes and end notes may be desirable. This can be achieved globally as a single setting as you don't want to use both.
The text was updated successfully, but these errors were encountered: