From 322c270b6590d0d0bf5025f4782ffe7cdea0f8b0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Tue, 16 May 2017 13:09:40 +0200 Subject: Removed embedded documentation --- docs/de/developer/api.rst | 272 ------------------------------------ docs/de/developer/asynchronous.rst | 159 --------------------- docs/de/developer/docker.rst | 57 -------- docs/de/developer/documentation.rst | 10 -- docs/de/developer/paywall.rst | 56 -------- docs/de/developer/testsuite.rst | 10 -- docs/de/developer/translate.rst | 57 -------- 7 files changed, 621 deletions(-) delete mode 100644 docs/de/developer/api.rst delete mode 100644 docs/de/developer/asynchronous.rst delete mode 100644 docs/de/developer/docker.rst delete mode 100644 docs/de/developer/documentation.rst delete mode 100644 docs/de/developer/paywall.rst delete mode 100644 docs/de/developer/testsuite.rst delete mode 100644 docs/de/developer/translate.rst (limited to 'docs/de/developer') diff --git a/docs/de/developer/api.rst b/docs/de/developer/api.rst deleted file mode 100644 index 7a18afde..00000000 --- a/docs/de/developer/api.rst +++ /dev/null @@ -1,272 +0,0 @@ -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 Dmitriy Bogdanov. -- `.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. -- `Golang wrapper for the wallabag API `_ von Strubbl, für seine Projekte `wallabag-stats Graph `_ und das Kommandozeilentool `wallabag-add-article `_. -- Tool, um automatisiert wallabag Artikel auf den lokalen PC oder ebook reader zu laden `wallabako `_ von anarcat. diff --git a/docs/de/developer/asynchronous.rst b/docs/de/developer/asynchronous.rst deleted file mode 100644 index 742dd3e5..00000000 --- a/docs/de/developer/asynchronous.rst +++ /dev/null @@ -1,159 +0,0 @@ -Asynchrone Aufgaben -=================== - -Um große asynchrone Aufgaben zu starten (etwa für große Importe), können wir RabbitMQ oder Redis nutzen. - -Installation von RabbitMQ für asynchrone Aufgaben -------------------------------------------------- - -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 Start -^^^^^^^^^^^^^^^^^^^^^^^ - -.. 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 - -RabbitMQ für wallabag konfigurieren -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Bearbeite deine ``app/config/parameters.yml``-Datei, um die RabbitMQ-Parameter zu ändern. Die Standardwerte sollten in Ordnung sein: - -.. code:: yaml - - rabbitmq_host: localhost - rabbitmq_port: 5672 - rabbitmq_user: guest - rabbitmq_password: guest - rabbitmq_prefetch_count: 10 # lesen http://www.rabbitmq.com/consumer-prefetch.html - -RabbitMQ in wallabag aktivieren -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -In den internen Einstellungen, aktiviere RabbitMQ im Import-Abschnitt mit dem Wert 1. - -Starte den RabbitMQ-Consumer -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Abhängig davon, über welchen Service du importieren möchtest, musst du den entsprechenden (oder mehrere) Cronjob aktivieren: - -.. code:: bash - - # für den Pocket-Import - bin/console rabbitmq:consumer -e=prod import_pocket -w - - # für den Readability-Import - bin/console rabbitmq:consumer -e=prod import_readability -w - - # für den Instapaper-Import - bin/console rabbitmq:consumer -e=prod import_instapaper -w - - # für den wallabag v1-Import - bin/console rabbitmq:consumer -e=prod import_wallabag_v1 -w - - # für den wallabag v2-Import - bin/console rabbitmq:consumer -e=prod import_wallabag_v2 -w - - # für den Firefox-Import - bin/console rabbitmq:consumer -e=prod import_firefox -w - - # für den Chrome-Import - bin/console rabbitmq:consumer -e=prod import_chrome -w - -Redis für asynchrone Aufgaben installieren ------------------------------------------- - -Um große asynchrone Aufgaben zu starten (etwa für große Importe), können wir auch Redis nutzen. - -Voraussetzungen -^^^^^^^^^^^^^^^ - -Du musst Redis auf deinem Server installiert haben. - -Installation -^^^^^^^^^^^^ - -.. code:: bash - - apt-get install redis-server - -Start -^^^^^ - -Der Server kann bereits nach der Installation laufen, falls nicht, kannst du ihn wie folgt starten: - -.. code:: bash - - redis-server - - -Redis für wallabag konfigurieren -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Bearbeite deine ``app/config/parameters.yml``-Datei, um die Redis-Parameter zu ändern. Die Standardwerte sollten in Ordnung sein: - -.. code:: yaml - - redis_host: localhost - redis_port: 6379 - -Redis in wallabag aktivieren -^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -In den internen Einstellungen, aktiviere Redis im Import-Abschnitt mit dem Wert 1. - -Starten des Redis-Consumer -^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Abhängig davon, über welchen Service du importieren möchtest, musst du den entsprechenden (oder mehrere) Cronjob aktivieren: - -.. code:: bash - - # für den Pocket-Import - bin/console wallabag:import:redis-worker -e=prod pocket -vv >> /path/to/wallabag/var/logs/redis-pocket.log - - # für den Readability-Import - bin/console wallabag:import:redis-worker -e=prod readability -vv >> /path/to/wallabag/var/logs/redis-readability.log - - # für den Instapaper-Import - bin/console wallabag:import:redis-worker -e=prod instapaper -vv >> /path/to/wallabag/var/logs/redis-instapaper.log - - # für den wallabag v1-Import - bin/console wallabag:import:redis-worker -e=prod wallabag_v1 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v1.log - - # für den wallabag v2-Import - bin/console wallabag:import:redis-worker -e=prod wallabag_v2 -vv >> /path/to/wallabag/var/logs/redis-wallabag_v2.log - - # für den Firefox-Import - bin/console wallabag:import:redis-worker -e=prod firefox -vv >> /path/to/wallabag/var/logs/redis-firefox.log - - # für den Chrome-Import - bin/console wallabag:import:redis-worker -e=prod chrome -vv >> /path/to/wallabag/var/logs/redis-chrome.log - -Wenn du den Import nur für einige Artikel nutzen willst, kannst du die Nummer festlegen (hier: 12) und der Consumer wird nach dem zwölften Artikel aufhören: - -.. code:: bash - - bin/console wallabag:import:redis-worker -e=prod pocket -vv --maxIterations=12 diff --git a/docs/de/developer/docker.rst b/docs/de/developer/docker.rst deleted file mode 100644 index 9948fe8c..00000000 --- a/docs/de/developer/docker.rst +++ /dev/null @@ -1,57 +0,0 @@ -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 bin/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 deleted file mode 100644 index 41e19363..00000000 --- a/docs/de/developer/documentation.rst +++ /dev/null @@ -1,10 +0,0 @@ -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/paywall.rst b/docs/de/developer/paywall.rst deleted file mode 100644 index 365027b4..00000000 --- a/docs/de/developer/paywall.rst +++ /dev/null @@ -1,56 +0,0 @@ -Articles behind a paywall -========================= - -wallabag can fetch articles from websites which use a paywall system. - -Enable paywall authentication ------------------------------ - -In internal settings, in the **Article** section, enable authentication for websites with paywall (with the value 1). - -Configure credentials in wallabag ---------------------------------- - -Edit your ``app/config/parameters.yml`` file to edit credentials for each website with paywall. Here is an example for some french websites: - -.. code:: yaml - - sites_credentials: - mediapart.fr: {username: "myMediapartLogin", password: "mypassword"} - arretsurimages.net: {username: "myASILogin", password: "mypassword"} - -.. note:: - - These credentials will be shared between each user of your wallabag instance. - -Parsing configuration files ---------------------------- - -.. note:: - - Read `this part of the documentation `_ to understand the configuration files. - -Each parsing configuration file needs to be improved by adding ``requires_login``, ``login_uri``, -``login_username_field``, ``login_password_field`` and ``not_logged_in_xpath``. - -Be careful, the login form must be in the page content when wallabag loads it. It's impossible for wallabag to be authenticated -on a website where the login form is loaded after the page (by ajax for example). - -``login_uri`` is the action URL of the form (``action`` attribute in the form). -``login_username_field`` is the ``name`` attribute of the login field. -``login_password_field`` is the ``name`` attribute of the password field. - -For example: - -.. code:: - - title://div[@id="titrage-contenu"]/h1[@class="title"] - body: //div[@class="contenu-html"]/div[@class="page-pane"] - - requires_login: yes - - login_uri: http://www.arretsurimages.net/forum/login.php - login_username_field: username - login_password_field: password - - not_logged_in_xpath: //body[@class="not-logged-in"] diff --git a/docs/de/developer/testsuite.rst b/docs/de/developer/testsuite.rst deleted file mode 100644 index b2b16cdc..00000000 --- a/docs/de/developer/testsuite.rst +++ /dev/null @@ -1,10 +0,0 @@ -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/developer/translate.rst b/docs/de/developer/translate.rst deleted file mode 100644 index 10544e31..00000000 --- a/docs/de/developer/translate.rst +++ /dev/null @@ -1,57 +0,0 @@ -Ü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/src/Wallabag/UserBundle/Resources/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. -- cgit v1.2.3