From 9765c8d638ac7f4f3c7072038c99ece34c8d7f74 Mon Sep 17 00:00:00 2001 From: Chris/Web Date: Thu, 15 Oct 2020 22:12:56 +0200 Subject: [PATCH 1/3] =?UTF-8?q?=E2=80=9EREADME.md=E2=80=9C=20=C3=A4ndern?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/README.md b/README.md index a29a6ee..1ec1c96 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,33 @@ # kollegenrunde-posts +Dieses Repository beinhaltet den Content der Website sowie zum Editieren benötigte Helferlein. Im folgenden wird beschrieben, wie man Posts bearbeitet. + +Wie man dagegen die Website entwickelt, wird im Repository (kollegen-hugo)[https://kollegen.uber.space/gitea/kollegenrunde/kollegen-hugo] beschrieben. + +### Setup + +Vorraussetzungen: +- git-Client ist installiert +- Python3 ist installiert + +Das Setup ist das gleiche, wie bei der Web-Entwicklung. Es wird ein leeres Verzeichnis benötigt, in das die beiden Repositories und das Hugo-Release installiert werden. Hier nochmal in Kürze (am Beispiel Linux): + +>$ mkdir ~/kred +>$ cd ~/kred +>$ wget https://github.com/gohugoio/hugo/releases/download/v0.76.4/hugo_0.76.4_Linux-64bit.tar.gz +>$ git clone https://kollegen.uber.space/gitea/kollegenrunde/kollegen-hugo.git +>$ git clone https://kollegen.uber.space/gitea/kollegenrunde/kollegen-posts.git + +Damit ist die Installation abgeschlossen. Es werden nun einzelne Schritte der redaktionellen Arbeit erläutert. + +### Website lokal testen + +Hugo kommt mit einem eigenen Webserver, so dass man lokale seine Änderungen testen kann. Um ihn auszuführen, muss man im Verzeichnis kollegen-hugo sein. + +>$ cd ~/kred/kollegen-hugo +>$ ../hugo/hugo server -D +Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender +Web Server is available at http://localhost:1313/kollegenrunde/ (bind address 127.0.0.1) + +Hat man alles richtig gemacht, kann man die Website nun im Browser sehen. + From d666eb8ca9cffef2f0167d13047ae7a877f519e9 Mon Sep 17 00:00:00 2001 From: Chris/Web Date: Sat, 17 Oct 2020 13:29:33 +0200 Subject: [PATCH 2/3] =?UTF-8?q?=E2=80=9EREADME.md=E2=80=9C=20=C3=A4ndern?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1ec1c96..d3bf7a0 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,13 @@ Dieses Repository beinhaltet den Content der Website sowie zum Editieren benöti Wie man dagegen die Website entwickelt, wird im Repository (kollegen-hugo)[https://kollegen.uber.space/gitea/kollegenrunde/kollegen-hugo] beschrieben. -### Setup +Generell werden ein Post editiert, in man lokal Hugo lokal ausführt und die Änderung testet und die Änderung commitet. Mit dem Push ins Kollegen-Gitea wird die Website dann dort neu generiert. + +Für kleine und rein textuelle Änderungen können auch direkt im Gitea-Repository durchgeführt werden, ohne lokale Installation. + +### Lokales Setup + +Hier wird nun beschrieben, wie man sich Hugo lokal einrichtet und lokale Post-Bearbeitung testet. Vorraussetzungen: - git-Client ist installiert From 9df5fc172b3708e0e345b1097a4a1004cb727830 Mon Sep 17 00:00:00 2001 From: Chris/Web Date: Sun, 18 Oct 2020 02:34:46 +0200 Subject: [PATCH 3/3] =?UTF-8?q?=E2=80=9EREADME.md=E2=80=9C=20=C3=A4ndern?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index d3bf7a0..c083084 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,15 @@ Das Setup ist das gleiche, wie bei der Web-Entwicklung. Es wird ein leeres Verze >$ git clone https://kollegen.uber.space/gitea/kollegenrunde/kollegen-hugo.git >$ git clone https://kollegen.uber.space/gitea/kollegenrunde/kollegen-posts.git +Für Python wird nun noch die virtual Environment in einem neuen Unterverzeichnis installiert: + +>$ python3 -m venv .venv # Virtuelle Umgebung anlegen +>$ source .venv/bin/activate # aufrufen +>$ pip install -r requirements.txt # Benötigte Paket installieren +>$ deactivate # venv verlassen + +Hinweis: Die venv wird nicht in git eingeheckt, deshalb muss sie mit jeder Neuinstallation eingerichtet werden. + Damit ist die Installation abgeschlossen. Es werden nun einzelne Schritte der redaktionellen Arbeit erläutert. ### Website lokal testen