Dieses README gibt einen kurzen Überblick darüber, was wo ist, wie was funktioniert und was wie getan werden kann.
Die LUG-LD Webseite lug-ld.de wird als Github Pages gehostet. Alles was dafür nötig ist liegt in diesem Repo.
- Direkt in Github mit dem eingebauten Web-Editor. Dazu braucht man die passenden Rechte im Repo, vergeben kann das @casartar und @halbrot.
- Das Repo auf den lokalen Rechner clonen, bearbeiten, pushen (Pull request erzeugen). Einer der Admins muss den PR dann prüfen und mergen.
Github Pages funktionieren so, das nach jeder Änderung im Repo eine statische Seite erzeugt wird. Änderungen sind meist nach wenigen Sekunden bis Minuten sichtbar, man muss nix tun. Der Generator für die statische Seite ist Jekyll. Jekyll verwendet Templates zur Darstellung, zusammen mit dem CSS und ein paar Scripts macht das Theme aus. Die lug-ld.de Webseite verwendet das Theme jekyll-theme-minimal.
Github Pages werden über die Datei _config.yaml gesteuert. Hier wird festgelegt:
- welches Theme verwendet wird
- welches Logo angezeigt wird
- der Titel der Seite
- wie bestimmte Variablen gesetzt werden. Welche Variablen das Theme zur Verfügung stellt, findet man im Repo der Template .
You can use the editor on GitHub to maintain and preview the content for your website in Markdown files.
Whenever you commit to this repository, GitHub Pages will run Jekyll to rebuild the pages in your site, from the content in your Markdown files.
Markdown is a lightweight and easy-to-use syntax for styling your writing. It includes conventions for
Syntax highlighted code block
# Header 1
## Header 2
### Header 3
- Bulleted
- List
1. Numbered
2. List
**Bold** and _Italic_ and `Code` text
[Link](url) and ![Image](src)
For more details see GitHub Flavored Markdown.
Your Pages site will use the layout and styles from the Jekyll theme you have selected in your repository settings. The name of this theme is saved in the Jekyll _config.yml
configuration file.
Having trouble with Pages? Check out our documentation or contact support and we’ll help you sort it out.