Neopolitan Manual: References And Footnotes

Rename this filename to "manual" from "usage"

Overview

These are the notes on how I'm planning to implement references and footnotes. The requirement for Neopolitan stops at the AST so this is just one option that powers my site and provides an example implementation

Goals

Use a single `ref`` section for text footnotes, link footnotes, and general link references that aren't direct footnotes
If a `ref`` has an `id`` it can be used on the page
If a `ref`` has a `gid`` it's a global id that can be used on any page
If a `gid` reference is called on a page other than the one where it exists the contents are output on the calling page as well (copied over from the original source)
If a ref has an id and that id is called in the body of the document the two things are linked and the reference is moved into a footnotes section
References don't need titles, they can just have IDs which will be used to link them in a footnotes sections
References that don't have IDs are put in a references section alpabetically by title
References that aren't footnotes can be called in via `gid``