Transifex mit Contao Toolbox: Unterschied zwischen den Versionen
Aus Contao Community Documentation
K |
(→Installation) |
||
| Zeile 11: | Zeile 11: | ||
=Installation= | =Installation= | ||
| + | Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen. | ||
| + | ==Über composer== | ||
| + | Download composer wenn noch nicht vorhanden: | ||
| + | <source lang="bash"> | ||
| + | curl -sS https://getcomposer.org/installer | php | ||
| + | </source> | ||
| + | Und nun die Contao Toolbox installieren: | ||
| + | <source lang="bash"> | ||
| + | php composer create-project --prefer-source cyberspectrum/contao-toolbox | ||
| + | </source> | ||
| + | {{Achtung|Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später)}} | ||
| + | <source lang="bash"> | ||
| + | Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n | ||
| + | </source> | ||
| + | |||
| + | ==Über Git Cloning== | ||
| + | <source lang="bash"> | ||
| + | git clone https://github.com/discordier/contao-toolbox.git | ||
| + | </source> | ||
| + | Anschließend als erstes die Abhängikeiten auflösen. | ||
| + | <source lang="bash"> | ||
| + | php composer update | ||
| + | </source> | ||
| + | |||
| + | ===Optional: eine ctb.phar kompilieren=== | ||
| + | Zum kompilieren ruft man das mitgelieferten Compiler-Script auf. | ||
| + | <source lang="bash"> | ||
| + | ./bin/compile-ctb | ||
| + | </source> | ||
| + | Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein alias anlegen um ctb ohne die Endung .phar aufrufen zu können. | ||
| + | |||
| + | Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellunge in der php.ini, dort muss definiert sein: | ||
| + | <source lang="ini"> | ||
| + | [Phar] | ||
| + | phar.readonly = Off | ||
| + | </source> | ||
| + | Weitere Hinweise dazu: [http://php.net/phar.readonly php.net/phar.readonly] | ||
=Konfiguration= | =Konfiguration= | ||
Version vom 7. Juli 2014, 14:40 Uhr
Inhaltsverzeichnis
Was ist das?
Die Contao-Toolbox, kurz ctb, gibt es auf GitHub: contao-toolbox
Das Konzept dahinter ist folgender.
- der Entwickler legt wie bisher PHP Sprachdateien an für die Ursprungsprache, z.B. "en", im Modul Unterverzeichnis language/en/
- mit ctb werden die Sprachdateien in das XLIFF Format gewandelt
- anschließend werden diese XLIFF Dateien mit ctb hoch geladen nach Transifex und tauchen dadurch in der Ursprungsprache als Ressourcen auf
- übersetzte Ressourcen anderer Sprachen werden mit ctb runter geladen im XLIFF Format
- anschließend werden mit ctb diese in PHP Sprachdateien umgewandelt und in das passende Verzeichnis abgelegt, z.B. language/de/
Installation
Die Installationanleitung entspricht der aus der Readme von ctb und kann auf zwei Arten erfolgen.
Über composer
Download composer wenn noch nicht vorhanden:
curl -sS https://getcomposer.org/installer | php
Und nun die Contao Toolbox installieren:
php composer create-project --prefer-source cyberspectrum/contao-toolbox
 |
Achtung: Am Ende der Installation wird gefragt, ob die VCS History gelöscht werden kann, hier mit 'n' dieses verneinen. Sonst arbeitet der Compiler nicht richtig (folgt später) |
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]? n
Über Git Cloning
git clone https://github.com/discordier/contao-toolbox.git
Anschließend als erstes die Abhängikeiten auflösen.
php composer update
Optional: eine ctb.phar kompilieren
Zum kompilieren ruft man das mitgelieferten Compiler-Script auf.
./bin/compile-ctb
Diese phar Datei kann man nun in ein Pfad kopieren auf dem ein Suchpfad liegt. Dadurch ist die spätere Nutzung einfacher. Dazu noch ein alias anlegen um ctb ohne die Endung .phar aufrufen zu können.
Falls es zu einem Compiler Fehler kommt liegt es wohl an einer Einstellunge in der php.ini, dort muss definiert sein:
[Phar] phar.readonly = Off
Weitere Hinweise dazu: php.net/phar.readonly
Konfiguration
(composer.json / config.json)
Kommandozeilen Workflow
Upload weiterer Sprachen
TODO: Wird ergänzt.
