open-organization / open-org-leaders-manual

Repository for The Open Organization Leaders Manual source code
Other
90 stars 16 forks source link

Hyperlinks should be footnotes #43

Closed semioticrobotic closed 2 years ago

semioticrobotic commented 2 years ago

Source files for book chapters contain hyperlinks that should actually be footnotes. Before we release any future editions, we should convert all those hyperlinks to footnotes. Doing this would save an incredible amount of time in production.

Instructions

Markdown syntax for footnotes is (surprise!) very simple. A footnote has two parts: the in-text part and the at-the-end part.

At the end of a sentence with a footnote, you add the following text:

[^unique-identifier]

Where unique-identifier is a brief (one or two words) that identify that footnote and distinguish it from all others in the whole book (that part is important).

Then, at the end of the document, you add:

[^unique-identifier]: The text of the footnote.

And that's it! When the chapter renders, it'll contain sequential footnotes all linked to their appropriate references.

Notes

semioticrobotic commented 2 years ago

I've started this work with a flurry of commits today but welcome anyone's help on completing it.

semioticrobotic commented 2 years ago

This is done now!