Skip to content

Latest commit

 

History

History
30 lines (28 loc) · 2.75 KB

README.md

File metadata and controls

30 lines (28 loc) · 2.75 KB
Raw

Vorlage für ein Lerntagebuch mit GitHub Pages

Diese Vorlage kann verwendet werden, um ein Blog mit GitHub Pages für den Kurs Bibliotheks- und Archivinformatik zu erstellen.

  1. Bei GitHub anmelden
  2. Mit dem Button Use this template ein eigenes Repository anlegen
    • Name und Beschreibung ausfüllen.
    • Für die Nutzung von GitHub-Pages muss das Repository öffentlich (public) sein.
  3. Die Einstellungen (Settings) des neuen Repositorys aufrufen
    • Im Menüpunkt "Pages" im Pulldown-Menü "Source" den branch master auswählen und Save-Button drücken
    • Die Seite lädt neu. Es erscheint jetzt die Meldung mit der Internetadresse des Blogs: "Your site is ready to be published at http://...".
    • Das Lerntagebuch ist jetzt bereits online. GitHub generiert nach jeder Änderung im Repository innerhalb von Sekunden neue HTML-Seiten, die unter der Adresse ...github.io... automatisch veröffentlicht werden.
  4. Metadaten in Datei _config.yml anpassen:
    • Ändern Sie Titel, Autor/in, Beschreibung.
    • Ändern Sie die E-Mail oder löschen Sie die Zeile, falls sie keine angeben wollen.
    • Setzen Sie Ihre Nutzernamen bei Twitter und GitHub ein oder löschen Sie die Zeilen.
  5. Titel und Willkommenstext in Datei index.md anpassen:
    • Die Angabe "title: ..." setzt den Untertitel der Seite.
    • Die Überschrift "## ..." und der Willkommenstext sind optional.
  6. Diese Anleitung in Datei README.md löschen (oder Erläuterungen zum GitHub Repository ergänzen)
  7. Blogposts im Ordner _posts anpassen
    • Die Vorlage enthält zwei Beispieldateien. Ändern Sie darin Text und Metadaten.
    • Die Dateien können auch umbenannt werden.
  8. Neue Blogposts erstellen
    • Wenn Sie weitere Blogbeiträge erstellen wollen, müssen Sie im Ordner _posts neue Dateien mit der Endung .md erstellen.
    • Orientieren Sie sich dabei an den Beispielen. Für die Darstellung in GitHub Pages sind die Metadaten (title: ..., date: ...) wichtig.
  9. Weitere Hinweise (optional):
    • Die Lizenz in Datei LICENSE anpassen: Voreingestellt ist der Lizenztext CC-BY 4.0. Diese Lizenz wird automatisch im GitHub Repository angezeigt. Falls Sie auch auf dem Lerntagebuch einen Lizenzhinweis ergänzen wollen, könnten Sie dies unter index.md tun.
    • Beschreibung im GitHub Repository ergänzen: Ganz oben kann ein kurzer Beschreibungstext und eine Internetadresse angegeben werden. Das erleichtert den Besucher*innen des GitHub Repositorys ihr Lerntagebuch zu finden.
    • Viele weitere Optionen finden Sie in der Dokumentation von GitHub Pages.