aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorJeremy Benoist <j0k3r@users.noreply.github.com>2016-06-16 06:50:21 +0200
committerGitHub <noreply@github.com>2016-06-16 06:50:21 +0200
commit77c530f43c8d0efd72c12e0b723982a5377c5bc9 (patch)
treee24c7363a795905dc66213e23d75f8345c342a3c
parentd220a951218149132189dbbdb149236d3701022f (diff)
parent429480357f93f54c04108202efb35e33dcc0f832 (diff)
downloadwallabag-77c530f43c8d0efd72c12e0b723982a5377c5bc9.tar.gz
wallabag-77c530f43c8d0efd72c12e0b723982a5377c5bc9.tar.zst
wallabag-77c530f43c8d0efd72c12e0b723982a5377c5bc9.zip
Merge pull request #2148 from wallabag/start-german-docu
translate documentation to German
-rw-r--r--docs/de/developer/api.rst270
-rw-r--r--docs/de/developer/docker.rst57
-rw-r--r--docs/de/developer/documentation.rst10
-rw-r--r--docs/de/developer/maintenance.rst32
-rw-r--r--docs/de/developer/translate.rst57
-rw-r--r--docs/de/index.rst52
-rw-r--r--docs/de/user/android.rst107
-rw-r--r--docs/de/user/annotations.rst24
-rw-r--r--docs/de/user/configuration.rst119
-rw-r--r--docs/de/user/create_account.rst25
-rw-r--r--docs/de/user/download_articles.rst17
-rw-r--r--docs/de/user/errors_during_fetching.rst28
-rw-r--r--docs/de/user/faq.rst45
-rw-r--r--docs/de/user/filters.rst49
-rw-r--r--docs/de/user/first_article.rst68
-rw-r--r--docs/de/user/import.rst46
-rw-r--r--docs/de/user/installation.rst326
-rw-r--r--docs/de/user/login.rst13
-rw-r--r--docs/de/user/migration.rst62
-rw-r--r--docs/de/user/tags.rst2
-rw-r--r--docs/de/user/upgrade.rst32
-rw-r--r--docs/en/user/configuration.rst2
-rw-r--r--docs/fr/user/configuration.rst2
23 files changed, 1443 insertions, 2 deletions
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 @@
1API DoKumentation
2=================
3
4Dank dieser Dokumentation werden wir sehen, wie wir mit der wallabag API interagieren.
5
6Voraussetzungen
7---------------
8
9* wallabag frisch (oder nicht) installiert auf http://localhost:8000
10* ``httpie`` installiert auf deinem Computer (`siehe Projektwebsite <https://github.com/jkbrzt/httpie>`__). Beachte, dass du die Kommandos auch mit curl oder wget nutzen kannst.
11* alle API Methoden sind hier dokumentiert http://localhost:8000/api/doc
12
13Einen neuen API Client erstellen
14--------------------------------
15
16In deinem wallabag Account, kannst du einen neuen API Client unter dieser URL http://localhost:8000/developer/client/create erstellen.
17
18Gib 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.
19
20Du bekommst Informationen wie diese:
21
22::
23
24 Client ID:
25
26 1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc
27
28 Client secret:
29
30 636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4
31
32
33Einen Aktualisierungstoken erhalten
34-----------------------------------
35
36Fü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):
37
38::
39
40 http POST http://localhost:8000/oauth/v2/token \
41 grant_type=password \
42 client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc \
43 client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4 \
44 username=wallabag \
45 password=wallabag
46
47Du bekommst folgendes zurück:
48
49::
50
51 HTTP/1.1 200 OK
52 Cache-Control: no-store, private
53 Connection: close
54 Content-Type: application/json
55 Date: Tue, 05 Apr 2016 08:44:33 GMT
56 Host: localhost:8000
57 Pragma: no-cache
58 X-Debug-Token: 19c8e0
59 X-Debug-Token-Link: /_profiler/19c8e0
60 X-Powered-By: PHP/7.0.4
61
62 {
63 "access_token": "ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA",
64 "expires_in": 3600,
65 "refresh_token": "OTNlZGE5OTJjNWQwYzc2NDI5ZGE5MDg3ZTNjNmNkYTY0ZWZhZDVhNDBkZTc1ZTNiMmQ0MjQ0OThlNTFjNTQyMQ",
66 "scope": null,
67 "token_type": "bearer"
68 }
69
70Wir werden mit dem ``access_token`` Wert in unseren nächsten Aufrufen arbeiten.
71
72cURL Beispiel:
73
74::
75
76 curl -s "https://localhost:8000/oauth/v2/token?grant_type=password&client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc&client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4&username=wallabag&password=wallabag"
77
78Existierende Einträge erhalten
79------------------------------
80
81Dokumentation für diese Methode: http://localhost:8000/api/doc#get--api-entries.{_format}
82
83Da wir auf einer neuen wallabag Installation arbeiten, bekommen wir keine Ergebnisse mit diesem Kommando:
84
85::
86
87 http GET http://localhost:8000/api/entries.json \
88 "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA"
89
90gibt zurück:
91
92::
93
94 HTTP/1.1 200 OK
95 0: application/json
96 Cache-Control: no-cache
97 Connection: close
98 Content-Type: application/json
99 Date: Tue, 05 Apr 2016 08:51:32 GMT
100 Host: localhost:8000
101 Set-Cookie: PHPSESSID=nrogm748md610ovhu6j70c3q63; path=/; HttpOnly
102 X-Debug-Token: 4fbbc4
103 X-Debug-Token-Link: /_profiler/4fbbc4
104 X-Powered-By: PHP/7.0.4
105
106 {
107 "_embedded": {
108 "items": []
109 },
110 "_links": {
111 "first": {
112 "href": "http://localhost:8000/api/entries?page=1&perPage=30"
113 },
114 "last": {
115 "href": "http://localhost:8000/api/entries?page=1&perPage=30"
116 },
117 "self": {
118 "href": "http://localhost:8000/api/entries?page=1&perPage=30"
119 }
120 },
121 "limit": 30,
122 "page": 1,
123 "pages": 1,
124 "total": 0
125 }
126
127Das Array ``items`` ist leer.
128
129cURL Beispiel:
130
131::
132
133 curl --get "https://localhost:8000/api/entries.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA"
134
135Deinen ersten Eintrag hinzufügen
136--------------------------------
137
138Dokumentation für diese Methode: http://localhost:8000/api/doc#post--api-entries.{_format}
139
140::
141
142 http POST http://localhost:8000/api/entries.json \
143 "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" \
144 url="http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html"
145
146gibt zurück:
147
148::
149
150 HTTP/1.1 200 OK
151 0: application/json
152 Cache-Control: no-cache
153 Connection: close
154 Content-Type: application/json
155 Date: Tue, 05 Apr 2016 09:07:54 GMT
156 Host: localhost:8000
157 Set-Cookie: PHPSESSID=bjie40ck72kp2pst3i71gf43a4; path=/; HttpOnly
158 X-Debug-Token: e01c51
159 X-Debug-Token-Link: /_profiler/e01c51
160 X-Powered-By: PHP/7.0.4
161
162 {
163 "_links": {
164 "self": {
165 "href": "/api/entries/1"
166 }
167 },
168 "content": "<p class=\"chapo\">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.</p><p>Si vous utilisez Firefox comme navigateur web, vous avez peut-être constaté l’arrivée d’<a href=\"http://www.numerama.com/magazine/33292-update-firefox.html\">une fonctionnalité intitulée Pocket</a>. 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.</p>\n<p>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.</p>\n<p>Mais <a href=\"https://en.wikipedia.org/wiki/Pocket_%28application%29#Firefox_integration\" target=\"_blank\">Pocket fait polémique</a>, 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 <strong>Wallabag</strong>, qui est l’équivalent libre de Pocket et d’autres systèmes du même genre, comme Instapaper et Readability.</p>\n<p>Et justement, Wallabag évolue. C’est ce dimanche que la <a href=\"https://www.wallabag.org/blog/2016/04/03/wallabag-v2\" target=\"_blank\">version 2.0.0 du logiciel</a> 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 <a href=\"http://doc.wallabag.org/fr/v2/\" target=\"_blank\">documentation est traduite</a> en français), lui permettant d’apparaître comme une alternative à Pocket, Instapaper et Readability.</p>\n<p><img class=\"aligncenter size-medium wp-image-160439\" src=\"http://www.numerama.com/content/uploads/2016/04/homepage-680x347.png\" alt=\"homepage\" width=\"680\" height=\"347\" srcset=\"//www.numerama.com/content/uploads/2016/04/homepage-680x347.png 680w, //www.numerama.com/content/uploads/2016/04/homepage-1024x523.png 1024w, //www.numerama.com/content/uploads/2016/04/homepage-270x138.png 270w, //www.numerama.com/content/uploads/2016/04/homepage.png 1286w\" sizes=\"(max-width: 680px) 100vw, 680px\"/></p>\n<p>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.</p>\n<p>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.</p>\n \n \n <footer class=\"clearfix\" readability=\"1\"><p class=\"source\">\n Crédit photo de la une : <a href=\"https://www.flickr.com/photos/bookgrl/2388310523/\">Laura Taylor</a>\n </p>\n \n <p><a href=\"http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html?&amp;show_reader_reports\" target=\"_blank\" rel=\"nofollow\">Signaler une erreur dans le texte</a></p>\n \n</footer> <section class=\"related-article\"><header><h3>Articles liés</h3>\n </header><article class=\"post-grid format-article\"><a class=\"floatleft\" href=\"http://www.numerama.com/magazine/34444-firefox-prepare-l-enterrement-des-vieux-plugins.html\" title=\"Firefox prépare l'enterrement des vieux plugins\">\n <div class=\"cover-preview cover-tech\">\n <p>Lire</p>\n \n \n \n <img class=\"cover-preview_img\" src=\"http://c2.lestechnophiles.com/www.numerama.com/content/uploads/2015/10/cimetierecolleville.jpg?resize=200,135\" srcset=\"&#10; //c2.lestechnophiles.com/www.numerama.com/content/uploads/2015/10/cimetierecolleville.jpg?resize=200,135 200w,&#10; //c2.lestechnophiles.com/www.numerama.com/content/uploads/2015/10/cimetierecolleville.jpg?resize=100,67 100w,&#10; \" sizes=\"(min-width: 1001px) 200px, (max-width: 1000px) 100px\" alt=\"Firefox prépare l'enterrement des vieux plugins\"/></div>\n <h4> Firefox prépare l'enterrement des vieux plugins </h4>\n </a>\n <footer class=\"span12\">\n </footer></article><article class=\"post-grid format-article\"><a class=\"floatleft\" href=\"http://www.numerama.com/tech/131636-activer-navigation-privee-navigateur-web.html\" title=\"Comment activer la navigation privée sur son navigateur web\">\n <div class=\"cover-preview cover-tech\">\n <p>Lire</p>\n \n \n \n <img class=\"cover-preview_img\" src=\"http://c1.lestechnophiles.com/www.numerama.com/content/uploads/2015/11/Incognito.jpg?resize=200,135\" srcset=\"&#10; //c1.lestechnophiles.com/www.numerama.com/content/uploads/2015/11/Incognito.jpg?resize=200,135 200w,&#10; //c1.lestechnophiles.com/www.numerama.com/content/uploads/2015/11/Incognito.jpg?resize=100,67 100w,&#10; \" sizes=\"(min-width: 1001px) 200px, (max-width: 1000px) 100px\" alt=\"Comment activer la navigation privée sur son navigateur web\"/></div>\n <h4> Comment activer la navigation privée sur son navigateur web </h4>\n </a>\n <footer class=\"span12\">\n </footer></article><article class=\"post-grid format-article\"><a class=\"floatleft\" href=\"http://www.numerama.com/tech/144028-firefox-se-mettra-a-jour-regulierement.html\" title=\"Firefox se mettra à jour un peu moins régulièrement\">\n <div class=\"cover-preview cover-tech\">\n <p>Lire</p>\n \n \n \n <img class=\"cover-preview_img\" src=\"http://c0.lestechnophiles.com/www.numerama.com/content/uploads/2016/02/firefox-mobile.jpg?resize=200,135\" srcset=\"&#10; //c0.lestechnophiles.com/www.numerama.com/content/uploads/2016/02/firefox-mobile.jpg?resize=200,135 200w,&#10; //c0.lestechnophiles.com/www.numerama.com/content/uploads/2016/02/firefox-mobile.jpg?resize=100,67 100w,&#10; \" sizes=\"(min-width: 1001px) 200px, (max-width: 1000px) 100px\" alt=\"Firefox se mettra à jour un peu moins régulièrement\"/></div>\n <h4> Firefox se mettra à jour un peu moins régulièrement </h4>\n </a>\n <footer class=\"span12\">\n </footer></article>\n</section>\n",
169 "created_at": "2016-04-05T09:07:54+0000",
170 "domain_name": "www.numerama.com",
171 "id": 1,
172 "is_archived": 0,
173 "is_starred": 0,
174 "language": "fr-FR",
175 "mimetype": "text/html",
176 "preview_picture": "http://www.numerama.com/content/uploads/2016/04/post-it.jpg",
177 "reading_time": 2,
178 "tags": [],
179 "title": "Le Pocket libre Wallabag fait le plein de fonctionnalités - Tech - Numerama",
180 "updated_at": "2016-04-05T09:07:54+0000",
181 "url": "http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html",
182 "user_email": "",
183 "user_id": 1,
184 "user_name": "wallabag"
185 }
186
187Wenn du jetzt das vorherige Kommando (siehe **Existierende Einträge erhalten**), wirst du Daten erhalten.
188
189cURL Beispiel:
190
191::
192
193 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"
194
195Eintrag löschen
196-----------------
197
198Dokumentation für diese Methode: http://localhost:8000/api/doc#delete--api-entries-{entry}.{_format}
199
200::
201
202 http DELETE http://localhost:8000/api/entries/1.json \
203 "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA"
204
205gibt zurück:
206
207::
208
209 HTTP/1.1 200 OK
210 0: application/json
211 Cache-Control: no-cache
212 Connection: close
213 Content-Type: application/json
214 Date: Tue, 05 Apr 2016 09:19:07 GMT
215 Host: localhost:8000
216 Set-Cookie: PHPSESSID=jopgnfvmuc9a62b27sqm6iulr6; path=/; HttpOnly
217 X-Debug-Token: 887cef
218 X-Debug-Token-Link: /_profiler/887cef
219 X-Powered-By: PHP/7.0.4
220
221 {
222 "_links": {
223 "self": {
224 "href": "/api/entries/"
225 }
226 },
227 "annotations": [],
228 "content": "<p class=\"chapo\">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.</p><p>Si vous utilisez Firefox comme navigateur web, vous avez peut-être constaté l’arrivée d’<a href=\"http://www.numerama.com/magazine/33292-update-firefox.html\">une fonctionnalité intitulée Pocket</a>. 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.</p>\n<p>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.</p>\n<p>Mais <a href=\"https://en.wikipedia.org/wiki/Pocket_%28application%29#Firefox_integration\" target=\"_blank\">Pocket fait polémique</a>, 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 <strong>Wallabag</strong>, qui est l’équivalent libre de Pocket et d’autres systèmes du même genre, comme Instapaper et Readability.</p>\n<p>Et justement, Wallabag évolue. C’est ce dimanche que la <a href=\"https://www.wallabag.org/blog/2016/04/03/wallabag-v2\" target=\"_blank\">version 2.0.0 du logiciel</a> 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 <a href=\"http://doc.wallabag.org/fr/v2/\" target=\"_blank\">documentation est traduite</a> en français), lui permettant d’apparaître comme une alternative à Pocket, Instapaper et Readability.</p>\n<p><img class=\"aligncenter size-medium wp-image-160439\" src=\"http://www.numerama.com/content/uploads/2016/04/homepage-680x347.png\" alt=\"homepage\" width=\"680\" height=\"347\" srcset=\"//www.numerama.com/content/uploads/2016/04/homepage-680x347.png 680w, //www.numerama.com/content/uploads/2016/04/homepage-1024x523.png 1024w, //www.numerama.com/content/uploads/2016/04/homepage-270x138.png 270w, //www.numerama.com/content/uploads/2016/04/homepage.png 1286w\" sizes=\"(max-width: 680px) 100vw, 680px\"/></p>\n<p>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.</p>\n<p>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.</p>\n \n \n <footer class=\"clearfix\" readability=\"1\"><p class=\"source\">\n Crédit photo de la une : <a href=\"https://www.flickr.com/photos/bookgrl/2388310523/\">Laura Taylor</a>\n </p>\n \n <p><a href=\"http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html?&amp;show_reader_reports\" target=\"_blank\" rel=\"nofollow\">Signaler une erreur dans le texte</a></p>\n \n</footer> <section class=\"related-article\"><header><h3>Articles liés</h3>\n </header><article class=\"post-grid format-article\"><a class=\"floatleft\" href=\"http://www.numerama.com/magazine/34444-firefox-prepare-l-enterrement-des-vieux-plugins.html\" title=\"Firefox prépare l'enterrement des vieux plugins\">\n <div class=\"cover-preview cover-tech\">\n <p>Lire</p>\n \n \n \n <img class=\"cover-preview_img\" src=\"http://c2.lestechnophiles.com/www.numerama.com/content/uploads/2015/10/cimetierecolleville.jpg?resize=200,135\" srcset=\"&#10; //c2.lestechnophiles.com/www.numerama.com/content/uploads/2015/10/cimetierecolleville.jpg?resize=200,135 200w,&#10; //c2.lestechnophiles.com/www.numerama.com/content/uploads/2015/10/cimetierecolleville.jpg?resize=100,67 100w,&#10; \" sizes=\"(min-width: 1001px) 200px, (max-width: 1000px) 100px\" alt=\"Firefox prépare l'enterrement des vieux plugins\"/></div>\n <h4> Firefox prépare l'enterrement des vieux plugins </h4>\n </a>\n <footer class=\"span12\">\n </footer></article><article class=\"post-grid format-article\"><a class=\"floatleft\" href=\"http://www.numerama.com/tech/131636-activer-navigation-privee-navigateur-web.html\" title=\"Comment activer la navigation privée sur son navigateur web\">\n <div class=\"cover-preview cover-tech\">\n <p>Lire</p>\n \n \n \n <img class=\"cover-preview_img\" src=\"http://c1.lestechnophiles.com/www.numerama.com/content/uploads/2015/11/Incognito.jpg?resize=200,135\" srcset=\"&#10; //c1.lestechnophiles.com/www.numerama.com/content/uploads/2015/11/Incognito.jpg?resize=200,135 200w,&#10; //c1.lestechnophiles.com/www.numerama.com/content/uploads/2015/11/Incognito.jpg?resize=100,67 100w,&#10; \" sizes=\"(min-width: 1001px) 200px, (max-width: 1000px) 100px\" alt=\"Comment activer la navigation privée sur son navigateur web\"/></div>\n <h4> Comment activer la navigation privée sur son navigateur web </h4>\n </a>\n <footer class=\"span12\">\n </footer></article><article class=\"post-grid format-article\"><a class=\"floatleft\" href=\"http://www.numerama.com/tech/144028-firefox-se-mettra-a-jour-regulierement.html\" title=\"Firefox se mettra à jour un peu moins régulièrement\">\n <div class=\"cover-preview cover-tech\">\n <p>Lire</p>\n \n \n \n <img class=\"cover-preview_img\" src=\"http://c0.lestechnophiles.com/www.numerama.com/content/uploads/2016/02/firefox-mobile.jpg?resize=200,135\" srcset=\"&#10; //c0.lestechnophiles.com/www.numerama.com/content/uploads/2016/02/firefox-mobile.jpg?resize=200,135 200w,&#10; //c0.lestechnophiles.com/www.numerama.com/content/uploads/2016/02/firefox-mobile.jpg?resize=100,67 100w,&#10; \" sizes=\"(min-width: 1001px) 200px, (max-width: 1000px) 100px\" alt=\"Firefox se mettra à jour un peu moins régulièrement\"/></div>\n <h4> Firefox se mettra à jour un peu moins régulièrement </h4>\n </a>\n <footer class=\"span12\">\n </footer></article>\n</section>\n",
229 "created_at": "2016-04-05T09:07:54+0000",
230 "domain_name": "www.numerama.com",
231 "is_archived": 0,
232 "is_starred": 0,
233 "language": "fr-FR",
234 "mimetype": "text/html",
235 "preview_picture": "http://www.numerama.com/content/uploads/2016/04/post-it.jpg",
236 "reading_time": 2,
237 "tags": [],
238 "title": "Le Pocket libre Wallabag fait le plein de fonctionnalités - Tech - Numerama",
239 "updated_at": "2016-04-05T09:07:54+0000",
240 "url": "http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html",
241 "user_email": "",
242 "user_id": 1,
243 "user_name": "wallabag"
244 }
245
246Und wenn du die existierenden Einträge nun listen willst (siehe **Existierende Einträge erhalten**), ist das Array wieder leer.
247
248cURL Beispiel:
249
250::
251
252 curl --request DELETE "https://localhost:8000/api/entries/1.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA"
253
254Andere Methoden
255---------------
256
257Wir werden nicht für jede API Methode Beispiele schreiben.
258
259Wirf einen Blick in die Liste http://localhost:8000/api/doc, um alle Methode kennenzulernen.
260
261
262Drittanbieter Ressourcen
263------------------------
264
265Einige Applikationen oder Bibliotheken nutzen unsere API. Hier ist eine nicht abschließende Aufzählung von ihnen:
266
267- `Java wrapper for the wallabag API <https://github.com/Strubbl/wallabag-java>`_ von Strubbl.
268- `.NET library for the wallabag v2 API <https://github.com/jlnostr/wallabag-api>`_ von Julian Oster.
269- `Python API for wallabag <https://github.com/foxmask/wallabag_api>`_ von FoxMaSk, für sein Projekt `Trigger Happy <https://blog.trigger-happy.eu/>`_.
270- `A plugin <https://github.com/joshp23/ttrss-to-wallabag-v2>`_ entworfen für `Tiny Tiny RSS <https://tt-rss.org/gitlab/fox/tt-rss/wikis/home>`_, 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 @@
1Lasse wallabag in docker-compose laufen
2=======================================
3
4Um deine eigene Entwicklungsinstanz von wallabag laufen zu lassen,
5möchtest du vielleicht die vorkonfigurierten docker compose Dateien
6nutzen.
7
8Voraussetzungen
9---------------
10
11Stelle sicher `Docker
12<https://docs.docker.com/installation/ubuntulinux/>`__ und `Docker
13Compose <https://docs.docker.com/compose/install/>`__ auf deinem
14System verfügbar und aktuell zu haben.
15
16Wechsel des DBMS
17----------------
18
19Standardmäßig startet wallabag mit einer SQLite Datenbank.
20Da wallabag Unterstützung für Postgresql und MySQL bietet, gibt es
21auch docker Container für diese.
22
23In der ``docker-compose.yml`` kommentierst du für das gewählte DBMS
24aus:
25
26- die Container Definition (``postgres`` oder ``mariadb`` root
27 Level Block)
28- den Container Link in dem ``php`` Container
29- die Container Umgebungsdatei in dem ``php`` Container
30
31Um mit Symfony Kommandos auf deinem Host auszuführen (wie z.B.
32``wallabag:install``), sollst du außerdem:
33
34- die richtige Umgebungsdatei auf deiner Kommandozeile einlesen,
35 sodass Variablen wie ``SYMFONY__ENV__DATABASE_HOST`` existieren
36- eine Zeile ``127.0.0.1 rdbms`` in deiner ``hosts`` Datei auf dem
37 System erstellen
38
39wallabag laufen lassen
40----------------------
41
42#. Forke und klone das Projekt
43#. Bearbeite ``app/config/parameters.yml`` um ``database_*``
44 Eigenschaften mit den kommentierten zu ersetzen (mit Werten
45 mit ``env.`` Präfix)
46#. ``composer install`` die Projektabhängigkeiten
47#. ``php app/console wallabag:install``, um das Schema zu erstellen
48#. ``docker-compose up`` um die Container laufen zu lassen
49#. Schließlich öffne http://localhost:8080/, um dein frisch
50 installiertes wallabag zu finden.
51
52In den verschiedenen Schritten wirst du vielleicht in verschiendene
53Probleme laufen wie UNIX Berechtigungsprobleme, falschen Pfaden im
54generierten Cache, etc.…
55Operationen wie das Löschen der Cachedateien oder das Ändern der
56Dateibesitzer können öfter gebraucht werden, darum habe keine Angst
57sie 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 @@
1Wirke an dieser Dokumentation mit
2=================================
3
4Quellen der Dokumentation sind hier zu finden https://github.com/wallabag/wallabag/tree/master/docs
5
6Wir nutzen `ReadTheDocs <https://readthedocs.org>`__, um sie zu generieren.
7
8Seiten werden in `reStructuredText <https://de.wikipedia.org/wiki/ReStructuredText>`__ geschrieben. Du kannst Onlinetools wie http://rst.aaroniles.net/ oder http://rst.ninjs.org/ nutzen, um eine Vorschau deiner Artikel zu betrachten.
9
10Wenn du eine neue Seite erstellst, vergiss nicht die `index.rst <https://raw.githubusercontent.com/wallabag/wallabag/master/docs/en/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 @@
1Wartungsmodus
2=============
3
4Wenn du längere Aufgaben auf deiner wallabag Instanz ausführen willst, kannst du den Wartungsmodus aktivieren.
5Keiner wird dann Zugang zu deiner Instanz haben.
6
7Aktivieren des Wartungsmodus
8----------------------------
9
10Um den Wartungsmodus zu aktivieren, führe folgendes Kommando aus:
11
12::
13
14 bin/console lexik:maintenance:lock --no-interaction
15
16Du 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:
17
18::
19
20 lexik_maintenance:
21 authorized:
22 ips: ['127.0.0.1']
23
24
25Deaktivieren des Wartungsmodus
26------------------------
27
28Um den Wartungsmodus zu deaktivieren, führe dieses Kommando aus:
29
30::
31
32 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 @@
1Übersetze wallabag
2==================
3
4wallabag Webapplikation
5-----------------------
6
7Übersetzungsdateien
8~~~~~~~~~~~~~~~~~~~
9
10.. note::
11
12 Da wallabag hauptsächlich von einem französischem Team entwickelt wird, betrachte
13 die französische Übersetzung als die aktuellste und kopiere sie, um deine eigene Übersetzung zu starten.
14
15Du kannst die Übersetzungsdateien hier finden: https://github.com/wallabag/wallabag/tree/master/src/Wallabag/CoreBundle/Resources/translations.
16
17Du musst die ``messages.CODE.yml`` und ``validators.CODE.yml`` erstellen, wobei CODE
18der ISO 639-1 Code deiner Sprache ist (`siehe Wikipedia <https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes>`__).
19
20Andere Dateien zum Übersetzen:
21
22- https://github.com/wallabag/wallabag/tree/master/app/Resources/CraueConfigBundle/translations.
23- https://github.com/wallabag/wallabag/tree/master/app/Resources/FOSUserBundle/translations.
24
25Du musst die ``THE_TRANSLATION_FILE.CODE.yml`` Dateien erstellen.
26
27Konfigurationsdatei
28~~~~~~~~~~~~~~~~~~~
29
30Du musst die `app/config/config.yml <https://github.com/wallabag/wallabag/blob/master/app/config/config.yml>`__ bearbeiten,
31um deine Sprache auf der Konfigurationsseite in wallabag anzuzeigen (um Nutzern zu erlauben zu dieser neuen Übersetzung zu wechseln).
32
33Unter dem Abschnitt ``wallabag_core.languages`` musst du eine neue Zeile mit deiner Übersetzung hinzufügen. Zum Beispiel:
34
35::
36
37 wallabag_core:
38 ...
39 languages:
40 en: 'English'
41 fr: 'Français'
42
43
44Für die erste Spalte (``en``, ``fr``, etc.) musst du den ISO 639-1 Code deiner Sprache hinzufügen (siehe oben).
45
46Für die zweite Spalte trägst du den Namen deiner Sprache ein. Nur den.
47
48wallabag Dokumentation
49----------------------
50
51.. note::
52
53 Im Gegensatz zur Webapplikation ist die Hauptsprache für die Dokumentation Englisch.
54
55Documentationsdateien sind hier gespeichert: https://github.com/wallabag/wallabag/tree/master/docs
56
57Du 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 @@
1wallabag Dokumentation
2======================
3
4.. image:: ../img/wallabag.png
5 :alt: wallabag Logo
6 :align: center
7
8**wallabag** ist eine Read-it-later Applikation: es speichert Websites,
9indem es nur den Inhalt behält. Elemente wie Navigation oder Werbung werden gelöscht.
10
11.. tip::
12
13 Diese Dokumentation ist über wallabag v2. Wenn du die Dokumentation für wallabag v1 lesen willst, `siehe dir bitte das hier an <https://github.com/wallabag/documentation>`__.
14
15Die Hauptdokumentation für diese Applikation ist in einigen Abschnitten organisiert:
16
17* :ref:`user-docs`
18* :ref:`dev-docs`
19
20.. _user-docs:
21
22.. toctree::
23 :maxdepth: 2
24 :caption: Nutzerdokumentation
25
26 user/faq
27 user/installation
28 user/upgrade
29 user/migration
30 user/import
31 user/create_account
32 user/login
33 user/configuration
34 user/first_article
35 user/errors_during_fetching
36 user/annotations
37 user/download_articles
38 user/filters
39 user/tags
40 user/android
41
42.. _dev-docs:
43
44.. toctree::
45 :maxdepth: 2
46 :caption: Entwicklerdokumentation
47
48 developer/api
49 developer/docker
50 developer/documentation
51 developer/translate
52 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 @@
1Android App
2===========
3
4
5Zweck dieses Dokuments
6----------------------
7
8Dieses 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.
9
10
11Schritte, um dein App zu einzurichten
12-------------------------------------
13
14Wenn du das erste Mal die App startest, siehst du den Willkommensbildschirm, wo du angewiesen wirst zunächst deine App mit deiner Wallabaginstanz einzurichten.
15
16.. image:: ../../img/user/android_welcome_screen.de.png
17 :alt: Willkommensbildschirm
18 :align: center
19
20Bestätige nur diese Nachricht und du wirst zum Einstellungsbildschirm weitergeleitet.
21
22.. image:: ../../img/user/android_configuration_screen.de.png
23 :alt: Einstellungsbildschirm
24 :align: center
25
26Trage 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.
27
28.. image:: ../../img/user/android_configuration_filled_in.de.png
29 :alt: Eingetragene Einstellungen
30 :align: center
31
32Nachdem du deine Daten eingetragen hast, drücke den Button Verbindung testen und warte auf das Fertigstellen des Tests.
33
34.. image:: ../../img/user/android_configuration_connection_test.de.png
35 :alt: Verbindungstest mit deinen Wallabagdaten
36 :align: center
37
38Der Verbindungstest sollte mit Erfolg ausgehen. Falls nicht, musst du zunächst deine Daten korrigieren bevor du zum nächsten Schritt gehst.
39
40.. image:: ../../img/user/android_configuration_connection_test_success.de.png
41 :alt: Verbindungstest war erfolgreich
42 :align: center
43
44Nach 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.
45
46.. image:: ../../img/user/android_configuration_get_feed_credentials.de.png
47 :alt: Feedzugangsdaten abholen
48 :align: center
49
50Wenn 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.
51
52.. image:: ../../img/user/android_configuration_feed_credentials_automatically_filled_in.de.png
53 :alt: Feedzugangsdaten erfolgreich abgeholt
54 :align: center
55
56Jetzt 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.
57
58.. image:: ../../img/user/android_configuration_scroll_bottom.de.png
59 :alt: unterer Rand des Einstellungsbildschirms
60 :align: center
61
62Nachdem 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.
63
64.. image:: ../../img/user/android_configuration_saved_feed_update.de.png
65 :alt: Einstellung erstmals gespeichert
66 :align: center
67
68Schließlich nach der ersten erfolgreichen Synchronisation, wird dir die Liste der ungelesenen Artikel präsentiert.
69
70.. image:: ../../img/user/android_unread_feed_synced.de.png
71 :alt: Gefüllte Artikellist da Feeds erfolgreich synchronisiert sind
72 :align: center
73
74
75
76Bekannte Limitierungen
77---------------------
78
792FA
80~~~
81
82Zur Zeit unterstützt die App keine Zwei-Faktor Authentifizierung. Du solltest sie deaktivieren damit die App funktioniert.
83
84
85Begrenzte Anzahl Artikel mit Wallabag v2
86~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
87
88In 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.
89
90
91SSL/TLS Verschlüsselung
92~~~~~~~~~~~~~~~~~~~~~~~
93
94Wenn 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.
95
96
97Referenzen
98----------
99
100`Quellcode der Android Applikation <https://github.com/wallabag/android-app>`_
101
102`Android Applikation auf F-Droid <https://f-droid.org/repository/browse/?fdfilter=wallabag&fdid=fr.gaulupeau.apps.InThePoche>`_
103
104`Android Applikation auf Google Play <https://play.google.com/store/apps/details?id=fr.gaulupeau.apps.InThePoche>`_
105
106`Support Chat auf English <https://gitter.im/wallabag/wallabag>`_
107
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 @@
1Anmerkungen
2===========
3
4In jedem Artikel, den du liest, kannst du Anmerkungen hinzufügen. Es ist einfacher mit ein paar Bilder erklärt.
5
6Wähle den Teil des Artikels aus, den du kommentieren willst und klicke auf den Bleistift:
7
8.. image:: ../../img/user/annotations_1.png
9 :alt: Wähle den Text
10 :align: center
11
12Schreibe deinen Kommentar:
13
14.. image:: ../../img/user/annotations_2.png
15 :alt: Schreibe deinen Kommentar
16 :align: center
17
18Der Text ist nun hervorgehoben und du kannst deine Anmerkung lesen, wenn du den Mauspfeil darüber fährst.
19
20.. image:: ../../img/user/annotations_3.png
21 :alt: lese deine Anmerkung
22 :align: center
23
24Du 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 @@
1Konfiguration
2=============
3
4Nun, da du eingeloggt bist, ist es Zeit, deinen Account so zu konfigurieren,
5wie du möchtest.
6
7Klicke auf ``Konfiguration`` im Menü. Du hast fünf Karteireiter: ``Einstellungen``,
8``RSS``, ``Benutzer-Informationen``, ``Kennwort`` und ``Tagging-Regeln``.
9
10Einstellungen
11-------------
12
13Theme
14~~~~~
15
16wallabag ist anpassbar. Du kannst dein bevorzugtes Theme hier auswählen. Du kannst
17auch ein neues erstellen, ein extra Kapitel wird dem gewidmet sein. Das Standardtheme
18ist ``Material``, es ist das Theme, dass in den Dokumentationsbildschirmfotos genutzt wird.
19
20Artikel pro Seite
21~~~~~~~~~~~~~~~~~
22
23Du kannst die Anzahl der dargestellten Artikel pro Seite ändern.
24
25Lesegeschwindigkeit
26~~~~~~~~~~~~~~~~~~~
27
28wallabag berechnet die Lesezeit für jeden Artikel. Du kannst hier definieren, dank dieser Liste, ob du
29ein schneller oder langsamer Leser bist. wallabag wird die Lesezeit für jeden Artikel neu berechnen.
30
31Sprache
32~~~~~~~
33
34Du kannst die Sprache von der wallabag Benutzeroberfläche ändern. Du musst die ausloggen, damit diese
35Änderung Wirkung zeigt.
36
37RSS
38---
39
40wallabag stellt RSS Feeds für jeden Artikelstatus bereit: ungelesen, Favoriten und Archiv.
41
42Als erstes musst du einen persönlciehn Token erstellen: Klicke auf ``Token generieren``.
43Es ist möglich deinen Token zu ändern, indem du auf ``Token zurücksetzen`` klickst.
44
45Jetzt hast du drei Links, einen für jeden Status: Füge sie in deinem liebsten Feedreader hinzu.
46
47Du kannst auch definieren wie viele Artikel du in deinem RSS Feed (Standardwert: 50) haben willst.
48
49Benutzer-Informationen
50----------------------
51
52Du kannst deinen Namen ändern, deine E-Mail-Adresse und die Zwei-Faktor-Authentifizierung aktivieren.
53
54Zwei-Faktor-Authentifizierung
55~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
56
57 Die Zwei-Faktor-Authentifizierung (2FA) dient dem Identitätsnachweis eines Nutzers mittels der
58 Kombination zweier verschiedener und insbesondere unabhängiger Komponenten (Faktoren).
59
60https://de.wikipedia.org/wiki/Zwei-Faktor-Authentifizierung
61
62Wenn du 2FA aktivierst, erhälst du jedes Mal, wenn du dich bei wallabag einloggen willst, einen Code per
63Mail. Du musst den Code in das folgende Formular eingeben.
64
65.. image:: ../../img/user/2FA_form.png
66 :alt: Zwei-Faktor-Authentifizierung
67 :align: center
68
69Wenn du nicht jedes Mal, wenn du dich einloggen willst, einen Code zugesendet bekommen möchtest, kannst du
70die Checkbox ``Ich bin an einem persönlichen Computer`` anhaken: wallabag wird sich an dich für 15 Tage
71erinnern.
72
73Passwort
74--------
75
76Du kannst dein Passwort hier ändern (8 Zeichen Minimum).
77
78Tagging-Regeln
79--------------
80
81Wenn du automatisch einen Tag zu einem neuen Artikel zuweisen lassen möchtest, ist dieser Teil der
82Konfiguration, was du suchst.
83
84Was ist mit Tagging-Regeln gemeint?
85~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
86
87Dies sind Regeln, die von wallabag genutzt werden, um neue Artikel automatisch zu taggen
88Jedes Mal, wenn ein neuer Artikel hinzugefügt wird, werden alle Tagging-Regeln genutzt, um deine
89konfigurierten Tags hinzuzufügen, folglich um dir den Aufwand zu sparen, die Artikel manuell einzuteilen.
90
91Wie benutze ich sie?
92~~~~~~~~~~~~~~~~~~~~
93
94Nehmen wir an, du möchtest neuen Artikeln einen Tag *schnell gelesen*, wenn du die Lesezeit kleiner als
953 Minuten ist.
96In diesem Fall solltest du in das Regelfeld "readingTime <= 3" eintragen und *schnell gelesen* in das Tags-Feld.
97Mehrere Tags können gleichzeitig hinzugefügt werden, wenn man sie mit einem Komma trennt:
98*schnell gelesen, Pflichtlektüre*.
99Komplexe Regeln können mit vordefinierten Operatoren geschrieben werden:
100Wenn *readingTime >= 5 AND domainName = "github.com"*, dann tagge als *lange zu lesen, github*.
101
102Welche Variablen und Operatoren kann ich zum Regeln schreiben nutzen?
103~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
104
105Die folgenden Variabel und Operatoren können genutzt werden, um Tagging-Regeln zu erstellen:
106
107=========== ============================================== ======== ==========
108Variable Bedeutung Operator Bedeutung
109----------- ---------------------------------------------- -------- ----------
110title Titel des Artikels <= Kleiner gleich als…
111url URL des Artikels < Kleiner als…
112isArchived Ob der Artikel archiviert ist oder nicht => Größer gleich als…
113isStarred Ob der Artikel favorisiert ist oder nicht > Größer als…
114content Inhalt des Eintrags = Gleich zu…
115language Sprache des Eintrags != Nicht gleich zu…
116mimetype MIME-Typ des Eintrags OR Eine Regel oder die andere
117readingTime Die geschätzte Lesezeit in Minuten AND Eine Regel und die andere
118domainName 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"
119=========== ============================================== ======== ==========
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 @@
1Account erstellen
2=================
3
4Klicke auf der Loginseite auf den ``Registrieren`` Button-
5
6.. image:: ../../img/user/registration_form.png
7 :alt: Registrierungsformular
8 :align: center
9
10Du musst das Formular ausfüllen. Bitte stelle sicher, dass du eine gültige
11E-Mail-Adresse eingibst, wir werden dir eine Aktivierungsmail schicken.
12
13.. image:: ../../img/user/sent_email.png
14 :alt: E-Mail wurde gesendet, um Account zu aktivieren
15 :align: center
16
17Überprüfge deinen Posteingang, du hast jetzt eine neue Mail mit einem Link wie diesen
18``http://wallabag/register/confirm/Ba19wokGovN-DdBQNfg4YgRkUQWRP4-k2g0Bk-hBTX4``.
19Klicke auf den Link, um deinen Account zu aktivieren.
20
21Dein Account ist nun aktiviert.
22
23.. image:: ../../img/user/activated_account.png
24 :alt: Willkommen!
25 :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 @@
1Artikel herunterladen
2=====================
3
4Du kannst jeden Artikel in verschiedenen Formaten herunterladen: ePUB, MOBI, PDF, XML, JSON, CSV.
5
6In der Artikelansicht, klickst du auf dieses Icon in der Seitenleiste:
7
8.. image:: ../../img/user/download_article.png
9 :alt: Artikel herunterladen
10 :align: center
11
12Du kannst auch eine ganze Kategorie (ungelesen, Favoriten, Archiv) in diesen Formaten herunterladen.
13Zum Beispiel, in der Ansicht **Ungelesen**, klickst du auf das Icon in der oberen Leiste:
14
15.. image:: ../../img/user/download_articles.png
16 :alt: Artikel herunterladen
17 :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 @@
1Fehler während des Artikelladens
2================================
3
4Warum schlägt das Laden eines Artikels fehl?
5--------------------------------------------
6
7Das kann verschiedene Ursachen haben:
8
9- Netzwerkprobleme
10- wallabag kann den Inhalt aufgrund der Websitestruktur nicht laden
11
12Wie kann ich helfen das zu beheben?
13-----------------------------------
14
15- `indem du uns eine Mail mit der URL des Artikels sendest <mailto:hello\@wallabag.org>`_
16- indem du versuchst das Laden des Artikels durch Erstellen einer Datei für den Artikel
17 selbst zu beheben
18 Du kannst `dieses Tool <http://siteconfig.fivefilters.org/>`__ nutzen.
19
20Wie kann ich versuchen, einen Artikel erneut zu laden?
21------------------------------------------------------
22
23Wenn wallabag beim Laden eines Artikels fehlschlägt, kannst du auf den erneut laden Button
24klicken (der dritte in dem unteren Bild).
25
26.. image:: ../../img/user/refetch.png
27 :alt: Inhalt neu laden
28 :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 @@
1Häufig gestellte Fragen
2==========================
3
4Während der Installation sehe ich den Fehler ``Error Output: sh: 1: @post-cmd: not found``
5------------------------------------------------------------------------------------------
6
7Es scheint, dass du ein Problem bei deiner ``composer`` Installation hast. Versuche es zu deinstallieren und neu zu installieren.
8
9`Lies die Dokumentation über composer, um zu erfahren wie es installiert wird
10<https://getcomposer.org/doc/00-intro.md>`__.
11
12Ich kann das Registrierungsformular nicht validieren
13----------------------------------------------------
14
15Stelle sicher, dass alle Felder ausgefüllt sind:
16
17* valide E-Mail-Adresse
18* das gleiche Passwort in zwei Feldern
19
20Ich erhalte meine Aktivierungsmail nicht
21----------------------------------------
22
23Bist du sicher, dass deine eingegebene E-Mail-Adresse korrekt war? Hast du deinen Spamordner überprüft?
24
25Wenn du dann immer noch nicht deine Aktivierungsmail siehst, stelle bitte sicher, dass du einen MTA
26korrekt installiert und eingerichtet hast. Prüfe, dass deine Firewallregel existiert, z.B. für firewalld:
27
28::
29 firewall-cmd --permanent --add-service=smtp
30 firewall-cmd --reload
31
32Schließlich, falls du SELinux aktiviert hast, setze folgende Regel:
33
34``setsebool -P httpd_can_sendmail 1``
35
36Wenn ich den Aktivierungslink klicke, bekomme ich die Nachricht ``Der Nutzer mit dem Bestätigungstoken "DtrOPfbQeVkWf6N" existiert nicht``
37------------------------------------------------------------------------------------------------------------------------------------------
38
39Du hast deinen Account schon aktiviert oder die URL der Aktivierungsmail ist falsch.
40
41Ich habe mein Passwort vergessen
42--------------------------------
43
44Du 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
45und 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 @@
1Filter
2======
3
4Um Artikel leichter zu erreichen, kannst du sie filtern.
5Klicke auf das dritte Symbol in der oberen Leiste.
6
7.. image:: ../../img/user/topbar.png
8 :alt: Obere Leiste
9 :align: center
10
11Alle diese Filter können kombiniert werden.
12
13.. image:: ../../img/user/filters.png
14 :alt: Kombiniere alle Filter
15 :align: center
16
17Status
18------
19
20Nutze die Checkboxen, um einen archivierten oder favorisierten Artikel zu finden.
21
22Vorschaubild
23---------------
24
25Hake diesen Filter an, wenn du Artikel mit einem Vorschaubild erhalten willst.
26
27Sprache
28-------
29
30wallabag (via graby) kann die Artikelsprache erkennen. Es ist einfach für dich, Artikel
31in einer bestimmten Sprache zu filtern.
32
33Lesezeit
34--------
35
36wallabag schätzt wieviel Zeit du brauchst, um einen Artikel zu lesen. Mit diesem Filter
37kannst du zum Beispiel Artikel mit einer Lesezeit zwischen 2 und 5 Minuten finden.
38
39Domainname
40----------
41
42Dank dieses Filters, kannst ud Artikel von der gleichen Domain finden.
43Zum Beispiel tippst du in diesem Feld ``bbc.co.uk``, um Artikel dieser Website zu finden.
44
45Erstellungsdatum
46----------------
47
48Wenn du Artikel speicherst, merkt sich wallabag das aktuelle Datum. So praktisch, um Aritkel, die
49zwischen 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 @@
1Speichere deinen ersten Artikel
2===============================
3
4Der Hauptzweck von wallabag ist es Webartikel zu speichern. Du hast viele Wege das zu tun.
5
6.. note::
7
8 Eine Schnellstartanleitung wird in der Anwendung angezeigt bis du deinen ersten
9 Artikel gespeichert hast.
10
11Durch Nutzung eines Bookmarklets
12--------------------------------
13
14Auf der ``How-To`` Seite, hast du einen Reiter ``Bookmarklet``. Ziehe und lasse den
15``bag it!`` Link in die Lesezeichenleiste deines Browser los.
16
17Jetzt kannst du immer wenn du einen Artikel im Web liest und ihn du ihn speichern
18willst, klicke auf den ``bag it!`` Link in deiner Lesezeichenleiste. Der Artikel
19wird gespeichert.
20
21Durch Nutzung des klassischen Formulars
22---------------------------------------
23
24In der oberen Leiste auf deinem Bildschirm, hast du drei Icons. Mit dem ersten, einem
25Pluszeichen, kannst du einfach neue Artikel speichern.
26
27.. image:: ../../img/user/topbar.png
28 :alt: obere Leiste
29 :align: center
30
31Klick darauf, um ein neues Feld anzeigen zu lassen, füge deine Artikel URL ein und
32drücke die ``Enter`` Taste. Der Artikel wird gespeichert.
33
34Durch Nutzung eines Browser Add-ons
35-----------------------------------
36
37Firefox
38~~~~~~~
39
40*Dieses Addon ist noch nicht für wallbag v2 verfügbar*.
41
42Chrome
43~~~~~~
44
45*Dieses Addon ist noch nicht für wallbag v2 verfügbar*.
46
47Durch Nutzung deiner Smartphone App
48-----------------------------------
49
50Android
51~~~~~~~
52
53*Diese Applikation ist noch nicht für wallbag v2 verfügbar*.
54
55Firefox OS
56~~~~~~~~~~
57
58*Diese Applikation ist noch nicht für wallbag v2 verfügbar*.
59
60Windows Phone
61~~~~~~~~~~~~~
62
63*Diese Applikation ist noch nicht für wallbag v2 verfügbar*.
64
65iOS
66~~~
67
68*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 @@
1Migration von einem Drittanbieter
2=================================
3
4Von Pocket
5-----------
6
7Erstelle eine neue Applikation in Pocket
8~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9
10Um deine Daten von Pocket zu importieren, nutzen wir die Pocket API. Du musst
11eine neue Applikation auf ihrer Entwicklerwebsite erstellen, um fortzufahren.
12
13* Erstelle eine neue Applikation `auf der Entwicklerwebsite <https://getpocket.com/developer/apps/new>`_
14* Fülle die erforderlichen Felder aus: Name, Beschreibung, Berechtigungen (nur **abrufen**), Plattform
15 (**web**), akzeptiere die Nutzungsbedingungen und reiche deine neue Applikation ein
16
17Pocket wird dir einen **Consumer Key** geben (z.B. `49961-985e4b92fe21fe4c78d682c1`).
18Du musst den ``pocket_consumer_key`` in dem Abschnitt ``Import`` in dem ``Interne Einstellungen`` Menü
19konfigurieren.
20
21Jetzt ist alles in Ordnung, um von Pocket zu migrieren.
22
23Importiere deine Daten in wallabag 2.x
24~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
25
26Klicke auf den ``Importieren`` Link im menü, auf ``Inhalte importieren`` in dem Pocketabschnitt und
27dann auf ``Verbinde mit Pocket und importieren Daten``.
28
29Du musst wallabag erlauben, mit deinem Pocketaccount zu interagieren.
30Deine Daten werden importiert. Datenimport kann ein sehr anspruchsvoller Prozess für deinen Server
31sein (wir müssen daran arbeiten, um diesen Import zu verbessern).
32
33Von Instapaper
34--------------
35
36*Funktion noch nicht implementiert in wallabag v2.*
37
38Von Readability
39---------------
40
41*Funktion noch nicht implementiert in wallabag v2.*
42
43Von einer HTML oder JSON Datei
44------------------------------
45
46*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 @@
1Installation von wallabag
2=========================
3
4Voraussetzungen
5---------------
6
7wallabag ist kompatibel mit PHP >= 5.5, inkl. PHP 7.
8
9Du benötigst die folgenden Extensions damit wallabag funktioniert. Einige von diesen sind vielleicht schon in deiner Version von PHP aktiviert, somit musst du eventuell
10nicht alle folgenden Pakete installieren.
11
12- php-session
13- php-ctype
14- php-dom
15- php-hash
16- php-simplexml
17- php-json
18- php-gd
19- php-mbstring
20- php-xml
21- php-tidy
22- php-iconv
23- php-curl
24- php-gettext
25- php-tokenizer
26
27wallabag nutzt PDO, um sich mit der Datenbank zu verbinden, darum benötigst du eines der folgenden Komponenten:
28
29- pdo_mysql
30- pdo_sqlite
31- pdo_pgsql
32
33und dessen dazugehörigen Datenbankserver.
34
35Installation
36------------
37
38Auf einem dedizierten Webserver (empfohlener Weg)
39~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
40
41wallabag 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.
42
43Composer installieren:
44
45::
46
47 curl -s http://getcomposer.org/installer | php
48
49Du kannst eine spezifische Anleitung `hier <https://getcomposer.org/doc/00-intro.md>`__ finden:
50
51Um wallabag selbst zu installieren, musst du die folgenden Kommandos ausführen:
52
53::
54
55 git clone https://github.com/wallabag/wallabag.git
56 cd wallabag
57 git checkout 2.0.5
58 SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
59 php bin/console wallabag:install --env=prod
60
61Um PHPs eingebauten Server zu starten und zu testen, ob alles korrekt installiert wurde, kannst du folgendes Kommando ausführen:
62
63::
64
65 php bin/console server:run --env=prod
66
67Und wallabag unter http://deineserverip:8000 erreichen
68
69.. tip::
70
71 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 <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ werfen.
72
73Auf einem geteilten Webhosting
74~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
75
76Wir stellen ein Paket inkl. aller Abhängigkeiten bereit.
77Die Standardkonfiguration nutzt SQLite für die Datenbank. Wenn du diese Einstellung ändern willst, ändere bitte ``app/config/parameters.yml``.
78
79Wir haben bereits einen Nutzer erstellt: Login und Passwort sind ``wallabag``.
80
81.. 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).
82
83Führe dieses Kommando aus, um das neueste Paket herunterzuladen und zu entpacken:
84
85.. code-block:: bash
86
87 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
88
89Jetzt lese die Dokumentation, um einen Virtualhost zu erstellen, dann greife auf dein wallabag zu.
90Wenn 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``.
91
92Installation mit Docker
93------------------------
94
95Wir stellen ein Docker Image zu Verfügung, um wallabag einfach zu installieren. Schaue in unser Repository in unserem `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__, um mehr Informationen zu erhalten.
96
97Kommando, um den Container zu starten
98~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
99
100.. code-block:: bash
101
102 docker pull wallabag/wallabag
103
104Virtualhosts
105------------
106
107Konfiguration von Apache
108~~~~~~~~~~~~~~~~~~~~~~~
109
110Angenommen 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:
111
112::
113
114 <VirtualHost *:80>
115 ServerName domain.tld
116 ServerAlias www.domain.tld
117
118 DocumentRoot /var/www/wallabag/web
119 <Directory /var/www/wallabag/web>
120 AllowOverride None
121 Order Allow,Deny
122 Allow from All
123
124 <IfModule mod_rewrite.c>
125 Options -MultiViews
126 RewriteEngine On
127 RewriteCond %{REQUEST_FILENAME} !-f
128 RewriteRule ^(.*)$ app.php [QSA,L]
129 </IfModule>
130 </Directory>
131
132 # uncomment the following lines if you install assets as symlinks
133 # or run into problems when compiling LESS/Sass/CoffeScript assets
134 # <Directory /var/www/wallabag>
135 # Options FollowSymlinks
136 # </Directory>
137
138 # optionally disable the RewriteEngine for the asset directories
139 # which will allow apache to simply reply with a 404 when files are
140 # not found instead of passing the request into the full symfony stack
141 <Directory /var/www/wallabag/web/bundles>
142 <IfModule mod_rewrite.c>
143 RewriteEngine Off
144 </IfModule>
145 </Directory>
146 ErrorLog /var/log/apache2/wallabag_error.log
147 CustomLog /var/log/apache2/wallabag_access.log combined
148 </VirtualHost>
149
150Nach dem du Apache neugeladen oder neugestartet hast, solltest du nun wallabag unter http://domain.tld erreichen.
151
152Konfiguration von Nginx
153~~~~~~~~~~~~~~~~~~~~~~~
154
155Angenommen du willst wallabag in das Verzeichnis ``/var/www/wallabag`` installieren, dann ist hier ein Rezept für wallabag:
156
157::
158
159 server {
160 server_name domain.tld www.domain.tld;
161 root /var/www/wallabag/web;
162
163 location / {
164 # try to serve file directly, fallback to app.php
165 try_files $uri /app.php$is_args$args;
166 }
167 location ~ ^/app\.php(/|$) {
168 fastcgi_pass unix:/var/run/php5-fpm.sock;
169 fastcgi_split_path_info ^(.+\.php)(/.*)$;
170 include fastcgi_params;
171 # When you are using symlinks to link the document root to the
172 # current version of your application, you should pass the real
173 # application path instead of the path to the symlink to PHP
174 # FPM.
175 # Otherwise, PHP's OPcache may not properly detect changes to
176 # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
177 # for more information).
178 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
179 fastcgi_param DOCUMENT_ROOT $realpath_root;
180 # Prevents URIs that include the front controller. This will 404:
181 # http://domain.tld/app.php/some-path
182 # Remove the internal directive to allow URIs like this
183 internal;
184 }
185
186 error_log /var/log/nginx/wallabag_error.log;
187 access_log /var/log/nginx/wallabag_access.log;
188 }
189
190Nach dem neuladen oder neustarten von nginx, solltest du nun wallabag unter http://domain.tld erreichen.
191
192.. tip::
193
194 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``.
195 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``.
196
197Konfiguration von lighttpd
198~~~~~~~~~~~~~~~~~~~~~~~~~
199
200Angenommen 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):
201
202::
203
204 server.modules = (
205 "mod_fastcgi",
206 "mod_access",
207 "mod_alias",
208 "mod_compress",
209 "mod_redirect",
210 "mod_rewrite",
211 )
212 server.document-root = "/var/www/wallabag/web"
213 server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
214 server.errorlog = "/var/log/lighttpd/error.log"
215 server.pid-file = "/var/run/lighttpd.pid"
216 server.username = "www-data"
217 server.groupname = "www-data"
218 server.port = 80
219 server.follow-symlink = "enable"
220 index-file.names = ( "index.php", "index.html", "index.lighttpd.html")
221 url.access-deny = ( "~", ".inc" )
222 static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )
223 compress.cache-dir = "/var/cache/lighttpd/compress/"
224 compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" )
225 include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port
226 include_shell "/usr/share/lighttpd/create-mime.assign.pl"
227 include_shell "/usr/share/lighttpd/include-conf-enabled.pl"
228 dir-listing.activate = "disable"
229
230 url.rewrite-if-not-file = (
231 "^/([^?]*)(?:\?(.*))?" => "/app.php?$1&$2",
232 "^/([^?]*)" => "/app.php?=$1",
233 )
234
235Rechte, um das Projektverzeichnis zu betreten
236---------------------------------------------
237
238Testumgebung
239~~~~~~~~~~~~
240
241Wenn 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.
242
243Produktionsumgebung
244~~~~~~~~~~~~~~~~~~~
245
246Sobald 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.
247
248Um 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).
249
250Der 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.
251
252Dies 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:
253
254.. code-block:: bash
255
256 chown -R www-data:www-data /var/www/wallabag/var
257
258Es muss analog für die folgenden Ordner ausgeführt werden
259
260* /var/www/wallabag/bin/
261* /var/www/wallabag/app/config/
262* /var/www/wallabag/vendor/
263* /var/www/wallabag/data/
264
265durch Eingabe der Kommandos
266
267.. code-block:: bash
268
269 chown -R www-data:www-data /var/www/wallabag/bin
270 chown -R www-data:www-data /var/www/wallabag/app/config
271 chown -R www-data:www-data /var/www/wallabag/vendor
272 chown -R www-data:www-data /var/www/wallabag/data/
273
274ansonsten wirst du früher oder später folgenden Fehlermeldung sehen:
275
276.. code-block:: bash
277
278 Unable to write to the "bin" directory.
279 file_put_contents(app/config/parameters.yml): failed to open stream: Permission denied
280 file_put_contents(/.../wallabag/vendor/autoload.php): failed to open stream: Permission denied
281
282Zusätzliche Regeln für SELinux
283~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
284
285Wenn 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:
286
287``getenforce``
288
289Dies wird ``Enforcing`` ausgeben, wenn SELinux aktiviert ist. Einen neuen Kontext zu erstellen, erfordert die folgende Syntax:
290
291``semanage fcontext -a -t <context type> <full path>``
292
293Zum Beispiel:
294
295``semanage fcontext -a -t httpd_sys_content_t "/var/www/wallabag(/.*)?"``
296
297Dies wird rekursiv den httpd_sys_content_t Kontext auf das wallabag Verzeichnis und alle darunterliegenden Dateien und Ordner anwenden. Die folgenden Regeln werden gebraucht:
298
299+-----------------------------------+----------------------------+
300| Vollständiger Pfad | Kontext |
301+===================================+============================+
302| /var/www/wallabag(/.*)? | ``httpd_sys_content_t`` |
303+-----------------------------------+----------------------------+
304| /var/www/wallabag/data(/.*)? | ``httpd_sys_rw_content_t`` |
305+-----------------------------------+----------------------------+
306| /var/www/wallabag/var/logs(/.*)? | ``httpd_log_t`` |
307+-----------------------------------+----------------------------+
308| /var/www/wallabag/var/cache(/.*)? | ``httpd_cache_t`` |
309+-----------------------------------+----------------------------+
310
311Nach dem diese Kontexte erstellt wurden, tippe das folgende, um deine Regeln anzuwenden:
312
313``restorecon -R -v /var/www/wallabag``
314
315Du 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.
316
317Wenn du das vorkonfigurierte latest-v2-package installierst, dann ist eine weitere Regel während der Installation nötig:
318
319``semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/wallabag/var"``
320
321Nachdem du erfolgreich dein wallabag erreichst und die Installation fertiggestellt hast, kann dieser Kontext entfernt werden:
322
323::
324
325 semanage fcontext -d -t httpd_sys_rw_content_t "/var/www/wallabag/var"
326 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 @@
1Login
2=====
3
4Dein Account ist nun aktiviert, Glückwünsch!
5
6Um dich bei wallabag einzuloggen, fülle das Formular auf der Loginseite aus.
7
8Wenn du an deinem persönlichen Computer arbeitest und verbunden bleiben willst,
9kannst du die Checkbox ``Angemeldet bleiben`` anhaken: wallabag wird sich für ein Jahr an deinen Login erinnern.
10
11.. image:: ../../img/user/login_form.png
12 :alt: Loginformular
13 :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 @@
1Migration von v1 oder v2
2========================
3
4Von wallabag 1.x
5-----------------
6
7Wenn 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.
8
9.. image:: ../../img/user/export_v1.png
10 :alt: Export von wallabag v1
11 :align: center
12
13.. note::
14 Wenn du mehrere Accounts auf der gleichen Instanz von wallabag hast, muss jeder Nutzer von v1 exportieren und in v2 seine Daten importieren.
15
16.. note::
17 Wenn du Probleme während des Exports oder Imports hast, scheue dich nicht davor `nach Hilfe zu fragen <https://www.wallabag.org/pages/support.html>`__.
18
19Wenn du eine JSON Datei mit deinen Artikeln erhalten hast, kannst du wallabag v2 installieren falls benötigt durch Befolgen `der Standardprozedur <http://doc.wallabag.org/en/master/user/installation.html>`__.
20
21Nachdem 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.
22
23.. image:: ../../img/user/import_wallabagv1.png
24 :alt: Import von wallabag v1
25 :align: center
26
27Import via command-line interface (CLI)
28~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
29
30Wenn du CLI Zugang zu deinem Webserver hast, kannst du dieses Kommando ausführen, um deine Aritkel vom wallabag v1 Export zu importieren:
31
32::
33
34 bin/console wallabag:import-v1 1 ~/Downloads/wallabag-export-1-2016-04-05.json --env=prod
35
36Bitte ersetze folgende Werte:
37
38* ``1`` ist die Nutzer ID in der Databank (Die ID von dem ersten erstellten Nutzer in wallabag ist 1)
39* ``~/Downloads/wallabag-export-1-2016-04-05.json`` ist der Pfad zu deinem wallabag v1 Export
40
41Du wirst eine solche Ausgabe erhalten:
42
43::
44
45 Start : 05-04-2016 11:36:07 ---
46 403 imported
47 0 already saved
48 End : 05-04-2016 11:36:09 ---
49
50Von wallabag 2.x
51----------------
52
53In der vorherigen wallabag Instanz, gehe zu `Alle Artikel` und exportiere diese Artikel als JSON.
54
55.. image:: ../../img/user/export_v2.png
56 :alt: Export von wallabag v2
57 :align: center
58
59In 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.
60
61.. note::
62 Wenn du Probleme während des Exports oder Imports hast, scheue dich nicht davor `nach Hilfe zu fragen <https://www.wallabag.org/pages/support.html>`__.
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 @@
1Tags
2==== \ 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 @@
1Wallabag updaten
2================
3
4Update auf einem dedizierten Webserver
5--------------------------------------
6
7Das 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):
8
9::
10
11 git fetch origin
12 git fetch --tags
13 git checkout 2.0.3
14 SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
15 php bin/console cache:clear --env=prod
16
17Update auf einem Shared Webhosting
18----------------------------------
19
20Sichere deine ``app/config/parameters.yml`` Datei.
21
22Lade das neueste Release von wallabag herunter:
23
24.. code-block:: bash
25
26 wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
27
28Entpacke das Archiv in deinen wallabag Ordner und ersetze ``app/config/parameters.yml`` mit deiner Datei.
29
30Wenn du SQLite nutzt, musst auch das ``data/`` Verzeichnis in die neue Installation kopieren.
31
32Leere den ``var/cache`` Ordner.
diff --git a/docs/en/user/configuration.rst b/docs/en/user/configuration.rst
index f681d874..f4c55dea 100644
--- a/docs/en/user/configuration.rst
+++ b/docs/en/user/configuration.rst
@@ -108,7 +108,7 @@ Variable Meaning Operator Meaning
108title Title of the entry <= Less than… 108title Title of the entry <= Less than…
109url URL of the entry < Strictly less than… 109url URL of the entry < Strictly less than…
110isArchived Whether the entry is archived or not => Greater than… 110isArchived Whether the entry is archived or not => Greater than…
111isStared Whether the entry is starred or not > Strictly greater than… 111isStarred Whether the entry is starred or not > Strictly greater than…
112content The entry's content = Equal to… 112content The entry's content = Equal to…
113language The entry's language != Not equal to… 113language The entry's language != Not equal to…
114mimetype The entry's mime-type OR One rule or another 114mimetype The entry's mime-type OR One rule or another
diff --git a/docs/fr/user/configuration.rst b/docs/fr/user/configuration.rst
index 89305998..278f0022 100644
--- a/docs/fr/user/configuration.rst
+++ b/docs/fr/user/configuration.rst
@@ -110,7 +110,7 @@ Variable Sens Opérateur Sens
110title Titre de l'article <= Inférieur ou égal à … 110title Titre de l'article <= Inférieur ou égal à …
111url URL de l'article < Strictement inférieur à … 111url URL de l'article < Strictement inférieur à …
112isArchived Si l'article est archivé ou non => Supérieur ou égal à … 112isArchived Si l'article est archivé ou non => Supérieur ou égal à …
113isStared Si l'article est en favori ou non > Strictement supérieur à … 113isStarred Si l'article est en favori ou non > Strictement supérieur à …
114content Le contenu de l'article = Égal à … 114content Le contenu de l'article = Égal à …
115language La langue de l'article != Différent de … 115language La langue de l'article != Différent de …
116mimetype The type MIME de l'article OR Telle règle ou telle autre règle 116mimetype The type MIME de l'article OR Telle règle ou telle autre règle