The goal of this quarto extension is to provide a wide range of quarto-based formats for INRAE engineers and researchers. These are an unofficial and opiniated templates.
brand.yml feature coming for quarto 1.6 will definitely have an impact on this extension. Stay tuned !
- The {InraeThemes} R package for ggplot2 and bootstrap themes
- The inrae-project-website extension for research project website templates
You will need to do this to get all the folders with all the templates, assets and prefilled quarto templates :
quarto use template davidcarayon/quarto-inrae-extensionNote: Previous versions of this extension can still be downloaded using GitHub release tags :
quarto use template davidcarayon/quarto-inrae-extension@v1.0.0
You may also use this format with an existing project to download only the _extensions folder (not recommended because you won't have the preconfigured qmd files).
quarto add davidcarayon/quarto-inrae-extensionYou can use the any of the template_*.qmd templates which all have an inrae-* format pre-configured.
You will also find a _quarto.yml file to use if you want to use custom projects (manuscripts, websites, books). These projects will use the index.qmd file.
Of course, this extension offers more features than you will typically need, so you can delete all the unnecessary qmd files.
These formats and designs are opiniated. Feel free to modify them to suit your needs in _extensions/davidcarayon/inrae. All suggestions and PR's are warmly welcomed.
To customise your formats, see the relevant documentations :
- Html and office documents (html/pdf/revealjs/docx/pptx) : Quarto's documentation
- LaTeX documents (beamer) : LaTeX's Beamer documentation
- Quarto projects (website, book) : Quarto's documentation
inrae-html: Provides an html document that can be hosted online (quarto-pub, github/lab pages, etc.). See Publishing in Quarto's documentationinrae-pdf: Generates a PDF document using the Weasyprint engine, similar topaged.js.inrae-docx: Generates a word document, typically to share for revisions
inrae-revealjs: Generates HTML slides that can be hosted online (quarto-pub, github/lab pages, etc.). See Publishing in Quarto's documentationinrae-beamer: Generates PDF beamer slides using LaTeXinrae-pptx: Generates a Powerpoint presentation, typically to... whatever.
NB : Some obscure error may occur when rendering Beamer if you are using 2023's version of texlive. If so, I can only suggest to follow this article to try and go back to 2022's version.
If you wish to use one of the 2 project formats, you can edit the _extensions/davidcarayon/inrae/_extension.yml to comment/uncomment your desired output :
## Project definition
project:
project:
type: default
#type: website
#type: book
format: inrae-html-
website: Quarto Websites are a convenient way to publish groups of documents. They can also be used as easy to deploy research project websites. See more here -
book: Quarto Books are combinations of multiple documents (chapters) into a single manuscript while not breaking cross-references. They can be typically used for complex reports. See more here
- RevealJS presentation of using R in VSCode : slides | code
- RevealJS presentation prepared for a training on phylogenetic methods : slides
- Quarto website filled with html docs and revealjs slides, all based on this extension, with a few tweaks : documents.migale.inrae.fr
- Dropped manuscript project format
- Switched from Typst to CSS with weasyprint for PDF reports
- Much better HTML reports
- Basic gitlab CI file for publishing on Gitlab Pages
- Cleaned the extension file tree
- new Typst format to replace the laggy LaTeX format for PDF reports
- Better documentation
- New feature : Projects (Manuscripts / websites / books)