https://github.com/pakillo/academic-website-template-quarto
https://github.com/pakillo/academic-website-template-quarto
quarto quarto-template
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/pakillo/academic-website-template-quarto
- Owner: Pakillo
- Created: 2024-10-20T19:52:15.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-24T07:06:05.000Z (over 1 year ago)
- Last Synced: 2025-01-28T10:44:49.113Z (over 1 year ago)
- Topics: quarto, quarto-template
- Language: JavaScript
- Homepage: https://pakillo.github.io/academic-website-template-Quarto/
- Size: 599 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Template for academic website made with Quarto
A template for academic websites made with [Quarto](https://quarto.org) and hosted on GitHub.
This is all configured so you only need to edit the source files in Quarto (.qmd). The website is generated and hosted automatically by GitHub.
Example website: https://pakillo.github.io/academic-website-template-Quarto/
## Using this template
1. Click on green button "Use this template" -> "Create a new repository"
2. Important: check 'Include all branches' when creating the repository (because we will need the 'gh-pages' branch to host the website).
3. Choose a name for your repository
4. Once your repo is created, remember to update the links and info in `_quarto.yml`, `index.qmd`, etc.
5. With every new commit pushed to the 'main branch' the website will be updated automatically (using GitHub Actions). If that is not working, go to Settings -> GitHub Pages and check that it is configured as explained [here](https://quarto.org/docs/publishing/github-pages.html#source-branch). Otherwise the Quarto rendering might be failing. Try running 'quarto render' locally in your computer for debugging.
### Tips
In the 'R' folder there are a couple of R functions to help you populate the Publications page.
- `doi2md` will take a DOI (e.g. from a published paper) and produce the Markdown text ready to paste into `Publications.qmd`. For example, running `doi2md("10.1111/ele.14141")` returns this text that you can directly paste into `Publications.qmd` (requires internet connection for retrieving the publication metadata):
Quintero, Rodríguez‐Sánchez, Jordano (2022) [Reciprocity and interaction effectiveness in generalised mutualisms among free‐living species](https://doi.org/10.1111/ele.14141). *Ecology Letters* 26 (1): 132-146
- `scholar_pubs` will take a Google Scholar ID (e.g. mine is "LQQrHeEAAAAJ") and will generate a Quarto file (named "publications.qmd" by default) with your full publication list as available in your Google Scholar profile. Note you could of course write similar functions to retrieve publications dynamically from your ORCID profile, Zotero database, etc.