home ~ projects ~ socials

Neopolitan Manual: References And Footnotes

TODO

    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

-- end of line --

References

A static website builder that works off Neopolitan files

The original markdown post

MDX

"Markdown for the component era"

"A GNU Emacs major mode for keeping notes, authoring documents, computational notebooks, literate programming, maintaining to-do lists, planning projects, and more — in a fast and effective plain text system."