Uberspace 7 Lab
Welcome to our laboratory! 🎉
This is where we host the source code of the official version over at https://lab.uberspace.de. The lab contains a collection of guides and tips on how to run specific software on Uberspace 7. Most of the guides are contributed by users like you! So, if you'd like to change or add something here, you're more than welcome to do so. Have a look at our contributing guidelines to learn how. Also, have a look at the list of guides people are looking for!
Pushing for each and every change is fun, but can take some time. To speed up your development process, the lab can be built locally.
source .venv/bin/activate make clean html
The HTML views are now present in
To build automatically on each change use
make clean serve
This will start a local webserver on http://127.0.0.1:8000, which always serves the most recent version.
To lint all files, you can use
Or just to check the guides for consistency:
To check the spelling you can use the spell check function of Sphinx:
Add Words to Guide
If your guide needs to use words, that should not go into the global
dictionary (see below), you can flag them with the
spelling directive like
this (usually near the top of your guide):
.. spelling:: passwörd anotherword
Add Words to Global Dictionary
make get-new-wordsto write a list of all spelling errors found to
- edit the resulting
- decide wich words to keep for the global dict,
- and wich might be better put into a guide local list (see the
spellingdirective above for that)
- if satisfied, run
make add-new-wordsto merge them to the global dictionary
- commit your changes ✏️
All text and code in this repository is licensed under CC-BY-NC-SA 4.0. All project logos are property of the respective project.