Vorlage für ein Lerntagebuch mit GitHub Pages.
https://felixlohmeier.github.io/lerntagebuch/
bac9ffc7af | ||
---|---|---|
_posts | ||
LICENSE | ||
README.md | ||
_config.yml | ||
index.md |
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.
- Bei GitHub anmelden
- 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.
- 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.
- Im Menüpunkt "Pages" im Pulldown-Menü "Source" den branch
- 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.
- Titel und Willkommenstext in Datei
index.md
anpassen:- Die Angabe "title: ..." setzt den Untertitel der Seite.
- Die Überschrift "## ..." und der Willkommenstext sind optional.
- Diese Anleitung in Datei
README.md
löschen (oder Erläuterungen zum GitHub Repository ergänzen) - Blogposts im Ordner
_posts
anpassen- Die Vorlage enthält zwei Beispieldateien. Ändern Sie darin Text und Metadaten.
- Die Dateien können auch umbenannt werden.
- 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.
- Wenn Sie weitere Blogbeiträge erstellen wollen, müssen Sie im Ordner
- 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 unterindex.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.
- Die Lizenz in Datei