From 8b197f27d857f7e1f7f45b2eb9e793650a664fc0 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Nicolas=20L=C5=93uillet?= Date: Sat, 20 Feb 2016 09:45:05 +0100 Subject: [PATCH] import and first article french translations --- docs/en/user/first_article.rst | 14 ++++-- docs/en/user/import.rst | 24 ++++++---- docs/fr/index.rst | 2 + docs/fr/user/first_article.rst | 68 ++++++++++++++++++++++++++++ docs/fr/user/import.rst | 83 ++++++++++++++++++++++++++++++++++ 5 files changed, 178 insertions(+), 13 deletions(-) create mode 100644 docs/fr/user/first_article.rst create mode 100644 docs/fr/user/import.rst diff --git a/docs/en/user/first_article.rst b/docs/en/user/first_article.rst index 6f94bbef..1400e1e8 100644 --- a/docs/en/user/first_article.rst +++ b/docs/en/user/first_article.rst @@ -10,20 +10,24 @@ The main purpose of wallabag is to save web articles. You have many ways to do i By using a bookmarklet ---------------------- -On the ``Howto`` page, you have a ``Bookmarklet`` tab. Drag and drop the ``bag it!`` link to your bookmarks bar of your browser. +On the ``Howto`` page, you have a ``Bookmarklet`` tab. Drag and drop the ``bag it!`` +link to your bookmarks bar of your browser. -Now, each time you're reading an article on the web and you want to save it, click on the ``bag it!`` link in your bookmarks bar. The article is saved. +Now, each time you're reading an article on the web and you want to save it, +click on the ``bag it!`` link in your bookmarks bar. The article is saved. By using the classic form ------------------------- -In the top bar of your screen, you have 3 icons. With the first one, a plus sign, you can easily save a new article. +In the top bar of your screen, you have 3 icons. With the first one, a plus sign, +you can easily save a new article. .. image:: ../../img/user/topbar.png :alt: Top bar :align: center -Click on it to display a new field, paste the article URL inside and press your ``Return`` key. The article is saved. +Click on it to display a new field, paste the article URL inside and press your +``Return`` key. The article is saved. By using a browser add-on ------------------------- @@ -59,4 +63,4 @@ Windows Phone iOS ~~~ -*This application is not yet available for wallabag v2*. \ No newline at end of file +*This application is not yet available for wallabag v2*. diff --git a/docs/en/user/import.rst b/docs/en/user/import.rst index 37f375b2..d6054d39 100644 --- a/docs/en/user/import.rst +++ b/docs/en/user/import.rst @@ -29,7 +29,8 @@ You will have a ``Unread articles.json`` file. Import your data into wallabag 2.x ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Click on ``Import`` link in the menu, select your export file on your computer and import it. +Click on ``Import`` link in the menu, choose the right wallabag version, +select your export file on your computer and import it. .. image:: ../../img/user/import_wllbg.png :alt: Import from wallabag 1.x @@ -40,24 +41,31 @@ All your wallabag articles will be imported. From Pocket ----------- -Create a new applicaton on Pocket -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Create a new application on Pocket +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -To import your data from Pocket, we use the Pocket API. You need to create a new application on their developer website to continue. +To import your data from Pocket, we use the Pocket API. You need to create +a new application on their developer website to continue. * Create a new application `on the developer website `_ -* Fill in the required fields: application name, application description, permissions (only **retrieve**), platform (**web**), accept the terms of service and submit your new application +* Fill in the required fields: application name, application description, + permissions (only **retrieve**), platform (**web**), accept the terms of service + and submit your new application -Pocket will give you a **Consumer Key** (for example, `49961-985e4b92fe21fe4c78d682c1`). You need to configure the ``pocket_consumer_key`` into the ``app/config/parameters.yml`` file in wallabag. +Pocket will give you a **Consumer Key** (for example, `49961-985e4b92fe21fe4c78d682c1`). +You need to configure the ``pocket_consumer_key`` into the ``app/config/parameters.yml`` file in wallabag. Now, all is fine to migrate from Pocket. Import your data into wallabag 2.x ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Click on ``Import`` link in the menu, on ``Import contents`` in Pocket section and then on ``Connect to Pocket and import data``. +Click on ``Import`` link in the menu, on ``Import contents`` in Pocket section +and then on ``Connect to Pocket and import data``. -You need to authorize wallabag to interact with your Pocket account. Your data will be imported. Data import can be a demanding process for your server (we need to work on this import to improve it). +You need to authorize wallabag to interact with your Pocket account. +Your data will be imported. Data import can be a demanding process for your server +(we need to work on this import to improve it). From Instapaper --------------- diff --git a/docs/fr/index.rst b/docs/fr/index.rst index 236c44c3..d4ff7296 100644 --- a/docs/fr/index.rst +++ b/docs/fr/index.rst @@ -27,6 +27,8 @@ La documentation principale de cette application est découpée en plusieurs sec user/create_account user/login user/configuration + user/first_article + user/import user/download_articles user/filters user/tags diff --git a/docs/fr/user/first_article.rst b/docs/fr/user/first_article.rst new file mode 100644 index 00000000..90c45a44 --- /dev/null +++ b/docs/fr/user/first_article.rst @@ -0,0 +1,68 @@ +Sauvegardez votre premier article +================================= + +La fonctionnalité principale de wallabag est de sauvegarder des articles. +Vous avez plusieurs manières de le faire. + +.. note:: + + Un guide de démarrage s'affichera dans l'application jusqu'à ce que vous + enregistriez votre premier article. + +En utilisant le bookmarklet +--------------------------- + +Sur la page ``Aide``, vous avez un onglet ``Bookmarklet``. Glissez/déposez le lien ``bag it!`` +dans votre barre de favoris de votre navigateur. + +Maintennat, à chaque fois que vous lisez un article et que vous souhaitez le sauvegarder, +cliquez sur le lien ``bag it!`` dans votre barre de favoris. L'article est enregistré. + +En utilisant le formulaire classique +------------------------------------ + +Dans la barre haut de wallabag, vous avez trois icônes. Avec la première icône, +un signe plus, vous pouvez facilement ajouter un nouvel article. + +.. image:: ../../img/user/topbar.png + :alt: Top bar + :align: center + +Cliquez dessus pour afficher un nouveau champ, collez-y l'URL de l'article et appuyez +sur la touche ``Entrée``. L'article est enregistré. + +En utilisant l'extension de votre navigateur +-------------------------------------------- + +Firefox +~~~~~~~ + +*Cette extension n'est pas encore disponible pour wallabag v2*. + +Chrome +~~~~~~ + +*Cette extension n'est pas encore disponible pour wallabag v2*. + +En utilisant l'application de votre smartphone +---------------------------------------------- + +Android +~~~~~~~ + +*Cette application n'est pas encore disponible pour wallabag v2*. + +Firefox OS +~~~~~~~~~~ + +*Cette application n'est pas encore disponible pour wallabag v2*. + +Windows Phone +~~~~~~~~~~~~~ + +*Cette application n'est pas encore disponible pour wallabag v2*. + +iOS +~~~ + +*Cette application n'est pas encore disponible pour wallabag v2*. diff --git a/docs/fr/user/import.rst b/docs/fr/user/import.rst new file mode 100644 index 00000000..c95f175d --- /dev/null +++ b/docs/fr/user/import.rst @@ -0,0 +1,83 @@ +Migrer à wallabag +================= + +Depuis wallabag +--------------- + +Exportez vos données de wallabag 1.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Sur la page de configuration, cliquez sur ``Export JSON`` dans la section ``Exportez vos données wallabag``. + +.. image:: ../../img/user/export_wllbg_1.png + :alt: Export from wallabag 1.x + :align: center + +Vous obtiendrez un fichier ``wallabag-export-1-1970-01-01.json``. + +Exportez vos données de wallabag 2.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Dans la barre latérale de téléchargement, cliquez sur ``JSON``. + +.. image:: ../../img/user/export_wllbg_2.png + :alt: Export from wallabag 2.x + :align: center + +Vous obtiendrez un fichier ``Unread articles.json``. + +Importez vos données wallabag 2.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Cliquez sur le lien ``Importer`` dans le menu, choisissez la version de wallabag correspondante, +sélectionnez votre fichier d'export sur votre ordinateur et importez-le. + +.. image:: ../../img/user/import_wllbg.png + :alt: Import from wallabag 1.x + :align: center + +Tous vos articles wallabag seront importés. + +Depuis Pocket +------------- + +Créer une nouvelle application dans Pocket +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Pour importer vos données depuis Pocket, nous utilisons l'API de Pocket. +Vous devez créer une nouvelle application sur leur site dédié aux développeurs pour continuer. + +* Créez une nouvelle application `sur leur site Développeurs `_ +* Remplissez les champs requis : nom de l'application, description de l'application, + permissions (seulement **retrieve**), la plateforme (**web**), acceptez les + termes d'utilisation du service et soumettez votre application + +Pocket vous fournira une **Consumer Key** (par exemple, `49961-985e4b92fe21fe4c78d682c1`). +Vous devez configurer la ``pocket_consumer_key`` dans le fichier ``app/config/parameters.yml``. + +Maintenant, tout est bien configuré pour migrer depuis Pocket. + +Importez vos données dans wallabag 2.x +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Cliquez sur le lien ``Importer`` dans le menu, sur ``Importer les contenus`` dans +la section Pocket puis sur ``Se connecter à Pocket et importer les données``. + +Vous devez autoriser wallabag à se connecter à votre compte Pocket. +Vos données vont être importées. L'import de données est une action qui peut être couteuse +pour votre serveur (nous devons encore travailler pour améliorer cet import). + +Depuis Instapaper +----------------- + +*Fonctionnalité pas encore implémentée dans wallabag v2.* + +Depuis Readability +------------------ + +*Fonctionnalité pas encore implémentée dans wallabag v2.* + +Depuis un fichier HTML ou JSON +------------------------------ + +*Fonctionnalité pas encore implémentée dans wallabag v2.* -- 2.41.0