This is a static website made with Zola. All public materials developed by the society will be available on it, along with documentation of projects, events and public Zulip communication.
Install Zola as described here or, and this is the easiest if you are used to the command line, download precompiled binaries for your platform from here.
Run zola build in order to build and zola serve to run a small server. It will also reload automatically on changes made to the files. With the help of GitHub Actions this website is built automatically on each new commit. You can see the whole build process in .github/workflows/main.yml.
You can also use zola check to verify if all external links work. This should be ran every now and then.
- Content i.e. materials, events, projects in
/content - Static files e.g. images in
/static - Templates which define the structure in
/templates
The templates should be treated as part of the design and edited in last resort.
Below is the least amount of steps to get from a fresh Git installation to changing content on this site. To be extended with detailed explanations.
Inform your Git about your identity as follows
git config --global user.name "Your name"
git config --global user.email "Your email"
Then clone this repository
git clone https://github.com/dsatlse/dsatlse.github.io.git
After making changes to your local state, assuming you have push rights, run the following
git add .
git commit -m "Add content on metric embedding"
git push
This is a static website made with Zola and hosted on GitHub, see the source. All public materials developed by the society will be available on it, along with documentation of projects, events and public Zulip communication. Here are some core principles related to our technical stack.
- Requiring minimal IT competence to maintain
- Clear documentation of the tools and how they relate to each other
- Liberal enough to extend without reinventing the wheel
- Easy transfer of ownership to subsequent committees
- Ideally keep the core pieces stable on unpaid plans
- Plug-and-play nature of components: if something is not used, don't force it