Vorlage für ein Lerntagebuch mit GitHub Pages. https://felixlohmeier.github.io/lerntagebuch/
Go to file
Felix Lohmeier 41310d515e
Entwurf Anleitung
2020-04-13 14:50:00 +02:00
_posts Update and rename 2020-03-28-my-first-blog-post.md to 2020-03-28-tag1.md 2020-04-13 14:06:50 +02:00
LICENSE Lizenz CC-BY 2020-04-13 14:02:44 +02:00
README.md Entwurf Anleitung 2020-04-13 14:50:00 +02:00
_config.yml Vorlage Konfiguration 2020-04-13 13:57:27 +02:00
index.md Vorlage Startseite 2020-04-13 13:55:32 +02:00

README.md

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
    • Weiter unten auf der Seite unter der Überschrift "GitHub Pages" im Pulldown-Menü "Source" die Einstellung master branch auswählen.
    • Die Seite mit den Einstellungen lädt neu. An der gleichen Stelle (Überschrift "GitHub Pages") erscheint jetzt die Internetadresse: "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.