Quarto Demo

What is Quarto? How can I use it?

quarto is used to generate the demo website from this repository via GitHub Actions on pushes to the main branch.

Level of Support

This repository is not actively supported by NSIDC but we welcome issue submissions and pull requests in order to foster community contribution.

See the LICENSE for details on permissions and warranties. Please contact [email protected] for more information.

Usage

Install Quarto

Do not install with Conda, or the tinytex extension will not install correctly. TODO: Open an issue in GitHub about this.

Please use an official package.

Install tinytex for PDF rendering

quarto install tinytex

Preview the output

quarto preview

Troubleshooting

Fails to render PDF, tlmgr doesn't exist

ERROR: Error executing '/home/mfisher/miniconda3/envs/quarto/bin/tlmgr': No such file or directory (os error 2)

My first instinct here was to install texlive-core from conda-forge, however that currently doesn't include a subdependency (conda-forge/texlive-core-feedstock#27).

The recommended course of action is quarto install tinytex, however this is not friendly with conda installations. To get around this, we use the system install of Quarto, and install other dependencies with conda.

License

See LICENSE.

Code of Conduct

See Code of Conduct.

Credit

This software was developed by the National Snow and Ice Data Center with funding from multiple sources.