This repository hosts the productive environment of the AARS website.
Originally, the site was built using Carrd, which creates a single HTML file which includes all the styling and scripts. That site was then refactored and moved to this repository.
In some cases, e.g. getting inspiration for icons or styling, using Carrd might still be useful. However, the card instance can no longer be exported and directly imported here.
The calendar is implemented with Vue.js. Since the calendar itself is split into multiple components, and therefore needs to be imported using the import statement, we need a small http server. That is because, the import statement does not work over the file:// protocol, only https://.
- Install Node.js
- Open a terminal
- Switch into the root directory of this project
- Run the command
npx serve - Open the browser at the URL the command outputs (usually http://localhost:3000)
- Navigate to the calendar
Modify the file ./calendar/data/event.json following these samples:
{ "start": "2025-03-01T14:00:00+01:00", "end": "2025-03-01T17:00:00+01:00", "location": "zueghusplatz", "eventStatus": "cancelled" },
{ "start": "2025-04-05T14:00:00+02:00", "end": "2025-04-05T17:00:00+02:00", "location": "hirschenplatz", "eventStatus": "confirmed" },
{ "start": "2025-10-11T14:00:00+02:00", "end": "2025-10-11T17:00:00+02:00", "location": "bellevue", "eventStatus": "in-planning" }
Please note:
- The status must be
in-planning,cancelledorconfirmed - Events before the last Sunday in March have
+01:00for CET - Events between the last Sunday in March and the last Sunday in October use
+02:00for CET - Events after the last Sunday in October use
+01:00for CET
For more text intensive sites, a Github Pages template is applied on markdown files.
The following files are relevant:
_config.yml: basic configuration, such as theme selection_includes/*.html: additional content that is added to the guidesassets/css/style.scss: contains style changes for the guidesguides/*.md: the actual content of the guidesguides/assets/*: other assets, such as images, that are only used in the guides
To easily create a table of content over a markdown file, this generator can be used.