ctdo-Satzung/README.md

# Satzung des CTDO e.V.

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.

Weiterhin ist es möglich, dass man für die Jahreshauptversammlung schon
Änderungen als Pull-Request vorbereiten kann und diese dann nur noch angenommen
werden müssen.

Der Entwurf muss in einem eigenen Branch bearbeitet werden. 

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 Commit im Master wird automatisch eine CI Pipeline laufen welche die Satzung in die Nextcloud schiebt.

## testen

Erzeugen von pdf files kann man so machen:

	docker run --rm -v $PWD:/mnt -w /mnt registry.gitlab.com/islandoftex/images/texlive:latest pdflatex beitragsordnung.tex

## 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
Add Readme.md and description 2016-12-18 18:24:30 +00:00			`# Satzung des CTDO e.V.`

test pdfttk cat und Readme ausgebaut 2022-08-29 19:50:42 +00:00			`Hier ist die Satzung des CTDO e.V. Die Satzung wird hier im repo verwaltet und verändert.`

test ci pipeline 2022-08-29 17:30:41 +00:00			`Die Idee ist, dass man zum einen nachvollziehen kann, wann die Satzung welchen`
Add Readme.md and description 2016-12-18 18:24:30 +00:00			`Stand hatte und was verändert wurde.`

			`Weiterhin ist es möglich, dass man für die Jahreshauptversammlung schon`
			`Änderungen als Pull-Request vorbereiten kann und diese dann nur noch angenommen`
veralterte pdf entfernt und readme beschreibung vereinsregister branch 2019-02-05 13:27:04 +00:00			`werden müssen.`
Add Readme.md and description 2016-12-18 18:24:30 +00:00
test ci pipeline 2022-08-29 17:30:41 +00:00			`Der Entwurf muss in einem eigenen Branch bearbeitet werden.`
test pdfttk cat und Readme ausgebaut 2022-08-29 19:50:42 +00:00
			`Die aktuell gültige Version wird dann (per Pull-Request) in den master Branch gemerged.`
test ci pipeline 2022-08-29 17:30:41 +00:00			`Der Merge kann nur durch ein Approval stattfinden.`

test pdfttk cat und Readme ausgebaut 2022-08-29 19:50:42 +00:00			`Nach dem Commit im Master wird automatisch eine CI Pipeline laufen welche die Satzung in die Nextcloud schiebt.`

Als VORSCHLAG: Beitragsordnung angepasst 2022-09-06 13:21:43 +00:00			`## testen`

			`Erzeugen von pdf files kann man so machen:`

			`docker run --rm -v $PWD:/mnt -w /mnt registry.gitlab.com/islandoftex/images/texlive:latest pdflatex beitragsordnung.tex`
test pdfttk cat und Readme ausgebaut 2022-08-29 19:50:42 +00:00
			`## 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.`
test ci pipeline 2022-08-29 17:30:41 +00:00
test pdfttk cat und Readme ausgebaut 2022-08-29 19:50:42 +00:00			`Der aktuelle öffentliche link lautet: https://cloud.ctdo.de/index.php/s/pQF5x55iTqErWHZ`