bourbon

Ab dem 13. September 2024 veraltet

Dieses Projekt ist nicht mehr aufrechterhalten. Wir ermutigen die Menschen, die modernen einheimischen CSS -Merkmale anstelle dieser Bibliothek zu nutzen. Sie können sich auf unseren Blog -Beitrag beziehen, um jeden Helfer zu ersetzen oder zu überdenken.

Ein leichtes Sass -Werkzeugsatz

Bourbon ist eine Bibliothek von SASS -Mixins und Funktionen, die Sie zu einem effizienteren Autor für Style Sheet machen sollen.

Es ist…

• Abhängig frei: Bourbon ist reiner Sass.
• Menschlich lesbar: Wir streben nach Klarheit über die Kürze.
• Leichtes Gewicht: Null Ausgabe nach der Installation und hat keine visuelle Meinung.

Hilfreiche Links

• Dokumentation
• Protokoll ändern
• Twitter
• Stapelüberlauf

Inhaltsverzeichnis

• Anforderungen
• Installation
• Befehlszeilenschnittstelle
• Browserunterstützung
• Beitragen
• Lizenz
• Um

Anforderungen

• SASS 3.4+ oder libsass 3.3+

Installation

1. Installieren Sie das Bourbon -Juwel mit dem RubyGems Paket Manager:

   gem install bourbon

2. Installieren Sie die Bourbon -Bibliothek in das aktuelle Verzeichnis:

   bourbon install

   Pro -Tipp: Sie können die Installation in ein bestimmtes Verzeichnis mit dem path ansprechen:

   bourbon install --path my/custom/path/

3. Importieren Sie Bourbon zu Beginn Ihres Stylesheet:

    @import " bourbon/bourbon " ;

   Es wird nicht empfohlen, dass Sie die Dateien von Bourbon direkt ändern, da die Aktualisierung auf zukünftige Versionen schwierig wird, indem Sie Ihre benutzerdefinierten Änderungen überschreiben oder Konflikte für Zusammenführungen verursachen.

Installation für Ruby on Rails 4.2+

1. Fügen Sie Bourbon zu Ihrer GemFile hinzu:

    gem "bourbon"

2. Dann rennen:

   bundle install

3. Starten Sie Ihren Server neu und benennen Sie application.css in application.scss um:

   mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss

4. Löschen Sie alle Kettenräderanweisungen in application.scss ( require , require_tree und require_self ) und verwenden Sie stattdessen das native @import von Sass (warum?).

5. Importieren Sie Bourbon zu Beginn von application.scss . Alle Projektstile, die die Funktionen von Bourbon nutzen, müssen nach Bourbon importiert werden.

    @import " bourbon " ;
   @import " home " ;
   @import " users " ;

Installieren mit NPM und Verwendung einer knotenbasierten Asset-Pipeline

1. Fügen Sie Bourbon als Abhängigkeit hinzu:

   npm install --save bourbon

2. Wenn Sie eine Brille verwenden, gehen Sie zu Schritt 3. Andernfalls müssen Sie Bourbon zu Ihrer Option von Node-Sass includePaths hinzufügen. require("bourbon").includePaths ist eine Reihe von Verzeichnissen, die Sie an Node-Sass übergeben sollten. Wie Sie dies tun, hängt davon ab, wie Knoten-Sass in Ihr Projekt integriert wird.

3. Importieren Sie Bourbon in Ihre Sass -Dateien:

    @import " bourbon " ;

Installation älterer Versionen von Bourbon

1. Deinstallieren Sie alle Bourbon -Gem -Versionen, die Sie bereits haben:

   gem uninstall bourbon

2. Setzen Sie das Bourbon -Juwel mit dem -v -Flag neu, um die von Ihnen benötigte Version anzugeben:

   gem install bourbon -v 4.2.7

3. Befolgen Sie die obigen Anweisungen, um Bourbon in Ihr Projekt zu installieren.

Befehlszeilenschnittstelle

bourbon [options]

Optionen

Option	Beschreibung
-h , --help	Hilfe zeigen
-v , --version	Zeigen Sie die Versionsnummer an
--path	Geben Sie einen benutzerdefinierten Pfad an
--force	Force Installation (Überschreibe)

Befehle

Befehl	Beschreibung
bourbon install	Installieren Sie Bourbon in das aktuelle Verzeichnis
bourbon update	Bourbon im aktuellen Verzeichnis überschreiben und aktualisieren
bourbon help	Hilfe zeigen

Browserunterstützung

Bourbon unterstützt Internet Explorer 11+ und die neuesten Versionen von Chrome, Firefox, Safari und Edge.

Beitragen

Siehe das beitragende Dokument. Danke, Mitwirkende!

Lizenz

Bourbon ist Copyright © 2011 Thoughtbot, Inc. Es handelt sich um kostenlose Software und kann unter den in der Lizenz angegebenen Bedingungen umverteilt werden.

Über Thinkbot

Dieses Repo wird von Thoughtbot, Inc. gepflegt und finanziert. Die Namen und Logos für Thoughtbot sind Marken von Thoughtbot, Inc.

Wir lieben Open -Source -Software! Sehen Sie unsere anderen Projekte. Wir stehen zur Verfügung.