gantry5
5.5.19
Sind Sie bereit, mit Gantry 5 zu beginnen? Das ist großartig! Wir sind hier, um zu helfen.
Auf dieser Seite erhalten Sie einige schnelle Tipps, die Ihnen den Einstieg in Gantry 5 erleichtern. Eine ausführlichere Dokumentation zu jedem dieser Tipps finden Sie, indem Sie unten in jedem Abschnitt auf die Schaltfläche „Mehr erfahren“ klicken.
Wir hoffen, dass Ihnen Gantry 5 genauso viel Spaß macht wie uns bei der Erstellung.
Die Back-End-Verwaltungsanforderungen von Gantry lauten in der Reihenfolge ihrer Präferenz wie folgt:
Hinweis: Internet Explorer wird nicht mehr unterstützt
Gantry 5 ist ein Framework, mit dem Gantry-basierte Themes erstellt werden. Damit ein Gantry-Theme funktioniert, müssen Sie sowohl das Framework als auch das Theme installieren. Dies zu tun ist überhaupt nicht schwierig.
Als Erstes müssen Sie die neueste Version von Gantry 5 und Hydrogen herunterladen. Sie können dies tun, indem Sie auf die untenstehenden Links klicken oder GitHub nutzen.
| Laden Sie Stable herunter | Laden Sie CI Builds herunter |
|---|
Sobald Sie über die neuesten Pakete verfügen, ist die Installation einfach. Wir haben im Installationsteil dieser Dokumentation eine Schritt-für-Schritt-Anleitung bereitgestellt.
Erfahren Sie mehr
Wenn Sie sowohl das Gantry-Framework als auch Hydrogen installiert und aktiviert haben, können Sie auf verschiedene Arten auf den Gantry 5-Administrator zugreifen. Am einfachsten ist es, einfach im Backend von Joomla zu Komponenten > Gantry 5-Vorlagen zu navigieren.
Hier sehen Sie eine Liste aller installierten Gantry-basierten Themes. Sie können hier eine Vorschau des Themas anzeigen oder „Konfigurieren“ auswählen, um direkt zum Gantry-Administrator zu gelangen, wo Sie mit der Änderung Ihrer Gantry-basierten Site beginnen können.
Der Gantry-Administrator verfügt über mehrere Verwaltungstools, die Sie durchblättern können, um das Aussehen und die Funktionsweise Ihres Gantry-basierten Themes zu konfigurieren. Hier finden Sie eine kurze Übersicht über jedes dieser Tools und was Sie damit machen können.
Im Gantry 5 Administrator werden Ihnen folgende Menüpunkte auffallen:
Menü-Editor : Dieses Verwaltungsfenster bietet Ihnen die Möglichkeit, das Menü der Plattform zu verbessern, indem Sie den Stil ändern, Links neu anordnen und Menüelemente erstellen, die außerhalb des integrierten Menü-Managers des CMS liegen.
Über : Auf dieser Seite erhalten Sie schnell und auf einen Blick Informationen über das aktuell aufgerufene Thema. Dies ist eine zentrale Anlaufstelle für Informationen zum Thema, einschließlich Name, Versionsnummer, Ersteller, Support-Links, Funktionen und mehr.
Plattformeinstellungen : Mit dieser Schaltfläche gelangen Sie zur CMS-Einstellungsseite für Gantry 5. In Joomla ist dies die Konfigurationsseite für Berechtigungen .
Cache löschen : Diese Schaltfläche löscht die Cache-Dateien im Zusammenhang mit Gantry. Dazu gehören alle temporären Dateien außerhalb von CSS- und Konfigurationsinformationen.
Outlines-Dropdown : Dieses Dropdown-Menü erleichtert den schnellen Wechsel zwischen Outlines, ohne den Gantry-Administrator verlassen zu müssen.
Stile : Über dieses Verwaltungsfenster haben Sie Zugriff auf stilbezogene Umrisseinstellungen. Dazu gehören Dinge wie Designfarben, Schriftarten, Stilvoreinstellungen und mehr.
Einstellungen : Dieses Verwaltungsfenster bietet Ihnen die Möglichkeit, die Funktionseinstellungen des Themas zu konfigurieren. Dazu gehört das Festlegen von Standardwerten für Partikel sowie das Aktivieren/Deaktivieren einzelner Partikel.
Layout : In diesem Verwaltungsbereich können Sie das Layout für Ihr Theme konfigurieren. In diesem Panel können Sie Modulpositionen, Partikel, Abstandshalter und nicht gerenderte Skripte wie Google Analytics-Code erstellen und platzieren.
Erfahren Sie mehr
Da sich Gantry 5 so sehr von allen Vorgängerversionen von Gantry unterscheidet, haben wir einige Begriffe entwickelt, um die Beziehungen zwischen den neuen Funktionen von Gantry besser zu verstehen. Hier finden Sie eine kurze Aufschlüsselung häufig verwendeter Begriffe im Zusammenhang mit Gantry 5.
| Begriff | Definition |
|---|---|
| Gliederung | Ein konfigurierbarer Stil, der in einem oder mehreren Bereichen Ihrer Website verwendet wird. Es dient als Container, in dem Stil, Einstellungen und Layout einer Seite festgelegt werden. |
| Teilchen | Ein typischerweise kleiner Datenblock, der im Frontend verwendet wird. Es verhält sich ähnlich wie ein Widget/Modul, kann aber einfach im Gantry 5 Administrator konfiguriert werden. |
| Atom | Ein Partikeltyp, der nicht gerenderte Daten enthält, z. B. benutzerdefinierte Skripte (JS, CSS usw.) oder Analyseskripte für die Datenverkehrsverfolgung. |
Erfahren Sie mehr
Mit Gitter wurde ein Chatroom eingerichtet, in dem Sie mit Entwicklern, Mitwirkenden und anderen Mitgliedern der Community über das Projekt sprechen können. Dies ist der beste Ort, um schnelle Tipps zu erhalten und Funktionen mit anderen zu besprechen.
Dokumentation ist ebenfalls verfügbar und wird im Laufe der Entwicklung kontinuierlich ergänzt. Fehlt etwas? Sie können über GitHub zur Dokumentation beitragen.
Es ist einfach, zum Gantry 5-Framework oder zur zugehörigen Dokumentation beizutragen. Die Entwicklung dieser beiden Projekte erfolgt über Github, wo Sie Issues einreichen können, um Fehler zu melden oder Verbesserungen vorzuschlagen, sowie Ihre eigenen Pull Requests einreichen, um Ihre eigenen Korrekturen und Ergänzungen einzureichen.
Wir empfehlen, mit dem Team über Gitter zu chatten, bevor Sie die Pull-Anfrage einreichen, um zu vermeiden, dass Sie sich mit einem Fix befassen, der bereits aussteht oder wahrscheinlich durch eine bevorstehende Änderung überschrieben wird.
Um die Git-Version von Gantry verwenden zu können, müssen Sie zunächst Composer-Abhängigkeiten installieren. Führen Sie dazu Folgendes aus:
bin/composer-install
Danach müssen Sie Gantry ordnungsgemäß mit Ihrer CMS-Installation verknüpfen.
In unserer Entwicklungsumgebung verwenden wir Gulp , um JavaScript zu bündeln und SCSS mit der watch Funktion zu kompilieren, sodass jede Änderung an Zieldateien automatisch die Neukompilierung auslöst.
Wenn Sie dies in Ihrer eigenen Entwicklungsumgebung einrichten möchten, können Sie dies anhand dieser einfachen Anweisungen tun.
Beachten Sie, dass Sie dafür eine Gantry 5 -Quelle und kein Paket benötigen, damit dies funktioniert. Sie können es entweder klonen oder die Quelle von GitHub herunterladen .
Das erste, was Sie brauchen, ist Node / NPM . Wenn Sie sie noch nicht haben, können Sie das Installationsprogramm für Ihr Betriebssystem unter https://nodejs.org/download/ herunterladen.
Der nächste Schritt besteht darin, alle Abhängigkeiten des JS-Moduls zu installieren. Stellen Sie dazu sicher, dass Sie sich im Stammverzeichnis des Gantry 5-Projekts befinden, und führen Sie den Befehl npm install aus.
Sobald dies erledigt ist, können Sie Gulp installieren. Wir empfehlen, Gulp global zu installieren, damit Sie den Befehl von jedem Ordner aus verwenden können. Hier ist der Befehl dazu: sudo npm install gulp --global
Gantry verfügt über verschiedene Sätze von JS- und CSS-Dateien, die aus dem Stammverzeichnis neu kompiliert werden können. Wenn Sie Gantry zum ersten Mal verwenden oder alle Module zurücksetzen und neu installieren müssen, können Sie den Befehl npm run build-assets ausführen. Durch diesen Vorgang werden alle node_modules -Ordner entfernt und npm install in allen Projektordnern erneut ausgeführt. Es wird eine Weile dauern.
Eine alternative Methode, die nicht alle node_modules -Ordner entfernt, ist gulp -up .
Zusammen mit dem Befehl
-upkönnen Sie alternativ-update,--update,-up,--up,-install,--install,-inst,--inst,-go,--go,-deps,--depsverwenden.--deps. Was auch immer für Sie leichter zu merken ist. Der Code erkennt selbstständig, ob er zum ersten Mal installiert werden muss oder nur die Knotenmodule aktualisieren muss.Beachten Sie, dass dies einige Momente dauern kann.
An diesem Punkt haben Sie alles, was Sie zum Ausführen von Gulp benötigen. Geben Sie einfach den Befehl gulp ein und Sie sollten sehen, wie CSS und JS kompiliert werden.
Wir bieten auch ein paar praktische Aufgaben:
$ gulp / $ gulp all : Kompiliert das gesamte CSS und JS im Projekt.$ gulp watch : Startet den Compiler im watch Modus. Jede Änderung, die an gezielten JS- oder SCSS -Dateien vorgenommen wird, löst eine automatische Neukompilierung aus.$ gulp watch --css / $ gulp watch --js : Startet die Compiler im watch und lauscht nur auf SCSS- oder JS- Änderungen. Nützlich, wenn Sie sich nur auf das eine und nicht auf das andere konzentrieren.$ gulp css / $ gulp js : Kompiliert alle CSS- oder JS-Dateien, falls Sie nur an einer und nicht an der anderen arbeiten.$ gulp —prod : Kompiliert jedes CSS und JS im Produktionsmodus. Die kompilierten Dateien verfügen über keine Quellzuordnungen und werden komprimiert (dies dauert normalerweise etwas länger als im normalen Modus). Die JSON-Datei für Google Fonts kann generiert werden, indem Sie der Anleitung unter https://developers.google.com/fonts/docs/developer_api folgen oder einfach https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY verwenden https://www.googleapis.com/webfonts/v1/webfonts?key=YOUR-API-KEY -URL. Sie müssen die Verwendung der Google Fonts API aktivieren und Ihren API-Schlüssel anstelle von YOUR-API-KEY angeben.
Gantry Framework v5 oder höher ist unter einem Doppellizenzsystem (MIT oder GPL Version 2 oder höher) lizenziert. Dies bedeutet, dass Sie frei wählen können, welche Lizenz (MIT oder GPL Version 2 oder höher) für Ihre Anforderungen geeignet ist.
| Weitere Details |
|---|
