| 2 | |
| 3 | Da die [[Website]] bislang sehr traditionell bearbeitet wurde -- ein einziger Ordner, direkt mit HTML, gibt |
| 4 | es keine Weboberfläche zur Bearbeitung (wie etwa in einer Wiki wie dieser hier). Auch erfordert der Einsatz |
| 5 | von PHP, dass man zur ''lokalen'' Bearbeitung, also offline auf dem eigenen Computer, einen Entwicklungsserver |
| 6 | (traditionelles [[https://de.wikipedia.org/wiki/LAMP_(Softwarepaket)|LAMP]] bzw. eben PHP/Apache) eingerichtet |
| 7 | hat. Um zumindest die Bearbeitung etwas einfacher zu machen, wird der Code der technikum29-Website |
| 8 | seit 2018 auf [[http://github.com|Github]] verwaltet. Das ist ein System ähnlich den |
| 9 | [[https://www.technikum29.de/labs|technikum29 Labs/Development Projects]] (diese Website hier), bloß etwas |
| 10 | moderner. Der angedachte Workflow ist bei Github, dass man das Coderepository auf seinem Computer ''klont'' |
| 11 | bzw. ''auscheckt'' und Änderungen dann mittels einem Git-Client ''pusht'' bzw. ''eincheckt''. Sie werden dann |
| 12 | automatisch auf der technikum29-Website übernommen. |
| 13 | |
| 14 | Allerdings erlaubt die Github-Website auch, direkt online Änderungen vorzunehmen, ohne auf seinem Computer |
| 15 | Git installiert zu haben oder über tiefere Git-Kenntnisse zu verfügen. Das ist besonders gut geeignet für kleine |
| 16 | Änderungen an bestehenden Dateien, es ist aber auch möglich, neue Dateien hinzuzufügen -- sowohl der Upload von |
| 17 | Dateien als auch die Eingabe eines Textdokumentes (PHP und HTML sind Plain-Text-Files) ist möglich. |
| 18 | |
| 19 | Diese Anleitung soll anhand Bildern exemplarisch zeigen, wie man einen neuen Blog-Eintrag einbindet. |
| 20 | |
| 21 | == 1. Schritt: Repository aufsichen == |
| 22 | Gebe in deinem Browser http://github.com/technikum29 ein. Folgende Seite erscheint: |
| 23 | |
| 24 | [[Image(github-t29-guide-09.jpg, width=100%)]] |
| 25 | |
| 26 | Das erste gezeigte Projekt ist `technikum29-www`, die Website. Es gibt auch noch weitere Projekte. |
| 27 | |
| 28 | == 2. Schritt: Einloggen == |
| 29 | Gesetzt dem Fall, dass du einen Github-Account hast und er bereits dem Projekt zugeordnet ist, |
| 30 | klickst du nun auf ''Sign in'' oben rechts. |
| 31 | |
| 32 | [[Image(github-t29-guide-07.jpg, width=100%)]] |
| 33 | |
| 34 | Du kommst danach wieder auf die vorherige Seite. |
| 35 | |
| 36 | == 3. Schritt: technikum29-www anklicken == |
| 37 | Wähle nun das Projekt http://github.com/technikum29/technikum29-www aus. Du siehst nun die Übersicht |
| 38 | an Ordnern direkt im Wurzelverzeichnis (''Root'') der Homepage. |
| 39 | |
| 40 | [[Image(github-t29-guide-10.jpg, width=100%)]] |
| 41 | |
| 42 | Wichtig sind die Verzeichnisse `blog` für den Blog, `de` und `en` für die deutsche bzw. englischsprachige |
| 43 | Website, sowie `shared`, wo alles in Richtung Bilder drin ist. Diese befinden sich vor allem unter `/shared/photos`. |
| 44 | |
| 45 | Klicke nun auf `blog`. |
| 46 | |
| 47 | == 4. Schritt: Im Blogverzeichnis umschauen == |
| 48 | Im Verzeichnis https://github.com/technikum29/technikum29-www/tree/master/blog findest du alle Blogeinträge. |
| 49 | |
| 50 | [[Image(github-t29-guide-01.jpg, width=100%)]] |
| 51 | |
| 52 | Die Dateien folgen dem Namensschema `YYYY-MM-DD-Kurztitel.php`, wobei `YYYY-DD-MM` das aktuelle Datum sein sollte |
| 53 | und der Kurztitel ein oder zwei prägnante Wörter, die dann Teil der URL werden. Deswegen sollten sie keine Umlaute |
| 54 | oder Leerzeichen verwenden. Auch Groß- und Kleinschreibung ist wichtig. |
| 55 | |
| 56 | == 5. Schritt: Einen typischen Blogartikel anschauen == |
| 57 | Klicke nun einen Artikel an, zB. https://github.com/technikum29/technikum29-www/blob/master/blog/2019-09-20-Ankuendigung-Kickoff.php |
| 58 | |
| 59 | [[Image(github-t29-guide-03.jpg, width=100%)]] |
| 60 | |
| 61 | Hier siehst du, wie der Quellcode eines typischen Blogartikels aufgebaut ist. Vergleiche damit, was angezeigt |
| 62 | wird, wenn du http://technikum29.de/blog/2019-09-20-Ankuendigung-Kickoff.php anwählst oder was in der generierten |
| 63 | Übersicht auf http://technikum29.de/blog angezeigt wird. |
| 64 | |
| 65 | Die ersten Linien beinhalten Metadaten, die als PHP-Variablen `$variable = "Wert";` gesetzt werden. Diese Werte |
| 66 | werden maschinell weiterverarbeitet. Alles, was danach kommt, ist der direkte Inhalt des Blogartikels und in |
| 67 | der Markupsprache des Webs, HTML, geschrieben. |
| 68 | |
| 69 | == 6. Schritt: Eintragen zum Anlegen einer neuen Datei öffnen == |
| 70 | '''Gehe nun zurück''' und klicke oben rechts auf `Create new file`: |
| 71 | |
| 72 | [[Image(github-t29-guide-01.jpg, width=100%)]] |
| 73 | |
| 74 | == 7. Schritt: Neuen |
| 75 | |
| 76 | |