Refactor interlinks plugin to use lua

[machow]

Now that the filter behaviors are well known, let's re-write it in lua. This will ensure it doesn't break as quarto leans more into lua filter features. This will also enable us to upgrade to quarto v1.3

Related

• _extensions/interlinks directory contains extraneous files #109
• Error with Quarto 1.3.294 and callouts #82
• Rendering large file hangs on interlinks #111
• Support embedding external ipynb files into doc pages #33
• Doc request: advise if/when to commit _inv and objects.json #125
• opt out of writing objects.json #63
• Interlinks filter, suggest running quartodoc build if no objects.json #83

Spec

(PR incoming)

TODO

• : run python filter on pyshiny site, commit files. Then, re-run with new filter. Based on diff, add any missing test cases.

[wch]

Hopefully this will also resolve #111.

[machow]

Paired w/ Carlos, who churned out a prototype lua filter with lightning speed :o! I'll open a PR, but want to leave these notes.

To figure out:

• How to go from running filter -> path to <docs_root>/objects.inv, or <docs_root>/_inv/... (Carlos figured it out)
• How to test? Maybe we...
  • Keep the relevant python logic for loading inventories, resolving refs
  • Keep some test docs in quartodoc/tests, with just the interlink syntax
  • Render those docs with the lua filter
  • Render those docs with python logic (like a snapshot test?)

[machow]

quarto --to json can be used for validating outputs of a lua filter (from e.g. python)