The words Under construction in black text on a yellow background with diagonal black stipes surrounding it
I'm in the process of moving my site. It's still a work in progress. Please excuse the mess and broken links.

Neopolitan Manual: References And Footnotes

TODO: Pull subtitle into page object

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

Debugging Stuff

I'm moving stuff around right now. All this below is helping me figure out where to put stuff

        -- title

Neopolitan Manual: References And Footnotes

-- todo

[] Rename this filename to "manual" from "usage"


-- h2

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


-- todo 
-- title: 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``




-- ref
-- title: Neopoligin
-- url: https://github.com/alanwsmith/neopoligin
-- subtitle: A static website builder that works off Neopolitan files

-- ref
-- title: Markdown
-- url: https://daringfireball.net/projects/markdown/
-- subtitle: The original post 

-- ref
-- title: MDX
-- url: https://mdxjs.com/
-- subtitle: "Markdown for the component era"

-- ref
-- title: Org Mode
-- url: https://orgmode.org/
-- subtitle: "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."




-- categories
-- Neopolitan 
-- Neopolitan Manual

-- metadata
-- date: 2023-09-11 11:29:30
-- id: 2vfyywip
-- site: aws
-- type: post
-- status: draft