{"id":13557562,"url":"https://github.com/Uberspace/lab","last_synced_at":"2025-04-03T11:32:32.055Z","repository":{"id":37430842,"uuid":"121502701","full_name":"Uberspace/lab","owner":"Uberspace","description":"The Uberlab provides various tutorials - written by you! - on how to run software and tools on Uberspace 7.","archived":false,"fork":false,"pushed_at":"2024-10-24T11:41:11.000Z","size":11592,"stargazers_count":315,"open_issues_count":216,"forks_count":414,"subscribers_count":28,"default_branch":"main","last_synced_at":"2024-10-25T01:44:07.269Z","etag":null,"topics":["guides","hosting","lab","laboratory","setup-guide","setup-tutorial","shared-hosting","uberlab","uberspace","uberspace7"],"latest_commit_sha":null,"homepage":"https://lab.uberspace.de","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Uberspace.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"authorship/README.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-14T11:22:16.000Z","updated_at":"2024-10-24T11:41:16.000Z","dependencies_parsed_at":"2024-07-09T13:14:13.707Z","dependency_job_id":"644903a9-f84e-4a3e-b2c8-1640feaaa698","html_url":"https://github.com/Uberspace/lab","commit_stats":{"total_commits":2195,"total_committers":361,"mean_commits":6.080332409972299,"dds":0.8305239179954442,"last_synced_commit":"b6a10f8955255a23203c902f59ee3ea3da7754e0"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Uberspace%2Flab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Uberspace%2Flab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Uberspace%2Flab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Uberspace%2Flab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Uberspace","download_url":"https://codeload.github.com/Uberspace/lab/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246993274,"owners_count":20865973,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["guides","hosting","lab","laboratory","setup-guide","setup-tutorial","shared-hosting","uberlab","uberspace","uberspace7"],"created_at":"2024-08-01T12:04:25.262Z","updated_at":"2025-04-03T11:32:27.046Z","avatar_url":"https://github.com/Uberspace.png","language":"Python","readme":"# Uberspace 7 Lab\n\nWelcome to our laboratory! :tada:\n\nThis is where we host the source code of the official version over at\n\u003chttps://lab.uberspace.de\u003e. The lab contains a collection of guides and tips on\nhow to run specific software on Uberspace 7. Most of the guides are contributed\nby users like you! So, if you'd like to change or add something here, you're\nmore than welcome to do so. Have a look at our [contributing guidelines][] to\nlearn how. Also, have a look at the [list of guides][] people are looking for!\n\n## Prerequisites\n\nYou need to have installed:\n\n-   Python (\u003c= 3.11)\n-   [Enchant library](https://abiword.github.io/enchant/)\n\n## Development\n\nPushing for each and every change is fun, but can take some time. To speed up\nyour development process, the lab can be built locally.\n\n### Initial Setup\n\n```shell\nmake setup\n```\n\n### Building\n\n```shell\nsource .venv/bin/activate\nmake clean html\n```\n\nThe HTML views are now present in `build/html`.\n\n### Development Server\n\nTo build automatically on each change use `sphinx-autobuild`:\n\n```shell\nmake clean serve\n```\n\nThis will start a local webserver on http://127.0.0.1:8000, which always serves\nthe most recent version.\n\n## Linting\n\nTo lint all files, you can use `pre-commit`:\n\n```shell\nmake lint\n```\n\nOr just to check the guides for consistency:\n\n```shell\nmake check-guides\n```\n\n## Spellcheck\n\nTo check the spelling you can use the spell check function of Sphinx:\n\n```shell\nmake spelling\n```\n\n### Add Words to Guide\n\nIf your guide needs to use words, that should not go into the _global\ndictionary_ (see below), you can flag them with the `spelling` directive like\nthis (usually near the top of your guide):\n\n```rst\n.. spelling::\n    passwörd\n    anotherword\n```\n\n### Add Words to Global Dictionary\n\n1. run `make get-new-words` to write a list of all spelling errors found\n   to `new_words.txt`\n1. edit the resulting `new_words.txt`\n    1. decide wich words to keep for the global dict,\n    1. and wich might be better put into a guide local list (see the `spelling`\n       directive above for that)\n1. if satisfied, run `make add-new-words` to merge them to the global dictionary\n1. commit your changes :pencil2:\n\n## License\n\nAll text and code in this repository is licensed under [CC-BY-NC-SA 4.0][].\nAll project logos are property of the respective project.\n\n[cc-by-nc-sa 4.0]: https://creativecommons.org/licenses/by-nc-sa/4.0/\n[contributing guidelines]: CONTRIBUTING.md\n[list of guides]: https://github.com/Uberspace/lab/issues?q=is%3Aopen+is%3Aissue+label%3Aguide\n","funding_links":[],"categories":["Python","others"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUberspace%2Flab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FUberspace%2Flab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUberspace%2Flab/lists"}