Changes between Version 1 and Version 2 of Website/Github zum Bearbeiten nutzen


Ignore:
Timestamp:
Nov 20, 2019, 2:56:30 PM (4 years ago)
Author:
sven
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Website/Github zum Bearbeiten nutzen

    v1 v2  
    11= Mini-Anleitung, um Github zum Bearbeiten der Website zu nutzen. =
     2
     3Da die [[Website]] bislang sehr traditionell bearbeitet wurde -- ein einziger Ordner, direkt mit HTML, gibt
     4es keine Weboberfläche zur Bearbeitung (wie etwa in einer Wiki wie dieser hier). Auch erfordert der Einsatz
     5von 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
     7hat. Um zumindest die Bearbeitung etwas einfacher zu machen, wird der Code der technikum29-Website
     8seit 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
     10moderner. Der angedachte Workflow ist bei Github, dass man das Coderepository auf seinem Computer ''klont''
     11bzw. ''auscheckt'' und Änderungen dann mittels einem Git-Client ''pusht'' bzw. ''eincheckt''. Sie werden dann
     12automatisch auf der technikum29-Website übernommen.
     13
     14Allerdings erlaubt die Github-Website auch, direkt online Änderungen vorzunehmen, ohne auf seinem Computer
     15Git 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
     17Dateien als auch die Eingabe eines Textdokumentes (PHP und HTML sind Plain-Text-Files) ist möglich.
     18
     19Diese Anleitung soll anhand Bildern exemplarisch zeigen, wie man einen neuen Blog-Eintrag einbindet.
     20
     21== 1. Schritt: Repository aufsichen ==
     22Gebe in deinem Browser http://github.com/technikum29 ein. Folgende Seite erscheint:
     23
     24[[Image(github-t29-guide-09.jpg, width=100%)]]
     25
     26Das erste gezeigte Projekt ist `technikum29-www`, die Website. Es gibt auch noch weitere Projekte.
     27
     28== 2. Schritt: Einloggen ==
     29Gesetzt dem Fall, dass du einen Github-Account hast und er bereits dem Projekt zugeordnet ist,
     30klickst du nun auf ''Sign in'' oben rechts.
     31
     32[[Image(github-t29-guide-07.jpg, width=100%)]]
     33
     34Du kommst danach wieder auf die vorherige Seite.
     35
     36== 3. Schritt: technikum29-www anklicken ==
     37Wähle nun das Projekt http://github.com/technikum29/technikum29-www aus. Du siehst nun die Übersicht
     38an Ordnern direkt im Wurzelverzeichnis (''Root'') der Homepage.
     39
     40[[Image(github-t29-guide-10.jpg, width=100%)]]
     41
     42Wichtig sind die Verzeichnisse `blog` für den Blog, `de` und `en` für die deutsche bzw. englischsprachige
     43Website, sowie `shared`, wo alles in Richtung Bilder drin ist. Diese befinden sich vor allem unter `/shared/photos`.
     44
     45Klicke nun auf `blog`.
     46
     47== 4. Schritt: Im Blogverzeichnis umschauen ==
     48Im 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
     52Die Dateien folgen dem Namensschema `YYYY-MM-DD-Kurztitel.php`, wobei `YYYY-DD-MM` das aktuelle Datum sein sollte
     53und der Kurztitel ein oder zwei prägnante Wörter, die dann Teil der URL werden. Deswegen sollten sie keine Umlaute
     54oder Leerzeichen verwenden. Auch Groß- und Kleinschreibung ist wichtig.
     55
     56== 5. Schritt: Einen typischen Blogartikel anschauen ==
     57Klicke 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
     61Hier siehst du, wie der Quellcode eines typischen Blogartikels aufgebaut ist. Vergleiche damit, was angezeigt
     62wird, 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
     65Die ersten Linien beinhalten Metadaten, die als PHP-Variablen `$variable = "Wert";` gesetzt werden. Diese Werte
     66werden maschinell weiterverarbeitet. Alles, was danach kommt, ist der direkte Inhalt des Blogartikels und in
     67der 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
© 2008 - 2013 technikum29 • Sven Köppel • Some rights reserved
Powered by Trac
Expect where otherwise noted, content on this site is licensed under a Creative Commons 3.0 License