test pdfttk cat und Readme ausgebaut

.drone.yml

@@ -9,23 +9,23 @@ steps:
       - pdflatex satzung.tex
       - pdflatex beitragsordnung.tex
       - pdflatex schluesselordnung.tex
-  - name: show directory contents
-    image: alpine
+  - name: merge PDF files into single file
+    image: mnuessler/pdftk
     commands:
-      - ls
-  - name: upload files to nextcloud
-    image: curlimages/curl
-    environment:
-      username:
-        from_secret: nextcloud_secret
-    commands:
-      - |
-          curl -k -T satzung.pdf -u "$username" -H "X-Requested-With: XMLHttpRequest" https://cloud.ctdo.de/public.php/webdav/$(date +"%Y-%m-%d")_satzung.pdf
-      - |
-          curl -k -T beitragsordnung.pdf -u "$username" -H "X-Requested-With: XMLHttpRequest" https://cloud.ctdo.de/public.php/webdav/$(date +"%Y-%m-%d")_beitragsordnung.pdf
-      - | 
-          curl -k -T schluesselordnung.pdf -u "$username" -H "X-Requested-With: XMLHttpRequest" https://cloud.ctdo.de/public.php/webdav/$(date +"%Y-%m-%d")_schluesselordnung.pdf
-    when:
-      ref:
-        - refs/heads/citest_publish
+      - satzung.pdf beitragsordnung.pdf schluesselordnung.pdf cat output satzung_mit_beitrags-_und_schluesselordnung.pdf
+  # - name: upload files to nextcloud
+  #   image: curlimages/curl
+  #   environment:
+  #     username:
+  #       from_secret: nextcloud_secret
+  #   commands:
+  #     - |
+  #         curl -k -T satzung.pdf -u "$username" -H "X-Requested-With: XMLHttpRequest" https://cloud.ctdo.de/public.php/webdav/$(date +"%Y-%m-%d")_satzung.pdf
+  #     - |
+  #         curl -k -T beitragsordnung.pdf -u "$username" -H "X-Requested-With: XMLHttpRequest" https://cloud.ctdo.de/public.php/webdav/$(date +"%Y-%m-%d")_beitragsordnung.pdf
+  #     - | 
+  #         curl -k -T schluesselordnung.pdf -u "$username" -H "X-Requested-With: XMLHttpRequest" https://cloud.ctdo.de/public.php/webdav/$(date +"%Y-%m-%d")_schluesselordnung.pdf
+  #   when:
+  #     ref:
+  #       - refs/heads/citest_publish
 

README.md

@@ -1,6 +1,7 @@
 # Satzung des CTDO e.V.
 
-Hier ist die Satzung des CTDO e.V. gesammelt und wird über dieses repo aktualisiert.
+Hier ist die Satzung des CTDO e.V. Die Satzung wird hier im repo verwaltet und verändert.
+
 Die Idee ist, dass man zum einen nachvollziehen kann, wann die Satzung welchen 
 Stand hatte und was verändert wurde.
 
@@ -9,8 +10,26 @@ Weiterhin ist es möglich, dass man für die Jahreshauptversammlung schon
 werden müssen.
 
 Der Entwurf muss in einem eigenen Branch bearbeitet werden. 
-Die beim aktuell gültige Version wird dann (per Pull-Request) in den main Branch gemerged.
+
+Die aktuell gültige Version wird dann (per Pull-Request) in den master Branch gemerged.
 Der Merge kann nur durch ein Approval stattfinden.
 
-Nach dem Merge wird automatisch eine CI Pipeline laufen welche die Satzung in die Nextcloud schiebt.
+Nach dem Commit im Master wird automatisch eine CI Pipeline laufen welche die Satzung in die Nextcloud schiebt.
 
+
+## technische details
+
+Das erstellen der PDF Dateien passiert mit dem Docker Container von texlive bzw deren speziellen Images auf "registry.gitlab.com/islandoftex/images/texlive"
+
+Die Automation ist in der Datei ".drone.yml" zu finden. Hier ist eine kleine Pipeline die bei jedem commit die Tex files zu PDF konvertiert.
+
+Die Details für den Upload zu Nextcloud via Shared URL stammen von hier: https://github.com/tavinus/cloudsend.sh/blob/master/cloudsend.sh
+
+Man nimmt einfach von dem https://cloud.ctdo.de/index.php/s/XXXXXXXX das XXXXXXX als benutzername im curl und verwendet die public.php/webdav Schnittstelle.
+
+## uploads / erzeugte Assets
+
+Die Uploads von der CI landen in Nextcloud beim Benutzer "lucas" der den Ordner "satzung" teilt.
+Es gibt zwei Teilungs Links. Einen der nur lesen darf für die Webseite und öffentliche Verlinkungen. Sowie einen weiteren der Lesen/Schreiben darf nur für die CI. Der "Benutzername" Teil des Links ist im [DroneCI](https://ci.ctdo.de/ctdo/ctdo-Satzung/settings/secrets) in dem Projekt als Secret "nextcloud_secret" hinterlegt.
+
+Der aktuelle öffentliche link lautet: https://cloud.ctdo.de/index.php/s/pQF5x55iTqErWHZ