447e2e240f
Former-commit-id: ab5e92ba1e6195522aba2080f9380962129c882b [formerly aed015544fa00fab251ddea07c40882b94168192] [formerly 48b8c881b3c4f89d354267f8f5c58a59b8b8a794 [formerly 123caea06e19fe630eee664c1d36d05086ffb830]] Former-commit-id: 8ef73fc69e6fa2a17e9229f27d336a817dd942bc [formerly 77c9cdac2ee8d4c65a5714940823ade571f30392] Former-commit-id: f6e329ab4b317bac9646e219c3b046cd93cb0359
83 lines
3.7 KiB
Markdown
83 lines
3.7 KiB
Markdown
[](https://travis-ci.org/ToolboxBodensee/c3woc-website)
|
|
|
|
|
|
|
|
Status
|
|
------------
|
|
Dies ist der Quellcode der aktuellen Webseite des C3 Waffel Operation Center.
|
|
Diese findet man unter [c3woc.de](https://c3woc.de/)
|
|
|
|
Lektor CMS:
|
|
------------
|
|
Das CMS für diese Webseite ist [Lektor](https://www.getlektor.com/).
|
|
Die Installationsanleitung gibt es [hier](https://www.getlektor.com/downloads/).
|
|
Lektor ist auch als Python Modul verfügbar und kann mit ``python2 -m lektor`` verwendet werden.
|
|
Auch die Installation über pip *(in einem [virtuellen Enviroment](https://docs.python.org/3/tutorial/venv.html)* ist möglich:
|
|
```bash
|
|
virtualenv venv
|
|
. venv/bin/activate
|
|
pip install lektor
|
|
```
|
|
|
|
Zum Starten von Lektor muss man mit der Komandozeile in das root Verzeichnis der Webseite gehen
|
|
und dort mit dem Befehl ``lektor server`` startet man Lektor und öffnen auf 127.0.0.1 den Port 5000 über den die Webseite
|
|
bearbeitbar ist. Die Versionskontrolle der Webseite findet über Git statt. Daher wenn möglich Bilder erst
|
|
bearbeiten, bevor diese Veröffentlicht werden!
|
|
|
|
|
|
Zur neuen Webseite Beitragen:
|
|
------------------------
|
|
1. Dieses Repository Forken oder einen neuen Branch machen (übers GitHub Interface)
|
|
2. Geforktes Repository Clonen (``git clone https://github.com/<Your_Name>/c3woc-website.git``)
|
|
3. Öffne deine Komandozeile im geklonten Repository-Fork (``cd c3woc-website``)
|
|
4. Lektor starten (``python2 -m lektor server``)
|
|
5. Webseite updaten... (``http://localhost:5000/``)
|
|
6. Lektor Beenden (``Strg. + C``)
|
|
7. Änderungen commiten (``git add --all; git commit -m "An der C3WOC Webseite habe ich _____ geändert"``)
|
|
8. Änderungen hochladen (``git push``)
|
|
9. Pull-Request Stellen (übers GitHub Interface)
|
|
|
|
Webseite übersetzen:
|
|
------------------------
|
|
Lektor bietet in der Admin-Oberfläche die Möglichkeit die C3WOC Webseite auf englisch zu übersetzen.
|
|
Diese Funktion befindet sich unter dem Punkt ``Alternative``.
|
|
Als Übersetzer mit guten Ergebnissen kann man beispielsweise [deepl](https://www.deepl.com) verwenden.<br/>
|
|
Links auf Seiten haben in der Englischen Version ein ``/en/`` vor der Adresse.
|
|
So wird ``https://c3woc.de/rezept/vegan/`` zu ``https://c3woc.de/en/rezept/vegan/``.
|
|
|
|
Fork aktuell halten ohne neu zu forken:
|
|
------------------------
|
|
```bash
|
|
cd c3woc-website
|
|
|
|
# Das Original Repository der Toolbox einbinden:
|
|
git remote add upstream https://github.com/ToolboxBodensee/c3woc-website.git
|
|
git fetch upstream
|
|
|
|
# Deinen Fork lokal aktualisieren:
|
|
git pull upstream master
|
|
```
|
|
|
|
Pull Request Reviewen
|
|
-----------------------
|
|
1. Die im Pull-Request eingereite Version clonen ``git clone --depth 23 <REPO> -b <BRANCH> <ORDNERNAME>``
|
|
2. Den geklonten Pull-Request anschauen ``lektor server``
|
|
3. Änderungen requesten oder Pull-Request approven
|
|
|
|
Design:
|
|
---------
|
|
Das Design basiert auf [HTML5UP](https://html5up.net), genauer gesagt auf dem Design [Landed](https://html5up.net/landed). Und wurde natürlich für die Toolbox Webseite angepasst!
|
|
|
|
Bei den Menüfarben sollte die Farbauswahl aus dem [Toolbox Presse-Kit](https://github.com/ToolboxBodensee/presskit) berücksichtigt werden.  `#E64F2D` Orange und  `#9B160F` Rot sind hier die Primärfarben.
|
|
|
|
CSS:
|
|
------
|
|
Das CSS Design wird mit [sass](https://sass-lang.com/) generiert.
|
|
Das vereinfacht die Verständlichkeit der einzelnen Design Elemente
|
|
und ermöglicht auch das anpassen des Designs durch das simple verändern weniger variablen.
|
|
Example use:
|
|
```bash
|
|
sassc assets/sass/main.scss > assets/css/main.css
|
|
```
|
|
|
|
|