The Uberlab provides various tutorials - written by you! - on how to run software and tools on Uberspace 7.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
noa 525c8723f0
Merge pull request #1247 from korakinos/patch-1
2 months ago
authorship [meta] fix hall of fame links 2 months ago
source Merge pull request #1247 from korakinos/patch-1 2 months ago
.editorconfig 🔧 add pre-comit config 11 months ago
.gitignore 🙈 ignore files for spelling tools 11 months ago
.pre-commit-config.yaml 🔧 syntax check guides via pre-commit 11 months ago
BROKEN_GUIDES.md 🚨 lint files 11 months ago
CONTRIBUTING.md 🔨 add command to check guides for consistency 11 months ago
LICENSE 🚨 lint files 11 months ago
Makefile ♻️ update spelling tools workflow 11 months ago
README.md ♻️ update spelling tools workflow 11 months ago
STYLE.md [style] add startsecs requirement for supervisord 2 months ago
check-guides.py 🔧 releax regex checking for "tested on" section 11 months ago
make.bat make.bat: note that this is not supported by us 3 years ago
netlify.toml [meta] remove .html from URLs 2 months ago
requirements.txt update dependencies to fix search 3 months ago
runtime.txt ⬆️ update Python to `3.8` 12 months ago
spelling_tools.py ♻️ update spelling tools workflow 11 months ago
ubermug.png Replace mug image by the final version 3 years ago

README.md

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!

Development

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.

Initial Setup

make setup

Building

source .venv/bin/activate
make clean html

The HTML views are now present in build/html.

Development Server

To build automatically on each change use sphinx-autobuild:

make clean serve

This will start a local webserver on http://127.0.0.1:8000, which always serves the most recent version.

Linting

To lint all files, you can use pre-commit:

make lint

Or just to check the guides for consistency:

make check-guides

Spellcheck

To check the spelling you can use the spell check function of Sphinx:

make spelling

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

  1. run make get-new-words to write a list of all spelling errors found to new_words.txt
  2. edit the resulting new_words.txt
    1. decide wich words to keep for the global dict,
    2. and wich might be better put into a guide local list (see the spelling directive above for that)
  3. if satisfied, run make add-new-words to merge them to the global dictionary
  4. commit your changes

License

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.