As of 1/19/23, Quarto was coupling its table of contents feature (toc) with its GitHub "Edit this page" feature. Since we don't always use a toc, there isn't a straightforward way for us to have the "Edit this page" link on pages without the toc. And, the placement of the "Edit this page" link is also restricted because of this coupling.
As a workaround, we created a post-render script render_scripts/github_link_insertion.ts to insert the GitHub links. Once the Quarto project adds the appropriate functionality in, we can transition to a Quarto built-in solution rather than maintain the custom post-render script.
As of 1/19/23, Quarto was coupling its table of contents feature (toc) with its GitHub "Edit this page" feature. Since we don't always use a toc, there isn't a straightforward way for us to have the "Edit this page" link on pages without the toc. And, the placement of the "Edit this page" link is also restricted because of this coupling.
As a workaround, we created a post-render script
render_scripts/github_link_insertion.ts
to insert the GitHub links. Once the Quarto project adds the appropriate functionality in, we can transition to a Quarto built-in solution rather than maintain the custom post-render script.Related Quarto issue: https://github.com/quarto-dev/quarto-cli/issues/2142 Related DataSciJEDI issue: https://github.com/datascijedi/website/issues/35
(Moved from the https://github.com/datascijedi/website/issues/115).