feat(template): render html and docx output formats and verify in CI

[cameronraysmith]

• include example.qmd distinct from template.qmd and add comments to both reiterating the requirement to specify the realized path to any csl files providing alternate citation sytles in end-user repositories
  • resolves extensions wrong #4 without reverting the default citation style from citeproc to natbib
• reenable citeproc as default citation method
  • required to resolve support rendering html and docx from extension template #5
• render html and docx in addition to pdf retaining the auto-generated tex source
  • resolves support rendering html and docx from extension template #5
• execute render in CI and upload pdf, html, docx, tex, and qmd CI artifacts for review and reference
  • resolves render and upload artifacts in CI #7

[cameronraysmith]

Since these changes come from a fork, I have executed the workflow there to demonstrate that it works as expected and uploads a copy of all desired artifacts along with each workflow execution

https://github.com/cameronraysmith/nature/actions/runs/9961835354

The zipped artifacts archive containing all template.* now including pdf, html, docx, qmd and tex can be downloaded from
https://github.com/cameronraysmith/nature/actions/runs/9961835354/artifacts/1707559811

[cameronraysmith]

We could split this change into a separate PR to be merged prior to this one and upon which it could be rebased so that we can then verify in this one (#6) that the CI workflow functions as expected for new PRs.

Alternatively, we can imagine this is likely given the results of
https://github.com/cameronraysmith/nature/actions/runs/9961835354 .

[cameronraysmith]

test end-user instantiation from PR fork

~/projects
❯ mkdir test-nature-end-user

~/projects
❯ cd test-nature-end-user

~/projects/test-nature-end-user
❯ quarto use template cameronraysmith/nature@end-user-example

Quarto templates may execute code when documents are rendered. If you do not
trust the authors of the template, we recommend that you do not install or
use the template.
? Do you trust the authors of this template (Y/n) › Yes
? Create a subdirectory for template? (y/N) › No
[✓] Downloading
[✓] Unzipping

The template requires the following changes to extensions:
Nature Journal Template [Install] 1.0.1 (format)
? Would you like to continue (Y/n) › Yes

Preparing template files...
Found 1 extension.

[✓] Copying
[✓] Installing extensions...
[✓] Copying files...

Extensions installed:

• Nature Journal Template

Files created:

• bibliography.bib
• fig.eps
• fig.pdf
• test-nature-end-user.qmd

~/projects/test-nature-end-user via ⨁ v1.5.40
❯ bat test-nature-end-user.qmd

...

  28   │ # see: https://quarto.org/docs/extensions/distributing.html#github-distribution
  29   │ csl: _extensions/christopherkenny/nature/csl/springer-basic-brackets-no-et-al.csl
  30   │ author:

...

[cameronraysmith]

Hi @christopherkenny I'm going to close this for now, but let me know if you want to revisit it at some point in the future.