Kategorie

Update von CYAML auf YAML 3.3.1

Oktober 5th, 2011

Wir haben unser Projekt CYAML auf die neuste YAML Version 3.3.1 aktualisiert.

Zu diesem Anlass wollen wir auch einen kurzen Überblick über die Funktionen und den Einsatz von CYAML geben.

Was ist CYAML?

CYAML ist ein compass Plugin und bildet das YAML Framework in SASS/SCSS ab. compass ist ein Ruby gem der sowohl für Stand-Alone Layouts wie auch die Integration in Ruby on Rails verwendet werden kann.

Welche Vorteile bietet mir CYAML?

Mit CYAML ist es möglich sehr einfach einzelne Teile von YAML für die Gestaltung eines XHTML/CSS Layouts zu verwenden. Ziel ist es nur noch eine einzige css Datei zu haben, welche alle nötigen CSS Rules (ob Framework oder Projekteigene) beinhaltet und bei der Entwicklung trotzdem einzelne Stylesheet Files zu haben um Übersicht und Wiederverwendbarkeit zu gewährleisten. In der neusten CYAML Version werden sogar die Bilder des YAML Frameworks als inline-images im CSS integriert wodurch die Anzahl HTTP-Requests reduziert werden kann.

Wie verwende ich CYAML?

sudo gem install cyaml

Danach kann man ein neues Projekt erstellen:

compass create projectname -r cyaml --using 

Jetzt noch die Standardkonfiguration an den richtigen Ort verschieben:

cd projectname
mv .config.scss src/config.scss
mv .basemod.scss src/basemod.scss

Um den Start zu erleichtern stellen wir ein vorgefertigtes 3-Spalten HTML Template bereit. Dieses kann kopiert werden:

cp citrin.html index.html

In src/basemod.scss können nun alle projektspezifischen CSS Regeln eingefügt werden.

Um mehr Teile des YAML Frameworks zu verwenden kann man einfach bei den entsprechenden Zeilen in src/default_includes.scss die Kommentar-Zeichen entfernen.

Werte wie Header und Content-Höhe oder die Breite der Content-Spalten können als Variabeln in src/config.scss gesetzt werden.
Nachdem man die SCSS-Files nach seinen Wünschen angepasst hat kompiliert man noch alles in ein einzelnes CSS File (in diesem Fall stylesheets/basemod.css)

compass compile

Das Repository und die Dokumentation findet man auf github: https://github.com/servasat/cyaml