Setting Up Your Local Environment/de: Difference between revisions

Revision as of 12:08, 19 August 2018

Tutorial
Handbuch für die Einrichtung von Joomla! 4 an die eigene Umgebung

Joomla!

4.x

Mit Joomla! 4 haben wir den Entwicklungsprozess verändert, es ist nicht länger möglich, die Paketquellen zu klonen und damit eine verwendbare Joomla! Installation zu erhalten. Wir richten uns hier an die besten Erfahrungen und haben einen Bauvorgang für das CMS eingefügt.

Schnellstartanweisungen

Es hängt von deinem Betriebssystem ab, was du alles tun musst, die Entwicklungsumgebung zu installieren. Wir können leider keine Dokumentation für alle Betriebssystem schreiben, daher solltest du deine bevorzugte Suchmaschine nach einer Anleitung fragen.

benötigte Werkzeuge

PHP - im Wesentlichen dasselbe wie beim Betreiben einer Joomla! Seite, allerdings brauchst du eine spezielle Version, die PHP CLI (Kommandozeileneingabe) (beachte auch die Seite Einrichten eines LAMPP Servers für die PHP Entwicklung)
Composer - um die Abhängigkeiten von Joomla!s PHP zu verwalten - Hilfe bei der Installation von Composer bietet die Dokumentation auf https://getcomposer.org/doc/00-intro.md
Node.js - um Joomla!s JavaScript und SASS Dateien zu kompilieren - Hilfe bei der Installation von Node.js bieten die Anweisungen die auf https://nodejs.org/en/ erhältlich sind.
Git - für die Versionsverwaltung

Schritt für Schritt zur Installation der eigenen Umgebung

Klone die Paketquelle
führe composer install im Wurzelverzeichnis der git Paketquelle aus (du kannst --ignore-platform-reqs hinzufügen falls du PHP-LDAP lokal nicht installiert und du es nicht brauchst)
führe npm install im Wurzelverzeichnis der git Paketquelle aus

Die etwas längere Startanleitung

Joomla! unterscheidet sich heutzutage nicht von anderen Internetwerkzeugen. Es weist einen großen PHP-Teil auf und erhält mehr und mehr JavaScriptcode. Während die Programmierung mit PHP nicht sehr viel Vorbereitung benötigt, braucht JavaScript eine umfangreiche Werkzeugumgebung. Der Hauptgrund liegt darin, dass niemand Programmkode auf eine Weise schreibt, die jeder Browser versteht, daher muss der Kode auch von zum Beispiel ES6 in eine kompatible Version von JavaScript transkompiliert werden. Dasselbe gilt für CSS, bei Joomla! verwenden wir SASS, dieses wird in natives CSS konvertiert, sodass es jeder Browser verstehen kann. Die Kehrseite bei der Installation einer Entwicklerumgebung ist, dass es ein bisschen komplizierter ist, dafür die Werkzeugausstattung das Programmieren viel bequemer macht. Dank Wächtern und dem automatischen Browserreload werden Änderungen in Echtzeit angezeigt.

PHP

Es sollte reichen, composer install auszuführen. Dies wird die PHP Abhängigkeiten, die in der composer.lock Datei gespeichert sind, installieren. Man kann dies beliebig oft wiederholen, es werden nur neue Pakete installiert, wenn die composer.lock Datei verändert wird. Bitte composer update nicht ausführen, da dadurch alle Pakete auf neuere Versionen und die composer.lock Datei aktualisiert werden.

Beachte: Eventuell muss composer install mit der Option --ignore-platform-reqs ausgeführt werden um Plattformanforderungen, die in Composer näher spezifiziert sind, zu ignorieren, dass heißt falls du die PHP LDAP Erweiterung nicht installiert hast.

Node/npm Skripte

Node.js wird mit einem Paketmanager names NPM (in manchen Dingen das Gleich wie Composer) ausgeliefert. NPM hat einen run Befehl und wir haben ein paar Skripte vorbereitet, die dir das Leben erleichtern. Man muss die Befehle im Stammverzeichnis der Paketquellen ausführen.

npm run build:css

It will compile SASS files to CSS and also create the minified files.

npm run build:js

It will compile and transpile the JavaScript files to the correct format and create minified files

npm run watch:css

This is the same as the build:css command but will watch for changes and automatically build updated files.

npm run watch:js

This is the same as the build:js command but will watch for changes and automatically build updated files.

npm run lint:js

This will make a syntax check on JavaScript files.

npm run test

This will run other JavaScript testing suite.

@@ Line 29: / Line 29: @@
 ===Node/npm Skripte===
-Node.js comes with a package manager called NPM (in some way the same as Composer). NPM has a <tt>run</tt> command and we have prepared some scripts to make your life easier. You have to run the commands for the root of the repository.
+Node.js wird mit einem Paketmanager names NPM (in manchen Dingen das Gleich wie Composer) ausgeliefert. NPM hat einen <tt>run</tt> Befehl und wir haben ein paar Skripte vorbereitet, die dir das Leben erleichtern. Man muss die Befehle im Stammverzeichnis der Paketquellen ausführen.
 ==== npm run build:css ====

J4.x