Configuration files for our MkDocs homepage. Content is taken from a separate cloud folder. https://eventbikezero.de
 
 
Go to file
Otto 67b986e4ee Lichtsteuerung, Mobile Beschallung, Blogartikel 2023-10-10 21:08:01 +02:00
overrides Migrate to mkdocs-material 8+ 2023-04-25 22:26:54 +02:00
.gitignore Allow override of default settings 2022-07-20 21:51:34 +02:00
.settings Allow override of default settings 2022-07-20 21:51:34 +02:00
README.md Add instructions and fix bug 2022-07-20 22:18:32 +02:00
deploy.sh Update deploy script 2022-08-14 19:55:59 +02:00
mkdocs.yml Lichtsteuerung, Mobile Beschallung, Blogartikel 2023-10-10 21:08:01 +02:00

README.md

eventbike homepage

This is the generator setup for the eventbike_zero website. The content itself is hosted in our private cloud (to allow all team members to edit it + save Codeberg from hosting our images). The content folder is symlinked to the docs folder.

Setup

On Debian:

sudo apt install python3-pip
pip3 install -r requirements.txt

Then link the actual homepage content from the cloud to the docs/ folder, like so:

ln -s ~/Dokumente/path-to-the-eventbike-cloud/homepage-content docs

You can edit the file .settings to make sure the deploy script finds your secrets folder with the deploy key.

Updating the site

Edit the files in the docs/ folder or in the cloud with your favourite text editor. We use Markdown for the pages, read more on the mkdocs website.

To preview your changes locally, run

mkdocs serve

and open http://127.0.0.1:8000/ in your web browser.

If you are done with your changes, just run deploy.sh, and optionally specify which environment to use (web goes live, or staging creates another preview)

./deploy.sh staging

Licence

Files in this repository are licenced under a zero-clause BSD if not stated otherwise. You can find the licence text below:.

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.