From 3247b907768b520299bc4adae0adcc599d0b66d8 Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Mon, 23 May 2016 21:41:00 +0200 Subject: translate documentation to German --- docs/de/developer/api.rst | 270 ++++++++++++++++++++++++++ docs/de/developer/docker.rst | 57 ++++++ docs/de/developer/documentation.rst | 10 + docs/de/developer/maintenance.rst | 32 ++++ docs/de/developer/translate.rst | 57 ++++++ docs/de/index.rst | 52 +++++ docs/de/user/android.rst | 107 +++++++++++ docs/de/user/annotations.rst | 24 +++ docs/de/user/configuration.rst | 119 ++++++++++++ docs/de/user/create_account.rst | 25 +++ docs/de/user/download_articles.rst | 17 ++ docs/de/user/errors_during_fetching.rst | 28 +++ docs/de/user/faq.rst | 45 +++++ docs/de/user/filters.rst | 49 +++++ docs/de/user/first_article.rst | 68 +++++++ docs/de/user/import.rst | 46 +++++ docs/de/user/installation.rst | 326 ++++++++++++++++++++++++++++++++ docs/de/user/login.rst | 13 ++ docs/de/user/migration.rst | 62 ++++++ docs/de/user/tags.rst | 2 + docs/de/user/upgrade.rst | 32 ++++ 21 files changed, 1441 insertions(+) create mode 100644 docs/de/developer/api.rst create mode 100644 docs/de/developer/docker.rst create mode 100644 docs/de/developer/documentation.rst create mode 100644 docs/de/developer/maintenance.rst create mode 100644 docs/de/developer/translate.rst create mode 100644 docs/de/index.rst create mode 100644 docs/de/user/android.rst create mode 100644 docs/de/user/annotations.rst create mode 100644 docs/de/user/configuration.rst create mode 100644 docs/de/user/create_account.rst create mode 100644 docs/de/user/download_articles.rst create mode 100644 docs/de/user/errors_during_fetching.rst create mode 100644 docs/de/user/faq.rst create mode 100644 docs/de/user/filters.rst create mode 100644 docs/de/user/first_article.rst create mode 100644 docs/de/user/import.rst create mode 100644 docs/de/user/installation.rst create mode 100644 docs/de/user/login.rst create mode 100644 docs/de/user/migration.rst create mode 100644 docs/de/user/tags.rst create mode 100644 docs/de/user/upgrade.rst (limited to 'docs/de') diff --git a/docs/de/developer/api.rst b/docs/de/developer/api.rst new file mode 100644 index 00000000..f8911181 --- /dev/null +++ b/docs/de/developer/api.rst @@ -0,0 +1,270 @@ +API DoKumentation +================= + +Dank dieser Dokumentation werden wir sehen, wie wir mit der wallabag API interagieren. + +Voraussetzungen +--------------- + +* wallabag frisch (oder nicht) installiert auf http://localhost:8000 +* ``httpie`` installiert auf deinem Computer (`siehe Projektwebsite `__). Beachte, dass du die Kommandos auch mit curl oder wget nutzen kannst. +* alle API Methoden sind hier dokumentiert http://localhost:8000/api/doc + +Einen neuen API Client erstellen +-------------------------------- + +In deinem wallabag Account, kannst du einen neuen API Client unter dieser URL http://localhost:8000/developer/client/create erstellen. + +Gib dazu nur die Umleitungs-URL deiner Appliaktion an und erstelle deinen Client. Wenn deine Applikation eine Desktopapplikation ist, trage die URL, die dir am besten passt, ein. + +Du bekommst Informationen wie diese: + +:: + + Client ID: + + 1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc + + Client secret: + + 636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4 + + +Einen Aktualisierungstoken erhalten +----------------------------------- + +Für jeden API Aufruf brauchst du einen Token. Lass uns einen erstellen mit diesem Kommando (ersetze ``client_id``, ``client_secret``, ``username`` und ``password`` mit ihren Werten): + +:: + + http POST http://localhost:8000/oauth/v2/token \ + grant_type=password \ + client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc \ + client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4 \ + username=wallabag \ + password=wallabag + +Du bekommst folgendes zurück: + +:: + + HTTP/1.1 200 OK + Cache-Control: no-store, private + Connection: close + Content-Type: application/json + Date: Tue, 05 Apr 2016 08:44:33 GMT + Host: localhost:8000 + Pragma: no-cache + X-Debug-Token: 19c8e0 + X-Debug-Token-Link: /_profiler/19c8e0 + X-Powered-By: PHP/7.0.4 + + { + "access_token": "ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA", + "expires_in": 3600, + "refresh_token": "OTNlZGE5OTJjNWQwYzc2NDI5ZGE5MDg3ZTNjNmNkYTY0ZWZhZDVhNDBkZTc1ZTNiMmQ0MjQ0OThlNTFjNTQyMQ", + "scope": null, + "token_type": "bearer" + } + +Wir werden mit dem ``access_token`` Wert in unseren nächsten Aufrufen arbeiten. + +cURL Beispiel: + +:: + + curl -s "https://localhost:8000/oauth/v2/token?grant_type=password&client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc&client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4&username=wallabag&password=wallabag" + +Existierende Einträge erhalten +------------------------------ + +Dokumentation für diese Methode: http://localhost:8000/api/doc#get--api-entries.{_format} + +Da wir auf einer neuen wallabag Installation arbeiten, bekommen wir keine Ergebnisse mit diesem Kommando: + +:: + + http GET http://localhost:8000/api/entries.json \ + "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" + +gibt zurück: + +:: + + HTTP/1.1 200 OK + 0: application/json + Cache-Control: no-cache + Connection: close + Content-Type: application/json + Date: Tue, 05 Apr 2016 08:51:32 GMT + Host: localhost:8000 + Set-Cookie: PHPSESSID=nrogm748md610ovhu6j70c3q63; path=/; HttpOnly + X-Debug-Token: 4fbbc4 + X-Debug-Token-Link: /_profiler/4fbbc4 + X-Powered-By: PHP/7.0.4 + + { + "_embedded": { + "items": [] + }, + "_links": { + "first": { + "href": "http://localhost:8000/api/entries?page=1&perPage=30" + }, + "last": { + "href": "http://localhost:8000/api/entries?page=1&perPage=30" + }, + "self": { + "href": "http://localhost:8000/api/entries?page=1&perPage=30" + } + }, + "limit": 30, + "page": 1, + "pages": 1, + "total": 0 + } + +Das Array ``items`` ist leer. + +cURL Beispiel: + +:: + + curl --get "https://localhost:8000/api/entries.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" + +Deinen ersten Eintrag hinzufügen +-------------------------------- + +Dokumentation für diese Methode: http://localhost:8000/api/doc#post--api-entries.{_format} + +:: + + http POST http://localhost:8000/api/entries.json \ + "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" \ + url="http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html" + +gibt zurück: + +:: + + HTTP/1.1 200 OK + 0: application/json + Cache-Control: no-cache + Connection: close + Content-Type: application/json + Date: Tue, 05 Apr 2016 09:07:54 GMT + Host: localhost:8000 + Set-Cookie: PHPSESSID=bjie40ck72kp2pst3i71gf43a4; path=/; HttpOnly + X-Debug-Token: e01c51 + X-Debug-Token-Link: /_profiler/e01c51 + X-Powered-By: PHP/7.0.4 + + { + "_links": { + "self": { + "href": "/api/entries/1" + } + }, + "content": "

Fonctionnant sur le même principe que Pocket, Instapaper ou Readability, le logiciel Wallabag permet de mémoriser des articles pour les lire plus tard. Sa nouvelle version apporte une multitude de nouvelles fonctionnalités.

Si vous utilisez Firefox comme navigateur web, vous avez peut-être constaté l’arrivée d’une fonctionnalité intitulée Pocket. Disponible autrefois sous la forme d’un module complémentaire, et sous un autre nom (Read it Later), elle est depuis le mois de juin 2015 directement incluse au sein de Firefox.

\n

Concrètement, Pocket sert à garder en mémoire des contenus que vous croisez au fil de la navigation, comme des articles de presse ou des vidéos, afin de pouvoir les consulter plus tard. Pocket fonctionne un peu comme un système de favoris, mais en bien plus élaboré grâce à ses options supplémentaires.

\n

Mais Pocket fait polémique, car il s’agit d’un projet propriétaire qui est intégré dans un logiciel libre. C’est pour cette raison que des utilisateurs ont choisi de se tourner vers d’autres solutions, comme Wallabag, qui est l’équivalent libre de Pocket et d’autres systèmes du même genre, comme Instapaper et Readability.

\n

Et justement, Wallabag évolue. C’est ce dimanche que la version 2.0.0 du logiciel a été publiée par l’équipe en  charge de son développement et celle-ci contient de nombreux changements par rapport aux moutures précédentes (la documentation est traduite en français), lui permettant d’apparaître comme une alternative à Pocket, Instapaper et Readability.

\n

\"homepage\"

\n

Parmi les principaux changements que l’on peut retenir avec cette nouvelle version, notons la possibilité d’écrire des annotations dans les articles mémorisés, de filtrer les contenus selon divers critères (temps de lecture, nom de domaine, date de création, statut…), d’assigner des mots-clés aux entrées, de modifier le titre des articles, le support des flux RSS ou encore le support de plusieurs langues dont le français.

\n

D’autres options sont également à signaler, comme l’aperçu d’un article mémorisé (si l’option est disponible), un guide de démarrage rapide pour les débutants, un outil d’export dans divers formats (PDF, JSON, EPUB, MOBI, XML, CSV et TXT) et, surtout, la possibilité de migrer vers Wallabag depuis Pocket, afin de convaincre les usagers de se lancer.

\n \n \n

Articles liés

\n
\n
\n", + "created_at": "2016-04-05T09:07:54+0000", + "domain_name": "www.numerama.com", + "id": 1, + "is_archived": 0, + "is_starred": 0, + "language": "fr-FR", + "mimetype": "text/html", + "preview_picture": "http://www.numerama.com/content/uploads/2016/04/post-it.jpg", + "reading_time": 2, + "tags": [], + "title": "Le Pocket libre Wallabag fait le plein de fonctionnalités - Tech - Numerama", + "updated_at": "2016-04-05T09:07:54+0000", + "url": "http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html", + "user_email": "", + "user_id": 1, + "user_name": "wallabag" + } + +Wenn du jetzt das vorherige Kommando (siehe **Existierende Einträge erhalten**), wirst du Daten erhalten. + +cURL Beispiel: + +:: + + curl "https://localhost:8000/api/entries.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA&url=http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html" + +Eintrag löschen +----------------- + +Dokumentation für diese Methode: http://localhost:8000/api/doc#delete--api-entries-{entry}.{_format} + +:: + + http DELETE http://localhost:8000/api/entries/1.json \ + "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" + +gibt zurück: + +:: + + HTTP/1.1 200 OK + 0: application/json + Cache-Control: no-cache + Connection: close + Content-Type: application/json + Date: Tue, 05 Apr 2016 09:19:07 GMT + Host: localhost:8000 + Set-Cookie: PHPSESSID=jopgnfvmuc9a62b27sqm6iulr6; path=/; HttpOnly + X-Debug-Token: 887cef + X-Debug-Token-Link: /_profiler/887cef + X-Powered-By: PHP/7.0.4 + + { + "_links": { + "self": { + "href": "/api/entries/" + } + }, + "annotations": [], + "content": "

Fonctionnant sur le même principe que Pocket, Instapaper ou Readability, le logiciel Wallabag permet de mémoriser des articles pour les lire plus tard. Sa nouvelle version apporte une multitude de nouvelles fonctionnalités.

Si vous utilisez Firefox comme navigateur web, vous avez peut-être constaté l’arrivée d’une fonctionnalité intitulée Pocket. Disponible autrefois sous la forme d’un module complémentaire, et sous un autre nom (Read it Later), elle est depuis le mois de juin 2015 directement incluse au sein de Firefox.

\n

Concrètement, Pocket sert à garder en mémoire des contenus que vous croisez au fil de la navigation, comme des articles de presse ou des vidéos, afin de pouvoir les consulter plus tard. Pocket fonctionne un peu comme un système de favoris, mais en bien plus élaboré grâce à ses options supplémentaires.

\n

Mais Pocket fait polémique, car il s’agit d’un projet propriétaire qui est intégré dans un logiciel libre. C’est pour cette raison que des utilisateurs ont choisi de se tourner vers d’autres solutions, comme Wallabag, qui est l’équivalent libre de Pocket et d’autres systèmes du même genre, comme Instapaper et Readability.

\n

Et justement, Wallabag évolue. C’est ce dimanche que la version 2.0.0 du logiciel a été publiée par l’équipe en  charge de son développement et celle-ci contient de nombreux changements par rapport aux moutures précédentes (la documentation est traduite en français), lui permettant d’apparaître comme une alternative à Pocket, Instapaper et Readability.

\n

\"homepage\"

\n

Parmi les principaux changements que l’on peut retenir avec cette nouvelle version, notons la possibilité d’écrire des annotations dans les articles mémorisés, de filtrer les contenus selon divers critères (temps de lecture, nom de domaine, date de création, statut…), d’assigner des mots-clés aux entrées, de modifier le titre des articles, le support des flux RSS ou encore le support de plusieurs langues dont le français.

\n

D’autres options sont également à signaler, comme l’aperçu d’un article mémorisé (si l’option est disponible), un guide de démarrage rapide pour les débutants, un outil d’export dans divers formats (PDF, JSON, EPUB, MOBI, XML, CSV et TXT) et, surtout, la possibilité de migrer vers Wallabag depuis Pocket, afin de convaincre les usagers de se lancer.

\n \n \n

Articles liés

\n
\n
\n", + "created_at": "2016-04-05T09:07:54+0000", + "domain_name": "www.numerama.com", + "is_archived": 0, + "is_starred": 0, + "language": "fr-FR", + "mimetype": "text/html", + "preview_picture": "http://www.numerama.com/content/uploads/2016/04/post-it.jpg", + "reading_time": 2, + "tags": [], + "title": "Le Pocket libre Wallabag fait le plein de fonctionnalités - Tech - Numerama", + "updated_at": "2016-04-05T09:07:54+0000", + "url": "http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html", + "user_email": "", + "user_id": 1, + "user_name": "wallabag" + } + +Und wenn du die existierenden Einträge nun listen willst (siehe **Existierende Einträge erhalten**), ist das Array wieder leer. + +cURL Beispiel: + +:: + + curl --request DELETE "https://localhost:8000/api/entries/1.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" + +Andere Methoden +--------------- + +Wir werden nicht für jede API Methode Beispiele schreiben. + +Wirf einen Blick in die Liste http://localhost:8000/api/doc, um alle Methode kennenzulernen. + + +Drittanbieter Ressourcen +------------------------ + +Einige Applikationen oder Bibliotheken nutzen unsere API. Hier ist eine nicht abschließende Aufzählung von ihnen: + +- `Java wrapper for the wallabag API `_ von Strubbl. +- `.NET library for the wallabag v2 API `_ von Julian Oster. +- `Python API for wallabag `_ von FoxMaSk, für sein Projekt `Trigger Happy `_. +- `A plugin `_ entworfen für `Tiny Tiny RSS `_, das die wallabag v2 API nutzt. Von Josh Panter. diff --git a/docs/de/developer/docker.rst b/docs/de/developer/docker.rst new file mode 100644 index 00000000..c63194aa --- /dev/null +++ b/docs/de/developer/docker.rst @@ -0,0 +1,57 @@ +Lasse wallabag in docker-compose laufen +======================================= + +Um deine eigene Entwicklungsinstanz von wallabag laufen zu lassen, +möchtest du vielleicht die vorkonfigurierten docker compose Dateien +nutzen. + +Voraussetzungen +--------------- + +Stelle sicher `Docker +`__ und `Docker +Compose `__ auf deinem +System verfügbar und aktuell zu haben. + +Wechsel des DBMS +---------------- + +Standardmäßig startet wallabag mit einer SQLite Datenbank. +Da wallabag Unterstützung für Postgresql und MySQL bietet, gibt es +auch docker Container für diese. + +In der ``docker-compose.yml`` kommentierst du für das gewählte DBMS +aus: + +- die Container Definition (``postgres`` oder ``mariadb`` root + Level Block) +- den Container Link in dem ``php`` Container +- die Container Umgebungsdatei in dem ``php`` Container + +Um mit Symfony Kommandos auf deinem Host auszuführen (wie z.B. +``wallabag:install``), sollst du außerdem: + +- die richtige Umgebungsdatei auf deiner Kommandozeile einlesen, + sodass Variablen wie ``SYMFONY__ENV__DATABASE_HOST`` existieren +- eine Zeile ``127.0.0.1 rdbms`` in deiner ``hosts`` Datei auf dem + System erstellen + +wallabag laufen lassen +---------------------- + +#. Forke und klone das Projekt +#. Bearbeite ``app/config/parameters.yml`` um ``database_*`` + Eigenschaften mit den kommentierten zu ersetzen (mit Werten + mit ``env.`` Präfix) +#. ``composer install`` die Projektabhängigkeiten +#. ``php app/console wallabag:install``, um das Schema zu erstellen +#. ``docker-compose up`` um die Container laufen zu lassen +#. Schließlich öffne http://localhost:8080/, um dein frisch + installiertes wallabag zu finden. + +In den verschiedenen Schritten wirst du vielleicht in verschiendene +Probleme laufen wie UNIX Berechtigungsprobleme, falschen Pfaden im +generierten Cache, etc.… +Operationen wie das Löschen der Cachedateien oder das Ändern der +Dateibesitzer können öfter gebraucht werden, darum habe keine Angst +sie anzupassen. diff --git a/docs/de/developer/documentation.rst b/docs/de/developer/documentation.rst new file mode 100644 index 00000000..41e19363 --- /dev/null +++ b/docs/de/developer/documentation.rst @@ -0,0 +1,10 @@ +Wirke an dieser Dokumentation mit +================================= + +Quellen der Dokumentation sind hier zu finden https://github.com/wallabag/wallabag/tree/master/docs + +Wir nutzen `ReadTheDocs `__, um sie zu generieren. + +Seiten werden in `reStructuredText `__ geschrieben. Du kannst Onlinetools wie http://rst.aaroniles.net/ oder http://rst.ninjs.org/ nutzen, um eine Vorschau deiner Artikel zu betrachten. + +Wenn du eine neue Seite erstellst, vergiss nicht die `index.rst `__ zu bearbeiten, um dort einen Link für die Seitenleiste hinzuzufügen. diff --git a/docs/de/developer/maintenance.rst b/docs/de/developer/maintenance.rst new file mode 100644 index 00000000..2a9070e1 --- /dev/null +++ b/docs/de/developer/maintenance.rst @@ -0,0 +1,32 @@ +Wartungsmodus +============= + +Wenn du längere Aufgaben auf deiner wallabag Instanz ausführen willst, kannst du den Wartungsmodus aktivieren. +Keiner wird dann Zugang zu deiner Instanz haben. + +Aktivieren des Wartungsmodus +---------------------------- + +Um den Wartungsmodus zu aktivieren, führe folgendes Kommando aus: + +:: + + bin/console lexik:maintenance:lock --no-interaction + +Du kannst deine IP Adresse in ``app/config/config.yml`` setzen, wenn du Zugriff zu wallabag haben willst, auch wenn der Wartungsmodus aktiv ist. Zum Beispiel: + +:: + + lexik_maintenance: + authorized: + ips: ['127.0.0.1'] + + +Deaktivieren des Wartungsmodus +------------------------ + +Um den Wartungsmodus zu deaktivieren, führe dieses Kommando aus: + +:: + + bin/console lexik:maintenance:unlock diff --git a/docs/de/developer/translate.rst b/docs/de/developer/translate.rst new file mode 100644 index 00000000..50e136ea --- /dev/null +++ b/docs/de/developer/translate.rst @@ -0,0 +1,57 @@ +Übersetze wallabag +================== + +wallabag Webapplikation +----------------------- + +Übersetzungsdateien +~~~~~~~~~~~~~~~~~~~ + +.. note:: + + Da wallabag hauptsächlich von einem französischem Team entwickelt wird, betrachte + die französische Übersetzung als die aktuellste und kopiere sie, um deine eigene Übersetzung zu starten. + +Du kannst die Übersetzungsdateien hier finden: https://github.com/wallabag/wallabag/tree/master/src/Wallabag/CoreBundle/Resources/translations. + +Du musst die ``messages.CODE.yml`` und ``validators.CODE.yml`` erstellen, wobei CODE +der ISO 639-1 Code deiner Sprache ist (`siehe Wikipedia `__). + +Andere Dateien zum Übersetzen: + +- https://github.com/wallabag/wallabag/tree/master/app/Resources/CraueConfigBundle/translations. +- https://github.com/wallabag/wallabag/tree/master/app/Resources/FOSUserBundle/translations. + +Du musst die ``THE_TRANSLATION_FILE.CODE.yml`` Dateien erstellen. + +Konfigurationsdatei +~~~~~~~~~~~~~~~~~~~ + +Du musst die `app/config/config.yml `__ bearbeiten, +um deine Sprache auf der Konfigurationsseite in wallabag anzuzeigen (um Nutzern zu erlauben zu dieser neuen Übersetzung zu wechseln). + +Unter dem Abschnitt ``wallabag_core.languages`` musst du eine neue Zeile mit deiner Übersetzung hinzufügen. Zum Beispiel: + +:: + + wallabag_core: + ... + languages: + en: 'English' + fr: 'Français' + + +Für die erste Spalte (``en``, ``fr``, etc.) musst du den ISO 639-1 Code deiner Sprache hinzufügen (siehe oben). + +Für die zweite Spalte trägst du den Namen deiner Sprache ein. Nur den. + +wallabag Dokumentation +---------------------- + +.. note:: + + Im Gegensatz zur Webapplikation ist die Hauptsprache für die Dokumentation Englisch. + +Documentationsdateien sind hier gespeichert: https://github.com/wallabag/wallabag/tree/master/docs + +Du musst die Ordnerstruktur des Ordners ``en`` beachten, wenn du deine eigene Übersetzung startest. diff --git a/docs/de/index.rst b/docs/de/index.rst new file mode 100644 index 00000000..5311150f --- /dev/null +++ b/docs/de/index.rst @@ -0,0 +1,52 @@ +wallabag Dokumentation +====================== + +.. image:: ../img/wallabag.png + :alt: wallabag Logo + :align: center + +**wallabag** ist eine Read-it-later Applikation: es speichert Websites, +indem es nur den Inhalt behält. Elemente wie Navigation oder Werbung werden gelöscht. + +.. tip:: + + Diese Dokumentation ist über wallabag v2. Wenn du die Dokumentation für wallabag v1 lesen willst, `siehe dir bitte das hier an `__. + +Die Hauptdokumentation für diese Applikation ist in einigen Abschnitten organisiert: + +* :ref:`user-docs` +* :ref:`dev-docs` + +.. _user-docs: + +.. toctree:: + :maxdepth: 2 + :caption: Nutzerdokumentation + + user/faq + user/installation + user/upgrade + user/migration + user/import + user/create_account + user/login + user/configuration + user/first_article + user/errors_during_fetching + user/annotations + user/download_articles + user/filters + user/tags + user/android + +.. _dev-docs: + +.. toctree:: + :maxdepth: 2 + :caption: Entwicklerdokumentation + + developer/api + developer/docker + developer/documentation + developer/translate + developer/maintenance diff --git a/docs/de/user/android.rst b/docs/de/user/android.rst new file mode 100644 index 00000000..8573bcb8 --- /dev/null +++ b/docs/de/user/android.rst @@ -0,0 +1,107 @@ +Android App +=========== + + +Zweck dieses Dokuments +---------------------- + +Dieses Dokument beschreibt wie du deine Android App einrichtest, damit sie mit deiner Wallabaginstanz zusammenarbeitet. Es gibt hierbei keinen Unterschied im Vorgang - egal ob du Wallabag v1 oder v2 einsetzt. + + +Schritte, um dein App zu einzurichten +------------------------------------- + +Wenn du das erste Mal die App startest, siehst du den Willkommensbildschirm, wo du angewiesen wirst zunächst deine App mit deiner Wallabaginstanz einzurichten. + +.. image:: ../../img/user/android_welcome_screen.de.png + :alt: Willkommensbildschirm + :align: center + +Bestätige nur diese Nachricht und du wirst zum Einstellungsbildschirm weitergeleitet. + +.. image:: ../../img/user/android_configuration_screen.de.png + :alt: Einstellungsbildschirm + :align: center + +Trage deine Wallabagdaten ein. Du musst deine Wallabagadresse eintragen. Es ist wichtig, dass die URL nicht mit einem Schrägstrich endet. Füge auch deine Wallabagzugangsdaten in das Nutzer- und Passwortfeld ein. + +.. image:: ../../img/user/android_configuration_filled_in.de.png + :alt: Eingetragene Einstellungen + :align: center + +Nachdem du deine Daten eingetragen hast, drücke den Button Verbindung testen und warte auf das Fertigstellen des Tests. + +.. image:: ../../img/user/android_configuration_connection_test.de.png + :alt: Verbindungstest mit deinen Wallabagdaten + :align: center + +Der Verbindungstest sollte mit Erfolg ausgehen. Falls nicht, musst du zunächst deine Daten korrigieren bevor du zum nächsten Schritt gehst. + +.. image:: ../../img/user/android_configuration_connection_test_success.de.png + :alt: Verbindungstest war erfolgreich + :align: center + +Nach dem Verbindungstest erfolgreich war, kannst du den Button zum Feedzugangsdaten abholen drücken. Die App versucht nun sich bei deiner Wallabaginstanz einzuloggen und die Nutzer ID und den dazugehörigen Token für die Feeds zu laden. + +.. image:: ../../img/user/android_configuration_get_feed_credentials.de.png + :alt: Feedzugangsdaten abholen + :align: center + +Wenn der Prozess des Abholens deiner Feedzugangsdaten erfolgreich beendet wurde, siehst du eine Toastnachricht, dass die User ID und der Token automatisch in das Formular eingetragen wurden. + +.. image:: ../../img/user/android_configuration_feed_credentials_automatically_filled_in.de.png + :alt: Feedzugangsdaten erfolgreich abgeholt + :align: center + +Jetzt scrollst du bis zum unteren Rand des Einstellungsbildschirms. Natürlich kannst du die Einstellungen dort deinen Wünschen anpassen. Schließe die Einrichtung mit dem Drücken des Speicherbuttons ab. + +.. image:: ../../img/user/android_configuration_scroll_bottom.de.png + :alt: unterer Rand des Einstellungsbildschirms + :align: center + +Nachdem du den Speicherbutton gedrückt hast, kommst du in den folgenden Bildschirm. Die App schlägt vor, eine initiale Synchronisation der Artikelfeeds durchzuführen. Hier ist es empfohlen, dies zu bestätigen und Ja zu drücken. + +.. image:: ../../img/user/android_configuration_saved_feed_update.de.png + :alt: Einstellung erstmals gespeichert + :align: center + +Schließlich nach der ersten erfolgreichen Synchronisation, wird dir die Liste der ungelesenen Artikel präsentiert. + +.. image:: ../../img/user/android_unread_feed_synced.de.png + :alt: Gefüllte Artikellist da Feeds erfolgreich synchronisiert sind + :align: center + + + +Bekannte Limitierungen +--------------------- + +2FA +~~~ + +Zur Zeit unterstützt die App keine Zwei-Faktor Authentifizierung. Du solltest sie deaktivieren damit die App funktioniert. + + +Begrenzte Anzahl Artikel mit Wallabag v2 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In deiner Wallabaginstanz kannst du einstellen, wie viele Artikel Teil deiner RSS Feeds sind. Diese Option existierte in Wallabag v1 nicht, wo immer alle Artikel Teil des Feeds waren. Also wenn du die Anzahl der Artikel, die in der App angezeigt werden sollen, größer einstellst als die Anzahl Artikel in deinem Feed, wirst du nur die Anzahl an Artikel deines Feeds sehen. + + +SSL/TLS Verschlüsselung +~~~~~~~~~~~~~~~~~~~~~~~ + +Wenn du deine Wallabaginstanz per HTTPS erreichen kannst, solltest du das so konfigurieren. Besonders dann, wenn deine HTTP URL nach HTTPS umleitet. Im Moment kann die App mit dieser Weiterleitung nicht korrekt umgehen. + + +Referenzen +---------- + +`Quellcode der Android Applikation `_ + +`Android Applikation auf F-Droid `_ + +`Android Applikation auf Google Play `_ + +`Support Chat auf English `_ + diff --git a/docs/de/user/annotations.rst b/docs/de/user/annotations.rst new file mode 100644 index 00000000..4b4d58b0 --- /dev/null +++ b/docs/de/user/annotations.rst @@ -0,0 +1,24 @@ +Anmerkungen +=========== + +In jedem Artikel, den du liest, kannst du Anmerkungen hinzufügen. Es ist einfacher mit ein paar Bilder erklärt. + +Wähle den Teil des Artikels aus, den du kommentieren willst und klicke auf den Bleistift: + +.. image:: ../../img/user/annotations_1.png + :alt: Wähle den Text + :align: center + +Schreibe deinen Kommentar: + +.. image:: ../../img/user/annotations_2.png + :alt: Schreibe deinen Kommentar + :align: center + +Der Text ist nun hervorgehoben und du kannst deine Anmerkung lesen, wenn du den Mauspfeil darüber fährst. + +.. image:: ../../img/user/annotations_3.png + :alt: lese deine Anmerkung + :align: center + +Du kannst so viele Anmerkungen erstellen wie du möchtest. diff --git a/docs/de/user/configuration.rst b/docs/de/user/configuration.rst new file mode 100644 index 00000000..67695ff1 --- /dev/null +++ b/docs/de/user/configuration.rst @@ -0,0 +1,119 @@ +Konfiguration +============= + +Nun, da du eingeloggt bist, ist es Zeit, deinen Account so zu konfigurieren, +wie du möchtest. + +Klicke auf ``Konfiguration`` im Menü. Du hast fünf Karteireiter: ``Einstellungen``, +``RSS``, ``Benutzer-Informationen``, ``Kennwort`` und ``Tagging-Regeln``. + +Einstellungen +------------- + +Theme +~~~~~ + +wallabag ist anpassbar. Du kannst dein bevorzugtes Theme hier auswählen. Du kannst +auch ein neues erstellen, ein extra Kapitel wird dem gewidmet sein. Das Standardtheme +ist ``Material``, es ist das Theme, dass in den Dokumentationsbildschirmfotos genutzt wird. + +Artikel pro Seite +~~~~~~~~~~~~~~~~~ + +Du kannst die Anzahl der dargestellten Artikel pro Seite ändern. + +Lesegeschwindigkeit +~~~~~~~~~~~~~~~~~~~ + +wallabag berechnet die Lesezeit für jeden Artikel. Du kannst hier definieren, dank dieser Liste, ob du +ein schneller oder langsamer Leser bist. wallabag wird die Lesezeit für jeden Artikel neu berechnen. + +Sprache +~~~~~~~ + +Du kannst die Sprache von der wallabag Benutzeroberfläche ändern. Du musst die ausloggen, damit diese +Änderung Wirkung zeigt. + +RSS +--- + +wallabag stellt RSS Feeds für jeden Artikelstatus bereit: ungelesen, Favoriten und Archiv. + +Als erstes musst du einen persönlciehn Token erstellen: Klicke auf ``Token generieren``. +Es ist möglich deinen Token zu ändern, indem du auf ``Token zurücksetzen`` klickst. + +Jetzt hast du drei Links, einen für jeden Status: Füge sie in deinem liebsten Feedreader hinzu. + +Du kannst auch definieren wie viele Artikel du in deinem RSS Feed (Standardwert: 50) haben willst. + +Benutzer-Informationen +---------------------- + +Du kannst deinen Namen ändern, deine E-Mail-Adresse und die Zwei-Faktor-Authentifizierung aktivieren. + +Zwei-Faktor-Authentifizierung +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + Die Zwei-Faktor-Authentifizierung (2FA) dient dem Identitätsnachweis eines Nutzers mittels der + Kombination zweier verschiedener und insbesondere unabhängiger Komponenten (Faktoren). + +https://de.wikipedia.org/wiki/Zwei-Faktor-Authentifizierung + +Wenn du 2FA aktivierst, erhälst du jedes Mal, wenn du dich bei wallabag einloggen willst, einen Code per +Mail. Du musst den Code in das folgende Formular eingeben. + +.. image:: ../../img/user/2FA_form.png + :alt: Zwei-Faktor-Authentifizierung + :align: center + +Wenn du nicht jedes Mal, wenn du dich einloggen willst, einen Code zugesendet bekommen möchtest, kannst du +die Checkbox ``Ich bin an einem persönlichen Computer`` anhaken: wallabag wird sich an dich für 15 Tage +erinnern. + +Passwort +-------- + +Du kannst dein Passwort hier ändern (8 Zeichen Minimum). + +Tagging-Regeln +-------------- + +Wenn du automatisch einen Tag zu einem neuen Artikel zuweisen lassen möchtest, ist dieser Teil der +Konfiguration, was du suchst. + +Was ist mit Tagging-Regeln gemeint? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Dies sind Regeln, die von wallabag genutzt werden, um neue Artikel automatisch zu taggen +Jedes Mal, wenn ein neuer Artikel hinzugefügt wird, werden alle Tagging-Regeln genutzt, um deine +konfigurierten Tags hinzuzufügen, folglich um dir den Aufwand zu sparen, die Artikel manuell einzuteilen. + +Wie benutze ich sie? +~~~~~~~~~~~~~~~~~~~~ + +Nehmen wir an, du möchtest neuen Artikeln einen Tag *schnell gelesen*, wenn du die Lesezeit kleiner als +3 Minuten ist. +In diesem Fall solltest du in das Regelfeld "readingTime <= 3" eintragen und *schnell gelesen* in das Tags-Feld. +Mehrere Tags können gleichzeitig hinzugefügt werden, wenn man sie mit einem Komma trennt: +*schnell gelesen, Pflichtlektüre*. +Komplexe Regeln können mit vordefinierten Operatoren geschrieben werden: +Wenn *readingTime >= 5 AND domainName = "github.com"*, dann tagge als *lange zu lesen, github*. + +Welche Variablen und Operatoren kann ich zum Regeln schreiben nutzen? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Die folgenden Variabel und Operatoren können genutzt werden, um Tagging-Regeln zu erstellen: + +=========== ============================================== ======== ========== +Variable Bedeutung Operator Bedeutung +----------- ---------------------------------------------- -------- ---------- +title Titel des Artikels <= Kleiner gleich als… +url URL des Artikels < Kleiner als… +isArchived Ob der Artikel archiviert ist oder nicht => Größer gleich als… +isStarred Ob der Artikel favorisiert ist oder nicht > Größer als… +content Inhalt des Eintrags = Gleich zu… +language Sprache des Eintrags != Nicht gleich zu… +mimetype MIME-Typ des Eintrags OR Eine Regel oder die andere +readingTime Die geschätzte Lesezeit in Minuten AND Eine Regel und die andere +domainName Der Domain-Name des Eintrags matches Testet, dass ein Feld einer Suche (unabhängig von Groß- und Kleinschreibung) übereinstimmt. Z.B.: title matches "Fußball" +=========== ============================================== ======== ========== diff --git a/docs/de/user/create_account.rst b/docs/de/user/create_account.rst new file mode 100644 index 00000000..ce1b02a4 --- /dev/null +++ b/docs/de/user/create_account.rst @@ -0,0 +1,25 @@ +Account erstellen +================= + +Klicke auf der Loginseite auf den ``Registrieren`` Button- + +.. image:: ../../img/user/registration_form.png + :alt: Registrierungsformular + :align: center + +Du musst das Formular ausfüllen. Bitte stelle sicher, dass du eine gültige +E-Mail-Adresse eingibst, wir werden dir eine Aktivierungsmail schicken. + +.. image:: ../../img/user/sent_email.png + :alt: E-Mail wurde gesendet, um Account zu aktivieren + :align: center + +Überprüfge deinen Posteingang, du hast jetzt eine neue Mail mit einem Link wie diesen +``http://wallabag/register/confirm/Ba19wokGovN-DdBQNfg4YgRkUQWRP4-k2g0Bk-hBTX4``. +Klicke auf den Link, um deinen Account zu aktivieren. + +Dein Account ist nun aktiviert. + +.. image:: ../../img/user/activated_account.png + :alt: Willkommen! + :align: center diff --git a/docs/de/user/download_articles.rst b/docs/de/user/download_articles.rst new file mode 100644 index 00000000..6f5384b2 --- /dev/null +++ b/docs/de/user/download_articles.rst @@ -0,0 +1,17 @@ +Artikel herunterladen +===================== + +Du kannst jeden Artikel in verschiedenen Formaten herunterladen: ePUB, MOBI, PDF, XML, JSON, CSV. + +In der Artikelansicht, klickst du auf dieses Icon in der Seitenleiste: + +.. image:: ../../img/user/download_article.png + :alt: Artikel herunterladen + :align: center + +Du kannst auch eine ganze Kategorie (ungelesen, Favoriten, Archiv) in diesen Formaten herunterladen. +Zum Beispiel, in der Ansicht **Ungelesen**, klickst du auf das Icon in der oberen Leiste: + +.. image:: ../../img/user/download_articles.png + :alt: Artikel herunterladen + :align: center diff --git a/docs/de/user/errors_during_fetching.rst b/docs/de/user/errors_during_fetching.rst new file mode 100644 index 00000000..b8e3e999 --- /dev/null +++ b/docs/de/user/errors_during_fetching.rst @@ -0,0 +1,28 @@ +Fehler während des Artikelladens +================================ + +Warum schlägt das Laden eines Artikels fehl? +-------------------------------------------- + +Das kann verschiedene Ursachen haben: + +- Netzwerkprobleme +- wallabag kann den Inhalt aufgrund der Websitestruktur nicht laden + +Wie kann ich helfen das zu beheben? +----------------------------------- + +- `indem du uns eine Mail mit der URL des Artikels sendest `_ +- indem du versuchst das Laden des Artikels durch Erstellen einer Datei für den Artikel + selbst zu beheben + Du kannst `dieses Tool `__ nutzen. + +Wie kann ich versuchen, einen Artikel erneut zu laden? +------------------------------------------------------ + +Wenn wallabag beim Laden eines Artikels fehlschlägt, kannst du auf den erneut laden Button +klicken (der dritte in dem unteren Bild). + +.. image:: ../../img/user/refetch.png + :alt: Inhalt neu laden + :align: center diff --git a/docs/de/user/faq.rst b/docs/de/user/faq.rst new file mode 100644 index 00000000..1a199c1c --- /dev/null +++ b/docs/de/user/faq.rst @@ -0,0 +1,45 @@ +Häufig gestellte Fragen +========================== + +Während der Installation sehe ich den Fehler ``Error Output: sh: 1: @post-cmd: not found`` +------------------------------------------------------------------------------------------ + +Es scheint, dass du ein Problem bei deiner ``composer`` Installation hast. Versuche es zu deinstallieren und neu zu installieren. + +`Lies die Dokumentation über composer, um zu erfahren wie es installiert wird +`__. + +Ich kann das Registrierungsformular nicht validieren +---------------------------------------------------- + +Stelle sicher, dass alle Felder ausgefüllt sind: + +* valide E-Mail-Adresse +* das gleiche Passwort in zwei Feldern + +Ich erhalte meine Aktivierungsmail nicht +---------------------------------------- + +Bist du sicher, dass deine eingegebene E-Mail-Adresse korrekt war? Hast du deinen Spamordner überprüft? + +Wenn du dann immer noch nicht deine Aktivierungsmail siehst, stelle bitte sicher, dass du einen MTA +korrekt installiert und eingerichtet hast. Prüfe, dass deine Firewallregel existiert, z.B. für firewalld: + +:: + firewall-cmd --permanent --add-service=smtp + firewall-cmd --reload + +Schließlich, falls du SELinux aktiviert hast, setze folgende Regel: + +``setsebool -P httpd_can_sendmail 1`` + +Wenn ich den Aktivierungslink klicke, bekomme ich die Nachricht ``Der Nutzer mit dem Bestätigungstoken "DtrOPfbQeVkWf6N" existiert nicht`` +------------------------------------------------------------------------------------------------------------------------------------------ + +Du hast deinen Account schon aktiviert oder die URL der Aktivierungsmail ist falsch. + +Ich habe mein Passwort vergessen +-------------------------------- + +Du kannst dein Passwort zurücksetzen, indem du auf den Link ``Kennwort vergessen?`` auf der Loginseite klickst. Fülle dann das Formular mit deiner E-Mail-Adresse oder deinem Nutzernamen aus +und du wirst eine E-Mail zum Passwort zurücksetzen erhalten. diff --git a/docs/de/user/filters.rst b/docs/de/user/filters.rst new file mode 100644 index 00000000..c9cda6b6 --- /dev/null +++ b/docs/de/user/filters.rst @@ -0,0 +1,49 @@ +Filter +====== + +Um Artikel leichter zu erreichen, kannst du sie filtern. +Klicke auf das dritte Symbol in der oberen Leiste. + +.. image:: ../../img/user/topbar.png + :alt: Obere Leiste + :align: center + +Alle diese Filter können kombiniert werden. + +.. image:: ../../img/user/filters.png + :alt: Kombiniere alle Filter + :align: center + +Status +------ + +Nutze die Checkboxen, um einen archivierten oder favorisierten Artikel zu finden. + +Vorschaubild +--------------- + +Hake diesen Filter an, wenn du Artikel mit einem Vorschaubild erhalten willst. + +Sprache +------- + +wallabag (via graby) kann die Artikelsprache erkennen. Es ist einfach für dich, Artikel +in einer bestimmten Sprache zu filtern. + +Lesezeit +-------- + +wallabag schätzt wieviel Zeit du brauchst, um einen Artikel zu lesen. Mit diesem Filter +kannst du zum Beispiel Artikel mit einer Lesezeit zwischen 2 und 5 Minuten finden. + +Domainname +---------- + +Dank dieses Filters, kannst ud Artikel von der gleichen Domain finden. +Zum Beispiel tippst du in diesem Feld ``bbc.co.uk``, um Artikel dieser Website zu finden. + +Erstellungsdatum +---------------- + +Wenn du Artikel speicherst, merkt sich wallabag das aktuelle Datum. So praktisch, um Aritkel, die +zwischen dem 1. und 31. Januar geschrieben sind, zu finden. diff --git a/docs/de/user/first_article.rst b/docs/de/user/first_article.rst new file mode 100644 index 00000000..b8ceda07 --- /dev/null +++ b/docs/de/user/first_article.rst @@ -0,0 +1,68 @@ +Speichere deinen ersten Artikel +=============================== + +Der Hauptzweck von wallabag ist es Webartikel zu speichern. Du hast viele Wege das zu tun. + +.. note:: + + Eine Schnellstartanleitung wird in der Anwendung angezeigt bis du deinen ersten + Artikel gespeichert hast. + +Durch Nutzung eines Bookmarklets +-------------------------------- + +Auf der ``How-To`` Seite, hast du einen Reiter ``Bookmarklet``. Ziehe und lasse den +``bag it!`` Link in die Lesezeichenleiste deines Browser los. + +Jetzt kannst du immer wenn du einen Artikel im Web liest und ihn du ihn speichern +willst, klicke auf den ``bag it!`` Link in deiner Lesezeichenleiste. Der Artikel +wird gespeichert. + +Durch Nutzung des klassischen Formulars +--------------------------------------- + +In der oberen Leiste auf deinem Bildschirm, hast du drei Icons. Mit dem ersten, einem +Pluszeichen, kannst du einfach neue Artikel speichern. + +.. image:: ../../img/user/topbar.png + :alt: obere Leiste + :align: center + +Klick darauf, um ein neues Feld anzeigen zu lassen, füge deine Artikel URL ein und +drücke die ``Enter`` Taste. Der Artikel wird gespeichert. + +Durch Nutzung eines Browser Add-ons +----------------------------------- + +Firefox +~~~~~~~ + +*Dieses Addon ist noch nicht für wallbag v2 verfügbar*. + +Chrome +~~~~~~ + +*Dieses Addon ist noch nicht für wallbag v2 verfügbar*. + +Durch Nutzung deiner Smartphone App +----------------------------------- + +Android +~~~~~~~ + +*Diese Applikation ist noch nicht für wallbag v2 verfügbar*. + +Firefox OS +~~~~~~~~~~ + +*Diese Applikation ist noch nicht für wallbag v2 verfügbar*. + +Windows Phone +~~~~~~~~~~~~~ + +*Diese Applikation ist noch nicht für wallbag v2 verfügbar*. + +iOS +~~~ + +*Diese Applikation ist noch nicht für wallbag v2 verfügbar*. diff --git a/docs/de/user/import.rst b/docs/de/user/import.rst new file mode 100644 index 00000000..ecd3134b --- /dev/null +++ b/docs/de/user/import.rst @@ -0,0 +1,46 @@ +Migration von einem Drittanbieter +================================= + +Von Pocket +----------- + +Erstelle eine neue Applikation in Pocket +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Um deine Daten von Pocket zu importieren, nutzen wir die Pocket API. Du musst +eine neue Applikation auf ihrer Entwicklerwebsite erstellen, um fortzufahren. + +* Erstelle eine neue Applikation `auf der Entwicklerwebsite `_ +* Fülle die erforderlichen Felder aus: Name, Beschreibung, Berechtigungen (nur **abrufen**), Plattform + (**web**), akzeptiere die Nutzungsbedingungen und reiche deine neue Applikation ein + +Pocket wird dir einen **Consumer Key** geben (z.B. `49961-985e4b92fe21fe4c78d682c1`). +Du musst den ``pocket_consumer_key`` in dem Abschnitt ``Import`` in dem ``Interne Einstellungen`` Menü +konfigurieren. + +Jetzt ist alles in Ordnung, um von Pocket zu migrieren. + +Importiere deine Daten in wallabag 2.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Klicke auf den ``Importieren`` Link im menü, auf ``Inhalte importieren`` in dem Pocketabschnitt und +dann auf ``Verbinde mit Pocket und importieren Daten``. + +Du musst wallabag erlauben, mit deinem Pocketaccount zu interagieren. +Deine Daten werden importiert. Datenimport kann ein sehr anspruchsvoller Prozess für deinen Server +sein (wir müssen daran arbeiten, um diesen Import zu verbessern). + +Von Instapaper +-------------- + +*Funktion noch nicht implementiert in wallabag v2.* + +Von Readability +--------------- + +*Funktion noch nicht implementiert in wallabag v2.* + +Von einer HTML oder JSON Datei +------------------------------ + +*Funktion noch nicht implementiert in wallabag v2.* diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst new file mode 100644 index 00000000..37a80170 --- /dev/null +++ b/docs/de/user/installation.rst @@ -0,0 +1,326 @@ +Installation von wallabag +========================= + +Voraussetzungen +--------------- + +wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7. + +Du benötigst die folgenden Extensions damit wallabag funktioniert. Einige von diesen sind vielleicht schon in deiner Version von PHP aktiviert, somit musst du eventuell +nicht alle folgenden Pakete installieren. + +- php-session +- php-ctype +- php-dom +- php-hash +- php-simplexml +- php-json +- php-gd +- php-mbstring +- php-xml +- php-tidy +- php-iconv +- php-curl +- php-gettext +- php-tokenizer + +wallabag nutzt PDO, um sich mit der Datenbank zu verbinden, darum benötigst du eines der folgenden Komponenten: + +- pdo_mysql +- pdo_sqlite +- pdo_pgsql + +und dessen dazugehörigen Datenbankserver. + +Installation +------------ + +Auf einem dedizierten Webserver (empfohlener Weg) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +wallabag nutzt eine große Anzahl an Bibliotheken, um zu funktionieren. Diese Bibliotheken müssen mit einem Tool namens Composer installiert werden. Du musst es installieren sofern du es bisher noch nicht gemacht hast. + +Composer installieren: + +:: + + curl -s http://getcomposer.org/installer | php + +Du kannst eine spezifische Anleitung `hier `__ finden: + +Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: + +:: + + git clone https://github.com/wallabag/wallabag.git + cd wallabag + git checkout 2.0.5 + SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist + php bin/console wallabag:install --env=prod + +Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen: + +:: + + php bin/console server:run --env=prod + +Und wallabag unter http://deineserverip:8000 erreichen + +.. tip:: + + Um Parameter mit Umgebungsvariable zu definieren, musst du die Variable mit dem ``SYMFONY__`` Präfix setzen. Zum Beispiel ``SYMFONY__DATABASE_DRIVER``. Du kannst einen Blick die `Symfony Dokumentation `__ werfen. + +Auf einem geteilten Webhosting +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Wir stellen ein Paket inkl. aller Abhängigkeiten bereit. +Die Standardkonfiguration nutzt SQLite für die Datenbank. Wenn du diese Einstellung ändern willst, ändere bitte ``app/config/parameters.yml``. + +Wir haben bereits einen Nutzer erstellt: Login und Passwort sind ``wallabag``. + +.. caution:: Mit diesem Paket überprüft wallabag nicht die von der Applikation gebrauchten Exentions (diese Tests werden während ``composer install`` durchgeführt wenn du einen dedizierten Webserver hast, siehe oben). + +Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacken: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +Jetzt lese die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu. +Wenn du die Datenbankkonfiguration eingestellt hast, MySQL oder PostgreSQL zu nutzen, musst du einen Nutzer über das folgende Kommando erstellen ``php bin/console wallabag:install --env=prod``. + +Installation mit Docker +------------------------ + +Wir stellen ein Docker Image zu Verfügung, um wallabag einfach zu installieren. Schaue in unser Repository in unserem `Docker Hub `__, um mehr Informationen zu erhalten. + +Kommando, um den Container zu starten +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: bash + + docker pull wallabag/wallabag + +Virtualhosts +------------ + +Konfiguration von Apache +~~~~~~~~~~~~~~~~~~~~~~~ + +Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren und du willst PHP als Apache Modul nutzen, dann ist hier ein vhost für wallabag: + +:: + + + ServerName domain.tld + ServerAlias www.domain.tld + + DocumentRoot /var/www/wallabag/web + + AllowOverride None + Order Allow,Deny + Allow from All + + + Options -MultiViews + RewriteEngine On + RewriteCond %{REQUEST_FILENAME} !-f + RewriteRule ^(.*)$ app.php [QSA,L] + + + + # uncomment the following lines if you install assets as symlinks + # or run into problems when compiling LESS/Sass/CoffeScript assets + # + # Options FollowSymlinks + # + + # optionally disable the RewriteEngine for the asset directories + # which will allow apache to simply reply with a 404 when files are + # not found instead of passing the request into the full symfony stack + + + RewriteEngine Off + + + ErrorLog /var/log/apache2/wallabag_error.log + CustomLog /var/log/apache2/wallabag_access.log combined + + +Nach dem du Apache neugeladen oder neugestartet hast, solltest du nun wallabag unter http://domain.tld erreichen. + +Konfiguration von Nginx +~~~~~~~~~~~~~~~~~~~~~~~ + +Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren, dann ist hier ein Rezept für wallabag: + +:: + + server { + server_name domain.tld www.domain.tld; + root /var/www/wallabag/web; + + location / { + # try to serve file directly, fallback to app.php + try_files $uri /app.php$is_args$args; + } + location ~ ^/app\.php(/|$) { + fastcgi_pass unix:/var/run/php5-fpm.sock; + fastcgi_split_path_info ^(.+\.php)(/.*)$; + include fastcgi_params; + # When you are using symlinks to link the document root to the + # current version of your application, you should pass the real + # application path instead of the path to the symlink to PHP + # FPM. + # Otherwise, PHP's OPcache may not properly detect changes to + # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126 + # for more information). + fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; + fastcgi_param DOCUMENT_ROOT $realpath_root; + # Prevents URIs that include the front controller. This will 404: + # http://domain.tld/app.php/some-path + # Remove the internal directive to allow URIs like this + internal; + } + + error_log /var/log/nginx/wallabag_error.log; + access_log /var/log/nginx/wallabag_access.log; + } + +Nach dem neuladen oder neustarten von nginx, solltest du nun wallabag unter http://domain.tld erreichen. + +.. tip:: + + When you want to import large file into wallabag, you need to add this line in your nginx configuration ``client_max_body_size XM; # allows file uploads up to X megabytes``. + Wenn du eine große Datei in wallabag importieren willst, solltest du diese Zeile zu deiner nginx Konfiguration hinzufügen ``client_max_body_size XM; # allows file uploads up to X megabytes``. + +Konfiguration von lighttpd +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren, dann ist hier ein Rezept für wallabag (bearbeite deine ``lighttpd.conf`` und füge die Konfiguration dort ein): + +:: + + server.modules = ( + "mod_fastcgi", + "mod_access", + "mod_alias", + "mod_compress", + "mod_redirect", + "mod_rewrite", + ) + server.document-root = "/var/www/wallabag/web" + server.upload-dirs = ( "/var/cache/lighttpd/uploads" ) + server.errorlog = "/var/log/lighttpd/error.log" + server.pid-file = "/var/run/lighttpd.pid" + server.username = "www-data" + server.groupname = "www-data" + server.port = 80 + server.follow-symlink = "enable" + index-file.names = ( "index.php", "index.html", "index.lighttpd.html") + url.access-deny = ( "~", ".inc" ) + static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" ) + compress.cache-dir = "/var/cache/lighttpd/compress/" + compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" ) + include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port + include_shell "/usr/share/lighttpd/create-mime.assign.pl" + include_shell "/usr/share/lighttpd/include-conf-enabled.pl" + dir-listing.activate = "disable" + + url.rewrite-if-not-file = ( + "^/([^?]*)(?:\?(.*))?" => "/app.php?$1&$2", + "^/([^?]*)" => "/app.php?=$1", + ) + +Rechte, um das Projektverzeichnis zu betreten +--------------------------------------------- + +Testumgebung +~~~~~~~~~~~~ + +Wenn wir nur wallabag testen wollen, führen wir nur das Kommando ``php bin/console server:run --env=prod`` aus, um unsere wallabag Instanz zu starten und alles wird geschmeidig laufen, weil der Nutzer, der das Projekt gestartet hat, den aktuellen Ordner ohne Probleme betreten kann. + +Produktionsumgebung +~~~~~~~~~~~~~~~~~~~ + +Sobald wir Apache oder Nginx nutzen, um unsere wallabag Instanz zu erreichen, und nicht das Kommando ``php bin/console server:run --env=prod`` nutzen, sollten wir dafür sorgen, die Rechte vernünftig zu vergeben, um die Ordner des Projektes zu schützen. + +Um dies zu machen, muss der Ordner, bekannt als ``DocumentRoot`` (bei Apache) oder ``root`` (bei Nginx), von dem Apache-/Nginx-Nutzer zugänglich sein. Sein Name ist meist ``www-data``, ``apache`` oder ``nobody`` (abhängig vom genutzten Linuxsystem). + +Der Ordner ``/var/www/wallabag/web`` musst dem letztgenannten zugänglich sein. Aber dies könnte nicht genug sein, wenn wir nur auf diesen Ordner achten, weil wir eine leere Seite sehen könnten oder einen Fehler 500, wenn wir die Homepage des Projekt öffnen. + +Dies kommt daher, dass wir die gleichen Rechte dem Ordner ``/var/www/wallabag/var`` geben müssen, so wie wir es für den Ordner ``/var/www/wallabag/web`` gemacht haben. Somit beheben wir das Problem mit dem folgenden Kommando: + +.. code-block:: bash + + chown -R www-data:www-data /var/www/wallabag/var + +Es muss analog für die folgenden Ordner ausgeführt werden + +* /var/www/wallabag/bin/ +* /var/www/wallabag/app/config/ +* /var/www/wallabag/vendor/ +* /var/www/wallabag/data/ + +durch Eingabe der Kommandos + +.. code-block:: bash + + chown -R www-data:www-data /var/www/wallabag/bin + chown -R www-data:www-data /var/www/wallabag/app/config + chown -R www-data:www-data /var/www/wallabag/vendor + chown -R www-data:www-data /var/www/wallabag/data/ + +ansonsten wirst du früher oder später folgenden Fehlermeldung sehen: + +.. code-block:: bash + + Unable to write to the "bin" directory. + file_put_contents(app/config/parameters.yml): failed to open stream: Permission denied + file_put_contents(/.../wallabag/vendor/autoload.php): failed to open stream: Permission denied + +Zusätzliche Regeln für SELinux +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Wenn SELinux in deinem System aktiviert ist, wirst du zusätzliche Kontexte konfigurieren müssen damit wallabag ordentlich funktioniert. Um zu testen, ob SELinux aktiviert ist, führe einfach folgendes aus: + +``getenforce`` + +Dies wird ``Enforcing`` ausgeben, wenn SELinux aktiviert ist. Einen neuen Kontext zu erstellen, erfordert die folgende Syntax: + +``semanage fcontext -a -t `` + +Zum Beispiel: + +``semanage fcontext -a -t httpd_sys_content_t "/var/www/wallabag(/.*)?"`` + +Dies wird rekursiv den httpd_sys_content_t Kontext auf das wallabag Verzeichnis und alle darunterliegenden Dateien und Ordner anwenden. Die folgenden Regeln werden gebraucht: + ++-----------------------------------+----------------------------+ +| Vollständiger Pfad | Kontext | ++===================================+============================+ +| /var/www/wallabag(/.*)? | ``httpd_sys_content_t`` | ++-----------------------------------+----------------------------+ +| /var/www/wallabag/data(/.*)? | ``httpd_sys_rw_content_t`` | ++-----------------------------------+----------------------------+ +| /var/www/wallabag/var/logs(/.*)? | ``httpd_log_t`` | ++-----------------------------------+----------------------------+ +| /var/www/wallabag/var/cache(/.*)? | ``httpd_cache_t`` | ++-----------------------------------+----------------------------+ + +Nach dem diese Kontexte erstellt wurden, tippe das folgende, um deine Regeln anzuwenden: + +``restorecon -R -v /var/www/wallabag`` + +Du kannst deine Kontexte in einem Verzeichnis überprüfen, indem du ``ls -lZ`` tippst und alle deine aktuellen Regeln mit ``semanage fcontext -l -C`` überprüfst. + +Wenn du das vorkonfigurierte latest-v2-package installierst, dann ist eine weitere Regel während der Installation nötig: + +``semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/wallabag/var"`` + +Nachdem du erfolgreich dein wallabag erreichst und die Installation fertiggestellt hast, kann dieser Kontext entfernt werden: + +:: + + semanage fcontext -d -t httpd_sys_rw_content_t "/var/www/wallabag/var" + retorecon -R -v /var/www/wallabag/var diff --git a/docs/de/user/login.rst b/docs/de/user/login.rst new file mode 100644 index 00000000..cf1cdc4c --- /dev/null +++ b/docs/de/user/login.rst @@ -0,0 +1,13 @@ +Login +===== + +Dein Account ist nun aktiviert, Glückwünsch! + +Um dich bei wallabag einzuloggen, fülle das Formular auf der Loginseite aus. + +Wenn du an deinem persönlichen Computer arbeitest und verbunden bleiben willst, +kannst du die Checkbox ``Angemeldet bleiben`` anhaken: wallabag wird sich für ein Jahr an deinen Login erinnern. + +.. image:: ../../img/user/login_form.png + :alt: Loginformular + :align: center diff --git a/docs/de/user/migration.rst b/docs/de/user/migration.rst new file mode 100644 index 00000000..bc8a61b0 --- /dev/null +++ b/docs/de/user/migration.rst @@ -0,0 +1,62 @@ +Migration von v1 oder v2 +======================== + +Von wallabag 1.x +----------------- + +Wenn du bisher wallabag v1.x genutzt hast, musst du deine Daten exportieren bevor du zu wallabag v2.x migrierst, weil die Applikation und ihre Datenbank sich stark geändert haben. In deiner alten wallabag Installation kannst du deine Daten auf der Konfigurationsseite exportieren. + +.. image:: ../../img/user/export_v1.png + :alt: Export von wallabag v1 + :align: center + +.. note:: + Wenn du mehrere Accounts auf der gleichen Instanz von wallabag hast, muss jeder Nutzer von v1 exportieren und in v2 seine Daten importieren. + +.. note:: + Wenn du Probleme während des Exports oder Imports hast, scheue dich nicht davor `nach Hilfe zu fragen `__. + +Wenn du eine JSON Datei mit deinen Artikeln erhalten hast, kannst du wallabag v2 installieren falls benötigt durch Befolgen `der Standardprozedur `__. + +Nachdem du einen Nutzerkonto auf deiner neuen wallabag v2 Instanz eingerichtet hast, kannst du zu dem Abschnitt `Import` springen und `Import von wallabag v1` auswählen. Wähle deine JSON Datei aus und lade sie hoch. + +.. image:: ../../img/user/import_wallabagv1.png + :alt: Import von wallabag v1 + :align: center + +Import via command-line interface (CLI) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Wenn du CLI Zugang zu deinem Webserver hast, kannst du dieses Kommando ausführen, um deine Aritkel vom wallabag v1 Export zu importieren: + +:: + + bin/console wallabag:import-v1 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod + +Bitte ersetze folgende Werte: + +* ``1`` ist die Nutzer ID in der Databank (Die ID von dem ersten erstellten Nutzer in wallabag ist 1) +* ``~/Downloads/wallabag-export-1-2016-04-05.json`` ist der Pfad zu deinem wallabag v1 Export + +Du wirst eine solche Ausgabe erhalten: + +:: + + Start : 05-04-2016 11:36:07 --- + 403 imported + 0 already saved + End : 05-04-2016 11:36:09 --- + +Von wallabag 2.x +---------------- + +In der vorherigen wallabag Instanz, gehe zu `Alle Artikel` und exportiere diese Artikel als JSON. + +.. image:: ../../img/user/export_v2.png + :alt: Export von wallabag v2 + :align: center + +In deiner neuen wallabag Instanz erstellst du ein Nutzerkonto und klickst auf den Link im Menü, um den Import fortzusetzen. Wähle Import von wallabag v2 aus und lade deine JSON Datei hoch. + +.. note:: + Wenn du Probleme während des Exports oder Imports hast, scheue dich nicht davor `nach Hilfe zu fragen `__. diff --git a/docs/de/user/tags.rst b/docs/de/user/tags.rst new file mode 100644 index 00000000..8ddc0f40 --- /dev/null +++ b/docs/de/user/tags.rst @@ -0,0 +1,2 @@ +Tags +==== \ No newline at end of file diff --git a/docs/de/user/upgrade.rst b/docs/de/user/upgrade.rst new file mode 100644 index 00000000..13e3104f --- /dev/null +++ b/docs/de/user/upgrade.rst @@ -0,0 +1,32 @@ +Wallabag updaten +================ + +Update auf einem dedizierten Webserver +-------------------------------------- + +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.0.3`` mit der neuesten Releasenummer): + +:: + + git fetch origin + git fetch --tags + git checkout 2.0.3 + SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist + php bin/console cache:clear --env=prod + +Update auf einem Shared Webhosting +---------------------------------- + +Sichere deine ``app/config/parameters.yml`` Datei. + +Lade das neueste Release von wallabag herunter: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. + +Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. + +Leere den ``var/cache`` Ordner. -- cgit v1.2.3 From 78d5da87fa19e9d385514f6ee5ec68f475f4e56d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Thu, 15 Sep 2016 14:58:14 +0200 Subject: Add links to translations in documentation homepage --- docs/de/index.rst | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'docs/de') diff --git a/docs/de/index.rst b/docs/de/index.rst index 5311150f..d8cd8f39 100644 --- a/docs/de/index.rst +++ b/docs/de/index.rst @@ -17,6 +17,11 @@ Die Hauptdokumentation für diese Applikation ist in einigen Abschnitten organis * :ref:`user-docs` * :ref:`dev-docs` +Die Dokumentation ist in anderen Sprachen verfügbar : + +* `Documentation in english `_ +* `Documentation en français `_ + .. _user-docs: .. toctree:: -- cgit v1.2.3 From 8fed8d1bacbbcbf606a94497c5b58f49068bd6a3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Thu, 25 Aug 2016 15:28:46 +0200 Subject: Add documentation about article sharing --- docs/de/user/installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index fced2ed4..2e3108be 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -46,7 +46,7 @@ Composer installieren: curl -s http://getcomposer.org/installer | php -Du kannst eine spezifische Anleitung `hier `__ finden: +Du kannst eine spezifische Anleitung `hier `__ finden. Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: -- cgit v1.2.3 From ce0a32229a8d139115ccd1d247a0ee4f1fedc8a3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Thu, 15 Sep 2016 14:26:30 +0200 Subject: Fix wallabag version in documentation --- docs/de/user/installation.rst | 5 ++--- docs/de/user/upgrade.rst | 7 +++---- 2 files changed, 5 insertions(+), 7 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 2e3108be..05602bf3 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -54,9 +54,8 @@ Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: git clone https://github.com/wallabag/wallabag.git cd wallabag - git checkout 2.0.8 - SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist - php bin/console wallabag:install --env=prod + git checkout 2.1.0 + ./install.sh Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen: diff --git a/docs/de/user/upgrade.rst b/docs/de/user/upgrade.rst index c04b68f3..953c84ff 100644 --- a/docs/de/user/upgrade.rst +++ b/docs/de/user/upgrade.rst @@ -4,15 +4,14 @@ Wallabag updaten Update auf einem dedizierten Webserver -------------------------------------- -Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.0.8`` mit der neuesten Releasenummer): +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.1.0`` mit der neuesten Releasenummer): :: git fetch origin git fetch --tags - git checkout 2.0.8 - SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist - php bin/console cache:clear --env=prod + git checkout 2.1.0 + ./install.sh Update auf einem Shared Webhosting ---------------------------------- -- cgit v1.2.3 From 084fb0d303efc6edd0bfbf43d96b6cbe48acb2b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Wed, 28 Sep 2016 10:02:31 +0200 Subject: Some fixes about upgrade from 2.0.x -> 2.1.0 --- docs/de/conf.py | 2 +- docs/de/user/upgrade.rst | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) (limited to 'docs/de') diff --git a/docs/de/conf.py b/docs/de/conf.py index 8f2d130d..cc9dcdf8 100644 --- a/docs/de/conf.py +++ b/docs/de/conf.py @@ -12,7 +12,7 @@ source_suffix = '.rst' master_doc = 'index' project = u'wallabag-fr' copyright = u'2013-2016, Nicolas Lœuillet - MIT Licence' -version = '2.0.0' +version = '2.1.0' release = version exclude_patterns = ['_build'] pygments_style = 'sphinx' diff --git a/docs/de/user/upgrade.rst b/docs/de/user/upgrade.rst index 953c84ff..084dab74 100644 --- a/docs/de/user/upgrade.rst +++ b/docs/de/user/upgrade.rst @@ -11,7 +11,9 @@ Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.htm git fetch origin git fetch --tags git checkout 2.1.0 - ./install.sh + ASSETS=build ./install.sh + php bin/console doctrine:migrations:migrate --env=prod + php bin/console cache:clear --env=prod Update auf einem Shared Webhosting ---------------------------------- -- cgit v1.2.3 From eef8aeec8fa56519363e90977900f198ff3bd19b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Wed, 28 Sep 2016 11:13:20 +0200 Subject: Reordered upgrade documentation --- docs/de/index.rst | 3 ++- docs/de/user/upgrade-2.0.x-2.0.y.rst | 34 ++++++++++++++++++++++++ docs/de/user/upgrade-2.0.x-2.1.0.rst | 50 ++++++++++++++++++++++++++++++++++++ docs/de/user/upgrade.rst | 35 ------------------------- 4 files changed, 86 insertions(+), 36 deletions(-) create mode 100644 docs/de/user/upgrade-2.0.x-2.0.y.rst create mode 100644 docs/de/user/upgrade-2.0.x-2.1.0.rst delete mode 100644 docs/de/user/upgrade.rst (limited to 'docs/de') diff --git a/docs/de/index.rst b/docs/de/index.rst index d8cd8f39..62f8b54a 100644 --- a/docs/de/index.rst +++ b/docs/de/index.rst @@ -30,7 +30,8 @@ Die Dokumentation ist in anderen Sprachen verfügbar : user/faq user/installation - user/upgrade + user/upgrade-2.0.x-2.1.0 + user/upgrade-2.0.x-2.0.y user/migration user/import user/create_account diff --git a/docs/de/user/upgrade-2.0.x-2.0.y.rst b/docs/de/user/upgrade-2.0.x-2.0.y.rst new file mode 100644 index 00000000..c04b68f3 --- /dev/null +++ b/docs/de/user/upgrade-2.0.x-2.0.y.rst @@ -0,0 +1,34 @@ +Wallabag updaten +================ + +Update auf einem dedizierten Webserver +-------------------------------------- + +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.0.8`` mit der neuesten Releasenummer): + +:: + + git fetch origin + git fetch --tags + git checkout 2.0.8 + SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist + php bin/console cache:clear --env=prod + +Update auf einem Shared Webhosting +---------------------------------- + +Sichere deine ``app/config/parameters.yml`` Datei. + +Lade das neueste Release von wallabag herunter: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +(md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) + +Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. + +Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. + +Leere den ``var/cache`` Ordner. diff --git a/docs/de/user/upgrade-2.0.x-2.1.0.rst b/docs/de/user/upgrade-2.0.x-2.1.0.rst new file mode 100644 index 00000000..eb67e686 --- /dev/null +++ b/docs/de/user/upgrade-2.0.x-2.1.0.rst @@ -0,0 +1,50 @@ +Wallabag updaten +================ + +.. warning:: +Before this migration, if you configured the Pocket import by adding your consumer key in Internal settings, please do a backup of it: you'll have to add it into the Config page after the upgrade. + +Update auf einem dedizierten Webserver +-------------------------------------- + +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.1.0`` mit der neuesten Releasenummer): + +:: + + git fetch origin + git fetch --tags + git checkout 2.1.0 + ASSETS=build ./install.sh + php bin/console doctrine:migrations:migrate --env=prod + php bin/console cache:clear --env=prod + +Update auf einem Shared Webhosting +---------------------------------- + +Sichere deine ``app/config/parameters.yml`` Datei. + +Lade das neueste Release von wallabag herunter: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +(md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) + +Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. + +Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. + +Leere den ``var/cache`` Ordner. + +Sie müssen einige SQL-Abfragen ausführen, um Ihre Datenbank zu aktualisieren. We assume that the table prefix is ``wallabag_`` and the database server is a MySQL one: + +.. code-block:: sql + + ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); + ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); + ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; + DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; diff --git a/docs/de/user/upgrade.rst b/docs/de/user/upgrade.rst deleted file mode 100644 index 084dab74..00000000 --- a/docs/de/user/upgrade.rst +++ /dev/null @@ -1,35 +0,0 @@ -Wallabag updaten -================ - -Update auf einem dedizierten Webserver --------------------------------------- - -Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.1.0`` mit der neuesten Releasenummer): - -:: - - git fetch origin - git fetch --tags - git checkout 2.1.0 - ASSETS=build ./install.sh - php bin/console doctrine:migrations:migrate --env=prod - php bin/console cache:clear --env=prod - -Update auf einem Shared Webhosting ----------------------------------- - -Sichere deine ``app/config/parameters.yml`` Datei. - -Lade das neueste Release von wallabag herunter: - -.. code-block:: bash - - wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package - -(md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) - -Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. - -Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. - -Leere den ``var/cache`` Ordner. -- cgit v1.2.3 From 9866d39431ca58e4c913b6385ed74287f014c38d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Wed, 28 Sep 2016 11:59:35 +0200 Subject: Fixed review --- docs/de/index.rst | 2 +- docs/de/user/upgrade-2.0.x-2.0.y.rst | 4 +-- docs/de/user/upgrade-2.0.x-2.1.0.rst | 50 ---------------------------- docs/de/user/upgrade-2.0.x-2.1.y.rst | 64 ++++++++++++++++++++++++++++++++++++ 4 files changed, 67 insertions(+), 53 deletions(-) delete mode 100644 docs/de/user/upgrade-2.0.x-2.1.0.rst create mode 100644 docs/de/user/upgrade-2.0.x-2.1.y.rst (limited to 'docs/de') diff --git a/docs/de/index.rst b/docs/de/index.rst index 62f8b54a..65cf8953 100644 --- a/docs/de/index.rst +++ b/docs/de/index.rst @@ -30,7 +30,7 @@ Die Dokumentation ist in anderen Sprachen verfügbar : user/faq user/installation - user/upgrade-2.0.x-2.1.0 + user/upgrade-2.0.x-2.1.y user/upgrade-2.0.x-2.0.y user/migration user/import diff --git a/docs/de/user/upgrade-2.0.x-2.0.y.rst b/docs/de/user/upgrade-2.0.x-2.0.y.rst index c04b68f3..adf288bd 100644 --- a/docs/de/user/upgrade-2.0.x-2.0.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.0.y.rst @@ -1,5 +1,5 @@ -Wallabag updaten -================ +Wallabag updaten 2.0.x -> 2.1.x +=============================== Update auf einem dedizierten Webserver -------------------------------------- diff --git a/docs/de/user/upgrade-2.0.x-2.1.0.rst b/docs/de/user/upgrade-2.0.x-2.1.0.rst deleted file mode 100644 index eb67e686..00000000 --- a/docs/de/user/upgrade-2.0.x-2.1.0.rst +++ /dev/null @@ -1,50 +0,0 @@ -Wallabag updaten -================ - -.. warning:: -Before this migration, if you configured the Pocket import by adding your consumer key in Internal settings, please do a backup of it: you'll have to add it into the Config page after the upgrade. - -Update auf einem dedizierten Webserver --------------------------------------- - -Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.1.0`` mit der neuesten Releasenummer): - -:: - - git fetch origin - git fetch --tags - git checkout 2.1.0 - ASSETS=build ./install.sh - php bin/console doctrine:migrations:migrate --env=prod - php bin/console cache:clear --env=prod - -Update auf einem Shared Webhosting ----------------------------------- - -Sichere deine ``app/config/parameters.yml`` Datei. - -Lade das neueste Release von wallabag herunter: - -.. code-block:: bash - - wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package - -(md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) - -Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. - -Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. - -Leere den ``var/cache`` Ordner. - -Sie müssen einige SQL-Abfragen ausführen, um Ihre Datenbank zu aktualisieren. We assume that the table prefix is ``wallabag_`` and the database server is a MySQL one: - -.. code-block:: sql - - ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); - ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); - ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; - DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst new file mode 100644 index 00000000..32d13c6a --- /dev/null +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -0,0 +1,64 @@ +Wallabag updaten +================ + +.. warning:: +Before this migration, if you configured the Pocket import by adding your consumer key in Internal settings, please do a backup of it: you'll have to add it into the Config page after the upgrade. + +Update auf einem dedizierten Webserver +-------------------------------------- + +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.1.0`` mit der neuesten Releasenummer): + +:: + + git fetch origin + git fetch --tags + git checkout 2.1.0 + ASSETS=build ./install.sh + php bin/console doctrine:migrations:migrate --env=prod + php bin/console cache:clear --env=prod + +Update auf einem Shared Webhosting +---------------------------------- + +Sichere deine ``app/config/parameters.yml`` Datei. + +Lade das neueste Release von wallabag herunter: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +(md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) + +Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. + +Please note that we added new parameters in this version. You have to edit ``app/config/parameters.yml`` by adding these lines (replace with your configuration) : + +.. code-block:: bash + + # RabbitMQ processing + rabbitmq_host: localhost + rabbitmq_port: 5672 + rabbitmq_user: guest + rabbitmq_password: guest + + # Redis processing + redis_host: localhost + redis_port: 6379 + +Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. + +Leere den ``var/cache`` Ordner. + +Sie müssen einige SQL-Abfragen ausführen, um Ihre Datenbank zu aktualisieren. We assume that the table prefix is ``wallabag_`` and the database server is a MySQL one: + +.. code-block:: sql + + ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); + ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); + ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; + DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; -- cgit v1.2.3 From ff1f55c2a0122c1842cfb59a0431221b247f6851 Mon Sep 17 00:00:00 2001 From: Strubbl Date: Wed, 28 Sep 2016 12:26:29 +0200 Subject: update German upgrade-2.0.x-2.1.y.rst --- docs/de/user/upgrade-2.0.x-2.1.y.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst index 32d13c6a..cc292957 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -2,7 +2,7 @@ Wallabag updaten ================ .. warning:: -Before this migration, if you configured the Pocket import by adding your consumer key in Internal settings, please do a backup of it: you'll have to add it into the Config page after the upgrade. +Wenn du den Import von Pocket durch das Hinzufügen des Consumer Key in den internen Einstellungen konfiguriert hast, fertige bitte ein Backup deines Keys an bevor du auf das neue Release migrierst: Du wirst den Key nach dem Update in der Konfiguration erneut eintragen müssen. Update auf einem dedizierten Webserver -------------------------------------- @@ -33,7 +33,7 @@ Lade das neueste Release von wallabag herunter: Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. -Please note that we added new parameters in this version. You have to edit ``app/config/parameters.yml`` by adding these lines (replace with your configuration) : +Bitte beachte, dass wir in dieser Version neue Parameter hinzugefügt haben. Du musst die Datei ``app/config/parameters.yml`` bearbeiten und die folgenden Zeilen hinzufügen (ersetze die Werte mit deiner Konfiguration): .. code-block:: bash @@ -51,7 +51,7 @@ Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installat Leere den ``var/cache`` Ordner. -Sie müssen einige SQL-Abfragen ausführen, um Ihre Datenbank zu aktualisieren. We assume that the table prefix is ``wallabag_`` and the database server is a MySQL one: +Du musst einige SQL-Abfragen ausführen, um die Datenbank zu aktualisieren. Wir nehmen an, dass der Tabellenpräfix ``wallabag_`` und die Datenbank MySQL ist: .. code-block:: sql -- cgit v1.2.3 From 34e4c12604977b2c57ff9eae313278fb5067f8b5 Mon Sep 17 00:00:00 2001 From: Julian Oster Date: Wed, 28 Sep 2016 13:52:06 +0200 Subject: Little improvements to the german translation --- docs/de/user/upgrade-2.0.x-2.1.y.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst index cc292957..85229d30 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -2,12 +2,12 @@ Wallabag updaten ================ .. warning:: -Wenn du den Import von Pocket durch das Hinzufügen des Consumer Key in den internen Einstellungen konfiguriert hast, fertige bitte ein Backup deines Keys an bevor du auf das neue Release migrierst: Du wirst den Key nach dem Update in der Konfiguration erneut eintragen müssen. +Wenn du den Import von Pocket durch das Hinzufügen des Consumer Key in den internen Einstellungen konfiguriert hast, fertige bitte ein Backup deines Keys an, bevor du auf das neue Release migrierst: Du wirst den Key nach dem Update in der Konfiguration erneut eintragen müssen. Update auf einem dedizierten Webserver -------------------------------------- -Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.1.0`` mit der neuesten Releasenummer): +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag-Installation auf die neueste Version zu aktualisieren, führe die folgenden Kommandos in deinem wallabag-Ordner aus (ersetze ``2.1.0`` mit der neuesten Releasenummer): :: @@ -31,7 +31,7 @@ Lade das neueste Release von wallabag herunter: (md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) -Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. +Entpacke das Archiv in deinen wallabag-Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. Bitte beachte, dass wir in dieser Version neue Parameter hinzugefügt haben. Du musst die Datei ``app/config/parameters.yml`` bearbeiten und die folgenden Zeilen hinzufügen (ersetze die Werte mit deiner Konfiguration): @@ -51,7 +51,7 @@ Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installat Leere den ``var/cache`` Ordner. -Du musst einige SQL-Abfragen ausführen, um die Datenbank zu aktualisieren. Wir nehmen an, dass der Tabellenpräfix ``wallabag_`` und die Datenbank MySQL ist: +Du musst einige SQL-Abfragen ausführen, um die Datenbank zu aktualisieren. Wir nehmen in diesem Fall an, dass das Tabellenpräfix ``wallabag_`` ist und eine MySQL-Datenbank genutzt wird: .. code-block:: sql -- cgit v1.2.3 From 080cb52fac8e2bf2d304c3d49ca3b96378d3587f Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Thu, 29 Sep 2016 10:36:19 +0200 Subject: add German rabbitmq.rst --- docs/de/developer/rabbitmq.rst | 67 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 docs/de/developer/rabbitmq.rst (limited to 'docs/de') diff --git a/docs/de/developer/rabbitmq.rst b/docs/de/developer/rabbitmq.rst new file mode 100644 index 00000000..4814a623 --- /dev/null +++ b/docs/de/developer/rabbitmq.rst @@ -0,0 +1,67 @@ +Installiere RabbitMQ für asynchrone Aufgaben +============================================ + +Um asynchrone Aufgaben zu starten (nützlich z.B. für große Imports), können wir RabbitMQ nutzen. + +Voraussetzungen +-------------- + +Du musst RabbitMQ auf deinem Server installiert haben. + +Installation +~~~~~~~~~~~~ + +.. code:: bash + + wget https://www.rabbitmq.com/rabbitmq-signing-key-public.asc + apt-key add rabbitmq-signing-key-public.asc + apt-get update + apt-get install rabbitmq-server + +Konfiguration und Starten +~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code:: bash + + rabbitmq-plugins enable rabbitmq_management # (useful to have a web interface, available at http://localhost:15672/ (guest/guest) + rabbitmq-server -detached + +RabbitMQ stoppen +~~~~~~~~~~~~~ + +.. code:: bash + + rabbitmqctl stop + + +Konfigure RabbitMQ in wallabag +------------------------------ + +Bearbeite die Datei ``parameters.yml``, um die RabbitMQ Konfiguration einzurichten. Die Standardkonfiguration sollte ok sein: + +.. code:: yaml + + rabbitmq_host: localhost + rabbitmq_port: 5672 + rabbitmq_user: guest + rabbitmq_password: guest + + +Starte den RabbitMQ Consumer +------------------------ + +Abhängig von welchem Service du importieren möchtest, solltest du einen Cron Job aktivieren (oder mehrere, wenn du viele unterstützen willst): + +.. code:: bash + + # for Pocket import + bin/console rabbitmq:consumer import_pocket -w + + # for Readbility import + bin/console rabbitmq:consumer import_readability -w + + # for wallabag v1 import + bin/console rabbitmq:consumer import_wallabag_v1 -w + + # for wallabag v2 import + bin/console rabbitmq:consumer import_wallabag_v2 -w -- cgit v1.2.3 From 00283a3b0aa8067f7ab66376509ca4464edd93ec Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Thu, 29 Sep 2016 10:41:07 +0200 Subject: add German redis.rst --- docs/de/developer/redis.rst | 62 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 docs/de/developer/redis.rst (limited to 'docs/de') diff --git a/docs/de/developer/redis.rst b/docs/de/developer/redis.rst new file mode 100644 index 00000000..19800c46 --- /dev/null +++ b/docs/de/developer/redis.rst @@ -0,0 +1,62 @@ +Installiere Redis für asynchrone Aufgaben +========================================= + +Um asynchrone Aufgaben zu starten (nützlich z.B. für große Imports), können wir Redis nutzen. + +Voraussetzungen +------------ + +Du musst Redis auf deinem Server installiert haben. + +Installation +~~~~~~~~~~~~ + +.. code:: bash + + apt-get install redis-server + +Starten +~~~~~~ + +Der Redis Service läuft eventuell schon direkt nach der Installation. Falls nicht kannst du ihn wie folgt starten: + +.. code:: bash + + redis-server + + +Konfigure Redis in wallabag +--------------------------- + +Bearbeite die Datei ``parameters.yml``, um die RabbitMQ Konfiguration einzurichten. Die Standardkonfiguration sollte ok sein: + +.. code:: yaml + + redis_host: localhost + redis_port: 6379 + + +Starte den Redis Consumer +------------------------ + +Abhängig von welchem Service du importieren möchtest, solltest du einen Cron Job aktivieren (oder mehrere, wenn du viele unterstützen willst): + +.. code:: bash + + # for Pocket import + bin/console wallabag:import:redis-worker pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log + + # for Readbility import + bin/console wallabag:import:redis-worker readability -vv >> /path/to/wallabag/var/logs/redis-readability.log + + # for wallabag v1 import + bin/console wallabag:import:redis-worker wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log + + # for wallabag v2 import + bin/console wallabag:import:redis-worker wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log + +Wenn du den Import nur für ein paar Nachrichten und nicht für alle starten willst, kannst du die Nummer (im folgenden Beispiel 12) angeben. Der Redis Worker wird dann nach der 12. Nachricht stoppen: + +.. code:: bash + + bin/console wallabag:import:redis-worker pocket -vv --maxIterations=12 -- cgit v1.2.3 From c59e628afeee9bfb2b8b358cdc81688e85cff744 Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Thu, 29 Sep 2016 10:43:53 +0200 Subject: Added links to async config in german doc --- docs/de/index.rst | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs/de') diff --git a/docs/de/index.rst b/docs/de/index.rst index 65cf8953..b3cd33b0 100644 --- a/docs/de/index.rst +++ b/docs/de/index.rst @@ -56,3 +56,5 @@ Die Dokumentation ist in anderen Sprachen verfügbar : developer/documentation developer/translate developer/maintenance + developer/redis + developer/rabbitmq -- cgit v1.2.3 From 2d8af6fc7fe32dd8788cb89f8c3aec9269cbe33c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Thu, 29 Sep 2016 11:01:15 +0200 Subject: Added french documentation about Redis and RabbitMQ --- docs/de/developer/rabbitmq.rst | 18 ++++++++++++++---- docs/de/developer/redis.rst | 15 ++++++++++++--- 2 files changed, 26 insertions(+), 7 deletions(-) (limited to 'docs/de') diff --git a/docs/de/developer/rabbitmq.rst b/docs/de/developer/rabbitmq.rst index 4814a623..bea02ff4 100644 --- a/docs/de/developer/rabbitmq.rst +++ b/docs/de/developer/rabbitmq.rst @@ -4,7 +4,7 @@ Installiere RabbitMQ für asynchrone Aufgaben Um asynchrone Aufgaben zu starten (nützlich z.B. für große Imports), können wir RabbitMQ nutzen. Voraussetzungen --------------- +--------------- Du musst RabbitMQ auf deinem Server installiert haben. @@ -27,7 +27,7 @@ Konfiguration und Starten rabbitmq-server -detached RabbitMQ stoppen -~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~ .. code:: bash @@ -48,7 +48,7 @@ Bearbeite die Datei ``parameters.yml``, um die RabbitMQ Konfiguration einzuricht Starte den RabbitMQ Consumer ------------------------- +---------------------------- Abhängig von welchem Service du importieren möchtest, solltest du einen Cron Job aktivieren (oder mehrere, wenn du viele unterstützen willst): @@ -57,11 +57,21 @@ Abhängig von welchem Service du importieren möchtest, solltest du einen Cron J # for Pocket import bin/console rabbitmq:consumer import_pocket -w - # for Readbility import + # for Readability import bin/console rabbitmq:consumer import_readability -w + # for Instapaper import + bin/console rabbitmq:consumer import_instapaper -w + # for wallabag v1 import bin/console rabbitmq:consumer import_wallabag_v1 -w # for wallabag v2 import bin/console rabbitmq:consumer import_wallabag_v2 -w + + # for Firefox import + bin/console rabbitmq:consumer import_firefox -w + + # for Chrome import + bin/console rabbitmq:consumer import_chrome -w + diff --git a/docs/de/developer/redis.rst b/docs/de/developer/redis.rst index 19800c46..d613ce6c 100644 --- a/docs/de/developer/redis.rst +++ b/docs/de/developer/redis.rst @@ -4,7 +4,7 @@ Installiere Redis für asynchrone Aufgaben Um asynchrone Aufgaben zu starten (nützlich z.B. für große Imports), können wir Redis nutzen. Voraussetzungen ------------- +--------------- Du musst Redis auf deinem Server installiert haben. @@ -37,7 +37,7 @@ Bearbeite die Datei ``parameters.yml``, um die RabbitMQ Konfiguration einzuricht Starte den Redis Consumer ------------------------- +------------------------- Abhängig von welchem Service du importieren möchtest, solltest du einen Cron Job aktivieren (oder mehrere, wenn du viele unterstützen willst): @@ -46,15 +46,24 @@ Abhängig von welchem Service du importieren möchtest, solltest du einen Cron J # for Pocket import bin/console wallabag:import:redis-worker pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log - # for Readbility import + # for Readability import bin/console wallabag:import:redis-worker readability -vv >> /path/to/wallabag/var/logs/redis-readability.log + # for Instapaper import + bin/console wallabag:import:redis-worker instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log + # for wallabag v1 import bin/console wallabag:import:redis-worker wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log # for wallabag v2 import bin/console wallabag:import:redis-worker wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log + # for Firefox import + bin/console wallabag:import:redis-worker firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log + + # for Chrome import + bin/console wallabag:import:redis-worker instapaper -vv >> /path/to/wallabag/var/logs/redis-chrome.log + Wenn du den Import nur für ein paar Nachrichten und nicht für alle starten willst, kannst du die Nummer (im folgenden Beispiel 12) angeben. Der Redis Worker wird dann nach der 12. Nachricht stoppen: .. code:: bash -- cgit v1.2.3 From 12f7fd004a64756e84cca963886e99225e79ec9a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 3 Oct 2016 09:16:57 +0200 Subject: Prepare wallabag 2.1.0 :rocket: --- docs/de/user/installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 05602bf3..c24f0e00 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -55,7 +55,7 @@ Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: git clone https://github.com/wallabag/wallabag.git cd wallabag git checkout 2.1.0 - ./install.sh + ASSETS=build ./install.sh Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen: -- cgit v1.2.3 From 9d3603147b0a4219a8065861351439cbe5e52772 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 3 Oct 2016 11:16:35 +0200 Subject: Update md5 hash for wallabag 2.1.0 --- docs/de/user/installation.rst | 2 +- docs/de/user/upgrade-2.0.x-2.1.y.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index c24f0e00..f7bc2e4f 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -85,7 +85,7 @@ Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacke wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package -(md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) +(md5 hash: ``6c33520e29cc754b687f9cee0398dede``) Jetzt lese die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu. Wenn du die Datenbankkonfiguration eingestellt hast, MySQL oder PostgreSQL zu nutzen, musst du einen Nutzer über das folgende Kommando erstellen ``php bin/console wallabag:install --env=prod``. diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst index 85229d30..23bf3682 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -29,7 +29,7 @@ Lade das neueste Release von wallabag herunter: wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package -(md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) +(md5 hash: ``6c33520e29cc754b687f9cee0398dede``) Entpacke das Archiv in deinen wallabag-Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. -- cgit v1.2.3 From 8fdb5e5766a6bf5970f268200a6c21fd39693637 Mon Sep 17 00:00:00 2001 From: Jeremy Benoist Date: Mon, 3 Oct 2016 14:21:49 +0200 Subject: Re-add wallabag:install --- docs/de/user/installation.rst | 1 + 1 file changed, 1 insertion(+) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index f7bc2e4f..7fa8c625 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -56,6 +56,7 @@ Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: cd wallabag git checkout 2.1.0 ASSETS=build ./install.sh + php bin/console wallabag:install --env=prod Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen: -- cgit v1.2.3 From 88d8125a5fa3b5c6c91cb22fc2bef1243d7391fc Mon Sep 17 00:00:00 2001 From: Jeremy Benoist Date: Mon, 3 Oct 2016 14:44:12 +0200 Subject: Ensure cache is clear before upgrading If we changed some namespace / classes, we need to refresh the cache before anything else. --- docs/de/user/upgrade-2.0.x-2.0.y.rst | 1 + docs/de/user/upgrade-2.0.x-2.1.y.rst | 1 + 2 files changed, 2 insertions(+) (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.0.y.rst b/docs/de/user/upgrade-2.0.x-2.0.y.rst index adf288bd..5820a0d2 100644 --- a/docs/de/user/upgrade-2.0.x-2.0.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.0.y.rst @@ -8,6 +8,7 @@ Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.htm :: + rm -rf var/cache/* git fetch origin git fetch --tags git checkout 2.0.8 diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst index 23bf3682..7c20f4ee 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -11,6 +11,7 @@ Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.htm :: + rm -rf var/cache/* git fetch origin git fetch --tags git checkout 2.1.0 -- cgit v1.2.3 From f7265b4b9dbe93b928874d6ec827cfbc27dffbb2 Mon Sep 17 00:00:00 2001 From: Zayon Date: Mon, 3 Oct 2016 23:21:35 +0200 Subject: Add php-bcmath extension to requirements Fix issue #2342 --- docs/de/user/installation.rst | 1 + 1 file changed, 1 insertion(+) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 7fa8c625..a7789656 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -23,6 +23,7 @@ nicht alle folgenden Pakete installieren. - php-curl - php-gettext - php-tokenizer +- php-bcmath wallabag nutzt PDO, um sich mit der Datenbank zu verbinden, darum benötigst du eines der folgenden Komponenten: -- cgit v1.2.3 From f440e282819a1e92e3200cf2e588fc9a0c1278ac Mon Sep 17 00:00:00 2001 From: Jeremy Benoist Date: Tue, 4 Oct 2016 10:25:49 +0200 Subject: Update doc Merge VALIDATE_TRANSLATION_FILE & ASSET build (less build on Travis) --- docs/de/user/installation.rst | 2 +- docs/de/user/upgrade-2.0.x-2.1.y.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 7fa8c625..f9f34c3c 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -55,7 +55,7 @@ Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: git clone https://github.com/wallabag/wallabag.git cd wallabag git checkout 2.1.0 - ASSETS=build ./install.sh + SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist php bin/console wallabag:install --env=prod Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen: diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst index 7c20f4ee..7319a18a 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -15,7 +15,7 @@ Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.htm git fetch origin git fetch --tags git checkout 2.1.0 - ASSETS=build ./install.sh + SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist php bin/console doctrine:migrations:migrate --env=prod php bin/console cache:clear --env=prod -- cgit v1.2.3 From 5958597ba6c54abe0922e1950f301f6f40cdb430 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 3 Oct 2016 21:11:31 +0200 Subject: Prepare wallabag 2.1.1 --- docs/de/user/installation.rst | 2 +- docs/de/user/upgrade-2.0.x-2.1.y.rst | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index c438761f..3578dca9 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -55,7 +55,7 @@ Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: git clone https://github.com/wallabag/wallabag.git cd wallabag - git checkout 2.1.0 + git checkout 2.1.1 --force SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist php bin/console wallabag:install --env=prod diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst index 7319a18a..8ee2ae59 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -7,14 +7,14 @@ Wenn du den Import von Pocket durch das Hinzufügen des Consumer Key in den inte Update auf einem dedizierten Webserver -------------------------------------- -Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag-Installation auf die neueste Version zu aktualisieren, führe die folgenden Kommandos in deinem wallabag-Ordner aus (ersetze ``2.1.0`` mit der neuesten Releasenummer): +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag-Installation auf die neueste Version zu aktualisieren, führe die folgenden Kommandos in deinem wallabag-Ordner aus (ersetze ``2.1.1`` mit der neuesten Releasenummer): :: rm -rf var/cache/* git fetch origin git fetch --tags - git checkout 2.1.0 + git checkout 2.1.0 --force SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist php bin/console doctrine:migrations:migrate --env=prod php bin/console cache:clear --env=prod -- cgit v1.2.3 From 8ebb214ec440db0d768fc67f860aec377ae5166d Mon Sep 17 00:00:00 2001 From: Jeremy Benoist Date: Tue, 4 Oct 2016 17:12:45 +0200 Subject: Typo --- docs/de/user/upgrade-2.0.x-2.1.y.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst index 8ee2ae59..a30488f8 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -14,7 +14,7 @@ Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.htm rm -rf var/cache/* git fetch origin git fetch --tags - git checkout 2.1.0 --force + git checkout 2.1.1 --force SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist php bin/console doctrine:migrations:migrate --env=prod php bin/console cache:clear --env=prod -- cgit v1.2.3 From 837247dea48f94644cbc9589b0239265ce33d6f5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Tue, 4 Oct 2016 17:43:28 +0200 Subject: Update md5 hash for package --- docs/de/user/upgrade-2.0.x-2.1.y.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst index a30488f8..eee50fe4 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.y.rst @@ -30,7 +30,7 @@ Lade das neueste Release von wallabag herunter: wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package -(md5 hash: ``6c33520e29cc754b687f9cee0398dede``) +(2.1.1 md5 hash: ``9584a3b60a2b2a4de87f536548caac93``) Entpacke das Archiv in deinen wallabag-Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. -- cgit v1.2.3 From ba69216853b25f747591740fb039491692c1f76e Mon Sep 17 00:00:00 2001 From: Jeremy Benoist Date: Sat, 8 Oct 2016 09:39:07 +0200 Subject: Set env to prod in documentation --- docs/de/developer/maintenance.rst | 4 ++-- docs/de/developer/rabbitmq.rst | 14 +++++++------- docs/de/developer/redis.rst | 16 ++++++++-------- 3 files changed, 17 insertions(+), 17 deletions(-) (limited to 'docs/de') diff --git a/docs/de/developer/maintenance.rst b/docs/de/developer/maintenance.rst index 2a9070e1..31343876 100644 --- a/docs/de/developer/maintenance.rst +++ b/docs/de/developer/maintenance.rst @@ -11,7 +11,7 @@ Um den Wartungsmodus zu aktivieren, führe folgendes Kommando aus: :: - bin/console lexik:maintenance:lock --no-interaction + bin/console lexik:maintenance:lock -e=prod --no-interaction Du kannst deine IP Adresse in ``app/config/config.yml`` setzen, wenn du Zugriff zu wallabag haben willst, auch wenn der Wartungsmodus aktiv ist. Zum Beispiel: @@ -29,4 +29,4 @@ Um den Wartungsmodus zu deaktivieren, führe dieses Kommando aus: :: - bin/console lexik:maintenance:unlock + bin/console lexik:maintenance:unlock -e=prod diff --git a/docs/de/developer/rabbitmq.rst b/docs/de/developer/rabbitmq.rst index bea02ff4..37e9984b 100644 --- a/docs/de/developer/rabbitmq.rst +++ b/docs/de/developer/rabbitmq.rst @@ -55,23 +55,23 @@ Abhängig von welchem Service du importieren möchtest, solltest du einen Cron J .. code:: bash # for Pocket import - bin/console rabbitmq:consumer import_pocket -w + bin/console rabbitmq:consumer -e=prod import_pocket -w # for Readability import - bin/console rabbitmq:consumer import_readability -w + bin/console rabbitmq:consumer -e=prod import_readability -w # for Instapaper import - bin/console rabbitmq:consumer import_instapaper -w + bin/console rabbitmq:consumer -e=prod import_instapaper -w # for wallabag v1 import - bin/console rabbitmq:consumer import_wallabag_v1 -w + bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w # for wallabag v2 import - bin/console rabbitmq:consumer import_wallabag_v2 -w + bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w # for Firefox import - bin/console rabbitmq:consumer import_firefox -w + bin/console rabbitmq:consumer -e=prod import_firefox -w # for Chrome import - bin/console rabbitmq:consumer import_chrome -w + bin/console rabbitmq:consumer -e=prod import_chrome -w diff --git a/docs/de/developer/redis.rst b/docs/de/developer/redis.rst index d613ce6c..46334cf0 100644 --- a/docs/de/developer/redis.rst +++ b/docs/de/developer/redis.rst @@ -44,28 +44,28 @@ Abhängig von welchem Service du importieren möchtest, solltest du einen Cron J .. code:: bash # for Pocket import - bin/console wallabag:import:redis-worker pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log + bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log # for Readability import - bin/console wallabag:import:redis-worker readability -vv >> /path/to/wallabag/var/logs/redis-readability.log + bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log # for Instapaper import - bin/console wallabag:import:redis-worker instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log + bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log # for wallabag v1 import - bin/console wallabag:import:redis-worker wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log + bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log # for wallabag v2 import - bin/console wallabag:import:redis-worker wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log + bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log # for Firefox import - bin/console wallabag:import:redis-worker firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log + bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log # for Chrome import - bin/console wallabag:import:redis-worker instapaper -vv >> /path/to/wallabag/var/logs/redis-chrome.log + bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-chrome.log Wenn du den Import nur für ein paar Nachrichten und nicht für alle starten willst, kannst du die Nummer (im folgenden Beispiel 12) angeben. Der Redis Worker wird dann nach der 12. Nachricht stoppen: .. code:: bash - bin/console wallabag:import:redis-worker pocket -vv --maxIterations=12 + bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12 -- cgit v1.2.3 From 7eff4736a1309ad71a75fa74dc1081a3b2303169 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Sat, 8 Oct 2016 15:10:56 +0200 Subject: Cleaned up documentation for installation process --- docs/de/user/installation.rst | 34 ++++++++++++++++------------------ 1 file changed, 16 insertions(+), 18 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 3578dca9..263d53c0 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -6,6 +6,16 @@ Voraussetzungen wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7. +wallabag nutzt eine große Anzahl an Bibliotheken, um zu funktionieren. Diese Bibliotheken müssen mit einem Tool namens Composer installiert werden. Du musst es installieren sofern du es bisher noch nicht gemacht hast. + +Composer installieren: + +:: + + curl -s http://getcomposer.org/installer | php + +Du kannst eine spezifische Anleitung `hier `__ finden. + Du benötigst die folgenden Extensions damit wallabag funktioniert. Einige von diesen sind vielleicht schon in deiner Version von PHP aktiviert, somit musst du eventuell nicht alle folgenden Pakete installieren. @@ -39,25 +49,13 @@ Installation Auf einem dedizierten Webserver (empfohlener Weg) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -wallabag nutzt eine große Anzahl an Bibliotheken, um zu funktionieren. Diese Bibliotheken müssen mit einem Tool namens Composer installiert werden. Du musst es installieren sofern du es bisher noch nicht gemacht hast. - -Composer installieren: - -:: - - curl -s http://getcomposer.org/installer | php - -Du kannst eine spezifische Anleitung `hier `__ finden. - Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: :: git clone https://github.com/wallabag/wallabag.git cd wallabag - git checkout 2.1.1 --force - SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist - php bin/console wallabag:install --env=prod + ./install.sh Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen: @@ -87,18 +85,18 @@ Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacke wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package -(md5 hash: ``6c33520e29cc754b687f9cee0398dede``) +You will find the `md5 hash of the latest package on our website `_. Jetzt lese die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu. Wenn du die Datenbankkonfiguration eingestellt hast, MySQL oder PostgreSQL zu nutzen, musst du einen Nutzer über das folgende Kommando erstellen ``php bin/console wallabag:install --env=prod``. Installation mit Docker ------------------------- +~~~~~~~~~~~~~~~~~~~~~~ Wir stellen ein Docker Image zu Verfügung, um wallabag einfach zu installieren. Schaue in unser Repository in unserem `Docker Hub `__, um mehr Informationen zu erhalten. Kommando, um den Container zu starten -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. code-block:: bash @@ -108,7 +106,7 @@ Virtualhosts ------------ Konfiguration von Apache -~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~ Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren und du willst PHP als Apache Modul nutzen, dann ist hier ein vhost für wallabag: @@ -198,7 +196,7 @@ Nach dem neuladen oder neustarten von nginx, solltest du nun wallabag unter http Wenn du eine große Datei in wallabag importieren willst, solltest du diese Zeile zu deiner nginx Konfiguration hinzufügen ``client_max_body_size XM; # allows file uploads up to X megabytes``. Konfiguration von lighttpd -~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~ Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren, dann ist hier ein Rezept für wallabag (bearbeite deine ``lighttpd.conf`` und füge die Konfiguration dort ein): -- cgit v1.2.3 From 5334381509990ea5a5351575abf163c3b6c9dc18 Mon Sep 17 00:00:00 2001 From: Strubbl Date: Sat, 8 Oct 2016 20:25:48 +0200 Subject: update German installation.rst --- docs/de/user/installation.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 263d53c0..615f5f28 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -63,7 +63,7 @@ Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installier php bin/console server:run --env=prod -Und wallabag unter http://deineserverip:8000 erreichen +und wallabag unter http://deineserverip:8000 erreichen. .. tip:: @@ -91,7 +91,7 @@ Jetzt lese die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf Wenn du die Datenbankkonfiguration eingestellt hast, MySQL oder PostgreSQL zu nutzen, musst du einen Nutzer über das folgende Kommando erstellen ``php bin/console wallabag:install --env=prod``. Installation mit Docker -~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~ Wir stellen ein Docker Image zu Verfügung, um wallabag einfach zu installieren. Schaue in unser Repository in unserem `Docker Hub `__, um mehr Informationen zu erhalten. @@ -188,11 +188,10 @@ Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installie access_log /var/log/nginx/wallabag_access.log; } -Nach dem neuladen oder neustarten von nginx, solltest du nun wallabag unter http://domain.tld erreichen. +Nach dem Neuladen oder Neustarten von nginx solltest du nun wallabag unter http://domain.tld erreichen. .. tip:: - When you want to import large file into wallabag, you need to add this line in your nginx configuration ``client_max_body_size XM; # allows file uploads up to X megabytes``. Wenn du eine große Datei in wallabag importieren willst, solltest du diese Zeile zu deiner nginx Konfiguration hinzufügen ``client_max_body_size XM; # allows file uploads up to X megabytes``. Konfiguration von lighttpd -- cgit v1.2.3 From 5112b3556b5a85c791cac6ec89c19939e0677904 Mon Sep 17 00:00:00 2001 From: Strubbl Date: Sat, 8 Oct 2016 20:28:18 +0200 Subject: update German installation.rst --- docs/de/user/installation.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 615f5f28..dc2b8b4d 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -85,9 +85,9 @@ Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacke wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package -You will find the `md5 hash of the latest package on our website `_. +Du findest die `md5 Hashsumme des neuesten Pakets auf unserer Website `_. -Jetzt lese die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu. +Jetzt lies die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu. Wenn du die Datenbankkonfiguration eingestellt hast, MySQL oder PostgreSQL zu nutzen, musst du einen Nutzer über das folgende Kommando erstellen ``php bin/console wallabag:install --env=prod``. Installation mit Docker -- cgit v1.2.3 From 84e3c36e02e4ffb4611f6e1eca37c97a0ffb4660 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 10 Oct 2016 09:15:53 +0200 Subject: Added documentation about testsuite Fix #2415 --- docs/de/developer/testsuite.rst | 10 ++++++++++ docs/de/user/installation.rst | 3 +++ 2 files changed, 13 insertions(+) create mode 100644 docs/de/developer/testsuite.rst (limited to 'docs/de') diff --git a/docs/de/developer/testsuite.rst b/docs/de/developer/testsuite.rst new file mode 100644 index 00000000..b2b16cdc --- /dev/null +++ b/docs/de/developer/testsuite.rst @@ -0,0 +1,10 @@ +Testsuite +========= + +To ensure wallabag development quality, we wrote tests with `PHPUnit `_. + +If you contribute to the project (by translating the application, by fixing bugs or by adding a new feature), please write your own tests. + +To launch wallabag testsuite, you need to install `ant `_. + +Then, execute this command ``make test``. diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index dc2b8b4d..bee3249b 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -6,6 +6,9 @@ Voraussetzungen wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7. +.. note:: +Pour installer wallabag facilement, nous avons créé un ``Makefile``, vous avez donc besoin d'avoir installé l'outil ``make``. + wallabag nutzt eine große Anzahl an Bibliotheken, um zu funktionieren. Diese Bibliotheken müssen mit einem Tool namens Composer installiert werden. Du musst es installieren sofern du es bisher noch nicht gemacht hast. Composer installieren: -- cgit v1.2.3 From 7c1225347db8b516cc268709939f6b359bc283c1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 10 Oct 2016 10:20:32 +0200 Subject: Update documentation --- docs/de/user/installation.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index bee3249b..2bb86269 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -57,14 +57,13 @@ Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen: :: git clone https://github.com/wallabag/wallabag.git - cd wallabag - ./install.sh + cd wallabag && make install Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen: :: - php bin/console server:run --env=prod + make run und wallabag unter http://deineserverip:8000 erreichen. -- cgit v1.2.3 From ed11d7f7319dbc3ad9ea8265179f0f32d7d9ef6c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 10 Oct 2016 13:01:14 +0200 Subject: Added page about parameters.yml --- docs/de/user/installation.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 2bb86269..0d082e41 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -7,7 +7,7 @@ Voraussetzungen wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7. .. note:: -Pour installer wallabag facilement, nous avons créé un ``Makefile``, vous avez donc besoin d'avoir installé l'outil ``make``. +To install wallabag easily, we create a ``Makefile``, so you need to have the ``make`` tool. wallabag nutzt eine große Anzahl an Bibliotheken, um zu funktionieren. Diese Bibliotheken müssen mit einem Tool namens Composer installiert werden. Du musst es installieren sofern du es bisher noch nicht gemacht hast. -- cgit v1.2.3 From fa4c39b37c1e1a1b52739a070775e9ba0fafe802 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 10 Oct 2016 15:38:49 +0200 Subject: Added steps about Redis/RabbitMQ activation --- docs/de/developer/rabbitmq.rst | 4 ++++ docs/de/developer/redis.rst | 4 ++++ 2 files changed, 8 insertions(+) (limited to 'docs/de') diff --git a/docs/de/developer/rabbitmq.rst b/docs/de/developer/rabbitmq.rst index 37e9984b..f81e07e3 100644 --- a/docs/de/developer/rabbitmq.rst +++ b/docs/de/developer/rabbitmq.rst @@ -46,6 +46,10 @@ Bearbeite die Datei ``parameters.yml``, um die RabbitMQ Konfiguration einzuricht rabbitmq_user: guest rabbitmq_password: guest +Enable RabbitMQ in wallabag +--------------------------- + +In internal settings, in the **Import** section, enable RabbitMQ (with the value 1). Starte den RabbitMQ Consumer ---------------------------- diff --git a/docs/de/developer/redis.rst b/docs/de/developer/redis.rst index 46334cf0..57b41550 100644 --- a/docs/de/developer/redis.rst +++ b/docs/de/developer/redis.rst @@ -35,6 +35,10 @@ Bearbeite die Datei ``parameters.yml``, um die RabbitMQ Konfiguration einzuricht redis_host: localhost redis_port: 6379 +Enable Redis in wallabag +------------------------ + +In internal settings, in the **Import** section, enable Redis (with the value 1). Starte den Redis Consumer ------------------------- -- cgit v1.2.3 From 36ef9e2730cad290861cca6813370bc87b8f16c9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 10 Oct 2016 18:51:20 +0200 Subject: Fixed display for note in installation page --- docs/de/user/installation.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/installation.rst b/docs/de/user/installation.rst index 0d082e41..35a30f52 100644 --- a/docs/de/user/installation.rst +++ b/docs/de/user/installation.rst @@ -7,7 +7,8 @@ Voraussetzungen wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7. .. note:: -To install wallabag easily, we create a ``Makefile``, so you need to have the ``make`` tool. + + To install wallabag easily, we create a ``Makefile``, so you need to have the ``make`` tool. wallabag nutzt eine große Anzahl an Bibliotheken, um zu funktionieren. Diese Bibliotheken müssen mit einem Tool namens Composer installiert werden. Du musst es installieren sofern du es bisher noch nicht gemacht hast. -- cgit v1.2.3 From b09cafbb3fb928ccb0c6c7cc98e717133e0df560 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Wed, 12 Oct 2016 13:37:50 +0200 Subject: Added french documentation for upgrade --- docs/de/user/upgrade-2.0.x-2.1.1.rst | 65 ++++++++++++++++++++++++++++++++++++ docs/de/user/upgrade-2.0.x-2.1.y.rst | 65 ------------------------------------ 2 files changed, 65 insertions(+), 65 deletions(-) create mode 100644 docs/de/user/upgrade-2.0.x-2.1.1.rst delete mode 100644 docs/de/user/upgrade-2.0.x-2.1.y.rst (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.1.1.rst b/docs/de/user/upgrade-2.0.x-2.1.1.rst new file mode 100644 index 00000000..eee50fe4 --- /dev/null +++ b/docs/de/user/upgrade-2.0.x-2.1.1.rst @@ -0,0 +1,65 @@ +Wallabag updaten +================ + +.. warning:: +Wenn du den Import von Pocket durch das Hinzufügen des Consumer Key in den internen Einstellungen konfiguriert hast, fertige bitte ein Backup deines Keys an, bevor du auf das neue Release migrierst: Du wirst den Key nach dem Update in der Konfiguration erneut eintragen müssen. + +Update auf einem dedizierten Webserver +-------------------------------------- + +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag-Installation auf die neueste Version zu aktualisieren, führe die folgenden Kommandos in deinem wallabag-Ordner aus (ersetze ``2.1.1`` mit der neuesten Releasenummer): + +:: + + rm -rf var/cache/* + git fetch origin + git fetch --tags + git checkout 2.1.1 --force + SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist + php bin/console doctrine:migrations:migrate --env=prod + php bin/console cache:clear --env=prod + +Update auf einem Shared Webhosting +---------------------------------- + +Sichere deine ``app/config/parameters.yml`` Datei. + +Lade das neueste Release von wallabag herunter: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +(2.1.1 md5 hash: ``9584a3b60a2b2a4de87f536548caac93``) + +Entpacke das Archiv in deinen wallabag-Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. + +Bitte beachte, dass wir in dieser Version neue Parameter hinzugefügt haben. Du musst die Datei ``app/config/parameters.yml`` bearbeiten und die folgenden Zeilen hinzufügen (ersetze die Werte mit deiner Konfiguration): + +.. code-block:: bash + + # RabbitMQ processing + rabbitmq_host: localhost + rabbitmq_port: 5672 + rabbitmq_user: guest + rabbitmq_password: guest + + # Redis processing + redis_host: localhost + redis_port: 6379 + +Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. + +Leere den ``var/cache`` Ordner. + +Du musst einige SQL-Abfragen ausführen, um die Datenbank zu aktualisieren. Wir nehmen in diesem Fall an, dass das Tabellenpräfix ``wallabag_`` ist und eine MySQL-Datenbank genutzt wird: + +.. code-block:: sql + + ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); + ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); + INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); + ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; + DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; diff --git a/docs/de/user/upgrade-2.0.x-2.1.y.rst b/docs/de/user/upgrade-2.0.x-2.1.y.rst deleted file mode 100644 index eee50fe4..00000000 --- a/docs/de/user/upgrade-2.0.x-2.1.y.rst +++ /dev/null @@ -1,65 +0,0 @@ -Wallabag updaten -================ - -.. warning:: -Wenn du den Import von Pocket durch das Hinzufügen des Consumer Key in den internen Einstellungen konfiguriert hast, fertige bitte ein Backup deines Keys an, bevor du auf das neue Release migrierst: Du wirst den Key nach dem Update in der Konfiguration erneut eintragen müssen. - -Update auf einem dedizierten Webserver --------------------------------------- - -Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag-Installation auf die neueste Version zu aktualisieren, führe die folgenden Kommandos in deinem wallabag-Ordner aus (ersetze ``2.1.1`` mit der neuesten Releasenummer): - -:: - - rm -rf var/cache/* - git fetch origin - git fetch --tags - git checkout 2.1.1 --force - SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist - php bin/console doctrine:migrations:migrate --env=prod - php bin/console cache:clear --env=prod - -Update auf einem Shared Webhosting ----------------------------------- - -Sichere deine ``app/config/parameters.yml`` Datei. - -Lade das neueste Release von wallabag herunter: - -.. code-block:: bash - - wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package - -(2.1.1 md5 hash: ``9584a3b60a2b2a4de87f536548caac93``) - -Entpacke das Archiv in deinen wallabag-Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. - -Bitte beachte, dass wir in dieser Version neue Parameter hinzugefügt haben. Du musst die Datei ``app/config/parameters.yml`` bearbeiten und die folgenden Zeilen hinzufügen (ersetze die Werte mit deiner Konfiguration): - -.. code-block:: bash - - # RabbitMQ processing - rabbitmq_host: localhost - rabbitmq_port: 5672 - rabbitmq_user: guest - rabbitmq_password: guest - - # Redis processing - redis_host: localhost - redis_port: 6379 - -Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. - -Leere den ``var/cache`` Ordner. - -Du musst einige SQL-Abfragen ausführen, um die Datenbank zu aktualisieren. Wir nehmen in diesem Fall an, dass das Tabellenpräfix ``wallabag_`` ist und eine MySQL-Datenbank genutzt wird: - -.. code-block:: sql - - ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL; - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry'); - ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL; - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import'); - INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import'); - ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL; - DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key'; -- cgit v1.2.3 From 75a1506c276a43f0d3ad65ac1436329e9d5c8c0f Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Wed, 12 Oct 2016 20:33:55 +0200 Subject: translate to German: user/parameters --- docs/de/index.rst | 1 + docs/de/user/parameters.rst | 50 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 51 insertions(+) create mode 100644 docs/de/user/parameters.rst (limited to 'docs/de') diff --git a/docs/de/index.rst b/docs/de/index.rst index b3cd33b0..9ad62013 100644 --- a/docs/de/index.rst +++ b/docs/de/index.rst @@ -44,6 +44,7 @@ Die Dokumentation ist in anderen Sprachen verfügbar : user/filters user/tags user/android + user/parameters .. _dev-docs: diff --git a/docs/de/user/parameters.rst b/docs/de/user/parameters.rst new file mode 100644 index 00000000..4c68fe9e --- /dev/null +++ b/docs/de/user/parameters.rst @@ -0,0 +1,50 @@ +Was bedeuten die Parameter? +=========================== +.. csv-table:: Datenbankparameter + :header: "Name", "Standardwert", "Beschreibung" + + "database_driver", "pdo_sqlite", "Sollte pdo_sqlite oder pdo_mysql oder pdo_pgsql sein" + "database_host", "127.0.0.1", "Hostadresse deiner Datenbank (normalerweise localhost oder 127.0.0.1)" + "database_port", "~", "Port deiner Datenbank (Du kannst ``~`` stehen lassen, um den Standardport zu nutzen)" + "database_name", "symfony", "Benenne deine Datenbank" + "database_user", "root", "Benutzer, der Schreibrecht in der Datenbank hat" + "database_password", "~", "Passwort des Benutzers" + "database_path", "``""%kernel.root_dir%/../data/db/wallabag.sqlite""``", "nur für SQLite, definiere, wo die Datenbankdatei abgelegt werden soll. Lass den Parameter leer für andere Datenbanktypen." + "database_table_prefix", "wallabag_", "alle wallabag Tabellen erhalten diesen Präfix im Namen. Du kannst einen ``_`` dafür im Präfix nutzen, um das zu verdeutlichen." + "database_socket", "null", "Wenn deine Datenbank einen Socket statt TCP nutzt, schreibe hier den Pfad zum Socket hin (andere Verbindungsparameter werden dann ignoriert." + +.. csv-table:: Konfiguration, um mit wallabag E-Mails senden zu können + :header: "Name", "Standardwert", "Beschreibung" + + "mailer_transport", "smtp", "Die exakte Transportmethode, um E-Mails zuzustellen. Gültige Werte sind: smtp, gmail, mail, sendmail, null (was das Mailen deaktivert)" + "mailer_host", "127.0.0.1", "Der Host, zu dem sich verbunden wird, wenn SMTP als Transport genutzt wird." + "mailer_user", "~", "Der Benutzername, wenn SMTP als Transport genutzt wird." + "mailer_password", "~", "Das Passwort, wenn SMTP als Transport genutzt wird." + +.. csv-table:: Andere wallabag Optionen + :header: "Name", "Standardwert", "Beschreibung" + + "locale", "en", "Standardsprache deiner wallabag Instanz (wie z.B. en, fr, es, etc.)" + "secret", "ovmpmAWXRCabNlMgzlzFXDYmCFfzGv", "Dieser String sollte einzigartig für deine Applikation sein und er wird genutzt, um sicherheitsrelevanten Operationen mehr Entropie hinzuzufügen." + "twofactor_auth", "true", "true, um Zwei-Faktor-Authentifizierung zu aktivieren" + "twofactor_sender", "no-reply@wallabag.org", "E-Mail-Adresse des Senders der Mails mit dem Code für die Zwei-Faktor-Authentifizierung" + "fosuser_registration", "true", "true, um die Registrierung für jedermann zu aktivieren" + "fosuser_confirmation", "true", "true, um eine Bestätigungsmail für jede Registrierung zu senden" + "from_email", "no-reply@wallabag.org", "E-Mail-Adresse, die im Absenderfeld jeder Mail genutzt wird" + "rss_limit", "50", "Artikellimit für RSS Feeds" + +.. csv-table:: RabbitMQ Konfiguration + :header: "Name", "Standardwert", "Beschreibung" + + "rabbitmq_host", "localhost", "Host deines RabbitMQ" + "rabbitmq_port", "5672", "Port deines RabbitMQ" + "rabbitmq_user", "guest", "Benutzer, der die Queue lesen kann" + "rabbitmq_password", "guest", "Passwort dieses Benutzers" + +.. csv-table:: Redis Konfiguration + :header: "Name", "Standardwert", "Beschreibung" + + "redis_scheme", "tcp", "Bestimmt das Protokoll, dass genutzt wird, um mit Redis zu kommunizieren. Gültige Werte sind: tcp, unix, http" + "redis_host", "localhost", "IP oder Hostname des Zielservers (ignoriert bei Unix Schema)" + "redis_port", "6379", "TCP/IP Port des Zielservers (ignoriert bei Unix Schema)" + "redis_path", "null", "Pfad zur Unix Domain Socket Datei, wenn Redis Unix Domain Sockets nutzt" -- cgit v1.2.3 From f68e351018287ab1998e803b7b1515235b734efc Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Wed, 12 Oct 2016 20:41:15 +0200 Subject: update German user/upgrade-2.0.x-2.1.1 --- docs/de/user/upgrade-2.0.x-2.1.1.rst | 48 +++++++++++++++++++++++++----------- 1 file changed, 34 insertions(+), 14 deletions(-) (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.1.1.rst b/docs/de/user/upgrade-2.0.x-2.1.1.rst index eee50fe4..e603f596 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.1.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.1.rst @@ -1,5 +1,5 @@ -Wallabag updaten -================ +Wallabag von 2.0.x auf 2.1.1 updaten +==================================== .. warning:: Wenn du den Import von Pocket durch das Hinzufügen des Consumer Key in den internen Einstellungen konfiguriert hast, fertige bitte ein Backup deines Keys an, bevor du auf das neue Release migrierst: Du wirst den Key nach dem Update in der Konfiguration erneut eintragen müssen. @@ -30,23 +30,43 @@ Lade das neueste Release von wallabag herunter: wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package -(2.1.1 md5 hash: ``9584a3b60a2b2a4de87f536548caac93``) +(2.1.1 md5 Hashsumme: ``9584a3b60a2b2a4de87f536548caac93``) Entpacke das Archiv in deinen wallabag-Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. Bitte beachte, dass wir in dieser Version neue Parameter hinzugefügt haben. Du musst die Datei ``app/config/parameters.yml`` bearbeiten und die folgenden Zeilen hinzufügen (ersetze die Werte mit deiner Konfiguration): -.. code-block:: bash - - # RabbitMQ processing - rabbitmq_host: localhost - rabbitmq_port: 5672 - rabbitmq_user: guest - rabbitmq_password: guest - - # Redis processing - redis_host: localhost - redis_port: 6379 +.. code-block:: yml + + parameters: + database_driver: pdo_sqlite + database_host: 127.0.0.1 + database_port: null + database_name: symfony + database_user: root + database_password: null + database_path: '%kernel.root_dir%/../data/db/wallabag.sqlite' + database_table_prefix: wallabag_ + mailer_transport: smtp + mailer_host: 127.0.0.1 + mailer_user: null + mailer_password: null + locale: en + secret: ovmpmAWXRCabNlMgzlzFXDYmCFfzGv + twofactor_auth: true + twofactor_sender: no-reply@wallabag.org + fosuser_registration: true + fosuser_confirmation: true + from_email: no-reply@wallabag.org + rss_limit: 50 + rabbitmq_host: localhost + rabbitmq_port: 5672 + rabbitmq_user: guest + rabbitmq_password: guest + redis_host: localhost + redis_port: 6379 + +Du kannst `hier eine Dokumentation über die Parameter finden`_. Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. -- cgit v1.2.3 From 17064d3c54a26b7ba9ecf2b7fb854a3cf4178915 Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Wed, 12 Oct 2016 20:44:22 +0200 Subject: update German user/upgrade-2.1.x-2.1.y.rst --- docs/de/user/upgrade-2.0.x-2.0.y.rst | 35 ----------------------------------- docs/de/user/upgrade-2.1.x-2.1.y.rst | 35 +++++++++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+), 35 deletions(-) delete mode 100644 docs/de/user/upgrade-2.0.x-2.0.y.rst create mode 100644 docs/de/user/upgrade-2.1.x-2.1.y.rst (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.0.y.rst b/docs/de/user/upgrade-2.0.x-2.0.y.rst deleted file mode 100644 index 5820a0d2..00000000 --- a/docs/de/user/upgrade-2.0.x-2.0.y.rst +++ /dev/null @@ -1,35 +0,0 @@ -Wallabag updaten 2.0.x -> 2.1.x -=============================== - -Update auf einem dedizierten Webserver --------------------------------------- - -Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.0.8`` mit der neuesten Releasenummer): - -:: - - rm -rf var/cache/* - git fetch origin - git fetch --tags - git checkout 2.0.8 - SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist - php bin/console cache:clear --env=prod - -Update auf einem Shared Webhosting ----------------------------------- - -Sichere deine ``app/config/parameters.yml`` Datei. - -Lade das neueste Release von wallabag herunter: - -.. code-block:: bash - - wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package - -(md5 hash: ``4f84c725d1d6e3345eae0a406115e5ff``) - -Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. - -Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. - -Leere den ``var/cache`` Ordner. diff --git a/docs/de/user/upgrade-2.1.x-2.1.y.rst b/docs/de/user/upgrade-2.1.x-2.1.y.rst new file mode 100644 index 00000000..e638ea9b --- /dev/null +++ b/docs/de/user/upgrade-2.1.x-2.1.y.rst @@ -0,0 +1,35 @@ +Wallabag von 2.1.x auf 2.1.y updaten +==================================== + +Update auf einem dedizierten Webserver +-------------------------------------- + +Das neueste Release ist auf https://www.wallabag.org/pages/download-wallabag.html veröffentlicht. Um deine wallabag Installation auf die neueste Version upzudaten, führe die folgenden Kommandos in deinem wallabag Ordner aus (ersetze ``2.1.2`` mit der neuesten Releasenummer): + +:: + + rm -rf var/cache/* + git fetch origin + git fetch --tags + git checkout 2.1.2 --force + SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist + php bin/console cache:clear --env=prod + +Update auf einem Shared Webhosting +---------------------------------- + +Sichere deine ``app/config/parameters.yml`` Datei. + +Lade das neueste Release von wallabag herunter: + +.. code-block:: bash + + wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package + +(md5 Hashsumme von 2.1.1: ``9584a3b60a2b2a4de87f536548caac93``) + +Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. + +Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. + +Leere den ``var/cache`` Ordner. -- cgit v1.2.3 From 83634bab228e2200e51a3c732645517a03bfb32d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Thu, 13 Oct 2016 16:56:03 +0200 Subject: Added missing space --- docs/de/user/upgrade-2.0.x-2.1.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.0.x-2.1.1.rst b/docs/de/user/upgrade-2.0.x-2.1.1.rst index e603f596..db81a1be 100644 --- a/docs/de/user/upgrade-2.0.x-2.1.1.rst +++ b/docs/de/user/upgrade-2.0.x-2.1.1.rst @@ -66,7 +66,7 @@ Bitte beachte, dass wir in dieser Version neue Parameter hinzugefügt haben. Du redis_host: localhost redis_port: 6379 -Du kannst `hier eine Dokumentation über die Parameter finden`_. +Du kannst `hier eine Dokumentation über die Parameter finden `_. Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren. -- cgit v1.2.3 From 8edb250caadbe00bcf3297f5318859e3862d428d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Fri, 14 Oct 2016 14:45:32 +0200 Subject: Added information about tagging rules in documentation Fix #2060 --- docs/de/user/configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/configuration.rst b/docs/de/user/configuration.rst index 67695ff1..4fd6baea 100644 --- a/docs/de/user/configuration.rst +++ b/docs/de/user/configuration.rst @@ -102,7 +102,7 @@ Wenn *readingTime >= 5 AND domainName = "github.com"*, dann tagge als *lange zu Welche Variablen und Operatoren kann ich zum Regeln schreiben nutzen? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Die folgenden Variabel und Operatoren können genutzt werden, um Tagging-Regeln zu erstellen: +Die folgenden Variabel und Operatoren können genutzt werden, um Tagging-Regeln zu erstellen (be careful, for some values, you need to add quotes, for example ``language = "en"``): =========== ============================================== ======== ========== Variable Bedeutung Operator Bedeutung -- cgit v1.2.3 From 68b8e75f9422fd63cde1c60a8ad13afbfc547f2d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Fri, 14 Oct 2016 14:55:45 +0200 Subject: Fixed french and german doc homepages --- docs/de/index.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/de') diff --git a/docs/de/index.rst b/docs/de/index.rst index 9ad62013..a380d7bd 100644 --- a/docs/de/index.rst +++ b/docs/de/index.rst @@ -30,8 +30,8 @@ Die Dokumentation ist in anderen Sprachen verfügbar : user/faq user/installation - user/upgrade-2.0.x-2.1.y - user/upgrade-2.0.x-2.0.y + user/upgrade-2.0.x-2.1.1 + user/upgrade-2.0.x-2.1.1 user/migration user/import user/create_account -- cgit v1.2.3 From 2752053f99420662fb1bf9e4f4ba1be1575ca764 Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Fri, 14 Oct 2016 23:47:37 +0200 Subject: docs/de/user/configuration.rst: German fix for tagging rules docu --- docs/de/user/configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/configuration.rst b/docs/de/user/configuration.rst index 4fd6baea..71627a52 100644 --- a/docs/de/user/configuration.rst +++ b/docs/de/user/configuration.rst @@ -102,7 +102,7 @@ Wenn *readingTime >= 5 AND domainName = "github.com"*, dann tagge als *lange zu Welche Variablen und Operatoren kann ich zum Regeln schreiben nutzen? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Die folgenden Variabel und Operatoren können genutzt werden, um Tagging-Regeln zu erstellen (be careful, for some values, you need to add quotes, for example ``language = "en"``): +Die folgenden Variablen und Operatoren können genutzt werden, um Tagging-Regeln zu erstellen (sei vorsichtig, denn bei einigen Werten muss du Anführungszeichen hinzufügen, z.B. ``language = "de"``): =========== ============================================== ======== ========== Variable Bedeutung Operator Bedeutung -- cgit v1.2.3 From f878902e6a0ec7a92d6c765b5104efa907ead902 Mon Sep 17 00:00:00 2001 From: Sven Fischer Date: Fri, 14 Oct 2016 23:48:50 +0200 Subject: docs/de/user/configuration.rst: German fix for tagging rules docu --- docs/de/user/configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/configuration.rst b/docs/de/user/configuration.rst index 71627a52..0b0793b1 100644 --- a/docs/de/user/configuration.rst +++ b/docs/de/user/configuration.rst @@ -102,7 +102,7 @@ Wenn *readingTime >= 5 AND domainName = "github.com"*, dann tagge als *lange zu Welche Variablen und Operatoren kann ich zum Regeln schreiben nutzen? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Die folgenden Variablen und Operatoren können genutzt werden, um Tagging-Regeln zu erstellen (sei vorsichtig, denn bei einigen Werten muss du Anführungszeichen hinzufügen, z.B. ``language = "de"``): +Die folgenden Variablen und Operatoren können genutzt werden, um Tagging-Regeln zu erstellen (sei vorsichtig, denn bei einigen Werten musst du Anführungszeichen hinzufügen, z.B. ``language = "de"``): =========== ============================================== ======== ========== Variable Bedeutung Operator Bedeutung -- cgit v1.2.3 From 39c3dd30d2138c1a942911762376f4bddbec4cdb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Mon, 17 Oct 2016 11:35:42 +0200 Subject: Removed MD5 hash in documentation --- docs/de/user/upgrade-2.1.x-2.1.y.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/de') diff --git a/docs/de/user/upgrade-2.1.x-2.1.y.rst b/docs/de/user/upgrade-2.1.x-2.1.y.rst index e638ea9b..2f9b7791 100644 --- a/docs/de/user/upgrade-2.1.x-2.1.y.rst +++ b/docs/de/user/upgrade-2.1.x-2.1.y.rst @@ -26,7 +26,7 @@ Lade das neueste Release von wallabag herunter: wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package -(md5 Hashsumme von 2.1.1: ``9584a3b60a2b2a4de87f536548caac93``) +Du findest die `md5 Hashsumme des neuesten Pakets auf unserer Website `_. Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei. -- cgit v1.2.3