Website zum Schweriner Webmontag
HTML CoffeeScript Ruby CSS JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_site
data
locales
source
.gitignore
.jekyll-metadata
Gemfile
Gemfile.lock
README.md
Rakefile
config.rb

README.md

Website zum Schweriner Webmontag

Grundlagen

Die Website basiert auf dem Static Site Generator Middleman, dem ConfMan - Conference Site Template und Bootstrap.

Website bearbeiten

Zum Bearbeiten brauchst du eigentlich nur einen Texteditor. Wenn du die Seite auch für die Veröffentlichung 'bauen', oder eine lokale Vorschau sehen möchtest, brauchst du Ruby, Middleman und den Bundler.

Den Code holst du dir mit:

git clone git@github.com:WebmontagSN/webmontag-schwerin.de.git

Danach installierst du Middleman und läßt Bundler die Abhängigkeiten installieren:

cd webmontag-schwerin.de
gem install middleman
bundle install

Wenn du beim Bearbeiten die Änderungen gleich im Browser sehen möchtest, kannst du einen lokalen Server mit LiveReload-Unterstützung laden.

middleman server

Die Ordner

build

Dieser Ordner enthält die fertige Website. Bitte nimm hier keine Änderungen von Hand vor. Sie werden beim nächsten Build der Website überschrieben. Falls du hier Dateien benötigst, leg sie im source Ordner an die entsprechende Stelle.

data

Die Texte sowie die Infos zu den Veranstaltungen und Sprechern findest du in YAML Dateien in diesem Ordner.

source

Im downloads Ordner können Dateien für den Download hinterlegt werden. Diese sind dann auch unter /downloads/* erreichbar.

Der layouts Ordner enthält das HTML-Gerüst der Website.

Den HTML-Code für die verschiedenen Bereiche der Website findest du im partials Ordner.

Der public Ordner enthält CSS, JS und Bilder.

Howto ...

Nach allen Änderungen musst du die Seite deployen damit die Änderungen online sichtbar werden. Dieser Vorgang wird weiter unten beschrieben.

Nächste Veranstaltung ausblenden

Wenn dir der letzte Webmontag nach seinem Termin zu lange auf der Seite steht und noch nicht ausreichend Daten für den nächsten Termin vorhanden sind, kannst du den ganzen Block ausblenden. Öffne dazu die Datei data/pages.yml und ändere die Zeile

- Next: Der nächste Termin

in

# - Next: Der nächste Termin

Veranstaltung anlegen

to be written

Speaker anlegen

Zu jedem Sprecher gehören ein Bild und die Daten. Das quadratische Profilfoto legst du im Ordner public/img/speakers ab. Folge bei der Vergabe des Dateinamens einfach dem Muster der bereits vorhandenen Bilder.

Die Daten hinterlegst du in der Datei data/speakers.yml. Am besten kopierst du den obersten Eintrag und ersetzt dann die Daten. Die URL im Feld company_url wird in der Ausgabe mit dem Namen des Sprechers verlinkt. Die URL aus dem Feld url wird mit dem Bild verlinkt. Unter social kannst du die URLs zu diesen Diensten hinterlegen:

  • xing
  • linkedin
  • twitter
  • google-plus
  • slideshare
  • github

Die Reihenfolge der Sprecher auf der Seite wird bei jedem Build der Seite zufällig generiert.

Gastgeber anlegen

Das Logo des Gastgebers mit weißem oder transparentem Hintergrund speicherst du unter public/img/hosts ab. In der Datei data/hosts.yml kopierst du einen vorhandene Eintrag und passt die Daten entsprechend an. Die Reihenfolge der Gastgeber sollte die Häufigkeit unserer Besuche widerspiegeln.

Shortnews anlegen

Shortnews werden auf der Startseite rechts neben dem letzten Blogbeitrag und im Feed ausgegeben. Die News befindet in der Datei data/news.yml. Dort kannst du die Daten entsprechend anpassen.

Blogbeitrag anlegen

Für einen Blogbeitrag legst du im Ordner source/blog eine neue Datei an. Der Dateiname sollte folgendem Schema folgen YYYY-titel-des-beitrages.html.md. Wenn der Beitrag eine Bildergalerie enthalten soll muss der Dateiname YYYY-titel-des-beitrages.html.md.erblauten. Die Endungen geben an, durch welche Parser der Beitrag läuft und wie die Endung am Ende lauten soll. Indiesem Fall wird es immer eine HTML Datei.

Die Datei besteht aus einem Header und dem eigentlichen Inhalt und sieht so aus:

---
title: Titel des Beitrages
date: YYYY-MM-DD
author: Michael Milz
teaser: >
  Hier steht der Teaser.
  Zeilenumbrüche sind möglich.
---

Hier kommt der Inhalt. Du kannst Markdown und/oder HTML zur Formatierung nutzen.

Der Name des Autors muss in data/authors.yml hinterlegt sein.

Website veröffentlichen

Die Website ist hier bei Github über Github-Pages gehostet. Damit deine Änderungen online sichtbar werden, muss Middleman die Seite bauen und in den gh-pages Branch pushen. Das veranlasst du mit:

middleman deploy

Deine Änderungen am Code musst du separat committen und pushen!

Fehler gefunden?

Als Mitglied im WebmontagSN Team bei github kannst du die Änderungen selbst vornehmen und die Seite deployen. Ansonsten können Fehler als Issue gemeldet werden.