diff --git a/README.md b/README.md index 243abdf..73cb27d 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,30 @@ -# Your GitHub Learning Lab Repository for GitHub Pages +# Vorlage für ein Lerntagebuch mit GitHub Pages -Welcome to **your** repository for your GitHub Learning Lab course. This repository will be used during the different activities that I will be guiding you through. +Diese Vorlage kann verwendet werden, um ein Blog mit GitHub Pages für den Kurs [Bibliotheks- und Archivinformatik](https://github.com/felixlohmeier/bibliotheks-und-archivinformatik) zu erstellen. -Oh! I haven't introduced myself... - -I'm the GitHub Learning Lab bot and I'm here to help guide you in your journey to learn and master the various topics covered in this course. I will be using Issue and Pull Request comments to communicate with you. In fact, I already added an issue for you to check out. - -![issue tab](https://lab.github.com/public/images/issue_tab.png) - -I'll meet you over there, can't wait to get started! - -This repository is licensed under [MIT](../LICENSE) (c) 2019 GitHub, Inc. +1. Bei GitHub anmelden +2. Mit dem Button [Use this template](https://github.com/felixlohmeier/lerntagebuch/generate) 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](https://help.github.com/en/github/working-with-github-pages/setting-up-a-github-pages-site-with-jekyll).