diff --git a/README.md b/README.md index 04908d7..90ac737 100644 --- a/README.md +++ b/README.md @@ -21,15 +21,19 @@ Das Setup ist das gleiche, wie bei der Web-Entwicklung. Es wird ein leeres Verze >$ 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 +>$ mkdir hugo +>$ tar -xvf hugo_0.76.4_Linux-64bit.tar.gz --directory hugo +>$ rm hugo_0.76.4_Linux-64bit.tar.gz +>$ git clone --recurse-submodules 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: +Für Python wird nun noch die virtual Environment in einem neuen Unterverzeichnis installiert. Unter Linux geht das so: ->$ python3 -m venv .venv # Virtuelle Umgebung anlegen ->$ source .venv/bin/activate # aufrufen ->$ pip install -r requirements.txt # Benötigte Paket installieren ->$ deactivate # venv verlassen +>$ cd ~/kred/kollegen-posts/redaktion/ +>$ python3 -m venv .venv # Virtuelle Umgebung anlegen +>$ source .venv/bin/activate # aufrufen +>(.venv) $ 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. @@ -49,6 +53,10 @@ Hat man alles richtig gemacht, kann man die Website nun im Browser sehen. ### Post-Editierung Das Python-Skript vereinfacht Erstellung und Bearbeitung eines Posts. Im Verzeichnis Redaktion wird damit ein Eingangsverzeichnis für einen Post angelegt, worin Originalbilder hineinkopiert werden können. Das Script verkleinert dann die Bilder (jpg) und kopiert sie in das eigentliche Post-Verzeichnis unter content. Ausserdem sorgt es für den Abgleich der Bilddateinamen mit den Einträgen in der Post-Datei index.md. Einer Post hat immer das Datum als Namen, z.B. 20160216. +Das Skript setzt das Unterverzeichnis in/posts voraus. Falls nicht vorhanden: + +>$ mkdir ~/kred/kollegen-posts/in && ~/kred/kollegen-posts/in/posts + Anlegen neuen Posts (auch Bearbeiten eines existierenden Posts) >$ cd ~/kred/kollegen-posts/redaktion >$ .venv/bin/python red.py init 20160216 @@ -65,12 +73,16 @@ Nun können eigenen Bilder in Originalgröße abgelegt werden, z. B.: >$ cp meine/bilder/*.jpg ~/kred/kollegen-posts/redaktion/in/posts/20160216/ +Unter Linux kann man diese beiden Schritte auch mit den Skript load.sh ausführen: + +>$ ./load.sh meine/bilder + Mit 'update' werden nun die Bilder konvertiert und im Zielverzeichnis abgelegt und in der Post-Datei index.md werden die Bild-Variablen initialisiert. >$ .venv/bin/python red.py update >Done. -Nun kann der Blogbeitrag in der Datei index.md editiert werden. +Nun kann der Blogbeitrag in der Datei ~/kred/kollegen-posts/content/posts/20160216/index.md editiert werden. ### Post-Datei index.md bearbeiten