This repository contains Quarto documents to generate our group website, which is hosted at https://evolecolgroup.github.io/website. It is still under development. Feel free to fork and modify for your own uses (but please acknowledge us if you do so).

When you render the website in RStudio, a static HTML version is updated in the docs folder, and you can inspect any changes. A GitHub action triggered by commits to the main branch will automatically update the website hosted by GitHub Pages via the gh-pages branch.

To add your profile to the website, please follow these steps:

1. Clone the repository and create a new branch.
2. Go to the people folder in this repository.
3. Make a copy of the template profile file "_template_profile.qmd", and rename it by setting your name as the file name (i.e. firstname_lastname.qmd). Please avoid capital letters, and use underscores to separate words.
4. Edit the file to include your details.
5. Add a picture of yourself in the same folder, again using your name as the file name (e.g. firstname_lastname.png). The picture should be square, ideally 250px by 250px.
6. If you don't already, consider having a Google Scholar profile, and include the link in your profile.
7. Render the quarto file to check that it looks good. Your card should be automatically added to the people page.
8. Commit your changes and submit a pull request.

To add a resource (software, data, etc.) to the website, please follow these steps:

1. Clone the repository and create a new branch.
2. Go to the resources folder in this repository.
3. Add an item to "resources.yaml", following the existing format.
4. Add an appropriate image associated with the resource to the img folder. The image should be 240px by 276px (the same size as logos for R packages).
5. Render the resources page to check that it looks good.
6. Commit your changes and submit a pull request.

Publications are automatically updated once a week, using the Google Scholar IDs from individual webpages. Individual publications are stored within the people folder in a .csv file with the name_surname.csv pattern. Publications from the period in the group are collated under /papers/group_pubs.csv. Highlighting for individual group members in the publication list is based on their time in the group, as gathered from their personal page or under /people/alumni/alumni.yml. If you need to edit details of a paper, that can be done directly in the csv files.

The website uses the extension fontawesome. This allows the inclusion of additional, non-standard icons using short codes.