Merge branch 'master' of https://kollegen.uber.space/gitea/kollegenrunde/kollegen-posts

README.md

@@ -46,3 +46,46 @@ Web Server is available at http://localhost:1313/kollegenrunde/ (bind address 12
 
 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.
+
+Anlegen neuen Posts (auch Bearbeiten eines existierenden Posts)  
+>$ cd ~/kred/kollegen-posts/redaktion  
+>$ .venv/bin/python red.py init 20160216  
+>Existing in path found. Put your original images here: 'in/posts/20160216'  
+>Post' directory created: '../content/posts/20160216'   
+>New post file created: '../content/posts/20160216/index.md'  
+>Image directory created: 'images'   
+>The next step would be to add your images into the 'in/posts/20160216' directory. After that you can update the post directory '../content/posts/20160216' and the post file 'index.md': call 'update'.  
+
+
+Damit werden die Verzeichnis ~/kred/kollegen-posts/redaktion/in/posts/20160216 und ~/kred/kollegen-posts/content/posts/20160216 angelegt (falls nicht vorhanden) und die Datei index.md initialisiert. Der Post ist nun initialisiert.
+
+Nun können eigenen Bilder in Originalgröße abgelegt werden, z. B.:
+
+>$ cp meine/bilder/*.jpg ~/kred/kollegen-posts/redaktion/in/posts/20160216/
+
+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. 
+
+### Post-Datei index.md bearbeiten
+
+Die so erzeugte bzw. upgedatete Datei besteht aus zwei Bereichen. Zuerst kommen die mit Initialwerten gesetzten Parameter und dann folgt, nach dem '---' der Text. Dieser wird mit  <!--more--> in Zusammenfassung und eigentlichem Inhalt getrennt.
+
+Der lokale Server erkennt Änderungen und aktualisiert die Webseite automtatisch.
+
+### Bearbeitung abschließen
+
+Ist die Post-Bearbeitung fertig, kann man das Eingangsverzeichnis entfernt werden.
+
+>$ .venv/bin/python red.py  cleanup  
+>Removed 'in/posts/20160216'  
+>20160216 closed.  
+
+
+### Neuen Post veröffentlichen
+Das Leben ist ein Baustelle....