This repository serves as a template for creating a website rendered from markdown files using Quarto. It provides a starting point for building a website with Quarto.
To individualize content, change the following:
- state project information in this
README.md
- individualize content of the main (starting) page in
index.qmd
- optionally add futher content in additional pages (
subpage.qmd
is initialized as starting point) - customize content in the
_quarto.yml
file- change
site_url
,repo_url
and under page footerhref
to point to the new repo - optionally change all the other links pointing to personal social media sites etc.
- optionally add additional pages such as
subpage
- change
- optionally change the style of the website (fonts, colors,...) in the
custom_theme.scss
file.
The website is rendered with Quarto either locally (has to be installed) or in Github automatically each time new content is added/changed via Github Actions to the _site
folder, do not change anything in there.
- Helpful tutorials and examples on Quarto in general are listed in the awesome-quarto repository.
- Good resources about creating websites with Quarto by Samantha Csik.
- Style adaptations in this repo adapted from Ella Kaye's website.
- Another helpful template repository was the NOAA-quarto-simple template.
- Github Action Workflow adpated from tarleb.com.
- Good resource on color choice and fonts from emilhvitfeldt.com
- Tool to check color contrasts: https://colourcontrast.cc/
- Information about blogs in quarto from albert-rapp.de
- Use icons with e.g.
{{< iconify exploding-head >}}
(https://github.com/mcanouil/quarto-iconify)