I want to request the Footnote plugin to be reenabled for richer content creation in the Purism community forums. For details, see its thread on Discourse Meta.
It would help with a guide I am writing up about regarding a Citizen Lab report, as I can start referencing relevant links towards various topics and concepts. If given a choice between only one method of displaying them, I would choose inline over non-inline.
This would have to be performed by a Purism sysadmin as it requires direct server/container access to update the .yml. The Purism sysadmin team currently has many higher-priority tasks on their plate; I can add this as a nice-to-have issue, but please don’t expect immediate action.
In the meantime, maybe some kind of Markdown pre-processing will do the trick - as anything that really needs a mass of footnotes is probably something that you would prepare offline anyway and then paste in when you are ready.
The only software I use that has Markdown support is Discourse; I have the guide as a draft due to this reason. However, sometimes I have to create new threads and transfer the guide to Tuta (previously Tutanota) instead, where it resides as a draft there too, albeit without Markdown support; it is exposed as raw code intead.
Oh, I meant something quick and dirty using e.g. awk
If it were me, I would format it offline using whatever tools you like and then host it on one of your many servers and then just a post a link here. So you wouldn’t need to use markdown at all.
If nothing else, maybe LibreOffice has enough functionality to create the document, then export as PDF, then host a PDF file. (LibreOffice can also produce HTML but that may or may not meet your requirements. If using HTML from LibreOffice, I would strip the changelog before publishing.)
Ideally, you can have footnotes come up “on hover” (if using a mouse).
However if the footnote is only a link then none of this really applies - as links are easy to do without using footnotes.
If this feature could be reenabled, then I can create Markdown tables that are more functional, particularly for addressing Purism infrastructure costs/expenses, otherwise Markdown tables will seem to appear overwhelming in details:
I’m not sure what’s missing there (what’s the alternative that your’re looking for?), but that table seems fine (and contents great, kudos for working on that) and readable - especially if you click on it (it shows larger view like with images).
This is just a small snippet of a much longer Markdown table, and how Markdown tables work is that the longest entry in a row expands the entire row to its length. Reenabling the Discourse Footnote plugin would allow me to compress text entries down into expandable buttons, similar to tooltips, while maintaining a small form factor for each row, thus improving readability for the upcoming Markdown table for addressing Purism’s infrastructure costs. Otherwise, I will prioritize a Markdown table for the Whonix Forum first instead:
Syntax for the reference is left-square-bracket then e.g. number then right-square-bracket
Syntax for definition (preferably grouped at bottom of source post but won’t actually appear in your formatted post at all) is left-square-bracket then e.g. number then right-square-bracket then colon then space then a URL.
A reference will not appear correctly formatted in the preview window until the definition is present.
Note that the square brackets aren’t present in the formatted version and aren’t part of the link if you add an extra set and I couldn’t work out how to override that but it isn’t a big issue for me.
And if you like your footnote references smaller and elevated then you can enclose the whole reference in <sup>…</sup>
I’ve illustrated those footnote reference options in this post.
Attempted Markdown table with footnotes on Purism Community Forums:
Vulnerability
User-to-Kernel
User-to-User
Guest-to-Host
Guest-to-Guest
Cross-Thread
BHI
GDS
L1TF
[^1]
MDS
[^1]
MMIO
[^1]
Meltdown
Retbleed
[^2]
RFDS
Spectre_v1
Spectre_v2
Spectre_v2_user
SRBDS
SRSO
SSB[^3]
TAA
[^1]
[^1]: Disables SMT if cross-thread mitigations are selected and CPU is vulnerable
[^2]: Disables SMT if cross-thread mitigations are selected, CPU is vulnerable, and STIBP is not supported
[^3]: Speculative store bypass is always enabled by default (no kernel mitigation applied) unless overridden with spec_store_bypass_disable option
When done inline, there are no text under the Markdown table, so it looks very cleanly formatted and the size of the Markdown table is significantly more manageable with multiple listed entries. I am preparing a Markdown table with over thirty entries, so I need to compress as many of the rows as possible for readability.
OK, so with current functionality, the best you could do is put your footnotes on another website or websites i.e. effectively as citations rather than footnotes. In that scenario it would depend on what information you wanted to include in the footnote i.e. editorial comment from you v. fine print from the provider’s web site.
Right, the current situation is not ideal since I am using MediaWiki-style numbered citations as external URL references instead, so text entries next to them are unnecessarily bloated. If I attempt to switch out text entries with numbered citations linking external references, that will require @JCS to manually lookup information through them, which are extra network requests that should be avoided.