Translate docs with po4a (#2590)

* [i18n] Add docs po4a script

* Add proof of concept

* Add a few more translations

* Hush ShellCheck and shfmt

* Make that list po4a-friendly

* drat, this document could've probably been auto-generated

* Definitive proof that it's translated from French ;-)

* Add some brand spanking new French translation

* More translation

* Mostly finish that config page

* Fix up FAQ

* More contributing

* Dev first steps

* Let's ignore that admin stuff at the very least for now

* Translate release new version, make French the source first and copy all translations

Then replace French with English in the source.

Much quicker than any alternative route.

* And add the English translation

* Minor stylistic leftover from French

* Most of first steps

* Forgot the extensions

* Use po4a 0.56 to get rid of way too many newlines

* Fix up those newlines

* No point linking to Firefox integration anymore from the new user guide

* Start on main view

* A bunch of main view stuff

* More main view

* And some subscriptions before going to bed

* First steps for devs

* More dev first steps

* Incomplete French → English dev/GH translation

Because I need to ask about that mailing list thing

* Fix typo in docs/en/developers/02_Github.md

* Translate & complete devs/github to English

* Fix up most of extensions

* Is that supposed to be a non-breaking space? Let's see

* Match up some users/mobile access

* More users/mobile access

* Add fresh French translation to Fever API

* Fix typo

* Match frontend todo thingies

* Fix a typo

* Some extensions strings

* Remove Fx subscription service from the docs

Cf. https://github.com/FreshRSS/FreshRSS/pull/2606

* Add translation for https://github.com/FreshRSS/FreshRSS/pull/2643

* fix typo as per https://github.com/FreshRSS/FreshRSS/pull/2643#discussion_r345433009

* Add some more French translations

* Update French translation as per @aledeg comment https://github.com/FreshRSS/FreshRSS/pull/2590#discussion_r345465909

* Translate some of the meaningless stuff

* Translate the rest of contributing.md to French

* Fix conflicts

* Translate Docker first steps to French

* Update with change from #2665

* Add @aledeg corrections

* Overlooked a couple @aledeg corrections thanks to GitHub autohide

* Latest @aledeg suggestions

cli/translation-update.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# This script performs the following:
+# - Generate configuration file for po4a (can be configured in CONFIGFILE)
+# - Generate POT file from pages/<DIRECTORY>/*.md
+# - Update PO files in i18n directory with POT file
+# - Generate localized pages.XX/<DIRECTORY>/*.md (where XX is the language code)
+# - Remove unneeded new lines from generated pages
+
+# Name of the po4a configuration file
+CONFIGFILE='po4a.conf'
+
+# List of supported languages
+LANGS=(fr)
+
+# Check if po4a is installed
+if [ -z "$(command -v po4a)" ]; then
+	echo 'It seems that po4a is not installed on your system.'
+	echo 'Please install po4a to use this script.'
+	exit 1
+fi
+
+# Generate po4a.conf file with list of TLDR pages
+echo 'Generating configuration file for po4a...'
+{
+	echo '# WARNING: this file is generated with translation-update.sh'
+	echo '# DO NOT modify this file manually!'
+	echo "[po4a_langs] ${LANGS[*]}"
+	# shellcheck disable=SC2016
+	echo '[po4a_paths] i18n/templates/freshrss.pot $lang:i18n/freshrss.$lang.po'
+} >$CONFIGFILE
+
+for FILE in $(cd en && tree -f -i | grep ".md" | grep -v "admins"); do
+	echo "[type: text] en/$FILE \$lang:\$lang/$FILE opt:\"-o markdown\" opt:\"-M utf-8\"" >>$CONFIGFILE
+done
+
+# Generate POT file, PO files, and pages.XX pages
+echo 'Generating POT file and translated pages...'
+po4a -k 0 --msgid-bugs-address 'https://github.com/FreshRSS/FreshRSS/issues' $CONFIGFILE

docs/en/contributing.md

@@ -2,39 +2,41 @@
 
 Do you want to ask us some questions? Do you want to discuss with us? Don't hesitate to subscribe to our mailing lists!
 
-- The first mailing is destined to generic information, it should be adapted to users. [Join mailing@freshrss.org](https://freshrss.org/mailman/listinfo/mailing).
-- The second mailing is mainly for developers. [Join dev@freshrss.org](https://freshrss.org/mailman/listinfo/dev)
+* The first mailing is destined to generic information, it should be adapted to users. [Join mailing@freshrss.org](https://freshrss.org/mailman/listinfo/mailing).
+* The second mailing is mainly for developers. [Join dev@freshrss.org](https://freshrss.org/mailman/listinfo/dev)
 
 ## Report a bug
 
-You found a bug? Don't panic, here are some steps to report it easily:
+Have you found a bug? Don't panic, here are some steps to report it with ease:
 
 1. Search for it on [the bug tracker](https://github.com/FreshRSS/FreshRSS/issues) (don't forget to use the search bar).
 2. If you find a similar bug, don't hesitate to post a comment to add more importance to the related ticket.
 3. If you didn't find it, [open a new ticket](https://github.com/FreshRSS/FreshRSS/issues/new).
 
-If you have to create a new ticket, try to apply the following advices:
+If you have to create a new ticket, please try to keep in mind the following advice:
 
-- Give an explicit title to the ticket so it will be easier to find it later.
-- Be as exhaustive as possible in the description: what did you do? What is the bug? What are the steps to reproduce the bug?
-- We also need some information:
-    + Your FreshRSS version (on about page or `constants.php` file)
-    + Your server configuration: type of hosting, PHP version
-    + Your storage system (SQLite, MySQL, MariaDB, PostgreSQL)
-    + If possible, the related logs (PHP logs and FreshRSS logs under `data/users/your_user/log.txt`)
+* Give an explicit title to the ticket so it will be easier to find it later.
+* Be as exhaustive as possible in the description: what did you do? What is the bug? What are the steps to reproduce the bug?
+
+We also need some information:
+
+* Your FreshRSS version (on the about page or in the `constants.php` file)
+* Your server configuration: the type of hosting and the PHP version
+* Your storage system (SQLite, MySQL, MariaDB, PostgreSQL)
+* If possible, the related logs (PHP logs and FreshRSS logs under `data/users/your_user/log.txt`)
 
 ## Fix a bug
 
-Did you want to fix a bug? To keep a great coordination between collaborators, you will have to follow these indications:
+Would you like to fix a bug? For optimum coordination between collaborators, you should follow these indications:
 
-1. Be sure the bug is associated to a ticket and say you work on it.
-2. [Fork this project repository](https://help.github.com/articles/fork-a-repo/).
-3. [Create a new branch](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/). The name of the branch must be explicit and being prefixed by the related ticket id. For instance, `783-contributing-file` to fix [ticket #783](https://github.com/FreshRSS/FreshRSS/issues/783).
+1. Be sure the bug is associated with a ticket and indicate that you'll work on it.
+2. [Fork the project repository](https://help.github.com/articles/fork-a-repo/).
+3. [Create a new branch](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/). The name of the branch should be clear, and ideally prefixed by the related ticket id. For instance, `783-contributing-file` to fix [ticket #783](https://github.com/FreshRSS/FreshRSS/issues/783).
 4. Make your changes to your fork and [send a pull request](https://help.github.com/articles/using-pull-requests/) on the **dev branch**.
 
 If you have to write code, please follow [our coding style recommendations](developers/01_First_steps.md).
 
-**Tip:** if you are searching for easy-to-fix bugs, have a look at the « [good first issue](https://github.com/FreshRSS/FreshRSS/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) » ticket label.
+**Tip:** if you're searching for easy-to-fix bugs, please have a look at the "[good first issue](https://github.com/FreshRSS/FreshRSS/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)" ticket label.
 
 ## Submit an idea
 
@@ -44,11 +46,11 @@ If your idea is nice, we'll have a look at it.
 
 ## Contribute to internationalization (i18n)
 
-If you want to improve internationalization, please open a new ticket first and follow indications from « Fix a bug » section.
+If you want to improve internationalization, please open a new ticket first and follow the advice from the *Fix a bug* section.
 
 Translations are present in the subdirectories of `./app/i18n/`.
 
-We are working on a better way to handle internationalization but don't hesitate to suggest any idea!
+We're working on a better way to handle internationalization, but don't hesitate to suggest any ideas!
 
 ## Contribute to documentation
 

docs/en/developers/01_First_steps.md

@@ -45,7 +45,7 @@ $ TAG=dev-arm make start
 
 You can find the full list of available tags [on the Docker hub](https://hub.docker.com/r/freshrss/freshrss/tags).
 
-You might want to rebuild the Docker image locally. You can do it with:
+If you want to build the Docker image yourself, you can use the following command:
 
 ```console
 $ make build
@@ -65,18 +65,18 @@ If you want to create your own FreshRSS extension, take a look at the [extension
 
 # Coding style
 
-If you want to contribute to the source code, it is important to follow the project coding style. The actual code does not follow it throughout the project, but every time we have an opportunity, we should fix it.
+If you want to contribute to the source code, it's important to follow the project's coding style. The actual code doesn't always follow it throughout the project, but we should fix it every time an opportunity presents itself.
 
-Contributions which do not follow the coding style will be rejected as long as the coding style is not fixed.
+Contributions which don't follow the coding style will be rejected as long as the coding style is not fixed.
 
-## Spaces, tabs and white spaces
+## Spaces, tabs and other whitespace characters
 
-### Indent
-Code indent must use tabs.
+### Indentation
+Code indentation must use tabs.
 
 ### Alignment
 
-Once the code is indented, it might be useful to align it to ease the reading. In that case, use spaces.
+Once the code has been correctly indented, it might be useful to align it for ease of reading. In that case, please use spaces.
 
 ```php
 $result = a_function_with_a_really_long_name($param1, $param2,
@@ -85,9 +85,9 @@ $result = a_function_with_a_really_long_name($param1, $param2,
 
 ### End of line
 
-The end of line character must be a line feed (LF) which is a default end of line on *NIX systems. This character must not follow other white spaces.
+The newline character must be a line feed (LF), which is the default line ending on *NIX systems. This character must not follow other white space.
 
-It is possible to verify if there is white spaces before the end of line, with the following Git command:
+You can verify if there is any unintended white space at the end of line with the following Git command:
 
 ```bash
 # command to check files before adding them in the Git index
@@ -100,13 +100,13 @@ git diff --check --cached
 
 Every file must end by an empty line.
 
-### With commas, dots and semi-columns
+### Commas, dots and semi-columns
 
-There is no space before those characters but there is one after.
+There should no space before those characters, but there should be one after.
 
-### With operators
+### Operators
 
-There is a space before and after every operator.
+There should be a space before and after every operator.
 
 ```php
 if ($a == 10) {
@@ -116,9 +116,9 @@ if ($a == 10) {
 echo $a ? 1 : 0;
 ```
 
-### With brackets
+### Parentheses
 
-There is no spaces in the brackets. There is no space before the opening bracket except if it is after a keyword. There is no space after the closing bracket except if it is followed by a curly bracket.
+There should be no spaces in between brackets. There should be no spaces before the opening bracket, except if it's after a keyword. There shouldn't be any spaces after the closing bracket, except if it's followed by a curly bracket.
 
 ```php
 if ($a == 10) {
@@ -132,7 +132,7 @@ if ((int)$a == 10) {
 
 ### With chained functions
 
-It happens most of the time in Javascript files. When there is chained functions, closures and callback functions, it is hard to understand the code if not properly formatted. In those cases, we add a new indent level for the complete instruction and reset the indent for a new instruction on the same level.
+It happens most of the time in Javascript files. When there are chained functions with closures and callback functions, it's hard to understand the code if not properly formatted. In those cases, we add a new indent level for the complete instruction and reset the indent for a new instruction on the same level.
 
 ```javascript
 // First instruction
@@ -151,9 +151,9 @@ shortcut.add("shift+" + shortcuts.mark_read, function () {
 
 ## Line length
 
-Lines should be shorter than 80 characters. However, in some case, it is possible to extend that limit to 100 characters.
+Lines should strive to be shorter than 80 characters. However, this limit may be extended to 100 characters when strictly necessary.
 
-With functions, parameters can be declared on different lines.
+With functions, parameters can be declared on multiple lines.
 
 ```php
 function my_function($param_1, $param_2,
@@ -164,11 +164,11 @@ function my_function($param_1, $param_2,
 
 ## Naming
 
-All the code elements (functions, classes, methods and variables) must describe their usage in concise way.
+All code elements (functions, classes, methods and variables) must describe their usage succinctly.
 
 ### Functions and variables
 
-They must follow the "snake case" convention.
+Functions and variables must follow the "snake case" naming convention.
 
 ```php
 // a function
@@ -181,7 +181,7 @@ $variable_name;
 
 ### Methods
 
-They must follow the "lower camel case" convention.
+Methods must follow the "lower camel case" naming convention.
 
 ```php
 private function methodName() {
@@ -191,7 +191,7 @@ private function methodName() {
 
 ### Classes
 
-They must follow the "upper camel case" convention.
+Classes must follow the "upper camel case" naming convention.
 
 ```php
 abstract class ClassName {}
@@ -199,16 +199,16 @@ abstract class ClassName {}
 
 ## Encoding
 
-Files must be encoded with UTF-8 character set.
+Files must be encoded with the UTF-8 character set.
 
 ## PHP compatibility
 
-Ensure that your code is working with a PHP version as old as what FreshRSS officially supports.
+Please ensure that your code works with the oldest PHP version officially supported by FreshRSS.
 
 ## Miscellaneous
 
 ### Operators
-They must be at the end of the line if a condition runs on more than one line.
+Operators must be at the end of the line if a condition is split over more than one line.
 
 ```php
 if ($a == 10 ||
@@ -223,7 +223,7 @@ If the file contains only PHP code, the PHP closing tag must be omitted.
 
 ### Arrays
 
-If an array declaration runs on more than one line, each element must be followed by a comma even the last one.
+If an array declaration runs on more than one line, each element must be followed by a comma, including the last one.
 
 ```php
 $variable = [

docs/en/developers/02_Github.md

@@ -1,11 +1,123 @@
 # Reporting a bug or a suggestion
 
-**TODO**
+Despite the care given to FreshRSS, it's still possible that bugs occur. The project is young and development is dynamic, so it can be corrected quickly. You might also have a feature in mind that doesn't yet exist. Regardless whether your idea seems silly, far-fetched, useless or too specific, please don't hesitate to propose it to us! "Ideas in the air" often find an attentive ear. It's new external perspectives that make the project evolve the most.
+
+If you're convinced that you should be heard, here's how you can go about it.
+
+## On GitHub
+
+GitHub is the ideal platform to submit your requests. It allows us to discuss a problem or suggestion with others and it often generates new ideas. Let's not neglect this "social" aspect!
+
+ 1. [Go to the bug ticket manager](https://github.com/FreshRSS/FreshRSS/issues)
+ 2. Start by checking if a similar request hasn't already been made. If so, please feel free to add your voice to the request.
+ 3. If your request is new, [open a new bug ticket](https://github.com/FreshRSS/FreshRSS/issues/new)
+ 4. Finally, write your request. If you're fluent in English, it's the preferred language because it allows for discussion with the largest number of people.
+ 5. Please follow the tips below to make it easier to let your ticket be heard.
+ 
+## Informal
+
+Not everyone likes or uses GitHub for a variety of legitimate reasons. That is why you can also contact us in a more informal way.
+
+* On [our Mattermost chat](https://framateam.org/signup_user_complete/?id=e2680d3e3128b9fac8fdb3003b0024ee)
+* On [the mailing lists](https://freshrss.org/announce-of-the-mailing-lists.html)
+* At events / meetings around Free Software
+* Over a beer in a bar
+* Etc.
+
+## Tips
+
+Here are some tips to help you present your bug report or suggestion:
+
+
+* **Pay attention to spelling**. Even if it's not always easy, try your best!
+* **Give an explicit title to your request**, even if it's a bit long. This not only helps us understand your request, but also to find your ticket later.
+* **One request = one ticket.** You may have lots of ideas while being afraid to spam the bug manager: it doesn't matter. It's better to have a few too many tickets than too many requests in one. We'll close and consolidate requests when possible.
+* If you report a bug, think about **providing us with the FreshRSS logs** (accessible in the FreshRSS `data/log/` folder) and the **PHP logs** (the location may vary by distribution, but consider searching in `/var/log/httpd` or `/var/log/apache`).
+* If you can't find the log files, specify it in your ticket so we know you've already searched.
+* Not all bugs require logs, but if you have any doubts, it is better to provide them to us. Logs are important and very useful for debugging!
+* The logs may reveal confidential information, so **be careful not to disclose anything sensitive.**
+
+In addition, when facing a bug, you're encouraged to follow this message format (from the [Sam & Max website](http://sametmax.com/template-de-demande-daide-en-informatique/):
+
+### What's my goal?
+
+Give the general context of what you were trying to do.
+
+### What have I been trying to do?
+
+Explain step by step what you have done so that we can reproduce the bug.
+
+### What results have I achieved?
+
+The bug: what you see that shouldn't have happened. Here you can provide the logs.
+
+### What was the expected result?
+
+So that we understand what you consider to be the problem.
+
+### What are my circumstances?
+
+Remember to give the following information if you know it:
+
+ 1. Which browser? Which version?
+ 2. Which server: Apache, Nginx? Which version?
+ 3. Which version of PHP?
+ 4. Which database: SQLite, MySQL, MariaDB, PostgreSQL? Which version?
+ 5. Which distribution runs on the server? And... which version?
 
 # Branching
 
-**TODO**
+## Basic
+If you are new to Git, here are some of the resources you might find useful:
+
+* [GitHub's blog post](https://github.com/blog/120-new-to-git)
+* <http://try.github.com/>
+* <http://sixrevisions.com/resources/git-tutorials-beginners/>
+* <http://rogerdudler.github.io/git-guide/>
+
+## Getting the latest code from the FreshRSS repository
+First you need to add the official repo to your remote repo list:
+```bash
+git remote add upstream git@github.com:FreshRSS/FreshRSS.git
+```
+
+You can verify the remote repo is successfully added by using:
+```bash
+git remote -v show
+```
+
+Now you can pull the latest development code:
+```bash
+git checkout dev
+git pull upstream dev
+```
+
+## Starting a new development branch
+```bash
+git checkout -b my-development-branch
+```
 
 # Sending a patch
 
-**TODO**
+```bash
+# Add the changed file, here actualize_script.php
+git add app/actualize_script.php
+# Commit the change and write a proper commit message
+git commit
+# Double check all looks well
+git show
+# Push it to your fork
+git push
+```
+
+Now you can create a PR based on your branch. Please make sure to file it against the `dev` branch!
+
+## How to write a commit message
+
+A commit message should succintly describe the changes on the first line. For example:
+
+> Fix broken icon
+
+If necessary, this can be followed by a blank line and a longer explanation.
+
+For further tips, see [here](https://chris.beams.io/posts/git-commit/).

docs/en/developers/03_Backend/05_Extensions.md

@@ -2,9 +2,9 @@
 
 ## About FreshRSS
 
-FreshRSS is an RSS / Atom feeds aggregator written in PHP since October 2012. The official site is located at [freshrss.org](https://freshrss.org) and its repository is hosted by Github: [github.com/FreshRSS/FreshRSS](https://github.com/FreshRSS/FreshRSS).
+FreshRSS is an RSS / Atom feed aggregator written in PHP dating back to October 2012. The official site is located at [freshrss.org](https://freshrss.org) and the official repository is hosted on Github: [github.com/FreshRSS/FreshRSS](https://github.com/FreshRSS/FreshRSS).
 
-## Problem to solve
+## The problem
 
 FreshRSS is limited in its technical possibilities by various factors:
 
@@ -18,7 +18,7 @@ Another solution consists of an extension system. By allowing users to write the
 
 1. Reducing the amount of source code a new contributor has to take in
 2. Unofficial integration of novelties
-3. No necessity of forking or main developer approvement.
+3. No forking or main developer approval required.
 
 Note: it is quite conceivable that the functionalities of an extension can later be officially integrated into the FreshRSS code. Extensions make it easy to propose a proof of concept.
 
@@ -30,10 +30,10 @@ This data sheet should refer to the official FreshRSS and Minz documentation (th
 
 ### MVC Architecture
 
-Minz relies on and imposes an MVC architecture for projects using it. This architecture consists of three main components:
+Minz relies on and imposes an MVC architecture on projects using it. This architecture consists of three main components:
 
 * The model: this is the base object that we will manipulate. In FreshRSS, categories, flows and articles are templates. The part of the code that makes it possible to manipulate them in a database is also part of the model but is separated from the base model: we speak of DAO (for "Data Access Object"). The templates are stored in a `Models` folder.
-* The view: this is what the user sees. The view is therefore simply HTML code mixed with PHP to display dynamic information. The views are stored in an `views` folder.
+* The view: this is what the user sees. The view is therefore simply HTML code mixed with PHP to display dynamic information. The views are stored in a `views` folder.
 * The controller: this is what makes it possible to link models and views. Typically, a controller will load templates from the database (like a list of items) to "pass" them to a view for display. Controllers are stored in a `Controllers` directory.
 
 ### Routing
@@ -64,7 +64,7 @@ When loading the address http://exemple.com?c=hello&a=world, the `world` action
 
 Note: if `c` or `a` is not specified, the default value for each of these variables is `index`. So the address http://exemple.com?c=hello will execute the `index` action of the `hello` controller.
 
-Later, the `hello/world` convention will be used to refer to a controller/action pair.
+From now on, the `hello/world` naming convention will be used to refer to a controller/action pair.
 
 ### Views
 
@@ -123,7 +123,7 @@ To take full advantage of the Minz routing system, it is strongly discouraged to
 </p>
 ```
 
-Should it be decided one day to use a "url rewriting" system to have addresses in a http://exemple.com/controller/action format, all previous addresses would become ineffective!
+If one day it was decided to use a "url rewriting" system to have addresses in a http://exemple.com/controller/action format, all previous addresses would become ineffective!
 
 So use the `Minz_Url` class and its `display()` method instead. `Minz_Url::display()` takes an array of the following form as its argument:
 
@@ -144,7 +144,7 @@ echo Minz_Url::display($url_array);
 ?>
 ```
 
-Since this can become a bit tedious to use in the long run, especially in views, it is preferable to use the `_url()' shortcut:
+Since this can become a bit tedious to use in the long run, especially in views, it is preferable to use the `_url()` shortcut:
 
 ```php
 <?php
@@ -192,8 +192,8 @@ $url_array = [
 	'c' => 'hello',
 	'a' => 'world',
 ];
-$feedback_good = 'Tout s\'est bien passé !';
-$feedback_bad = 'Oups, quelque chose n\'a pas marché.';
+$feedback_good = 'All went well!';
+$feedback_bad = 'Oops, something went wrong.';
 
 Minz_Request::good($feedback_good, $url_array);
 
@@ -210,17 +210,17 @@ It is common (and that's an understatement) to want to show some text to the use
 
 The solution is to use the `Minz_Translate` class, which allows dynamic translation of FreshRSS (or any Minz-based application). Before using this module, it is necessary to know where to find the strings to be translated. Each language has its own subdirectory in a parent directory named `i18n`. For example, English language files are located in `i18n/fr/`. There are seven different files:
 
-- `admin.php` for anything related to FreshRSS administration
-- `conf.php` for configuration
-- `feedback.php` contains translations of feedback messages
-- `gen.php` stores what is global to FreshRSS (gen for "general")
-- `index.php` for the main page that lists feeds and the About page
-- `install.php` contains strings related FreshRSS installation
-- `sub.php` for subscription management (sub for "subscription")
+* `admin.php` for anything related to FreshRSS administration
+* `conf.php` for configuration
+* `feedback.php` contains translations of feedback messages
+* `gen.php` stores what is global to FreshRSS (gen for "general")
+* `index.php` for the main page that lists feeds and the About page
+* `install.php` contains strings related FreshRSS installation
+* `sub.php` for subscription management (sub for "subscription")
 
 This organization makes it possible to avoid a single huge translation file.
 
-The translation files are quite simple: it is only a matter of returning a PHP table containing the translations. Extract from `app/i18n/en/gen.php`:
+The translation files are quite simple: it's only a matter of returning a PHP table containing the translations. As an example, here's an extract from `app/i18n/fr/gen.php`:
 
 ```php
 <?php
@@ -263,7 +263,7 @@ There is a small special case that sometimes makes life easier: the `_` identifi
 
 Here we are! We've talked about the most useful features of Minz and how to run FreshRSS correctly and it's about time to address the extensions themselves.
 
-An extension allows you to add functionality easily to FreshRSS without having to touch the core of the project directly.
+An extension allows you to easily add functionality to FreshRSS without having to touch the core of the project directly.
 
 ### Basic files and folders
 
@@ -273,8 +273,8 @@ The convention requires that the main directory name be preceded by an "x" to in
 
 The main directory of an extension must contain at least two **mandatory** files:
 
-- A `metadata.json` file that contains a description of the extension. This file is written in JSON.
-- An `extension.php` file containing the entry point of the extension (which is a class that inherits Minz_Extension).
+* A `metadata.json` file that contains a description of the extension. This file is written in JSON.
+* An `extension.php` file containing the entry point of the extension (which is a class that inherits Minz_Extension).
 
 Please note that there is a not a required link between the directory name of the extension and the name of the class inside `extension.php`,
 but you should follow our best practice:
@@ -292,11 +292,11 @@ There is an example HelloWorld extension that you can download from [our GitHub
 
 You may also need additional files or subdirectories depending on your needs:
 
-- `configure.phtml` is the file containing the form to parameterize your extension
-- A `static/` directory containing CSS and JavaScript files that you will need for your extension (note that if you need to write a lot of CSS it may be more interesting to write a complete theme)
-- A `Controllers` directory containing additional controllers
-- An `i18n` directory containing additional translations
-- `layout` and` views` directories to define new views or to overwrite the current views
+* `configure.phtml` is the file containing the form to parameterize your extension
+* A `static/` directory containing CSS and JavaScript files that you will need for your extension (note that if you need to write a lot of CSS it may be more interesting to write a complete theme)
+* A `Controllers` directory containing additional controllers
+* An `i18n` directory containing additional translations
+* `layout` and` views` directories to define new views or to overwrite the current views
 
 In addition, it is good to have a `LICENSE` file indicating the license under which your extension is distributed and a` README` file giving a detailed description of it.
 
@@ -304,16 +304,16 @@ In addition, it is good to have a `LICENSE` file indicating the license under wh
 
 The `metadata.json` file defines your extension through a number of important elements. It must contain a valid JSON array containing the following entries:
 
-- `name` : the name of your extension
-- `author` : your name, your e-mail address ... but there is no specific format to adopt
-- `description` : a description of your extension
-- `version` : the current version number of the extension
-- `entrypoint` : Indicates the entry point of your extension. It must match the name of the class contained in the file `extension.php` without the suffix` Extension` (so if the entry point is `HelloWorld`, your class will be called` HelloWorldExtension`)
-- `type` : Defines the type of your extension. There are two types: `system` and` user`. We will study this difference right after.
+* `name`: the name of your extension
+* `author`: your name, your e-mail address ... but there is no specific format to adopt
+* `description`: a description of your extension
+* `version`: the current version number of the extension
+* `entrypoint`: Indicates the entry point of your extension. It must match the name of the class contained in the file `extension.php` without the suffix` Extension` (so if the entry point is `HelloWorld`, your class will be called` HelloWorldExtension`)
+* `type`: Defines the type of your extension. There are two types: `system` and` user`. We will study this difference right after.
 
 Only the `name` and` entrypoint` fields are required.
 
-### Choose between « system » or « user »
+### Choosing between `system` and `user`
 
 A __user__ extension can be enabled by some users and not by others (typically for user preferences).
 
@@ -327,24 +327,24 @@ In addition, this class must be inherited from the `Minz_Extension` class to ben
 
 Your class will benefit from four methods to redefine:
 
-- `install()` is called when a user clicks the button to activate your extension. It allows, for example, to update the database of a user in order to make it compatible with the extension. It returns `true` if everything went well or, if not, a string explaining the problem.
-- `uninstall()` is called when a user clicks the button to disable your extension. This will allow you to undo the database changes you potentially made in `install ()`. It returns `true` if everything went well or, if not, a string explaining the problem.
-- `init()` is called for every page load *if the extension is enabled*. It will therefore initialize the behavior of the extension. This is the most important method.
-- `handleConfigureAction()` is called when a user loads the extension management panel. Specifically, it is called when the `?c=extension&a=configured&e=name-of-your-extension` URL is loaded. You should also write here the behavior you want when validating the form in your `configure.phtml` file.
+* `install()` is called when a user clicks the button to activate your extension. It allows, for example, to update the database of a user in order to make it compatible with the extension. It returns `true` if everything went well or, if not, a string explaining the problem.
+* `uninstall()` is called when a user clicks the button to disable your extension. This will allow you to undo the database changes you potentially made in `install ()`. It returns `true` if everything went well or, if not, a string explaining the problem.
+* `init()` is called for every page load *if the extension is enabled*. It will therefore initialize the behavior of the extension. This is the most important method.
+* `handleConfigureAction()` is called when a user loads the extension management panel. Specifically, it is called when the `?c=extension&a=configured&e=name-of-your-extension` URL is loaded. You should also write here the behavior you want when validating the form in your `configure.phtml` file.
 
 In addition, you will have a number of methods directly inherited from `Minz_Extension` that you should not redefine:
 
-- The "getters" first: most are explicit enough not to detail them here - `getName()`, `getEntrypoint()`, `getPath()` (allows you to retrieve the path to your extension), `getAuthor()`, `getDescription()`, `getVersion()`, `getType()`.
-- `getFileUrl($filename, $type)` will return the URL to a file in the `static` directory. The first parameter is the name of the file (without `static /`), the second is the type of file to be used (`css` or` js`).
-- `registerController($base_name)` will tell Minz to take into account the given controller in the routing system. The controller must be located in your `Controllers` directory, the name of the file must be` <base_name>Controller.php` and the name of the `FreshExtension_<base_name>_Controller` class.
+* The "getters" first: most are explicit enough not to detail them here - `getName()`, `getEntrypoint()`, `getPath()` (allows you to retrieve the path to your extension), `getAuthor()`, `getDescription()`, `getVersion()`, `getType()`.
+* `getFileUrl($filename, $type)` will return the URL to a file in the `static` directory. The first parameter is the name of the file (without `static /`), the second is the type of file to be used (`css` or` js`).
+* `registerController($base_name)` will tell Minz to take into account the given controller in the routing system. The controller must be located in your `Controllers` directory, the name of the file must be` <base_name>Controller.php` and the name of the `FreshExtension_<base_name>_Controller` class.
 
 **TODO**
 
-- `registerViews()`
-- `registerTranslates()`
-- `registerHook($hook_name, $hook_function)`
+* `registerViews()`
+* `registerTranslates()`
+* `registerHook($hook_name, $hook_function)`
 
-### The « hooks » system
+### The "hooks" system
 
 You can register at the FreshRSS event system in an extensions `init()` method, to manipulate data when some of the core functions are executed.
 
@@ -363,16 +363,16 @@ class HelloWorldExtension extends Minz_Extension
 
 The following events are available:
 
-- `entry_before_display` (`function($entry) -> Entry | null`): will be executed every time an entry is rendered. The entry itself (instance of FreshRSS\_Entry) will be passed as parameter.
-- `entry_before_insert` (`function($entry) -> Entry | null`): will be executed when a feed is refreshed and new entries will be imported into the database. The new entry (instance of FreshRSS\_Entry) will be passed as parameter.
-- `feed_before_insert` (`function($feed) -> Feed | null`): will be executed when a new feed is imported into the database. The new feed (instance of FreshRSS\_Feed) will be passed as parameter.
-- `freshrss_init` (`function() -> none`): will be executed at the end of the initialization of FreshRSS, useful to initialize components or to do additional access checks
-- `menu_admin_entry` (`function() -> string`): add an entry at the end of the "Administration" menu, the returned string must be valid HTML (e.g. `<li class="item active"><a href="url">New entry</a></li>`)
-- `menu_configuration_entry` (`function() -> string`): add an entry at the end of the "Configuration" menu, the returned string must be valid HTML (e.g. `<li class="item active"><a href="url">New entry</a></li>`)
-- `menu_other_entry` (`function() -> string`): add an entry at the end of the header dropdown menu (i.e. after the "About" entry), the returned string must be valid HTML (e.g. `<li class="item active"><a href="url">New entry</a></li>`)
-- `nav_reading_modes` (`function($reading_modes) -> array | null`): **TODO** add documentation
-- `post_update` (`function(none) -> none`): **TODO** add documentation
-- `simplepie_before_init` (`function($simplePie, $feed) -> none`): **TODO** add documentation
+* `entry_before_display` (`function($entry) -> Entry | null`): will be executed every time an entry is rendered. The entry itself (instance of FreshRSS\_Entry) will be passed as parameter.
+* `entry_before_insert` (`function($entry) -> Entry | null`): will be executed when a feed is refreshed and new entries will be imported into the database. The new entry (instance of FreshRSS\_Entry) will be passed as parameter.
+* `feed_before_insert` (`function($feed) -> Feed | null`): will be executed when a new feed is imported into the database. The new feed (instance of FreshRSS\_Feed) will be passed as parameter.
+* `freshrss_init` (`function() -> none`): will be executed at the end of the initialization of FreshRSS, useful to initialize components or to do additional access checks
+* `menu_admin_entry` (`function() -> string`): add an entry at the end of the "Administration" menu, the returned string must be valid HTML (e.g. `<li class="item active"><a href="url">New entry</a></li>`)
+* `menu_configuration_entry` (`function() -> string`): add an entry at the end of the "Configuration" menu, the returned string must be valid HTML (e.g. `<li class="item active"><a href="url">New entry</a></li>`)
+* `menu_other_entry` (`function() -> string`): add an entry at the end of the header dropdown menu (i.e. after the "About" entry), the returned string must be valid HTML (e.g. `<li class="item active"><a href="url">New entry</a></li>`)
+* `nav_reading_modes` (`function($reading_modes) -> array | null`): **TODO** add documentation
+* `post_update` (`function(none) -> none`): **TODO** add documentation
+* `simplepie_before_init` (`function($simplePie, $feed) -> none`): **TODO** add documentation
 
 ### Writing your own configure.phtml
 

docs/en/developers/05_Release_new_version.md

@@ -1 +1,111 @@
-**TODO**
+# Preparing the release
+
+In order to get as much feedback as possible before a release, it's preferable to announce it on GitHub by creating a dedicated ticket ([see examples] (https://github.com/FreshRSS/FreshRSS/search?utf8=%E2%9C%93&q=Call+for+testing&type=Issues)). This should be done **at least one week in advance**.
+
+It's also recommended to make the announcement on mailing@freshrss.org.
+
+# Check the dev status
+
+Before releasing a new version of FreshRSS, you must ensure that the code is stable and free of major bugs. Ideally, our tests should be automated and executed before any publication.
+
+You must also **make sure that the CHANGELOG file is up to date** in the dev branch with the updates of the version(s) to be released.
+
+# Git process
+
+```bash
+$ git checkout master
+$ git pull
+$ git merge --ff dev
+$ vim constants.php
+# Update version number x.y.y.z of FRESHRSS_VERSION
+$ git commit -a
+Version x.y.z
+$ git tag -a x.y.z
+Version x.y.z
+$ git push && git push --tags
+```
+
+# Updating `update.freshrss.org`
+
+It's important to update update.freshrss.org since this is the default service for automatic FreshRSS updates.
+
+The repository managing the code is located on GitHub: [FreshRSS/update.freshrss.org] (https://github.com/FreshRSS/update.freshrss.org/).
+
+## Writing the update script
+
+The scripts are located in the `./scripts/` directory and must take the form `update_to_x.y.z.z.php`. This directory  also contains `update_to_dev.php` intended for updates of the dev branch (this script must not include code specific to a particular version!) and `update_util.php`, which contains a list of functions useful for all scripts.
+
+In order to write a new script, it's better to copy/paste the last version or to start from `update_to_dev.php`. The first thing to do is to define the URL from which the FreshRSS package will be downloaded (`PACKAGE_URL`). The URL is in the form  of `https://codeload.github.com/FreshRSS/FreshRSS/zip/x.y.z`.
+
+There are then 5 functions that have to be executed:
+
+* `apply_update()` takes care of saving the directory containing the data, checking its structure, downloading the FreshRSS package, deploying it and cleaning it all up. This function is pre-filled but adjustments can be made if necessary (e.g., reorganization of the `./data` structure). It returns `true` if no problem has occurred or a string indicating a problem;
+* `need_info_update()` returns `true` if the user must intervene during the update or `false` if not;
+* `ask_info_update()` displays a form to the user if `need_info_update()` has returned `true`;
+* `save_info_update()` is responsible for saving the information filled out by the user (from the `ask_info_update()` form);
+* `do_post_update()` is executed at the end of the update and takes into account the code of the new version (e.g., if the new version changes the `Minz_Configuration` object, you will benefit from these improvements).
+
+## Updating the versions file
+
+Once the script has been written and versioned, it's necessary to update the `./versions.php' file which contains a mapping table indicating which versions are updated to which other versions.
+
+Here's an example of a `versions.php` file:
+
+```php
+<?php
+return array(
+	// STABLE
+	'0.8.0' => '1.0.0',
+	'0.8.1' => '1.0.0',
+	'1.0.0' => '1.0.1',  // doesn't exist (yet)
+	// DEV
+	'1.1.2-dev' => 'dev',
+	'1.1.3-dev' => 'dev',
+	'1.1.4-dev' => 'dev',
+);
+```
+
+And here's how this table works:
+
+* on the left you can find the N version, on the right the N+1 version;
+* the `x.y.z.z-dev` versions are **all** updated to `dev`;
+* stable versions are updated to stable versions;
+* it's possible to skip several versions at once, provided that the update scripts support it;
+* it's advisable to indicate the correspondence of the current version to its potential future version by specifying that this version does not yet exist. As long as the corresponding script does not exist, nothing will happen.
+
+It's **very strongly** recommended to keep this file organized according to version numbers by separating stable and dev versions.
+
+## Deployment
+
+Before updating update.freshrss.org, it's better to test with dev.update.freshrss.org, which corresponds to pre-production. So update dev.update.freshrss.org and change the `FRESHRSS_UPDATE_WEBSITE` URL of your FreshRSS instance. Start the update and check that it's running correctly.
+
+When you're satisfied, update update.freshrss.org with the new script, test it again, and then move on.
+
+# Updating the FreshRSS services
+
+Two services need to be updated immediately after the update.
+
+* rss.freshrss.org;
+* demo.freshrss.org (public login: `demo` / `demodemo`).
+
+# Publicly announce the release
+
+When everything's working, it's time to announce the release to the world!
+
+* on GitHub by creating[a new release](https://github.com/FreshRSS/FreshRSS/releases/new)
+* on the freshrss.org blog, at least for stable versions (write the article on[FreshRSS/freshrss.org](https://github.com/FreshRSS/freshrss.org))
+* on Twitter ([@FreshRSS](https://twitter.com/FreshRSS) account)
+* and on mailing@freshrss.org
+
+# Starting the next development version
+
+```bash
+$ git checkout dev
+$ vim constants.php
+# Update the FRESHRSS_VERSION
+$ vim CHANGELOG.md
+# Prepare the changelog for the next version
+$ git add CHANGELOG.md && git commit && git push
+```
+
+Also remember to update update.freshrss.org so that it takes the current development version into account.

docs/en/index.md

@@ -4,17 +4,17 @@ FreshRSS is an RSS aggregator and reader. It allows you to read and follow sever
 
 FreshRSS has a lot of features including:
 
-- RSS and Atom aggregation
-- Mark article as favorite if you liked it or if you want to read it later
-- Filter and search functionality helps to easily find articles
-- Statistics to show you the publishing frequency all the websites you follow
-- Import/export of your feeds into OPML format
-- Several themes created by the community
-- "Google Reader"-like API to connect Android applications
-- The application is "responsive," which means it adapts to small screens so you can bring articles in your pocket
-- Self-hosted: the code is free (under AGPL3 licence), so you can host your own instance of FreshRSS
-- Multi-user, so you can also host for your friends and family
-- And a lot more!
+* RSS and Atom aggregation
+* Mark article as favorite if you liked it or if you want to read it later
+* Filter and search functionality helps to easily find articles
+* Statistics to show you the publishing frequency all the websites you follow
+* Import/export of your feeds into OPML format
+* Several themes created by the community
+* "Google Reader"-like API to connect Android applications
+* The application is "responsive," which means it adapts to small screens so you can bring articles in your pocket
+* Self-hosted: the code is free (under AGPL3 licence), so you can host your own instance of FreshRSS
+* Multi-user, so you can also host for your friends and family
+* And a lot more!
 
 This documentation is split into different sections:
 

docs/en/users/02_First_steps.md

@@ -1,21 +1,20 @@
-Learning how to handle a new application is not always easy. We build FreshRSS to be intuitive, but you will need some guidance to get your hand on it.
+Learning how to handle a new application is not always easy. We've tried to make FreshRSS as intuitive as possible, but you might still need a little help to master the program.
 
-This section guides you to the pages you need as a new comer.
+This section will guide you to the pages you need to get started. The order is tailored to newcomers.
 
 [After installing the application](../admins/03_Installation.md), the first step is to add some feeds. You have a few options:
 
 1. [Add a feed manually](04_Subscriptions.md#adding-a-feed)
 2. [Import an OPML or JSON file](04_Subscriptions.md#import-and-export)
 3. [Use the bookmarklet](04_Subscriptions.md#use-bookmarklet)
-4. [Firefox integration](04_Subscriptions.md#firefox-subscription-service)
 
-Once you have added your feeds to FreshRSS, it is time to read them. You have access to three reading modes:
+Once you have added your feeds to FreshRSS, it is time to read them. There are three availalbe reading modes:
 
-1. [The normal view](03_Main_view.md#normal-view) which allows you to display and read quickly new articles
-2. [The global view](03_Main_view.md#global-view) which allows you to see in one glance the status of your feeds
-3. [The reader view](03_Main_view.md#reader-view) which allows you to have a nice reading experience.
+1. [The normal view](03_Main_view.md#normal-view) enables you to quickly read new articles
+2. [The global view](03_Main_view.md#global-view) shows you an overview of the status of your feeds in one glance
+3. [The reader view](03_Main_view.md#reader-view) offers you a comfortable reading experience
 
-Now that you know the basic usages, it is time to configure FreshRSS to improve your reading experience. It has a lot of options, so play with them to find your perfect configuration. However, here is few resources to help you:
+Now that you've mastered basic use, it's time to configure FreshRSS to improve your reading experience. It's highly configurable, so it's recommended to play around with them to find a configuration that suits you well. Here are a few resources to help you improve your daily FreshRSS experience:
 
 * [Organize your feeds in categories](04_Subscriptions.md#feed-management)
 * [Change the home page](05_Configuration.md#changing-the-view)

docs/en/users/03_Main_view.md

@@ -12,7 +12,7 @@
 
 # Refreshing feeds
 
-To use FreshRSS at its full potential, it needs to grab subscribed feeds new articles. To do so, you have several methods available.
+To take full advantage of FreshRSS, it needs to retrieve new items from the feeds you have subscribed to. There are several ways to do this.
 
 ## Automatic update
 
@@ -20,7 +20,7 @@ This is the recommended method since you can forget about it once it is configur
 
 ### With the actualize_script.php script
 
-This method is available only if you have access to the installation server scheduled tasks.
+This method is only available if you have access to the scheduled tasks of the machine on which your FreshRSS instance is installed.
 
 The script is named *actualize_script.php* and is located in the *app* folder. The scheduled task syntax will not be explained here. However, here is [a quick introduction to crontab](http://www.adminschoice.com/crontab-quick-reference/) that might help you.
 
@@ -68,13 +68,13 @@ If you configure the application to allow anonymous reading, you can also allow
 
 ![Anonymous access configuration](../img/users/anonymous_access.1.png)
 
-The URL used in the previous section becomes accessible and therefore, you can use the same syntax for the scheduled task.
+The URL used in the previous section will now become accessible to anyone. Therefore you can use the same syntax for the scheduled task.
 
-You can also configure an authentication token to grant a special right on the server.
+You can also configure an authentication token to grant special access on the server.
 
 ![Token configuration](../img/users/token.1.png)
 
-The scheduled task syntax to use will be the following:
+The scheduled task syntax should look as follows:
 
 ```cron
 0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&token=my-token'
@@ -88,7 +88,7 @@ You can also target a different user by adding their username to the query strin
 
 ### HTTP authentication
 
-In that case, the syntax in the two previous section are unusable. It means that you need to provide your credentials to the scheduled task. **Note that this method is highly discouraged since it means that your credentials will be in plain sight!**
+When using HTTP authentication, the syntax in the two previous sections is unusable. You'll need to provide your credentials to the scheduled task. **Note that this method is highly discouraged since it means that your credentials will be in plain sight!**
 
 ```cron
 0 * * * * curl -u alice:password123 'https://freshrss.example.net/i/?c=feed&a=actualize'
@@ -96,11 +96,11 @@ In that case, the syntax in the two previous section are unusable. It means that
 
 ## Manual update
 
-If you cannot or do not want to use the automatic methods, you can make it manually. There is two ways, the partial or the complete update.
+If you can't or don't want to use the automatic method, you can update manually. There are two methods for updating all or some of the feeds.
 
 ### Complete update
 
-This update occurs on all feeds. To trigger it, you need to click on the navigation menu update link.
+This update occurs on all feeds. To trigger it, simply click on the update link in the navigation menu.
 
 ![Navigation menu](../img/users/refresh.1.png)
 
@@ -110,24 +110,24 @@ When the update starts, a progress bar appears and changes while feeds are proce
 
 ### Partial update
 
-This update occurs on the selected feed only. To trigger it, you need to click on the feed menu update link.
+This update occurs on the selected feed only. To trigger it, simply click on the update link in the feed menu.
 
 ![Feed menu](../img/users/refresh.2.png)
 
 # Filtering articles
 
-While the number of articles stored by FreshRSS increase, it is important to have efficient filters to display only a subset of the articles. There is several methods with different criterion. Most of the time, those methods can be combined.
+When the number of articles stored by FreshRSS inevitably grows larger, it's important to use efficient filters to display only a subset of the articles. There are several methods that filter with different criteria. Usually those methods can be combined.
 
 ## By category
 
-This is the easiest method. You only need to click on the category title in the side panel. There are two special categories on top of that panel:
+This is the easiest method. You only need to click on the category title in the side panel. There are two special categories at the top of the panel:
 
-  * *Main feed* which displays only articles from feeds marked as available in that category
-  * *Favourites* which displays only articles marked as favourites
+  * *Main feed* displays only articles from feeds marked as available in that category
+  * *Favourites* displays only articles marked as favourites
 
 ## By feed
 
-There is several methods to filter articles by feed:
+There are several methods to filter articles by feed:
 
   * by clicking the feed title in the side panel
   * by clicking the feed title in the article details
@@ -138,9 +138,9 @@ There is several methods to filter articles by feed:
 
 ## By status
 
-Each article has two attributes, which can be combined. The first attribute indicates if the article was read or not. The second attribute indicates if the article was marked as favorite or not.
+Each article has two attributes that can be combined. The first attribute indicates whether or not the article has been read. The second attribute indicates if the article was marked as favorite or not.
 
-With version 0.7, attribute filters are available in the article display dropdown list. With this version, it is not possible to combine those filters. For instance, it is not possible to display only read and favourite articles.
+In version 0.7, attribute filters are available in the article display dropdown list. With this version, it's not possible to combine filters. For instance, it's not possible to display only read and favorite articles.
 
 ![Attribute filters in 0.7](../img/users/status.filter.0.7.png)
 
@@ -156,7 +156,7 @@ It is possible to filter articles by their content by inputting a string in the
 
 ## With the search field
 
-It is possible to use the search field to further refine results:
+You can use the search field to further refine results:
 
 * by author: `author:name` or `author:'composed name'`
 * by title: `intitle:keyword` or `intitle:'composed keyword'`
@@ -197,12 +197,12 @@ It is possible to use the search field to further refine results:
 		* `date:P1DT1H/` (past one day and one hour)
 * by date of publication, using the same format: `pubdate:<date-interval>`
 
-Beware that there is no space between the operator and the value.
+Be careful not to enter a space between the operator and the search value.
 
 Some operators can be used negatively, to exclude articles, with the same syntax as above, but prefixed by a `!` or `-`:
 `-author:name`, `-intitle:keyword`, `-inurl:keyword`, `-#tag`, `!keyword`.
 
-It is also possible to combine operators to have a very sharp filter, and it is allowed to have multiple instances of `author:`, `intitle:`, `inurl:`, `#`, and free-text.
+It is also possible to combine keywords to create a more precise filter. For example, you can enter multiple instances of `author:`, `intitle:`, `inurl:`, `#`, and free-text.
 
 Combining several search criteria implies a logical *and*, but the keyword ` OR ` can be used to combine several search criteria with a logical *or* instead:
 `author:Dupont OR author:Dupond`

docs/en/users/04_Subscriptions.md

@@ -8,7 +8,7 @@
 
 # Use bookmarklet
 
-Bookmarklets are little scripts that you can execute to perform useful or frivolous tasks. FreshRSS offers a bookmarklet for subscribing to newsfeeds.
+Bookmarklets are little scripts that you can execute to perform various tasks. FreshRSS offers a bookmarklet for subscribing to newsfeeds.
 
  1. Open "Subscriptions management".
  2. Click on "Subscription tools".
@@ -17,23 +17,3 @@ Bookmarklets are little scripts that you can execute to perform useful or frivol
 # Feed management
 
 **TODO**
-
-# Firefox subscription service
-
-NB: From version 63 and onwards Firefox has removed the ability to add your own subscription services that aren't standalone programs. This makes it impossible to add FreshRSS to the feed preview/subscription page, though this page is set to be removed from version 64 anyway (see [bugzilla](https://bugzilla.mozilla.org/show_bug.cgi?id=1477667)). You can use the bookmarklet mentioned above for an easy way to subscribe to feeds.
-
-If you're using a version pre-63 you can manually add your FreshRSS app to the list of Firefox subscription services, which enables you to subscribe to sites which provide a feed link using the Firefox built-in "Subscribe" button. An in-depth process is described in the [official documentation](https://developer.mozilla.org/en-US/Firefox/Releases/2/Adding_feed_readers_to_Firefox) but you can use the following steps:
-
-  1. Open about:config in Firefox
-
-  2. Search for "browser.contentHandlers.types." and note the highest number following the returned strings (ie if yo see browser.contentHandlers.types.1.something up to browser.contentHandlers.types.5.somethingelse etc. the highest number is 5). Your contentHandler will have to have a free number so just pick one higher than currently registered (you would chose six in above example).
-
-  3. You will have to add three new strings to your about config (replace %NUMBER% with the number from previous step and example.com with your installation address):
-
-  | Preference name                              | Value                                                      | Note                                                      |
-  | -------------------------------------------- | ---------------------------------------------------------- | --------------------------------------------------------- |
-  | browser.contentHandlers.types.%NUMBER%.title | **FreshRSS**                                               | Use any name you would like (ie. "My feeds")              |
-  | browser.contentHandlers.types.%NUMBER%.type  | **application/vnd.mozilla.maybe.feed**                     | Do not change this value!                                 |
-  | browser.contentHandlers.types.%NUMBER%.uri   | **http://EXAMPLE.COM/FreshRss/i?c=feed&a=add&url_rss=%s** | Replace base url with yours and switch to https (if used) |
-
-  4. Restart Firefox and you can subscribe to sites with the Firefox built-in "Subscribe" button. Just select the name you set under the first Preference name from the dropdown (you can also make it default with the checbox) and you will be redirected to FreshRSS subscription settings (you must be logged in).

docs/en/users/05_Configuration.md

@@ -3,17 +3,17 @@
 
 ## Language
 
-At the moment, FreshRSS is available in 13 languages. After you confirm your choice, the interface will be displayed in the chosen language.
-Depending on the chosen language, there might be parts of the interface that are still not translated. If you're willing to help translating
-the missing bits or add a new language, please check how you can [contribute to the project](../contributing.md#contribute-to-internationalization-i18n).
+FreshRSS is currently available in 14 languages. After confirming your choice, the interface will be displayed in your preferred language.
+Depending on the language chosen, parts of the interface may not be not translated yet. If you're willing to help translate
+the missing bits or would like to add a new language, please take a look at how you can [contribute to the project](../contributing.md#contribute-to-internationalization-i18n).
 
-There are parts of FreshRSS that are not translated and are not intended to be translated. For now, the logs visible in the application as well as the one generated by automatic update scripts are part of it.
+Some parts of FreshRSS aren't translated and aren't intended to be translated either. For now, this includes the logs visible in the application as well as the log generated by automatic update scripts.
 
 Available languages are: cz, de, en, es, fr, he, it, kr, nl, oc, pt-br, ru, tr, zh-cn.
 
 ## Theme
 
-In matters of taste and color, there can be no disputes. This is why FreshRSS offers eight official themes:
+There's no accounting for tastes, which is why FreshRSS offers eight official themes:
 
  * *Blue Lagoon* by **Mister aiR**
  * *Dark* by **AD**
@@ -22,24 +22,24 @@ In matters of taste and color, there can be no disputes. This is why FreshRSS of
  * *Origine-compact* by **Kevin Papst**
  * *Pafat* by **Plopoyop**
  * *Screwdriver* by **Mister aiR**
- * *Swage* par **Patrick Crandol**
+ * *Swage* by **Patrick Crandol**
 
-If none of these are suitable for you, it is always possible to [create your own](../developers/04_Frontend/02_Design.md).
+If you can't find any themes you like, it's always possible to [create your own](../developers/04_Frontend/02_Design.md).
 
 To select a theme, simply scroll through the themes and select one that strikes your fancy. After confirmation, the theme will be applied to the interface.
 
 ## Content width
 
-There are some who prefer short lines of text while others prefer to maximize the available screen space. To satisfy the maximum number of people it is possible to choose the width of the displayed content. There are four settings available:
+Some people prefer short lines of text, while others prefer to maximize the available screen space. To satisfy the maximum number of people, it's possible to customize the width of the displayed content. There are four settings available:
 
- * **Fine** which displays content up to 550 pixels
- * **Medium** which displays content up to 800 pixels
- * **Large** which displays content up to 1000 pixels
- * **No limit** which displays the content on 100% of the available space
+ * **Fine** displays content up to a maximum width of 550 pixels
+ * **Medium** displays content up to a maximum width of 800 pixels
+ * **Large** displays content up to a maximum width of 1000 pixels
+ * **No limit** displays the content on 100% of the available space
 
 ## Article icons
 
-It worth noting that this section only has effects in normal view.
+Please note that this section only affects normal view.
 
 ![Article icons configuration](../img/users/configuration.article.icons.png)
 
@@ -47,12 +47,12 @@ Each article is rendered with a header (top line) and a footer (bottom line).
 In that section, you can choose what will be displayed in those.
 
 If you disable every item in the top line, you'll still be able to see it since
-there is the feed name and the article title. But if you do the same thing for
+it contains the feed name and the article title. But if you do the same thing for
 the bottom line, it will be empty.
 
 ## HTML5 notification timout
 
-After the automatic updates of the feeds, FreshRSS uses the HTML5 notification API to notify of the arrival of new articles.
+After automatically updating the feeds, FreshRSS can pop up a notification using the HTML5 notification API.
 
 The duration of this notification can be set. By default, the value is 0.
 
@@ -68,29 +68,29 @@ If you don't use those buttons because you never browse on mobile or because you
 
 **TODO**
 
-# Archiving
+# Archival
 
 **TODO**
 
 # Sharing
 
-To make your life easier, you can share directly an article within FreshRSS.
+To make your life easier, you can share articles straight from FreshRSS.
 
-At the moment, FreshRSS supports 15 sharing methods ranging from self-hosted services (Shaarli, etc.) to proprietary services (Facebook, etc.).
+At the moment, FreshRSS supports 18 sharing methods, ranging from self-hosted services (Shaarli, etc.) to proprietary services (Facebook, etc.).
 
 By default, the sharing list is empty.
 ![Sharing configuration](../img/users/configuration.sharing.png)
 
-To add a new item in the list, follow those simple steps:
+To add a new item to the list, please follow the following simple steps:
 
- 1. Select the share method in the drop-down.
- 1. Press the ```✚``` sign to add it to the list.
- 1. Configure the method in the list. All method names can be modified in the display. Some methods need the sharing URL to be able to work properly (ex: Shaarli).
+ 1. Select the desired sharing method in the drop-down list.
+ 1. Press the ```✚``` button to add it to the list.
+ 1. Configure the method in the list. All  names can be modified in the display. Some methods need the sharing URL to be able to work properly (ex: Shaarli).
  1. Submit your changes.
 
 To remove an item from the list, follow those simple steps:
 
- 1. Press the ```❌``` sign next to the share method you want to remove.
+ 1. Press the ```❌``` button next to the share method you want to remove.
  1. Submit your changes.
 
 # Shortcuts
@@ -151,7 +151,7 @@ More information can be found in the [Apache documentation](http://httpd.apache.
 
 **TODO**
 
-## Archivage
+## Archival
 
 **TODO**
 
@@ -163,24 +163,24 @@ More information can be found in the [Apache documentation](http://httpd.apache.
 
 ### Retrieve a truncated stream from within FreshRSS
 
-The question comes up regularly, so we will try to clarify here how one can retrieve a truncated RSS feed with FreshRSS. Please note that the process is absolutely not "user friendly", but it works :)
+This question comes up regularly, so we'll try to clarify how one can retrieve a truncated RSS feed with FreshRSS. Please note that the process is absolutely not user friendly, but it works. :)
 
-Also know that this way you are generating much more traffic to the originating sites and that they might block you accordingly. The performance of FreshRSS is also negatively affected because you have to fetch the full article content one by one. So it's a feature to use sparingly!
+Please be aware that this way you'll generate much more traffic to the originating sites, and they might block you accordingly. FreshRSS performance is also negatively affected, because you'll have to fetch the full article content one by one. So it's a feature to use sparingly!
 
-What is meant by "CSS path of articles on the original site" actually corresponds to the "path" consisting of IDs and classes (which in html, matches the id and class attributes) to retrieve only the interesting part that corresponds to the article. Ideally, this path starts with an id (which is unique to the page).
+What's meant by "CSS path of articles on the original site" actually corresponds to the "path" consisting of IDs and classes (which in HTML, matches the id and class attributes) to retrieve only the interesting part that corresponds to the article. Ideally, this path starts with an id (which is unique to the page).
 
 #### Example: Rue89
 
-To find this path, you must go to the address of one of the truncated articles (for example http://www.rue89.com/2013/10/15/prof-maths-jai-atteint-lextase-dihn-pedagogie-inversee-246635). You must then look for the "block" of HTML corresponding to the content of the article (in the source code!).
+To find this path, you have to go to the address of one of the truncated articles (for example, http://www.rue89.com/2013/10/15/prof-maths-jai-atteint-lextase-dihn-pedagogie-inversee-246635). You look have to look for the "block" of HTML that corresponds to article content (in the source code!).
 
-We find here that the block that encompasses only the content of the article is ```<div class="content clearfix">```. We will only use the ".content" class here. Nevertheless, as said above, it is best to start the path with an id. If we go back to the parent block, this is the block ```<div id="article">``` and that's perfect! The path will be ```#article .content```.
+Here we find that the block that encompasses nothing but the content of the article is ```<div class="content clearfix">```. We'll only use the `.content` class here. Nevertheless, as said above, it's best to start the path with an id. If we go back to the parent block, we find ```<div id="article">``` and that's perfect! The path will be ```#article .content```.
 
-#### Add the corresponding classes to the articles CSS path on the feed configuration page. Examples:
+#### Add the corresponding classes to the article CSS path on the feed configuration page. Examples:
 
 *  Rue89: ```#article .content```
 *  PCINpact: ```#actu_content```
 *  Lesnumériques: ```article#body div.text.clearfix```
-*  Phoronix : ```#main .content```
+*  Phoronix: ```#main .content```
 
 ### Retrieve a truncated stream with external tools
 

docs/en/users/06_Fever_API.md

@@ -5,51 +5,52 @@ and general aspects of API access.
 
 ## RSS clients
 
-There are many RSS clients existing supporting Fever APIs but they seem to understand the Fever API a bit differently.
-If your favourite client does not work properly with this API, create an issue and we will have a look.
+There are many RSS clients that support the Fever API, but they seem to understand the Fever API a bit differently.
+If your favourite client doesn't work properly with this API, please create an issue and we'll have a look.
 But we can **only** do that for free clients.
 
 ### Usage & Authentication
 
-Before you can start to use this API, you have to enable and setup API access, which is [documented here](https://freshrss.github.io/FreshRSS/en/users/06_Mobile_access.html),
-and then re-set the user’s API password.
+Before you can start using this API, you have to enable and setup API access, which is [documented here](https://freshrss.github.io/FreshRSS/en/users/06_Mobile_access.html),
+and then reset the user’s API password.
 
-Then point your mobile application to the URL of `fever.php` (e.g. `https://freshrss.example.net/api/fever.php`).
+Then point your mobile application to the `fever.php` address (e.g. `https://freshrss.example.net/api/fever.php`).
 
-## Compatibility
+## Compatible clients
 
 Tested with:
 
-- Android
-  - [Readably](https://play.google.com/store/apps/details?id=com.isaiasmatewos.readably) (Closed source)
+* Android
+  * [Readably](https://play.google.com/store/apps/details?id=com.isaiasmatewos.readably) (Closed source)
 
-- iOS
-  - [Fiery Feeds](https://apps.apple.com/app/fiery-feeds-rss-reader/id1158763303) (Closed source)
-  - [Unread](https://apps.apple.com/app/unread-rss-reader/id1252376153) (Commercial)
-  - [Reeder](https://www.reederapp.com/) (Commercial) (Use its Google Reader API / native FreshRSS option when possible)
+* iOS
+  * [Fiery Feeds](https://apps.apple.com/app/fiery-feeds-rss-reader/id1158763303) (Closed source)
+  * [Unread](https://apps.apple.com/app/unread-rss-reader/id1252376153) (Commercial)
+  * [Reeder](https://www.reederapp.com/) (Commercial) (Use its Google Reader API / native FreshRSS option when possible)
 
-- MacOS
-  - [ReadKit](https://apps.apple.com/app/readkit/id588726889) (Commercial)
+* MacOS
+  * [ReadKit](https://apps.apple.com/app/readkit/id588726889) (Commercial)
 
 
 ## Features
 
-Following features are implemented:
+The following features are implemented:
 
-- fetching categories
-- fetching feeds
-- fetching RSS items (new, favorites, unread, by_id, by_feed, by_category, since)
-- fetching favicons
-- setting read marker for item(s)
-- setting starred marker for item(s)
-- setting read marker for feed
-- setting read marker for category
-- supports FreshRSS extensions, which use the `entry_before_display` hook
+* fetching categories
+* fetching feeds
+* fetching RSS items (new, favorites, unread, by_id, by_feed, by_category, since)
+* fetching favicons
+* setting read marker for item(s)
+* setting starred marker for item(s)
+* setting read marker for feed
+* setting read marker for category
+* supports FreshRSS extensions, which use the `entry_before_display` hook
 
-Following features are not supported:
-- **Hot Links** aka **hot** as there is nothing in FreshRSS yet that is similar or could be used to simulate it
+The following features are not supported:
 
-## Testing and error search
+* **Hot Links** aka **hot** as there is nothing in FreshRSS yet that is similar or could be used to simulate it.
+
+## Testing and debugging
 
 If this API does not work as expected in your RSS reader, you can test it manually with a tool like [Postman](https://www.getpostman.com/).
 
@@ -83,25 +84,25 @@ This should give:
 	"last_refreshed_on_time": "1520013061"
 }
 ```
-Perfect, you are authenticated and can now start testing the more advanced features. Therefor change the URL and append the possible API actions to your request parameters. Check the [original Fever documentation](https://feedafever.com/api) for more information.
+Perfect, you're now authenticated and you can start testing the more advanced features. To do so, change the URL and append the possible API actions to your request parameters. Please refer to the [original Fever documentation](https://feedafever.com/api) for more information.
 
 Some basic calls are:
 
-- https://freshrss.example.net/api/fever.php?api&items
-- https://freshrss.example.net/api/fever.php?api&feeds
-- https://freshrss.example.net/api/fever.php?api&groups
-- https://freshrss.example.net/api/fever.php?api&unread_item_ids
-- https://freshrss.example.net/api/fever.php?api&saved_item_ids
-- https://freshrss.example.net/api/fever.php?api&items&since_id=some_id
-- https://freshrss.example.net/api/fever.php?api&items&max_id=some_id
-- https://freshrss.example.net/api/fever.php?api&mark=item&as=read&id=some_id
-- https://freshrss.example.net/api/fever.php?api&mark=item&as=unread&id=some_id
+* https://freshrss.example.net/api/fever.php?api&items
+* https://freshrss.example.net/api/fever.php?api&feeds
+* https://freshrss.example.net/api/fever.php?api&groups
+* https://freshrss.example.net/api/fever.php?api&unread_item_ids
+* https://freshrss.example.net/api/fever.php?api&saved_item_ids
+* https://freshrss.example.net/api/fever.php?api&items&since_id=some_id
+* https://freshrss.example.net/api/fever.php?api&items&max_id=some_id
+* https://freshrss.example.net/api/fever.php?api&mark=item&as=read&id=some_id
+* https://freshrss.example.net/api/fever.php?api&mark=item&as=unread&id=some_id
 
 Replace `some_id` with a real ID from your `freshrss_username_entry` database.
 
 ### Debugging
 
-If nothing helps and your clients still misbehaves, add these lines to the start of `fever.api`:
+If nothing helps and your client is still misbehaving, you can add the following lines to the beginning of the `fever.api` file to determine the cause of the problems:
 
 ```php
 file_put_contents(__DIR__ . '/fever.log', $_SERVER['HTTP_USER_AGENT'] . ': ' . json_encode($_REQUEST) . PHP_EOL, FILE_APPEND);

docs/en/users/06_Mobile_access.md

@@ -44,7 +44,7 @@ See the [page about the Fever compatible API](06_Fever_API.md) for another possi
 # Compatible clients
 
 6. On the same FreshRSS API page, note the address given under “Your API address”, like `https://freshrss.example.net/api/greader.php`
-	* You will type it in a client, together with your FreshRSS username, and the corresponding special API password.
+	* Type the API address in a client, together with your FreshRSS username, and the corresponding special API password.
 
 7. Pick a client supporting a Google Reader-like API. Selection:
 	* Android

docs/en/users/07_Frequently_Asked_Questions.md

@@ -1,47 +1,47 @@
 We may not have answered all of your questions in the previous sections. The FAQ contains some questions that have not been answered elsewhere.
 
-## What is /i at the end of the application URL?
+## What is `/i` at the end of the application URL?
 
-Of course, ```/i``` has a purpose! We used it for performance and usability:
+Of course, ```/i``` has a purpose! It's used for performance and usability:
 
 * It allows for serving icons, images, styles and scripts without cookies. Without that trick, those files would be downloaded more often, especially when form authentication is used. Also, HTTP requests would be heavier.
-* ```./p/``` public root can be served without any HTTP access restrictions. Whereas it could be implemented in ```./p/i/```.
+* The ```./p/``` public root can be served without any HTTP access restrictions. Whereas it could be implemented in ```./p/i/```.
 * It avoids problems while serving public resources like ```favicon.ico```, ```robots.txt```, etc.
 * It allows the logo to be displayed instead of a white page while hitting a restriction or a delay during the loading process.
 
-## Why robots.txt is located in a sub-folder?
+## Why is `robots.txt` located in a sub-folder?
 
-To increase security, FreshRSS is hosted in two sections. The first section is public (```./p``` folder) and the second section is private (everything else). Therefore the ```robots.txt``` file is located in ```./p``` sub-folder.
+To increase security, FreshRSS is hosted in two sections. The first section is public (the `./p` folder) and the second section is private (everything else). Therefore the `robots.txt` file is located in the `./p` sub-folder.
 
-As explained in the [security section](/en/User_documentation/Installation/Security), it is highly recommended to make only the public section available at the domain level. With that configuration, ```./p``` is the root folder for https://demo.freshrss.org/, thus making ```robots.txt``` available at the root of the application.
+As explained in the [security section](/en/User_documentation/Installation/Security), it's highly recommended to make only the public section available at the domain level. With that configuration, `./p` is the root folder for http://demo.freshrss.org/, thus making `robots.txt` available at the root of the application.
 
-The same rule applies for ```favicon.ico``` and ```.htaccess```.
+The same principle applies to `favicon.ico` and `.htaccess`.
 
 ## Why do I have errors while registering a feed?
 
 There can be different origins for that problem.
-The feed syntax can be invalid, it can be unrecognized by the SimplePie library. the hosting server can be the root of the problem, FreshRSS can be buggy.
+The feed syntax can be invalid, it can be unrecognized by the SimplePie library, the hosting server can be the root of the problem, or FreshRSS can be buggy.
 The first step is to identify what causes the problem.
 Here are the steps to follow:
 
-1. __Verify if the feed syntax is valid__ with the [W3C on-line tool](https://validator.w3.org/feed/ "RSS and Atom feed validator"). If it is not valid, there is nothing we can do.
-1. __Verify SimplePie validation__ with the [SimplePie on-line tool](https://simplepie.org/demo/ "SimplePie official demo"). If it is not recognized, there is nothing we can do.
-1. __Verify FreshRSS integration__ with the [demo](https://demo.freshrss.org "FreshRSS official demo"). If it is not working, you need to [create an issue on Github](https://github.com/FreshRSS/FreshRSS/issues/new "Create an issue for FreshRSS") so we can have a look at it. If it is working, there is probably something fishy with the hosting server.
+1. __Verify if the feed syntax is valid__ with the [W3C on-line tool](https://validator.w3.org/feed/ "RSS and Atom feed validator"). If it's not valid, there's nothing we can do.
+1. __Verify SimplePie validation__ with the [SimplePie on-line tool](https://simplepie.org/demo/ "SimplePie official demo"). If it's not recognized, there's nothing we can do.
+1. __Verify FreshRSS integration__ with the [demo](https://demo.freshrss.org "FreshRSS official demo"). If it's not working, you need to [create an issue on Github](https://github.com/FreshRSS/FreshRSS/issues/new "Create an issue for FreshRSS") so we can have a look at it. If it's working, there's probably something fishy with the hosting server.
 
-## How to change a forgotten password?
+## How can you change a forgotten password?
 
-Since [1.10.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.10.0) release, admins are able to change user passwords directly from the interface. This interface is available under  ```Administration → Manage users```.
+Since the [1.10.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.10.0) release, admins can change user passwords directly from the interface. This interface is available under  ```Administration → Manage users```.
 Select a user, enter a password, and validate.
 
-Since [1.8.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.8.0) release, admins are able to change user passwords using a terminal. It worth mentioning that it must have access to PHP CLI. Open a terminal, and type the following command:
+Since the [1.8.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.8.0) release, admins can change user passwords using a terminal. It worth mentioning that you must have access to PHP CLI. Open a terminal, and type the following command:
 ```sh
 ./cli/update_user.php --user <username> --password <password>
 ```
-For more information on that matter, there is a [dedicated documentation](../../cli/README.md).
+For more information on that matter, please refer to the [dedicated documentation](../../cli/README.md).
 
 ## Permissions under SELinux
 
-Some Linux distribution like Fedora or RedHat Enterprise Linux have SELinux system enabled. This acts like a firewall application, so all applications cannot write/modify files under certain conditions. While installing FreshRSS, step 2 can fail if the httpd process cannot write to some data sub-directories, the following command should be executed as root :
+Some Linux distribution, like Fedora or RedHat Enterprise Linux, have SELinux enabled. This acts similar to a firewall application, so that applications can't write or modify files under certain conditions. While installing FreshRSS, step 2 can fail if the httpd process can't write to some data sub-directories. The following command should be executed as root to fix this problem:
 ```sh
 semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/FreshRSS/data(/.*)?'
 restorecon -Rv /usr/share/FreshRSS/data
@@ -49,7 +49,7 @@ restorecon -Rv /usr/share/FreshRSS/data
 
 ## Why do I have a blank page while trying to configure the sharing options?
 
-The `sharing` word in the URL is a trigger word for some an-blocker rules. Starting at version 1.16, `sharing` has been replaced by `integration` in the faulty URL while keeping the exact same wording through out the application.
+The `sharing` word in the URL is a trigger word for some ad-blocker rules. Starting with version 1.16, `sharing` has been replaced by `integration` in the faulty URL while keeping the exact same wording throughout the application.
 
 If you are using a version prior to 1.16, you can disable your ad-blocker for FreshRSS or you can add a rule to allow the `sharing` page to be accessed.
 

docs/fr/contributing.md

@@ -1,20 +1,91 @@
-## Contribuer au code
+## Rejoignez-nous sur les listes de mailing
 
-Pour cela, vous vous trouvez au bon endroit pour commencer : la documentation est là pour vous mettre le pied à l'étrier afin de découvrir le code. Voici une sélection de pages qui vous aideront à démarrer :
+S'il vous manque des informations, n'hésitez pas à fouiller un peu la
+documentation ou venir nous poser directement vos questions sur [la mailing
+list des développeurs](https://freshrss.org/mailman/listinfo/dev).
 
-- [Les premiers pas](developers/01_First_steps.md)
-- [Comment l'on fonctionne sur GitHub](developers/02_Github.md)
+* Le premier mailing est destiné à l'information générique, il doit être
+  adapté aux utilisateurs. [Rejoignez
+  mailing@freshrss.org](https://freshrss.org/mailman/listinfo/mailing).
+* Le deuxième mailing s'adresse principalement aux développeurs. [Rejoignez
+  dev@freshrss.org](https://freshrss.org/mailman/listinfo/dev)
 
-S'il vous manque des informations, n'hésitez pas à fouiller un peu la documentation ou venir nous poser directement vos questions sur [la mailing list des développeurs](https://freshrss.org/mailman/listinfo/dev).
+## Signaler un bug
 
-## Contribuer à la documentation
+Avez-vous trouvé un bogue ? Ne paniquez pas, voici quelques étapes pour le
+signaler facilement :
+
+1. Cherche sur [le bug tracker](https://github.com/FreshRSS/FreshRSS/issues)
+   (n'oubliez pas d'utiliser la barre de recherche).
+2. Si vous constatez un bogue similaire, n'hésitez pas à poster un
+   commentaire pour ajouter de l'importance au ticket correspondant.
+3. Si vous ne l'avez pas trouvé, [ouvrez un nouveau
+   ticket](https://github.com/FreshRSS/FreshRSS/issues/new).
+
+Si vous devez créer un nouveau ticket, essayez de garder les conseils
+suivants :
+
+* Donnez un titre explicite au ticket pour le retrouver plus facilement plus
+  tard.
+* Soyez aussi exhaustif que possible dans la description : qu'avez-vous fait
+  ? Quel est le bogue ? Quelles sont les étapes pour reproduire le bogue ?
+
+Nous avons aussi besoin de quelques informations :
+
+* Votre version de FreshRSS (sur la page A propos) ou le fichier
+  `constants.php`)
+* Votre configuration de serveur : type d'hébergement, version PHP
+* Quelle base de données : SQLite, MySQL, MariaDB, PostgreSQL ? Quelle
+  version ?
+* Si possible, les logs associés (logs PHP et logs FreshRSS sous
+  `data/users/your_user/log.txt`)
+
+## Corriger un bogue
+
+Voulez-vous corriger un bogue ? Pour maintenir une grande coordination entre
+les collaborateurs, vous devrez suivre ces indications :
 
-Il ne vous aura pas échappé que la documentation est encore un peu vide… il y a énormément de choses à faire ! Si vous souhaitez aider à écrire quelques pages, prenez le temps de lire [les informations données sur Github](https://github.com/FreshRSS/documentation/blob/master/README.fr.md).
+1. Assurez-vous que le bogue est associé à un ticket et indiquez que vous
+   allez travailler sur le bogue.
+2. [Fork du répertoire de
+   projet](https://help.github.com/articles/fork-a-repo/).
+3. [Créez une nouvelle
+   branche](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/).
+   Le nom de la branche doit être clair, et idéalement préfixé par
+   l'identifiant du ticket correspondant. Par exemple,
+   `783-contributing-file` pour réparer [ticket
+   #783](https://github.com/FreshRSS/FreshRSS/issues/783).
+4. Apportez vos modifications à votre fork et [envoyez une demande de
+   pull](https://help.github.com/articles/using-pull-requests/) sur la
+   branche **dev**.
 
-Vous pouvez notamment regarder [les tickets ouverts avec le tag "Documentation"](https://github.com/FreshRSS/FreshRSS/issues?labels=Documentation&state=open). Il s'agit de la liste des choses assez spécifiques à ajouter à la documentation.
+Si vous devez écrire du code, veuillez suivre [nos recommandations de style
+de codage](developers/01_First_steps.md).
 
-## Contribuer au blog
+**Conseil : **si vous cherchez des bugs faciles à corriger, jetez un coup d'oeil à la vignette "[good first issue](https://github.com/FreshRSS/FreshRSS/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)".
 
-Vous souhaitez écrire un article à propos des technologies RSS/Atom/WebSub ou tout simplement nous donner un coup de main à la rédaction d'un billet ? Vous pouvez nous aider !
+## Soumettre une idée
+
+Vous avez de bonnes idées, oui ! Ne soyez pas timide et ouvrez [un nouveau
+ticket](https://github.com/FreshRSS/FreshRSS/issues/new) sur notre tracker
+bogue pour nous demander si nous pouvons le mettre en œuvre. Les plus
+grandes idées viennent souvent des suggestions les plus timides !
+
+Si votre idée est bonne, nous y jetterons un coup d'oeil.
+
+## Contribuer à l'internationalisation (i18n)
+
+Si vous voulez améliorer l'internationalisation, ouvrez d'abord un nouveau
+ticket et suivez les conseils de la section *Fixer un bogue*.
+
+Les traductions sont disponibles dans les sous-répertoires de `./app/i18n/`.
+
+Nous travaillons sur une meilleure façon de gérer l'internationalisation
+mais n'hésitez pas à nous suggérer des idées !
+
+## Contribuer à la documentation
 
-Pour cela, il suffit de vous rendre sur le dépôt GitHub [FreshRSS/freshrss.org](https://github.com/FreshRSS/freshrss.org) et de nous proposer une « Pull Request ». Les articles de blog doivent se trouver dans le répertoire `./blog` et être écrits en Markdown.
+Il ne vous aura pas échappé que la documentation est encore un peu vide… il
+y a énormément de choses à faire ! Si vous souhaitez aider à écrire quelques
+pages, rendez-vous dans les principaux dépôts[fichier
+docs](https://github.com/FreshRSS/FreshRSS/tree/master/docs) !

docs/fr/developers/01_First_steps.md

@@ -1,20 +1,105 @@
-# Configurer son environnement
+# Configurer son environnement (Docker)
+
+FreshRSS est construit en PHP et utilise le framework Minz. Les
+dépendancessont directement incluses dans le code source, donc vous n'avez
+pas besoin d'utiliser Composer.
+
+Il existe plusieurs façons de configurer votre environnement
+dedéveloppement. La méthode la plus simple et la plus supportée est basée
+surDocker. C'est la solution qui est documentée ci-dessous. Si vous avez
+déjà unenvironnement PHP fonctionnel, vous n'en avez probablement pas
+besoin.
+
+Nous supposons ici que vous utilisez une distribution GNU/Linux, capable
+d'exécuter Docker. Sinon, vous devrez adapter les commandes en conséquence.
+
+Les commandes qui suivent doivent être exécutées dans une console. Ils
+commencent par `$` quand les commandes doivent être exécutées en tant
+qu'utilisateur normal, et par `#` quand elles doivent être exécutées en tant
+qu'utilisateur root. Vous n'avez pas besoin de taper ces caractères. Un
+chemin d'accès peut être indiqué devant ces caractères pour vous aider à
+identifier où ils doivent être exécutés. Par exemple, `app$ echo 'Hello
+World'` indique que vous devez exécuter la commande `echo` dans le
+répertoire `app/`.
+
+Tout d'abord, vous devez installer
+[Docker](https://docs.docker.com/install/linux/docker-ce/ubuntu/).
+
+Une fois que c'est fait, clonez le dépôt de code de la manière suivante :
+
+```console
+$ git clone https://github.com/FreshRSS/FreshRSS.git
+$ cd FreshRSS
+```
+
+Notez que, pour contribuer, vous devrez d'abord « forker » ce dépôt de code
+(ou dépôt de code référent) et cloner votre « fork » à la place de ce
+dépôt. Adaptez les commandes en conséquence.
+
+Ensuite, la seule commande que vous devez connaître est la suivante :
+
+```console
+$ make start
+```
+
+Cela peut prendre un certain temps pour que Docker télécharge l'image
+utilisée. Dans le cas où la commande échoue pour un problème de droit, il
+faudra soit ajouter votre utilisateur au groupe `docker`, soit relancer la
+commande en la préfixant par `sudo`.
+
+**Vous pouvez maintenant accéder à FreshRSS à [http://localhost:8080](http://localhost:8080).** Suivez simplement le processus d'installation et sélectionnez la base de données SQLite.
+
+Vous pouvez arrêter les conteneurs en tapant <kbd>Control</kbd> + <kbd>c</kbd> ou avec la commande suivante, dans un autre terminal:
+
+```console
+$ make stop
+```
 
-**TODO**
+Si la configuration vous intéresse, les commandes `make' sont définies dans
+le fichier [`Makefile`](/Makefile).
 
-## Docker
+Si vous avez besoin d'utiliser une image Docker identifiée par un tag
+différent (par défaut `dev-alpine`), vous pouvez surcharger de la manière
+suivante la variable d'environnement `TAG` au moment de l'exécution de la
+commande :
 
-Le développement et le deploiement de FreshRSS peuvent se faire [via Docker](https://github.com/FreshRSS/FreshRSS/tree/dev/Docker).
+```console
+$ TAG=dev-arm make start
+```
+
+Vous pouvez trouver la liste complète des tags disponibles [sur le hub
+Docker](https://hub.docker.com/r/freshrss/freshrss/tags).
+
+Si vous voulez construire l'image Docker, vous pouvez lancer la commande
+suivante :
+
+```console
+$ make build
+$ # ou
+$ TAG=dev-arm make build
+```
+
+La valeur de la variable `TAG` peut contenir n'importe quelle valeur (par
+exemple `dev-local`). Vous pouvez cibler une architecture spécifique en
+ajoutant `-alpine` ou `-arm` à la fin du tag (par exemple `dev-local-arm`).
 
 # Architecture du projet
 
-**TODO**
+**À FAIRE**
+
+# Extensions
+
+Si vous souhaitez créer votre propre extension FreshRSS, consultez la
+[documentation de l'extension](03_Backend/05_Extensions.md).
 
 # Style de codage
 
-Si vous désirez contribuer au code, il est important de respecter le style de codage suivant. Le code actuel ne le respecte pas entièrement mais il est de notre devoir à tous de le changer dès que l'occasion se présente.
+Si vous désirez contribuer au code, il est important de respecter le style
+de codage suivant. Le code actuel ne le respecte pas entièrement mais il est
+de notre devoir à tous de le changer dès que l'occasion se présente.
 
-Aucune nouvelle contribution ne respectant pas ces règles ne sera acceptée tant que les corrections nécessaires ne sont pas appliquées.
+Aucune nouvelle contribution ne respectant pas ces règles ne sera acceptée
+tant que les corrections nécessaires ne sont pas appliquées.
 
 ## Espaces, tabulations et autres caractères blancs
 
@@ -23,7 +108,8 @@ L'indentation du code doit être faite impérativement avec des tabulations.
 
 ### Alignement
 
-Une fois l'indentation faite, il peut être nécessaire de faire un alignement pour simplifier la lecture. Dans ce cas, il faut utiliser les espaces.
+Une fois l'indentation faite, il peut être nécessaire de faire un alignement
+pour simplifier la lecture. Dans ce cas, il faut utiliser les espaces.
 
 ```php
 $resultat = une_fonction_avec_un_nom_long($param1, $param2,
@@ -32,9 +118,12 @@ $resultat = une_fonction_avec_un_nom_long($param1, $param2,
 
 ### Fin de ligne
 
-Le caractère de fin de ligne doit être un saut de ligne (LF) qui est le caractère de fin de ligne des systèmes *NIX. Ce caractère ne doit pas être précédé par des caractères blanc.
+Le caractère de fin de ligne doit être un saut de ligne (LF) qui est le
+caractère de fin de ligne des systèmes *NIX. Ce caractère ne doit pas être
+précédé par des caractères blanc.
 
-Il est possible de vérifier la présence de caractères blancs en fin de ligne grâce à Git avec la commande suivante :
+Il est possible de vérifier la présence de caractères blancs en fin de ligne
+grâce à Git avec la commande suivante :
 
 ```bash
 # commande à lancer avant l'ajout des fichiers dans l'index
@@ -65,7 +154,10 @@ echo $a ? 1 : 0;
 
 ### Le cas des parenthèses
 
-Il n'y a pas d'espaces entre des parenthèses. Il n'y a pas d'espaces avant une parenthèse ouvrante sauf si elle est précédée d'un mot-clé. Il n'y a pas d'espaces après une parenthèse fermante sauf si elle est suivie d'une accolade ouvrante.
+Il n'y a pas d'espaces entre des parenthèses. Il n'y a pas d'espaces avant
+une parenthèse ouvrante sauf si elle est précédée d'un mot-clé. Il n'y a pas
+d'espaces après une parenthèse fermante sauf si elle est suivie d'une
+accolade ouvrante.
 
 ```php
 if ($a == 10) {
@@ -79,7 +171,11 @@ if ((int)$a == 10) {
 
 ### Le cas des fonctions chainées
 
-Ce cas se présente le plus souvent en Javascript. Quand on a des fonctions chainées, des fonctions anonymes ainsi que des fonctions de rappels, il est très facile de se perdre. Dans ce cas là, on ajoute une indentation supplémentaire pour toute l'instruction et on revient au même niveau pour une instruction de même niveau.
+Ce cas se présente le plus souvent en Javascript. Quand on a des fonctions
+chainées, des fonctions anonymes ainsi que des fonctions de rappels, il est
+très facile de se perdre. Dans ce cas là, on ajoute une indentation
+supplémentaire pour toute l'instruction et on revient au même niveau pour
+une instruction de même niveau.
 
 ```javascript
 // Première instruction
@@ -98,9 +194,13 @@ shortcut.add("shift+" + shortcuts.mark_read, function () {
 
 ## Longueur des lignes
 
-Les lignes ne doivent pas dépasser 80 caractères. Il est cependant autorisé exceptionnellement de dépasser cette limite s'il n'est pas possible de la respecter mais en aucun cas, les lignes ne doivent dépasser les 100 caractères.
+Les lignes ne doivent pas dépasser 80 caractères. Il est cependant autorisé
+exceptionnellement de dépasser cette limite s'il n'est pas possible de la
+respecter mais en aucun cas, les lignes ne doivent dépasser les 100
+caractères.
 
-Dans le cas des fonctions, les paramètres peuvent être déclarés sur plusieurs lignes.
+Dans le cas des fonctions, les paramètres peuvent être déclarés sur
+plusieurs lignes.
 
 ```php
 function ma_fonction($param_1, $param_2,
@@ -111,7 +211,8 @@ function ma_fonction($param_1, $param_2,
 
 ## Nommage
 
-L'ensemble des éléments du code (fonctions, classes, méthodes et variables) doivent être nommés de manière à décrire leur usage de façon concise.
+L'ensemble des éléments du code (fonctions, classes, méthodes et variables)
+doivent être nommés de manière à décrire leur usage de façon concise.
 
 ### Fonctions et variables
 
@@ -150,12 +251,14 @@ Les fichiers doivent être encodés en UTF-8.
 
 ## Compatibilité PHP
 
-Assurez-vous que votre code fonctionne avec une version de PHP aussi ancienne que celle que FreshRSS supporte officiellement.
+Assurez-vous que votre code fonctionne avec une version de PHP aussi
+ancienne que celle que FreshRSS supporte officiellement.
 
 ## Divers
 
-### Opérateurs
-Les opérateurs doivent être en fin de ligne dans le cas de conditions sur plusieurs lignes.
+### Le cas des opérateurs
+Les opérateurs doivent être en fin de ligne dans le cas de conditions sur
+plusieurs lignes.
 
 ```php
 if ($a == 10 ||
@@ -164,13 +267,15 @@ if ($a == 10 ||
 }
 ```
 
-### Fin des fichiers
+### Fin de fichier
 
-Si le fichier ne contient que du PHP, il ne doit pas comporter de balise fermante
+Si le fichier ne contient que du PHP, il ne doit pas comporter de balise
+fermante.
 
 ### Tableaux
 
-Lors de l'écriture de tableaux sur plusieurs lignes, tous les éléments doivent être suivis d'une virgule (même le dernier).
+Lors de l'écriture de tableaux sur plusieurs lignes, tous les éléments
+doivent être suivis d'une virgule (même le dernier).
 
 ```php
 $variable = [

docs/fr/developers/02_Github.md

@@ -1,77 +1,169 @@
 # Remonter un problème ou une suggestion
 
-Malgré le soin apporté à FreshRSS, il se peut que des bugs apparaissent encore. Le projet est jeune et le développement dynamique, aussi celui-ci pourra être corrigé rapidement. Il se peut aussi que vous ayez en tête une fonctionnalité qui n'existe pas encore. Que celle-ci vous paraisse idiote, farfelue, inutile ou trop spécifique, il ne faut surtout pas hésiter à nous la proposer ! Très souvent des "idées en l'air" ont trouvé une oreille attentive. Ce sont les regards externes qui font le plus évoluer le projet.
+Malgré le soin apporté à FreshRSS, il se peut que des bugs apparaissent
+encore. Le projet est jeune et le développement dynamique, aussi celui-ci
+pourra être corrigé rapidement. Il se peut aussi que vous ayez en tête une
+fonctionnalité qui n'existe pas encore. Que celle-ci vous paraisse idiote,
+farfelue, inutile ou trop spécifique, il ne faut surtout pas hésiter à nous
+la proposer ! Très souvent des "idées en l'air" ont trouvé une oreille
+attentive. Ce sont les regards externes qui font le plus évoluer le projet.
 
-Si vous êtes convaincus qu'il faut vous faire entendre, voici la marche à suivre.
+Si vous êtes convaincus qu'il faut vous faire entendre, voici la marche à
+suivre.
 
 ## Sur GitHub
 
-GitHub est la plate-forme à privilégier pour vos demandes. En effet, cela nous permet de pouvoir discuter à plusieurs sur un problème ou une suggestion et de faire émerger, souvent, des idées nouvelles. Ne négligeons pas cet aspect "social" !
-
- 1. [Rendez-vous sur le gestionnaire de tickets de bugs](https://github.com/FreshRSS/FreshRSS/issues)
- 2. Commencez par rechercher si une demande similaire n'a pas déjà été faite. Si oui, n'hésitez pas à ajouter votre voix à la demande.
- 3. Si votre demande est nouvelle, [ouvrez un nouveau ticket de bug](https://github.com/FreshRSS/FreshRSS/issues/new)
- 4. Rédigez enfin votre demande. Si vous maitrisez l'anglais, c'est la langue à privilégier car cela permet d'ouvrir la discussion à un plus grand nombre de personnes. Sinon, ce n'est pas grave, continuez en français :)
- 5. Merci de bien vouloir suivre les quelques conseils donnés plus bas pour faciliter la prise en compte de votre ticket.
-
+GitHub est la plate-forme à privilégier pour vos demandes. En effet, cela
+nous permet de pouvoir discuter à plusieurs sur un problème ou une
+suggestion et de faire émerger, souvent, des idées nouvelles. Ne négligeons
+pas cet aspect "social" !
+
+ 1. [Rendez-vous sur le gestionnaire de tickets de
+    bugs](https://github.com/FreshRSS/FreshRSS/issues)
+ 2. Commencez par rechercher si une demande similaire n'a pas déjà été
+    faite. Si oui, n'hésitez pas à ajouter votre voix à la demande.
+ 3. Si votre demande est nouvelle, [ouvrez un nouveau ticket de
+    bug](https://github.com/FreshRSS/FreshRSS/issues/new)
+ 4. Rédigez enfin votre demande. Si vous maitrisez l'anglais, c'est la
+    langue à privilégier car cela permet d'ouvrir la discussion à un plus
+    grand nombre de personnes. Sinon, ce n'est pas grave, continuez en
+    français :)
+ 5. Merci de bien vouloir suivre les quelques conseils donnés plus bas pour
+    faciliter la prise en compte de votre ticket.
+ 
 ## De façon informelle
 
-Tout le monde n'aime pas ou n'utilise pas GitHub pour des raisons aussi diverses que légitimes. C'est pourquoi vous pouvez aussi nous contacter de façon plus informelle.
+Tout le monde n'aime pas ou n'utilise pas GitHub pour des raisons aussi
+diverses que légitimes. C'est pourquoi vous pouvez aussi nous contacter de
+façon plus informelle.
 
-* Sur [les listes de diffusion](https://freshrss.org/announce-of-the-mailing-lists.html)
+* Sur [notre chat
+  Mattermost](https://framateam.org/signup_user_complete/?id=e2680d3e3128b9fac8fdb3003b0024ee)
+* Sur [les listes de
+  diffusion](https://freshrss.org/announce-of-the-mailing-lists.html)
 * À des évènements / rencontres autour du Logiciel Libre
 * Autour d'une bière dans un bar
 * Etc.
 
 ## Conseils
 
-Voici quelques conseils pour bien présenter votre remontée de bug ou votre suggestion :
-
-
-* **Faites attention à l'orthographe.** même si ce n'est pas toujours facile, faites votre maximum ;)
-* **Donnez un titre explicite à votre demande**, quitte à ce qu'il soit un peu long. Cela nous aide non seulement à comprendre votre demande, mais aussi à retrouver votre ticket plus tard.
-* **Une demande = un ticket.** Vous pouvez avoir des tas d'idées mais vous avez peur de spammer le gestionnaire de bugs : ça ne fait rien. Il vaut mieux avoir un peu trop de tickets que trop de demandes dans un seul. On s'occupera de fermer et regrouper les demandes qui le peuvent.
-* Si vous remontez un bug, pensez à nous **fournir les logs de FreshRSS** (accessibles dans les dossier ''data/log/'' de FreshRSS) **et PHP** (l'emplacement peut varier selon les distributions, mais pensez à chercher dans ''/var/log/httpd'' ou ''/var/log/apache'').
-* Si vous ne trouvez pas les fichiers de logs, précisez-le dans votre ticket afin que nous sachions que vous avez déjà cherché.
-* Tous les bugs ne nécessitent pas les logs, mais si vous doutez, mieux vaut nous les fournir. Les logs sont importants et très utiles pour débugguer !
-* Il se peut que les logs puissent révéler des informations plus ou moins confidentielles, **faites attention à ne rien divulguer de sensible.**
-
-De plus, face à un bug, je ne peux que vous encourager à suivre le format de message suivant (tiré du [site de Max & Sam](http://sametmax.com/template-de-demande-daide-en-informatique/)) :
-
-----
-
-**Quel est mon objectif ?**
+Voici quelques conseils pour bien présenter votre remontée de bug ou votre
+suggestion :
+
+
+* **Faites attention à l'orthographe.** même si ce n'est pas toujours
+  facile, faites votre maximum. ;)
+* **Donnez un titre explicite à votre demande**, quitte à ce qu'il soit un
+  peu long. Cela nous aide non seulement à comprendre votre demande, mais
+  aussi à retrouver votre ticket plus tard.
+* **Une demande = un ticket.** Vous pouvez avoir des tas d'idées mais vous
+  avez peur de spammer le gestionnaire de bugs : ça ne fait rien. Il vaut
+  mieux avoir un peu trop de tickets que trop de demandes dans un seul. On
+  s'occupera de fermer et regrouper les demandes qui le peuvent.
+* Si vous remontez un bug, pensez à nous **fournir les logs de FreshRSS**
+  (accessibles dans les dossier ''data/log/'' de FreshRSS) **et PHP**
+  (l'emplacement peut varier selon les distributions, mais pensez à chercher
+  dans ''/var/log/httpd'' ou ''/var/log/apache'').
+* Si vous ne trouvez pas les fichiers de logs, précisez-le dans votre ticket
+  afin que nous sachions que vous avez déjà cherché.
+* Tous les bugs ne nécessitent pas les logs, mais si vous doutez, mieux vaut
+  nous les fournir. Les logs sont importants et très utiles pour débugguer !
+* Il se peut que les logs puissent révéler des informations plus ou moins
+  confidentielles, **faites attention à ne rien divulguer de sensible.**
+
+De plus, face à un bug, je ne peux que vous encourager à suivre le format de
+message suivant (tiré du [site de Sam &
+Max](http://sametmax.com/template-de-demande-daide-en-informatique/)) :
+
+### Quel est mon objectif ?
 
 Donnez le contexte général de ce que vous essayiez de faire.
 
-**Qu’est-ce que j’ai essayé de faire ?**
+### Qu’est-ce que j’ai essayé de faire ?
 
-Expliquez pas à pas ce que vous avez fait afin que nous puissions reproduire le bug.
+Expliquez pas à pas ce que vous avez fait afin que nous puissions reproduire
+le bug.
 
-**Quels résultats ai-je obtenus ?**
+### Quels résultats ai-je obtenus ?
 
-Le bug : ce que vous voyez qui n'aurez pas dû se passer. Ici vous pouvez fournir les logs.
+Le bug : ce que vous voyez qui n'aurez pas dû se passer. Ici vous pouvez
+fournir les logs.
 
-**Quel était le résultat attendu ?**
+### Quel était le résultat attendu ?
 
 Afin que nous comprenions bien où est le problème... au moins selon vous :p
 
-**Quelle est ma situation ?**
+### Quelle est ma situation ?
 
 Pensez à donner les informations suivantes si vous les connaissez :
 
  1. Quel navigateur ? Quelle version ?
  2. Quel serveur : Apache, Nginx ? Quelle version ?
  3. Quelle version de PHP ?
- 4. Quelle base de données : SQLite, MySQL, MariaDB, PostgreSQL ? Quelle version ?
+ 4. Quelle base de données : SQLite, MySQL, MariaDB, PostgreSQL ? Quelle
+    version ?
  5. Quelle distribution sur le serveur ? Et… quelle version ?
 
-----
-
 # Système de branches
 
-**TODO**
+## Élémentaire
+Si vous êtes novice dans Git, voici quelques ressources qui pourraient vous
+être utiles :
+
+* [Article du blog de GitHub](https://github.com/blog/120-new-to-git)
+* <http://try.github.com/>
+* <http://sixrevisions.com/resources/git-tutorials-beginners/>
+* <http://rogerdudler.github.io/git-guide/>
+
+## Obtenir le dernier code du répertoire FreshRSS
+Vous devez avant tout ajouter le repo officiel à votre liste de repo remote
+:
+```bash
+git remote add upstream git@github.com:FreshRSS/FreshRSS.git
+```
+
+Vous pouvez vérifier que le repo remote a été ajouté avec succès en
+utilisant :
+```bash
+git remote -v show
+```
+
+Vous pouvez maintenant pull le dernier code de développement :
+```bash
+git checkout dev
+git pull upstream dev
+```
+
+## Lancer une nouvelle branche de développement
+```bash
+git checkout -b mon-branch-developpement
+```
 
 # Proposer un patch
 
-**TODO**
+```bash
+# Ajoutez le fichier modifié, ici actualize_script.php
+git add app/actualize_script.php
+# Commitez le changement et écrivez un message de commit approprié.
+git commit
+# Vérifiez deux fois que tout a l'air d'aller bien
+git show
+# Poussez les changements sur ton fork
+git push
+```
+
+Vous pouvez maintenant créer un PR en fonction de votre branche. S'il vous
+plaît, assurez-vous de le soumettre contre la branche `dev` !
+
+## Comment écrire un message de commit
+
+Un message de commit devrait décrire succinctement les changements sur la
+première ligne. Par exemple :
+
+> Fixe une icône cassée
+
+Si nécessaire, une ligne blanche et une explication plus longue peuvent le
+suivre.
+
+Pour d'autres conseils, voir
+[ici](https://chris.beams.io/posts/git-commit/).

docs/fr/developers/03_Backend/02_Minz.md

@@ -1,27 +1,27 @@
 # Modèles
 
-**TODO**
+**À FAIRE**
 
 # Contrôleurs et actions
 
-**TODO**
+**À FAIRE**
 
 # Vues
 
-**TODO**
+**À FAIRE**
 
 # Routage
 
-**TODO**
+**À FAIRE**
 
 # Écriture des URL
 
-**TODO**
+**À FAIRE**
 
 # Internationalisation
 
-**TODO**
+**À FAIRE**
 
 # Comprendres les mécanismes internes
 
-**TODO**
+**À FAIRE**

docs/fr/developers/03_Backend/04_Changing_source_code.md

@@ -1,15 +1,15 @@
 # Accès à la base de données
 
-**TODO**
+**À FAIRE**
 
 # Écrire une action et sa vue associée
 
-**TODO**
+**À FAIRE**
 
 # Gestion de l'authentification
 
-**TODO**
+**À FAIRE**
 
 # Gestion des logs
 
-**TODO**
+**À FAIRE**

docs/fr/developers/03_Backend/05_Extensions.md

@@ -1,47 +1,88 @@
-# Fiche technique 0001 — Écriture d'extensions pour FreshRSS
+# Écriture d'extensions pour FreshRSS
 
 ## Présentation de FreshRSS
 
-FreshRSS est un agrégateur de flux RSS / Atom écrit en PHP depuis octobre 2012. Le site officiel est situé à l'adresse [freshrss.org](https://freshrss.org) et son dépot Git est hébergé par Github : [github.com/FreshRSS/FreshRSS](https://github.com/FreshRSS/FreshRSS).
+FreshRSS est un agrégateur de flux RSS / Atom écrit en PHP depuis octobre
+2012. Le site officiel est situé à l'adresse
+[freshrss.org](https://freshrss.org) et son dépot Git est hébergé par Github
+: [github.com/FreshRSS/FreshRSS](https://github.com/FreshRSS/FreshRSS).
 
 ## Problème à résoudre
 
-FreshRSS est limité dans ses possibilités techniques par différents facteurs :
+FreshRSS est limité dans ses possibilités techniques par différents facteurs
+:
 
-- La disponibilité des développeurs principaux ;
-- La volonté d'intégrer certains changements ;
-- Le niveau de « hack » nécessaire pour intégrer des fonctionnalités à la marge.
+* La disponibilité des développeurs principaux ;
+* La volonté d'intégrer certains changements ;
+* Le niveau de « hack » nécessaire pour intégrer des fonctionnalités à la
+  marge.
 
-Si la première limitation peut, en théorie, être levée par la participation de nouveaux contributeurs au projet, elle est en réalité conditionnée par la volonté des contributeurs à s'intéresser au code source du projet en entier. Afin de lever les deux autres limitations quant à elles, il faudra la plupart du temps passer par un « à-coté » souvent synonyme de « fork ».
+Si la première limitation peut, en théorie, être levée par la participation
+de nouveaux contributeurs au projet, elle est en réalité conditionnée par la
+volonté des contributeurs à s'intéresser au code source du projet en
+entier. Afin de lever les deux autres limitations quant à elles, il faudra
+la plupart du temps passer par un « à-coté » souvent synonyme de « fork ».
 
-Une autre solution consiste à passer par un système d'extensions. En permettant à des utilisateurs d'écrire leur propre extension sans avoir à s'intéresser au cœur même du logiciel de base, on permet :
+Une autre solution consiste à passer par un système d'extensions. En
+permettant à des utilisateurs d'écrire leur propre extension sans avoir à
+s'intéresser au cœur même du logiciel de base, on permet :
 
-1. De réduire la quantité de code source à assimiler pour un nouveau contributeur ;
-2. De permettre d'intégrer des nouveautés de façon non-officielles ;
-3. De se passer des développeurs principaux pour d'éventuelles améliorations sans passer par la case « fork ».
-
-Note : il est tout à fait imaginable que les fonctionnalités d'une extension puissent par la suite être intégrées dans le code initial de FreshRSS de façon officielle. Cela permet de proposer un « proof of concept » assez facilement.
+1. De réduire la quantité de code source à assimiler pour un nouveau
+   contributeur ;
+2. De permettre d'intégrer des nouveautés de façon non-officielles ;
+3. De se passer des développeurs principaux pour d'éventuelles améliorations
+   sans passer par la case « fork ».
 
+Note : il est tout à fait imaginable que les fonctionnalités d'une extension
+puissent par la suite être intégrées dans le code initial de FreshRSS de
+façon officielle. Cela permet de proposer un « proof of concept » assez
+facilement.
 
 ## Comprendre les mécaniques de base (Minz et MVC)
 
 **TODO** : bouger dans 02_Minz.md
 
-Cette fiche technique devrait renvoyer vers la documentation officielle de FreshRSS et de Minz (le framework PHP sur lequel repose FreshRSS). Malheureusement cette documentation n'existe pas encore. Voici donc en quelques mots les principaux éléments à connaître. Il n'est pas nécessaire de lire l'ensemble des chapitres de cette section si vous n'avez pas à utiliser une fonctionnalité dans votre extension (si vous n'avez pas besoin de traduire votre extension, pas besoin d'en savoir plus sur le module `Minz_Translate` par exemple).
+Cette fiche technique devrait renvoyer vers la documentation officielle de
+FreshRSS et de Minz (le framework PHP sur lequel repose
+FreshRSS). Malheureusement cette documentation n'existe pas encore. Voici
+donc en quelques mots les principaux éléments à connaître. Il n'est pas
+nécessaire de lire l'ensemble des chapitres de cette section si vous n'avez
+pas à utiliser une fonctionnalité dans votre extension (si vous n'avez pas
+besoin de traduire votre extension, pas besoin d'en savoir plus sur le
+module `Minz_Translate` par exemple).
 
 ### Architecture MVC
 
-Minz repose et impose une architecture MVC pour les projets l'utilisant. On distingue dans cette architecture trois composants principaux :
-
-- Le Modèle : c'est l'objet de base que l'on va manipuler. Dans FreshRSS, les catégories, les flux et les articles sont des modèles. La partie du code qui permet de les manipuler en base de données fait aussi partie du modèle mais est séparée du modèle de base : on parle de DAO (pour « Data Access Object »). Les modèles sont stockés dans un répertoire `Models`.
-- La Vue : c'est ce qui représente ce que verra l'utilisateur. La vue est donc simplement du code HTML que l'on mixe avec du PHP pour afficher les informations dynamiques. Les vues sont stockées dans un répertoire `views`.
-- Le Contrôleur : c'est ce qui permet de lier modèles et vues entre eux. Typiquement, un contrôleur va charger des modèles à partir de la base de données (une liste d'articles par exemple) pour les « passer » à une vue afin qu'elle les affiche. Les contrôleurs sont stockés dans un répertoire `Controllers`.
-
-### Le routage
-
-Afin de lier une URL à un contrôleur, on doit passer par une phase dite de « routage ». Dans FreshRSS, cela est particulièrement simple car il suffit d'indiquer le nom du contrôleur à charger dans l'URL à l'aide d'un paramètre `c`. Par exemple, l'adresse http://exemple.com?c=hello va exécuter le code contenu dans le contrôleur `hello`.
-
-Une notion qui n'a pas encore été évoquée est le système d'« actions ». Une action est exécutée *sur* un contrôleur. Concrètement, un contrôleur va être représenté par une classe et ses actions par des méthodes. Pour exécuter une action, il est nécessaire d'indiquer un paramètre `a` dans l'URL.
+Minz repose et impose une architecture MVC pour les projets l'utilisant. On
+distingue dans cette architecture trois composants principaux :
+
+* Le Modèle : c'est l'objet de base que l'on va manipuler. Dans FreshRSS,
+  les catégories, les flux et les articles sont des modèles. La partie du
+  code qui permet de les manipuler en base de données fait aussi partie du
+  modèle mais est séparée du modèle de base : on parle de DAO (pour « Data
+  Access Object »). Les modèles sont stockés dans un répertoire `Models`.
+* La Vue : c'est ce qui représente ce que verra l'utilisateur. La vue est
+  donc simplement du code HTML que l'on mixe avec du PHP pour afficher les
+  informations dynamiques. Les vues sont stockées dans un répertoire
+  `views`.
+* Le Contrôleur : c'est ce qui permet de lier modèles et vues entre
+  eux. Typiquement, un contrôleur va charger des modèles à partir de la base
+  de données (une liste d'articles par exemple) pour les « passer » à une
+  vue afin qu'elle les affiche. Les contrôleurs sont stockés dans un
+  répertoire `Controllers`.
+
+### Routage
+
+Afin de lier une URL à un contrôleur, on doit passer par une phase dite de «
+routage ». Dans FreshRSS, cela est particulièrement simple car il suffit
+d'indiquer le nom du contrôleur à charger dans l'URL à l'aide d'un paramètre
+`c`. Par exemple, l'adresse http://exemple.com?c=hello va exécuter le code
+contenu dans le contrôleur `hello`.
+
+Une notion qui n'a pas encore été évoquée est le système d'« actions ». Une
+action est exécutée *sur* un contrôleur. Concrètement, un contrôleur va être
+représenté par une classe et ses actions par des méthodes. Pour exécuter une
+action, il est nécessaire d'indiquer un paramètre `a` dans l'URL.
 
 Exemple de code :
 
@@ -61,17 +102,24 @@ class FreshRSS_hello_Controller extends Minz_ActionController {
 ?>
 ```
 
-Si l'on charge l'adresse http://exemple.com?c=hello&a=world, l'action `world` va donc être exécutée sur le contrôleur `hello`.
+Si l'on charge l'adresse http://exemple.com?c=hello&a=world, l'action
+`world` va donc être exécutée sur le contrôleur `hello`.
 
-Note : si `c` ou `a` n'est pas précisée, la valeur par défaut de chacune de ces variables est `index`. Ainsi l'adresse http://exemple.com?c=hello va exécuter l'action `index` du contrôleur `hello`.
+Note : si `c` ou `a` n'est pas précisée, la valeur par défaut de chacune de
+ces variables est `index`. Ainsi l'adresse http://exemple.com?c=hello va
+exécuter l'action `index` du contrôleur `hello`.
 
-Plus loin, sera utilisée la convention `hello/world` pour évoquer un couple contrôleur/action.
+Plus loin, sera utilisée la convention `hello/world` pour évoquer un couple
+contrôleur/action.
 
-### Gestion des vues
+### Vues
 
-Chaque vue est associée à un contrôleur et à une action. La vue associée à `hello/world` va être stockée dans un fichier bien spécifique : `views/hello/world.phtml`. Cette convention est imposée par Minz.
+Chaque vue est associée à un contrôleur et à une action. La vue associée à
+`hello/world` va être stockée dans un fichier bien spécifique :
+`views/hello/world.phtml`. Cette convention est imposée par Minz.
 
-Comme expliqué plus haut, les vues sont du code HTML mixé à du PHP. Exemple de code :
+Comme expliqué plus haut, les vues sont du code HTML mixé à du PHP. Exemple
+de code :
 
 ```html
 <p>
@@ -83,7 +131,9 @@ La variable `$this->a_variable` a été passée précédemment par le contrôleu
 
 ### Accéder aux paramètres GET / POST
 
-Il est souvent nécessaire de profiter des paramètres passés par GET ou par POST. Dans Minz, ces paramètres sont accessibles de façon indistincts à l'aide de la classe `Minz_Request`. Exemple de code :
+Il est souvent nécessaire de profiter des paramètres passés par GET ou par
+POST. Dans Minz, ces paramètres sont accessibles de façon indistincts à
+l'aide de la classe `Minz_Request`. Exemple de code :
 
 ```php
 <?php
@@ -105,17 +155,26 @@ echo Minz_Request::param('bar');
 ?>
 ```
 
-La méthode `Minz_Request::isPost()` peut être utile pour n'exécuter un morceau de code que s'il s'agit d'une requête POST.
+La méthode `Minz_Request::isPost()` peut être utile pour n'exécuter un
+morceau de code que s'il s'agit d'une requête POST.
 
-Note : il est préférable de n'utiliser `Minz_Request` que dans les contrôleurs. Il est probable que vous rencontriez cette méthode dans les vues de FreshRSS, voire dans les modèles, mais sachez qu'il ne s'agit **pas** d'une bonne pratique.
+Note : il est préférable de n'utiliser `Minz_Request` que dans les
+contrôleurs. Il est probable que vous rencontriez cette méthode dans les
+vues de FreshRSS, voire dans les modèles, mais sachez qu'il ne s'agit
+**pas** d'une bonne pratique.
 
 ### Accéder aux paramètres de session
 
-L'accès aux paramètres de session est étrangement similaire aux paramètres GET / POST mais passe par la classe `Minz_Session` cette fois-ci ! Il n'y a pas d'exemple ici car vous pouvez reprendre le précédent en changeant tous les `Minz_Request` par des `Minz_Session`.
+L'accès aux paramètres de session est étrangement similaire aux paramètres
+GET / POST mais passe par la classe `Minz_Session` cette fois-ci ! Il n'y a
+pas d'exemple ici car vous pouvez reprendre le précédent en changeant tous
+les `Minz_Request` par des `Minz_Session`.
 
 ### Gestion des URL
 
-Pour profiter pleinement du système de routage de Minz, il est fortement déconseillé d'écrire les URL en dur dans votre code. Par exemple, la vue suivante doit être évitée :
+Pour profiter pleinement du système de routage de Minz, il est fortement
+déconseillé d'écrire les URL en dur dans votre code. Par exemple, la vue
+suivante doit être évitée :
 
 ```html
 <p>
@@ -123,9 +182,13 @@ Pour profiter pleinement du système de routage de Minz, il est fortement décon
 </p>
 ```
 
-Si un jour il est décidé d'utiliser un système d'« url rewriting » pour avoir des adresses au format http://exemple.com/controller/action, toutes les adresses précédentes deviendraient ineffectives !
+Si un jour il est décidé d'utiliser un système d'« url rewriting » pour
+avoir des adresses au format http://exemple.com/controller/action, toutes
+les adresses précédentes deviendraient ineffectives !
 
-Préférez donc l'utilisation de la classe `Minz_Url` et de sa méthode `display()`. `Minz_Url::display()` prend en paramètre un tableau de la forme suivante :
+Préférez donc l'utilisation de la classe `Minz_Url` et de sa méthode
+`display()`. `Minz_Url::display()` prend en paramètre un tableau de la forme
+suivante :
 
 ```php
 <?php
@@ -144,7 +207,8 @@ echo Minz_Url::display($url_array);
 ?>
 ```
 
-Comme cela peut devenir un peu pénible à utiliser à la longue, surtout dans les vues, il est préférable d'utiliser le raccourci `_url()` :
+Comme cela peut devenir un peu pénible à utiliser à la longue, surtout dans
+les vues, il est préférable d'utiliser le raccourci `_url()` :
 
 ```php
 <?php
@@ -155,11 +219,16 @@ echo _url('hello', 'world', 'foo', 'bar');
 ?>
 ```
 
-Note : en règle générale, la forme raccourcie (`_url()`) doit être utilisée dans les vues tandis que la forme longue (`Minz_Url::display()`) doit être utilisée dans les contrôleurs.
+Note : en règle générale, la forme raccourcie (`_url()`) doit être utilisée
+dans les vues tandis que la forme longue (`Minz_Url::display()`) doit être
+utilisée dans les contrôleurs.
 
 ### Redirections
 
-Il est souvent nécessaire de rediriger un utilisateur vers une autre page. Pour cela, la classe `Minz_Request` dispose d'une autre méthode utile : `forward()`. Cette méthode prend en argument le même format d'URL que celui vu juste avant.
+Il est souvent nécessaire de rediriger un utilisateur vers une autre
+page. Pour cela, la classe `Minz_Request` dispose d'une autre méthode utile
+: `forward()`. Cette méthode prend en argument le même format d'URL que
+celui vu juste avant.
 
 Exemple de code :
 
@@ -173,7 +242,7 @@ $url_array = [
 
 // Indique à Minz de rediriger l'utilisateur vers la page hello/world.
 // Notez qu'il s'agit d'une redirection au sens Minz du terme, pas d'une redirection que le navigateur va avoir à gérer (code HTTP 301 ou 302)
-// Le code qui suit forward() va ainsi être exécuté !
+// Le code qui suit forward() va ainsi être exécuté !
 Minz_Request::forward($url_array);
 
 // Pour effectuer une redirection type 302, ajoutez "true".
@@ -183,7 +252,14 @@ Minz_Request::forward($url_array, true);
 ?>
 ```
 
-Il est très fréquent de vouloir effectuer une redirection tout en affichant un message à l'utilisateur pour lui indiquer comment s'est déroulée l'action effectuée juste avant (validation d'un formulaire par exemple). Un tel message est passé par une variable de session `notification` (note : nous parlerons plutôt de « feedback » désormais pour éviter la confusion avec une notification qui peut survenir à tout moment). Pour faciliter ce genre d'action très fréquente, il existe deux raccourcis qui effectuent tout deux une redirection type 302 en affectant un message de feedback :
+Il est très fréquent de vouloir effectuer une redirection tout en affichant
+un message à l'utilisateur pour lui indiquer comment s'est déroulée l'action
+effectuée juste avant (validation d'un formulaire par exemple). Un tel
+message est passé par une variable de session `notification` (note : nous
+parlerons plutôt de « feedback » désormais pour éviter la confusion avec une
+notification qui peut survenir à tout moment). Pour faciliter ce genre
+d'action très fréquente, il existe deux raccourcis qui effectuent tout deux
+une redirection type 302 en affectant un message de feedback :
 
 ```php
 <?php
@@ -206,43 +282,62 @@ Minz_Request::bad($feedback_bad, $url_array);
 
 ### Gestion de la traduction
 
-Il est fréquent (et c'est un euphémisme) de vouloir afficher des phrases à l'utilisateur. Dans l'exemple précédent par exemple, nous affichions un feedback à l'utilisateur en fonction du résultat d'une validation de formulaire. Le problème est que FreshRSS possède des utilisateurs de différentes nationalités. Il est donc nécessaire de pouvoir gérer différentes langues pour ne pas rester cantonné à l'Anglais ou au Français.
-
-La solution consiste à utiliser la classe `Minz_Translate` qui permet de traduire dynamiquement FreshRSS (ou toute application basée sur Minz). Avant d'utiliser ce module, il est nécessaire de savoir où trouver les chaînes de caractères à traduire. Chaque langue possède son propre sous-répertoire dans un répertoire parent nommé `i18n`. Par exemple, les fichiers de langue en Français sont situés dans `i18n/fr/`. Il existe sept fichiers différents :
-
-- `admin.php` pour tout ce qui est relatif à l'administration de FreshRSS ;
-- `conf.php` pour l'aspect configuration ;
-- `feedback.php` contient les traductions des messages de feedback ;
-- `gen.php` stocke ce qui est global à FreshRSS (gen pour « general ») ;
-- `index.php` pour la page principale qui liste les flux et la page « À propos » ;
-- `install.php` contient les phrases relatives à l'installation de FreshRSS ;
-- `sub.php` pour l'aspect gestion des abonnements (sub pour « subscription »).
-
-Cette organisation permet de ne pas avoir un unique énorme fichier de traduction.
-
-Les fichiers de traduction sont assez simples : il s'agit seulement de retourner un tableau PHP contenant les traductions. Extrait du fichier `app/i18n/fr/gen.php` :
+Il est fréquent (et c'est un euphémisme) de vouloir afficher des phrases à
+l'utilisateur. Dans l'exemple précédent par exemple, nous affichions un
+feedback à l'utilisateur en fonction du résultat d'une validation de
+formulaire. Le problème est que FreshRSS possède des utilisateurs de
+différentes nationalités. Il est donc nécessaire de pouvoir gérer
+différentes langues pour ne pas rester cantonné à l'Anglais ou au Français.
+
+La solution consiste à utiliser la classe `Minz_Translate` qui permet de
+traduire dynamiquement FreshRSS (ou toute application basée sur Minz). Avant
+d'utiliser ce module, il est nécessaire de savoir où trouver les chaînes de
+caractères à traduire. Chaque langue possède son propre sous-répertoire dans
+un répertoire parent nommé `i18n`. Par exemple, les fichiers de langue en
+Français sont situés dans `i18n/fr/`. Il existe sept fichiers différents :
+
+* `admin.php` pour tout ce qui est relatif à l'administration de FreshRSS ;
+* `conf.php` pour l'aspect configuration ;
+* `feedback.php` contient les traductions des messages de feedback ;
+* `gen.php` stocke ce qui est global à FreshRSS (gen pour « general ») ;
+* `index.php` pour la page principale qui liste les flux et la page « À
+  propos » ;
+* `install.php` contient les phrases relatives à l'installation de FreshRSS
+  ;
+* `sub.php` pour l'aspect gestion des abonnements (sub pour « subscription
+  »).
+
+Cette organisation permet de ne pas avoir un unique énorme fichier de
+traduction.
+
+Les fichiers de traduction sont assez simples : il s'agit seulement de
+retourner un tableau PHP contenant les traductions. Extrait du fichier
+`app/i18n/fr/gen.php` :
 
 ```php
 <?php
 
-return [
+return array(
 	'action' => [
 		'actualize' => 'Actualiser',
 		'back_to_rss_feeds' => '← Retour à vos flux RSS',
 		'cancel' => 'Annuler',
 		'create' => 'Créer',
 		'disable' => 'Désactiver',
-	],
-	'freshrss' => [
+	),
+	'freshrss' => array(
 		'_' => 'FreshRSS',
 		'about' => 'À propos de FreshRSS',
-	],
+	),
 ];
 
 ?>
 ```
 
-Pour accéder à ces traductions, `Minz_Translate` va nous aider à l'aide de sa méthode `Minz_Translate::t()`. Comme cela peut être un peu long à taper, il a été introduit un raccourci qui **doit** être utilisé en toutes circonstances : `_t()`. Exemple de code :
+Pour accéder à ces traductions, `Minz_Translate` va nous aider à l'aide de
+sa méthode `Minz_Translate::t()`. Comme cela peut être un peu long à taper,
+il a été introduit un raccourci qui **doit** être utilisé en toutes
+circonstances : `_t()`. Exemple de code :
 
 ```html
 <p>
@@ -252,85 +347,212 @@ Pour accéder à ces traductions, `Minz_Translate` va nous aider à l'aide de sa
 </p>
 ```
 
-La chaîne à passer à la fonction `_t()` consiste en une série d'identifiants séparés par des points. Le premier identifiant indique de quel fichier on veut extraire la traduction (dans notre cas présent, de `gen.php`), tandis que les suivantes indiquent des entrées de tableaux. Ainsi `action` est une entrée du tableau principal et `back_to_rss_feeds` est une entrée du tableau `action`. Cela permet d'organiser encore un peu plus nos fichiers de traduction.
-
-Il existe un petit cas particulier qui permet parfois de se simplifier la vie : le cas de l'identifiant `_`. Celui-ci doit nécessairement être présent en bout de chaîne et permet de donner une valeur à l'identifiant de niveau supérieur. C'est assez dur à expliquer mais très simple à comprendre. Dans l'exemple donné plus haut, un `_` est associé à la valeur `FreshRSS` : cela signifie qu'il n'y a pas besoin d'écrire `_t('gen.freshrss._')` mais `_t('gen.freshrss')` suffit.
+La chaîne à passer à la fonction `_t()` consiste en une série d'identifiants
+séparés par des points. Le premier identifiant indique de quel fichier on
+veut extraire la traduction (dans notre cas présent, de `gen.php`), tandis
+que les suivantes indiquent des entrées de tableaux. Ainsi `action` est une
+entrée du tableau principal et `back_to_rss_feeds` est une entrée du tableau
+`action`. Cela permet d'organiser encore un peu plus nos fichiers de
+traduction.
+
+Il existe un petit cas particulier qui permet parfois de se simplifier la
+vie : le cas de l'identifiant `_`. Celui-ci doit nécessairement être présent
+en bout de chaîne et permet de donner une valeur à l'identifiant de niveau
+supérieur. C'est assez dur à expliquer mais très simple à comprendre. Dans
+l'exemple donné plus haut, un `_` est associé à la valeur `FreshRSS` : cela
+signifie qu'il n'y a pas besoin d'écrire `_t('gen.freshrss._')` mais
+`_t('gen.freshrss')` suffit.
 
 ### Gestion de la configuration
 
 ## Écrire une extension pour FreshRSS
 
-Nous y voilà ! Nous avons abordé les fonctionnalités les plus utiles de Minz et qui permettent de faire tourner FreshRSS correctement et il est plus que temps d'aborder les extensions en elles-même.
+Nous y voilà ! Nous avons abordé les fonctionnalités les plus utiles de Minz
+et qui permettent de faire tourner FreshRSS correctement et il est plus que
+temps d'aborder les extensions en elles-même.
 
-Une extension permet donc d'ajouter des fonctionnalités facilement à FreshRSS sans avoir à toucher au cœur du projet directement.
+Une extension permet donc d'ajouter des fonctionnalités facilement à
+FreshRSS sans avoir à toucher au cœur du projet directement.
 
 ### Les fichiers et répertoires de base
 
-La première chose à noter est que **toutes** les extensions **doivent** se situer dans le répertoire `extensions`, à la base de l'arborescence de FreshRSS. Une extension est un répertoire contenant un ensemble de fichiers et sous-répertoires obligatoires ou facultatifs. La convention veut que l'on précède le nom du répertoire principal par un « x » pour indiquer qu'il ne s'agit pas d'une extension incluse par défaut dans FreshRSS.
-
-Le répertoire principal d'une extension doit comporter au moins deux fichiers **obligatoire** :
-
-- Un fichier `metadata.json` qui contient une description de l'extension. Ce fichier est écrit en JSON ;
-- Un fichier `extension.php` contenant le point d'entrée de l'extension.
+La première chose à noter est que **toutes** les extensions **doivent** se
+situer dans le répertoire `extensions`, à la base de l'arborescence de
+FreshRSS. Une extension est un répertoire contenant un ensemble de fichiers
+et sous-répertoires obligatoires ou facultatifs. La convention veut que l'on
+précède le nom du répertoire principal par un « x » pour indiquer qu'il ne
+s'agit pas d'une extension incluse par défaut dans FreshRSS.
 
-Il est possible aussi que vous ayez besoin de fichiers ou sous-répertoires additionnels selon vos besoins :
+Le répertoire principal d'une extension doit comporter au moins deux
+fichiers **obligatoire** :
 
-- `configure.phtml` est le fichier contenant le formulaire permettant de paramétrer votre extension ;
-- Un répertoire `static/` contenant fichiers CSS et JavaScript dont vous aurez besoin pour votre extension. Notez que si vous devez écrire beaucoup de CSS il est peut-être plus intéressant d'écrire un thème complet (mais ce n'est pas le sujet de cette fiche technique) ;
-- Un répertoire `Controllers` contenant des contrôleurs additionnels ;
-- Un répertoire `i18n` contenant des traductions supplémentaires ;
-- Des répertoires `layout` et `views` permettant de définir de nouvelles vues ou d'écraser les vues actuelles.
+* Un fichier `metadata.json` qui contient une description de l'extension. Ce
+  fichier est écrit en JSON ;
+* Un fichier `extension.php` contenant le point d'entrée de l'extension.
 
-De plus, il est de bon ton d'avoir un fichier `LICENSE` indiquant la licence sous laquelle est distribuée votre extension et un fichier `README` donnant une description détaillée de celle-ci.
+Please note that there is a not a required link between the directory name
+of the extension and the name of the class inside `extension.php`, but you
+should follow our best practice: If you want to write a `HelloWorld`
+extension, the directory name should be `xExtension-HelloWorld` and the base
+class name `HelloWorldExtension`.
 
-### Écrire le fichier metadata.json
-
-Le fichier `metadata.json` définit votre extension à travers un certain nombre d'éléments importants. Il doit contenir un tableau JSON valide contenant les entrées suivantes :
-
-- `name` : le nom de votre extension ;
-- `author` : votre nom, éventuellement votre adresse mail mais il n'y a pas de format spécifique à adopter ;
-- `description` : une description de votre extension ;
-- `version` : le numéro de version actuel de l'extension ;
-- `entrypoint` : indique le point d'entrée de votre extension. Il doit correspondre au nom de la classe contenue dans le fichier `extension.php` sans le suffixe `Extension` (donc si le point d'entrée est `HelloWorld`, votre classe s'appellera `HelloWorldExtension`) ;
-- `type` : définit le type de votre extension. Il existe deux types : `system` et `user`. Nous étudierons cette différence juste après.
+In the file `freshrss/extensions/xExtension-HelloWorld/extension.php` you
+need the structure:
+```html
+class HelloWorldExtension extends Minz_Extension {
+	public function init() {
+		// your code here
+	}
+}
+```
+There is an example HelloWorld extension that you can download from [our
+GitHub repo](https://github.com/FreshRSS/xExtension-HelloWorld).
+
+You may also need additional files or subdirectories depending on your
+needs:
+
+* `configure.phtml` est le fichier contenant le formulaire pour paramétrer
+  votre extension
+* A `static/` directory containing CSS and JavaScript files that you will
+  need for your extension (note that if you need to write a lot of CSS it
+  may be more interesting to write a complete theme)
+* A `Controllers` directory containing additional controllers
+* An `i18n` directory containing additional translations
+* `layout` and` views` directories to define new views or to overwrite the
+  current views
+
+In addition, it is good to have a `LICENSE` file indicating the license
+under which your extension is distributed and a` README` file giving a
+detailed description of it.
+
+### The metadata.json file
+
+The `metadata.json` file defines your extension through a number of
+important elements. It must contain a valid JSON array containing the
+following entries:
+
+* `name` : le nom de votre extension ;
+* `author` : votre nom, éventuellement votre adresse mail mais il n'y a pas
+  de format spécifique à adopter ;
+* `description` : une description de votre extension ;
+* `version` : le numéro de version actuel de l'extension ;
+* `entrypoint` : indique le point d'entrée de votre extension. Il doit
+  correspondre au nom de la classe contenue dans le fichier `extension.php`
+  sans le suffixe `Extension` (donc si le point d'entrée est `HelloWorld`,
+  votre classe s'appellera `HelloWorldExtension`) ;
+* `type` : définit le type de votre extension. Il existe deux types :
+  `system` et `user`. Nous étudierons cette différence juste après.
 
 Seuls les champs `name` et `entrypoint` sont requis.
 
 ### Choisir entre extension « system » ou « user »
 
-### Écrire le fichier extension.php
-
-Ce fichier est le point d'entrée de votre extension. Il doit contenir une classe bien spécifique pour fonctionner. Comme évoqué plus haut, le nom de la classe doit être votre `entrypoint` suffixé par `Extension` (`HelloWorldExtension` par exemple). De plus, cette classe doit héritée de la classe `Minz_Extension` pour bénéficier des méthodes propres aux extensions.
-
-Votre classe va bénéficier de quatre méthodes à redéfinir :
-
-- `install()` est appelée lorsqu'un utilisateur va cliquer sur le bouton pour activer votre extension. Elle permet par exemple de mettre à jour la base de données d'un utilisateur afin de la rendre compatible avec l'extension. Elle retourne `true` si tout s'est bien passé ou, dans le cas contraire, une chaîne de caractères expliquant le problème ;
-- `uninstall()` est appelée lorsqu'un utilisateur va cliquer sur le bouton pour désactiver votre extension. Ainsi, vous pourrez annuler les changements en base de données que vous avez potentiellement faits dans `install()`. Elle retourne `true` si tout s'est bien passé ou, dans le cas contraire, une chaîne de caractères expliquant le problème ;
-- `init()` est appelée à chaque chargement de page *si l'extension est activée*. Elle va donc initialiser le comportement de l'extension. C'est la méthode la plus importante ;
-- `handleConfigureAction()` est appelée lorsqu'un utilisateur charge le panneau de gestion de l'extension. Plus précisément, elle est appelée lorsque l'URL `?c=extension&a=configure&e=le-nom-de-votre-extension` est chargée. Vous devriez aussi écrire ici le comportement voulu lors de la validation du formulaire contenu dans votre fichier `configure.phtml`.
-
-De plus, vous disposerez d'un certain nombre de méthodes directement héritées de `Minz_Extension` que vous ne devriez pas redéfinir :
-
-- Les « getters » tout d'abord. La plupart sont suffisamment explicites pour ne pas les détailler : `getName()`, `getEntrypoint()`, `getPath()` (permet de récupérer le chemin vers votre extension), `getAuthor()`, `getDescription()`, `getVersion()`, `getType()` ;
-- `getFileUrl($filename, $type)` va vous retourner l'URL vers un fichier du répertoire `static`. Le premier paramètre est le nom du fichier (sans `static/`), le deuxième est le type de fichier à servir (`css` ou `js`) ;
-- `registerController($base_name)` va indiquer à Minz de prendre en compte le contrôleur donné dans le système de routage. Le contrôleur doit se situer dans votre répertoire `Controllers`, le nom du fichier doit être `<base_name>Controller.php` et le nom de la classe `FreshExtension_<base_name>_Controller`.
-
-TODO :
-
-- `registerViews()`
-- `registerTranslates()`
-- `registerHook($hook_name, $hook_function)`
+A __user__ extension can be enabled by some users and not by others
+(typically for user preferences).
+
+A __system__ extension in comparison is enabled for every account.
+
+### Writing your own extension.php
+
+This file is the entry point of your extension. It must contain a specific
+class to function.  As mentioned above, the name of the class must be your
+`entrypoint` suffixed by` Extension` (`HelloWorldExtension` for example).
+In addition, this class must be inherited from the `Minz_Extension` class to
+benefit from extensions-specific methods.
+
+Your class will benefit from four methods to redefine:
+
+* `install()` is called when a user clicks the button to activate your
+  extension. It allows, for example, to update the database of a user in
+  order to make it compatible with the extension. It returns `true` if
+  everything went well or, if not, a string explaining the problem.
+* `uninstall()` is called when a user clicks the button to disable your
+  extension. This will allow you to undo the database changes you
+  potentially made in `install ()`. It returns `true` if everything went
+  well or, if not, a string explaining the problem.
+* `init()` is called for every page load *if the extension is enabled*. It
+  will therefore initialize the behavior of the extension. This is the most
+  important method.
+* `handleConfigureAction()` is called when a user loads the extension
+  management panel. Specifically, it is called when the
+  `?c=extension&a=configured&e=name-of-your-extension` URL is loaded. You
+  should also write here the behavior you want when validating the form in
+  your `configure.phtml` file.
+
+In addition, you will have a number of methods directly inherited from
+`Minz_Extension` that you should not redefine:
+
+* The "getters" first: most are explicit enough not to detail them here -
+  `getName()`, `getEntrypoint()`, `getPath()` (allows you to retrieve the
+  path to your extension), `getAuthor()`, `getDescription()`,
+  `getVersion()`, `getType()`.
+* `getFileUrl($filename, $type)` will return the URL to a file in the
+  `static` directory. The first parameter is the name of the file (without
+  `static /`), the second is the type of file to be used (`css` or` js`).
+* `registerController($base_name)` will tell Minz to take into account the
+  given controller in the routing system. The controller must be located in
+  your `Controllers` directory, the name of the file must be`
+  <base_name>Controller.php` and the name of the
+  `FreshExtension_<base_name>_Controller` class.
+
+**À FAIRE**
+
+* `registerViews()`
+* `registerTranslates()`
+* `registerHook($hook_name, $hook_function)`
+
+### Le système « hooks »
+
+You can register at the FreshRSS event system in an extensions `init()`
+method, to manipulate data when some of the core functions are executed.
 
-### Système de « hooks »
-
-TODO :
-
-- `entry_before_display` (`function($entry) -> Entry | null`)
-- `entry_before_insert` (`function($entry) -> Entry | null`)
-- `feed_before_insert` (`function($feed) -> Feed | null`)
-- `post_update` (`function(none) -> none`)
-- `simplepie_before_init` (`function($simplePie, $feed) -> none`)
-
-### Écrire le fichier configure.phtml
+```html
+class HelloWorldExtension extends Minz_Extension
+{
+	public function init() {
+		$this->registerHook('entry_before_display', array($this, 'renderEntry'));
+	}
+	public function renderEntry($entry) {
+		$entry->_content('<h1>Hello World</h1>' . $entry->content());
+		return $entry;
+	}
+}
+```
 
-Lorsque vous voulez ajouter de la configuration à votre extension ou afficher ses informations, vous devez créer le fichier `configure.phtml`.
+The following events are available:
+
+* `entry_before_display` (`function($entry) -> Entry | null`): will be
+  executed every time an entry is rendered. The entry itself (instance of
+  FreshRSS\_Entry) will be passed as parameter.
+* `entry_before_insert` (`function($entry) -> Entry | null`): will be
+  executed when a feed is refreshed and new entries will be imported into
+  the database. The new entry (instance of FreshRSS\_Entry) will be passed
+  as parameter.
+* `feed_before_insert` (`function($feed) -> Feed | null`): will be executed
+  when a new feed is imported into the database. The new feed (instance of
+  FreshRSS\_Feed) will be passed as parameter.
+* `freshrss_init` (`function() -> none`): will be executed at the end of the
+  initialization of FreshRSS, useful to initialize components or to do
+  additional access checks
+* `menu_admin_entry` (`function() -> string`): add an entry at the end of
+  the "Administration" menu, the returned string must be valid HTML
+  (e.g. `<li class="item active"><a href="url">New entry</a></li>`)
+* `menu_configuration_entry` (`function() -> string`): add an entry at the
+  end of the "Configuration" menu, the returned string must be valid HTML
+  (e.g. `<li class="item active"><a href="url">New entry</a></li>`)
+* `menu_other_entry` (`function() -> string`): add an entry at the end of
+  the header dropdown menu (i.e. after the "About" entry), the returned
+  string must be valid HTML (e.g. `<li class="item active"><a href="url">New
+  entry</a></li>`)
+* `nav_reading_modes` (`function($reading_modes) -> array | null`): **TODO**
+  add documentation
+* `post_update` (`function(none) -> none`): **TODO** add documentation
+* `simplepie_before_init` (`function($simplePie, $feed) -> none`): **TODO**
+  add documentation
+
+### Writing your own configure.phtml
+
+When you want to support user configurations for your extension or simply
+display some information, you have to create the `configure.phtml` file.
+
+**À FAIRE**

docs/fr/developers/04_Frontend/01_View_files.md

@@ -1,15 +1,15 @@
 # Les fichiers .phtml
 
-**TODO**
+**À FAIRE**
 
 # Écrire une URL
 
-**TODO**
+**À FAIRE**
 
 # Afficher une icône
 
-**TODO**
+**À FAIRE**
 
 # Internationalisation
 
-**TODO**
+**À FAIRE**

docs/fr/developers/04_Frontend/02_Design.md

@@ -1,11 +1,11 @@
 # Fichier modèle
 
-**TODO**
+**À FAIRE**
 
 # Écrire un nouveau thème
 
-**TODO**
+**À FAIRE**
 
 # Surcharger les icônes
 
-**TODO**
+**À FAIRE**

docs/fr/developers/05_Release_new_version.md

@@ -1,14 +1,21 @@
 # Préparer la sortie
 
-Afin d'avoir le plus de retour possible avant une sortie, il est préférable de l'annoncer sur GitHub en créant un ticket dédié ([voir les exemples](https://github.com/FreshRSS/FreshRSS/search?utf8=%E2%9C%93&q=Call+for+testing&type=Issues)). Ceci est à faire **au moins une semaine à l'avance**.
+Afin d'avoir le plus de retour possible avant une sortie, il est préférable
+de l'annoncer sur GitHub en créant un ticket dédié ([voir les
+exemples](https://github.com/FreshRSS/FreshRSS/search?utf8=%E2%9C%93&q=Call+for+testing&type=Issues)).
+Ceci est à faire **au moins une semaine à l'avance**.
 
 Il est aussi recommandé de faire l'annonce sur mailing@freshrss.org.
 
 # S'assurer de l'état de dev
 
-Avant de sortir une nouvelle version de FreshRSS, il faut vous assurer que le code est stable et ne présente pas de bugs majeurs. Idéalement, il faudrait que nos tests soient automatisés et exécutés avant toute publication.
+Avant de sortir une nouvelle version de FreshRSS, il faut vous assurer que
+le code est stable et ne présente pas de bugs majeurs. Idéalement, il
+faudrait que nos tests soient automatisés et exécutés avant toute
+publication.
 
-Il faut aussi **vous assurer que le fichier CHANGELOG est à jour** dans la branche de dev avec les mises à jour de la ou les version(s) à sortir.
+Il faut aussi **vous assurer que le fichier CHANGELOG est à jour** dans la
+branche de dev avec les mises à jour de la ou les version(s) à sortir.
 
 # Processus Git
 
@@ -27,33 +34,56 @@ $ git push && git push --tags
 
 # Mise à jour de update.freshrss.org
 
-Il est important de mettre à jour update.freshrss.org puisqu'il s'agit du service par défaut gérant les mises à jour automatiques de FreshRSS.
+Il est important de mettre à jour update.freshrss.org puisqu'il s'agit du
+service par défaut gérant les mises à jour automatiques de FreshRSS.
 
-Le dépot gérant le code se trouve sur GitHub : [FreshRSS/update.freshrss.org](https://github.com/FreshRSS/update.freshrss.org/).
+Le dépot gérant le code se trouve sur GitHub :
+[FreshRSS/update.freshrss.org](https://github.com/FreshRSS/update.freshrss.org/).
 
 ## Écriture du script de mise à jour
 
-Les scripts se trouvent dans le répertoire `./scripts/` et doivent être de la forme `update_to_x.y.z.php`. On trouve aussi dans ce répertoire `update_to_dev.php` destiné aux mises à jour de la branche de dev (ce script ne doit pas inclure de code spécifique à une version particulière !) et `update_util.php` contenant une liste de fonctions utiles à tous les scripts.
+Les scripts se trouvent dans le répertoire `./scripts/` et doivent être de
+la forme `update_to_x.y.z.php`. On trouve aussi dans ce répertoire
+`update_to_dev.php` destiné aux mises à jour de la branche de dev (ce script
+ne doit pas inclure de code spécifique à une version particulière !) et
+`update_util.php` contenant une liste de fonctions utiles à tous les
+scripts.
 
-Afin d'écrire un nouveau script, il est préférable de copier / coller celui de la dernière version ou de partir de `update_to_dev.php`. La première chose à faire est de définir l'URL à partir de laquelle sera téléchargée le package FreshRSS (`PACKAGE_URL`). L'URL est de la forme `https://codeload.github.com/FreshRSS/FreshRSS/zip/x.y.z`.
+Afin d'écrire un nouveau script, il est préférable de copier / coller celui
+de la dernière version ou de partir de `update_to_dev.php`. La première
+chose à faire est de définir l'URL à partir de laquelle sera téléchargée le
+package FreshRSS (`PACKAGE_URL`). L'URL est de la forme
+`https://codeload.github.com/FreshRSS/FreshRSS/zip/x.y.z`.
 
 Il existe ensuite 5 fonctions à remplir :
 
-- `apply_update()` qui se charge de sauvegarder le répertoire contenant les données, de vérifier sa structure, de télécharger le package FreshRSS, de le déployer et de tout nettoyer. Cette fonction est pré-remplie mais des ajustements peuvent être faits si besoin est (ex. réorganisation de la structure de `./data`). Elle retourne `true` si aucun problème n'est survenu ou une chaîne de caractères indiquant un soucis ;
-- `need_info_update()` retourne `true` si l'utilisateur doit intervenir durant la mise à jour ou `false` sinon ;
-- `ask_info_update()` affiche un formulaire à l'utilisateur si `need_info_update()` a retourné `true` ;
-- `save_info_update()` est chargée de sauvegarder les informations renseignées par l'utilisateur (issues du formulaire de `ask_info_update()`) ;
-- `do_post_update()` est exécutée à la fin de la mise à jour et prend en compte le code de la nouvelle version (ex. si la nouvelle version modifie l'objet `Minz_Configuration`, vous bénéficierez de ces améliorations).
+* `apply_update()` qui se charge de sauvegarder le répertoire contenant les
+  données, de vérifier sa structure, de télécharger le package FreshRSS, de
+  le déployer et de tout nettoyer. Cette fonction est pré-remplie mais des
+  ajustements peuvent être faits si besoin est (ex. réorganisation de la
+  structure de `./data`). Elle retourne `true` si aucun problème n'est
+  survenu ou une chaîne de caractères indiquant un soucis ;
+* `need_info_update()` retourne `true` si l'utilisateur doit intervenir
+  durant la mise à jour ou `false` sinon ;
+* `ask_info_update()` affiche un formulaire à l'utilisateur si
+  `need_info_update()` a retourné `true` ;
+* `save_info_update()` est chargée de sauvegarder les informations
+  renseignées par l'utilisateur (issues du formulaire de
+  `ask_info_update()`) ;
+* `do_post_update()` est exécutée à la fin de la mise à jour et prend en
+  compte le code de la nouvelle version (ex. si la nouvelle version modifie
+  l'objet `Minz_Configuration`, vous bénéficierez de ces améliorations).
 
 ## Mise à jour du fichier de versions
 
-Lorsque le script a été écrit et versionné, il est nécessaire de mettre à jour le fichier `./versions.php` qui contient une table de correspondances indiquant quelles versions sont mises à jour vers quelles autres versions.
+Lorsque le script a été écrit et versionné, il est nécessaire de mettre à
+jour le fichier `./versions.php` qui contient une table de correspondances
+indiquant quelles versions sont mises à jour vers quelles autres versions.
 
 Voici un exemple de fichier `versions.php` :
 
 ```php
 <?php
-
 return array(
 	// STABLE
 	'0.8.0' => '1.0.0',
@@ -68,35 +98,49 @@ return array(
 
 Et voici comment fonctionne cette table :
 
-- à gauche se trouve la version N, à droite la version N+1 ;
-- les versions `x.y.z-dev` sont **toutes** mises à jour vers `dev` ;
-- les versions stables sont mises à jour vers des versions stables ;
-- il est possible de sauter plusieurs versions d'un coup à condition que les scripts de mise à jour le prennent en charge ;
-- il est conseillé d'indiquer la correspondance de la version courante vers sa potentielle future version en précisant que cette version n'existe pas encore. Tant que le script correspondant n'existera pas, rien ne se passera.
+* à gauche se trouve la version N, à droite la version N+1 ;
+* les versions `x.y.z-dev` sont **toutes** mises à jour vers `dev` ;
+* les versions stables sont mises à jour vers des versions stables ;
+* il est possible de sauter plusieurs versions d'un coup à condition que les
+  scripts de mise à jour le prennent en charge ;
+* il est conseillé d'indiquer la correspondance de la version courante vers
+  sa potentielle future version en précisant que cette version n'existe pas
+  encore. Tant que le script correspondant n'existera pas, rien ne se
+  passera.
 
-Il est **très fortement** indiqué de garder ce fichier rangé selon les numéros de versions en séparant les versions stables et de dev.
+Il est **très fortement** indiqué de garder ce fichier rangé selon les
+numéros de versions en séparant les versions stables et de dev.
 
 ## Déploiement
 
-Avant de mettre à jour update.freshrss.org, il est préférable de tester avec dev.update.freshrss.org qui correspond à la pré-production. Mettez donc à jour dev.update.freshrss.org et changez l'URL `FRESHRSS_UPDATE_WEBSITE` de votre instance FreshRSS. Lancez la mise à jour et vérifiez que celle-ci se déroule correctement.
+Avant de mettre à jour update.freshrss.org, il est préférable de tester avec
+dev.update.freshrss.org qui correspond à la pré-production. Mettez donc à
+jour dev.update.freshrss.org et changez l'URL `FRESHRSS_UPDATE_WEBSITE` de
+votre instance FreshRSS. Lancez la mise à jour et vérifiez que celle-ci se
+déroule correctement.
 
-Lorsque vous serez satisfait, mettez à jour update.freshrss.org avec le nouveau script et en testant de nouveau puis passez à la suite.
+Lorsque vous serez satisfait, mettez à jour update.freshrss.org avec le
+nouveau script et en testant de nouveau puis passez à la suite.
 
 # Mise à jour des services FreshRSS
 
-Deux services sont à mettre à jour immédiatement après la mise à jour de update.freshrss.org :
+Deux services sont à mettre à jour immédiatement après la mise à jour de
+update.freshrss.org :
 
-- rss.freshrss.org ;
-- demo.freshrss.org (identifiants publics : `demo` / `demodemo`).
+* rss.freshrss.org ;
+* demo.freshrss.org (identifiants publics : `demo` / `demodemo`).
 
 # Annoncer publiquement la sortie
 
 Lorsque tout fonctionne, il est temps d'annoncer la sortie au monde entier !
 
-- sur GitHub en créant [une nouvelle release](https://github.com/FreshRSS/FreshRSS/releases/new) ;
-- sur le blog de freshrss.org au minimum pour les versions stables (écrire l'article sur [FreshRSS/freshrss.org](https://github.com/FreshRSS/freshrss.org)).
-- sur Twitter (compte [@FreshRSS](https://twitter.com/FreshRSS)) ;
-- et sur mailing@freshrss.org ;
+* sur GitHub en créant [une nouvelle
+  release](https://github.com/FreshRSS/FreshRSS/releases/new) ;
+* sur le blog de freshrss.org au minimum pour les versions stables (écrire
+  l'article sur
+  [FreshRSS/freshrss.org](https://github.com/FreshRSS/freshrss.org)).
+* sur Twitter (compte [@FreshRSS](https://twitter.com/FreshRSS)) ;
+* et sur mailing@freshrss.org ;
 
 # Lancer la prochaine version de développement
 
@@ -109,4 +153,5 @@ $ vim CHANGELOG.md
 $ git add CHANGELOG.md && git commit && git push
 ```
 
-Pensez aussi à mettre à jour update.freshrss.org pour qu'il prenne en compte la version de développement actuelle.
+Pensez aussi à mettre à jour update.freshrss.org pour qu'il prenne en compte
+la version de développement actuelle.

docs/fr/index.md

@@ -1,24 +1,37 @@
 ![Logo de FreshRSS](img/logo_freshrss.png)
 
-FreshRSS est un agrégateur et lecteur de flux RSS. Il permet de regrouper l’actualité de plusieurs sites différents dans un endroit unique pour que vous puissiez la lire sans devoir aller de site en site.
+FreshRSS est un agrégateur et lecteur de flux RSS. Il permet de regrouper
+l’actualité de plusieurs sites différents dans un endroit unique pour que
+vous puissiez la lire sans devoir aller de site en site.
 
-FreshRSS a été conçu comme un agrégateur puissant et propose des tas de fonctionnalités :
+FreshRSS a été conçu comme un agrégateur puissant et propose des tas de
+fonctionnalités :
 
-- Agrégation des flux RSS et Atom.
-- Utilisez les favoris pour marquer les articles qui vous ont plu ou que vous souhaitez lire plus tard.
-- Le système de filtrage et de recherche permettent de cibler exactement les articles que vous souhaitez lire.
-- Les statistiques permettent de savoir en un coup d’œil quels sont les sites qui publient le plus, ou à l’inverse, le moins.
-- Importation / exportation des flux au format OPML.
-- Multi-thèmes pour changer l’habillage de FreshRSS.
-- « *Responsive design* » : l’application s’adapte aux petits écrans pour emporter FreshRSS dans votre poche.
-- Multi-utilisateurs pour héberger plusieurs personnes sur une même installation.
-- API Google Reader pour pouvoir y brancher des applications Android.
-- Auto-hébergeable : le code source est libre (AGPL3) et vous pouvez donc l’héberger sur votre propre serveur.
-- Et bien d’autres !
+* Agrégation des flux RSS et Atom.
+* Utilisez les favoris pour marquer les articles qui vous ont plu ou que
+  vous souhaitez lire plus tard.
+* Le système de filtrage et de recherche permettent de cibler exactement les
+  articles que vous souhaitez lire.
+* Les statistiques permettent de savoir en un coup d’œil quels sont les
+  sites qui publient le plus, ou à l’inverse, le moins.
+* Importation / exportation des flux au format OPML.
+* Multi-thèmes pour changer l’habillage de FreshRSS.
+* API Google Reader pour pouvoir y brancher des applications Android.
+* « *Responsive design* » : l’application s’adapte aux petits écrans pour
+  emporter FreshRSS dans votre poche.
+* Auto-hébergeable : le code source est libre (AGPL3) et vous pouvez donc
+  l’héberger sur votre propre serveur.
+* Multi-utilisateurs pour héberger plusieurs personnes sur une même
+  installation.
+* Et bien d’autres !
 
 Cette documentation est divisée en plusieurs parties :
 
-* La [documentation utilisateurs](./users/02_First_steps.md) pour découvrir les fonctionnalités de FreshRSS.
-* La [documentation administrateurs](./users/01_Installation.md) pour l’installation et la maintenance de FreshRSS.
-* La [documentation développeurs](./developers/01_First_steps.md) pour savoir comment contribuer et mieux comprendre le code source de FreshRSS.
-* Le [guide de contribution](./contributing.md) pour nous aider à développer FreshRSS.
+* La [documentation utilisateurs](./users/02_First_steps.md) pour découvrir
+  les fonctionnalités de FreshRSS.
+* La [documentation administrateurs](../en/admins/01_Installation.md) (en
+  anglais) pour l’installation et la maintenance de FreshRSS.
+* La [documentation développeurs](./developers/01_First_steps.md) pour
+  savoir comment contribuer et mieux comprendre le code source de FreshRSS.
+* Le [guide de contribution](./contributing.md) pour nous aider à développer
+  FreshRSS.

docs/fr/users/02_First_steps.md

@@ -1,25 +1,46 @@
-Découvrir un nouveau logiciel n'est pas toujours facile. Si nous avons voulu FreshRSS le plus intuitif possible, vous aurez peut-être besoin d'un coup de main pour le maîtriser.
+Découvrir un nouveau logiciel n'est pas toujours facile. Si nous avons voulu
+FreshRSS le plus intuitif possible, vous aurez peut-être besoin d'un coup de
+main pour le maîtriser.
 
-Cette section se propose de vous aider dans la prise en main de l'outil. Il ne s'agit que de liens menant vers les autres pages de la documentation mais ordonnées dans un ordre spécifique aux nouveaux arrivants.
+Cette section se propose de vous aider dans la prise en main de l'outil. Il
+ne s'agit que de liens menant vers les autres pages de la documentation mais
+ordonnées dans un ordre spécifique aux nouveaux arrivants.
 
-[Après l'installation](01_Installation.md), la première chose à faire est d'ajouter un ou plusieurs sites à suivre. Pour cela plusieurs choix s'offrent à vous :
+[Après l'installation](../../en/admins/03_Installation.md), la première
+chose à faire est d'ajouter un ou plusieurs sites à suivre. Pour cela
+plusieurs choix s'offrent à vous :
 
- 1.  [Ajouter un flux manuellement](04_Subscriptions.md#ajouter-un-flux)
- 2.  [Importer un fichier OPML ou JSON](04_Subscriptions.md#import-et-export)
- 3.  [Utiliser le bookmark dédié](04_Subscriptions.md#utiliser-le-bookmark)
+1. [Ajouter un flux manuellement](04_Subscriptions.md#ajouter-un-flux)
+2. [Importer un fichier OPML ou JSON](04_Subscriptions.md#import-et-export)
+3. [Utiliser le bookmark dédié](04_Subscriptions.md#utiliser-le-bookmark)
 
-Une fois que vous avez ajouté vos flux à FreshRSS, il est temps de les lire. Pour cela, trois modes de lecture s'offrent à vous :
+Une fois que vous avez ajouté vos flux à FreshRSS, il est temps de les
+lire. Pour cela, trois modes de lecture s'offrent à vous :
 
- 1.  [La vue normale](03_Main_view.md#la-vue-normale) qui permet de voir et de lire rapidement les nouveaux articles
- 2.  [La vue globale](03_Main_view.md#la-vue-globale) est destinée à vous offrir un panorama de l'état de vos flux
- 3.  [La vue lecture](03_Main_view.md#la-vue-lecture) est pensée pour vous offrir un meilleur confort de lecture
+1. [La vue normale](03_Main_view.md#la-vue-normale) qui permet de voir et de
+   lire rapidement les nouveaux articles
+2. [La vue globale](03_Main_view.md#la-vue-globale) est destinée à vous
+   offrir un panorama de l'état de vos flux
+3. [La vue lecture](03_Main_view.md#la-vue-lecture) est pensée pour vous
+   offrir un meilleur confort de lecture
 
-Bien, vous maitrisez maintenant la vue que vous préférez ? Il est temps de vous offrir un peu plus de confort de lecture. FreshRSS est grandement configurable et c'est à vous de trouver la configuration qui vous conviendra le plus. Voici tout de même quelques pistes pour améliorer votre quotidien sur FreshRSS :
+Bien, vous maitrisez maintenant la vue que vous préférez ? Il est temps de
+vous offrir un peu plus de confort de lecture. FreshRSS est grandement
+configurable et c'est à vous de trouver la configuration qui vous conviendra
+le plus. Voici tout de même quelques pistes pour améliorer votre quotidien
+sur FreshRSS :
 
-* [Rangez vos flux dans des catégories](04_Subscriptions.md#organisation_des_flux)
-* [Configurez votre page d'accueil](05_Configuration.md#personnaliser-la-vue)
-* [Configurez vos options de lecture](05_Configuration.md#options-de-lecture)
+* [Rangez vos flux dans des
+  catégories](04_Subscriptions.md#organisation_des_flux)
+* [Configurez votre page
+  d'accueil](05_Configuration.md#personnaliser-la-vue)
+* [Configurez vos options de
+  lecture](05_Configuration.md#options-de-lecture)
 * [Mettez à jour vos flux](03_Main_view.md#rafraichir-les-flux)
-* [Filtrez les articles](03_Main_view.md#filtrer-les-articles) pour accéder rapidement à ceux que vous voulez lire en priorité
-* [Retrouvez un article](03_Main_view.md#rechercher-des-articles) qui a été publié il y a quelques jours ou mois
+* [Filtrez les articles](03_Main_view.md#filtrer-les-articles) pour accéder
+  rapidement à ceux que vous voulez lire en priorité
+* [Retrouvez un article](03_Main_view.md#rechercher-des-articles) qui a été
+  publié il y a quelques jours ou mois
 * [Accédez à vos flux même sur mobile](06_Mobile_access.md)
+* [Ajoutez quelques extensions](https://github.com/FreshRSS/Extensions)
+* [Foire aux questions](07_Frequently_Asked_Questions.md)

docs/fr/users/03_Main_view.md

@@ -1,65 +1,97 @@
 # La vue normale
 
-**TODO**
+**À FAIRE**
 
 # La vue globale
 
-**TODO**
+**À FAIRE**
 
 # La vue lecture
 
-**TODO**
+**À FAIRE**
 
 # Rafraîchir les flux
 
-Pour profiter pleinement de FreshRSS, il faut qu’il récupère les nouveaux articles disponibles des flux auxquels vous avez souscrit. Pour cela, il existe plusieurs méthodes.
+Pour profiter pleinement de FreshRSS, il faut qu’il récupère les nouveaux
+articles disponibles des flux auxquels vous avez souscrit. Pour cela, il
+existe plusieurs méthodes.
 
 ## Mise à jour automatique
 
-C’est la méthode recommandée car il n’y a pas besoin d’y penser, elle se fait toute seule, à la fréquence que vous avez choisi.
+C’est la méthode recommandée car il n’y a pas besoin d’y penser, elle se
+fait toute seule, à la fréquence que vous avez choisi.
 
 ### Par le script actualize_script.php
 
-Cette méthode n’est possible que si vous avez accès aux tâches planifiées de la machine sur laquelle est installée votre instance de FreshRSS.
+Cette méthode n’est possible que si vous avez accès aux tâches planifiées de
+la machine sur laquelle est installée votre instance de FreshRSS.
 
-Le script qui permet de mettre à jour les articles s’appelle *actualize_script.php* et se trouve dans le répertoire *app* de votre instance de FreshRSS. La syntaxe des tâches planifiées ne sera pas expliqué ici, cependant voici [une introduction rapide à crontab](http://www.adminschoice.com/crontab-quick-reference/) qui peut vous aider.
+Le script qui permet de mettre à jour les articles s’appelle
+*actualize_script.php* et se trouve dans le répertoire *app* de votre
+instance de FreshRSS. La syntaxe des tâches planifiées ne sera pas expliqué
+ici, cependant voici [une introduction rapide à
+crontab](http://www.adminschoice.com/crontab-quick-reference/) qui peut vous
+aider.
 
-Ci-dessous vous trouverez un exemple permettant la mise à jour des articles toutes les heures.
+Ci-dessous vous trouverez un exemple permettant la mise à jour des articles
+toutes les heures.
 
 ```cron
 0 * * * * php /chemin/vers/FreshRSS/app/actualize_script.php > /tmp/FreshRSS.log 2>&1
 ```
 
+« Paramètres de configuration du script; Ils sont utilisables simultanément
+: »
 
-### Cron en-ligne
+- Parameter "force"
+https://freshrss.example.net/i/?c=feed&a=actualize&force=1 If *force* is set
+to 1 all feeds will be refreshed at once.
 
-Il se peut que vous n’ayez pas accès aux tâches planifiées du serveur hébergeant votre instance de FreshRSS. Il reste une possibilité pour mettre les flux à jour automatiquement.
+- Parameter "ajax" https://freshrss.example.net/i/?c=feed&a=actualize&ajax=1
+Only a status site is returned and not a complete website. Example: "OK"
 
-Pour cela vous devez paramétrer une tâche cron qui devra charger régulièrement une url spécifique : https://freshrss.example.net/i/?c=feed&a=actualize (à adapter selon votre installation). Différents cas de figure peuvent se présenter à vous désormais.
+- Parameter "maxFeeds"
+https://freshrss.example.net/i/?c=feed&a=actualize&maxFeeds=30 If *maxFeeds*
+is set the configured amount of feeds is refreshed at once. The default
+setting is "10".
 
-##### Aucune authentification
+- Parameter "token"
+https://freshrss.example.net/i/?c=feed&a=actualize&token=542345872345734
+Security parameter to prevent unauthorized refreshes. For detailed
+Documentation see "Form authentication".
 
-C’est le cas le plus simple, puisque votre instance est publique, vous n’avez rien de particulier à préciser :
+### Online cron
 
-```cron
-0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize'
-```
+If you do not have access to the installation server scheduled task, you can
+still automate the update process.
+
+To do so, you need to create a scheduled task, which need to call a specific
+URL: https://freshrss.example.net/i/?c=feed&a=actualize (it could be
+different depending on your installation). Depending on your application
+authentication method, you need to adapt the scheduled task.
+
+#### Aucune authentification
 
-Vous pouvez également choisir un utilisateur différent en ajoutant son nom d'utilisateur à la chaîne de requête, avec `&user=nom-dutilisateur` :
+C’est le cas le plus simple, puisque votre instance est publique, vous
+n’avez rien de particulier à préciser :
 
 ```cron
-0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&user=someone&token=my-token'
+0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize'
 ```
 
-##### Authentification par formulaire
+### Authentification par formulaire
 
-Dans ces cas-là, si vous avez autorisé la lecture anonyme des articles, vous pouvez aussi permettre à n’importe qui de rafraîchir vos flux (« Autoriser le rafraîchissement anonyme des flux »).
+Dans ces cas-là, si vous avez autorisé la lecture anonyme des articles, vous
+pouvez aussi permettre à n’importe qui de rafraîchir vos flux (« Autoriser
+le rafraîchissement anonyme des flux »).
 
 ![Configuration de l’accès anonymes](../img/users/anonymous_access.1.png)
 
-L’url précédente devient donc accessible à n’importe qui et vous pouvez utiliser la tâche cron de la partie précédente.
+L’url précédente devient donc accessible à n’importe qui et vous pouvez
+utiliser la tâche cron de la partie précédente.
 
-Vous pouvez aussi configurer un jeton d’authentification pour accorder un droit spécial sur votre serveur.
+Vous pouvez aussi configurer un jeton d’authentification pour accorder un
+droit spécial sur votre serveur.
 
 ![Configuration du token](../img/users/token.1.png)
 
@@ -69,47 +101,70 @@ La tâche cron à utiliser sera de la forme suivante :
 0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&token=mon-token'
 ```
 
+You can also target a different user by adding their username to the query
+string, with `&user=insert-username`:
+
+```cron
+0 * * * * curl 'https://freshrss.exemple.net/i/?c=feed&a=actualize&user=quelquun&token=mon-token'
+```
 
-##### Authentification HTTP
+### Authentification HTTP
 
-Dans ce cas-là, le token et les permissions “anonymes” sont inutilisables et il vous sera nécessaire d’indiquer vos identifiants dans la tâche cron. **Notez que cette solution est grandement déconseillée puisqu’elle implique que vos identifiants seront visibles en clair !**
+Dans ce cas-là, le token et les permissions “anonymes” sont inutilisables et
+il vous sera nécessaire d’indiquer vos identifiants dans la tâche
+cron. **Notez que cette solution est grandement déconseillée puisqu’elle
+implique que vos identifiants seront visibles en clair !**
 
 ```cron
-0 * * * * curl -u alice:password123 'https://freshrss.example.net/i/?c=feed&a=actualize'
+0 * * * * curl -u alice:motdepasse123 'https://freshrss.exemple.net/i/?c=feed&a=actualize'
 ```
 
 ## Mise à jour manuelle
 
-Si vous ne pouvez pas ou ne voulez pas utiliser la méthode automatique, vous pouvez le faire de façon manuelle. Il existe deux méthodes qui permettent de mettre à jour tout ou partie des flux.
+Si vous ne pouvez pas ou ne voulez pas utiliser la méthode automatique, vous
+pouvez le faire de façon manuelle. Il existe deux méthodes qui permettent de
+mettre à jour tout ou partie des flux.
 
 ### Mise à jour complète
 
-Cette mise à jour se fait pour l’ensemble des flux de l’instance. Pour initier cette mise à jour, il suffit de cliquer sur le lien de mise à jour disponible dans le menu de navigation.
+Cette mise à jour se fait pour l’ensemble des flux de l’instance. Pour
+initier cette mise à jour, il suffit de cliquer sur le lien de mise à jour
+disponible dans le menu de navigation.
 
 ![Menu de navigation](../img/users/refresh.1.png)
 
-Lorsque la mise à jour démarre, une barre de progression apparait et s’actualise au fur et à mesure de la récupération des articles.
+Lorsque la mise à jour démarre, une barre de progression apparait et
+s’actualise au fur et à mesure de la récupération des articles.
 
 ![Barre de progression](../img/users/refresh.5.png)
 
 ### Mise à jour partielle
 
-Cette mise à jour se fait pour le flux sélectionné uniquement. Pour initier cette mise à jour, il suffit de cliquer sur le lien de mise à jour disponible dans le menu du flux.
+Cette mise à jour se fait pour le flux sélectionné uniquement. Pour initier
+cette mise à jour, il suffit de cliquer sur le lien de mise à jour
+disponible dans le menu du flux.
 
 ![Menu du flux](../img/users/refresh.2.png)
 
 # Filtrer les articles
 
-Avec le nombre croissant d’articles stockés par FreshRSS, il devient important d’avoir des filtres efficaces pour n’afficher qu’une partie des articles. Il existe plusieurs méthodes qui filtrent selon des critères différents. Ces méthodes peuvent être combinées dans la plus part des cas.
+Avec le nombre croissant d’articles stockés par FreshRSS, il devient
+important d’avoir des filtres efficaces pour n’afficher qu’une partie des
+articles. Il existe plusieurs méthodes qui filtrent selon des critères
+différents. Ces méthodes peuvent être combinées dans la plus part des cas.
 
-##Par catégorie
+## Par catégorie
 
-C’est la méthode la plus simple. Il suffit de cliquer sur le titre d’une catégorie dans le panneau latéral. Il existe deux catégories spéciales qui sont placées en haut dudit panneau :
+C’est la méthode la plus simple. Il suffit de cliquer sur le titre d’une
+catégorie dans le panneau latéral. Il existe deux catégories spéciales qui
+sont placées en haut dudit panneau :
 
-  * *Flux principal* qui affiche uniquement les articles des flux marqués comme visible dans cette catégorie
-  * *Favoris* qui affiche uniquement les articles, tous flux confondus, marqués comme favoris
+  * *Flux principal* qui affiche uniquement les articles des flux marqués
+    comme visible dans cette catégorie
+  * *Favoris* qui affiche uniquement les articles, tous flux confondus,
+    marqués comme favoris
 
-##Par flux
+## Par flux
 
 Il existe plusieurs méthodes pour filtrer les articles par flux :
 
@@ -120,73 +175,88 @@ Il existe plusieurs méthodes pour filtrer les articles par flux :
 
 ![Filtrer par flux](../img/users/feed.filter.1.png)
 
-##Par statut
+## Par statut
 
-Chaque article possède deux attributs qui peuvent être combinés. Le premier attribut indique si l’article a été lu ou non. Le second attribut indique si l’article a été noté comme favori ou non.
+Chaque article possède deux attributs qui peuvent être combinés. Le premier
+attribut indique si l’article a été lu ou non. Le second attribut indique si
+l’article a été noté comme favori ou non.
 
-Dans la version 0.7.x, les filtres sur les attributs sont accessibles depuis la liste déroulante qui gère l’affichage des articles. Dans cette version, il n’est pas possible de combiner les filtres. Par exemple, on ne peut pas afficher les articles lus qui ont été notés comme favori.
+Dans la version 0.7.x, les filtres sur les attributs sont accessibles depuis
+la liste déroulante qui gère l’affichage des articles. Dans cette version,
+il n’est pas possible de combiner les filtres. Par exemple, on ne peut pas
+afficher les articles lus qui ont été notés comme favori.
 
 ![Filtrer par attribut en version 0.7](../img/users/status.filter.0.7.png)
 
-À partir de la version 0.8, les filtres sur les attributs sont directement accessibles. Il est maintenant possible de les combiner. Comme il est possible de faire toutes les combinaisons, il y en a certaines qui retournent le même résultat. Par exemple, si les quatre filtres sont activés ou désactivés, le résultat sera le même.
+Starting with version 0.8, all attribute filters are visible as toggle
+icons. They can be combined. As any combination is possible, some have the
+same result. For instance, the result for all filters selected is the same
+as no filter selected.
 
-![Filtrer par attribut en version 0.8](../img/users/status.filter.0.8.png)
+![Attribute filters in 0.8](../img/users/status.filter.0.8.png)
 
-Par défaut, le filtre n’affiche que les articles qui n’ont pas été lus.
+By default, this filter displays only unread articles
 
-##Par contenu
+## By content
 
-Il est possible de filtrer les articles par leur contenu en entrant une chaine de caractères dans le champ de recherche prévu à cet effet.
+It is possible to filter articles by their content by inputting a string in
+the search field.
 
-##Grâce au champ de recherche
+## Grâce au champ de recherche
 
-Il est possible d’utiliser le champ de recherche pour raffiner les résultats :
+Il est possible d’utiliser le champ de recherche pour raffiner les résultats
+:
 
 * par auteur : `author:nom` or `author:'nom composé'`
 * par titre : `intitle:mot` or `intitle:'mot composé'`
 * par URL: `inurl:mot` or `inurl:'mot composé'`
 * par tag: `#tag`
 * par texte libre : `mot` or `'mot composé'`
-* par date de découverte, en utilisant le [format d’intervalle de dates ISO 8601](https://fr.wikipedia.org/wiki/ISO_8601#Les_dur.C3.A9es_et_intervalles) : `date:<intervalle>`
-	* D’un jour, mois, ou année :
+* by date of discovery, using the [ISO 8601 time interval format](http://en.wikipedia.org/wiki/ISO_8601#Time_intervals): `date:<date-interval>`
+	* From a specific day, or month, or year:
 		* `date:2014-03-30`
 		* `date:2014-03` or `date:201403`
 		* `date:2014`
-	* D’une heure précise d’un jour donné :
+	* From a specific time of a given day:
 		* `date:2014-05-30T13`
 		* `date:2014-05-30T13:30`
-	* Entre deux dates :
+	* Between two given dates:
 		* `date:2014-02/2014-04`
 		* `date:2014-02--2014-04`
 		* `date:2014-02/04`
 		* `date:2014-02-03/05`
 		* `date:2014-02-03T22:00/22:15`
 		* `date:2014-02-03T22:00/15`
-	* Après une date donnée :
+	* After a given date:
 		* `date:2014-03/`
-	* Avant une date donnée :
+	* Before a given date:
 		* `date:/2014-03`
-	* Pour une certaine durée après une date donnée :
+	* For a specific duration after a given date:
 		* `date:2014-03/P1W`
-	* Pour une certaine durée avant une date donnée :
+	* For a specific duration before a given date:
 		* `date:P1W/2014-05-25T23:59:59`
-	* Pour une certaine durée avant l’instant présent (la barre oblique est optionnelle) :
-		* `date:P1Y/` ou `date:P1Y` (depuis un an)
-		* `date:P2M/` (depuis deux mois)
-		* `date:P3W/` (depuis trois semaines)
-		* `date:P4D/` (depuis quatre jours)
-		* `date:PT5H/` (depuis cinq heures)
-		* `date:PT30M/` (depuis trente minutes)
-		* `date:PT90S/` (depuis 90 seconds)
-		* `date:P1DT1H/` (depuis un jour et une heure)
-* par date de publication, en utilisant le même format : `pubdate:<intervalle>`
-
-Attention à ne pas introduire d’espace entre l’opérateur et la valeur recherchée.
-
-Certains opérateurs peuvent être utilisé négativement, pour exclure des articles, avec la même syntaxe que ci-dessus, mais préfixé par `!` ou `-` :
-`-author:nom`, `-intitle:mot`, `-inurl:mot`, `-#tag`, `!mot`.
-
-Il est également possible de combiner les mots-clefs pour faire un filtrage encore plus précis, et il est autorisé d’avoir plusieurs instances de : `author:`, `intitle:`, `inurl:`, `#`, et texte libre.
-
-Combiner plusieurs critères implique un *et* logique, mais le mot clef ` OR ` peut être utiliser pour combiner plusieurs critères avec un *ou* logique :
-`author:Dupont OR author:Dupond`
+	* For the past duration before now (the trailing slash is optional):
+		* `date:P1Y/` or `date:P1Y` (past year)
+		* `date:P2M/` (past two months)
+		* `date:P3W/` (past three weeks)
+		* `date:P4D/` (past four days)
+		* `date:PT5H/` (past five hours)
+		* `date:PT30M/` (past thirty minutes)
+		* `date:PT90S/` (past ninety seconds)
+		* `date:P1DT1H/` (past one day and one hour)
+* by date of publication, using the same format: `pubdate:<date-interval>`
+
+Attention à ne pas introduire d’espace entre l’opérateur et la valeur
+recherchée.
+
+Certains opérateurs peuvent être utilisé négativement, pour exclure des
+articles, avec la même syntaxe que ci-dessus, mais préfixé par `!` ou `-`
+:`-author:nom`, `-intitle:mot`, `-inurl:mot`, `-#tag`, `!mot`.
+
+Il est également possible de combiner les mots-clefs pour faire un filtrage
+encore plus précis, et il est autorisé d’avoir plusieurs instances de :
+`author:`, `intitle:`, `inurl:`, `#`, et texte libre.
+
+Combiner plusieurs critères implique un *et* logique, mais le mot clef ` OR
+` peut être utiliser pour combiner plusieurs critères avec un *ou* logique
+:`author:Dupont OR author:Dupond`

docs/fr/users/04_Subscriptions.md

@@ -1,19 +1,23 @@
 # Ajouter un flux
 
-**TODO**
+**À FAIRE**
 
 # Import et export
 
-**TODO**
+**À FAIRE**
 
-# Utiliser le « bookmarklet »
+# Utiliser le « bookmarklet »
 
-Les « bookmarklets » sont de petits scripts que vous pouvez exécuter pour effectuer des tâches utiles ou frivoles. FreshRSS offre un signet ( « bookmark » ) pour s'abonner aux fils de nouvelles.
+Les « bookmarklets » sont de petits scripts que vous pouvez exécuter pour
+effectuer des tâches diverses et variées. FreshRSS offre un signet (
+« bookmark » ) pour s'abonner aux fils de nouvelles.
 
  1. Ouvrez "Gestion des abonnements".
  2. Cliquez sur "Outils d'abonnement".
- 3. Glissez le bouton "S'abonner" dans la barre d'outils des signets ou cliquez droit et choisissez l'action "Lien vers les signets" de votre navigateur.
+ 3. Glissez le bouton "S'abonner" dans la barre d'outils des signets ou
+    cliquez droit et choisissez l'action "Lien vers les signets" de votre
+    navigateur.
 
 # Organisation des flux
 
-**TODO**
+**À FAIRE**

docs/fr/users/05_Configuration.md

@@ -1,14 +1,27 @@
+
 # Personnaliser la vue
 
-##Langue
-À l'heure actuelle, FreshRSS est disponible en 13 langues. Après validation de ce choix, l'interface sera affichée dans la langue choisie, même si certaines parties de l'interface peuvent ne pas encore avoir été traduites. Si vous voulez aider à la traduction, regardez comment vous pouvez [contribuer au projet](../contributing.md#contribute-to-internationalization-i18n).
+## Langue
+
+À l'heure actuelle, FreshRSS est disponible en 13 langues. Après validation
+de ce choix, l'interface sera affichée dans la langue choisie, même si
+certaines parties de l'interface peuvent ne pas encore avoir été
+traduites. Si vous voulez aider à la traduction, regardez comment vous
+pouvez [contribuer au
+projet](../contributing.md#contribute-to-internationalization-i18n).
 
-Il y a des parties de FreshRSS qui ne sont pas traduites et qui n'ont pas vocation à l'être. Pour le moment, les logs visibles dans l'application ainsi que celle générées par le script de mise à jour automatique en font partie.
+Il y a des parties de FreshRSS qui ne sont pas traduites et qui n'ont pas
+vocation à l'être. Pour le moment, les logs visibles dans l'application
+ainsi que celle générées par le script de mise à jour automatique en font
+partie.
 
-Les langues disponibles sont : cz, de, en, es, fr, he, it, kr, nl, oc, pt-br, ru, tr, zh-cn.
+Les langues disponibles sont : cz, de, en, es, fr, he, it, kr, nl, oc,
+pt-br, ru, tr, zh-cn.
 
-##Thème
-Les goûts et les couleurs, ça ne se discute pas. C'est pourquoi FreshRSS propose huit thèmes officiels :
+## Thème
+
+Les goûts et les couleurs, ça ne se discute pas. C'est pourquoi FreshRSS
+propose huit thèmes officiels :
 
  * *Blue Lagoon* par **Mister aiR**
  * *Dark* par **AD**
@@ -19,60 +32,148 @@ Les goûts et les couleurs, ça ne se discute pas. C'est pourquoi FreshRSS propo
  * *Screwdriver* par **Mister aiR**
  * *Swage* par **Patrick Crandol**
 
-Si aucun de ceux proposés ne convient, il est toujours possible de [créer son propre thème](../developers/04_Frontend/02_Design.md).
+Si aucun de ceux proposés ne convient, il est toujours possible de [créer
+son propre thème](../developers/04_Frontend/02_Design.md).
+
+Pour sélectionner un thème, il suffit de faire défiler les thèmes jusqu'à
+l'apparition du thème choisi. Après validation, le thème sera appliqué à
+l'interface.
 
-Pour sélectionner un thème, il suffit de faire défiler les thèmes jusqu'à l'apparition du thème choisi. Après validation, le thème sera appliqué à l'interface.
+## Largeur du contenu
 
-##Largeur du contenu
-Il y en a qui préfère des lignes de texte courtes, d'autres qui préfèrent maximiser l'espace disponible sur l'écran. Pour satisfaire le maximum de personne, il est possible de choisir la largeur du contenu affiché. Il y a quatre réglages disponibles :
+Il y en a qui préfère des lignes de texte courtes, d'autres qui préfèrent
+maximiser l'espace disponible sur l'écran. Pour satisfaire le maximum de
+personne, il est possible de choisir la largeur du contenu affiché. Il y a
+quatre réglages disponibles :
 
  * **Fine** qui affiche le contenu jusqu'à 550 pixels
  * **Moyenne** qui affiche le contenu jusqu'à 800 pixels
  * **Large** qui affiche le contenu jusqu'à 1000 pixels
  * **Pas de limite** qui affiche le contenu sur 100% de la place disponible
 
-##Icônes d'article
+## Icônes d'article
+
+Veuillez noter que cette section n'affecte que la vue normale.
+
+![Configuration des icônes
+d'article](../img/users/configuration.article.icons.png)
+
+Chaque article est rendu avec un en-tête (ligne supérieure) et un pied de
+page (ligne inférieure). Dans cette section, vous pouvez choisir ce qui sera
+affiché dans ceux-ci.
 
-**TODO**
+Si vous désactivez tous les éléments de la ligne supérieure, vous pourrez
+toujours les voir, puisqu'il contient le nom du flux et le titre de
+l'article. Mais si vous faites le même chose pour la ligne inférieure, elle
+sera vide.
 
-##Temps d'affichage de la notification HTML5
-Après la mise à jour automatique des flux, FreshRSS utilise l'API de notification de HTML5 pour avertir de l'arrivée de nouveaux articles.
+## Temps d'affichage de la notification HTML5
 
-Il est possible de régler la durée d'affichage de cette notification. Par défaut, la valeur est 0.
+Après la mise à jour automatique des flux, FreshRSS utilise l'API de
+notification de HTML5 pour avertir de l'arrivée de nouveaux articles.
 
-# Options de lecture
+Il est possible de régler la durée d'affichage de cette notification. Par
+défaut, la valeur est 0.
 
-**TODO**
+## Show the navigation button
+
+By default, FreshRSS displays buttons to ease the article navigation when
+browsing on mobile. The drawback is that they eat up some precious space.
+
+![navigation button
+configuration](../img/users/configuration.navigation.button.png)
+
+If you don't use those buttons because you never browse on mobile or because
+you browse with gestures, you can disable them from the interface.
+
+# Reading
+
+**À FAIRE**
 
 # Archivage
 
-**TODO**
+**À FAIRE**
 
 # Partage
 
-**TODO**
+Pour vous faciliter la vie, vous pouvez partager des articles directement
+via FreshRSS.
+
+At the moment, FreshRSS supports 18 sharing methods, ranging from
+self-hosted services (Shaarli, etc.) to proprietary services (Facebook,
+etc.).
+
+By default, the sharing list is empty.  ![Sharing
+configuration](../img/users/configuration.sharing.png)
+
+Pour ajouter un nouvel élément à la liste, veuillez suivre les étapes
+simples ci-dessous :
+
+ 1. Select the desired sharing method in the drop-down list.
+ 1. Press the ```✚``` button to add it to the list.
+ 1. Configure the method in the list. All names can be modified in the
+    display. Some methods need the sharing URL to be able to work properly
+    (ex: Shaarli).
+ 1. Submit your changes.
+
+To remove an item from the list, follow those simple steps:
+
+ 1. Press the ```❌``` button next to the share method you want to remove.
+ 1. Submit your changes.
 
 # Raccourcis
 
-**TODO**
+To ease the use of the application, FreshRSS comes with a lot of predefined
+keyboard shortcuts.  They allow actions to improve the user experience with
+a keyboard.
+
+Of course, if you're not satisfied with the key mapping, you can change you
+configuration to fit your needs.
 
-# Filtres
+There are 4 types of shortcuts:
 
-**TODO**
+ 1. Views: they allow switching views with ease.
+ 1. Navigation: they allow navigation through articles, feeds, and
+    categories.
+ 1. Article actions: they allow interactions with an article, like sharing
+    or opening it on the original web-site.
+ 1. Other actions: they allow other interactions with the application, like
+    opening the user queries menu or accessing the documentation.
 
-# Utilisateurs
+It's worth noting that the share article action has two levels. Once you
+press the shortcut, a menu containing all the share options opens.  To
+choose one share option, you need to select it by its number. When there is
+only one option, it's selected automatically though.
 
-**TODO**
+The same process applies to the user queries.
 
-## Méthodes d'authentification
+Be aware that there is no validation on the selected shortcuts.  This means
+that if you assign a shortcut to more than one action, you'll end up with
+some unexpected behavior.
 
-**Brouillon**
+# User queries
 
-### Authentification HTTP
+You can configure your [user queries](./03_Main_view.md) in that
+section. There is not much to say here as it is pretty straightforward.  You
+can only change user query titles or drop them.
 
- 1.  Ne laisse rien de visible
- 2.  Pour Apache, basé sur un fichier .htaccess
-    - Exemple de .htaccess pour un utilisateur "marie" à placer dans le répertoire de FreshRSS ou dans un répertoire parent :
+At the moment, there is no helper to build a user query from here.
+
+# Users
+
+**À FAIRE**
+
+## Authentication methods
+
+### HTTP Authentication (Apache)
+
+ 1. User control is based on the `.htaccess` file.
+ 2. It is best practice to place the `.htaccess` file in the `./i/`
+    subdirectory so the API and other third party services can work.
+ 3. If you want to limit all access to registered users only, place the file
+    in the FreshRSS directory itself or in a parent directory. Note that
+    WebSub and API will not work!
+ 4. Example `.htaccess` file for a user "marie":
 
 ```
 AuthUserFile /home/marie/repertoire/.htpasswd
@@ -82,40 +183,55 @@ AuthType Basic
 Require user marie
 ```
 
-Plus d'informations dans [la documentation d'Apache.](http://httpd.apache.org/docs/trunk/howto/auth.html#gettingitworking)
-
+Plus d'informations dans [la documentation
+d'Apache.](http://httpd.apache.org/docs/trunk/howto/auth.html#gettingitworking)
 
 # Gestion des flux
 
 ## Informations
 
-**TODO**
+**À FAIRE**
 
 ## Archivage
 
-**TODO**
+**À FAIRE**
 
 ## Identification
 
-**TODO**
+**À FAIRE**
 
 ## Avancé
 
 ### Récupérer un flux tronqué à partir de FreshRSS
 
-La question revient régulièrement, je vais essayer de clarifier ici comment on peut récupérer un flux RSS tronqué avec FreshRSS. Sachez avant tout que la manière de s'y prendre n'est absolument pas "user friendly", mais elle fonctionne :)
+La question revient régulièrement, je vais essayer de clarifier ici comment
+on peut récupérer un flux RSS tronqué avec FreshRSS. Sachez avant tout que
+la manière de s'y prendre n'est absolument pas "user friendly", mais elle
+fonctionne. :)
 
-Sachez aussi que par cette manière vous générez beaucoup plus de trafic vers les sites d'origines et qu'ils peuvent vous bloquer par conséquent. Les performances de FreshRSS sont aussi moins bonnes car vous devez alors aller chercher le contenu des articles un par un. C'est donc une fonctionnalité à utiliser avec parcimonie !
+Sachez aussi que par cette manière vous générez beaucoup plus de trafic vers
+les sites d'origines et qu'ils peuvent vous bloquer par conséquent. Les
+performances de FreshRSS sont aussi moins bonnes car vous devez alors aller
+chercher le contenu des articles un par un. C'est donc une fonctionnalité à
+utiliser avec parcimonie !
 
-Ce que j'entends par "Chemin CSS des articles sur le site d’origine" correspond en fait au "chemin" constitué par les IDs et les classes (en html, correspond aux attributs id et class) pour récupérer uniquement la partie intéressante qui correspond à l'article. L'idéal est que ce chemin commence par un id (qui est unique pour la page)
+Ce que j'entends par "Chemin CSS des articles sur le site d’origine"
+correspond en fait au "chemin" constitué par les IDs et les classes (en
+html, correspond aux attributs id et class) pour récupérer uniquement la
+partie intéressante qui correspond à l'article. L'idéal est que ce chemin
+commence par un id (qui est unique pour la page).
 
-#### Exemple 1 : Rue89
+#### Exemple : Rue89
 
-Pour trouver ce chemin, il faut se rendre à l'adresse d'un des articles tronqués (par exemple http://www.rue89.com/2013/10/15/prof-maths-jai-atteint-lextase-dihn-pedagogie-inversee-246635). Il faut alors chercher le "bloc" HTML correspondant au contenu de l'article (dans le code source !)
+Pour trouver ce chemin, il faut se rendre à l'adresse d'un des articles
+tronqués (par exemple
+http://www.rue89.com/2013/10/15/prof-maths-jai-atteint-lextase-dihn-pedagogie-inversee-246635).
+Il faut alors chercher le "bloc" HTML correspondant au contenu de l'article
+(dans le code source !)
 
-On trouve ici que le bloc qui englobe uniquement le contenu de l'article est ```<div class="content clearfix">```. On ne va garder que la classe .content ici. Néanmoins, comme je le disais plus haut, il est préférable de commencer le chemin avec un id. Si on remonte au bloc parent, il s'agit du bloc ```<div id="article">``` et c'est parfait ! Le chemin sera donc ```#article .content```
+On trouve ici que le bloc qui englobe uniquement le contenu de l'article est ```<div class="content clearfix">```. On ne va garder que la classe `.content` ici. Néanmoins, comme je le disais plus haut, il est préférable de commencer le chemin avec un id. Si on remonte au bloc parent, il s'agit du bloc ```<div id="article">``` et c'est parfait ! Le chemin sera donc ```#article .content```.
 
-#### Liste de correspondances site -> chemin css
+#### Liste de correspondances site → chemin css
 
 *  Rue89 : ```#article .content```
 *  PCINpact : ```#actu_content```
@@ -124,7 +240,8 @@ On trouve ici que le bloc qui englobe uniquement le contenu de l'article est ```
 
 ### Récupérer un flux tronqué à l'aide d'outils externes
 
-Des outils complémentaires peuvent être utilisés pour récupérer le contenu complet d'un article, comme :
+Des outils complémentaires peuvent être utilisés pour récupérer le contenu
+complet d'un article, comme :
 
 * [RSS-Bridge](https://github.com/RSS-Bridge/rss-bridge)
 * [Full-Text RSS](https://bitbucket.org/fivefilters/full-text-rss)

docs/fr/users/06_Fever_API.md

@@ -1,23 +1,139 @@
 # FreshRSS - API compatible Fever
 
-Voir la page [sur notre API compatible Google Reader](06_Mobile_access.md) pour une autre possibilité
-et des généralités sur l’accès par API.
+Voir la page [sur notre API compatible Google Reader](06_Mobile_access.md)
+pour une autre possibilité et des généralités sur l’accès par API.
 
-## Compatibilité
+## Clients compatibles
 
-Testé avec:
+De nombreux clients RSS prennent en charge l'API Fever, mais ils semblent
+comprendre l'API Fever un peu différemment. Si votre client préféré ne
+fonctionne pas correctement avec cette API, veuiller créer un ticket et nous
+y jetterons un oeil. Mais nous ne pouvons le faire que pour les clients
+gratuits.
 
-- Android
-  [Readably](https://play.google.com/store/apps/details?id=com.isaiasmatewos.readably) (Propriétaire)
+### Utilisation et authentification
 
-- iOS
-  - [Fiery Feeds](https://apps.apple.com/app/fiery-feeds-rss-reader/id1158763303) (Propriétaire)
-  - [Unread](https://apps.apple.com/app/unread-rss-reader/id1252376153) (Commercial)
-  - [Reeder](https://www.reederapp.com/) (Commercial) (Connectez-vous plutôt par son option Google Reader API)
+Avant de pouvoir commencer à utiliser cette API, vvous devez activer et
+configurer l'accès à l'API, qui est [documenté
+ici](https://freshrss.github.io/FreshRSS/en/users/06_Mobile_access.html), et
+réinitialisez ensuite le mot de passe API de l'utilisateur.
 
-- MacOS
-  - [Readkit](https://apps.apple.com/app/readkit/id588726889) (Commercial)
+Connectez ensuite votre application mobile en utilisant l'adresse de l'API
+(e.g. `https://freshrss.example.net/api/fever.php`).
 
-## TODO
+## Clients compatibles
 
-Voir [la page en anglais](../../en/users/06_Fever_API.md).
+Testé avec :
+
+* Android
+  * [Readably](https://play.google.com/store/apps/details?id=com.isaiasmatewos.readably) (Propriétaire)
+
+* iOS
+  * [Fiery Feeds](https://apps.apple.com/app/fiery-feeds-rss-reader/id1158763303) (Propriétaire)
+  * [Unread](https://apps.apple.com/app/unread-rss-reader/id1252376153) (Commercial)
+  * [Reeder](https://www.reederapp.com/) (Commercial) (Connectez-vous plutôt par son option Google Reader API)
+
+* MacOS
+  * [ReadKit](https://apps.apple.com/app/readkit/id588726889) (Commercial)
+
+
+## Fonctionnalités
+
+Les fonctionnalités suivantes sont implémentées :
+
+* récupération des catégories
+* récupération des flux
+* récupération des entrées (new, favorites, unread, by_id, by_feed,
+  by_category,since)
+* récupération des favicons
+* marquage des entrées comme lues
+* marquage des entrées comme favoris
+* marquage d'un flux comme lu
+* marquage d'une catégorie comme lue
+* support des extensions grace au hook `entry_before_display`
+
+Les fonctionnalités suivantes ne sont pas implémentées :
+
+* « Hot Links » car il n'y a encore rien dans FreshRSS qui soit similaire ou
+  qui puisse être utilisé pour le simuler.
+
+## Tester et déboguer
+
+Si l'API ne fonctionne pas comme attendu dans votre lecteur, il est possible
+de la tester manuellement avec un outil tel que
+[Postman](https://www.getpostman.com/).
+
+Envoyer une requête POST à l'adresse
+https://freshrss.example.net/api/fever.php?api devrait vous renvoyer le
+résultat suivant :
+```json
+{
+	"api_version": 3,
+	"auth": 0
+}
+```
+Super, la configuration de base fonctionne !
+
+Maintenant essayons de faire un appel authentifié. Fever utilise un
+paramètre `api_key` qui contient le résultat de la fonction de hachage MD5
+de la valeur `"$username:$apiPassword"`. En considérant que l'utilisateur
+est `kevin` et que son mot de passe est `freshrss`, voici la commande à
+lancer pour calculer la valeur du paramètre `api_key` :
+
+```sh
+api_key=`echo -n "kevin:freshrss" | md5sum | cut -d' ' -f1`
+```
+
+Ajoutez un contenu sous forme de `form-data`à votre requête POST ainsi que
+le paramètre `api_key` contenant la valeur calculée à l'étape précédente :
+
+```sh
+curl -s -F "api_key=$api_key" 'https://freshrss.exemple.net/api/fever.php?api'
+```
+
+Vous devriez obtenir le résultat suivant :
+```json
+{
+	"api_version": 3,
+	"auth": 1,
+	"last_refreshed_on_time": "1520013061"
+}
+```
+Parfait, maintenant vous êtes autentifié et vous pouvez commencer à tester
+les fonctions avancées. Pour cela, il suffit de changer l'adresse en lui
+ajoutant les paramètres nécessaires à la réalisation des actions
+supportées. Pour plus d'information, veuillez vous référer à la
+[documentation officielle de Fever](https://feedafever.com/api).
+
+Voici quelques exemples simples d'appels réalisables :
+
+* https://freshrss.example.net/api/fever.php?api&items
+* https://freshrss.example.net/api/fever.php?api&feeds
+* https://freshrss.example.net/api/fever.php?api&groups
+* https://freshrss.example.net/api/fever.php?api&unread_item_ids
+* https://freshrss.example.net/api/fever.php?api&saved_item_ids
+* https://freshrss.example.net/api/fever.php?api&items&since_id=some_id
+* https://freshrss.example.net/api/fever.php?api&items&max_id=some_id
+* https://freshrss.example.net/api/fever.php?api&mark=item&as=read&id=some_id
+* https://freshrss.example.net/api/fever.php?api&mark=item&as=unread&id=some_id
+
+Remplacez `some_id` par un identifiant réel de votre base de données
+`freshrss_username_entry`.
+
+### Déboguer
+
+Si rien ne fonctionne correctement et que votre client se comporte
+étrangement, vous pouvez ajouter les quelques lignes suivantes au début du
+fichier `fever.api` pour déterminer la cause des problèmes rencontrés :
+
+```php
+file_put_contents(__DIR__ . '/fever.log', $_SERVER['HTTP_USER_AGENT'] . ': ' . json_encode($_REQUEST) . PHP_EOL, FILE_APPEND);
+```
+
+Utilisez ensuite votre client RSS pour interroger l'API et vérifier le
+fichier `fever.log`.
+
+## Remerciements
+
+Ce plugin a été inspiré par le
+[tinytinyrss-fever-plugin](https://github.com/dasmurphy/tinytinyrss-fever-plugin).

docs/fr/users/06_Mobile_access.md

@@ -1,19 +1,24 @@
-Cette page suppose que vous avez fini [l’installation du serveur](01_Installation.md).
+Cette page suppose que vous ayez fini [l’installation du
+serveur](01_Installation.md).
 
 # Activer l’API dans FreshRSS
 
-1. Dans la section “Authentification”, cocher l’option “Autoriser l’accès par API (nécessaire pour les applis mobiles)”.
+1. Dans la section “Authentification”, cocher l’option “Autoriser l’accès
+   par API (nécessaire pour les applis mobiles)”.
 2. Dans la section “Profil”, remplir le champ “Mot de passe API (ex. : pour applis mobiles)”.
 	* Chaque utilisateur doit choisir son mot de passe API.
-	* La raison d’être d’un mot de passe API différent du mot de passe principal est que le mot de passe API est potentiellement utilisé de manière moins sûre, mais il permet aussi moins de choses.
+	* La raison d’être d’un mot de passe API
+ différent du mot de passe principal est que le mot de passe API est potentiellement utilisé de manière moins sûre, mais il permet aussi moins de choses.
 
-Le reste de cette page concerne l’API compatible Google Reader.
-Voir la [page sur l’API compatible Fever](06_Fever_API.md) pour une autre possibilité.
+Le reste de cette page concerne l’API compatible Google Reader. Voir la
+[page sur l’API compatible Fever](06_Fever_API.md) pour une autre
+possibilité.
 
 
 # Tester
 
-3. Dans la section “Profil”, cliquer sur le lien de la forme `https://rss.example.net/api/` à côté du champ “Mot de passe API”.
+3. Dans la section “Profil”, cliquer sur le lien de la forme
+   `https://rss.example.net/api/` à côté du champ “Mot de passe API”.
 4. Cliquer sur le premier lien “Check full server configuration”:
 	* Si vous obtenez `PASS`, tout est bon : passer à l’étape 6.
 	* Si vous obtenez *Bad Request!* ou *Not Found*, alors votre serveur ne semble pas accepter les slashs `/` qui sont encodés `%2F`. Passer à l’étape 5.
@@ -41,38 +46,25 @@ Voir la [page sur l’API compatible Fever](06_Fever_API.md) pour une autre poss
 	* Mettre à jour et retourner à l’étape 3.
 
 
-# Tests sur mobile
-
-6. Vous pouvez maintenant tester sur une application mobile (News+, FeedMe, ou EasyRSS sur Android)
-	* en utilisant comme adresse https://rss.example.net/api/greader.php ou http://example.net/FreshRSS/p/api/greader.php selon la configuration de votre site Web.
-	* ⚠️ attention aux majuscules et aux espaces en tapant l’adresse avec le clavier du mobile ⚠️
-	* avec votre nom d’utilisateur et le mot de passe enregistré au point 2 (mot de passe API).
-
-
-# En cas de problèmes
-
- * Vous pouvez voir les logs API dans `./FreshRSS/data/users/_/log_api.txt`
- * Si vous avez une erreur 404 (fichier non trouvé) lors de l’étape de test, et que vous êtes sous Apache,
- voir http://httpd.apache.org/docs/trunk/mod/core.html#allowencodedslashes pour utiliser News+
-(facultatif pour EasyRSS et FeedMe qui devraient fonctionner dès lors que vous obtenez un PASS au test *Check partial server configuration*).
-
-
 # Clients compatibles
 
-Tout client supportant une API de type Google Reader. Sélection :
-
-* Android
-	* [News+](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus) avec [News+ Google Reader extension](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus.extension.google_reader) (Propriétaire)
-	* [FeedMe 3.5.3+](https://play.google.com/store/apps/details?id=com.seazon.feedme) (Propriétaire)
-	* [EasyRSS](https://github.com/Alkarex/EasyRSS) (Libre, F-Droid)
-* Linux
-	* [FeedReader 2.0+](https://jangernert.github.io/FeedReader/) (Libre)
-* iOS
-	* [Reeder-4](https://apps.apple.com/app/reeder-4/id1449412357) (Commercial)
-* MacOS
-	* [Vienna RSS](http://www.vienna-rss.com/) (Libre)
-* Firefox
-	* [FreshRSS-Notify](https://addons.mozilla.org/fr/firefox/addon/freshrss-notify-webextension/) (Libre)
+6. Sur la même page de l'API FreshRSS, notez l'adresse donnée sous "Votre adresse API", comme `https://freshrss.example.net/api/greader.php`
+	* Saisissez l'adresse de l'API dans le client sélectionné puis votre nom d'utilisateur et votre mot de passe spécialement créé pour l'API.
+
+7. Vous pouvez maintenant tester sur une application mobile:
+	* Android
+		* [News+](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus) avec [News+ Google Reader extension](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus.extension.google_reader) (Closed source)
+		* [FeedMe 3.5.3+](https://play.google.com/store/apps/details?id=com.seazon.feedme) (Propriétaire)
+		* [EasyRSS](https://github.com/Alkarex/EasyRSS) (Libre, [F-Droid](https://f-droid.org/packages/org.freshrss.easyrss/))
+	* Linux
+		* [FeedReader 2.0+](https://jangernert.github.io/FeedReader/) (Libre)
+	* MacOS
+		* [Vienna RSS](http://www.vienna-rss.com/) (Libre)
+		* [Reeder](https://www.reederapp.com/) (Commercial)
+	* iOS
+		* [Reeder](https://www.reederapp.com/) (Commercial)
+	* Firefox
+		* [FreshRSS-Notify](https://addons.mozilla.org/firefox/addon/freshrss-notify-webextension/) (Libre)
 
 
 # API compatible Google Reader

docs/fr/users/07_Frequently_Asked_Questions.md

@@ -1,54 +1,114 @@
-Il est possible que nous n'ayons pas répondu à toutes vos questions dans les parties précédentes. La FAQ regroupe certaines interrogations qui n'ont pas trouvé leur réponse ailleurs.
-
-## C'est quoi ce /i à la fin de l'URL ?
-
-Bien entendu, le ```/i``` n'est pas là pour faire joli ! Il s'agit d'une question de performances et de praticité :
-
-* Cela permet de servir les icônes, images, styles, scripts sans cookie. Sans cela, ces fichiers seraient souvent re-téléchargés, en particulier lorsque le formulaire de connexion est utilisé. De plus, les requêtes vers ces ressources seraient plus lourdes.
-* La racine publique ```./p/``` peut être servie sans restriction d'accès HTTP (qui peut avantageusement être mise en place dans ```./p/i/```).
-* Cela permet d'éviter des problèmes pour des fichiers qui doivent être publics pour bien fonctionner, comme ```favicon.ico```, ```robots.txt```, etc.
-* Cela permet aussi d'avoir un logo FreshRSS plutôt qu'une page blanche pour accueillir l'utilisateur par exemple dans le cas de la restriction d'accès HTTP ou lors de l'attente du chargement plus lourd du reste de l'interface.
+Il est possible que nous n'ayons pas répondu à toutes vos questions dans les
+parties précédentes. La FAQ regroupe certaines interrogations qui n'ont pas
+trouvé leur réponse ailleurs.
+
+## C'est quoi ce `/i` à la fin de l'URL ?
+
+Bien entendu, le ```/i``` n'est pas là pour faire joli ! Il s'agit d'une
+question de performances et de praticité :
+
+* Cela permet de servir les icônes, images, styles, scripts sans
+  cookie. Sans cela, ces fichiers seraient souvent re-téléchargés, en
+  particulier lorsque le formulaire de connexion est utilisé. De plus, les
+  requêtes vers ces ressources seraient plus lourdes.
+* La racine publique ```./p/``` peut être servie sans restriction d'accès
+  HTTP (qui peut avantageusement être mise en place dans ```./p/i/```).
+* Cela permet d'éviter des problèmes pour des fichiers qui doivent être
+  publics pour bien fonctionner, comme ```favicon.ico```, ```robots.txt```,
+  etc.
+* Cela permet aussi d'avoir un logo FreshRSS plutôt qu'une page blanche pour
+  accueillir l'utilisateur par exemple dans le cas de la restriction d'accès
+  HTTP ou lors de l'attente du chargement plus lourd du reste de
+  l'interface.
 
 ## Pourquoi le ```robots.txt``` se trouve dans un sous-répertoire ?
 
-Afin d'améliorer la sécurité, FreshRSS est découpé en deux parties : une partie publique (le répertoire ```./p```) et une partie privée (tout le reste !). Le ```robots.txt``` se trouve donc dans le sous-répertoire ```./p```.
+Afin d'améliorer la sécurité, FreshRSS est découpé en deux parties : une
+partie publique (le répertoire ```./p```) et une partie privée (tout le
+reste !). Le ```robots.txt``` se trouve donc dans le sous-répertoire
+```./p```.
 
-Comme expliqué dans les [conseils de sécurité](01_Installation.md#conseils-de-securite), il est recommandé de faire pointer un nom de domaine vers ce sous-répertoire afin que seule la partie publique ne soit accessible par un navigateur web. De cette manière http://demo.freshrss.org/ pointe vers le répertoire ```./p``` et le ```robots.txt``` se trouve bien à la racine du site : http://demo.freshrss.org/robots.txt.
+Comme expliqué dans les [conseils de
+sécurité](01_Installation.md#conseils-de-securite), il est recommandé de
+faire pointer un nom de domaine vers ce sous-répertoire afin que seule la
+partie publique ne soit accessible par un navigateur web. De cette manière
+https://demo.freshrss.org/ pointe vers le répertoire ```./p``` et le
+```robots.txt``` se trouve bien à la racine du site :
+https://demo.freshrss.org/robots.txt.
 
-L'explication est la même pour les fichiers ```favicon.ico``` et ```.htaccess```.
+L'explication est la même pour les fichiers ```favicon.ico``` et
+```.htaccess```.
 
 ## Pourquoi j'ai des erreurs quand j'essaye d'enregistrer un flux ?
 
-Il peut y avoir différentes origines à ce problème.
-Le flux peut avoir une syntaxe invalide, il peut ne pas être reconnu par la bibliothèque SimplePie, l'hébergement peut avoir des problèmes, FreshRSS peut être boggué.
-Il faut dans un premier temps déterminer la cause du problème.
-Voici la liste des étapes à suivre pour la déterminer :
-
-1. __Vérifier la validité du flux__ grâce à l'[outil en ligne du W3C](https://validator.w3.org/feed/ "Validateur en ligne de flux RSS et Atom"). Si ça ne fonctionne pas, nous ne pouvons rien faire.
-1. __Vérifier la reconnaissance par SimplePie__ grâce à l'[outil en ligne de SimplePie](http://simplepie.org/demo/ "Démo officielle de SimplePie"). Si ça ne fonctionne pas, nous ne pouvons rien faire.
-1. __Vérifier l'intégration dans FreshRSS__ grâce à la [démo](http://demo.freshrss.org "Démo officielle de FreshRSS"). Si ça ne fonctionne pas, il faut [créer un ticket sur Github](https://github.com/FreshRSS/FreshRSS/issues/new "Créer un ticket pour FreshRSS") pour que l'on puisse regarder ce qui se passe. Si ça fonctionne, il y a probablement un problème avec l'hébergement.
-
-Voici une liste des flux qui ne fonctionnent pas :
-
-* http://foulab.org/fr/rss/Foulab_News : ne passe pas la validation W3C (novembre 2014)
-* http://eu.battle.net/hearthstone/fr/feed/news : ne passe pas la validation W3C (novembre 2014)
-* http://webseriesmag.blogs.liberation.fr/we/atom.xml : ne fonctionne pas chez l'utilisateur mais passe l'ensemble des validations ci-dessus (novembre 2014)
+Il peut y avoir différentes origines à ce problème. Le flux peut avoir une
+syntaxe invalide, il peut ne pas être reconnu par la bibliothèque SimplePie,
+l'hébergement peut avoir des problèmes, FreshRSS peut être boggué. Il faut
+dans un premier temps déterminer la cause du problème.Voici la liste des
+étapes à suivre pour la déterminer :
+
+1. __Vérifier la validité du flux__ grâce à l'[outil en ligne du
+   W3C](https://validator.w3.org/feed/ "Validateur en ligne de flux RSS et
+   Atom"). Si ça ne fonctionne pas, nous ne pouvons rien faire.
+1. __Vérifier la reconnaissance par SimplePie__ grâce à l'[outil en ligne de
+   SimplePie](https://simplepie.org/demo/ "Démo officielle de
+   SimplePie"). Si ça ne fonctionne pas, nous ne pouvons rien faire.
+1. __Vérifier l'intégration dans FreshRSS__ grâce à la
+   [démo](https://demo.freshrss.org "Démo officielle de FreshRSS"). Si ça ne
+   fonctionne pas, il faut [créer un ticket sur
+   Github](https://github.com/FreshRSS/FreshRSS/issues/new "Créer un ticket
+   pour FreshRSS") pour que l'on puisse regarder ce qui se passe. Si ça
+   fonctionne, il y a probablement un problème avec l'hébergement.
 
 ## Comment changer un mot de passe oublié ?
 
-Depuis la version [1.10.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.10.0), l'administrateur peut modifier le mot de passe d'un utilisateur depuis l'interface. Cette interface est disponible dans le menu ```Administration → Gestion des utilisateurs```.
-Il suffit de sélectionner l'utilisateur, de saisir un mot de passe et de valider.
-
-Depuis la version [1.8.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.8.0), l'administrateur peut modifier le mot de passe d'un utilisateur depuis un terminal. Il est bon de noter que celui-ci doit avoir un accès à PHP en ligne de commande. Pour cela, il suffit d'ouvrir son terminal et de saisir la commande suivante :
+Depuis la version
+[1.10.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.10.0),
+l'administrateur peut modifier le mot de passe d'un utilisateur depuis
+l'interface. Cette interface est disponible dans le menu ```Administration →
+Gestion des utilisateurs```. Il suffit de sélectionner l'utilisateur, de
+saisir un mot de passe et de valider.
+
+Depuis la version
+[1.8.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.8.0),
+l'administrateur peut modifier le mot de passe d'un utilisateur depuis un
+terminal. Il est bon de noter que celui-ci doit avoir un accès à PHP en
+ligne de commande. Pour cela, il suffit d'ouvrir son terminal et de saisir
+la commande suivante :
 ```sh
 ./cli/update_user.php --user <username> --password <password>
+
 ```
-Pour plus d'information à ce sujet, il existe la [documentation dédiée](../../cli/README.md).
+Pour plus d'information à ce sujet, il existe la [documentation
+dédiée](../../cli/README.md).
 
 ## Gérer les permissions sous SELinux
 
-Certaines distributions Linux comme Fedora ou RedHat Enterprise Linux (RHEL) activent par défaut le système SELinux. Celui-ci permet de gérer des permissions au niveau des processus. Lors de l'installation de FreshRSS, l'étape 2 procède à la vérification des droits sur certains répertoires, il faut donc exécuter la commande suivante en tant que root:
+Certaines distributions Linux comme Fedora ou RedHat Enterprise Linux (RHEL)
+activent par défaut le système SELinux. Celui-ci permet de gérer des
+permissions au niveau des processus. Lors de l'installation de FreshRSS,
+l'étape 2 procède à la vérification des droits sur certains répertoires, il
+faut donc exécuter la commande suivante en tant que root:
 ```sh
 semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/FreshRSS/data(/.*)?'
 restorecon -Rv /usr/share/FreshRSS/data
 ```
+
+## Pourquoi y a-t-il une page blanche lorsque je configure les options de partage ?
+
+Le mot `sharing` dans l'URL est un mot déclencheur pour certaines règles des
+bloqueurs de publicités. À partir de la version 1.16, `sharing` a été
+remplacé par `integration` dans l'URL posant problème tout en conservant
+exactement la même dénomination à travers l'application.
+
+Si vous utilisez une version antérieure à 1.16, vous pouvez désactiver votre
+bloqueur de publicité pour FreshRSS ou vous pouvez ajouter une règle pour
+permettre la consultation de la page de configuration « partage ».
+
+Exemples avec _uBlock_ :
+
+- Ajoutez votre instance FreshRSS à la liste blanche de en l'ajoutant dans
+  _uBlock > Ouvrir le tableau de bord > Liste blanche_.
+- Autorisez votre instance FreshRSS à appeler la page de configuration
+  `sharing` en ajoutant la règle `*sharing,domain=~votredomaine.com` dans
+  _uBlock > Ouvrir le fichier tableau de bord > Mes filtres_

docs/i18n/freshrss.fr.po

@@ -0,0 +1,6252 @@
+# French translations for PACKAGE package
+# Copyright (C) 2019 Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+#
+# Automatically generated, 2019.
+# Frans de Jonge <fransdejonge@gmail.com>, 2019.
+msgid ""
+msgstr ""
+"Project-Id-Version: \n"
+"Report-Msgid-Bugs-To: https://github.com/FreshRSS/FreshRSS/issues\n"
+"POT-Creation-Date: 2019-11-15 10:34+0100\n"
+"PO-Revision-Date: 2019-11-15 10:34+0100\n"
+"Last-Translator: Frans de Jonge <fransdejonge@gmail.com>\n"
+"Language-Team: English <kde-i18n-doc@kde.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"X-Generator: Lokalize 2.0\n"
+
+#. type: Title ##
+#: en/./contributing.md:1
+#, no-wrap
+msgid "Join us on the mailing lists"
+msgstr "Rejoignez-nous sur les listes de mailing"
+
+#. type: Plain text
+#: en/./contributing.md:4
+msgid ""
+"Do you want to ask us some questions? Do you want to discuss with us? Don't "
+"hesitate to subscribe to our mailing lists!"
+msgstr ""
+"S'il vous manque des informations, n'hésitez pas à fouiller un peu la "
+"documentation ou venir nous poser directement vos questions sur [la mailing "
+"list des développeurs](https://freshrss.org/mailman/listinfo/dev)."
+
+#. type: Bullet: '* '
+#: en/./contributing.md:7
+msgid ""
+"The first mailing is destined to generic information, it should be adapted "
+"to users. [Join mailing@freshrss.org](https://freshrss.org/mailman/listinfo/"
+"mailing)."
+msgstr ""
+"Le premier mailing est destiné à l'information générique, il doit être "
+"adapté aux utilisateurs. [Rejoignez mailing@freshrss.org](https://freshrss."
+"org/mailman/listinfo/mailing)."
+
+#. type: Bullet: '* '
+#: en/./contributing.md:7
+msgid ""
+"The second mailing is mainly for developers. [Join dev@freshrss.org](https://"
+"freshrss.org/mailman/listinfo/dev)"
+msgstr ""
+"Le deuxième mailing s'adresse principalement aux développeurs. [Rejoignez "
+"dev@freshrss.org](https://freshrss.org/mailman/listinfo/dev)"
+
+#. type: Title ##
+#: en/./contributing.md:8
+#, no-wrap
+msgid "Report a bug"
+msgstr "Signaler un bug"
+
+#. type: Plain text
+#: en/./contributing.md:11
+msgid ""
+"Have you found a bug? Don't panic, here are some steps to report it with "
+"ease:"
+msgstr ""
+"Avez-vous trouvé un bogue ? Ne paniquez pas, voici quelques étapes pour le "
+"signaler facilement :"
+
+#. type: Bullet: '1. '
+#: en/./contributing.md:15
+msgid ""
+"Search for it on [the bug tracker](https://github.com/FreshRSS/FreshRSS/"
+"issues) (don't forget to use the search bar)."
+msgstr ""
+"Cherche sur [le bug tracker](https://github.com/FreshRSS/FreshRSS/issues) "
+"(n'oubliez pas d'utiliser la barre de recherche)."
+
+#. type: Bullet: '2. '
+#: en/./contributing.md:15
+msgid ""
+"If you find a similar bug, don't hesitate to post a comment to add more "
+"importance to the related ticket."
+msgstr ""
+"Si vous constatez un bogue similaire, n'hésitez pas à poster un commentaire "
+"pour ajouter de l'importance au ticket correspondant."
+
+#. type: Bullet: '3. '
+#: en/./contributing.md:15
+msgid ""
+"If you didn't find it, [open a new ticket](https://github.com/FreshRSS/"
+"FreshRSS/issues/new)."
+msgstr ""
+"Si vous ne l'avez pas trouvé, [ouvrez un nouveau ticket](https://github.com/"
+"FreshRSS/FreshRSS/issues/new)."
+
+#. type: Plain text
+#: en/./contributing.md:17
+msgid ""
+"If you have to create a new ticket, please try to keep in mind the following "
+"advice:"
+msgstr ""
+"Si vous devez créer un nouveau ticket, essayez de garder les conseils "
+"suivants :"
+
+#. type: Bullet: '* '
+#: en/./contributing.md:20
+msgid ""
+"Give an explicit title to the ticket so it will be easier to find it later."
+msgstr ""
+"Donnez un titre explicite au ticket pour le retrouver plus facilement plus "
+"tard."
+
+#. type: Bullet: '* '
+#: en/./contributing.md:20
+msgid ""
+"Be as exhaustive as possible in the description: what did you do? What is "
+"the bug? What are the steps to reproduce the bug?"
+msgstr ""
+"Soyez aussi exhaustif que possible dans la description : qu'avez-vous fait ? "
+"Quel est le bogue ? Quelles sont les étapes pour reproduire le bogue ?"
+
+#. type: Plain text
+#: en/./contributing.md:22
+msgid "We also need some information:"
+msgstr "Nous avons aussi besoin de quelques informations :"
+
+#. type: Bullet: '* '
+#: en/./contributing.md:27
+msgid ""
+"Your FreshRSS version (on the about page or in the `constants.php` file)"
+msgstr ""
+"Votre version de FreshRSS (sur la page A propos) ou le fichier `constants."
+"php`)"
+
+#. type: Bullet: '* '
+#: en/./contributing.md:27
+msgid "Your server configuration: the type of hosting and the PHP version"
+msgstr "Votre configuration de serveur : type d'hébergement, version PHP"
+
+#. type: Bullet: '* '
+#: en/./contributing.md:27
+msgid "Your storage system (SQLite, MySQL, MariaDB, PostgreSQL)"
+msgstr ""
+"Quelle base de données : SQLite, MySQL, MariaDB, PostgreSQL ? Quelle "
+"version ?"
+
+#. type: Bullet: '* '
+#: en/./contributing.md:27
+msgid ""
+"If possible, the related logs (PHP logs and FreshRSS logs under `data/users/"
+"your_user/log.txt`)"
+msgstr ""
+"Si possible, les logs associés (logs PHP et logs FreshRSS sous `data/users/"
+"your_user/log.txt`)"
+
+#. type: Title ##
+#: en/./contributing.md:28
+#, no-wrap
+msgid "Fix a bug"
+msgstr "Corriger un bogue"
+
+#. type: Plain text
+#: en/./contributing.md:31
+msgid ""
+"Would you like to fix a bug? For optimum coordination between collaborators, "
+"you should follow these indications:"
+msgstr ""
+"Voulez-vous corriger un bogue ? Pour maintenir une grande coordination entre "
+"les collaborateurs, vous devrez suivre ces indications :"
+
+#. type: Bullet: '1. '
+#: en/./contributing.md:36
+msgid ""
+"Be sure the bug is associated with a ticket and indicate that you'll work on "
+"it."
+msgstr ""
+"Assurez-vous que le bogue est associé à un ticket et indiquez que vous allez "
+"travailler sur le bogue."
+
+#. type: Bullet: '2. '
+#: en/./contributing.md:36
+msgid ""
+"[Fork the project repository](https://help.github.com/articles/fork-a-repo/)."
+msgstr ""
+"[Fork du répertoire de projet](https://help.github.com/articles/fork-a-"
+"repo/)."
+
+#. type: Bullet: '3. '
+#: en/./contributing.md:36
+msgid ""
+"[Create a new branch](https://help.github.com/articles/creating-and-deleting-"
+"branches-within-your-repository/). The name of the branch should be clear, "
+"and ideally prefixed by the related ticket id. For instance, `783-"
+"contributing-file` to fix [ticket #783](https://github.com/FreshRSS/FreshRSS/"
+"issues/783)."
+msgstr ""
+"[Créez une nouvelle branche](https://help.github.com/articles/creating-and-"
+"deleting-branches-within-your-repository/). Le nom de la branche doit être "
+"clair, et idéalement préfixé par l'identifiant du ticket correspondant. Par "
+"exemple, `783-contributing-file` pour réparer [ticket #783](https://github."
+"com/FreshRSS/FreshRSS/issues/783)."
+
+#. type: Bullet: '4. '
+#: en/./contributing.md:36
+msgid ""
+"Make your changes to your fork and [send a pull request](https://help.github."
+"com/articles/using-pull-requests/) on the **dev branch**."
+msgstr ""
+"Apportez vos modifications à votre fork et [envoyez une demande de pull]"
+"(https://help.github.com/articles/using-pull-requests/) sur la branche "
+"**dev**."
+
+#. type: Plain text
+#: en/./contributing.md:38
+msgid ""
+"If you have to write code, please follow [our coding style recommendations]"
+"(developers/01_First_steps.md)."
+msgstr ""
+"Si vous devez écrire du code, veuillez suivre [nos recommandations de style "
+"de codage](developers/01_First_steps.md)."
+
+#. type: Plain text
+#: en/./contributing.md:40
+#, no-wrap
+msgid "**Tip:** if you're searching for easy-to-fix bugs, please have a look at the \"[good first issue](https://github.com/FreshRSS/FreshRSS/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)\" ticket label.\n"
+msgstr "**Conseil : **si vous cherchez des bugs faciles à corriger, jetez un coup d'oeil à la vignette \"[good first issue](https://github.com/FreshRSS/FreshRSS/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)\".\n"
+
+#. type: Title ##
+#: en/./contributing.md:41
+#, no-wrap
+msgid "Submit an idea"
+msgstr "Soumettre une idée"
+
+#. type: Plain text
+#: en/./contributing.md:44
+msgid ""
+"You have great ideas, yes! Don't be shy and open [a new ticket](https://"
+"github.com/FreshRSS/FreshRSS/issues/new) on our bug tracker to ask if we can "
+"implement it. The greatest ideas often come from the shyest suggestions!"
+msgstr ""
+"Vous avez de bonnes idées, oui ! Ne soyez pas timide et ouvrez [un nouveau "
+"ticket](https://github.com/FreshRSS/FreshRSS/issues/new) sur notre tracker "
+"bogue pour nous demander si nous pouvons le mettre en œuvre. Les plus "
+"grandes idées viennent souvent des suggestions les plus timides !"
+
+#. type: Plain text
+#: en/./contributing.md:46
+msgid "If your idea is nice, we'll have a look at it."
+msgstr "Si votre idée est bonne, nous y jetterons un coup d'oeil."
+
+#. type: Title ##
+#: en/./contributing.md:47
+#, no-wrap
+msgid "Contribute to internationalization (i18n)"
+msgstr "Contribuer à l'internationalisation (i18n)"
+
+#. type: Plain text
+#: en/./contributing.md:50
+msgid ""
+"If you want to improve internationalization, please open a new ticket first "
+"and follow the advice from the *Fix a bug* section."
+msgstr ""
+"Si vous voulez améliorer l'internationalisation, ouvrez d'abord un nouveau "
+"ticket et suivez les conseils de la section *Fixer un bogue*."
+
+#. type: Plain text
+#: en/./contributing.md:52
+msgid "Translations are present in the subdirectories of `./app/i18n/`."
+msgstr ""
+"Les traductions sont disponibles dans les sous-répertoires de `./app/i18n/`."
+
+#. type: Plain text
+#: en/./contributing.md:54
+msgid ""
+"We're working on a better way to handle internationalization, but don't "
+"hesitate to suggest any ideas!"
+msgstr ""
+"Nous travaillons sur une meilleure façon de gérer l'internationalisation "
+"mais n'hésitez pas à nous suggérer des idées !"
+
+#. type: Title ##
+#: en/./contributing.md:55
+#, no-wrap
+msgid "Contribute to documentation"
+msgstr "Contribuer à la documentation"
+
+#. type: Plain text
+#: en/./contributing.md:58
+msgid ""
+"The documentation needs a lot of improvements in order to be more useful to "
+"new contributors and we are working on it.  If you want to give some help, "
+"meet us in the main repositories [docs directory](https://github.com/"
+"FreshRSS/FreshRSS/tree/master/docs)!"
+msgstr ""
+"Il ne vous aura pas échappé que la documentation est encore un peu vide… il "
+"y a énormément de choses à faire ! Si vous souhaitez aider à écrire quelques "
+"pages, rendez-vous dans les principaux dépôts[fichier docs](https://github."
+"com/FreshRSS/FreshRSS/tree/master/docs) !"
+
+#. type: Title #
+#: en/./developers/01_First_steps.md:1
+#, no-wrap
+msgid "Environment configuration (Docker)"
+msgstr "Configurer son environnement (Docker)"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:4
+msgid ""
+"FreshRSS is built with PHP and uses a homemade framework, Minz. The "
+"dependencies are directly included in the source code, so you don't need "
+"Composer."
+msgstr ""
+"FreshRSS est construit en PHP et utilise le framework Minz. Les "
+"dépendancessont directement incluses dans le code source, donc vous n'avez "
+"pas besoin d'utiliser Composer."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:6
+msgid ""
+"There are various ways to configure your development environment. The "
+"easiest and most supported method is based on Docker, which is the solution "
+"documented below. If you already have a working PHP environment, you "
+"probably don't need it."
+msgstr ""
+"Il existe plusieurs façons de configurer votre environnement "
+"dedéveloppement. La méthode la plus simple et la plus supportée est basée "
+"surDocker. C'est la solution qui est documentée ci-dessous. Si vous avez "
+"déjà unenvironnement PHP fonctionnel, vous n'en avez probablement pas besoin."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:8
+msgid ""
+"We assume here that you use a GNU/Linux distribution, capable of running "
+"Docker. Otherwise, you'll have to adapt the commands accordingly."
+msgstr ""
+"Nous supposons ici que vous utilisez une distribution GNU/Linux, capable "
+"d'exécuter Docker. Sinon, vous devrez adapter les commandes en conséquence."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:10
+msgid ""
+"The commands that follow have to be executed in a console. They start by `$` "
+"when commands need to be executed as normal user, and by `#` when they need "
+"to be executed as root user. You don't have to type these characters. A path "
+"may be indicated before these characters to help you identify where they "
+"need to be executed. For instance, `app$ echo 'Hello World'` indicates that "
+"you have to execute `echo` command in the `app/` directory."
+msgstr ""
+"Les commandes qui suivent doivent être exécutées dans une console. Ils "
+"commencent par `$` quand les commandes doivent être exécutées en tant "
+"qu'utilisateur normal, et par `#` quand elles doivent être exécutées en tant "
+"qu'utilisateur root. Vous n'avez pas besoin de taper ces caractères. Un "
+"chemin d'accès peut être indiqué devant ces caractères pour vous aider à "
+"identifier où ils doivent être exécutés. Par exemple, `app$ echo 'Hello "
+"World'` indique que vous devez exécuter la commande `echo` dans le "
+"répertoire `app/`."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:12
+msgid ""
+"First, you need to install [Docker](https://docs.docker.com/install/linux/"
+"docker-ce/ubuntu/)."
+msgstr ""
+"Tout d'abord, vous devez installer [Docker](https://docs.docker.com/install/"
+"linux/docker-ce/ubuntu/)."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:14
+msgid "Once you're done, clone the repository with:"
+msgstr ""
+"Une fois que c'est fait, clonez le dépôt de code de la manière suivante :"
+
+#. type: Code fence info string
+#: en/./developers/01_First_steps.md:15 en/./developers/01_First_steps.md:24
+#: en/./developers/01_First_steps.md:34 en/./developers/01_First_steps.md:42
+#: en/./developers/01_First_steps.md:50
+#, no-wrap
+msgid "console"
+msgstr "console"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:15
+#, no-wrap
+msgid ""
+"$ git clone https://github.com/FreshRSS/FreshRSS.git\n"
+"$ cd FreshRSS\n"
+msgstr ""
+"$ git clone https://github.com/FreshRSS/FreshRSS.git\n"
+"$ cd FreshRSS\n"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:21
+msgid ""
+"Note that, if you want to contribute, you have to fork the repository first "
+"and clone your fork instead of the \"root\" one. Adapt the commands in "
+"consequence."
+msgstr ""
+"Notez que, pour contribuer, vous devrez d'abord « forker » ce dépôt de code "
+"(ou dépôt de code référent) et cloner votre « fork » à la place de ce dépôt. "
+"Adaptez les commandes en conséquence."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:23
+msgid "Then, the only command you need to know is the following:"
+msgstr "Ensuite, la seule commande que vous devez connaître est la suivante :"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:24
+#, no-wrap
+msgid "$ make start\n"
+msgstr "$ make start\n"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:29
+msgid ""
+"This might take some time while Docker downloads the image. If your user "
+"isn't in the `docker` group, you'll need to prepend the command with `sudo`."
+msgstr ""
+"Cela peut prendre un certain temps pour que Docker télécharge l'image "
+"utilisée. Dans le cas où la commande échoue pour un problème de droit, il "
+"faudra soit ajouter votre utilisateur au groupe `docker`, soit relancer la "
+"commande en la préfixant par `sudo`."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:31
+#, no-wrap
+msgid "**You can now access FreshRSS at [http://localhost:8080](http://localhost:8080).** Just follow the install process and select the SQLite database.\n"
+msgstr "**Vous pouvez maintenant accéder à FreshRSS à [http://localhost:8080](http://localhost:8080).** Suivez simplement le processus d'installation et sélectionnez la base de données SQLite.\n"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:33
+#, no-wrap
+msgid "You can stop the containers by typing <kbd>Control</kbd> + <kbd>c</kbd> or with the following command, in another terminal:\n"
+msgstr "Vous pouvez arrêter les conteneurs en tapant <kbd>Control</kbd> + <kbd>c</kbd> ou avec la commande suivante, dans un autre terminal:\n"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:34
+#, no-wrap
+msgid "$ make stop\n"
+msgstr "$ make stop\n"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:39
+msgid ""
+"If you're interested in the configuration, the `make` commands are defined "
+"in the [`Makefile`](/Makefile)."
+msgstr ""
+"Si la configuration vous intéresse, les commandes `make' sont définies dans "
+"le fichier [`Makefile`](/Makefile)."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:41
+msgid ""
+"If you need to use a different tag image (default is `dev-alpine`), you can "
+"set the `TAG` environment variable:"
+msgstr ""
+"Si vous avez besoin d'utiliser une image Docker identifiée par un tag "
+"différent (par défaut `dev-alpine`), vous pouvez surcharger de la manière "
+"suivante la variable d'environnement `TAG` au moment de l'exécution de la "
+"commande :"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:42
+#, no-wrap
+msgid "$ TAG=dev-arm make start\n"
+msgstr "$ TAG=dev-arm make start\n"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:47
+msgid ""
+"You can find the full list of available tags [on the Docker hub](https://hub."
+"docker.com/r/freshrss/freshrss/tags)."
+msgstr ""
+"Vous pouvez trouver la liste complète des tags disponibles [sur le hub "
+"Docker](https://hub.docker.com/r/freshrss/freshrss/tags)."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:49
+msgid ""
+"If you want to build the Docker image yourself, you can use the following "
+"command:"
+msgstr ""
+"Si vous voulez construire l'image Docker, vous pouvez lancer la commande "
+"suivante :"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:50
+#, no-wrap
+msgid ""
+"$ make build\n"
+"$ # or\n"
+"$ TAG=dev-arm make build\n"
+msgstr ""
+"$ make build\n"
+"$ # ou\n"
+"$ TAG=dev-arm make build\n"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:57
+msgid ""
+"The `TAG` variable can be anything (e.g. `dev-local`). You can target a "
+"specific architecture by adding `-alpine` or `-arm` at the end of the tag (e."
+"g. `dev-local-arm`)."
+msgstr ""
+"La valeur de la variable `TAG` peut contenir n'importe quelle valeur (par "
+"exemple `dev-local`). Vous pouvez cibler une architecture spécifique en "
+"ajoutant `-alpine` ou `-arm` à la fin du tag (par exemple `dev-local-arm`)."
+
+#. type: Title #
+#: en/./developers/01_First_steps.md:58
+#, no-wrap
+msgid "Project architecture"
+msgstr "Architecture du projet"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:61 en/./developers/03_Backend/02_Minz.md:4
+#: en/./developers/03_Backend/02_Minz.md:8
+#: en/./developers/03_Backend/02_Minz.md:12
+#: en/./developers/03_Backend/02_Minz.md:16
+#: en/./developers/03_Backend/02_Minz.md:20
+#: en/./developers/03_Backend/02_Minz.md:24
+#: en/./developers/03_Backend/02_Minz.md:27
+#: en/./developers/03_Backend/04_Changing_source_code.md:4
+#: en/./developers/03_Backend/04_Changing_source_code.md:8
+#: en/./developers/03_Backend/04_Changing_source_code.md:12
+#: en/./developers/03_Backend/04_Changing_source_code.md:15
+#: en/./developers/03_Backend/05_Extensions.md:342
+#: en/./developers/03_Backend/05_Extensions.md:381
+#: en/./developers/04_Frontend/01_View_files.md:4
+#: en/./developers/04_Frontend/01_View_files.md:8
+#: en/./developers/04_Frontend/01_View_files.md:12
+#: en/./developers/04_Frontend/01_View_files.md:15
+#: en/./developers/04_Frontend/02_Design.md:4
+#: en/./developers/04_Frontend/02_Design.md:8
+#: en/./developers/04_Frontend/02_Design.md:11 en/./users/03_Main_view.md:4
+#: en/./users/03_Main_view.md:8 en/./users/03_Main_view.md:12
+#: en/./users/04_Subscriptions.md:4 en/./users/04_Subscriptions.md:8
+#: en/./users/04_Subscriptions.md:19 en/./users/05_Configuration.md:70
+#: en/./users/05_Configuration.md:74 en/./users/05_Configuration.md:128
+#: en/./users/05_Configuration.md:153 en/./users/05_Configuration.md:157
+#: en/./users/05_Configuration.md:161
+#, no-wrap
+msgid "**TODO**\n"
+msgstr "**À FAIRE**\n"
+
+#. type: Title #
+#: en/./developers/01_First_steps.md:62
+#, no-wrap
+msgid "Extensions"
+msgstr "Extensions"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:65
+msgid ""
+"If you want to create your own FreshRSS extension, take a look at the "
+"[extension documentation](03_Backend/05_Extensions.md)."
+msgstr ""
+"Si vous souhaitez créer votre propre extension FreshRSS, consultez la "
+"[documentation de l'extension](03_Backend/05_Extensions.md)."
+
+#. type: Title #
+#: en/./developers/01_First_steps.md:66
+#, no-wrap
+msgid "Coding style"
+msgstr "Style de codage"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:69
+msgid ""
+"If you want to contribute to the source code, it's important to follow the "
+"project's coding style. The actual code doesn't always follow it throughout "
+"the project, but we should fix it every time an opportunity presents itself."
+msgstr ""
+"Si vous désirez contribuer au code, il est important de respecter le style "
+"de codage suivant. Le code actuel ne le respecte pas entièrement mais il est "
+"de notre devoir à tous de le changer dès que l'occasion se présente."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:71
+msgid ""
+"Contributions which don't follow the coding style will be rejected as long "
+"as the coding style is not fixed."
+msgstr ""
+"Aucune nouvelle contribution ne respectant pas ces règles ne sera acceptée "
+"tant que les corrections nécessaires ne sont pas appliquées."
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:72
+#, no-wrap
+msgid "Spaces, tabs and other whitespace characters"
+msgstr "Espaces, tabulations et autres caractères blancs"
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:74
+#, no-wrap
+msgid "Indentation"
+msgstr "Indentation"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:76
+msgid "Code indentation must use tabs."
+msgstr ""
+"L'indentation du code doit être faite impérativement avec des tabulations."
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:77
+#, no-wrap
+msgid "Alignment"
+msgstr "Alignement"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:80
+msgid ""
+"Once the code has been correctly indented, it might be useful to align it "
+"for ease of reading. In that case, please use spaces."
+msgstr ""
+"Une fois l'indentation faite, il peut être nécessaire de faire un alignement "
+"pour simplifier la lecture. Dans ce cas, il faut utiliser les espaces."
+
+#. type: Code fence info string
+#: en/./developers/01_First_steps.md:81 en/./developers/01_First_steps.md:111
+#: en/./developers/01_First_steps.md:123 en/./developers/01_First_steps.md:158
+#: en/./developers/01_First_steps.md:173 en/./developers/01_First_steps.md:186
+#: en/./developers/01_First_steps.md:196 en/./developers/01_First_steps.md:213
+#: en/./developers/01_First_steps.md:228
+#: en/./developers/03_Backend/05_Extensions.md:47
+#: en/./developers/03_Backend/05_Extensions.md:88
+#: en/./developers/03_Backend/05_Extensions.md:130
+#: en/./developers/03_Backend/05_Extensions.md:149
+#: en/./developers/03_Backend/05_Extensions.md:166
+#: en/./developers/03_Backend/05_Extensions.md:188
+#: en/./developers/03_Backend/05_Extensions.md:225
+#: en/./developers/05_Release_new_version.md:54 en/./users/06_Fever_API.md:107
+#, no-wrap
+msgid "php"
+msgstr "php"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:81
+#, no-wrap
+msgid ""
+"$result = a_function_with_a_really_long_name($param1, $param2,\n"
+"                                             $param3, $param4);\n"
+msgstr ""
+"$resultat = une_fonction_avec_un_nom_long($param1, $param2,\n"
+"                                          $param3, $param4);\n"
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:86
+#, no-wrap
+msgid "End of line"
+msgstr "Fin de ligne"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:89
+msgid ""
+"The newline character must be a line feed (LF), which is the default line "
+"ending on *NIX systems. This character must not follow other white space."
+msgstr ""
+"Le caractère de fin de ligne doit être un saut de ligne (LF) qui est le "
+"caractère de fin de ligne des systèmes *NIX. Ce caractère ne doit pas être "
+"précédé par des caractères blanc."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:91
+msgid ""
+"You can verify if there is any unintended white space at the end of line "
+"with the following Git command:"
+msgstr ""
+"Il est possible de vérifier la présence de caractères blancs en fin de ligne "
+"grâce à Git avec la commande suivante :"
+
+#. type: Code fence info string
+#: en/./developers/01_First_steps.md:92 en/./developers/02_Github.md:80
+#: en/./developers/02_Github.md:85 en/./developers/02_Github.md:90
+#: en/./developers/02_Github.md:96 en/./developers/02_Github.md:102
+#: en/./developers/05_Release_new_version.md:15
+#: en/./developers/05_Release_new_version.md:102
+#, no-wrap
+msgid "bash"
+msgstr "bash"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:92
+#, no-wrap
+msgid ""
+"# command to check files before adding them in the Git index\n"
+"git diff --check\n"
+"# command to check files after adding them in the Git index\n"
+"git diff --check --cached\n"
+msgstr ""
+"# commande à lancer avant l'ajout des fichiers dans l'index\n"
+"git diff --check\n"
+"# commande à lancer après l'ajout des fichiers dans l'index mais avant le commit\n"
+"git diff --check --cached\n"
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:99 en/./developers/01_First_steps.md:220
+#, no-wrap
+msgid "End of file"
+msgstr "Fin de fichier"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:102
+msgid "Every file must end by an empty line."
+msgstr "Chaque fichier doit se terminer par une ligne vide."
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:103
+#, no-wrap
+msgid "Commas, dots and semi-columns"
+msgstr "Le cas de la virgule, du point et du point-virgule"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:106
+msgid ""
+"There should no space before those characters, but there should be one after."
+msgstr "Il n'y a pas d'espace avant ces caractères, il y en a un après."
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:107 en/./developers/01_First_steps.md:210
+#, no-wrap
+msgid "Operators"
+msgstr "Le cas des opérateurs"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:110
+msgid "There should be a space before and after every operator."
+msgstr "Chaque opérateur est entouré d'espaces."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:111
+#, no-wrap
+msgid ""
+"if ($a == 10) {\n"
+"\t// do something\n"
+"}\n"
+"\n"
+"echo $a ? 1 : 0;\n"
+msgstr ""
+"if ($a == 10) {\n"
+"\t// faire quelque chose\n"
+"}\n"
+"\n"
+"echo $a ? 1 : 0;\n"
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:119
+#, no-wrap
+msgid "Parentheses"
+msgstr "Le cas des parenthèses"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:122
+msgid ""
+"There should be no spaces in between brackets. There should be no spaces "
+"before the opening bracket, except if it's after a keyword. There shouldn't "
+"be any spaces after the closing bracket, except if it's followed by a curly "
+"bracket."
+msgstr ""
+"Il n'y a pas d'espaces entre des parenthèses. Il n'y a pas d'espaces avant "
+"une parenthèse ouvrante sauf si elle est précédée d'un mot-clé. Il n'y a pas "
+"d'espaces après une parenthèse fermante sauf si elle est suivie d'une "
+"accolade ouvrante."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:123
+#, no-wrap
+msgid ""
+"if ($a == 10) {\n"
+"\t// do something\n"
+"}\n"
+"\n"
+"if ((int)$a == 10) {\n"
+"\t// do something\n"
+"}\n"
+msgstr ""
+"if ($a == 10) {\n"
+"\t// faire quelque chose\n"
+"}\n"
+"\n"
+"if ((int)$a == 10) {\n"
+"\t// faire quelque chose\n"
+"}\n"
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:133
+#, no-wrap
+msgid "With chained functions"
+msgstr "Le cas des fonctions chainées"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:136
+msgid ""
+"It happens most of the time in Javascript files. When there are chained "
+"functions with closures and callback functions, it's hard to understand the "
+"code if not properly formatted. In those cases, we add a new indent level "
+"for the complete instruction and reset the indent for a new instruction on "
+"the same level."
+msgstr ""
+"Ce cas se présente le plus souvent en Javascript. Quand on a des fonctions "
+"chainées, des fonctions anonymes ainsi que des fonctions de rappels, il est "
+"très facile de se perdre. Dans ce cas là, on ajoute une indentation "
+"supplémentaire pour toute l'instruction et on revient au même niveau pour "
+"une instruction de même niveau."
+
+#. type: Code fence info string
+#: en/./developers/01_First_steps.md:137
+#, no-wrap
+msgid "javascript"
+msgstr "javascript"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:137
+#, no-wrap
+msgid ""
+"// First instruction\n"
+"shortcut.add(shortcuts.mark_read, function () {\n"
+"\t\t//...\n"
+"\t}, {\n"
+"\t\t'disable_in_input': true\n"
+"\t});\n"
+"// Second instruction\n"
+"shortcut.add(\"shift+\" + shortcuts.mark_read, function () {\n"
+"\t\t//...\n"
+"\t}, {\n"
+"\t\t'disable_in_input': true\n"
+"\t});\n"
+msgstr ""
+"// Première instruction\n"
+"shortcut.add(shortcuts.mark_read, function () {\n"
+"\t\t//...\n"
+"\t}, {\n"
+"\t\t'disable_in_input': true\n"
+"\t});\n"
+"// Deuxième instruction\n"
+"shortcut.add(\"shift+\" + shortcuts.mark_read, function () {\n"
+"\t\t//...\n"
+"\t}, {\n"
+"\t\t'disable_in_input': true\n"
+"\t});\n"
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:152
+#, no-wrap
+msgid "Line length"
+msgstr "Longueur des lignes"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:155
+msgid ""
+"Lines should strive to be shorter than 80 characters. However, this limit "
+"may be extended to 100 characters when strictly necessary."
+msgstr ""
+"Les lignes ne doivent pas dépasser 80 caractères. Il est cependant autorisé "
+"exceptionnellement de dépasser cette limite s'il n'est pas possible de la "
+"respecter mais en aucun cas, les lignes ne doivent dépasser les 100 "
+"caractères."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:157
+msgid "With functions, parameters can be declared on multiple lines."
+msgstr ""
+"Dans le cas des fonctions, les paramètres peuvent être déclarés sur "
+"plusieurs lignes."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:158
+#, no-wrap
+msgid ""
+"function my_function($param_1, $param_2,\n"
+"                     $param_3, $param_4) {\n"
+"\t// do something\n"
+"}\n"
+msgstr ""
+"function ma_fonction($param_1, $param_2,\n"
+"                     $param_3, $param_4) {\n"
+"\t// faire quelque chose\n"
+"}\n"
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:165
+#, no-wrap
+msgid "Naming"
+msgstr "Nommage"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:168
+msgid ""
+"All code elements (functions, classes, methods and variables) must describe "
+"their usage succinctly."
+msgstr ""
+"L'ensemble des éléments du code (fonctions, classes, méthodes et variables) "
+"doivent être nommés de manière à décrire leur usage de façon concise."
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:169
+#, no-wrap
+msgid "Functions and variables"
+msgstr "Fonctions et variables"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:172
+msgid ""
+"Functions and variables must follow the \"snake case\" naming convention."
+msgstr ""
+"Les fonctions et les variables doivent suivre la convention \"snake case\"."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:173
+#, no-wrap
+msgid ""
+"// a function\n"
+"function function_name() {\n"
+"\t// do something\n"
+"}\n"
+"// a variable\n"
+"$variable_name;\n"
+msgstr ""
+"// une fontion\n"
+"function nom_de_la_fontion() {\n"
+"\t// faire quelque chose\n"
+"}\n"
+"// une variable\n"
+"$nom_de_la_variable;\n"
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:182
+#, no-wrap
+msgid "Methods"
+msgstr "Méthodes"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:185
+msgid "Methods must follow the \"lower camel case\" naming convention."
+msgstr "Les méthodes doivent suivre la convention \"lower camel case\"."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:186
+#, no-wrap
+msgid ""
+"private function methodName() {\n"
+"\t// do something\n"
+"}\n"
+msgstr ""
+"private function nomDeLaMethode() {\n"
+"\t// faire quelque chose\n"
+"}\n"
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:192
+#, no-wrap
+msgid "Classes"
+msgstr "Classes"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:195
+msgid "Classes must follow the \"upper camel case\" naming convention."
+msgstr "Les classes doivent suivre la convention \"upper camel case\"."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:196
+#, no-wrap
+msgid "abstract class ClassName {}\n"
+msgstr "abstract class NomDeLaClasse {}\n"
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:200
+#, no-wrap
+msgid "Encoding"
+msgstr "Encodage"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:203
+msgid "Files must be encoded with the UTF-8 character set."
+msgstr "Les fichiers doivent être encodés en UTF-8."
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:204
+#, no-wrap
+msgid "PHP compatibility"
+msgstr "Compatibilité PHP"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:207
+msgid ""
+"Please ensure that your code works with the oldest PHP version officially "
+"supported by FreshRSS."
+msgstr ""
+"Assurez-vous que votre code fonctionne avec une version de PHP aussi "
+"ancienne que celle que FreshRSS supporte officiellement."
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:208
+#, no-wrap
+msgid "Miscellaneous"
+msgstr "Divers"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:212
+msgid ""
+"Operators must be at the end of the line if a condition is split over more "
+"than one line."
+msgstr ""
+"Les opérateurs doivent être en fin de ligne dans le cas de conditions sur "
+"plusieurs lignes."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:213
+#, no-wrap
+msgid ""
+"if ($a == 10 ||\n"
+"    $a == 20) {\n"
+"\t// do something\n"
+"}\n"
+msgstr ""
+"if ($a == 10 ||\n"
+"    $a == 20) {\n"
+"\t// faire quelque chose\n"
+"}\n"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:223
+msgid ""
+"If the file contains only PHP code, the PHP closing tag must be omitted."
+msgstr ""
+"Si le fichier ne contient que du PHP, il ne doit pas comporter de balise "
+"fermante."
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:224
+#, no-wrap
+msgid "Arrays"
+msgstr "Tableaux"
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:227
+msgid ""
+"If an array declaration runs on more than one line, each element must be "
+"followed by a comma, including the last one."
+msgstr ""
+"Lors de l'écriture de tableaux sur plusieurs lignes, tous les éléments "
+"doivent être suivis d'une virgule (même le dernier)."
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:228
+#, no-wrap
+msgid ""
+"$variable = [\n"
+"\t\"value 1\",\n"
+"\t\"value 2\",\n"
+"\t\"value 3\",\n"
+"];\n"
+msgstr ""
+"$variable = [\n"
+"\t\"valeur 1\",\n"
+"\t\"valeur 2\",\n"
+"\t\"valeur 3\",\n"
+"];\n"
+
+#. type: Title #
+#: en/./developers/02_Github.md:1
+#, no-wrap
+msgid "Reporting a bug or a suggestion"
+msgstr "Remonter un problème ou une suggestion"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:4
+msgid ""
+"Despite the care given to FreshRSS, it's still possible that bugs occur. The "
+"project is young and development is dynamic, so it can be corrected quickly. "
+"You might also have a feature in mind that doesn't yet exist. Regardless "
+"whether your idea seems silly, far-fetched, useless or too specific, please "
+"don't hesitate to propose it to us! \"Ideas in the air\" often find an "
+"attentive ear. It's new external perspectives that make the project evolve "
+"the most."
+msgstr ""
+"Malgré le soin apporté à FreshRSS, il se peut que des bugs apparaissent "
+"encore. Le projet est jeune et le développement dynamique, aussi celui-ci "
+"pourra être corrigé rapidement. Il se peut aussi que vous ayez en tête une "
+"fonctionnalité qui n'existe pas encore. Que celle-ci vous paraisse idiote, "
+"farfelue, inutile ou trop spécifique, il ne faut surtout pas hésiter à nous "
+"la proposer ! Très souvent des \"idées en l'air\" ont trouvé une oreille "
+"attentive. Ce sont les regards externes qui font le plus évoluer le projet."
+
+#. type: Plain text
+#: en/./developers/02_Github.md:6
+msgid ""
+"If you're convinced that you should be heard, here's how you can go about it."
+msgstr ""
+"Si vous êtes convaincus qu'il faut vous faire entendre, voici la marche à "
+"suivre."
+
+#. type: Title ##
+#: en/./developers/02_Github.md:7
+#, no-wrap
+msgid "On GitHub"
+msgstr "Sur GitHub"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:10
+msgid ""
+"GitHub is the ideal platform to submit your requests. It allows us to "
+"discuss a problem or suggestion with others and it often generates new "
+"ideas. Let's not neglect this \"social\" aspect!"
+msgstr ""
+"GitHub est la plate-forme à privilégier pour vos demandes. En effet, cela "
+"nous permet de pouvoir discuter à plusieurs sur un problème ou une "
+"suggestion et de faire émerger, souvent, des idées nouvelles. Ne négligeons "
+"pas cet aspect \"social\" !"
+
+#. type: Bullet: ' 1. '
+#: en/./developers/02_Github.md:16
+msgid ""
+"[Go to the bug ticket manager](https://github.com/FreshRSS/FreshRSS/issues)"
+msgstr ""
+"[Rendez-vous sur le gestionnaire de tickets de bugs](https://github.com/"
+"FreshRSS/FreshRSS/issues)"
+
+#. type: Bullet: ' 2. '
+#: en/./developers/02_Github.md:16
+msgid ""
+"Start by checking if a similar request hasn't already been made. If so, "
+"please feel free to add your voice to the request."
+msgstr ""
+"Commencez par rechercher si une demande similaire n'a pas déjà été faite. Si "
+"oui, n'hésitez pas à ajouter votre voix à la demande."
+
+#. type: Bullet: ' 3. '
+#: en/./developers/02_Github.md:16
+msgid ""
+"If your request is new, [open a new bug ticket](https://github.com/FreshRSS/"
+"FreshRSS/issues/new)"
+msgstr ""
+"Si votre demande est nouvelle, [ouvrez un nouveau ticket de bug](https://"
+"github.com/FreshRSS/FreshRSS/issues/new)"
+
+#. type: Bullet: ' 4. '
+#: en/./developers/02_Github.md:16
+msgid ""
+"Finally, write your request. If you're fluent in English, it's the preferred "
+"language because it allows for discussion with the largest number of people."
+msgstr ""
+"Rédigez enfin votre demande. Si vous maitrisez l'anglais, c'est la langue à "
+"privilégier car cela permet d'ouvrir la discussion à un plus grand nombre de "
+"personnes. Sinon, ce n'est pas grave, continuez en français :)"
+
+#. type: Bullet: ' 5. '
+#: en/./developers/02_Github.md:16
+msgid ""
+"Please follow the tips below to make it easier to let your ticket be heard."
+msgstr ""
+"Merci de bien vouloir suivre les quelques conseils donnés plus bas pour "
+"faciliter la prise en compte de votre ticket."
+
+#. type: Title ##
+#: en/./developers/02_Github.md:17
+#, no-wrap
+msgid "Informal"
+msgstr "De façon informelle"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:20
+msgid ""
+"Not everyone likes or uses GitHub for a variety of legitimate reasons. That "
+"is why you can also contact us in a more informal way."
+msgstr ""
+"Tout le monde n'aime pas ou n'utilise pas GitHub pour des raisons aussi "
+"diverses que légitimes. C'est pourquoi vous pouvez aussi nous contacter de "
+"façon plus informelle."
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid ""
+"On [our Mattermost chat](https://framateam.org/signup_user_complete/?"
+"id=e2680d3e3128b9fac8fdb3003b0024ee)"
+msgstr ""
+"Sur [notre chat Mattermost](https://framateam.org/signup_user_complete/?"
+"id=e2680d3e3128b9fac8fdb3003b0024ee)"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid ""
+"On [the mailing lists](https://freshrss.org/announce-of-the-mailing-lists."
+"html)"
+msgstr ""
+"Sur [les listes de diffusion](https://freshrss.org/announce-of-the-mailing-"
+"lists.html)"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid "At events / meetings around Free Software"
+msgstr "À des évènements / rencontres autour du Logiciel Libre"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid "Over a beer in a bar"
+msgstr "Autour d'une bière dans un bar"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid "Etc."
+msgstr "Etc."
+
+#. type: Title ##
+#: en/./developers/02_Github.md:27
+#, no-wrap
+msgid "Tips"
+msgstr "Conseils"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:30
+msgid "Here are some tips to help you present your bug report or suggestion:"
+msgstr ""
+"Voici quelques conseils pour bien présenter votre remontée de bug ou votre "
+"suggestion :"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"**Pay attention to spelling**. Even if it's not always easy, try your best!"
+msgstr ""
+"**Faites attention à l'orthographe.** même si ce n'est pas toujours facile, "
+"faites votre maximum. ;)"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"**Give an explicit title to your request**, even if it's a bit long. This "
+"not only helps us understand your request, but also to find your ticket "
+"later."
+msgstr ""
+"**Donnez un titre explicite à votre demande**, quitte à ce qu'il soit un peu "
+"long. Cela nous aide non seulement à comprendre votre demande, mais aussi à "
+"retrouver votre ticket plus tard."
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"**One request = one ticket.** You may have lots of ideas while being afraid "
+"to spam the bug manager: it doesn't matter. It's better to have a few too "
+"many tickets than too many requests in one. We'll close and consolidate "
+"requests when possible."
+msgstr ""
+"**Une demande = un ticket.** Vous pouvez avoir des tas d'idées mais vous "
+"avez peur de spammer le gestionnaire de bugs : ça ne fait rien. Il vaut "
+"mieux avoir un peu trop de tickets que trop de demandes dans un seul. On "
+"s'occupera de fermer et regrouper les demandes qui le peuvent."
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"If you report a bug, think about **providing us with the FreshRSS logs** "
+"(accessible in the FreshRSS `data/log/` folder) and the **PHP logs** (the "
+"location may vary by distribution, but consider searching in `/var/log/"
+"httpd` or `/var/log/apache`)."
+msgstr ""
+"Si vous remontez un bug, pensez à nous **fournir les logs de FreshRSS** "
+"(accessibles dans les dossier ''data/log/'' de FreshRSS) **et PHP** "
+"(l'emplacement peut varier selon les distributions, mais pensez à chercher "
+"dans ''/var/log/httpd'' ou ''/var/log/apache'')."
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"If you can't find the log files, specify it in your ticket so we know you've "
+"already searched."
+msgstr ""
+"Si vous ne trouvez pas les fichiers de logs, précisez-le dans votre ticket "
+"afin que nous sachions que vous avez déjà cherché."
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"Not all bugs require logs, but if you have any doubts, it is better to "
+"provide them to us. Logs are important and very useful for debugging!"
+msgstr ""
+"Tous les bugs ne nécessitent pas les logs, mais si vous doutez, mieux vaut "
+"nous les fournir. Les logs sont importants et très utiles pour débugguer !"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"The logs may reveal confidential information, so **be careful not to "
+"disclose anything sensitive.**"
+msgstr ""
+"Il se peut que les logs puissent révéler des informations plus ou moins "
+"confidentielles, **faites attention à ne rien divulguer de sensible.**"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:41
+msgid ""
+"In addition, when facing a bug, you're encouraged to follow this message "
+"format (from the [Sam & Max website](http://sametmax.com/template-de-demande-"
+"daide-en-informatique/):"
+msgstr ""
+"De plus, face à un bug, je ne peux que vous encourager à suivre le format de "
+"message suivant (tiré du [site de Sam & Max](http://sametmax.com/template-de-"
+"demande-daide-en-informatique/)) :"
+
+#. type: Title ###
+#: en/./developers/02_Github.md:42
+#, no-wrap
+msgid "What's my goal?"
+msgstr "Quel est mon objectif ?"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:45
+msgid "Give the general context of what you were trying to do."
+msgstr "Donnez le contexte général de ce que vous essayiez de faire."
+
+#. type: Title ###
+#: en/./developers/02_Github.md:46
+#, no-wrap
+msgid "What have I been trying to do?"
+msgstr "Qu’est-ce que j’ai essayé de faire ?"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:49
+msgid ""
+"Explain step by step what you have done so that we can reproduce the bug."
+msgstr ""
+"Expliquez pas à pas ce que vous avez fait afin que nous puissions reproduire "
+"le bug."
+
+#. type: Title ###
+#: en/./developers/02_Github.md:50
+#, no-wrap
+msgid "What results have I achieved?"
+msgstr "Quels résultats ai-je obtenus ?"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:53
+msgid ""
+"The bug: what you see that shouldn't have happened. Here you can provide the "
+"logs."
+msgstr ""
+"Le bug : ce que vous voyez qui n'aurez pas dû se passer. Ici vous pouvez "
+"fournir les logs."
+
+#. type: Title ###
+#: en/./developers/02_Github.md:54
+#, no-wrap
+msgid "What was the expected result?"
+msgstr "Quel était le résultat attendu ?"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:57
+msgid "So that we understand what you consider to be the problem."
+msgstr ""
+"Afin que nous comprenions bien où est le problème... au moins selon vous :p"
+
+#. type: Title ###
+#: en/./developers/02_Github.md:58
+#, no-wrap
+msgid "What are my circumstances?"
+msgstr "Quelle est ma situation ?"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:61
+msgid "Remember to give the following information if you know it:"
+msgstr "Pensez à donner les informations suivantes si vous les connaissez :"
+
+#. type: Bullet: ' 1. '
+#: en/./developers/02_Github.md:67
+msgid "Which browser? Which version?"
+msgstr "Quel navigateur ? Quelle version ?"
+
+#. type: Bullet: ' 2. '
+#: en/./developers/02_Github.md:67
+msgid "Which server: Apache, Nginx? Which version?"
+msgstr "Quel serveur : Apache, Nginx ? Quelle version ?"
+
+#. type: Bullet: ' 3. '
+#: en/./developers/02_Github.md:67
+msgid "Which version of PHP?"
+msgstr "Quelle version de PHP ?"
+
+#. type: Bullet: ' 4. '
+#: en/./developers/02_Github.md:67
+msgid "Which database: SQLite, MySQL, MariaDB, PostgreSQL? Which version?"
+msgstr ""
+"Quelle base de données : SQLite, MySQL, MariaDB, PostgreSQL ? Quelle "
+"version ?"
+
+#. type: Bullet: ' 5. '
+#: en/./developers/02_Github.md:67
+msgid "Which distribution runs on the server? And... which version?"
+msgstr "Quelle distribution sur le serveur ? Et… quelle version ?"
+
+#. type: Title #
+#: en/./developers/02_Github.md:68
+#, no-wrap
+msgid "Branching"
+msgstr "Système de branches"
+
+#. type: Title ##
+#: en/./developers/02_Github.md:70
+#, no-wrap
+msgid "Basic"
+msgstr "Élémentaire"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:72
+msgid ""
+"If you are new to Git, here are some of the resources you might find useful:"
+msgstr ""
+"Si vous êtes novice dans Git, voici quelques ressources qui pourraient vous "
+"être utiles :"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:77
+msgid "[GitHub's blog post](https://github.com/blog/120-new-to-git)"
+msgstr "[Article du blog de GitHub](https://github.com/blog/120-new-to-git)"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:77
+msgid "<http://try.github.com/>"
+msgstr "<http://try.github.com/>"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:77
+msgid "<http://sixrevisions.com/resources/git-tutorials-beginners/>"
+msgstr "<http://sixrevisions.com/resources/git-tutorials-beginners/>"
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:77
+msgid "<http://rogerdudler.github.io/git-guide/>"
+msgstr "<http://rogerdudler.github.io/git-guide/>"
+
+#. type: Title ##
+#: en/./developers/02_Github.md:78
+#, no-wrap
+msgid "Getting the latest code from the FreshRSS repository"
+msgstr "Obtenir le dernier code du répertoire FreshRSS"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:80
+msgid "First you need to add the official repo to your remote repo list:"
+msgstr ""
+"Vous devez avant tout ajouter le repo officiel à votre liste de repo remote :"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:80
+#, no-wrap
+msgid "git remote add upstream git@github.com:FreshRSS/FreshRSS.git\n"
+msgstr "git remote add upstream git@github.com:FreshRSS/FreshRSS.git\n"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:85
+msgid "You can verify the remote repo is successfully added by using:"
+msgstr ""
+"Vous pouvez vérifier que le repo remote a été ajouté avec succès en "
+"utilisant :"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:85
+#, no-wrap
+msgid "git remote -v show\n"
+msgstr "git remote -v show\n"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:90
+msgid "Now you can pull the latest development code:"
+msgstr "Vous pouvez maintenant pull le dernier code de développement :"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:90
+#, no-wrap
+msgid ""
+"git checkout dev\n"
+"git pull upstream dev\n"
+msgstr ""
+"git checkout dev\n"
+"git pull upstream dev\n"
+
+#. type: Title ##
+#: en/./developers/02_Github.md:95
+#, no-wrap
+msgid "Starting a new development branch"
+msgstr "Lancer une nouvelle branche de développement"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:96
+#, no-wrap
+msgid "git checkout -b my-development-branch\n"
+msgstr "git checkout -b mon-branch-developpement\n"
+
+#. type: Title #
+#: en/./developers/02_Github.md:100
+#, no-wrap
+msgid "Sending a patch"
+msgstr "Proposer un patch"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:102
+#, no-wrap
+msgid ""
+"# Add the changed file, here actualize_script.php\n"
+"git add app/actualize_script.php\n"
+"# Commit the change and write a proper commit message\n"
+"git commit\n"
+"# Double check all looks well\n"
+"git show\n"
+"# Push it to your fork\n"
+"git push\n"
+msgstr ""
+"# Ajoutez le fichier modifié, ici actualize_script.php\n"
+"git add app/actualize_script.php\n"
+"# Commitez le changement et écrivez un message de commit approprié.\n"
+"git commit\n"
+"# Vérifiez deux fois que tout a l'air d'aller bien\n"
+"git show\n"
+"# Poussez les changements sur ton fork\n"
+"git push\n"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:114
+msgid ""
+"Now you can create a PR based on your branch. Please make sure to file it "
+"against the `dev` branch!"
+msgstr ""
+"Vous pouvez maintenant créer un PR en fonction de votre branche. S'il vous "
+"plaît, assurez-vous de le soumettre contre la branche `dev` !"
+
+#. type: Title ##
+#: en/./developers/02_Github.md:115
+#, no-wrap
+msgid "How to write a commit message"
+msgstr "Comment écrire un message de commit"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:118
+msgid ""
+"A commit message should succintly describe the changes on the first line. "
+"For example:"
+msgstr ""
+"Un message de commit devrait décrire succinctement les changements sur la "
+"première ligne. Par exemple :"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:120
+#, no-wrap
+msgid "> Fix broken icon\n"
+msgstr "> Fixe une icône cassée\n"
+
+#. type: Plain text
+#: en/./developers/02_Github.md:122
+msgid ""
+"If necessary, this can be followed by a blank line and a longer explanation."
+msgstr ""
+"Si nécessaire, une ligne blanche et une explication plus longue peuvent le "
+"suivre."
+
+#. type: Plain text
+#: en/./developers/02_Github.md:123
+msgid "For further tips, see [here](https://chris.beams.io/posts/git-commit/)."
+msgstr ""
+"Pour d'autres conseils, voir [ici](https://chris.beams.io/posts/git-commit/)."
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:1
+#, no-wrap
+msgid "Models"
+msgstr "Modèles"
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:5
+#, no-wrap
+msgid "Controllers and actions"
+msgstr "Contrôleurs et actions"
+
+#. type: Title ###
+#: en/./developers/03_Backend/02_Minz.md:9
+#: en/./developers/03_Backend/05_Extensions.md:69
+#, no-wrap
+msgid "Views"
+msgstr "Vues"
+
+#. type: Title ###
+#: en/./developers/03_Backend/02_Minz.md:13
+#: en/./developers/03_Backend/05_Extensions.md:39
+#, no-wrap
+msgid "Routing"
+msgstr "Routage"
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:17
+#, no-wrap
+msgid "Writing URL"
+msgstr "Écriture des URL"
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:21
+#: en/./developers/04_Frontend/01_View_files.md:13
+#, no-wrap
+msgid "Internationalisation"
+msgstr "Internationalisation"
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:25
+#, no-wrap
+msgid "Understanding internals"
+msgstr "Comprendres les mécanismes internes"
+
+#. type: Title #
+#: en/./developers/03_Backend/04_Changing_source_code.md:1
+#, no-wrap
+msgid "Accessing the database"
+msgstr "Accès à la base de données"
+
+#. type: Title #
+#: en/./developers/03_Backend/04_Changing_source_code.md:5
+#, no-wrap
+msgid "Writing an action and its related view"
+msgstr "Écrire une action et sa vue associée"
+
+#. type: Title #
+#: en/./developers/03_Backend/04_Changing_source_code.md:9
+#, no-wrap
+msgid "Authentication"
+msgstr "Gestion de l'authentification"
+
+#. type: Title #
+#: en/./developers/03_Backend/04_Changing_source_code.md:13
+#, no-wrap
+msgid "Logs"
+msgstr "Gestion des logs"
+
+#. type: Title #
+#: en/./developers/03_Backend/05_Extensions.md:1
+#, no-wrap
+msgid "Writing extensions for FreshRSS"
+msgstr "Écriture d'extensions pour FreshRSS"
+
+#. type: Title ##
+#: en/./developers/03_Backend/05_Extensions.md:3
+#, no-wrap
+msgid "About FreshRSS"
+msgstr "Présentation de FreshRSS"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:6
+msgid ""
+"FreshRSS is an RSS / Atom feed aggregator written in PHP dating back to "
+"October 2012. The official site is located at [freshrss.org](https://"
+"freshrss.org) and the official repository is hosted on Github: [github.com/"
+"FreshRSS/FreshRSS](https://github.com/FreshRSS/FreshRSS)."
+msgstr ""
+"FreshRSS est un agrégateur de flux RSS / Atom écrit en PHP depuis octobre "
+"2012. Le site officiel est situé à l'adresse [freshrss.org](https://freshrss."
+"org) et son dépot Git est hébergé par Github : [github.com/FreshRSS/FreshRSS]"
+"(https://github.com/FreshRSS/FreshRSS)."
+
+#. type: Title ##
+#: en/./developers/03_Backend/05_Extensions.md:7
+#, no-wrap
+msgid "The problem"
+msgstr "Problème à résoudre"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:10
+msgid "FreshRSS is limited in its technical possibilities by various factors:"
+msgstr ""
+"FreshRSS est limité dans ses possibilités techniques par différents "
+"facteurs :"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:14
+msgid "The number of developers"
+msgstr "La disponibilité des développeurs principaux ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:14
+msgid "The will to integrate certain changes"
+msgstr "La volonté d'intégrer certains changements ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:14
+msgid "The level of \"hacking\" required to integrate marginal features"
+msgstr ""
+"Le niveau de « hack » nécessaire pour intégrer des fonctionnalités à la "
+"marge."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:16
+msgid ""
+"While the first limitation can, in theory, be lifted by the participation of "
+"new contributors to the project, it depends on the willingness of "
+"contributors to take an interest in the source code of the entire project. "
+"In order to remove the other two limitations, most of the time it will be "
+"necessary to create a \"fork\"."
+msgstr ""
+"Si la première limitation peut, en théorie, être levée par la participation "
+"de nouveaux contributeurs au projet, elle est en réalité conditionnée par la "
+"volonté des contributeurs à s'intéresser au code source du projet en entier. "
+"Afin de lever les deux autres limitations quant à elles, il faudra la "
+"plupart du temps passer par un « à-coté » souvent synonyme de « fork »."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:18
+msgid ""
+"Another solution consists of an extension system. By allowing users to write "
+"their own extension without taking an interest in the core of the basic "
+"software, we allow for:"
+msgstr ""
+"Une autre solution consiste à passer par un système d'extensions. En "
+"permettant à des utilisateurs d'écrire leur propre extension sans avoir à "
+"s'intéresser au cœur même du logiciel de base, on permet :"
+
+#. type: Bullet: '1. '
+#: en/./developers/03_Backend/05_Extensions.md:22
+msgid "Reducing the amount of source code a new contributor has to take in"
+msgstr ""
+"De réduire la quantité de code source à assimiler pour un nouveau "
+"contributeur ;"
+
+#. type: Bullet: '2. '
+#: en/./developers/03_Backend/05_Extensions.md:22
+msgid "Unofficial integration of novelties"
+msgstr "De permettre d'intégrer des nouveautés de façon non-officielles ;"
+
+#. type: Bullet: '3. '
+#: en/./developers/03_Backend/05_Extensions.md:22
+msgid "No forking or main developer approval required."
+msgstr ""
+"De se passer des développeurs principaux pour d'éventuelles améliorations "
+"sans passer par la case « fork »."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:24
+msgid ""
+"Note: it is quite conceivable that the functionalities of an extension can "
+"later be officially integrated into the FreshRSS code. Extensions make it "
+"easy to propose a proof of concept."
+msgstr ""
+"Note : il est tout à fait imaginable que les fonctionnalités d'une extension "
+"puissent par la suite être intégrées dans le code initial de FreshRSS de "
+"façon officielle. Cela permet de proposer un « proof of concept » assez "
+"facilement."
+
+#. type: Title ##
+#: en/./developers/03_Backend/05_Extensions.md:25
+#, no-wrap
+msgid "Understanding basic mechanics (Minz and MVC)"
+msgstr "Comprendre les mécaniques de base (Minz et MVC)"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:28
+#, no-wrap
+msgid "**TODO** : move to 02_Minz.md\n"
+msgstr "**TODO** : bouger dans 02_Minz.md\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:30
+msgid ""
+"This data sheet should refer to the official FreshRSS and Minz documentation "
+"(the PHP framework on which FreshRSS is based). Unfortunately, this "
+"documentation does not yet exist. In a few words, here are the main things "
+"you should know. It is not necessary to read all the chapters in this "
+"section if you don't need to use a feature in your extension (if you don't "
+"need to translate your extension, no need to know more about the "
+"`Minz_Translate` module for example)."
+msgstr ""
+"Cette fiche technique devrait renvoyer vers la documentation officielle de "
+"FreshRSS et de Minz (le framework PHP sur lequel repose FreshRSS). "
+"Malheureusement cette documentation n'existe pas encore. Voici donc en "
+"quelques mots les principaux éléments à connaître. Il n'est pas nécessaire "
+"de lire l'ensemble des chapitres de cette section si vous n'avez pas à "
+"utiliser une fonctionnalité dans votre extension (si vous n'avez pas besoin "
+"de traduire votre extension, pas besoin d'en savoir plus sur le module "
+"`Minz_Translate` par exemple)."
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:31
+#, no-wrap
+msgid "MVC Architecture"
+msgstr "Architecture MVC"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:34
+msgid ""
+"Minz relies on and imposes an MVC architecture on projects using it. This "
+"architecture consists of three main components:"
+msgstr ""
+"Minz repose et impose une architecture MVC pour les projets l'utilisant. On "
+"distingue dans cette architecture trois composants principaux :"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:38
+msgid ""
+"The model: this is the base object that we will manipulate. In FreshRSS, "
+"categories, flows and articles are templates. The part of the code that "
+"makes it possible to manipulate them in a database is also part of the model "
+"but is separated from the base model: we speak of DAO (for \"Data Access "
+"Object\"). The templates are stored in a `Models` folder."
+msgstr ""
+"Le Modèle : c'est l'objet de base que l'on va manipuler. Dans FreshRSS, les "
+"catégories, les flux et les articles sont des modèles. La partie du code qui "
+"permet de les manipuler en base de données fait aussi partie du modèle mais "
+"est séparée du modèle de base : on parle de DAO (pour « Data Access Object "
+"»). Les modèles sont stockés dans un répertoire `Models`."
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:38
+msgid ""
+"The view: this is what the user sees. The view is therefore simply HTML code "
+"mixed with PHP to display dynamic information. The views are stored in a "
+"`views` folder."
+msgstr ""
+"La Vue : c'est ce qui représente ce que verra l'utilisateur. La vue est donc "
+"simplement du code HTML que l'on mixe avec du PHP pour afficher les "
+"informations dynamiques. Les vues sont stockées dans un répertoire `views`."
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:38
+msgid ""
+"The controller: this is what makes it possible to link models and views. "
+"Typically, a controller will load templates from the database (like a list "
+"of items) to \"pass\" them to a view for display. Controllers are stored in "
+"a `Controllers` directory."
+msgstr ""
+"Le Contrôleur : c'est ce qui permet de lier modèles et vues entre eux. "
+"Typiquement, un contrôleur va charger des modèles à partir de la base de "
+"données (une liste d'articles par exemple) pour les « passer » à une vue "
+"afin qu'elle les affiche. Les contrôleurs sont stockés dans un répertoire "
+"`Controllers`."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:42
+msgid ""
+"In order to link a URL to a controller, first you have to go through a "
+"\"routing\" phase. In FreshRSS, this is particularly simple because it "
+"suffices to specify the name of the controller to load into the URL using a "
+"`c` parameter. For example, the address http://exemple.com?c=hello will "
+"execute the code contained in the `hello` controller."
+msgstr ""
+"Afin de lier une URL à un contrôleur, on doit passer par une phase dite de « "
+"routage ». Dans FreshRSS, cela est particulièrement simple car il suffit "
+"d'indiquer le nom du contrôleur à charger dans l'URL à l'aide d'un paramètre "
+"`c`. Par exemple, l'adresse http://exemple.com?c=hello va exécuter le code "
+"contenu dans le contrôleur `hello`."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:44
+msgid ""
+"One concept that has not yet been discussed is the \"actions\" system. An "
+"action is executed *on* a controller. Concretely, a controller is "
+"represented by a class and its actions by methods. To execute an action, it "
+"is necessary to specify an `a` parameter in the URL."
+msgstr ""
+"Une notion qui n'a pas encore été évoquée est le système d'« actions ». Une "
+"action est exécutée *sur* un contrôleur. Concrètement, un contrôleur va être "
+"représenté par une classe et ses actions par des méthodes. Pour exécuter une "
+"action, il est nécessaire d'indiquer un paramètre `a` dans l'URL."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:46
+#: en/./developers/03_Backend/05_Extensions.md:165
+msgid "Code example:"
+msgstr "Exemple de code :"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:47
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"class FreshRSS_hello_Controller extends Minz_ActionController {\n"
+"\tpublic function indexAction() {\n"
+"\t\t$this->view->a_variable = 'FooBar';\n"
+"\t}\n"
+"\n"
+"\tpublic function worldAction() {\n"
+"\t\t$this->view->a_variable = 'Hello World!';\n"
+"\t}\n"
+"}\n"
+"\n"
+"?>\n"
+msgstr ""
+"<?php\n"
+"\n"
+"class FreshRSS_hello_Controller extends Minz_ActionController {\n"
+"\tpublic function indexAction() {\n"
+"\t\t$this->view->a_variable = 'FooBar';\n"
+"\t}\n"
+"\n"
+"\tpublic function worldAction() {\n"
+"\t\t$this->view->a_variable = 'Hello World!';\n"
+"\t}\n"
+"}\n"
+"\n"
+"?>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:64
+msgid ""
+"When loading the address http://exemple.com?c=hello&a=world, the `world` "
+"action is executed on the `hello` controller."
+msgstr ""
+"Si l'on charge l'adresse http://exemple.com?c=hello&a=world, l'action "
+"`world` va donc être exécutée sur le contrôleur `hello`."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:66
+msgid ""
+"Note: if `c` or `a` is not specified, the default value for each of these "
+"variables is `index`. So the address http://exemple.com?c=hello will execute "
+"the `index` action of the `hello` controller."
+msgstr ""
+"Note : si `c` ou `a` n'est pas précisée, la valeur par défaut de chacune de "
+"ces variables est `index`. Ainsi l'adresse http://exemple.com?c=hello va "
+"exécuter l'action `index` du contrôleur `hello`."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:68
+msgid ""
+"From now on, the `hello/world` naming convention will be used to refer to a "
+"controller/action pair."
+msgstr ""
+"Plus loin, sera utilisée la convention `hello/world` pour évoquer un couple "
+"contrôleur/action."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:72
+msgid ""
+"Each view is associated with a controller and an action. The view associated "
+"with `hello/world` will be stored in a very specific file: `views/hello/"
+"world. phtml`. This convention is imposed by Minz."
+msgstr ""
+"Chaque vue est associée à un contrôleur et à une action. La vue associée à "
+"`hello/world` va être stockée dans un fichier bien spécifique : `views/hello/"
+"world.phtml`. Cette convention est imposée par Minz."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:74
+msgid ""
+"As explained above, the views consist of HTML mixed with PHP. Code example:"
+msgstr ""
+"Comme expliqué plus haut, les vues sont du code HTML mixé à du PHP. Exemple "
+"de code :"
+
+#. type: Code fence info string
+#: en/./developers/03_Backend/05_Extensions.md:75
+#: en/./developers/03_Backend/05_Extensions.md:120
+#: en/./developers/03_Backend/05_Extensions.md:248
+#: en/./developers/03_Backend/05_Extensions.md:284
+#: en/./developers/03_Backend/05_Extensions.md:351
+#, no-wrap
+msgid "html"
+msgstr "html"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:75
+#, no-wrap
+msgid ""
+"<p>\n"
+"\tThis is a parameter passed from the controller: <?= $this->a_variable ?>\n"
+"</p>\n"
+msgstr ""
+"<p>\n"
+"\tPhrase passée en paramètre : <?= $this->a_variable ?>\n"
+"</p>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:82
+#, no-wrap
+msgid "The variable `$this->a_variable` is passed by the controller (see previous example). The difference is that in the controller it is necessary to pass `$this->view`, while in the view `$this` suffices.\n"
+msgstr "La variable `$this->a_variable` a été passée précédemment par le contrôleur (voir exemple précédent). La différence est que dans le contrôleur il est nécessaire de passer par `$this->view` et que dans la vue `$this` suffit.\n"
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:83
+#, no-wrap
+msgid "Working with GET / POST"
+msgstr "Accéder aux paramètres GET / POST"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:87
+msgid ""
+"It is often necessary to take advantage of parameters passed by GET or POST. "
+"In Minz, these parameters are accessible using the `Minz_Request` class.  "
+"Code example:"
+msgstr ""
+"Il est souvent nécessaire de profiter des paramètres passés par GET ou par "
+"POST. Dans Minz, ces paramètres sont accessibles de façon indistincts à "
+"l'aide de la classe `Minz_Request`. Exemple de code :"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:88
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"$default_value = 'foo';\n"
+"$param = Minz_Request::param('bar', $default_value);\n"
+"\n"
+"// Display the value of the parameter `bar` (passed via GET or POST)\n"
+"// or \"foo\" if the parameter does not exist.\n"
+"echo $param;\n"
+"\n"
+"// Sets the value of the `bar` parameter\n"
+"Minz_Request::_param('bar', 'baz');\n"
+"\n"
+"// Will necessarily display \"baz\" since we have just forced its value.\n"
+"// Note that the second parameter (default) is optional.\n"
+"echo Minz_Request::param('bar');\n"
+"\n"
+"?>\n"
+msgstr ""
+"<?php\n"
+"\n"
+"$default_value = 'foo';\n"
+"$param = Minz_Request::param('bar', $default_value);\n"
+"\n"
+"// Affichera la valeur du paramètre `bar` (passé via GET ou POST)\n"
+"// ou \"foo\" si le paramètre n'existe pas.\n"
+"echo $param;\n"
+"\n"
+"// Force la valeur du paramètre `bar`\n"
+"Minz_Request::_param('bar', 'baz');\n"
+"\n"
+"// Affichera forcément \"baz\" puisque nous venons de forcer sa valeur.\n"
+"// Notez que le second paramètre (valeur par défaut) est facultatif.\n"
+"echo Minz_Request::param('bar');\n"
+"\n"
+"?>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:109
+msgid ""
+"The `Minz_Request::isPost()` method can be used to execute a piece of code "
+"only if it is a POST request."
+msgstr ""
+"La méthode `Minz_Request::isPost()` peut être utile pour n'exécuter un "
+"morceau de code que s'il s'agit d'une requête POST."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:111
+msgid ""
+"Note: it is preferable to use `Minz_Request` only in controllers. It is "
+"likely that you will encounter this method in FreshRSS views, or even in "
+"templates, but be aware that this is **not** good practice."
+msgstr ""
+"Note : il est préférable de n'utiliser `Minz_Request` que dans les "
+"contrôleurs. Il est probable que vous rencontriez cette méthode dans les "
+"vues de FreshRSS, voire dans les modèles, mais sachez qu'il ne s'agit "
+"**pas** d'une bonne pratique."
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:112
+#, no-wrap
+msgid "Access session settings"
+msgstr "Accéder aux paramètres de session"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:115
+msgid ""
+"The access to session parameters is strangely similar to the GET / POST "
+"parameters but passes through the `Minz_Session` class this time! There is "
+"no example here because you can repeat the previous example by changing all "
+"`Minz_Request` to `Minz_Session`."
+msgstr ""
+"L'accès aux paramètres de session est étrangement similaire aux paramètres "
+"GET / POST mais passe par la classe `Minz_Session` cette fois-ci ! Il n'y a "
+"pas d'exemple ici car vous pouvez reprendre le précédent en changeant tous "
+"les `Minz_Request` par des `Minz_Session`."
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:116
+#, no-wrap
+msgid "Working with URLs"
+msgstr "Gestion des URL"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:119
+msgid ""
+"To take full advantage of the Minz routing system, it is strongly "
+"discouraged to write hard URLs in your code. For example, the following view "
+"should be avoided:"
+msgstr ""
+"Pour profiter pleinement du système de routage de Minz, il est fortement "
+"déconseillé d'écrire les URL en dur dans votre code. Par exemple, la vue "
+"suivante doit être évitée :"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:120
+#, no-wrap
+msgid ""
+"<p>\n"
+"\tGo to page <a href=\"http://example.com?c=hello&amp;a=world\">Hello world</a>!\n"
+"</p>\n"
+msgstr ""
+"<p>\n"
+"\tAccéder à la page <a href=\"http://exemple.com?c=hello&amp;a=world\">Hello world</a>!\n"
+"</p>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:127
+msgid ""
+"If one day it was decided to use a \"url rewriting\" system to have "
+"addresses in a http://exemple.com/controller/action format, all previous "
+"addresses would become ineffective!"
+msgstr ""
+"Si un jour il est décidé d'utiliser un système d'« url rewriting » pour "
+"avoir des adresses au format http://exemple.com/controller/action, toutes "
+"les adresses précédentes deviendraient ineffectives !"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:129
+msgid ""
+"So use the `Minz_Url` class and its `display()` method instead. `Minz_Url::"
+"display()` takes an array of the following form as its argument:"
+msgstr ""
+"Préférez donc l'utilisation de la classe `Minz_Url` et de sa méthode "
+"`display()`. `Minz_Url::display()` prend en paramètre un tableau de la forme "
+"suivante :"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:130
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"\t'params' => [\n"
+"\t\t'foo' => 'bar',\n"
+"\t],\n"
+"];\n"
+"\n"
+"// Show something like .?c=hello&amp;a=world&amp;foo=bar\n"
+"echo Minz_Url::display($url_array);\n"
+"\n"
+"?>\n"
+msgstr ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"\t'params' => [\n"
+"\t\t'foo' => 'bar',\n"
+"\t],\n"
+"];\n"
+"\n"
+"// Affichera quelque chose comme .?c=hello&amp;a=world&amp;foo=bar\n"
+"echo Minz_Url::display($url_array);\n"
+"\n"
+"?>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:148
+msgid ""
+"Since this can become a bit tedious to use in the long run, especially in "
+"views, it is preferable to use the `_url()` shortcut:"
+msgstr ""
+"Comme cela peut devenir un peu pénible à utiliser à la longue, surtout dans "
+"les vues, il est préférable d'utiliser le raccourci `_url()` :"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:149
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"// Displays the same as above\n"
+"echo _url('hello', 'world', 'foo', 'bar');\n"
+"\n"
+"?>\n"
+msgstr ""
+"<?php\n"
+"\n"
+"// Affichera la même chose que précédemment\n"
+"echo _url('hello', 'world', 'foo', 'bar');\n"
+"\n"
+"?>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:159
+msgid ""
+"Note: as a general rule, the shortened form (`_url()`) should be used in "
+"views, while the long form (`Minz_Url::display()`) should be used in "
+"controllers."
+msgstr ""
+"Note : en règle générale, la forme raccourcie (`_url()`) doit être utilisée "
+"dans les vues tandis que la forme longue (`Minz_Url::display()`) doit être "
+"utilisée dans les contrôleurs."
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:160
+#, no-wrap
+msgid "Redirections"
+msgstr "Redirections"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:163
+msgid ""
+"It is often necessary to redirect a user to another page. To do so, the "
+"`Minz_Request` class offers another useful method: `forward()`. This method "
+"takes the same URL format as the one seen just before as its argument."
+msgstr ""
+"Il est souvent nécessaire de rediriger un utilisateur vers une autre page. "
+"Pour cela, la classe `Minz_Request` dispose d'une autre méthode utile : "
+"`forward()`. Cette méthode prend en argument le même format d'URL que celui "
+"vu juste avant."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:166
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"];\n"
+"\n"
+"// Tells Minz to redirect the user to the hello / world page.\n"
+"// Note that this is a redirection in the Minz sense of the term, not a redirection that the browser will have to manage (HTTP code 301 or 302)\n"
+"// The code that follows forward() will thus be executed!\n"
+"Minz_Request::forward($url_array);\n"
+"\n"
+"// To perform a type 302 redirect, add \"true\".\n"
+"// The code that follows will never be executed.\n"
+"Minz_Request::forward($url_array, true);\n"
+"\n"
+"?>\n"
+msgstr ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"];\n"
+"\n"
+"// Indique à Minz de rediriger l'utilisateur vers la page hello/world.\n"
+"// Notez qu'il s'agit d'une redirection au sens Minz du terme, pas d'une redirection que le navigateur va avoir à gérer (code HTTP 301 ou 302)\n"
+"// Le code qui suit forward() va ainsi être exécuté !\n"
+"Minz_Request::forward($url_array);\n"
+"\n"
+"// Pour effectuer une redirection type 302, ajoutez \"true\".\n"
+"// Le code qui suivra ne sera alors jamais exécuté.\n"
+"Minz_Request::forward($url_array, true);\n"
+"\n"
+"?>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:187
+msgid ""
+"It is very common to want display a message to the user while performing a "
+"redirect, to tell the user how the action was carried out (validation of a "
+"form for example). Such a message is passed through a `notification` session "
+"variable (note: we will talk about feedback from now on to avoid confusion "
+"with a notification that can occur at any time). To facilitate this kind of "
+"very frequent action, there are two shortcuts that both perform a 302 "
+"redirect by assigning a feedback message:"
+msgstr ""
+"Il est très fréquent de vouloir effectuer une redirection tout en affichant "
+"un message à l'utilisateur pour lui indiquer comment s'est déroulée l'action "
+"effectuée juste avant (validation d'un formulaire par exemple). Un tel "
+"message est passé par une variable de session `notification` (note : nous "
+"parlerons plutôt de « feedback » désormais pour éviter la confusion avec une "
+"notification qui peut survenir à tout moment). Pour faciliter ce genre "
+"d'action très fréquente, il existe deux raccourcis qui effectuent tout deux "
+"une redirection type 302 en affectant un message de feedback :"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:188
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"];\n"
+"$feedback_good = 'All went well!';\n"
+"$feedback_bad = 'Oops, something went wrong.';\n"
+"\n"
+"Minz_Request::good($feedback_good, $url_array);\n"
+"\n"
+"// or\n"
+"\n"
+"Minz_Request::bad($feedback_bad, $url_array);\n"
+"\n"
+"?>\n"
+msgstr ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"];\n"
+"$feedback_good = 'Tout s\\'est bien passé !';\n"
+"$feedback_bad = 'Oups, quelque chose n\\'a pas marché.';\n"
+"\n"
+"Minz_Request::good($feedback_good, $url_array);\n"
+"\n"
+"// ou\n"
+"\n"
+"Minz_Request::bad($feedback_bad, $url_array);\n"
+"\n"
+"?>\n"
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:207
+#, no-wrap
+msgid "Translation Management"
+msgstr "Gestion de la traduction"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:210
+msgid ""
+"It is common (and that's an understatement) to want to show some text to the "
+"user. In the previous example, for example, we display feedback to the user "
+"based on the result of form validation. The problem is that FreshRSS has "
+"users of different nationalities. It is therefore necessary to be able to "
+"manage different languages in order not to remain confined to English or "
+"French."
+msgstr ""
+"Il est fréquent (et c'est un euphémisme) de vouloir afficher des phrases à "
+"l'utilisateur. Dans l'exemple précédent par exemple, nous affichions un "
+"feedback à l'utilisateur en fonction du résultat d'une validation de "
+"formulaire. Le problème est que FreshRSS possède des utilisateurs de "
+"différentes nationalités. Il est donc nécessaire de pouvoir gérer "
+"différentes langues pour ne pas rester cantonné à l'Anglais ou au Français."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:212
+msgid ""
+"The solution is to use the `Minz_Translate` class, which allows dynamic "
+"translation of FreshRSS (or any Minz-based application). Before using this "
+"module, it is necessary to know where to find the strings to be translated. "
+"Each language has its own subdirectory in a parent directory named `i18n`. "
+"For example, English language files are located in `i18n/fr/`. There are "
+"seven different files:"
+msgstr ""
+"La solution consiste à utiliser la classe `Minz_Translate` qui permet de "
+"traduire dynamiquement FreshRSS (ou toute application basée sur Minz). Avant "
+"d'utiliser ce module, il est nécessaire de savoir où trouver les chaînes de "
+"caractères à traduire. Chaque langue possède son propre sous-répertoire dans "
+"un répertoire parent nommé `i18n`. Par exemple, les fichiers de langue en "
+"Français sont situés dans `i18n/fr/`. Il existe sept fichiers différents :"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`admin.php` for anything related to FreshRSS administration"
+msgstr ""
+"`admin.php` pour tout ce qui est relatif à l'administration de FreshRSS ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`conf.php` for configuration"
+msgstr "`conf.php` pour l'aspect configuration ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`feedback.php` contains translations of feedback messages"
+msgstr "`feedback.php` contient les traductions des messages de feedback ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`gen.php` stores what is global to FreshRSS (gen for \"general\")"
+msgstr "`gen.php` stocke ce qui est global à FreshRSS (gen pour « general ») ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`index.php` for the main page that lists feeds and the About page"
+msgstr ""
+"`index.php` pour la page principale qui liste les flux et la page « À propos "
+"» ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`install.php` contains strings related FreshRSS installation"
+msgstr ""
+"`install.php` contient les phrases relatives à l'installation de FreshRSS ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`sub.php` for subscription management (sub for \"subscription\")"
+msgstr ""
+"`sub.php` pour l'aspect gestion des abonnements (sub pour « subscription »)."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:222
+msgid ""
+"This organization makes it possible to avoid a single huge translation file."
+msgstr ""
+"Cette organisation permet de ne pas avoir un unique énorme fichier de "
+"traduction."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:224
+msgid ""
+"The translation files are quite simple: it's only a matter of returning a "
+"PHP table containing the translations. As an example, here's an extract from "
+"`app/i18n/fr/gen.php`:"
+msgstr ""
+"Les fichiers de traduction sont assez simples : il s'agit seulement de "
+"retourner un tableau PHP contenant les traductions. Extrait du fichier `app/"
+"i18n/fr/gen.php` :"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:225
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"return array(\n"
+"\t'action' => [\n"
+"\t\t'actualize' => 'Actualiser',\n"
+"\t\t'back_to_rss_feeds' => '← Retour à vos flux RSS',\n"
+"\t\t'cancel' => 'Annuler',\n"
+"\t\t'create' => 'Créer',\n"
+"\t\t'disable' => 'Désactiver',\n"
+"\t),\n"
+"\t'freshrss' => array(\n"
+"\t\t'_' => 'FreshRSS',\n"
+"\t\t'about' => 'À propos de FreshRSS',\n"
+"\t),\n"
+"];\n"
+"\n"
+"?>\n"
+msgstr ""
+"<?php\n"
+"\n"
+"return array(\n"
+"\t'action' => [\n"
+"\t\t'actualize' => 'Actualiser',\n"
+"\t\t'back_to_rss_feeds' => '← Retour à vos flux RSS',\n"
+"\t\t'cancel' => 'Annuler',\n"
+"\t\t'create' => 'Créer',\n"
+"\t\t'disable' => 'Désactiver',\n"
+"\t),\n"
+"\t'freshrss' => array(\n"
+"\t\t'_' => 'FreshRSS',\n"
+"\t\t'about' => 'À propos de FreshRSS',\n"
+"\t),\n"
+"];\n"
+"\n"
+"?>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:247
+msgid ""
+"To access these translations, `Minz_Translate` will help us with its "
+"`Minz_Translate::t()` method. As this can be a bit long to type, a shortcut "
+"has been introduced that **must** be used in all circumstances: `_t()`.  "
+"Code example:"
+msgstr ""
+"Pour accéder à ces traductions, `Minz_Translate` va nous aider à l'aide de "
+"sa méthode `Minz_Translate::t()`. Comme cela peut être un peu long à taper, "
+"il a été introduit un raccourci qui **doit** être utilisé en toutes "
+"circonstances : `_t()`. Exemple de code :"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:248
+#, no-wrap
+msgid ""
+"<p>\n"
+"\t<a href=\"<?= _url('index', 'index') ?>\">\n"
+"\t\t<?= _t('gen.action.back_to_rss_feeds') ?>\n"
+"\t</a>\n"
+"</p>\n"
+msgstr ""
+"<p>\n"
+"\t<a href=\"<?= _url('index', 'index') ?>\">\n"
+"\t\t<?= _t('gen.action.back_to_rss_feeds') ?>\n"
+"\t</a>\n"
+"</p>\n"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:257
+msgid ""
+"The string to pass to the `_t()` function consists of a series of "
+"identifiers separated by dots. The first identifier indicates from which "
+"file to extract the translation (in this case, `gen.php`), while the "
+"following ones indicate table entries. Thus `action` is an entry of the main "
+"array and `back_to_rss_feeds` is an entry of the `action` array. This allows "
+"us to further organize our translation files."
+msgstr ""
+"La chaîne à passer à la fonction `_t()` consiste en une série d'identifiants "
+"séparés par des points. Le premier identifiant indique de quel fichier on "
+"veut extraire la traduction (dans notre cas présent, de `gen.php`), tandis "
+"que les suivantes indiquent des entrées de tableaux. Ainsi `action` est une "
+"entrée du tableau principal et `back_to_rss_feeds` est une entrée du tableau "
+"`action`. Cela permet d'organiser encore un peu plus nos fichiers de "
+"traduction."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:259
+msgid ""
+"There is a small special case that sometimes makes life easier: the `_` "
+"identifier. This must necessarily be present at the end of the chain and "
+"gives a value to the higher-level identifier. It's pretty hard to explain "
+"but very simple to understand. In the example given above, a `_` is "
+"associated with the value `FreshRSS`: this means that there is no need to "
+"write `_t('gen.freshrss._')` but `_t('gen.freshrss')` suffices."
+msgstr ""
+"Il existe un petit cas particulier qui permet parfois de se simplifier la "
+"vie : le cas de l'identifiant `_`. Celui-ci doit nécessairement être présent "
+"en bout de chaîne et permet de donner une valeur à l'identifiant de niveau "
+"supérieur. C'est assez dur à expliquer mais très simple à comprendre. Dans "
+"l'exemple donné plus haut, un `_` est associé à la valeur `FreshRSS` : cela "
+"signifie qu'il n'y a pas besoin d'écrire `_t('gen.freshrss._')` mais "
+"`_t('gen.freshrss')` suffit."
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:260
+#, no-wrap
+msgid "Configuration management"
+msgstr "Gestion de la configuration"
+
+#. type: Title ##
+#: en/./developers/03_Backend/05_Extensions.md:262
+#, no-wrap
+msgid "Write an extension for FreshRSS"
+msgstr "Écrire une extension pour FreshRSS"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:265
+msgid ""
+"Here we are! We've talked about the most useful features of Minz and how to "
+"run FreshRSS correctly and it's about time to address the extensions "
+"themselves."
+msgstr ""
+"Nous y voilà ! Nous avons abordé les fonctionnalités les plus utiles de Minz "
+"et qui permettent de faire tourner FreshRSS correctement et il est plus que "
+"temps d'aborder les extensions en elles-même."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:267
+msgid ""
+"An extension allows you to easily add functionality to FreshRSS without "
+"having to touch the core of the project directly."
+msgstr ""
+"Une extension permet donc d'ajouter des fonctionnalités facilement à "
+"FreshRSS sans avoir à toucher au cœur du projet directement."
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:268
+#, no-wrap
+msgid "Basic files and folders"
+msgstr "Les fichiers et répertoires de base"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:273
+msgid ""
+"The first thing to note is that **all** extensions **must** be located in "
+"the `extensions` directory, at the base of the FreshRSS tree.  An extension "
+"is a directory containing a set of mandatory (and optional) files and "
+"subdirectories.  The convention requires that the main directory name be "
+"preceded by an \"x\" to indicate that it is not an extension included by "
+"default in FreshRSS."
+msgstr ""
+"La première chose à noter est que **toutes** les extensions **doivent** se "
+"situer dans le répertoire `extensions`, à la base de l'arborescence de "
+"FreshRSS. Une extension est un répertoire contenant un ensemble de fichiers "
+"et sous-répertoires obligatoires ou facultatifs. La convention veut que l'on "
+"précède le nom du répertoire principal par un « x » pour indiquer qu'il ne "
+"s'agit pas d'une extension incluse par défaut dans FreshRSS."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:275
+msgid ""
+"The main directory of an extension must contain at least two **mandatory** "
+"files:"
+msgstr ""
+"Le répertoire principal d'une extension doit comporter au moins deux "
+"fichiers **obligatoire** :"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:278
+msgid ""
+"A `metadata.json` file that contains a description of the extension. This "
+"file is written in JSON."
+msgstr ""
+"Un fichier `metadata.json` qui contient une description de l'extension. Ce "
+"fichier est écrit en JSON ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:278
+msgid ""
+"An `extension.php` file containing the entry point of the extension (which "
+"is a class that inherits Minz_Extension)."
+msgstr "Un fichier `extension.php` contenant le point d'entrée de l'extension."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:282
+msgid ""
+"Please note that there is a not a required link between the directory name "
+"of the extension and the name of the class inside `extension.php`, but you "
+"should follow our best practice: If you want to write a `HelloWorld` "
+"extension, the directory name should be `xExtension-HelloWorld` and the base "
+"class name `HelloWorldExtension`."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:284
+msgid ""
+"In the file `freshrss/extensions/xExtension-HelloWorld/extension.php` you "
+"need the structure:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:284
+#, no-wrap
+msgid ""
+"class HelloWorldExtension extends Minz_Extension {\n"
+"\tpublic function init() {\n"
+"\t\t// your code here\n"
+"\t}\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:292
+msgid ""
+"There is an example HelloWorld extension that you can download from [our "
+"GitHub repo](https://github.com/FreshRSS/xExtension-HelloWorld)."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:294
+msgid ""
+"You may also need additional files or subdirectories depending on your needs:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid ""
+"`configure.phtml` is the file containing the form to parameterize your "
+"extension"
+msgstr ""
+"`configure.phtml` est le fichier contenant le formulaire pour paramétrer "
+"votre extension"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid ""
+"A `static/` directory containing CSS and JavaScript files that you will need "
+"for your extension (note that if you need to write a lot of CSS it may be "
+"more interesting to write a complete theme)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid "A `Controllers` directory containing additional controllers"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid "An `i18n` directory containing additional translations"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid ""
+"`layout` and` views` directories to define new views or to overwrite the "
+"current views"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:302
+msgid ""
+"In addition, it is good to have a `LICENSE` file indicating the license "
+"under which your extension is distributed and a` README` file giving a "
+"detailed description of it."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:303
+#, no-wrap
+msgid "The metadata.json file"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:306
+msgid ""
+"The `metadata.json` file defines your extension through a number of "
+"important elements. It must contain a valid JSON array containing the "
+"following entries:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid "`name`: the name of your extension"
+msgstr "`name` : le nom de votre extension ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid ""
+"`author`: your name, your e-mail address ... but there is no specific format "
+"to adopt"
+msgstr ""
+"`author` : votre nom, éventuellement votre adresse mail mais il n'y a pas de "
+"format spécifique à adopter ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid "`description`: a description of your extension"
+msgstr "`description` : une description de votre extension ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid "`version`: the current version number of the extension"
+msgstr "`version` : le numéro de version actuel de l'extension ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid ""
+"`entrypoint`: Indicates the entry point of your extension. It must match the "
+"name of the class contained in the file `extension.php` without the suffix` "
+"Extension` (so if the entry point is `HelloWorld`, your class will be "
+"called` HelloWorldExtension`)"
+msgstr ""
+"`entrypoint` : indique le point d'entrée de votre extension. Il doit "
+"correspondre au nom de la classe contenue dans le fichier `extension.php` "
+"sans le suffixe `Extension` (donc si le point d'entrée est `HelloWorld`, "
+"votre classe s'appellera `HelloWorldExtension`) ;"
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid ""
+"`type`: Defines the type of your extension. There are two types: `system` "
+"and` user`. We will study this difference right after."
+msgstr ""
+"`type` : définit le type de votre extension. Il existe deux types : `system` "
+"et `user`. Nous étudierons cette différence juste après."
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:315
+msgid "Only the `name` and` entrypoint` fields are required."
+msgstr "Seuls les champs `name` et `entrypoint` sont requis."
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:316
+#, no-wrap
+msgid "Choosing between `system` and `user`"
+msgstr "Choisir entre extension « system » ou « user »"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:319
+msgid ""
+"A __user__ extension can be enabled by some users and not by others "
+"(typically for user preferences)."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:321
+msgid "A __system__ extension in comparison is enabled for every account."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:322
+#, no-wrap
+msgid "Writing your own extension.php"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:327
+msgid ""
+"This file is the entry point of your extension. It must contain a specific "
+"class to function.  As mentioned above, the name of the class must be your "
+"`entrypoint` suffixed by` Extension` (`HelloWorldExtension` for example).  "
+"In addition, this class must be inherited from the `Minz_Extension` class to "
+"benefit from extensions-specific methods."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:329
+msgid "Your class will benefit from four methods to redefine:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:334
+msgid ""
+"`install()` is called when a user clicks the button to activate your "
+"extension. It allows, for example, to update the database of a user in order "
+"to make it compatible with the extension. It returns `true` if everything "
+"went well or, if not, a string explaining the problem."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:334
+msgid ""
+"`uninstall()` is called when a user clicks the button to disable your "
+"extension. This will allow you to undo the database changes you potentially "
+"made in `install ()`. It returns `true` if everything went well or, if not, "
+"a string explaining the problem."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:334
+msgid ""
+"`init()` is called for every page load *if the extension is enabled*. It "
+"will therefore initialize the behavior of the extension. This is the most "
+"important method."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:334
+msgid ""
+"`handleConfigureAction()` is called when a user loads the extension "
+"management panel. Specifically, it is called when the `?"
+"c=extension&a=configured&e=name-of-your-extension` URL is loaded. You should "
+"also write here the behavior you want when validating the form in your "
+"`configure.phtml` file."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:336
+msgid ""
+"In addition, you will have a number of methods directly inherited from "
+"`Minz_Extension` that you should not redefine:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:340
+msgid ""
+"The \"getters\" first: most are explicit enough not to detail them here - "
+"`getName()`, `getEntrypoint()`, `getPath()` (allows you to retrieve the path "
+"to your extension), `getAuthor()`, `getDescription()`, `getVersion()`, "
+"`getType()`."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:340
+msgid ""
+"`getFileUrl($filename, $type)` will return the URL to a file in the `static` "
+"directory. The first parameter is the name of the file (without `static /`), "
+"the second is the type of file to be used (`css` or` js`)."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:340
+msgid ""
+"`registerController($base_name)` will tell Minz to take into account the "
+"given controller in the routing system. The controller must be located in "
+"your `Controllers` directory, the name of the file must be` "
+"<base_name>Controller.php` and the name of the "
+"`FreshExtension_<base_name>_Controller` class."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:346
+msgid "`registerViews()`"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:346
+msgid "`registerTranslates()`"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:346
+msgid "`registerHook($hook_name, $hook_function)`"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:347
+#, no-wrap
+msgid "The \"hooks\" system"
+msgstr "Le système « hooks »"
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:350
+msgid ""
+"You can register at the FreshRSS event system in an extensions `init()` "
+"method, to manipulate data when some of the core functions are executed."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:351
+#, no-wrap
+msgid ""
+"class HelloWorldExtension extends Minz_Extension\n"
+"{\n"
+"\tpublic function init() {\n"
+"\t\t$this->registerHook('entry_before_display', array($this, 'renderEntry'));\n"
+"\t}\n"
+"\tpublic function renderEntry($entry) {\n"
+"\t\t$entry->_content('<h1>Hello World</h1>' . $entry->content());\n"
+"\t\treturn $entry;\n"
+"\t}\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:365
+msgid "The following events are available:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`entry_before_display` (`function($entry) -> Entry | null`): will be "
+"executed every time an entry is rendered. The entry itself (instance of "
+"FreshRSS\\_Entry) will be passed as parameter."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`entry_before_insert` (`function($entry) -> Entry | null`): will be executed "
+"when a feed is refreshed and new entries will be imported into the database. "
+"The new entry (instance of FreshRSS\\_Entry) will be passed as parameter."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`feed_before_insert` (`function($feed) -> Feed | null`): will be executed "
+"when a new feed is imported into the database. The new feed (instance of "
+"FreshRSS\\_Feed) will be passed as parameter."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`freshrss_init` (`function() -> none`): will be executed at the end of the "
+"initialization of FreshRSS, useful to initialize components or to do "
+"additional access checks"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`menu_admin_entry` (`function() -> string`): add an entry at the end of the "
+"\"Administration\" menu, the returned string must be valid HTML (e.g. `<li "
+"class=\"item active\"><a href=\"url\">New entry</a></li>`)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`menu_configuration_entry` (`function() -> string`): add an entry at the end "
+"of the \"Configuration\" menu, the returned string must be valid HTML (e.g. "
+"`<li class=\"item active\"><a href=\"url\">New entry</a></li>`)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`menu_other_entry` (`function() -> string`): add an entry at the end of the "
+"header dropdown menu (i.e. after the \"About\" entry), the returned string "
+"must be valid HTML (e.g. `<li class=\"item active\"><a href=\"url\">New "
+"entry</a></li>`)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`nav_reading_modes` (`function($reading_modes) -> array | null`): **TODO** "
+"add documentation"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid "`post_update` (`function(none) -> none`): **TODO** add documentation"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`simplepie_before_init` (`function($simplePie, $feed) -> none`): **TODO** "
+"add documentation"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:377
+#, no-wrap
+msgid "Writing your own configure.phtml"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:380
+msgid ""
+"When you want to support user configurations for your extension or simply "
+"display some information, you have to create the `configure.phtml` file."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/04_Frontend/01_View_files.md:1
+#, no-wrap
+msgid "The .phtml files"
+msgstr "Les fichiers .phtml"
+
+#. type: Title #
+#: en/./developers/04_Frontend/01_View_files.md:5
+#, no-wrap
+msgid "Writing a URL"
+msgstr "Écrire une URL"
+
+#. type: Title #
+#: en/./developers/04_Frontend/01_View_files.md:9
+#, no-wrap
+msgid "Displaying an icon"
+msgstr "Afficher une icône"
+
+#. type: Title #
+#: en/./developers/04_Frontend/02_Design.md:1
+#, no-wrap
+msgid "Template file"
+msgstr "Fichier modèle"
+
+#. type: Title #
+#: en/./developers/04_Frontend/02_Design.md:5
+#, no-wrap
+msgid "Writing a new theme"
+msgstr "Écrire un nouveau thème"
+
+#. type: Title #
+#: en/./developers/04_Frontend/02_Design.md:9
+#, no-wrap
+msgid "Overriding icons"
+msgstr "Surcharger les icônes"
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:1
+#, no-wrap
+msgid "Preparing the release"
+msgstr "Préparer la sortie"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:4
+msgid ""
+"In order to get as much feedback as possible before a release, it's "
+"preferable to announce it on GitHub by creating a dedicated ticket ([see "
+"examples] (https://github.com/FreshRSS/FreshRSS/search?utf8=%E2%9C%93&q=Call"
+"+for+testing&type=Issues)). This should be done **at least one week in "
+"advance**."
+msgstr ""
+"Afin d'avoir le plus de retour possible avant une sortie, il est préférable "
+"de l'annoncer sur GitHub en créant un ticket dédié ([voir les exemples]"
+"(https://github.com/FreshRSS/FreshRSS/search?utf8=%E2%9C%93&q=Call+for"
+"+testing&type=Issues)). Ceci est à faire **au moins une semaine à l'avance**."
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:6
+msgid "It's also recommended to make the announcement on mailing@freshrss.org."
+msgstr "Il est aussi recommandé de faire l'annonce sur mailing@freshrss.org."
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:7
+#, no-wrap
+msgid "Check the dev status"
+msgstr "S'assurer de l'état de dev"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:10
+msgid ""
+"Before releasing a new version of FreshRSS, you must ensure that the code is "
+"stable and free of major bugs. Ideally, our tests should be automated and "
+"executed before any publication."
+msgstr ""
+"Avant de sortir une nouvelle version de FreshRSS, il faut vous assurer que "
+"le code est stable et ne présente pas de bugs majeurs. Idéalement, il "
+"faudrait que nos tests soient automatisés et exécutés avant toute "
+"publication."
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:12
+msgid ""
+"You must also **make sure that the CHANGELOG file is up to date** in the dev "
+"branch with the updates of the version(s) to be released."
+msgstr ""
+"Il faut aussi **vous assurer que le fichier CHANGELOG est à jour** dans la "
+"branche de dev avec les mises à jour de la ou les version(s) à sortir."
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:13
+#, no-wrap
+msgid "Git process"
+msgstr "Processus Git"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:15
+#, no-wrap
+msgid ""
+"$ git checkout master\n"
+"$ git pull\n"
+"$ git merge --ff dev\n"
+"$ vim constants.php\n"
+"# Update version number x.y.y.z of FRESHRSS_VERSION\n"
+"$ git commit -a\n"
+"Version x.y.z\n"
+"$ git tag -a x.y.z\n"
+"Version x.y.z\n"
+"$ git push && git push --tags\n"
+msgstr ""
+"$ git checkout master\n"
+"$ git pull\n"
+"$ git merge --ff dev\n"
+"$ vim constants.php\n"
+"# Mettre à jour le numéro de version x.y.z de FRESHRSS_VERSION\n"
+"$ git commit -a\n"
+"Version x.y.z\n"
+"$ git tag -a x.y.z\n"
+"Version x.y.z\n"
+"$ git push && git push --tags\n"
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:28
+#, no-wrap
+msgid "Updating `update.freshrss.org`"
+msgstr "Mise à jour de update.freshrss.org"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:31
+msgid ""
+"It's important to update update.freshrss.org since this is the default "
+"service for automatic FreshRSS updates."
+msgstr ""
+"Il est important de mettre à jour update.freshrss.org puisqu'il s'agit du "
+"service par défaut gérant les mises à jour automatiques de FreshRSS."
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:33
+msgid ""
+"The repository managing the code is located on GitHub: [FreshRSS/update."
+"freshrss.org] (https://github.com/FreshRSS/update.freshrss.org/)."
+msgstr ""
+"Le dépot gérant le code se trouve sur GitHub : [FreshRSS/update.freshrss.org]"
+"(https://github.com/FreshRSS/update.freshrss.org/)."
+
+#. type: Title ##
+#: en/./developers/05_Release_new_version.md:34
+#, no-wrap
+msgid "Writing the update script"
+msgstr "Écriture du script de mise à jour"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:37
+msgid ""
+"The scripts are located in the `./scripts/` directory and must take the form "
+"`update_to_x.y.z.z.php`. This directory also contains `update_to_dev.php` "
+"intended for updates of the dev branch (this script must not include code "
+"specific to a particular version!) and `update_util.php`, which contains a "
+"list of functions useful for all scripts."
+msgstr ""
+"Les scripts se trouvent dans le répertoire `./scripts/` et doivent être de "
+"la forme `update_to_x.y.z.php`. On trouve aussi dans ce répertoire "
+"`update_to_dev.php` destiné aux mises à jour de la branche de dev (ce script "
+"ne doit pas inclure de code spécifique à une version particulière !) et "
+"`update_util.php` contenant une liste de fonctions utiles à tous les scripts."
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:39
+msgid ""
+"In order to write a new script, it's better to copy/paste the last version "
+"or to start from `update_to_dev.php`. The first thing to do is to define the "
+"URL from which the FreshRSS package will be downloaded (`PACKAGE_URL`). The "
+"URL is in the form of `https://codeload.github.com/FreshRSS/FreshRSS/zip/x.y."
+"z`."
+msgstr ""
+"Afin d'écrire un nouveau script, il est préférable de copier / coller celui "
+"de la dernière version ou de partir de `update_to_dev.php`. La première "
+"chose à faire est de définir l'URL à partir de laquelle sera téléchargée le "
+"package FreshRSS (`PACKAGE_URL`). L'URL est de la forme `https://codeload."
+"github.com/FreshRSS/FreshRSS/zip/x.y.z`."
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:41
+msgid "There are then 5 functions that have to be executed:"
+msgstr "Il existe ensuite 5 fonctions à remplir :"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`apply_update()` takes care of saving the directory containing the data, "
+"checking its structure, downloading the FreshRSS package, deploying it and "
+"cleaning it all up. This function is pre-filled but adjustments can be made "
+"if necessary (e.g., reorganization of the `./data` structure). It returns "
+"`true` if no problem has occurred or a string indicating a problem;"
+msgstr ""
+"`apply_update()` qui se charge de sauvegarder le répertoire contenant les "
+"données, de vérifier sa structure, de télécharger le package FreshRSS, de le "
+"déployer et de tout nettoyer. Cette fonction est pré-remplie mais des "
+"ajustements peuvent être faits si besoin est (ex. réorganisation de la "
+"structure de `./data`). Elle retourne `true` si aucun problème n'est survenu "
+"ou une chaîne de caractères indiquant un soucis ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`need_info_update()` returns `true` if the user must intervene during the "
+"update or `false` if not;"
+msgstr ""
+"`need_info_update()` retourne `true` si l'utilisateur doit intervenir durant "
+"la mise à jour ou `false` sinon ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`ask_info_update()` displays a form to the user if `need_info_update()` has "
+"returned `true`;"
+msgstr ""
+"`ask_info_update()` affiche un formulaire à l'utilisateur si "
+"`need_info_update()` a retourné `true` ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`save_info_update()` is responsible for saving the information filled out by "
+"the user (from the `ask_info_update()` form);"
+msgstr ""
+"`save_info_update()` est chargée de sauvegarder les informations renseignées "
+"par l'utilisateur (issues du formulaire de `ask_info_update()`) ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`do_post_update()` is executed at the end of the update and takes into "
+"account the code of the new version (e.g., if the new version changes the "
+"`Minz_Configuration` object, you will benefit from these improvements)."
+msgstr ""
+"`do_post_update()` est exécutée à la fin de la mise à jour et prend en "
+"compte le code de la nouvelle version (ex. si la nouvelle version modifie "
+"l'objet `Minz_Configuration`, vous bénéficierez de ces améliorations)."
+
+#. type: Title ##
+#: en/./developers/05_Release_new_version.md:48
+#, no-wrap
+msgid "Updating the versions file"
+msgstr "Mise à jour du fichier de versions"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:51
+msgid ""
+"Once the script has been written and versioned, it's necessary to update the "
+"`./versions.php' file which contains a mapping table indicating which "
+"versions are updated to which other versions."
+msgstr ""
+"Lorsque le script a été écrit et versionné, il est nécessaire de mettre à "
+"jour le fichier `./versions.php` qui contient une table de correspondances "
+"indiquant quelles versions sont mises à jour vers quelles autres versions."
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:53
+msgid "Here's an example of a `versions.php` file:"
+msgstr "Voici un exemple de fichier `versions.php` :"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:54
+#, no-wrap
+msgid ""
+"<?php\n"
+"return array(\n"
+"\t// STABLE\n"
+"\t'0.8.0' => '1.0.0',\n"
+"\t'0.8.1' => '1.0.0',\n"
+"\t'1.0.0' => '1.0.1',  // doesn't exist (yet)\n"
+"\t// DEV\n"
+"\t'1.1.2-dev' => 'dev',\n"
+"\t'1.1.3-dev' => 'dev',\n"
+"\t'1.1.4-dev' => 'dev',\n"
+");\n"
+msgstr ""
+"<?php\n"
+"return array(\n"
+"\t// STABLE\n"
+"\t'0.8.0' => '1.0.0',\n"
+"\t'0.8.1' => '1.0.0',\n"
+"\t'1.0.0' => '1.0.1',  // doesn't exist (yet)\n"
+"\t// DEV\n"
+"\t'1.1.2-dev' => 'dev',\n"
+"\t'1.1.3-dev' => 'dev',\n"
+"\t'1.1.4-dev' => 'dev',\n"
+");\n"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:69
+msgid "And here's how this table works:"
+msgstr "Et voici comment fonctionne cette table :"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid "on the left you can find the N version, on the right the N+1 version;"
+msgstr "à gauche se trouve la version N, à droite la version N+1 ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid "the `x.y.z.z-dev` versions are **all** updated to `dev`;"
+msgstr "les versions `x.y.z-dev` sont **toutes** mises à jour vers `dev` ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid "stable versions are updated to stable versions;"
+msgstr "les versions stables sont mises à jour vers des versions stables ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid ""
+"it's possible to skip several versions at once, provided that the update "
+"scripts support it;"
+msgstr ""
+"il est possible de sauter plusieurs versions d'un coup à condition que les "
+"scripts de mise à jour le prennent en charge ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid ""
+"it's advisable to indicate the correspondence of the current version to its "
+"potential future version by specifying that this version does not yet exist. "
+"As long as the corresponding script does not exist, nothing will happen."
+msgstr ""
+"il est conseillé d'indiquer la correspondance de la version courante vers sa "
+"potentielle future version en précisant que cette version n'existe pas "
+"encore. Tant que le script correspondant n'existera pas, rien ne se passera."
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:77
+msgid ""
+"It's **very strongly** recommended to keep this file organized according to "
+"version numbers by separating stable and dev versions."
+msgstr ""
+"Il est **très fortement** indiqué de garder ce fichier rangé selon les "
+"numéros de versions en séparant les versions stables et de dev."
+
+#. type: Title ##
+#: en/./developers/05_Release_new_version.md:78
+#, no-wrap
+msgid "Deployment"
+msgstr "Déploiement"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:81
+msgid ""
+"Before updating update.freshrss.org, it's better to test with dev.update."
+"freshrss.org, which corresponds to pre-production. So update dev.update."
+"freshrss.org and change the `FRESHRSS_UPDATE_WEBSITE` URL of your FreshRSS "
+"instance. Start the update and check that it's running correctly."
+msgstr ""
+"Avant de mettre à jour update.freshrss.org, il est préférable de tester avec "
+"dev.update.freshrss.org qui correspond à la pré-production. Mettez donc à "
+"jour dev.update.freshrss.org et changez l'URL `FRESHRSS_UPDATE_WEBSITE` de "
+"votre instance FreshRSS. Lancez la mise à jour et vérifiez que celle-ci se "
+"déroule correctement."
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:83
+msgid ""
+"When you're satisfied, update update.freshrss.org with the new script, test "
+"it again, and then move on."
+msgstr ""
+"Lorsque vous serez satisfait, mettez à jour update.freshrss.org avec le "
+"nouveau script et en testant de nouveau puis passez à la suite."
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:84
+#, no-wrap
+msgid "Updating the FreshRSS services"
+msgstr "Mise à jour des services FreshRSS"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:87
+msgid "Two services need to be updated immediately after the update."
+msgstr ""
+"Deux services sont à mettre à jour immédiatement après la mise à jour de "
+"update.freshrss.org :"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:90
+msgid "rss.freshrss.org;"
+msgstr "rss.freshrss.org ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:90
+msgid "demo.freshrss.org (public login: `demo` / `demodemo`)."
+msgstr "demo.freshrss.org (identifiants publics : `demo` / `demodemo`)."
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:91
+#, no-wrap
+msgid "Publicly announce the release"
+msgstr "Annoncer publiquement la sortie"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:94
+msgid ""
+"When everything's working, it's time to announce the release to the world!"
+msgstr ""
+"Lorsque tout fonctionne, il est temps d'annoncer la sortie au monde entier !"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:99
+msgid ""
+"on GitHub by creating[a new release](https://github.com/FreshRSS/FreshRSS/"
+"releases/new)"
+msgstr ""
+"sur GitHub en créant [une nouvelle release](https://github.com/FreshRSS/"
+"FreshRSS/releases/new) ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:99
+msgid ""
+"on the freshrss.org blog, at least for stable versions (write the article "
+"on[FreshRSS/freshrss.org](https://github.com/FreshRSS/freshrss.org))"
+msgstr ""
+"sur le blog de freshrss.org au minimum pour les versions stables (écrire "
+"l'article sur [FreshRSS/freshrss.org](https://github.com/FreshRSS/freshrss."
+"org))."
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:99
+msgid "on Twitter ([@FreshRSS](https://twitter.com/FreshRSS) account)"
+msgstr "sur Twitter (compte [@FreshRSS](https://twitter.com/FreshRSS)) ;"
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:99
+msgid "and on mailing@freshrss.org"
+msgstr "et sur mailing@freshrss.org ;"
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:100
+#, no-wrap
+msgid "Starting the next development version"
+msgstr "Lancer la prochaine version de développement"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:102
+#, no-wrap
+msgid ""
+"$ git checkout dev\n"
+"$ vim constants.php\n"
+"# Update the FRESHRSS_VERSION\n"
+"$ vim CHANGELOG.md\n"
+"# Prepare the changelog for the next version\n"
+"$ git add CHANGELOG.md && git commit && git push\n"
+msgstr ""
+"$ git checkout dev\n"
+"$ vim constants.php\n"
+"# Mettre à jour le numéro de version de FRESHRSS_VERSION\n"
+"$ vim CHANGELOG.md\n"
+"# Préparer la section pour la prochaine version\n"
+"$ git add CHANGELOG.md && git commit && git push\n"
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:111
+msgid ""
+"Also remember to update update.freshrss.org so that it takes the current "
+"development version into account."
+msgstr ""
+"Pensez aussi à mettre à jour update.freshrss.org pour qu'il prenne en compte "
+"la version de développement actuelle."
+
+#. type: Plain text
+#: en/./index.md:2
+msgid "![FreshRSS logo](img/logo_freshrss.png)"
+msgstr "![Logo de FreshRSS](img/logo_freshrss.png)"
+
+#. type: Plain text
+#: en/./index.md:4
+msgid ""
+"FreshRSS is an RSS aggregator and reader. It allows you to read and follow "
+"several news websites at a glance without the need to browse from one "
+"website to another."
+msgstr ""
+"FreshRSS est un agrégateur et lecteur de flux RSS. Il permet de regrouper "
+"l’actualité de plusieurs sites différents dans un endroit unique pour que "
+"vous puissiez la lire sans devoir aller de site en site."
+
+#. type: Plain text
+#: en/./index.md:6
+msgid "FreshRSS has a lot of features including:"
+msgstr ""
+"FreshRSS a été conçu comme un agrégateur puissant et propose des tas de "
+"fonctionnalités :"
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "RSS and Atom aggregation"
+msgstr "Agrégation des flux RSS et Atom."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid ""
+"Mark article as favorite if you liked it or if you want to read it later"
+msgstr ""
+"Utilisez les favoris pour marquer les articles qui vous ont plu ou que vous "
+"souhaitez lire plus tard."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Filter and search functionality helps to easily find articles"
+msgstr ""
+"Le système de filtrage et de recherche permettent de cibler exactement les "
+"articles que vous souhaitez lire."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid ""
+"Statistics to show you the publishing frequency all the websites you follow"
+msgstr ""
+"Les statistiques permettent de savoir en un coup d’œil quels sont les sites "
+"qui publient le plus, ou à l’inverse, le moins."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Import/export of your feeds into OPML format"
+msgstr "Importation / exportation des flux au format OPML."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Several themes created by the community"
+msgstr "Multi-thèmes pour changer l’habillage de FreshRSS."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "\"Google Reader\"-like API to connect Android applications"
+msgstr "API Google Reader pour pouvoir y brancher des applications Android."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid ""
+"The application is \"responsive,\" which means it adapts to small screens so "
+"you can bring articles in your pocket"
+msgstr ""
+"« *Responsive design* » : l’application s’adapte aux petits écrans pour "
+"emporter FreshRSS dans votre poche."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid ""
+"Self-hosted: the code is free (under AGPL3 licence), so you can host your "
+"own instance of FreshRSS"
+msgstr ""
+"Auto-hébergeable : le code source est libre (AGPL3) et vous pouvez donc "
+"l’héberger sur votre propre serveur."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Multi-user, so you can also host for your friends and family"
+msgstr ""
+"Multi-utilisateurs pour héberger plusieurs personnes sur une même "
+"installation."
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "And a lot more!"
+msgstr "Et bien d’autres !"
+
+#. type: Plain text
+#: en/./index.md:20
+msgid "This documentation is split into different sections:"
+msgstr "Cette documentation est divisée en plusieurs parties :"
+
+#. type: Bullet: '* '
+#: en/./index.md:24
+msgid ""
+"[User documentation](./users/02_First_steps.html), where you can discover "
+"all the possibilities offered by FreshRSS"
+msgstr ""
+"La [documentation utilisateurs](./users/02_First_steps.md) pour découvrir "
+"les fonctionnalités de FreshRSS."
+
+#. type: Bullet: '* '
+#: en/./index.md:24
+msgid ""
+"[Administrator documentation](./admins/01_Index.html) for detailed "
+"installation and maintenance related tasks"
+msgstr ""
+"La [documentation administrateurs](../en/admins/01_Installation.md) (en "
+"anglais) pour l’installation et la maintenance de FreshRSS."
+
+#. type: Bullet: '* '
+#: en/./index.md:24
+msgid ""
+"[Developer documentation](./developers/01_First_steps.html) to guide you in "
+"the source code of FreshRSS and to help you if you want to contribute"
+msgstr ""
+"La [documentation développeurs](./developers/01_First_steps.md) pour savoir "
+"comment contribuer et mieux comprendre le code source de FreshRSS."
+
+#. type: Bullet: '* '
+#: en/./index.md:24
+msgid ""
+"[Contributor guidelines](./contributing.md) for those who want to help "
+"improve FreshRSS"
+msgstr ""
+"Le [guide de contribution](./contributing.md) pour nous aider à développer "
+"FreshRSS."
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:2
+msgid ""
+"Learning how to handle a new application is not always easy. We've tried to "
+"make FreshRSS as intuitive as possible, but you might still need a little "
+"help to master the program."
+msgstr ""
+"Découvrir un nouveau logiciel n'est pas toujours facile. Si nous avons voulu "
+"FreshRSS le plus intuitif possible, vous aurez peut-être besoin d'un coup de "
+"main pour le maîtriser."
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:4
+msgid ""
+"This section will guide you to the pages you need to get started. The order "
+"is tailored to newcomers."
+msgstr ""
+"Cette section se propose de vous aider dans la prise en main de l'outil. Il "
+"ne s'agit que de liens menant vers les autres pages de la documentation mais "
+"ordonnées dans un ordre spécifique aux nouveaux arrivants."
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:6
+msgid ""
+"[After installing the application](../admins/03_Installation.md), the first "
+"step is to add some feeds. You have a few options:"
+msgstr ""
+"[Après l'installation](../../en/admins/03_Installation.md), la première "
+"chose à faire est d'ajouter un ou plusieurs sites à suivre. Pour cela "
+"plusieurs choix s'offrent à vous :"
+
+#. type: Bullet: '1. '
+#: en/./users/02_First_steps.md:10
+msgid "[Add a feed manually](04_Subscriptions.md#adding-a-feed)"
+msgstr "[Ajouter un flux manuellement](04_Subscriptions.md#ajouter-un-flux)"
+
+#. type: Bullet: '2. '
+#: en/./users/02_First_steps.md:10
+msgid "[Import an OPML or JSON file](04_Subscriptions.md#import-and-export)"
+msgstr ""
+"[Importer un fichier OPML ou JSON](04_Subscriptions.md#import-et-export)"
+
+#. type: Bullet: '3. '
+#: en/./users/02_First_steps.md:10
+msgid "[Use the bookmarklet](04_Subscriptions.md#use-bookmarklet)"
+msgstr "[Utiliser le bookmark dédié](04_Subscriptions.md#utiliser-le-bookmark)"
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:12
+msgid ""
+"Once you have added your feeds to FreshRSS, it is time to read them. There "
+"are three availalbe reading modes:"
+msgstr ""
+"Une fois que vous avez ajouté vos flux à FreshRSS, il est temps de les lire. "
+"Pour cela, trois modes de lecture s'offrent à vous :"
+
+#. type: Bullet: '1. '
+#: en/./users/02_First_steps.md:16
+msgid ""
+"[The normal view](03_Main_view.md#normal-view) enables you to quickly read "
+"new articles"
+msgstr ""
+"[La vue normale](03_Main_view.md#la-vue-normale) qui permet de voir et de "
+"lire rapidement les nouveaux articles"
+
+#. type: Bullet: '2. '
+#: en/./users/02_First_steps.md:16
+msgid ""
+"[The global view](03_Main_view.md#global-view) shows you an overview of the "
+"status of your feeds in one glance"
+msgstr ""
+"[La vue globale](03_Main_view.md#la-vue-globale) est destinée à vous offrir "
+"un panorama de l'état de vos flux"
+
+#. type: Bullet: '3. '
+#: en/./users/02_First_steps.md:16
+msgid ""
+"[The reader view](03_Main_view.md#reader-view) offers you a comfortable "
+"reading experience"
+msgstr ""
+"[La vue lecture](03_Main_view.md#la-vue-lecture) est pensée pour vous offrir "
+"un meilleur confort de lecture"
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:18
+msgid ""
+"Now that you've mastered basic use, it's time to configure FreshRSS to "
+"improve your reading experience. It's highly configurable, so it's "
+"recommended to play around with them to find a configuration that suits you "
+"well. Here are a few resources to help you improve your daily FreshRSS "
+"experience:"
+msgstr ""
+"Bien, vous maitrisez maintenant la vue que vous préférez ? Il est temps de "
+"vous offrir un peu plus de confort de lecture. FreshRSS est grandement "
+"configurable et c'est à vous de trouver la configuration qui vous conviendra "
+"le plus. Voici tout de même quelques pistes pour améliorer votre quotidien "
+"sur FreshRSS :"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid ""
+"[Organize your feeds in categories](04_Subscriptions.md#feed-management)"
+msgstr ""
+"[Rangez vos flux dans des catégories](04_Subscriptions."
+"md#organisation_des_flux)"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Change the home page](05_Configuration.md#changing-the-view)"
+msgstr ""
+"[Configurez votre page d'accueil](05_Configuration.md#personnaliser-la-vue)"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Choose the reading options](05_Configuration.md#reading-options)"
+msgstr ""
+"[Configurez vos options de lecture](05_Configuration.md#options-de-lecture)"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Refresh feeds](03_Main_view.md#refreshing-feeds)"
+msgstr "[Mettez à jour vos flux](03_Main_view.md#rafraichir-les-flux)"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid ""
+"[Filter articles](03_Main_view.md#filtering-articles) for a fast access to a "
+"selection"
+msgstr ""
+"[Filtrez les articles](03_Main_view.md#filtrer-les-articles) pour accéder "
+"rapidement à ceux que vous voulez lire en priorité"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid ""
+"[Search an article](03_Main_view.md#searching-articles) published some time "
+"ago"
+msgstr ""
+"[Retrouvez un article](03_Main_view.md#rechercher-des-articles) qui a été "
+"publié il y a quelques jours ou mois"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Access your feeds on a mobile device](06_Mobile_access.md)"
+msgstr "[Accédez à vos flux même sur mobile](06_Mobile_access.md)"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Add some extensions](https://github.com/FreshRSS/Extensions)"
+msgstr "[Ajoutez quelques extensions](https://github.com/FreshRSS/Extensions)"
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Frequently asked questions](07_Frequently_Asked_Questions.md)"
+msgstr "[Foire aux questions](07_Frequently_Asked_Questions.md)"
+
+#. type: Title #
+#: en/./users/03_Main_view.md:1
+#, no-wrap
+msgid "Normal view"
+msgstr "La vue normale"
+
+#. type: Title #
+#: en/./users/03_Main_view.md:5
+#, no-wrap
+msgid "Global view"
+msgstr "La vue globale"
+
+#. type: Title #
+#: en/./users/03_Main_view.md:9
+#, no-wrap
+msgid "Reader view"
+msgstr "La vue lecture"
+
+#. type: Title #
+#: en/./users/03_Main_view.md:13
+#, no-wrap
+msgid "Refreshing feeds"
+msgstr "Rafraîchir les flux"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:16
+msgid ""
+"To take full advantage of FreshRSS, it needs to retrieve new items from the "
+"feeds you have subscribed to. There are several ways to do this."
+msgstr ""
+"Pour profiter pleinement de FreshRSS, il faut qu’il récupère les nouveaux "
+"articles disponibles des flux auxquels vous avez souscrit. Pour cela, il "
+"existe plusieurs méthodes."
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:17
+#, no-wrap
+msgid "Automatic update"
+msgstr "Mise à jour automatique"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:20
+msgid ""
+"This is the recommended method since you can forget about it once it is "
+"configured."
+msgstr ""
+"C’est la méthode recommandée car il n’y a pas besoin d’y penser, elle se "
+"fait toute seule, à la fréquence que vous avez choisi."
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:21
+#, no-wrap
+msgid "With the actualize_script.php script"
+msgstr "Par le script actualize_script.php"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:24
+msgid ""
+"This method is only available if you have access to the scheduled tasks of "
+"the machine on which your FreshRSS instance is installed."
+msgstr ""
+"Cette méthode n’est possible que si vous avez accès aux tâches planifiées de "
+"la machine sur laquelle est installée votre instance de FreshRSS."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:26
+msgid ""
+"The script is named *actualize_script.php* and is located in the *app* "
+"folder. The scheduled task syntax will not be explained here. However, here "
+"is [a quick introduction to crontab](http://www.adminschoice.com/crontab-"
+"quick-reference/) that might help you."
+msgstr ""
+"Le script qui permet de mettre à jour les articles s’appelle "
+"*actualize_script.php* et se trouve dans le répertoire *app* de votre "
+"instance de FreshRSS. La syntaxe des tâches planifiées ne sera pas expliqué "
+"ici, cependant voici [une introduction rapide à crontab](http://www."
+"adminschoice.com/crontab-quick-reference/) qui peut vous aider."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:28
+msgid "Here is an example to trigger article update every hour."
+msgstr ""
+"Ci-dessous vous trouverez un exemple permettant la mise à jour des articles "
+"toutes les heures."
+
+#. type: Code fence info string
+#: en/./users/03_Main_view.md:29 en/./users/03_Main_view.md:61
+#: en/./users/03_Main_view.md:79 en/./users/03_Main_view.md:85
+#: en/./users/03_Main_view.md:93
+#, no-wrap
+msgid "cron"
+msgstr "cron"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:29
+#, no-wrap
+msgid "0 * * * * php /path/to/FreshRSS/app/actualize_script.php > /tmp/FreshRSS.log 2>&1\n"
+msgstr "0 * * * * php /chemin/vers/FreshRSS/app/actualize_script.php > /tmp/FreshRSS.log 2>&1\n"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:34
+msgid ""
+"Special parameters to configure the script - all parameters can be combined:"
+msgstr ""
+"« Paramètres de configuration du script; Ils sont utilisables "
+"simultanément : »"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:38
+msgid ""
+"- Parameter \"force\" https://freshrss.example.net/i/?"
+"c=feed&a=actualize&force=1 If *force* is set to 1 all feeds will be "
+"refreshed at once."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:42
+msgid ""
+"- Parameter \"ajax\" https://freshrss.example.net/i/?"
+"c=feed&a=actualize&ajax=1 Only a status site is returned and not a complete "
+"website. Example: \"OK\""
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:46
+msgid ""
+"- Parameter \"maxFeeds\" https://freshrss.example.net/i/?"
+"c=feed&a=actualize&maxFeeds=30 If *maxFeeds* is set the configured amount of "
+"feeds is refreshed at once. The default setting is \"10\"."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:50
+msgid ""
+"- Parameter \"token\" https://freshrss.example.net/i/?"
+"c=feed&a=actualize&token=542345872345734 Security parameter to prevent "
+"unauthorized refreshes. For detailed Documentation see \"Form authentication"
+"\"."
+msgstr ""
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:51
+#, no-wrap
+msgid "Online cron"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:54
+msgid ""
+"If you do not have access to the installation server scheduled task, you can "
+"still automate the update process."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:56
+msgid ""
+"To do so, you need to create a scheduled task, which need to call a specific "
+"URL: https://freshrss.example.net/i/?c=feed&a=actualize (it could be "
+"different depending on your installation). Depending on your application "
+"authentication method, you need to adapt the scheduled task."
+msgstr ""
+
+#. type: Title ####
+#: en/./users/03_Main_view.md:57
+#, no-wrap
+msgid "No authentication"
+msgstr "Aucune authentification"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:60
+msgid ""
+"This is the most straightforward since you have a public instance; there is "
+"nothing special to configure:"
+msgstr ""
+"C’est le cas le plus simple, puisque votre instance est publique, vous "
+"n’avez rien de particulier à préciser :"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:61
+#, no-wrap
+msgid "0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize'\n"
+msgstr "0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize'\n"
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:65
+#, no-wrap
+msgid "Form authentication"
+msgstr "Authentification par formulaire"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:68
+msgid ""
+"If you configure the application to allow anonymous reading, you can also "
+"allow anonymous users to update feeds (“Allow anonymous refresh of the "
+"articles”)."
+msgstr ""
+"Dans ces cas-là, si vous avez autorisé la lecture anonyme des articles, vous "
+"pouvez aussi permettre à n’importe qui de rafraîchir vos flux (« Autoriser "
+"le rafraîchissement anonyme des flux »)."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:70
+msgid "![Anonymous access configuration](../img/users/anonymous_access.1.png)"
+msgstr ""
+"![Configuration de l’accès anonymes](../img/users/anonymous_access.1.png)"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:72
+msgid ""
+"The URL used in the previous section will now become accessible to anyone. "
+"Therefore you can use the same syntax for the scheduled task."
+msgstr ""
+"L’url précédente devient donc accessible à n’importe qui et vous pouvez "
+"utiliser la tâche cron de la partie précédente."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:74
+msgid ""
+"You can also configure an authentication token to grant special access on "
+"the server."
+msgstr ""
+"Vous pouvez aussi configurer un jeton d’authentification pour accorder un "
+"droit spécial sur votre serveur."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:76
+msgid "![Token configuration](../img/users/token.1.png)"
+msgstr "![Configuration du token](../img/users/token.1.png)"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:78
+msgid "The scheduled task syntax should look as follows:"
+msgstr "La tâche cron à utiliser sera de la forme suivante :"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:79
+#, no-wrap
+msgid "0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&token=my-token'\n"
+msgstr "0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&token=mon-token'\n"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:84
+msgid ""
+"You can also target a different user by adding their username to the query "
+"string, with `&user=insert-username`:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:85
+#, no-wrap
+msgid "0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&user=someone&token=my-token'\n"
+msgstr "0 * * * * curl 'https://freshrss.exemple.net/i/?c=feed&a=actualize&user=quelquun&token=mon-token'\n"
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:89
+#, no-wrap
+msgid "HTTP authentication"
+msgstr "Authentification HTTP"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:92
+msgid ""
+"When using HTTP authentication, the syntax in the two previous sections is "
+"unusable. You'll need to provide your credentials to the scheduled task. "
+"**Note that this method is highly discouraged since it means that your "
+"credentials will be in plain sight!**"
+msgstr ""
+"Dans ce cas-là, le token et les permissions “anonymes” sont inutilisables et "
+"il vous sera nécessaire d’indiquer vos identifiants dans la tâche cron. "
+"**Notez que cette solution est grandement déconseillée puisqu’elle implique "
+"que vos identifiants seront visibles en clair !**"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:93
+#, no-wrap
+msgid "0 * * * * curl -u alice:password123 'https://freshrss.example.net/i/?c=feed&a=actualize'\n"
+msgstr "0 * * * * curl -u alice:motdepasse123 'https://freshrss.exemple.net/i/?c=feed&a=actualize'\n"
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:97
+#, no-wrap
+msgid "Manual update"
+msgstr "Mise à jour manuelle"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:100
+msgid ""
+"If you can't or don't want to use the automatic method, you can update "
+"manually. There are two methods for updating all or some of the feeds."
+msgstr ""
+"Si vous ne pouvez pas ou ne voulez pas utiliser la méthode automatique, vous "
+"pouvez le faire de façon manuelle. Il existe deux méthodes qui permettent de "
+"mettre à jour tout ou partie des flux."
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:101
+#, no-wrap
+msgid "Complete update"
+msgstr "Mise à jour complète"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:104
+msgid ""
+"This update occurs on all feeds. To trigger it, simply click on the update "
+"link in the navigation menu."
+msgstr ""
+"Cette mise à jour se fait pour l’ensemble des flux de l’instance. Pour "
+"initier cette mise à jour, il suffit de cliquer sur le lien de mise à jour "
+"disponible dans le menu de navigation."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:106
+msgid "![Navigation menu](../img/users/refresh.1.png)"
+msgstr "![Menu de navigation](../img/users/refresh.1.png)"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:108
+msgid ""
+"When the update starts, a progress bar appears and changes while feeds are "
+"processed."
+msgstr ""
+"Lorsque la mise à jour démarre, une barre de progression apparait et "
+"s’actualise au fur et à mesure de la récupération des articles."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:110
+msgid "![Progress bar](../img/users/refresh.5.png)"
+msgstr "![Barre de progression](../img/users/refresh.5.png)"
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:111
+#, no-wrap
+msgid "Partial update"
+msgstr "Mise à jour partielle"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:114
+msgid ""
+"This update occurs on the selected feed only. To trigger it, simply click on "
+"the update link in the feed menu."
+msgstr ""
+"Cette mise à jour se fait pour le flux sélectionné uniquement. Pour initier "
+"cette mise à jour, il suffit de cliquer sur le lien de mise à jour "
+"disponible dans le menu du flux."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:116
+msgid "![Feed menu](../img/users/refresh.2.png)"
+msgstr "![Menu du flux](../img/users/refresh.2.png)"
+
+#. type: Title #
+#: en/./users/03_Main_view.md:117
+#, no-wrap
+msgid "Filtering articles"
+msgstr "Filtrer les articles"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:120
+msgid ""
+"When the number of articles stored by FreshRSS inevitably grows larger, it's "
+"important to use efficient filters to display only a subset of the articles. "
+"There are several methods that filter with different criteria. Usually those "
+"methods can be combined."
+msgstr ""
+"Avec le nombre croissant d’articles stockés par FreshRSS, il devient "
+"important d’avoir des filtres efficaces pour n’afficher qu’une partie des "
+"articles. Il existe plusieurs méthodes qui filtrent selon des critères "
+"différents. Ces méthodes peuvent être combinées dans la plus part des cas."
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:121
+#, no-wrap
+msgid "By category"
+msgstr "Par catégorie"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:124
+msgid ""
+"This is the easiest method. You only need to click on the category title in "
+"the side panel. There are two special categories at the top of the panel:"
+msgstr ""
+"C’est la méthode la plus simple. Il suffit de cliquer sur le titre d’une "
+"catégorie dans le panneau latéral. Il existe deux catégories spéciales qui "
+"sont placées en haut dudit panneau :"
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:127
+msgid ""
+"*Main feed* displays only articles from feeds marked as available in that "
+"category"
+msgstr ""
+"*Flux principal* qui affiche uniquement les articles des flux marqués comme "
+"visible dans cette catégorie"
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:127
+msgid "*Favourites* displays only articles marked as favourites"
+msgstr ""
+"*Favoris* qui affiche uniquement les articles, tous flux confondus, marqués "
+"comme favoris"
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:128
+#, no-wrap
+msgid "By feed"
+msgstr "Par flux"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:131
+msgid "There are several methods to filter articles by feed:"
+msgstr "Il existe plusieurs méthodes pour filtrer les articles par flux :"
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:136
+msgid "by clicking the feed title in the side panel"
+msgstr "en cliquant sur le titre du flux dans le panneau latéral"
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:136
+msgid "by clicking the feed title in the article details"
+msgstr "en cliquant sur le titre du flux dans le détail de l’article"
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:136
+msgid "by filtering in the feed options from the side panel"
+msgstr "en filtrant dans les options du flux dans le panneau latéral"
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:136
+msgid "by filtering in the feed configuration"
+msgstr "en filtrant dans la configuration du flux"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:138
+msgid "![Feed filter](../img/users/feed.filter.1.png)"
+msgstr "![Filtrer par flux](../img/users/feed.filter.1.png)"
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:139
+#, no-wrap
+msgid "By status"
+msgstr "Par statut"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:142
+msgid ""
+"Each article has two attributes that can be combined. The first attribute "
+"indicates whether or not the article has been read. The second attribute "
+"indicates if the article was marked as favorite or not."
+msgstr ""
+"Chaque article possède deux attributs qui peuvent être combinés. Le premier "
+"attribut indique si l’article a été lu ou non. Le second attribut indique si "
+"l’article a été noté comme favori ou non."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:144
+msgid ""
+"In version 0.7, attribute filters are available in the article display "
+"dropdown list. With this version, it's not possible to combine filters. For "
+"instance, it's not possible to display only read and favorite articles."
+msgstr ""
+"Dans la version 0.7.x, les filtres sur les attributs sont accessibles depuis "
+"la liste déroulante qui gère l’affichage des articles. Dans cette version, "
+"il n’est pas possible de combiner les filtres. Par exemple, on ne peut pas "
+"afficher les articles lus qui ont été notés comme favori."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:146
+msgid "![Attribute filters in 0.7](../img/users/status.filter.0.7.png)"
+msgstr ""
+"![Filtrer par attribut en version 0.7](../img/users/status.filter.0.7.png)"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:148
+msgid ""
+"Starting with version 0.8, all attribute filters are visible as toggle "
+"icons. They can be combined. As any combination is possible, some have the "
+"same result. For instance, the result for all filters selected is the same "
+"as no filter selected."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:150
+msgid "![Attribute filters in 0.8](../img/users/status.filter.0.8.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:152
+msgid "By default, this filter displays only unread articles"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:153
+#, no-wrap
+msgid "By content"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:156
+msgid ""
+"It is possible to filter articles by their content by inputting a string in "
+"the search field."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:157
+#, no-wrap
+msgid "With the search field"
+msgstr "Grâce au champ de recherche"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:160
+msgid "You can use the search field to further refine results:"
+msgstr ""
+"Il est possible d’utiliser le champ de recherche pour raffiner les "
+"résultats :"
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by author: `author:name` or `author:'composed name'`"
+msgstr "par auteur : `author:nom` or `author:'nom composé'`"
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by title: `intitle:keyword` or `intitle:'composed keyword'`"
+msgstr "par titre : `intitle:mot` or `intitle:'mot composé'`"
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by URL: `inurl:keyword` or `inurl:'composed keyword'`"
+msgstr "par URL: `inurl:mot` or `inurl:'mot composé'`"
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by tag: `#tag`"
+msgstr "par tag: `#tag`"
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by free-text: `keyword` or `'composed keyword'`"
+msgstr "par texte libre : `mot` or `'mot composé'`"
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:199
+#, no-wrap
+msgid ""
+"* by date of discovery, using the [ISO 8601 time interval format](http://en.wikipedia.org/wiki/ISO_8601#Time_intervals): `date:<date-interval>`\n"
+"\t* From a specific day, or month, or year:\n"
+"\t\t* `date:2014-03-30`\n"
+"\t\t* `date:2014-03` or `date:201403`\n"
+"\t\t* `date:2014`\n"
+"\t* From a specific time of a given day:\n"
+"\t\t* `date:2014-05-30T13`\n"
+"\t\t* `date:2014-05-30T13:30`\n"
+"\t* Between two given dates:\n"
+"\t\t* `date:2014-02/2014-04`\n"
+"\t\t* `date:2014-02--2014-04`\n"
+"\t\t* `date:2014-02/04`\n"
+"\t\t* `date:2014-02-03/05`\n"
+"\t\t* `date:2014-02-03T22:00/22:15`\n"
+"\t\t* `date:2014-02-03T22:00/15`\n"
+"\t* After a given date:\n"
+"\t\t* `date:2014-03/`\n"
+"\t* Before a given date:\n"
+"\t\t* `date:/2014-03`\n"
+"\t* For a specific duration after a given date:\n"
+"\t\t* `date:2014-03/P1W`\n"
+"\t* For a specific duration before a given date:\n"
+"\t\t* `date:P1W/2014-05-25T23:59:59`\n"
+"\t* For the past duration before now (the trailing slash is optional):\n"
+"\t\t* `date:P1Y/` or `date:P1Y` (past year)\n"
+"\t\t* `date:P2M/` (past two months)\n"
+"\t\t* `date:P3W/` (past three weeks)\n"
+"\t\t* `date:P4D/` (past four days)\n"
+"\t\t* `date:PT5H/` (past five hours)\n"
+"\t\t* `date:PT30M/` (past thirty minutes)\n"
+"\t\t* `date:PT90S/` (past ninety seconds)\n"
+"\t\t* `date:P1DT1H/` (past one day and one hour)\n"
+"* by date of publication, using the same format: `pubdate:<date-interval>`\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:201
+msgid ""
+"Be careful not to enter a space between the operator and the search value."
+msgstr ""
+"Attention à ne pas introduire d’espace entre l’opérateur et la valeur "
+"recherchée."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:204
+msgid ""
+"Some operators can be used negatively, to exclude articles, with the same "
+"syntax as above, but prefixed by a `!` or `-`: `-author:name`, `-intitle:"
+"keyword`, `-inurl:keyword`, `-#tag`, `!keyword`."
+msgstr ""
+"Certains opérateurs peuvent être utilisé négativement, pour exclure des "
+"articles, avec la même syntaxe que ci-dessus, mais préfixé par `!` ou `-` :`-"
+"author:nom`, `-intitle:mot`, `-inurl:mot`, `-#tag`, `!mot`."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:206
+msgid ""
+"It is also possible to combine keywords to create a more precise filter. For "
+"example, you can enter multiple instances of `author:`, `intitle:`, `inurl:"
+"`, `#`, and free-text."
+msgstr ""
+"Il est également possible de combiner les mots-clefs pour faire un filtrage "
+"encore plus précis, et il est autorisé d’avoir plusieurs instances de : "
+"`author:`, `intitle:`, `inurl:`, `#`, et texte libre."
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:208
+msgid ""
+"Combining several search criteria implies a logical *and*, but the keyword ` "
+"OR ` can be used to combine several search criteria with a logical *or* "
+"instead: `author:Dupont OR author:Dupond`"
+msgstr ""
+"Combiner plusieurs critères implique un *et* logique, mais le mot clef ` OR "
+"` peut être utiliser pour combiner plusieurs critères avec un *ou* logique :"
+"`author:Dupont OR author:Dupond`"
+
+#. type: Title #
+#: en/./users/04_Subscriptions.md:1
+#, no-wrap
+msgid "Adding a feed"
+msgstr "Ajouter un flux"
+
+#. type: Title #
+#: en/./users/04_Subscriptions.md:5
+#, no-wrap
+msgid "Import and export"
+msgstr "Import et export"
+
+#. type: Title #
+#: en/./users/04_Subscriptions.md:9
+#, no-wrap
+msgid "Use bookmarklet"
+msgstr "Utiliser le « bookmarklet »"
+
+#. type: Plain text
+#: en/./users/04_Subscriptions.md:12
+msgid ""
+"Bookmarklets are little scripts that you can execute to perform various "
+"tasks. FreshRSS offers a bookmarklet for subscribing to newsfeeds."
+msgstr ""
+"Les « bookmarklets » sont de petits scripts que vous pouvez exécuter pour "
+"effectuer des tâches diverses et variées. FreshRSS offre un signet "
+"( « bookmark » ) pour s'abonner aux fils de nouvelles."
+
+#. type: Bullet: ' 1. '
+#: en/./users/04_Subscriptions.md:16
+msgid "Open \"Subscriptions management\"."
+msgstr "Ouvrez \"Gestion des abonnements\"."
+
+#. type: Bullet: ' 2. '
+#: en/./users/04_Subscriptions.md:16
+msgid "Click on \"Subscription tools\"."
+msgstr "Cliquez sur \"Outils d'abonnement\"."
+
+#. type: Bullet: ' 3. '
+#: en/./users/04_Subscriptions.md:16
+msgid ""
+"Drag the \"Subscribe\" button to your bookmark toolbar or right click and "
+"choose your browser's \"Bookmark link\" action."
+msgstr ""
+"Glissez le bouton \"S'abonner\" dans la barre d'outils des signets ou "
+"cliquez droit et choisissez l'action \"Lien vers les signets\" de votre "
+"navigateur."
+
+#. type: Title #
+#: en/./users/04_Subscriptions.md:17
+#, no-wrap
+msgid "Feed management"
+msgstr "Organisation des flux"
+
+#. type: Title #
+#: en/./users/05_Configuration.md:2
+#, no-wrap
+msgid "Display"
+msgstr "Personnaliser la vue"
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:4
+#, no-wrap
+msgid "Language"
+msgstr "Langue"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:9
+msgid ""
+"FreshRSS is currently available in 14 languages. After confirming your "
+"choice, the interface will be displayed in your preferred language.  "
+"Depending on the language chosen, parts of the interface may not be not "
+"translated yet. If you're willing to help translate the missing bits or "
+"would like to add a new language, please take a look at how you can "
+"[contribute to the project](../contributing.md#contribute-to-"
+"internationalization-i18n)."
+msgstr ""
+"À l'heure actuelle, FreshRSS est disponible en 13 langues. Après validation "
+"de ce choix, l'interface sera affichée dans la langue choisie, même si "
+"certaines parties de l'interface peuvent ne pas encore avoir été traduites. "
+"Si vous voulez aider à la traduction, regardez comment vous pouvez "
+"[contribuer au projet](../contributing.md#contribute-to-internationalization-"
+"i18n)."
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:11
+msgid ""
+"Some parts of FreshRSS aren't translated and aren't intended to be "
+"translated either. For now, this includes the logs visible in the "
+"application as well as the log generated by automatic update scripts."
+msgstr ""
+"Il y a des parties de FreshRSS qui ne sont pas traduites et qui n'ont pas "
+"vocation à l'être. Pour le moment, les logs visibles dans l'application "
+"ainsi que celle générées par le script de mise à jour automatique en font "
+"partie."
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:13
+msgid ""
+"Available languages are: cz, de, en, es, fr, he, it, kr, nl, oc, pt-br, ru, "
+"tr, zh-cn."
+msgstr ""
+"Les langues disponibles sont : cz, de, en, es, fr, he, it, kr, nl, oc, pt-"
+"br, ru, tr, zh-cn."
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:14
+#, no-wrap
+msgid "Theme"
+msgstr "Thème"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:17
+msgid ""
+"There's no accounting for tastes, which is why FreshRSS offers eight "
+"official themes:"
+msgstr ""
+"Les goûts et les couleurs, ça ne se discute pas. C'est pourquoi FreshRSS "
+"propose huit thèmes officiels :"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Blue Lagoon* by **Mister aiR**"
+msgstr "*Blue Lagoon* par **Mister aiR**"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Dark* by **AD**"
+msgstr "*Dark* par **AD**"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Flat design* by **Marien Fressinaud**"
+msgstr "*Flat design* par **Marien Fressinaud**"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Origine* by **Marien Fressinaud**"
+msgstr "*Origine* par **Marien Fressinaud**"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Origine-compact* by **Kevin Papst**"
+msgstr "*Origine-compact* par **Kevin Papst**"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Pafat* by **Plopoyop**"
+msgstr "*Pafat* par **Plopoyop**"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Screwdriver* by **Mister aiR**"
+msgstr "*Screwdriver* par **Mister aiR**"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Swage* by **Patrick Crandol**"
+msgstr "*Swage* par **Patrick Crandol**"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:28
+msgid ""
+"If you can't find any themes you like, it's always possible to [create your "
+"own](../developers/04_Frontend/02_Design.md)."
+msgstr ""
+"Si aucun de ceux proposés ne convient, il est toujours possible de [créer "
+"son propre thème](../developers/04_Frontend/02_Design.md)."
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:30
+msgid ""
+"To select a theme, simply scroll through the themes and select one that "
+"strikes your fancy. After confirmation, the theme will be applied to the "
+"interface."
+msgstr ""
+"Pour sélectionner un thème, il suffit de faire défiler les thèmes jusqu'à "
+"l'apparition du thème choisi. Après validation, le thème sera appliqué à "
+"l'interface."
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:31
+#, no-wrap
+msgid "Content width"
+msgstr "Largeur du contenu"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:34
+msgid ""
+"Some people prefer short lines of text, while others prefer to maximize the "
+"available screen space. To satisfy the maximum number of people, it's "
+"possible to customize the width of the displayed content. There are four "
+"settings available:"
+msgstr ""
+"Il y en a qui préfère des lignes de texte courtes, d'autres qui préfèrent "
+"maximiser l'espace disponible sur l'écran. Pour satisfaire le maximum de "
+"personne, il est possible de choisir la largeur du contenu affiché. Il y a "
+"quatre réglages disponibles :"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:39
+msgid "**Fine** displays content up to a maximum width of 550 pixels"
+msgstr "**Fine** qui affiche le contenu jusqu'à 550 pixels"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:39
+msgid "**Medium** displays content up to a maximum width of 800 pixels"
+msgstr "**Moyenne** qui affiche le contenu jusqu'à 800 pixels"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:39
+msgid "**Large** displays content up to a maximum width of 1000 pixels"
+msgstr "**Large** qui affiche le contenu jusqu'à 1000 pixels"
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:39
+msgid "**No limit** displays the content on 100% of the available space"
+msgstr ""
+"**Pas de limite** qui affiche le contenu sur 100% de la place disponible"
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:40
+#, no-wrap
+msgid "Article icons"
+msgstr "Icônes d'article"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:43
+msgid "Please note that this section only affects normal view."
+msgstr "Veuillez noter que cette section n'affecte que la vue normale."
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:45
+msgid ""
+"![Article icons configuration](../img/users/configuration.article.icons.png)"
+msgstr ""
+"![Configuration des icônes d'article](../img/users/configuration.article."
+"icons.png)"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:48
+msgid ""
+"Each article is rendered with a header (top line) and a footer (bottom "
+"line).  In that section, you can choose what will be displayed in those."
+msgstr ""
+"Chaque article est rendu avec un en-tête (ligne supérieure) et un pied de "
+"page (ligne inférieure). Dans cette section, vous pouvez choisir ce qui sera "
+"affiché dans ceux-ci."
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:52
+msgid ""
+"If you disable every item in the top line, you'll still be able to see it "
+"since it contains the feed name and the article title. But if you do the "
+"same thing for the bottom line, it will be empty."
+msgstr ""
+"Si vous désactivez tous les éléments de la ligne supérieure, vous pourrez "
+"toujours les voir, puisqu'il contient le nom du flux et le titre de "
+"l'article. Mais si vous faites le même chose pour la ligne inférieure, elle "
+"sera vide."
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:53
+#, no-wrap
+msgid "HTML5 notification timout"
+msgstr "Temps d'affichage de la notification HTML5"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:56
+msgid ""
+"After automatically updating the feeds, FreshRSS can pop up a notification "
+"using the HTML5 notification API."
+msgstr ""
+"Après la mise à jour automatique des flux, FreshRSS utilise l'API de "
+"notification de HTML5 pour avertir de l'arrivée de nouveaux articles."
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:58
+msgid ""
+"The duration of this notification can be set. By default, the value is 0."
+msgstr ""
+"Il est possible de régler la durée d'affichage de cette notification. Par "
+"défaut, la valeur est 0."
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:59
+#, no-wrap
+msgid "Show the navigation button"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:62
+msgid ""
+"By default, FreshRSS displays buttons to ease the article navigation when "
+"browsing on mobile. The drawback is that they eat up some precious space."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:64
+msgid ""
+"![navigation button configuration](../img/users/configuration.navigation."
+"button.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:66
+msgid ""
+"If you don't use those buttons because you never browse on mobile or because "
+"you browse with gestures, you can disable them from the interface."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:67
+#, no-wrap
+msgid "Reading"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:71 en/./users/05_Configuration.md:154
+#, no-wrap
+msgid "Archival"
+msgstr "Archivage"
+
+#. type: Title #
+#: en/./users/05_Configuration.md:75
+#, no-wrap
+msgid "Sharing"
+msgstr "Partage"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:78
+msgid ""
+"To make your life easier, you can share articles straight from FreshRSS."
+msgstr ""
+"Pour vous faciliter la vie, vous pouvez partager des articles directement "
+"via FreshRSS."
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:80
+msgid ""
+"At the moment, FreshRSS supports 18 sharing methods, ranging from self-"
+"hosted services (Shaarli, etc.) to proprietary services (Facebook, etc.)."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:83
+msgid ""
+"By default, the sharing list is empty.  ![Sharing configuration](../img/"
+"users/configuration.sharing.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:85
+msgid ""
+"To add a new item to the list, please follow the following simple steps:"
+msgstr ""
+"Pour ajouter un nouvel élément à la liste, veuillez suivre les étapes "
+"simples ci-dessous :"
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:90
+msgid "Select the desired sharing method in the drop-down list."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:90
+msgid "Press the ```✚``` button to add it to the list."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:90
+msgid ""
+"Configure the method in the list. All names can be modified in the display. "
+"Some methods need the sharing URL to be able to work properly (ex: Shaarli)."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:90 en/./users/05_Configuration.md:95
+msgid "Submit your changes."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:92
+msgid "To remove an item from the list, follow those simple steps:"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:95
+msgid "Press the ```❌``` button next to the share method you want to remove."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:96
+#, no-wrap
+msgid "Shortcuts"
+msgstr "Raccourcis"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:100
+msgid ""
+"To ease the use of the application, FreshRSS comes with a lot of predefined "
+"keyboard shortcuts.  They allow actions to improve the user experience with "
+"a keyboard."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:102
+msgid ""
+"Of course, if you're not satisfied with the key mapping, you can change you "
+"configuration to fit your needs."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:104
+msgid "There are 4 types of shortcuts:"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:109
+msgid "Views: they allow switching views with ease."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:109
+msgid ""
+"Navigation: they allow navigation through articles, feeds, and categories."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:109
+msgid ""
+"Article actions: they allow interactions with an article, like sharing or "
+"opening it on the original web-site."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:109
+msgid ""
+"Other actions: they allow other interactions with the application, like "
+"opening the user queries menu or accessing the documentation."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:112
+msgid ""
+"It's worth noting that the share article action has two levels. Once you "
+"press the shortcut, a menu containing all the share options opens.  To "
+"choose one share option, you need to select it by its number. When there is "
+"only one option, it's selected automatically though."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:114
+msgid "The same process applies to the user queries."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:117
+msgid ""
+"Be aware that there is no validation on the selected shortcuts.  This means "
+"that if you assign a shortcut to more than one action, you'll end up with "
+"some unexpected behavior."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:118
+#, no-wrap
+msgid "User queries"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:122
+msgid ""
+"You can configure your [user queries](./03_Main_view.md) in that section. "
+"There is not much to say here as it is pretty straightforward.  You can only "
+"change user query titles or drop them."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:124
+msgid "At the moment, there is no helper to build a user query from here."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:125
+#, no-wrap
+msgid "Users"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:129
+#, no-wrap
+msgid "Authentication methods"
+msgstr ""
+
+#. type: Title ###
+#: en/./users/05_Configuration.md:131
+#, no-wrap
+msgid "HTTP Authentication (Apache)"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:137
+msgid "User control is based on the `.htaccess` file."
+msgstr ""
+
+#. type: Bullet: ' 2. '
+#: en/./users/05_Configuration.md:137
+msgid ""
+"It is best practice to place the `.htaccess` file in the `./i/` subdirectory "
+"so the API and other third party services can work."
+msgstr ""
+
+#. type: Bullet: ' 3. '
+#: en/./users/05_Configuration.md:137
+msgid ""
+"If you want to limit all access to registered users only, place the file in "
+"the FreshRSS directory itself or in a parent directory. Note that WebSub and "
+"API will not work!"
+msgstr ""
+
+#. type: Bullet: ' 4. '
+#: en/./users/05_Configuration.md:137
+msgid "Example `.htaccess` file for a user \"marie\":"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:138
+#, no-wrap
+msgid ""
+"AuthUserFile /home/marie/repertoire/.htpasswd\n"
+"AuthGroupFile /dev/null\n"
+"AuthName \"Chez Marie\"\n"
+"AuthType Basic\n"
+"Require user marie\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:147
+msgid ""
+"More information can be found in the [Apache documentation](http://httpd."
+"apache.org/docs/trunk/howto/auth.html#gettingitworking)."
+msgstr ""
+"Plus d'informations dans [la documentation d'Apache.](http://httpd.apache."
+"org/docs/trunk/howto/auth.html#gettingitworking)"
+
+#. type: Title #
+#: en/./users/05_Configuration.md:148
+#, no-wrap
+msgid "Subscription management"
+msgstr "Gestion des flux"
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:150
+#, no-wrap
+msgid "Information"
+msgstr "Informations"
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:158
+#, no-wrap
+msgid "Login"
+msgstr "Identification"
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:162
+#, no-wrap
+msgid "Advanced"
+msgstr "Avancé"
+
+#. type: Title ###
+#: en/./users/05_Configuration.md:164
+#, no-wrap
+msgid "Retrieve a truncated stream from within FreshRSS"
+msgstr "Récupérer un flux tronqué à partir de FreshRSS"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:167
+msgid ""
+"This question comes up regularly, so we'll try to clarify how one can "
+"retrieve a truncated RSS feed with FreshRSS. Please note that the process is "
+"absolutely not user friendly, but it works. :)"
+msgstr ""
+"La question revient régulièrement, je vais essayer de clarifier ici comment "
+"on peut récupérer un flux RSS tronqué avec FreshRSS. Sachez avant tout que "
+"la manière de s'y prendre n'est absolument pas \"user friendly\", mais elle "
+"fonctionne. :)"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:169
+msgid ""
+"Please be aware that this way you'll generate much more traffic to the "
+"originating sites, and they might block you accordingly. FreshRSS "
+"performance is also negatively affected, because you'll have to fetch the "
+"full article content one by one. So it's a feature to use sparingly!"
+msgstr ""
+"Sachez aussi que par cette manière vous générez beaucoup plus de trafic vers "
+"les sites d'origines et qu'ils peuvent vous bloquer par conséquent. Les "
+"performances de FreshRSS sont aussi moins bonnes car vous devez alors aller "
+"chercher le contenu des articles un par un. C'est donc une fonctionnalité à "
+"utiliser avec parcimonie !"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:171
+msgid ""
+"What's meant by \"CSS path of articles on the original site\" actually "
+"corresponds to the \"path\" consisting of IDs and classes (which in HTML, "
+"matches the id and class attributes) to retrieve only the interesting part "
+"that corresponds to the article. Ideally, this path starts with an id (which "
+"is unique to the page)."
+msgstr ""
+"Ce que j'entends par \"Chemin CSS des articles sur le site d’origine\" "
+"correspond en fait au \"chemin\" constitué par les IDs et les classes (en "
+"html, correspond aux attributs id et class) pour récupérer uniquement la "
+"partie intéressante qui correspond à l'article. L'idéal est que ce chemin "
+"commence par un id (qui est unique pour la page)."
+
+#. type: Title ####
+#: en/./users/05_Configuration.md:172
+#, no-wrap
+msgid "Example: Rue89"
+msgstr "Exemple : Rue89"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:175
+msgid ""
+"To find this path, you have to go to the address of one of the truncated "
+"articles (for example, http://www.rue89.com/2013/10/15/prof-maths-jai-"
+"atteint-lextase-dihn-pedagogie-inversee-246635). You look have to look for "
+"the \"block\" of HTML that corresponds to article content (in the source "
+"code!)."
+msgstr ""
+"Pour trouver ce chemin, il faut se rendre à l'adresse d'un des articles "
+"tronqués (par exemple http://www.rue89.com/2013/10/15/prof-maths-jai-atteint-"
+"lextase-dihn-pedagogie-inversee-246635). Il faut alors chercher le \"bloc\" "
+"HTML correspondant au contenu de l'article (dans le code source !)"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:177
+#, no-wrap
+msgid "Here we find that the block that encompasses nothing but the content of the article is ```<div class=\"content clearfix\">```. We'll only use the `.content` class here. Nevertheless, as said above, it's best to start the path with an id. If we go back to the parent block, we find ```<div id=\"article\">``` and that's perfect! The path will be ```#article .content```.\n"
+msgstr "On trouve ici que le bloc qui englobe uniquement le contenu de l'article est ```<div class=\"content clearfix\">```. On ne va garder que la classe `.content` ici. Néanmoins, comme je le disais plus haut, il est préférable de commencer le chemin avec un id. Si on remonte au bloc parent, il s'agit du bloc ```<div id=\"article\">``` et c'est parfait ! Le chemin sera donc ```#article .content```.\n"
+
+#. type: Title ####
+#: en/./users/05_Configuration.md:178
+#, no-wrap
+msgid "Add the corresponding classes to the article CSS path on the feed configuration page. Examples:"
+msgstr "Liste de correspondances site → chemin css"
+
+#. type: Bullet: '*  '
+#: en/./users/05_Configuration.md:184
+msgid "Rue89: ```#article .content```"
+msgstr "Rue89 : ```#article .content```"
+
+#. type: Bullet: '*  '
+#: en/./users/05_Configuration.md:184
+msgid "PCINpact: ```#actu_content```"
+msgstr "PCINpact : ```#actu_content```"
+
+#. type: Bullet: '*  '
+#: en/./users/05_Configuration.md:184
+msgid "Lesnumériques: ```article#body div.text.clearfix```"
+msgstr "Lesnumériques : ```article#body div.text.clearfix```"
+
+#. type: Bullet: '*  '
+#: en/./users/05_Configuration.md:184
+msgid "Phoronix: ```#main .content```"
+msgstr "Phoronix : ```#main .content```"
+
+#. type: Title ###
+#: en/./users/05_Configuration.md:185
+#, no-wrap
+msgid "Retrieve a truncated stream with external tools"
+msgstr "Récupérer un flux tronqué à l'aide d'outils externes"
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:188
+msgid ""
+"Complimentary tools can be used to retrieve full article content, such as:"
+msgstr ""
+"Des outils complémentaires peuvent être utilisés pour récupérer le contenu "
+"complet d'un article, comme :"
+
+#. type: Bullet: '* '
+#: en/./users/05_Configuration.md:190
+msgid "[RSS-Bridge](https://github.com/RSS-Bridge/rss-bridge)"
+msgstr "[RSS-Bridge](https://github.com/RSS-Bridge/rss-bridge)"
+
+#. type: Bullet: '* '
+#: en/./users/05_Configuration.md:190
+msgid "[Full-Text RSS](https://bitbucket.org/fivefilters/full-text-rss)"
+msgstr "[Full-Text RSS](https://bitbucket.org/fivefilters/full-text-rss)"
+
+#. type: Title #
+#: en/./users/06_Fever_API.md:1
+#, no-wrap
+msgid "FreshRSS - Fever API implementation"
+msgstr "FreshRSS - API compatible Fever"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:5
+msgid ""
+"See the [page about our Google Reader compatible API](06_Mobile_access.md) "
+"for another possibility and general aspects of API access."
+msgstr ""
+"Voir la page [sur notre API compatible Google Reader](06_Mobile_access.md) "
+"pour une autre possibilité et des généralités sur l’accès par API."
+
+#. type: Title ##
+#: en/./users/06_Fever_API.md:6
+#, no-wrap
+msgid "RSS clients"
+msgstr "Clients compatibles"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:11
+msgid ""
+"There are many RSS clients that support the Fever API, but they seem to "
+"understand the Fever API a bit differently.  If your favourite client "
+"doesn't work properly with this API, please create an issue and we'll have a "
+"look.  But we can **only** do that for free clients."
+msgstr ""
+"De nombreux clients RSS prennent en charge l'API Fever, mais ils semblent "
+"comprendre l'API Fever un peu différemment. Si votre client préféré ne "
+"fonctionne pas correctement avec cette API, veuiller créer un ticket et nous "
+"y jetterons un oeil. Mais nous ne pouvons le faire que pour les clients "
+"gratuits."
+
+#. type: Title ###
+#: en/./users/06_Fever_API.md:12
+#, no-wrap
+msgid "Usage & Authentication"
+msgstr "Utilisation et authentification"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:16
+msgid ""
+"Before you can start using this API, you have to enable and setup API "
+"access, which is [documented here](https://freshrss.github.io/FreshRSS/en/"
+"users/06_Mobile_access.html), and then reset the user’s API password."
+msgstr ""
+"Avant de pouvoir commencer à utiliser cette API, vvous devez activer et "
+"configurer l'accès à l'API, qui est [documenté ici](https://freshrss.github."
+"io/FreshRSS/en/users/06_Mobile_access.html), et réinitialisez ensuite le mot "
+"de passe API de l'utilisateur."
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:18
+msgid ""
+"Then point your mobile application to the `fever.php` address (e.g. `https://"
+"freshrss.example.net/api/fever.php`)."
+msgstr ""
+"Connectez ensuite votre application mobile en utilisant l'adresse de l'API "
+"(e.g. `https://freshrss.example.net/api/fever.php`)."
+
+#. type: Title #
+#: en/./users/06_Fever_API.md:19 en/./users/06_Mobile_access.md:44
+#, no-wrap
+msgid "Compatible clients"
+msgstr "Clients compatibles"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:22
+msgid "Tested with:"
+msgstr "Testé avec :"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:25
+#, no-wrap
+msgid ""
+"* Android\n"
+"  * [Readably](https://play.google.com/store/apps/details?id=com.isaiasmatewos.readably) (Closed source)\n"
+msgstr ""
+"* Android\n"
+"  * [Readably](https://play.google.com/store/apps/details?id=com.isaiasmatewos.readably) (Propriétaire)\n"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:30
+#, no-wrap
+msgid ""
+"* iOS\n"
+"  * [Fiery Feeds](https://apps.apple.com/app/fiery-feeds-rss-reader/id1158763303) (Closed source)\n"
+"  * [Unread](https://apps.apple.com/app/unread-rss-reader/id1252376153) (Commercial)\n"
+"  * [Reeder](https://www.reederapp.com/) (Commercial) (Use its Google Reader API / native FreshRSS option when possible)\n"
+msgstr ""
+"* iOS\n"
+"  * [Fiery Feeds](https://apps.apple.com/app/fiery-feeds-rss-reader/id1158763303) (Propriétaire)\n"
+"  * [Unread](https://apps.apple.com/app/unread-rss-reader/id1252376153) (Commercial)\n"
+"  * [Reeder](https://www.reederapp.com/) (Commercial) (Connectez-vous plutôt par son option Google Reader API)\n"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:33
+#, no-wrap
+msgid ""
+"* MacOS\n"
+"  * [ReadKit](https://apps.apple.com/app/readkit/id588726889) (Commercial)\n"
+msgstr ""
+"* MacOS\n"
+"  * [ReadKit](https://apps.apple.com/app/readkit/id588726889) (Commercial)\n"
+
+#. type: Title ##
+#: en/./users/06_Fever_API.md:35
+#, no-wrap
+msgid "Features"
+msgstr "Fonctionnalités"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:38
+msgid "The following features are implemented:"
+msgstr "Les fonctionnalités suivantes sont implémentées :"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "fetching categories"
+msgstr "récupération des catégories"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "fetching feeds"
+msgstr "récupération des flux"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid ""
+"fetching RSS items (new, favorites, unread, by_id, by_feed, by_category, "
+"since)"
+msgstr ""
+"récupération des entrées (new, favorites, unread, by_id, by_feed, "
+"by_category,since)"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "fetching favicons"
+msgstr "récupération des favicons"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "setting read marker for item(s)"
+msgstr "marquage des entrées comme lues"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "setting starred marker for item(s)"
+msgstr "marquage des entrées comme favoris"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "setting read marker for feed"
+msgstr "marquage d'un flux comme lu"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "setting read marker for category"
+msgstr "marquage d'une catégorie comme lue"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "supports FreshRSS extensions, which use the `entry_before_display` hook"
+msgstr "support des extensions grace au hook `entry_before_display`"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:50
+msgid "The following features are not supported:"
+msgstr "Les fonctionnalités suivantes ne sont pas implémentées :"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:52
+msgid ""
+"**Hot Links** aka **hot** as there is nothing in FreshRSS yet that is "
+"similar or could be used to simulate it."
+msgstr ""
+"« Hot Links » car il n'y a encore rien dans FreshRSS qui soit similaire ou "
+"qui puisse être utilisé pour le simuler."
+
+#. type: Title ##
+#: en/./users/06_Fever_API.md:53
+#, no-wrap
+msgid "Testing and debugging"
+msgstr "Tester et déboguer"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:56
+msgid ""
+"If this API does not work as expected in your RSS reader, you can test it "
+"manually with a tool like [Postman](https://www.getpostman.com/)."
+msgstr ""
+"Si l'API ne fonctionne pas comme attendu dans votre lecteur, il est possible "
+"de la tester manuellement avec un outil tel que [Postman](https://www."
+"getpostman.com/)."
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:58
+msgid ""
+"Configure a POST request to the URL https://freshrss.example.net/api/fever."
+"php?api which should give you the result:"
+msgstr ""
+"Envoyer une requête POST à l'adresse https://freshrss.example.net/api/fever."
+"php?api devrait vous renvoyer le résultat suivant :"
+
+#. type: Code fence info string
+#: en/./users/06_Fever_API.md:58 en/./users/06_Fever_API.md:80
+#, no-wrap
+msgid "json"
+msgstr "json"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:58
+#, no-wrap
+msgid ""
+"{\n"
+"\t\"api_version\": 3,\n"
+"\t\"auth\": 0\n"
+"}\n"
+msgstr ""
+"{\n"
+"\t\"api_version\": 3,\n"
+"\t\"auth\": 0\n"
+"}\n"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:65
+msgid "Great, the base setup seems to work!"
+msgstr "Super, la configuration de base fonctionne !"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:68
+msgid ""
+"Now lets try an authenticated call. Fever uses an `api_key`, which is the "
+"MD5 hash of `\"$username:$apiPassword\"`.  Assuming the user is `kevin` and "
+"the password `freshrss`, here is a command-line example to compute the "
+"resulting `api_key`"
+msgstr ""
+"Maintenant essayons de faire un appel authentifié. Fever utilise un "
+"paramètre `api_key` qui contient le résultat de la fonction de hachage MD5 "
+"de la valeur `\"$username:$apiPassword\"`. En considérant que l'utilisateur "
+"est `kevin` et que son mot de passe est `freshrss`, voici la commande à "
+"lancer pour calculer la valeur du paramètre `api_key` :"
+
+#. type: Code fence info string
+#: en/./users/06_Fever_API.md:69 en/./users/06_Fever_API.md:75
+#: en/./users/06_Mobile_access.md:69
+#: en/./users/07_Frequently_Asked_Questions.md:37
+#: en/./users/07_Frequently_Asked_Questions.md:45
+#, no-wrap
+msgid "sh"
+msgstr "sh"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:69
+#, no-wrap
+msgid "api_key=`echo -n \"kevin:freshrss\" | md5sum | cut -d' ' -f1`\n"
+msgstr "api_key=`echo -n \"kevin:freshrss\" | md5sum | cut -d' ' -f1`\n"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:74
+msgid ""
+"Add a body to your POST request encoded as `form-data` and one key named "
+"`api_key` with the value `your-password-hash`:"
+msgstr ""
+"Ajoutez un contenu sous forme de `form-data`à votre requête POST ainsi que "
+"le paramètre `api_key` contenant la valeur calculée à l'étape précédente :"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:75
+#, no-wrap
+msgid "curl -s -F \"api_key=$api_key\" 'https://freshrss.example.net/api/fever.php?api'\n"
+msgstr "curl -s -F \"api_key=$api_key\" 'https://freshrss.exemple.net/api/fever.php?api'\n"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:80
+msgid "This should give:"
+msgstr "Vous devriez obtenir le résultat suivant :"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:80
+#, no-wrap
+msgid ""
+"{\n"
+"\t\"api_version\": 3,\n"
+"\t\"auth\": 1,\n"
+"\t\"last_refreshed_on_time\": \"1520013061\"\n"
+"}\n"
+msgstr ""
+"{\n"
+"\t\"api_version\": 3,\n"
+"\t\"auth\": 1,\n"
+"\t\"last_refreshed_on_time\": \"1520013061\"\n"
+"}\n"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:88
+msgid ""
+"Perfect, you're now authenticated and you can start testing the more "
+"advanced features. To do so, change the URL and append the possible API "
+"actions to your request parameters. Please refer to the [original Fever "
+"documentation](https://feedafever.com/api) for more information."
+msgstr ""
+"Parfait, maintenant vous êtes autentifié et vous pouvez commencer à tester "
+"les fonctions avancées. Pour cela, il suffit de changer l'adresse en lui "
+"ajoutant les paramètres nécessaires à la réalisation des actions supportées. "
+"Pour plus d'information, veuillez vous référer à la [documentation "
+"officielle de Fever](https://feedafever.com/api)."
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:90
+msgid "Some basic calls are:"
+msgstr "Voici quelques exemples simples d'appels réalisables :"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&items"
+msgstr "https://freshrss.example.net/api/fever.php?api&items"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&feeds"
+msgstr "https://freshrss.example.net/api/fever.php?api&feeds"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&groups"
+msgstr "https://freshrss.example.net/api/fever.php?api&groups"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&unread_item_ids"
+msgstr "https://freshrss.example.net/api/fever.php?api&unread_item_ids"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&saved_item_ids"
+msgstr "https://freshrss.example.net/api/fever.php?api&saved_item_ids"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&items&since_id=some_id"
+msgstr "https://freshrss.example.net/api/fever.php?api&items&since_id=some_id"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&items&max_id=some_id"
+msgstr "https://freshrss.example.net/api/fever.php?api&items&max_id=some_id"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid ""
+"https://freshrss.example.net/api/fever.php?api&mark=item&as=read&id=some_id"
+msgstr ""
+"https://freshrss.example.net/api/fever.php?api&mark=item&as=read&id=some_id"
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid ""
+"https://freshrss.example.net/api/fever.php?api&mark=item&as=unread&id=some_id"
+msgstr ""
+"https://freshrss.example.net/api/fever.php?api&mark=item&as=unread&id=some_id"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:102
+msgid ""
+"Replace `some_id` with a real ID from your `freshrss_username_entry` "
+"database."
+msgstr ""
+"Remplacez `some_id` par un identifiant réel de votre base de données "
+"`freshrss_username_entry`."
+
+#. type: Title ###
+#: en/./users/06_Fever_API.md:103
+#, no-wrap
+msgid "Debugging"
+msgstr "Déboguer"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:106
+msgid ""
+"If nothing helps and your client is still misbehaving, you can add the "
+"following lines to the beginning of the `fever.api` file to determine the "
+"cause of the problems:"
+msgstr ""
+"Si rien ne fonctionne correctement et que votre client se comporte "
+"étrangement, vous pouvez ajouter les quelques lignes suivantes au début du "
+"fichier `fever.api` pour déterminer la cause des problèmes rencontrés :"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:107
+#, no-wrap
+msgid "file_put_contents(__DIR__ . '/fever.log', $_SERVER['HTTP_USER_AGENT'] . ': ' . json_encode($_REQUEST) . PHP_EOL, FILE_APPEND);\n"
+msgstr "file_put_contents(__DIR__ . '/fever.log', $_SERVER['HTTP_USER_AGENT'] . ': ' . json_encode($_REQUEST) . PHP_EOL, FILE_APPEND);\n"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:112
+msgid ""
+"Then use your RSS client to query the API and afterwards check the file "
+"`fever.log`."
+msgstr ""
+"Utilisez ensuite votre client RSS pour interroger l'API et vérifier le "
+"fichier `fever.log`."
+
+#. type: Title ##
+#: en/./users/06_Fever_API.md:113
+#, no-wrap
+msgid "Credits"
+msgstr "Remerciements"
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:115
+msgid ""
+"This plugin was inspired by the [tinytinyrss-fever-plugin](https://github."
+"com/dasmurphy/tinytinyrss-fever-plugin)."
+msgstr ""
+"Ce plugin a été inspiré par le [tinytinyrss-fever-plugin](https://github.com/"
+"dasmurphy/tinytinyrss-fever-plugin)."
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:2
+msgid ""
+"This page assumes you have completed the [server setup](../"
+"admins/02_Installation.md)."
+msgstr ""
+"Cette page suppose que vous ayez fini [l’installation du serveur]"
+"(01_Installation.md)."
+
+#. type: Title #
+#: en/./users/06_Mobile_access.md:3
+#, no-wrap
+msgid "Enable the API in FreshRSS"
+msgstr "Activer l’API dans FreshRSS"
+
+#. type: Bullet: '1. '
+#: en/./users/06_Mobile_access.md:9
+msgid ""
+"Under the section “Authentication”, enable the option “Allow API access "
+"(required for mobile apps)”."
+msgstr ""
+"Dans la section “Authentification”, cocher l’option “Autoriser l’accès par "
+"API (nécessaire pour les applis mobiles)”."
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:9
+#, no-wrap
+msgid ""
+"2. Under the section “Profile”, fill-in the field “API password (e.g., for mobile apps)”.\n"
+"\t* Every user must define an API password.\n"
+"\t* The reason for an API-specific password is that it may be used in less safe situations than the main password, and does not grant access to as many things.\n"
+msgstr ""
+"2. Dans la section “Profil”, remplir le champ “Mot de passe API (ex. : pour applis mobiles)”.\n"
+"\t* Chaque utilisateur doit choisir son mot de passe API.\n"
+"\t* La raison d’être d’un mot de passe API\n"
+" différent du mot de passe principal est que le mot de passe API est potentiellement utilisé de manière moins sûre, mais il permet aussi moins de choses.\n"
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:12
+msgid ""
+"The rest of this page is about the Google Reader compatible API.  See the "
+"[page about the Fever compatible API](06_Fever_API.md) for another "
+"possibility."
+msgstr ""
+"Le reste de cette page concerne l’API compatible Google Reader. Voir la "
+"[page sur l’API compatible Fever](06_Fever_API.md) pour une autre "
+"possibilité."
+
+#. type: Title #
+#: en/./users/06_Mobile_access.md:14
+#, no-wrap
+msgid "Testing"
+msgstr "Tester"
+
+#. type: Bullet: '3. '
+#: en/./users/06_Mobile_access.md:21
+msgid ""
+"Under the section “Profile”, click on the link like `https://rss.example.net/"
+"api/` next to the field “API password”."
+msgstr ""
+"Dans la section “Profil”, cliquer sur le lien de la forme `https://rss."
+"example.net/api/` à côté du champ “Mot de passe API”."
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:21
+#, no-wrap
+msgid ""
+"4. Click on first link “Check full server configuration”:\n"
+"\t* If you get *PASS* then you are done, all is good: you may proceed to step 6.\n"
+"\t* If you get *Bad Request!* or *Not Found*, then your server probably does not accept slashes `/` that are escaped `%2F`. Proceed to step 5.\n"
+"\t* If you get any other error message, proceed to step 5.\n"
+msgstr ""
+"4. Cliquer sur le premier lien “Check full server configuration”:\n"
+"\t* Si vous obtenez `PASS`, tout est bon : passer à l’étape 6.\n"
+"\t* Si vous obtenez *Bad Request!* ou *Not Found*, alors votre serveur ne semble pas accepter les slashs `/` qui sont encodés `%2F`. Passer à l’étape 5.\n"
+"\t* Si vous obtenez un autre message d’erreur, passer à l’étape 5.\n"
+
+#. type: Title #
+#: en/./users/06_Mobile_access.md:23
+#, no-wrap
+msgid "Fix server configuration"
+msgstr "Déboguer la configuration du serveur"
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:42
+#, no-wrap
+msgid ""
+"5. Click on the second link “Check partial server configuration (without `%2F` support)”:\n"
+"\t* If you get `PASS`, then the problem is indeed that your server does not accept slashes `/` that are escaped `%2F`.\n"
+"\t\t* With Apache, remember the directive [`AllowEncodedSlashes On`](http://httpd.apache.org/docs/trunk/mod/core.html#allowencodedslashes)\n"
+"\t\t* Or use a client that does not escape slashes (such as EasyRSS), in which case proceed to step 6.\n"
+"\t* If you get *Service Unavailable!*, then check from step 1 again.\n"
+"\t* With __Apache__:\n"
+"\t\t* If you get *FAIL getallheaders!*, the combination of your PHP version and your Web server does not provide access to [`getallheaders`](http://php.net/getallheaders)\n"
+"\t\t\t* Turn on Apache `mod_setenvif` (often enabled by default), or `mod_rewrite` with the following procedure:\n"
+"\t\t\t\t* Allow [`FileInfo` in `.htaccess`](http://httpd.apache.org/docs/trunk/mod/core.html#allowoverride): see the [server setup](../admins/02_Installation.md) again.\n"
+"\t\t\t\t* Enable [`mod_rewrite`](http://httpd.apache.org/docs/trunk/mod/mod_rewrite.html):\n"
+"\t\t\t\t\t* With Debian / Ubuntu: `sudo a2enmod rewrite`\n"
+"\t* With __nginx__:\n"
+"\t\t* If you get *Bad Request!*, check your server `PATH_INFO` configuration.\n"
+"\t\t* If you get *File not found!*, check your server `fastcgi_split_path_info`.\n"
+"\t* If you get *FAIL 64-bit or GMP extension!*, then your PHP version does not pass the requirement of being 64-bit and/or have PHP [GMP](http://php.net/gmp) extension.\n"
+"\t\t* The easiest is to add the GMP extension. On Debian / Ubuntu: `sudo apt install php-gmp`\n"
+"\t* Update and try again from step 3.\n"
+msgstr ""
+"5. Cliquer sur le second lien “Check partial server configuration (without `%2F` support)”:\n"
+"\t* Si vous obtenez `PASS`, alors le problème est bien que votre serveur n’accepte pas les slashs `/` qui sont encodés `%2F`.\n"
+"\t\t* Avec Apache, vérifiez la directive [`AllowEncodedSlashes On`](http://httpd.apache.org/docs/trunk/mod/core.html#allowencodedslashes)\n"
+"\t\t* Ou utilisez un client qui n’encode pas les slashs (comme EasyRSS), auquel cas passer à l’étape 6.\n"
+"\t* Si vous obtenez *Service Unavailable!*, retourner à l’étape 6.\n"
+"\t* Avec __Apache__:\n"
+"\t\t* Si vous obtenez *FAIL getallheaders!*, alors la combinaison de votre version de PHP et de votre serveur Web ne permet pas l’accès à [`getallheaders`](http://php.net/getallheaders)\n"
+"\t\t\t* Activer Apache `mod_setenvif` (souvent activé par défault), ou `mod_rewrite` avec la procédure suivante :\n"
+"\t\t\t\t* Autoriser [`FileInfo` dans `.htaccess`](http://httpd.apache.org/docs/trunk/mod/core.html#allowoverride) : revoir [l’installation du serveur](01_Installation.md).\n"
+"\t\t\t\t* Activer [`mod_rewrite`](http://httpd.apache.org/docs/trunk/mod/mod_rewrite.html) :\n"
+"\t\t\t\t\t* Sur Debian / Ubuntu : `sudo a2enmod rewrite`\n"
+"\t* Avec __nginx__:\n"
+"\t\t* Si vous obtenez *Bad Request!*, vérifier la configuration `PATH_INFO` de votre serveur.\n"
+"\t\t* Si vous obtenez *File not found!*, vérifier la configuration `fastcgi_split_path_info` de votre serveur.\n"
+"\t* Si vous obtenez *FAIL 64-bit or GMP extension!*, alors votre installation PHP soit n’est pas en 64 bit, soit n’a pas l’extension PHP [GMP](http://php.net/gmp) activée.\n"
+"\t\t* Le plus simple est d’activer l’extension GMP. Sur Debian / Ubuntu : `sudo apt install php-gmp`\n"
+"\t* Mettre à jour et retourner à l’étape 3.\n"
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:48
+#, no-wrap
+msgid ""
+"6. On the same FreshRSS API page, note the address given under “Your API address”, like `https://freshrss.example.net/api/greader.php`\n"
+"\t* Type the API address in a client, together with your FreshRSS username, and the corresponding special API password.\n"
+msgstr ""
+"6. Sur la même page de l'API FreshRSS, notez l'adresse donnée sous \"Votre adresse API\", comme `https://freshrss.example.net/api/greader.php`\n"
+"\t* Saisissez l'adresse de l'API dans le client sélectionné puis votre nom d'utilisateur et votre mot de passe spécialement créé pour l'API.\n"
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:63
+#, no-wrap
+msgid ""
+"7. Pick a client supporting a Google Reader-like API. Selection:\n"
+"\t* Android\n"
+"\t\t* [News+](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus) with [News+ Google Reader extension](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus.extension.google_reader) (Closed source)\n"
+"\t\t* [FeedMe 3.5.3+](https://play.google.com/store/apps/details?id=com.seazon.feedme) (Closed source)\n"
+"\t\t* [EasyRSS](https://github.com/Alkarex/EasyRSS) (Open source, [F-Droid](https://f-droid.org/packages/org.freshrss.easyrss/))\n"
+"\t* Linux\n"
+"\t\t* [FeedReader 2.0+](https://jangernert.github.io/FeedReader/) (Open source)\n"
+"\t* MacOS\n"
+"\t\t* [Vienna RSS](http://www.vienna-rss.com/) (Open source)\n"
+"\t\t* [Reeder](https://www.reederapp.com/) (Commercial)\n"
+"\t* iOS\n"
+"\t\t* [Reeder](https://www.reederapp.com/) (Commercial)\n"
+"\t* Firefox\n"
+"\t\t* [FreshRSS-Notify](https://addons.mozilla.org/firefox/addon/freshrss-notify-webextension/) (Open source)\n"
+msgstr ""
+"7. Vous pouvez maintenant tester sur une application mobile:\n"
+"\t* Android\n"
+"\t\t* [News+](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus) avec [News+ Google Reader extension](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus.extension.google_reader) (Closed source)\n"
+"\t\t* [FeedMe 3.5.3+](https://play.google.com/store/apps/details?id=com.seazon.feedme) (Propriétaire)\n"
+"\t\t* [EasyRSS](https://github.com/Alkarex/EasyRSS) (Libre, [F-Droid](https://f-droid.org/packages/org.freshrss.easyrss/))\n"
+"\t* Linux\n"
+"\t\t* [FeedReader 2.0+](https://jangernert.github.io/FeedReader/) (Libre)\n"
+"\t* MacOS\n"
+"\t\t* [Vienna RSS](http://www.vienna-rss.com/) (Libre)\n"
+"\t\t* [Reeder](https://www.reederapp.com/) (Commercial)\n"
+"\t* iOS\n"
+"\t\t* [Reeder](https://www.reederapp.com/) (Commercial)\n"
+"\t* Firefox\n"
+"\t\t* [FreshRSS-Notify](https://addons.mozilla.org/firefox/addon/freshrss-notify-webextension/) (Libre)\n"
+
+#. type: Title #
+#: en/./users/06_Mobile_access.md:65
+#, no-wrap
+msgid "Google Reader compatible API"
+msgstr "API compatible Google Reader"
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:68
+msgid "Examples of basic queries:"
+msgstr "Exemples de requêtes simples :"
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:69
+#, no-wrap
+msgid ""
+"# Initial login, using API password (Email and Passwd can be given either as GET, or POST - better)\n"
+"curl 'https://freshrss.example.net/api/greader.php/accounts/ClientLogin?Email=alice&Passwd=Abcdef123456'\n"
+"SID=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\n"
+"Auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\n"
+"\n"
+"# Examples of read-only requests\n"
+"curl -s -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/subscription/list?output=json'\n"
+"\n"
+"curl -s -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/unread-count?output=json'\n"
+"\n"
+"curl -s -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/tag/list?output=json'\n"
+"\n"
+"# Retrieve a token for requests making modifications\n"
+"curl -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/token'\n"
+"8e6845e089457af25303abc6f53356eb60bdb5f8ZZZZZZZZZZZZZZZZZ\n"
+"\n"
+"# Get articles, piped to jq for easier JSON reading\n"
+"curl -s -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/stream/contents/reading-list' | jq .\n"
+msgstr ""
+"# Authentification utilisant le mot de passe API (Email et Passwd peuvent être passés en GET, ou POST - mieux)\n"
+"curl 'https://freshrss.example.net/api/greader.php/accounts/ClientLogin?Email=alice&Passwd=Abcdef123456'\n"
+"SID=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\n"
+"Auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\n"
+"\n"
+"# Exemples de requêtes en lecture\n"
+"curl -s -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/subscription/list?output=json'\n"
+"\n"
+"curl -s -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/unread-count?output=json'\n"
+"\n"
+"curl -s -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/tag/list?output=json'\n"
+"\n"
+"# Demande de jeton pour faire de requêtes de modification\n"
+"curl -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/token'\n"
+"8e6845e089457af25303abc6f53356eb60bdb5f8ZZZZZZZZZZZZZZZZZ\n"
+"\n"
+"# Récupère les articles, envoyés à jq pour une lecture JSON plus facile\n"
+"curl -s -H \"Authorization:GoogleLogin auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/stream/contents/reading-list' | jq .\n"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:2
+msgid ""
+"We may not have answered all of your questions in the previous sections. The "
+"FAQ contains some questions that have not been answered elsewhere."
+msgstr ""
+"Il est possible que nous n'ayons pas répondu à toutes vos questions dans les "
+"parties précédentes. La FAQ regroupe certaines interrogations qui n'ont pas "
+"trouvé leur réponse ailleurs."
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:3
+#, no-wrap
+msgid "What is `/i` at the end of the application URL?"
+msgstr "C'est quoi ce `/i` à la fin de l'URL ?"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:6
+msgid ""
+"Of course, ```/i``` has a purpose! It's used for performance and usability:"
+msgstr ""
+"Bien entendu, le ```/i``` n'est pas là pour faire joli ! Il s'agit d'une "
+"question de performances et de praticité :"
+
+#. type: Bullet: '* '
+#: en/./users/07_Frequently_Asked_Questions.md:11
+msgid ""
+"It allows for serving icons, images, styles and scripts without cookies. "
+"Without that trick, those files would be downloaded more often, especially "
+"when form authentication is used. Also, HTTP requests would be heavier."
+msgstr ""
+"Cela permet de servir les icônes, images, styles, scripts sans cookie. Sans "
+"cela, ces fichiers seraient souvent re-téléchargés, en particulier lorsque "
+"le formulaire de connexion est utilisé. De plus, les requêtes vers ces "
+"ressources seraient plus lourdes."
+
+#. type: Bullet: '* '
+#: en/./users/07_Frequently_Asked_Questions.md:11
+msgid ""
+"The ```./p/``` public root can be served without any HTTP access "
+"restrictions. Whereas it could be implemented in ```./p/i/```."
+msgstr ""
+"La racine publique ```./p/``` peut être servie sans restriction d'accès HTTP "
+"(qui peut avantageusement être mise en place dans ```./p/i/```)."
+
+#. type: Bullet: '* '
+#: en/./users/07_Frequently_Asked_Questions.md:11
+msgid ""
+"It avoids problems while serving public resources like ```favicon.ico```, "
+"```robots.txt```, etc."
+msgstr ""
+"Cela permet d'éviter des problèmes pour des fichiers qui doivent être "
+"publics pour bien fonctionner, comme ```favicon.ico```, ```robots.txt```, "
+"etc."
+
+#. type: Bullet: '* '
+#: en/./users/07_Frequently_Asked_Questions.md:11
+msgid ""
+"It allows the logo to be displayed instead of a white page while hitting a "
+"restriction or a delay during the loading process."
+msgstr ""
+"Cela permet aussi d'avoir un logo FreshRSS plutôt qu'une page blanche pour "
+"accueillir l'utilisateur par exemple dans le cas de la restriction d'accès "
+"HTTP ou lors de l'attente du chargement plus lourd du reste de l'interface."
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:12
+#, no-wrap
+msgid "Why is `robots.txt` located in a sub-folder?"
+msgstr "Pourquoi le ```robots.txt``` se trouve dans un sous-répertoire ?"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:15
+msgid ""
+"To increase security, FreshRSS is hosted in two sections. The first section "
+"is public (the `./p` folder) and the second section is private (everything "
+"else). Therefore the `robots.txt` file is located in the `./p` sub-folder."
+msgstr ""
+"Afin d'améliorer la sécurité, FreshRSS est découpé en deux parties : une "
+"partie publique (le répertoire ```./p```) et une partie privée (tout le "
+"reste !). Le ```robots.txt``` se trouve donc dans le sous-répertoire ```./"
+"p```."
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:17
+msgid ""
+"As explained in the [security section](/en/User_documentation/Installation/"
+"Security), it's highly recommended to make only the public section available "
+"at the domain level. With that configuration, `./p` is the root folder for "
+"http://demo.freshrss.org/, thus making `robots.txt` available at the root of "
+"the application."
+msgstr ""
+"Comme expliqué dans les [conseils de sécurité](01_Installation.md#conseils-"
+"de-securite), il est recommandé de faire pointer un nom de domaine vers ce "
+"sous-répertoire afin que seule la partie publique ne soit accessible par un "
+"navigateur web. De cette manière https://demo.freshrss.org/ pointe vers le "
+"répertoire ```./p``` et le ```robots.txt``` se trouve bien à la racine du "
+"site : https://demo.freshrss.org/robots.txt."
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:19
+msgid "The same principle applies to `favicon.ico` and `.htaccess`."
+msgstr ""
+"L'explication est la même pour les fichiers ```favicon.ico``` et ```."
+"htaccess```."
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:20
+#, no-wrap
+msgid "Why do I have errors while registering a feed?"
+msgstr "Pourquoi j'ai des erreurs quand j'essaye d'enregistrer un flux ?"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:26
+msgid ""
+"There can be different origins for that problem.  The feed syntax can be "
+"invalid, it can be unrecognized by the SimplePie library, the hosting server "
+"can be the root of the problem, or FreshRSS can be buggy.  The first step is "
+"to identify what causes the problem.  Here are the steps to follow:"
+msgstr ""
+"Il peut y avoir différentes origines à ce problème. Le flux peut avoir une "
+"syntaxe invalide, il peut ne pas être reconnu par la bibliothèque SimplePie, "
+"l'hébergement peut avoir des problèmes, FreshRSS peut être boggué. Il faut "
+"dans un premier temps déterminer la cause du problème.Voici la liste des "
+"étapes à suivre pour la déterminer :"
+
+#. type: Bullet: '1. '
+#: en/./users/07_Frequently_Asked_Questions.md:30
+msgid ""
+"__Verify if the feed syntax is valid__ with the [W3C on-line tool](https://"
+"validator.w3.org/feed/ \"RSS and Atom feed validator\"). If it's not valid, "
+"there's nothing we can do."
+msgstr ""
+"__Vérifier la validité du flux__ grâce à l'[outil en ligne du W3C](https://"
+"validator.w3.org/feed/ \"Validateur en ligne de flux RSS et Atom\"). Si ça "
+"ne fonctionne pas, nous ne pouvons rien faire."
+
+#. type: Bullet: '1. '
+#: en/./users/07_Frequently_Asked_Questions.md:30
+msgid ""
+"__Verify SimplePie validation__ with the [SimplePie on-line tool](https://"
+"simplepie.org/demo/ \"SimplePie official demo\"). If it's not recognized, "
+"there's nothing we can do."
+msgstr ""
+"__Vérifier la reconnaissance par SimplePie__ grâce à l'[outil en ligne de "
+"SimplePie](https://simplepie.org/demo/ \"Démo officielle de SimplePie\"). Si "
+"ça ne fonctionne pas, nous ne pouvons rien faire."
+
+#. type: Bullet: '1. '
+#: en/./users/07_Frequently_Asked_Questions.md:30
+msgid ""
+"__Verify FreshRSS integration__ with the [demo](https://demo.freshrss.org "
+"\"FreshRSS official demo\"). If it's not working, you need to [create an "
+"issue on Github](https://github.com/FreshRSS/FreshRSS/issues/new \"Create an "
+"issue for FreshRSS\") so we can have a look at it. If it's working, there's "
+"probably something fishy with the hosting server."
+msgstr ""
+"__Vérifier l'intégration dans FreshRSS__ grâce à la [démo](https://demo."
+"freshrss.org \"Démo officielle de FreshRSS\"). Si ça ne fonctionne pas, il "
+"faut [créer un ticket sur Github](https://github.com/FreshRSS/FreshRSS/"
+"issues/new \"Créer un ticket pour FreshRSS\") pour que l'on puisse regarder "
+"ce qui se passe. Si ça fonctionne, il y a probablement un problème avec "
+"l'hébergement."
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:31
+#, no-wrap
+msgid "How can you change a forgotten password?"
+msgstr "Comment changer un mot de passe oublié ?"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:35
+msgid ""
+"Since the [1.10.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.10.0) "
+"release, admins can change user passwords directly from the interface. This "
+"interface is available under ```Administration → Manage users```.  Select a "
+"user, enter a password, and validate."
+msgstr ""
+"Depuis la version [1.10.0](https://github.com/FreshRSS/FreshRSS/releases/"
+"tag/1.10.0), l'administrateur peut modifier le mot de passe d'un utilisateur "
+"depuis l'interface. Cette interface est disponible dans le menu "
+"```Administration → Gestion des utilisateurs```. Il suffit de sélectionner "
+"l'utilisateur, de saisir un mot de passe et de valider."
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:37
+msgid ""
+"Since the [1.8.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.8.0) "
+"release, admins can change user passwords using a terminal. It worth "
+"mentioning that you must have access to PHP CLI. Open a terminal, and type "
+"the following command:"
+msgstr ""
+"Depuis la version [1.8.0](https://github.com/FreshRSS/FreshRSS/releases/"
+"tag/1.8.0), l'administrateur peut modifier le mot de passe d'un utilisateur "
+"depuis un terminal. Il est bon de noter que celui-ci doit avoir un accès à "
+"PHP en ligne de commande. Pour cela, il suffit d'ouvrir son terminal et de "
+"saisir la commande suivante :"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:37
+#, no-wrap
+msgid "./cli/update_user.php --user <username> --password <password>\n"
+msgstr ""
+"./cli/update_user.php --user <username> --password <password>\n"
+"\n"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:41
+msgid ""
+"For more information on that matter, please refer to the [dedicated "
+"documentation](../../cli/README.md)."
+msgstr ""
+"Pour plus d'information à ce sujet, il existe la [documentation dédiée]"
+"(../../cli/README.md)."
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:42
+#, no-wrap
+msgid "Permissions under SELinux"
+msgstr "Gérer les permissions sous SELinux"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:45
+msgid ""
+"Some Linux distribution, like Fedora or RedHat Enterprise Linux, have "
+"SELinux enabled. This acts similar to a firewall application, so that "
+"applications can't write or modify files under certain conditions. While "
+"installing FreshRSS, step 2 can fail if the httpd process can't write to "
+"some data sub-directories. The following command should be executed as root "
+"to fix this problem:"
+msgstr ""
+"Certaines distributions Linux comme Fedora ou RedHat Enterprise Linux (RHEL) "
+"activent par défaut le système SELinux. Celui-ci permet de gérer des "
+"permissions au niveau des processus. Lors de l'installation de FreshRSS, "
+"l'étape 2 procède à la vérification des droits sur certains répertoires, il "
+"faut donc exécuter la commande suivante en tant que root:"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:45
+#, no-wrap
+msgid ""
+"semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/FreshRSS/data(/.*)?'\n"
+"restorecon -Rv /usr/share/FreshRSS/data\n"
+msgstr ""
+"semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/FreshRSS/data(/.*)?'\n"
+"restorecon -Rv /usr/share/FreshRSS/data\n"
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:50
+#, no-wrap
+msgid "Why do I have a blank page while trying to configure the sharing options?"
+msgstr "Pourquoi y a-t-il une page blanche lorsque je configure les options de partage ?"
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:53
+msgid ""
+"The `sharing` word in the URL is a trigger word for some ad-blocker rules. "
+"Starting with version 1.16, `sharing` has been replaced by `integration` in "
+"the faulty URL while keeping the exact same wording throughout the "
+"application."
+msgstr ""
+"Le mot `sharing` dans l'URL est un mot déclencheur pour certaines règles des "
+"bloqueurs de publicités. À partir de la version 1.16, `sharing` a été "
+"remplacé par `integration` dans l'URL posant problème tout en conservant "
+"exactement la même dénomination à travers l'application."
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:55
+msgid ""
+"If you are using a version prior to 1.16, you can disable your ad-blocker "
+"for FreshRSS or you can add a rule to allow the `sharing` page to be "
+"accessed."
+msgstr ""
+"Si vous utilisez une version antérieure à 1.16, vous pouvez désactiver votre "
+"bloqueur de publicité pour FreshRSS ou vous pouvez ajouter une règle pour "
+"permettre la consultation de la page de configuration « partage »."
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:57
+msgid "Examples with _uBlock_:"
+msgstr "Exemples avec _uBlock_ :"
+
+#. type: Bullet: '- '
+#: en/./users/07_Frequently_Asked_Questions.md:59
+msgid ""
+"Whitelist your FreshRSS instance by adding it in _uBlock > Open the "
+"dashboard > Whitelist_."
+msgstr ""
+"Ajoutez votre instance FreshRSS à la liste blanche de en l'ajoutant dans "
+"_uBlock > Ouvrir le tableau de bord > Liste blanche_."
+
+#. type: Bullet: '- '
+#: en/./users/07_Frequently_Asked_Questions.md:59
+msgid ""
+"Authorize your FreshRSS instance to call `sharing` configuration page by "
+"adding the rule `*sharing,domain=~yourdomain.com` in _uBlock > Open the "
+"dashboard > My filters_"
+msgstr ""
+"Autorisez votre instance FreshRSS à appeler la page de configuration "
+"`sharing` en ajoutant la règle `*sharing,domain=~votredomaine.com` dans "
+"_uBlock > Ouvrir le fichier tableau de bord > Mes filtres_"
+
+#, fuzzy
+#~| msgid ""
+#~| "As explained in the [security section](/en/User_documentation/"
+#~| "Installation/Security), it's highly recommended to make only the public "
+#~| "section available at the domain level. With that configuration, `./p` is "
+#~| "the root folder for http://demo.freshrss.org/, thus making `robots.txt` "
+#~| "available at the root of the application."
+#~ msgid ""
+#~ "As explained in the [security section](/en/User_documentation/"
+#~ "Installation/Security), it is highly recommended to make only the public "
+#~ "section available at the domain level. With that configuration, ```./p``` "
+#~ "is the root folder for https://demo.freshrss.org/, thus making ```robots."
+#~ "txt``` available at the root of the application.\n"
+#~ ">>>>>>> 8bdf7b09f208346481cba5e08edc55dfab8c8d63\n"
+#~ msgstr ""
+#~ "Comme expliqué dans les [conseils de sécurité](01_Installation."
+#~ "md#conseils-de-securite), il est recommandé de faire pointer un nom de "
+#~ "domaine vers ce sous-répertoire afin que seule la partie publique ne soit "
+#~ "accessible par un navigateur web. De cette manière http://demo.freshrss."
+#~ "org/ pointe vers le répertoire ```./p``` et le ```robots.txt``` se trouve "
+#~ "bien à la racine du site : http://demo.freshrss.org/robots.txt."
+
+#~ msgid "Here's a list of feeds which don't work:"
+#~ msgstr "Voici une liste des flux qui ne fonctionnent pas :"
+
+#~ msgid ""
+#~ "http://foulab.org/fr/rss/Foulab_News: is not a W3C valid feed (November "
+#~ "2014)"
+#~ msgstr ""
+#~ "http://foulab.org/fr/rss/Foulab_News : ne passe pas la validation W3C "
+#~ "(novembre 2014)"
+
+#~ msgid ""
+#~ "http://eu.battle.net/hearthstone/fr/feed/news: is not a W3C valid feed "
+#~ "(November 2014)"
+#~ msgstr ""
+#~ "http://eu.battle.net/hearthstone/fr/feed/news : ne passe pas la "
+#~ "validation W3C (novembre 2014)"
+
+#~ msgid ""
+#~ "http://webseriesmag.blogs.liberation.fr/we/atom.xml: is not working for "
+#~ "the user but passes validation (November 2014)"
+#~ msgstr ""
+#~ "http://webseriesmag.blogs.liberation.fr/we/atom.xml : ne fonctionne pas "
+#~ "chez l'utilisateur mais passe l'ensemble des validations ci-dessus "
+#~ "(novembre 2014)"
+
+#~ msgid "Problem to solve"
+#~ msgstr "Problème à résoudre"
+
+#~ msgid "Préparer la sortie"
+#~ msgstr "Préparer la sortie"
+
+#~ msgid "S'assurer de l'état de dev"
+#~ msgstr "S'assurer de l'état de dev"
+
+#~ msgid ""
+#~ "Avant de sortir une nouvelle version de FreshRSS, il faut vous assurer "
+#~ "que le code est stable et ne présente pas de bugs majeurs. Idéalement, il "
+#~ "faudrait que nos tests soient automatisés et exécutés avant toute "
+#~ "publication."
+#~ msgstr ""
+#~ "Avant de sortir une nouvelle version de FreshRSS, il faut vous assurer "
+#~ "que le code est stable et ne présente pas de bugs majeurs. Idéalement, il "
+#~ "faudrait que nos tests soient automatisés et exécutés avant toute "
+#~ "publication."
+
+#~ msgid ""
+#~ "Il faut aussi **vous assurer que le fichier CHANGELOG est à jour** dans "
+#~ "la branche de dev avec les mises à jour de la ou les version(s) à sortir."
+#~ msgstr ""
+#~ "Il faut aussi **vous assurer que le fichier CHANGELOG est à jour** dans "
+#~ "la branche de dev avec les mises à jour de la ou les version(s) à sortir."
+
+#~ msgid "Processus Git"
+#~ msgstr "Processus Git"
+
+#~ msgid "Écriture du script de mise à jour"
+#~ msgstr "Écriture du script de mise à jour"
+
+#~ msgid "Il existe ensuite 5 fonctions à remplir :"
+#~ msgstr "Il existe ensuite 5 fonctions à remplir :"
+
+#~ msgid ""
+#~ "- `apply_update()` qui se charge de sauvegarder le répertoire contenant "
+#~ "les données, de vérifier sa structure, de télécharger le package "
+#~ "FreshRSS, de le déployer et de tout nettoyer. Cette fonction est pré-"
+#~ "remplie mais des ajustements peuvent être faits si besoin est (ex. "
+#~ "réorganisation de la structure de `./data`). Elle retourne `true` si "
+#~ "aucun problème n'est survenu ou une chaîne de caractères indiquant un "
+#~ "soucis ; - `need_info_update()` retourne `true` si l'utilisateur doit "
+#~ "intervenir durant la mise à jour ou `false` sinon ; - `ask_info_update()` "
+#~ "affiche un formulaire à l'utilisateur si `need_info_update()` a retourné "
+#~ "`true` ; - `save_info_update()` est chargée de sauvegarder les "
+#~ "informations renseignées par l'utilisateur (issues du formulaire de "
+#~ "`ask_info_update()`) ; - `do_post_update()` est exécutée à la fin de la "
+#~ "mise à jour et prend en compte le code de la nouvelle version (ex. si la "
+#~ "nouvelle version modifie l'objet `Minz_Configuration`, vous bénéficierez "
+#~ "de ces améliorations)."
+#~ msgstr ""
+#~ "- `apply_update()` qui se charge de sauvegarder le répertoire contenant "
+#~ "les données, de vérifier sa structure, de télécharger le package "
+#~ "FreshRSS, de le déployer et de tout nettoyer. Cette fonction est pré-"
+#~ "remplie mais des ajustements peuvent être faits si besoin est (ex. "
+#~ "réorganisation de la structure de `./data`). Elle retourne `true` si "
+#~ "aucun problème n'est survenu ou une chaîne de caractères indiquant un "
+#~ "soucis ; - `need_info_update()` retourne `true` si l'utilisateur doit "
+#~ "intervenir durant la mise à jour ou `false` sinon ; - `ask_info_update()` "
+#~ "affiche un formulaire à l'utilisateur si `need_info_update()` a retourné "
+#~ "`true` ; - `save_info_update()` est chargée de sauvegarder les "
+#~ "informations renseignées par l'utilisateur (issues du formulaire de "
+#~ "`ask_info_update()`) ; - `do_post_update()` est exécutée à la fin de la "
+#~ "mise à jour et prend en compte le code de la nouvelle version (ex. si la "
+#~ "nouvelle version modifie l'objet `Minz_Configuration`, vous bénéficierez "
+#~ "de ces améliorations)."
+
+#~ msgid "Mise à jour du fichier de versions"
+#~ msgstr "Mise à jour du fichier de versions"
+
+#~ msgid ""
+#~ "Lorsque le script a été écrit et versionné, il est nécessaire de mettre à "
+#~ "jour le fichier `./versions.php` qui contient une table de "
+#~ "correspondances indiquant quelles versions sont mises à jour vers quelles "
+#~ "autres versions."
+#~ msgstr ""
+#~ "Lorsque le script a été écrit et versionné, il est nécessaire de mettre à "
+#~ "jour le fichier `./versions.php` qui contient une table de "
+#~ "correspondances indiquant quelles versions sont mises à jour vers quelles "
+#~ "autres versions."
+
+#~ msgid "Et voici comment fonctionne cette table :"
+#~ msgstr "Et voici comment fonctionne cette table :"
+
+#~ msgid ""
+#~ "- à gauche se trouve la version N, à droite la version N+1 ; - les "
+#~ "versions `x.y.z-dev` sont **toutes** mises à jour vers `dev` ; - les "
+#~ "versions stables sont mises à jour vers des versions stables ; - il est "
+#~ "possible de sauter plusieurs versions d'un coup à condition que les "
+#~ "scripts de mise à jour le prennent en charge ; - il est conseillé "
+#~ "d'indiquer la correspondance de la version courante vers sa potentielle "
+#~ "future version en précisant que cette version n'existe pas encore. Tant "
+#~ "que le script correspondant n'existera pas, rien ne se passera."
+#~ msgstr ""
+#~ "- à gauche se trouve la version N, à droite la version N+1 ; - les "
+#~ "versions `x.y.z-dev` sont **toutes** mises à jour vers `dev` ; - les "
+#~ "versions stables sont mises à jour vers des versions stables ; - il est "
+#~ "possible de sauter plusieurs versions d'un coup à condition que les "
+#~ "scripts de mise à jour le prennent en charge ; - il est conseillé "
+#~ "d'indiquer la correspondance de la version courante vers sa potentielle "
+#~ "future version en précisant que cette version n'existe pas encore. Tant "
+#~ "que le script correspondant n'existera pas, rien ne se passera."
+
+#~ msgid ""
+#~ "Il est **très fortement** indiqué de garder ce fichier rangé selon les "
+#~ "numéros de versions en séparant les versions stables et de dev."
+#~ msgstr ""
+#~ "Il est **très fortement** indiqué de garder ce fichier rangé selon les "
+#~ "numéros de versions en séparant les versions stables et de dev."
+
+#~ msgid ""
+#~ "Lorsque vous serez satisfait, mettez à jour update.freshrss.org avec le "
+#~ "nouveau script et en testant de nouveau puis passez à la suite."
+#~ msgstr ""
+#~ "Lorsque vous serez satisfait, mettez à jour update.freshrss.org avec le "
+#~ "nouveau script et en testant de nouveau puis passez à la suite."
+
+#~ msgid "Mise à jour des services FreshRSS"
+#~ msgstr "Mise à jour des services FreshRSS"
+
+#~ msgid ""
+#~ "Deux services sont à mettre à jour immédiatement après la mise à jour de "
+#~ "update.freshrss.org :"
+#~ msgstr ""
+#~ "Deux services sont à mettre à jour immédiatement après la mise à jour de "
+#~ "update.freshrss.org :"
+
+#~ msgid "Annoncer publiquement la sortie"
+#~ msgstr "Annoncer publiquement la sortie"
+
+#~ msgid ""
+#~ "Lorsque tout fonctionne, il est temps d'annoncer la sortie au monde "
+#~ "entier !"
+#~ msgstr ""
+#~ "Lorsque tout fonctionne, il est temps d'annoncer la sortie au monde "
+#~ "entier !"
+
+#~ msgid ""
+#~ "- sur GitHub en créant [une nouvelle release](https://github.com/FreshRSS/"
+#~ "FreshRSS/releases/new) ; - sur le blog de freshrss.org au minimum pour "
+#~ "les versions stables (écrire l'article sur [FreshRSS/freshrss.org]"
+#~ "(https://github.com/FreshRSS/freshrss.org)).  - sur Twitter (compte "
+#~ "[@FreshRSS](https://twitter.com/FreshRSS)) ; - et sur mailing@freshrss."
+#~ "org ;"
+#~ msgstr ""
+#~ "- sur GitHub en créant [une nouvelle release](https://github.com/FreshRSS/"
+#~ "FreshRSS/releases/new) ; - sur le blog de freshrss.org au minimum pour "
+#~ "les versions stables (écrire l'article sur [FreshRSS/freshrss.org]"
+#~ "(https://github.com/FreshRSS/freshrss.org)).  - sur Twitter (compte "
+#~ "[@FreshRSS](https://twitter.com/FreshRSS)) ; - et sur mailing@freshrss."
+#~ "org ;"
+
+#~ msgid "Lancer la prochaine version de développement"
+#~ msgstr "Lancer la prochaine version de développement"
+
+#~ msgid ""
+#~ "Pensez aussi à mettre à jour update.freshrss.org pour qu'il prenne en "
+#~ "compte la version de développement actuelle."
+#~ msgstr ""
+#~ "Pensez aussi à mettre à jour update.freshrss.org pour qu'il prenne en "
+#~ "compte la version de développement actuelle."
+
+#~ msgid "With brackets"
+#~ msgstr "Le cas des parenthèses"
+
+#~ msgid ""
+#~ "- RSS and Atom aggregation - Mark article as favorite if you liked it or "
+#~ "if you want to read it later - Filter and search functionality helps to "
+#~ "easily find articles - Statistics to show you the publishing frequency "
+#~ "all the websites you follow - Import/export of your feeds into OPML "
+#~ "format - Several themes created by the community - \"Google Reader\"-like "
+#~ "API to connect Android applications - The application is \"responsive,\" "
+#~ "which means it adapts to small screens so you can bring articles in your "
+#~ "pocket - Self-hosted: the code is free (under AGPL3 licence), so you can "
+#~ "host your own instance of FreshRSS - Multi-user, so you can also host for "
+#~ "your friends and family - And a lot more!"
+#~ msgstr ""
+#~ "- Agrégation des flux RSS et Atom.- Utilisez les favoris pour marquer les "
+#~ "articles qui vous ont plu ou que vous souhaitez lire plus tard.- Le "
+#~ "système de filtrage et de recherche permettent de cibler exactement les "
+#~ "articles que vous souhaitez lire.- Les statistiques permettent de savoir "
+#~ "en un coup d’œil quels sont les sites qui publient le plus, ou à "
+#~ "l’inverse, le moins.- Importation / exportation des flux au format OPML.- "
+#~ "Multi-thèmes pour changer l’habillage de FreshRSS.- « *Responsive design* "
+#~ "» : l’application s’adapte aux petits écrans pour emporter FreshRSS dans "
+#~ "votre poche.- Multi-utilisateurs pour héberger plusieurs personnes sur "
+#~ "une même installation.- API Google Reader pour pouvoir y brancher des "
+#~ "applications Android.- Auto-hébergeable : le code source est libre "
+#~ "(AGPL3) et vous pouvez donc l’héberger sur votre propre serveur.- Et bien "
+#~ "d’autres !"

docs/i18n/templates/freshrss.pot

@@ -0,0 +1,4968 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: https://github.com/FreshRSS/FreshRSS/issues\n"
+"POT-Creation-Date: 2019-11-15 10:34+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: Title ##
+#: en/./contributing.md:1
+#, no-wrap
+msgid "Join us on the mailing lists"
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:4
+msgid ""
+"Do you want to ask us some questions? Do you want to discuss with us? Don't "
+"hesitate to subscribe to our mailing lists!"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./contributing.md:7
+msgid ""
+"The first mailing is destined to generic information, it should be adapted "
+"to users. [Join "
+"mailing@freshrss.org](https://freshrss.org/mailman/listinfo/mailing)."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./contributing.md:7
+msgid ""
+"The second mailing is mainly for developers. [Join "
+"dev@freshrss.org](https://freshrss.org/mailman/listinfo/dev)"
+msgstr ""
+
+#. type: Title ##
+#: en/./contributing.md:8
+#, no-wrap
+msgid "Report a bug"
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:11
+msgid ""
+"Have you found a bug? Don't panic, here are some steps to report it with "
+"ease:"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./contributing.md:15
+msgid ""
+"Search for it on [the bug "
+"tracker](https://github.com/FreshRSS/FreshRSS/issues) (don't forget to use "
+"the search bar)."
+msgstr ""
+
+#. type: Bullet: '2. '
+#: en/./contributing.md:15
+msgid ""
+"If you find a similar bug, don't hesitate to post a comment to add more "
+"importance to the related ticket."
+msgstr ""
+
+#. type: Bullet: '3. '
+#: en/./contributing.md:15
+msgid ""
+"If you didn't find it, [open a new "
+"ticket](https://github.com/FreshRSS/FreshRSS/issues/new)."
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:17
+msgid ""
+"If you have to create a new ticket, please try to keep in mind the following "
+"advice:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./contributing.md:20
+msgid "Give an explicit title to the ticket so it will be easier to find it later."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./contributing.md:20
+msgid ""
+"Be as exhaustive as possible in the description: what did you do? What is "
+"the bug? What are the steps to reproduce the bug?"
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:22
+msgid "We also need some information:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./contributing.md:27
+msgid "Your FreshRSS version (on the about page or in the `constants.php` file)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./contributing.md:27
+msgid "Your server configuration: the type of hosting and the PHP version"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./contributing.md:27
+msgid "Your storage system (SQLite, MySQL, MariaDB, PostgreSQL)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./contributing.md:27
+msgid ""
+"If possible, the related logs (PHP logs and FreshRSS logs under "
+"`data/users/your_user/log.txt`)"
+msgstr ""
+
+#. type: Title ##
+#: en/./contributing.md:28
+#, no-wrap
+msgid "Fix a bug"
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:31
+msgid ""
+"Would you like to fix a bug? For optimum coordination between collaborators, "
+"you should follow these indications:"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./contributing.md:36
+msgid ""
+"Be sure the bug is associated with a ticket and indicate that you'll work on "
+"it."
+msgstr ""
+
+#. type: Bullet: '2. '
+#: en/./contributing.md:36
+msgid ""
+"[Fork the project "
+"repository](https://help.github.com/articles/fork-a-repo/)."
+msgstr ""
+
+#. type: Bullet: '3. '
+#: en/./contributing.md:36
+msgid ""
+"[Create a new "
+"branch](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/). "
+"The name of the branch should be clear, and ideally prefixed by the related "
+"ticket id. For instance, `783-contributing-file` to fix [ticket "
+"#783](https://github.com/FreshRSS/FreshRSS/issues/783)."
+msgstr ""
+
+#. type: Bullet: '4. '
+#: en/./contributing.md:36
+msgid ""
+"Make your changes to your fork and [send a pull "
+"request](https://help.github.com/articles/using-pull-requests/) on the **dev "
+"branch**."
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:38
+msgid ""
+"If you have to write code, please follow [our coding style "
+"recommendations](developers/01_First_steps.md)."
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:40
+#, no-wrap
+msgid ""
+"**Tip:** if you're searching for easy-to-fix bugs, please have a look at the "
+"\"[good first "
+"issue](https://github.com/FreshRSS/FreshRSS/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)\" "
+"ticket label.\n"
+msgstr ""
+
+#. type: Title ##
+#: en/./contributing.md:41
+#, no-wrap
+msgid "Submit an idea"
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:44
+msgid ""
+"You have great ideas, yes! Don't be shy and open [a new "
+"ticket](https://github.com/FreshRSS/FreshRSS/issues/new) on our bug tracker "
+"to ask if we can implement it. The greatest ideas often come from the shyest "
+"suggestions!"
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:46
+msgid "If your idea is nice, we'll have a look at it."
+msgstr ""
+
+#. type: Title ##
+#: en/./contributing.md:47
+#, no-wrap
+msgid "Contribute to internationalization (i18n)"
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:50
+msgid ""
+"If you want to improve internationalization, please open a new ticket first "
+"and follow the advice from the *Fix a bug* section."
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:52
+msgid "Translations are present in the subdirectories of `./app/i18n/`."
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:54
+msgid ""
+"We're working on a better way to handle internationalization, but don't "
+"hesitate to suggest any ideas!"
+msgstr ""
+
+#. type: Title ##
+#: en/./contributing.md:55
+#, no-wrap
+msgid "Contribute to documentation"
+msgstr ""
+
+#. type: Plain text
+#: en/./contributing.md:58
+msgid ""
+"The documentation needs a lot of improvements in order to be more useful to "
+"new contributors and we are working on it.  If you want to give some help, "
+"meet us in the main repositories [docs "
+"directory](https://github.com/FreshRSS/FreshRSS/tree/master/docs)!"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/01_First_steps.md:1
+#, no-wrap
+msgid "Environment configuration (Docker)"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:4
+msgid ""
+"FreshRSS is built with PHP and uses a homemade framework, Minz. The "
+"dependencies are directly included in the source code, so you don't need "
+"Composer."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:6
+msgid ""
+"There are various ways to configure your development environment. The "
+"easiest and most supported method is based on Docker, which is the solution "
+"documented below. If you already have a working PHP environment, you "
+"probably don't need it."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:8
+msgid ""
+"We assume here that you use a GNU/Linux distribution, capable of running "
+"Docker. Otherwise, you'll have to adapt the commands accordingly."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:10
+msgid ""
+"The commands that follow have to be executed in a console. They start by `$` "
+"when commands need to be executed as normal user, and by `#` when they need "
+"to be executed as root user. You don't have to type these characters. A path "
+"may be indicated before these characters to help you identify where they "
+"need to be executed. For instance, `app$ echo 'Hello World'` indicates that "
+"you have to execute `echo` command in the `app/` directory."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:12
+msgid ""
+"First, you need to install "
+"[Docker](https://docs.docker.com/install/linux/docker-ce/ubuntu/)."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:14
+msgid "Once you're done, clone the repository with:"
+msgstr ""
+
+#. type: Code fence info string
+#: en/./developers/01_First_steps.md:15 en/./developers/01_First_steps.md:24 en/./developers/01_First_steps.md:34 en/./developers/01_First_steps.md:42 en/./developers/01_First_steps.md:50
+#, no-wrap
+msgid "console"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:15
+#, no-wrap
+msgid ""
+"$ git clone https://github.com/FreshRSS/FreshRSS.git\n"
+"$ cd FreshRSS\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:21
+msgid ""
+"Note that, if you want to contribute, you have to fork the repository first "
+"and clone your fork instead of the \"root\" one. Adapt the commands in "
+"consequence."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:23
+msgid "Then, the only command you need to know is the following:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:24
+#, no-wrap
+msgid "$ make start\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:29
+msgid ""
+"This might take some time while Docker downloads the image. If your user "
+"isn't in the `docker` group, you'll need to prepend the command with `sudo`."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:31
+#, no-wrap
+msgid ""
+"**You can now access FreshRSS at "
+"[http://localhost:8080](http://localhost:8080).** Just follow the install "
+"process and select the SQLite database.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:33
+#, no-wrap
+msgid ""
+"You can stop the containers by typing <kbd>Control</kbd> + <kbd>c</kbd> or "
+"with the following command, in another terminal:\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:34
+#, no-wrap
+msgid "$ make stop\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:39
+msgid ""
+"If you're interested in the configuration, the `make` commands are defined "
+"in the [`Makefile`](/Makefile)."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:41
+msgid ""
+"If you need to use a different tag image (default is `dev-alpine`), you can "
+"set the `TAG` environment variable:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:42
+#, no-wrap
+msgid "$ TAG=dev-arm make start\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:47
+msgid ""
+"You can find the full list of available tags [on the Docker "
+"hub](https://hub.docker.com/r/freshrss/freshrss/tags)."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:49
+msgid ""
+"If you want to build the Docker image yourself, you can use the following "
+"command:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:50
+#, no-wrap
+msgid ""
+"$ make build\n"
+"$ # or\n"
+"$ TAG=dev-arm make build\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:57
+msgid ""
+"The `TAG` variable can be anything (e.g. `dev-local`). You can target a "
+"specific architecture by adding `-alpine` or `-arm` at the end of the tag "
+"(e.g. `dev-local-arm`)."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/01_First_steps.md:58
+#, no-wrap
+msgid "Project architecture"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:61 en/./developers/03_Backend/02_Minz.md:4 en/./developers/03_Backend/02_Minz.md:8 en/./developers/03_Backend/02_Minz.md:12 en/./developers/03_Backend/02_Minz.md:16 en/./developers/03_Backend/02_Minz.md:20 en/./developers/03_Backend/02_Minz.md:24 en/./developers/03_Backend/02_Minz.md:27 en/./developers/03_Backend/04_Changing_source_code.md:4 en/./developers/03_Backend/04_Changing_source_code.md:8 en/./developers/03_Backend/04_Changing_source_code.md:12 en/./developers/03_Backend/04_Changing_source_code.md:15 en/./developers/03_Backend/05_Extensions.md:342 en/./developers/03_Backend/05_Extensions.md:381 en/./developers/04_Frontend/01_View_files.md:4 en/./developers/04_Frontend/01_View_files.md:8 en/./developers/04_Frontend/01_View_files.md:12 en/./developers/04_Frontend/01_View_files.md:15 en/./developers/04_Frontend/02_Design.md:4 en/./developers/04_Frontend/02_Design.md:8 en/./developers/04_Frontend/02_Design.md:11 en/./users/03_Main_view.md:4 en/./users/03_Main_view.md:8 en/./users/03_Main_view.md:12 en/./users/04_Subscriptions.md:4 en/./users/04_Subscriptions.md:8 en/./users/04_Subscriptions.md:19 en/./users/05_Configuration.md:70 en/./users/05_Configuration.md:74 en/./users/05_Configuration.md:128 en/./users/05_Configuration.md:153 en/./users/05_Configuration.md:157 en/./users/05_Configuration.md:161
+#, no-wrap
+msgid "**TODO**\n"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/01_First_steps.md:62
+#, no-wrap
+msgid "Extensions"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:65
+msgid ""
+"If you want to create your own FreshRSS extension, take a look at the "
+"[extension documentation](03_Backend/05_Extensions.md)."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/01_First_steps.md:66
+#, no-wrap
+msgid "Coding style"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:69
+msgid ""
+"If you want to contribute to the source code, it's important to follow the "
+"project's coding style. The actual code doesn't always follow it throughout "
+"the project, but we should fix it every time an opportunity presents itself."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:71
+msgid ""
+"Contributions which don't follow the coding style will be rejected as long "
+"as the coding style is not fixed."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:72
+#, no-wrap
+msgid "Spaces, tabs and other whitespace characters"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:74
+#, no-wrap
+msgid "Indentation"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:76
+msgid "Code indentation must use tabs."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:77
+#, no-wrap
+msgid "Alignment"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:80
+msgid ""
+"Once the code has been correctly indented, it might be useful to align it "
+"for ease of reading. In that case, please use spaces."
+msgstr ""
+
+#. type: Code fence info string
+#: en/./developers/01_First_steps.md:81 en/./developers/01_First_steps.md:111 en/./developers/01_First_steps.md:123 en/./developers/01_First_steps.md:158 en/./developers/01_First_steps.md:173 en/./developers/01_First_steps.md:186 en/./developers/01_First_steps.md:196 en/./developers/01_First_steps.md:213 en/./developers/01_First_steps.md:228 en/./developers/03_Backend/05_Extensions.md:47 en/./developers/03_Backend/05_Extensions.md:88 en/./developers/03_Backend/05_Extensions.md:130 en/./developers/03_Backend/05_Extensions.md:149 en/./developers/03_Backend/05_Extensions.md:166 en/./developers/03_Backend/05_Extensions.md:188 en/./developers/03_Backend/05_Extensions.md:225 en/./developers/05_Release_new_version.md:54 en/./users/06_Fever_API.md:107
+#, no-wrap
+msgid "php"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:81
+#, no-wrap
+msgid ""
+"$result = a_function_with_a_really_long_name($param1, $param2,\n"
+"                                             $param3, $param4);\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:86
+#, no-wrap
+msgid "End of line"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:89
+msgid ""
+"The newline character must be a line feed (LF), which is the default line "
+"ending on *NIX systems. This character must not follow other white space."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:91
+msgid ""
+"You can verify if there is any unintended white space at the end of line "
+"with the following Git command:"
+msgstr ""
+
+#. type: Code fence info string
+#: en/./developers/01_First_steps.md:92 en/./developers/02_Github.md:80 en/./developers/02_Github.md:85 en/./developers/02_Github.md:90 en/./developers/02_Github.md:96 en/./developers/02_Github.md:102 en/./developers/05_Release_new_version.md:15 en/./developers/05_Release_new_version.md:102
+#, no-wrap
+msgid "bash"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:92
+#, no-wrap
+msgid ""
+"# command to check files before adding them in the Git index\n"
+"git diff --check\n"
+"# command to check files after adding them in the Git index\n"
+"git diff --check --cached\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:99 en/./developers/01_First_steps.md:220
+#, no-wrap
+msgid "End of file"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:102
+msgid "Every file must end by an empty line."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:103
+#, no-wrap
+msgid "Commas, dots and semi-columns"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:106
+msgid ""
+"There should no space before those characters, but there should be one "
+"after."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:107 en/./developers/01_First_steps.md:210
+#, no-wrap
+msgid "Operators"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:110
+msgid "There should be a space before and after every operator."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:111
+#, no-wrap
+msgid ""
+"if ($a == 10) {\n"
+"\t// do something\n"
+"}\n"
+"\n"
+"echo $a ? 1 : 0;\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:119
+#, no-wrap
+msgid "Parentheses"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:122
+msgid ""
+"There should be no spaces in between brackets. There should be no spaces "
+"before the opening bracket, except if it's after a keyword. There shouldn't "
+"be any spaces after the closing bracket, except if it's followed by a curly "
+"bracket."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:123
+#, no-wrap
+msgid ""
+"if ($a == 10) {\n"
+"\t// do something\n"
+"}\n"
+"\n"
+"if ((int)$a == 10) {\n"
+"\t// do something\n"
+"}\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:133
+#, no-wrap
+msgid "With chained functions"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:136
+msgid ""
+"It happens most of the time in Javascript files. When there are chained "
+"functions with closures and callback functions, it's hard to understand the "
+"code if not properly formatted. In those cases, we add a new indent level "
+"for the complete instruction and reset the indent for a new instruction on "
+"the same level."
+msgstr ""
+
+#. type: Code fence info string
+#: en/./developers/01_First_steps.md:137
+#, no-wrap
+msgid "javascript"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:137
+#, no-wrap
+msgid ""
+"// First instruction\n"
+"shortcut.add(shortcuts.mark_read, function () {\n"
+"\t\t//...\n"
+"\t}, {\n"
+"\t\t'disable_in_input': true\n"
+"\t});\n"
+"// Second instruction\n"
+"shortcut.add(\"shift+\" + shortcuts.mark_read, function () {\n"
+"\t\t//...\n"
+"\t}, {\n"
+"\t\t'disable_in_input': true\n"
+"\t});\n"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:152
+#, no-wrap
+msgid "Line length"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:155
+msgid ""
+"Lines should strive to be shorter than 80 characters. However, this limit "
+"may be extended to 100 characters when strictly necessary."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:157
+msgid "With functions, parameters can be declared on multiple lines."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:158
+#, no-wrap
+msgid ""
+"function my_function($param_1, $param_2,\n"
+"                     $param_3, $param_4) {\n"
+"\t// do something\n"
+"}\n"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:165
+#, no-wrap
+msgid "Naming"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:168
+msgid ""
+"All code elements (functions, classes, methods and variables) must describe "
+"their usage succinctly."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:169
+#, no-wrap
+msgid "Functions and variables"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:172
+msgid "Functions and variables must follow the \"snake case\" naming convention."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:173
+#, no-wrap
+msgid ""
+"// a function\n"
+"function function_name() {\n"
+"\t// do something\n"
+"}\n"
+"// a variable\n"
+"$variable_name;\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:182
+#, no-wrap
+msgid "Methods"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:185
+msgid "Methods must follow the \"lower camel case\" naming convention."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:186
+#, no-wrap
+msgid ""
+"private function methodName() {\n"
+"\t// do something\n"
+"}\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:192
+#, no-wrap
+msgid "Classes"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:195
+msgid "Classes must follow the \"upper camel case\" naming convention."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:196
+#, no-wrap
+msgid "abstract class ClassName {}\n"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:200
+#, no-wrap
+msgid "Encoding"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:203
+msgid "Files must be encoded with the UTF-8 character set."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:204
+#, no-wrap
+msgid "PHP compatibility"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:207
+msgid ""
+"Please ensure that your code works with the oldest PHP version officially "
+"supported by FreshRSS."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/01_First_steps.md:208
+#, no-wrap
+msgid "Miscellaneous"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:212
+msgid ""
+"Operators must be at the end of the line if a condition is split over more "
+"than one line."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:213
+#, no-wrap
+msgid ""
+"if ($a == 10 ||\n"
+"    $a == 20) {\n"
+"\t// do something\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:223
+msgid "If the file contains only PHP code, the PHP closing tag must be omitted."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/01_First_steps.md:224
+#, no-wrap
+msgid "Arrays"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:227
+msgid ""
+"If an array declaration runs on more than one line, each element must be "
+"followed by a comma, including the last one."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/01_First_steps.md:228
+#, no-wrap
+msgid ""
+"$variable = [\n"
+"\t\"value 1\",\n"
+"\t\"value 2\",\n"
+"\t\"value 3\",\n"
+"];\n"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/02_Github.md:1
+#, no-wrap
+msgid "Reporting a bug or a suggestion"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:4
+msgid ""
+"Despite the care given to FreshRSS, it's still possible that bugs occur. The "
+"project is young and development is dynamic, so it can be corrected "
+"quickly. You might also have a feature in mind that doesn't yet "
+"exist. Regardless whether your idea seems silly, far-fetched, useless or too "
+"specific, please don't hesitate to propose it to us! \"Ideas in the air\" "
+"often find an attentive ear. It's new external perspectives that make the "
+"project evolve the most."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:6
+msgid ""
+"If you're convinced that you should be heard, here's how you can go about "
+"it."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/02_Github.md:7
+#, no-wrap
+msgid "On GitHub"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:10
+msgid ""
+"GitHub is the ideal platform to submit your requests. It allows us to "
+"discuss a problem or suggestion with others and it often generates new "
+"ideas. Let's not neglect this \"social\" aspect!"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./developers/02_Github.md:16
+msgid "[Go to the bug ticket manager](https://github.com/FreshRSS/FreshRSS/issues)"
+msgstr ""
+
+#. type: Bullet: ' 2. '
+#: en/./developers/02_Github.md:16
+msgid ""
+"Start by checking if a similar request hasn't already been made. If so, "
+"please feel free to add your voice to the request."
+msgstr ""
+
+#. type: Bullet: ' 3. '
+#: en/./developers/02_Github.md:16
+msgid ""
+"If your request is new, [open a new bug "
+"ticket](https://github.com/FreshRSS/FreshRSS/issues/new)"
+msgstr ""
+
+#. type: Bullet: ' 4. '
+#: en/./developers/02_Github.md:16
+msgid ""
+"Finally, write your request. If you're fluent in English, it's the preferred "
+"language because it allows for discussion with the largest number of people."
+msgstr ""
+
+#. type: Bullet: ' 5. '
+#: en/./developers/02_Github.md:16
+msgid "Please follow the tips below to make it easier to let your ticket be heard."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/02_Github.md:17
+#, no-wrap
+msgid "Informal"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:20
+msgid ""
+"Not everyone likes or uses GitHub for a variety of legitimate reasons. That "
+"is why you can also contact us in a more informal way."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid ""
+"On [our Mattermost "
+"chat](https://framateam.org/signup_user_complete/?id=e2680d3e3128b9fac8fdb3003b0024ee)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid ""
+"On [the mailing "
+"lists](https://freshrss.org/announce-of-the-mailing-lists.html)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid "At events / meetings around Free Software"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid "Over a beer in a bar"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:26
+msgid "Etc."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/02_Github.md:27
+#, no-wrap
+msgid "Tips"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:30
+msgid "Here are some tips to help you present your bug report or suggestion:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid "**Pay attention to spelling**. Even if it's not always easy, try your best!"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"**Give an explicit title to your request**, even if it's a bit long. This "
+"not only helps us understand your request, but also to find your ticket "
+"later."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"**One request = one ticket.** You may have lots of ideas while being afraid "
+"to spam the bug manager: it doesn't matter. It's better to have a few too "
+"many tickets than too many requests in one. We'll close and consolidate "
+"requests when possible."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"If you report a bug, think about **providing us with the FreshRSS logs** "
+"(accessible in the FreshRSS `data/log/` folder) and the **PHP logs** (the "
+"location may vary by distribution, but consider searching in "
+"`/var/log/httpd` or `/var/log/apache`)."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"If you can't find the log files, specify it in your ticket so we know you've "
+"already searched."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"Not all bugs require logs, but if you have any doubts, it is better to "
+"provide them to us. Logs are important and very useful for debugging!"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:39
+msgid ""
+"The logs may reveal confidential information, so **be careful not to "
+"disclose anything sensitive.**"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:41
+msgid ""
+"In addition, when facing a bug, you're encouraged to follow this message "
+"format (from the [Sam & Max "
+"website](http://sametmax.com/template-de-demande-daide-en-informatique/):"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/02_Github.md:42
+#, no-wrap
+msgid "What's my goal?"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:45
+msgid "Give the general context of what you were trying to do."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/02_Github.md:46
+#, no-wrap
+msgid "What have I been trying to do?"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:49
+msgid "Explain step by step what you have done so that we can reproduce the bug."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/02_Github.md:50
+#, no-wrap
+msgid "What results have I achieved?"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:53
+msgid ""
+"The bug: what you see that shouldn't have happened. Here you can provide the "
+"logs."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/02_Github.md:54
+#, no-wrap
+msgid "What was the expected result?"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:57
+msgid "So that we understand what you consider to be the problem."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/02_Github.md:58
+#, no-wrap
+msgid "What are my circumstances?"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:61
+msgid "Remember to give the following information if you know it:"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./developers/02_Github.md:67
+msgid "Which browser? Which version?"
+msgstr ""
+
+#. type: Bullet: ' 2. '
+#: en/./developers/02_Github.md:67
+msgid "Which server: Apache, Nginx? Which version?"
+msgstr ""
+
+#. type: Bullet: ' 3. '
+#: en/./developers/02_Github.md:67
+msgid "Which version of PHP?"
+msgstr ""
+
+#. type: Bullet: ' 4. '
+#: en/./developers/02_Github.md:67
+msgid "Which database: SQLite, MySQL, MariaDB, PostgreSQL? Which version?"
+msgstr ""
+
+#. type: Bullet: ' 5. '
+#: en/./developers/02_Github.md:67
+msgid "Which distribution runs on the server? And... which version?"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/02_Github.md:68
+#, no-wrap
+msgid "Branching"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/02_Github.md:70
+#, no-wrap
+msgid "Basic"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:72
+msgid "If you are new to Git, here are some of the resources you might find useful:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:77
+msgid "[GitHub's blog post](https://github.com/blog/120-new-to-git)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:77
+msgid "<http://try.github.com/>"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:77
+msgid "<http://sixrevisions.com/resources/git-tutorials-beginners/>"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/02_Github.md:77
+msgid "<http://rogerdudler.github.io/git-guide/>"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/02_Github.md:78
+#, no-wrap
+msgid "Getting the latest code from the FreshRSS repository"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:80
+msgid "First you need to add the official repo to your remote repo list:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:80
+#, no-wrap
+msgid "git remote add upstream git@github.com:FreshRSS/FreshRSS.git\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:85
+msgid "You can verify the remote repo is successfully added by using:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:85
+#, no-wrap
+msgid "git remote -v show\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:90
+msgid "Now you can pull the latest development code:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:90
+#, no-wrap
+msgid ""
+"git checkout dev\n"
+"git pull upstream dev\n"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/02_Github.md:95
+#, no-wrap
+msgid "Starting a new development branch"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:96
+#, no-wrap
+msgid "git checkout -b my-development-branch\n"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/02_Github.md:100
+#, no-wrap
+msgid "Sending a patch"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:102
+#, no-wrap
+msgid ""
+"# Add the changed file, here actualize_script.php\n"
+"git add app/actualize_script.php\n"
+"# Commit the change and write a proper commit message\n"
+"git commit\n"
+"# Double check all looks well\n"
+"git show\n"
+"# Push it to your fork\n"
+"git push\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:114
+msgid ""
+"Now you can create a PR based on your branch. Please make sure to file it "
+"against the `dev` branch!"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/02_Github.md:115
+#, no-wrap
+msgid "How to write a commit message"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:118
+msgid ""
+"A commit message should succintly describe the changes on the first "
+"line. For example:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:120
+#, no-wrap
+msgid "> Fix broken icon\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:122
+msgid "If necessary, this can be followed by a blank line and a longer explanation."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/02_Github.md:123
+msgid "For further tips, see [here](https://chris.beams.io/posts/git-commit/)."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:1
+#, no-wrap
+msgid "Models"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:5
+#, no-wrap
+msgid "Controllers and actions"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/02_Minz.md:9 en/./developers/03_Backend/05_Extensions.md:69
+#, no-wrap
+msgid "Views"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/02_Minz.md:13 en/./developers/03_Backend/05_Extensions.md:39
+#, no-wrap
+msgid "Routing"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:17
+#, no-wrap
+msgid "Writing URL"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:21 en/./developers/04_Frontend/01_View_files.md:13
+#, no-wrap
+msgid "Internationalisation"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/02_Minz.md:25
+#, no-wrap
+msgid "Understanding internals"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/04_Changing_source_code.md:1
+#, no-wrap
+msgid "Accessing the database"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/04_Changing_source_code.md:5
+#, no-wrap
+msgid "Writing an action and its related view"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/04_Changing_source_code.md:9
+#, no-wrap
+msgid "Authentication"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/04_Changing_source_code.md:13
+#, no-wrap
+msgid "Logs"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/03_Backend/05_Extensions.md:1
+#, no-wrap
+msgid "Writing extensions for FreshRSS"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/03_Backend/05_Extensions.md:3
+#, no-wrap
+msgid "About FreshRSS"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:6
+msgid ""
+"FreshRSS is an RSS / Atom feed aggregator written in PHP dating back to "
+"October 2012. The official site is located at "
+"[freshrss.org](https://freshrss.org) and the official repository is hosted "
+"on Github: "
+"[github.com/FreshRSS/FreshRSS](https://github.com/FreshRSS/FreshRSS)."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/03_Backend/05_Extensions.md:7
+#, no-wrap
+msgid "The problem"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:10
+msgid "FreshRSS is limited in its technical possibilities by various factors:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:14
+msgid "The number of developers"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:14
+msgid "The will to integrate certain changes"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:14
+msgid "The level of \"hacking\" required to integrate marginal features"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:16
+msgid ""
+"While the first limitation can, in theory, be lifted by the participation of "
+"new contributors to the project, it depends on the willingness of "
+"contributors to take an interest in the source code of the entire "
+"project. In order to remove the other two limitations, most of the time it "
+"will be necessary to create a \"fork\"."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:18
+msgid ""
+"Another solution consists of an extension system. By allowing users to write "
+"their own extension without taking an interest in the core of the basic "
+"software, we allow for:"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./developers/03_Backend/05_Extensions.md:22
+msgid "Reducing the amount of source code a new contributor has to take in"
+msgstr ""
+
+#. type: Bullet: '2. '
+#: en/./developers/03_Backend/05_Extensions.md:22
+msgid "Unofficial integration of novelties"
+msgstr ""
+
+#. type: Bullet: '3. '
+#: en/./developers/03_Backend/05_Extensions.md:22
+msgid "No forking or main developer approval required."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:24
+msgid ""
+"Note: it is quite conceivable that the functionalities of an extension can "
+"later be officially integrated into the FreshRSS code. Extensions make it "
+"easy to propose a proof of concept."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/03_Backend/05_Extensions.md:25
+#, no-wrap
+msgid "Understanding basic mechanics (Minz and MVC)"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:28
+#, no-wrap
+msgid "**TODO** : move to 02_Minz.md\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:30
+msgid ""
+"This data sheet should refer to the official FreshRSS and Minz documentation "
+"(the PHP framework on which FreshRSS is based). Unfortunately, this "
+"documentation does not yet exist. In a few words, here are the main things "
+"you should know. It is not necessary to read all the chapters in this "
+"section if you don't need to use a feature in your extension (if you don't "
+"need to translate your extension, no need to know more about the "
+"`Minz_Translate` module for example)."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:31
+#, no-wrap
+msgid "MVC Architecture"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:34
+msgid ""
+"Minz relies on and imposes an MVC architecture on projects using it. This "
+"architecture consists of three main components:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:38
+msgid ""
+"The model: this is the base object that we will manipulate. In FreshRSS, "
+"categories, flows and articles are templates. The part of the code that "
+"makes it possible to manipulate them in a database is also part of the model "
+"but is separated from the base model: we speak of DAO (for \"Data Access "
+"Object\"). The templates are stored in a `Models` folder."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:38
+msgid ""
+"The view: this is what the user sees. The view is therefore simply HTML code "
+"mixed with PHP to display dynamic information. The views are stored in a "
+"`views` folder."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:38
+msgid ""
+"The controller: this is what makes it possible to link models and "
+"views. Typically, a controller will load templates from the database (like a "
+"list of items) to \"pass\" them to a view for display. Controllers are "
+"stored in a `Controllers` directory."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:42
+msgid ""
+"In order to link a URL to a controller, first you have to go through a "
+"\"routing\" phase. In FreshRSS, this is particularly simple because it "
+"suffices to specify the name of the controller to load into the URL using a "
+"`c` parameter. For example, the address http://exemple.com?c=hello will "
+"execute the code contained in the `hello` controller."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:44
+msgid ""
+"One concept that has not yet been discussed is the \"actions\" system. An "
+"action is executed *on* a controller. Concretely, a controller is "
+"represented by a class and its actions by methods. To execute an action, it "
+"is necessary to specify an `a` parameter in the URL."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:46 en/./developers/03_Backend/05_Extensions.md:165
+msgid "Code example:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:47
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"class FreshRSS_hello_Controller extends Minz_ActionController {\n"
+"\tpublic function indexAction() {\n"
+"\t\t$this->view->a_variable = 'FooBar';\n"
+"\t}\n"
+"\n"
+"\tpublic function worldAction() {\n"
+"\t\t$this->view->a_variable = 'Hello World!';\n"
+"\t}\n"
+"}\n"
+"\n"
+"?>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:64
+msgid ""
+"When loading the address http://exemple.com?c=hello&a=world, the `world` "
+"action is executed on the `hello` controller."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:66
+msgid ""
+"Note: if `c` or `a` is not specified, the default value for each of these "
+"variables is `index`. So the address http://exemple.com?c=hello will execute "
+"the `index` action of the `hello` controller."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:68
+msgid ""
+"From now on, the `hello/world` naming convention will be used to refer to a "
+"controller/action pair."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:72
+msgid ""
+"Each view is associated with a controller and an action. The view associated "
+"with `hello/world` will be stored in a very specific file: "
+"`views/hello/world. phtml`. This convention is imposed by Minz."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:74
+msgid "As explained above, the views consist of HTML mixed with PHP. Code example:"
+msgstr ""
+
+#. type: Code fence info string
+#: en/./developers/03_Backend/05_Extensions.md:75 en/./developers/03_Backend/05_Extensions.md:120 en/./developers/03_Backend/05_Extensions.md:248 en/./developers/03_Backend/05_Extensions.md:284 en/./developers/03_Backend/05_Extensions.md:351
+#, no-wrap
+msgid "html"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:75
+#, no-wrap
+msgid ""
+"<p>\n"
+"\tThis is a parameter passed from the controller: <?= $this->a_variable ?>\n"
+"</p>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:82
+#, no-wrap
+msgid ""
+"The variable `$this->a_variable` is passed by the controller (see previous "
+"example). The difference is that in the controller it is necessary to pass "
+"`$this->view`, while in the view `$this` suffices.\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:83
+#, no-wrap
+msgid "Working with GET / POST"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:87
+msgid ""
+"It is often necessary to take advantage of parameters passed by GET or "
+"POST. In Minz, these parameters are accessible using the `Minz_Request` "
+"class.  Code example:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:88
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"$default_value = 'foo';\n"
+"$param = Minz_Request::param('bar', $default_value);\n"
+"\n"
+"// Display the value of the parameter `bar` (passed via GET or POST)\n"
+"// or \"foo\" if the parameter does not exist.\n"
+"echo $param;\n"
+"\n"
+"// Sets the value of the `bar` parameter\n"
+"Minz_Request::_param('bar', 'baz');\n"
+"\n"
+"// Will necessarily display \"baz\" since we have just forced its value.\n"
+"// Note that the second parameter (default) is optional.\n"
+"echo Minz_Request::param('bar');\n"
+"\n"
+"?>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:109
+msgid ""
+"The `Minz_Request::isPost()` method can be used to execute a piece of code "
+"only if it is a POST request."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:111
+msgid ""
+"Note: it is preferable to use `Minz_Request` only in controllers. It is "
+"likely that you will encounter this method in FreshRSS views, or even in "
+"templates, but be aware that this is **not** good practice."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:112
+#, no-wrap
+msgid "Access session settings"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:115
+msgid ""
+"The access to session parameters is strangely similar to the GET / POST "
+"parameters but passes through the `Minz_Session` class this time! There is "
+"no example here because you can repeat the previous example by changing all "
+"`Minz_Request` to `Minz_Session`."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:116
+#, no-wrap
+msgid "Working with URLs"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:119
+msgid ""
+"To take full advantage of the Minz routing system, it is strongly "
+"discouraged to write hard URLs in your code. For example, the following view "
+"should be avoided:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:120
+#, no-wrap
+msgid ""
+"<p>\n"
+"\tGo to page <a href=\"http://example.com?c=hello&amp;a=world\">Hello "
+"world</a>!\n"
+"</p>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:127
+msgid ""
+"If one day it was decided to use a \"url rewriting\" system to have "
+"addresses in a http://exemple.com/controller/action format, all previous "
+"addresses would become ineffective!"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:129
+msgid ""
+"So use the `Minz_Url` class and its `display()` method "
+"instead. `Minz_Url::display()` takes an array of the following form as its "
+"argument:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:130
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"\t'params' => [\n"
+"\t\t'foo' => 'bar',\n"
+"\t],\n"
+"];\n"
+"\n"
+"// Show something like .?c=hello&amp;a=world&amp;foo=bar\n"
+"echo Minz_Url::display($url_array);\n"
+"\n"
+"?>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:148
+msgid ""
+"Since this can become a bit tedious to use in the long run, especially in "
+"views, it is preferable to use the `_url()` shortcut:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:149
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"// Displays the same as above\n"
+"echo _url('hello', 'world', 'foo', 'bar');\n"
+"\n"
+"?>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:159
+msgid ""
+"Note: as a general rule, the shortened form (`_url()`) should be used in "
+"views, while the long form (`Minz_Url::display()`) should be used in "
+"controllers."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:160
+#, no-wrap
+msgid "Redirections"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:163
+msgid ""
+"It is often necessary to redirect a user to another page. To do so, the "
+"`Minz_Request` class offers another useful method: `forward()`. This method "
+"takes the same URL format as the one seen just before as its argument."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:166
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"];\n"
+"\n"
+"// Tells Minz to redirect the user to the hello / world page.\n"
+"// Note that this is a redirection in the Minz sense of the term, not a "
+"redirection that the browser will have to manage (HTTP code 301 or 302)\n"
+"// The code that follows forward() will thus be executed!\n"
+"Minz_Request::forward($url_array);\n"
+"\n"
+"// To perform a type 302 redirect, add \"true\".\n"
+"// The code that follows will never be executed.\n"
+"Minz_Request::forward($url_array, true);\n"
+"\n"
+"?>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:187
+msgid ""
+"It is very common to want display a message to the user while performing a "
+"redirect, to tell the user how the action was carried out (validation of a "
+"form for example). Such a message is passed through a `notification` session "
+"variable (note: we will talk about feedback from now on to avoid confusion "
+"with a notification that can occur at any time). To facilitate this kind of "
+"very frequent action, there are two shortcuts that both perform a 302 "
+"redirect by assigning a feedback message:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:188
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"$url_array = [\n"
+"\t'c' => 'hello',\n"
+"\t'a' => 'world',\n"
+"];\n"
+"$feedback_good = 'All went well!';\n"
+"$feedback_bad = 'Oops, something went wrong.';\n"
+"\n"
+"Minz_Request::good($feedback_good, $url_array);\n"
+"\n"
+"// or\n"
+"\n"
+"Minz_Request::bad($feedback_bad, $url_array);\n"
+"\n"
+"?>\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:207
+#, no-wrap
+msgid "Translation Management"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:210
+msgid ""
+"It is common (and that's an understatement) to want to show some text to the "
+"user. In the previous example, for example, we display feedback to the user "
+"based on the result of form validation. The problem is that FreshRSS has "
+"users of different nationalities. It is therefore necessary to be able to "
+"manage different languages in order not to remain confined to English or "
+"French."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:212
+msgid ""
+"The solution is to use the `Minz_Translate` class, which allows dynamic "
+"translation of FreshRSS (or any Minz-based application). Before using this "
+"module, it is necessary to know where to find the strings to be "
+"translated. Each language has its own subdirectory in a parent directory "
+"named `i18n`. For example, English language files are located in "
+"`i18n/fr/`. There are seven different files:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`admin.php` for anything related to FreshRSS administration"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`conf.php` for configuration"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`feedback.php` contains translations of feedback messages"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`gen.php` stores what is global to FreshRSS (gen for \"general\")"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`index.php` for the main page that lists feeds and the About page"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`install.php` contains strings related FreshRSS installation"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:220
+msgid "`sub.php` for subscription management (sub for \"subscription\")"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:222
+msgid "This organization makes it possible to avoid a single huge translation file."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:224
+msgid ""
+"The translation files are quite simple: it's only a matter of returning a "
+"PHP table containing the translations. As an example, here's an extract from "
+"`app/i18n/fr/gen.php`:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:225
+#, no-wrap
+msgid ""
+"<?php\n"
+"\n"
+"return array(\n"
+"\t'action' => [\n"
+"\t\t'actualize' => 'Actualiser',\n"
+"\t\t'back_to_rss_feeds' => '← Retour à vos flux RSS',\n"
+"\t\t'cancel' => 'Annuler',\n"
+"\t\t'create' => 'Créer',\n"
+"\t\t'disable' => 'Désactiver',\n"
+"\t),\n"
+"\t'freshrss' => array(\n"
+"\t\t'_' => 'FreshRSS',\n"
+"\t\t'about' => 'À propos de FreshRSS',\n"
+"\t),\n"
+"];\n"
+"\n"
+"?>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:247
+msgid ""
+"To access these translations, `Minz_Translate` will help us with its "
+"`Minz_Translate::t()` method. As this can be a bit long to type, a shortcut "
+"has been introduced that **must** be used in all circumstances: `_t()`.  "
+"Code example:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:248
+#, no-wrap
+msgid ""
+"<p>\n"
+"\t<a href=\"<?= _url('index', 'index') ?>\">\n"
+"\t\t<?= _t('gen.action.back_to_rss_feeds') ?>\n"
+"\t</a>\n"
+"</p>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:257
+msgid ""
+"The string to pass to the `_t()` function consists of a series of "
+"identifiers separated by dots. The first identifier indicates from which "
+"file to extract the translation (in this case, `gen.php`), while the "
+"following ones indicate table entries. Thus `action` is an entry of the main "
+"array and `back_to_rss_feeds` is an entry of the `action` array. This allows "
+"us to further organize our translation files."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:259
+msgid ""
+"There is a small special case that sometimes makes life easier: the `_` "
+"identifier. This must necessarily be present at the end of the chain and "
+"gives a value to the higher-level identifier. It's pretty hard to explain "
+"but very simple to understand. In the example given above, a `_` is "
+"associated with the value `FreshRSS`: this means that there is no need to "
+"write `_t('gen.freshrss._')` but `_t('gen.freshrss')` suffices."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:260
+#, no-wrap
+msgid "Configuration management"
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/03_Backend/05_Extensions.md:262
+#, no-wrap
+msgid "Write an extension for FreshRSS"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:265
+msgid ""
+"Here we are! We've talked about the most useful features of Minz and how to "
+"run FreshRSS correctly and it's about time to address the extensions "
+"themselves."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:267
+msgid ""
+"An extension allows you to easily add functionality to FreshRSS without "
+"having to touch the core of the project directly."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:268
+#, no-wrap
+msgid "Basic files and folders"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:273
+msgid ""
+"The first thing to note is that **all** extensions **must** be located in "
+"the `extensions` directory, at the base of the FreshRSS tree.  An extension "
+"is a directory containing a set of mandatory (and optional) files and "
+"subdirectories.  The convention requires that the main directory name be "
+"preceded by an \"x\" to indicate that it is not an extension included by "
+"default in FreshRSS."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:275
+msgid ""
+"The main directory of an extension must contain at least two **mandatory** "
+"files:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:278
+msgid ""
+"A `metadata.json` file that contains a description of the extension. This "
+"file is written in JSON."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:278
+msgid ""
+"An `extension.php` file containing the entry point of the extension (which "
+"is a class that inherits Minz_Extension)."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:282
+msgid ""
+"Please note that there is a not a required link between the directory name "
+"of the extension and the name of the class inside `extension.php`, but you "
+"should follow our best practice: If you want to write a `HelloWorld` "
+"extension, the directory name should be `xExtension-HelloWorld` and the base "
+"class name `HelloWorldExtension`."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:284
+msgid ""
+"In the file `freshrss/extensions/xExtension-HelloWorld/extension.php` you "
+"need the structure:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:284
+#, no-wrap
+msgid ""
+"class HelloWorldExtension extends Minz_Extension {\n"
+"\tpublic function init() {\n"
+"\t\t// your code here\n"
+"\t}\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:292
+msgid ""
+"There is an example HelloWorld extension that you can download from [our "
+"GitHub repo](https://github.com/FreshRSS/xExtension-HelloWorld)."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:294
+msgid ""
+"You may also need additional files or subdirectories depending on your "
+"needs:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid ""
+"`configure.phtml` is the file containing the form to parameterize your "
+"extension"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid ""
+"A `static/` directory containing CSS and JavaScript files that you will need "
+"for your extension (note that if you need to write a lot of CSS it may be "
+"more interesting to write a complete theme)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid "A `Controllers` directory containing additional controllers"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid "An `i18n` directory containing additional translations"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:300
+msgid ""
+"`layout` and` views` directories to define new views or to overwrite the "
+"current views"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:302
+msgid ""
+"In addition, it is good to have a `LICENSE` file indicating the license "
+"under which your extension is distributed and a` README` file giving a "
+"detailed description of it."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:303
+#, no-wrap
+msgid "The metadata.json file"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:306
+msgid ""
+"The `metadata.json` file defines your extension through a number of "
+"important elements. It must contain a valid JSON array containing the "
+"following entries:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid "`name`: the name of your extension"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid ""
+"`author`: your name, your e-mail address ... but there is no specific format "
+"to adopt"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid "`description`: a description of your extension"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid "`version`: the current version number of the extension"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid ""
+"`entrypoint`: Indicates the entry point of your extension. It must match the "
+"name of the class contained in the file `extension.php` without the suffix` "
+"Extension` (so if the entry point is `HelloWorld`, your class will be "
+"called` HelloWorldExtension`)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:313
+msgid ""
+"`type`: Defines the type of your extension. There are two types: `system` "
+"and` user`. We will study this difference right after."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:315
+msgid "Only the `name` and` entrypoint` fields are required."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:316
+#, no-wrap
+msgid "Choosing between `system` and `user`"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:319
+msgid ""
+"A __user__ extension can be enabled by some users and not by others "
+"(typically for user preferences)."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:321
+msgid "A __system__ extension in comparison is enabled for every account."
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:322
+#, no-wrap
+msgid "Writing your own extension.php"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:327
+msgid ""
+"This file is the entry point of your extension. It must contain a specific "
+"class to function.  As mentioned above, the name of the class must be your "
+"`entrypoint` suffixed by` Extension` (`HelloWorldExtension` for example).  "
+"In addition, this class must be inherited from the `Minz_Extension` class to "
+"benefit from extensions-specific methods."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:329
+msgid "Your class will benefit from four methods to redefine:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:334
+msgid ""
+"`install()` is called when a user clicks the button to activate your "
+"extension. It allows, for example, to update the database of a user in order "
+"to make it compatible with the extension. It returns `true` if everything "
+"went well or, if not, a string explaining the problem."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:334
+msgid ""
+"`uninstall()` is called when a user clicks the button to disable your "
+"extension. This will allow you to undo the database changes you potentially "
+"made in `install ()`. It returns `true` if everything went well or, if not, "
+"a string explaining the problem."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:334
+msgid ""
+"`init()` is called for every page load *if the extension is enabled*. It "
+"will therefore initialize the behavior of the extension. This is the most "
+"important method."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:334
+msgid ""
+"`handleConfigureAction()` is called when a user loads the extension "
+"management panel. Specifically, it is called when the "
+"`?c=extension&a=configured&e=name-of-your-extension` URL is loaded. You "
+"should also write here the behavior you want when validating the form in "
+"your `configure.phtml` file."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:336
+msgid ""
+"In addition, you will have a number of methods directly inherited from "
+"`Minz_Extension` that you should not redefine:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:340
+msgid ""
+"The \"getters\" first: most are explicit enough not to detail them here - "
+"`getName()`, `getEntrypoint()`, `getPath()` (allows you to retrieve the path "
+"to your extension), `getAuthor()`, `getDescription()`, `getVersion()`, "
+"`getType()`."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:340
+msgid ""
+"`getFileUrl($filename, $type)` will return the URL to a file in the `static` "
+"directory. The first parameter is the name of the file (without `static /`), "
+"the second is the type of file to be used (`css` or` js`)."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:340
+msgid ""
+"`registerController($base_name)` will tell Minz to take into account the "
+"given controller in the routing system. The controller must be located in "
+"your `Controllers` directory, the name of the file must be` "
+"<base_name>Controller.php` and the name of the "
+"`FreshExtension_<base_name>_Controller` class."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:346
+msgid "`registerViews()`"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:346
+msgid "`registerTranslates()`"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:346
+msgid "`registerHook($hook_name, $hook_function)`"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:347
+#, no-wrap
+msgid "The \"hooks\" system"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:350
+msgid ""
+"You can register at the FreshRSS event system in an extensions `init()` "
+"method, to manipulate data when some of the core functions are executed."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:351
+#, no-wrap
+msgid ""
+"class HelloWorldExtension extends Minz_Extension\n"
+"{\n"
+"\tpublic function init() {\n"
+"\t\t$this->registerHook('entry_before_display', array($this, "
+"'renderEntry'));\n"
+"\t}\n"
+"\tpublic function renderEntry($entry) {\n"
+"\t\t$entry->_content('<h1>Hello World</h1>' . $entry->content());\n"
+"\t\treturn $entry;\n"
+"\t}\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:365
+msgid "The following events are available:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`entry_before_display` (`function($entry) -> Entry | null`): will be "
+"executed every time an entry is rendered. The entry itself (instance of "
+"FreshRSS\\_Entry) will be passed as parameter."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`entry_before_insert` (`function($entry) -> Entry | null`): will be executed "
+"when a feed is refreshed and new entries will be imported into the "
+"database. The new entry (instance of FreshRSS\\_Entry) will be passed as "
+"parameter."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`feed_before_insert` (`function($feed) -> Feed | null`): will be executed "
+"when a new feed is imported into the database. The new feed (instance of "
+"FreshRSS\\_Feed) will be passed as parameter."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`freshrss_init` (`function() -> none`): will be executed at the end of the "
+"initialization of FreshRSS, useful to initialize components or to do "
+"additional access checks"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`menu_admin_entry` (`function() -> string`): add an entry at the end of the "
+"\"Administration\" menu, the returned string must be valid HTML (e.g. `<li "
+"class=\"item active\"><a href=\"url\">New entry</a></li>`)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`menu_configuration_entry` (`function() -> string`): add an entry at the end "
+"of the \"Configuration\" menu, the returned string must be valid HTML "
+"(e.g. `<li class=\"item active\"><a href=\"url\">New entry</a></li>`)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`menu_other_entry` (`function() -> string`): add an entry at the end of the "
+"header dropdown menu (i.e. after the \"About\" entry), the returned string "
+"must be valid HTML (e.g. `<li class=\"item active\"><a href=\"url\">New "
+"entry</a></li>`)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`nav_reading_modes` (`function($reading_modes) -> array | null`): **TODO** "
+"add documentation"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid "`post_update` (`function(none) -> none`): **TODO** add documentation"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/03_Backend/05_Extensions.md:376
+msgid ""
+"`simplepie_before_init` (`function($simplePie, $feed) -> none`): **TODO** "
+"add documentation"
+msgstr ""
+
+#. type: Title ###
+#: en/./developers/03_Backend/05_Extensions.md:377
+#, no-wrap
+msgid "Writing your own configure.phtml"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/03_Backend/05_Extensions.md:380
+msgid ""
+"When you want to support user configurations for your extension or simply "
+"display some information, you have to create the `configure.phtml` file."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/04_Frontend/01_View_files.md:1
+#, no-wrap
+msgid "The .phtml files"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/04_Frontend/01_View_files.md:5
+#, no-wrap
+msgid "Writing a URL"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/04_Frontend/01_View_files.md:9
+#, no-wrap
+msgid "Displaying an icon"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/04_Frontend/02_Design.md:1
+#, no-wrap
+msgid "Template file"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/04_Frontend/02_Design.md:5
+#, no-wrap
+msgid "Writing a new theme"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/04_Frontend/02_Design.md:9
+#, no-wrap
+msgid "Overriding icons"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:1
+#, no-wrap
+msgid "Preparing the release"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:4
+msgid ""
+"In order to get as much feedback as possible before a release, it's "
+"preferable to announce it on GitHub by creating a dedicated ticket ([see "
+"examples] "
+"(https://github.com/FreshRSS/FreshRSS/search?utf8=%E2%9C%93&q=Call+for+testing&type=Issues)). "
+"This should be done **at least one week in advance**."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:6
+msgid "It's also recommended to make the announcement on mailing@freshrss.org."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:7
+#, no-wrap
+msgid "Check the dev status"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:10
+msgid ""
+"Before releasing a new version of FreshRSS, you must ensure that the code is "
+"stable and free of major bugs. Ideally, our tests should be automated and "
+"executed before any publication."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:12
+msgid ""
+"You must also **make sure that the CHANGELOG file is up to date** in the dev "
+"branch with the updates of the version(s) to be released."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:13
+#, no-wrap
+msgid "Git process"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:15
+#, no-wrap
+msgid ""
+"$ git checkout master\n"
+"$ git pull\n"
+"$ git merge --ff dev\n"
+"$ vim constants.php\n"
+"# Update version number x.y.y.z of FRESHRSS_VERSION\n"
+"$ git commit -a\n"
+"Version x.y.z\n"
+"$ git tag -a x.y.z\n"
+"Version x.y.z\n"
+"$ git push && git push --tags\n"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:28
+#, no-wrap
+msgid "Updating `update.freshrss.org`"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:31
+msgid ""
+"It's important to update update.freshrss.org since this is the default "
+"service for automatic FreshRSS updates."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:33
+msgid ""
+"The repository managing the code is located on GitHub: "
+"[FreshRSS/update.freshrss.org] "
+"(https://github.com/FreshRSS/update.freshrss.org/)."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/05_Release_new_version.md:34
+#, no-wrap
+msgid "Writing the update script"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:37
+msgid ""
+"The scripts are located in the `./scripts/` directory and must take the form "
+"`update_to_x.y.z.z.php`. This directory also contains `update_to_dev.php` "
+"intended for updates of the dev branch (this script must not include code "
+"specific to a particular version!) and `update_util.php`, which contains a "
+"list of functions useful for all scripts."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:39
+msgid ""
+"In order to write a new script, it's better to copy/paste the last version "
+"or to start from `update_to_dev.php`. The first thing to do is to define the "
+"URL from which the FreshRSS package will be downloaded (`PACKAGE_URL`). The "
+"URL is in the form of "
+"`https://codeload.github.com/FreshRSS/FreshRSS/zip/x.y.z`."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:41
+msgid "There are then 5 functions that have to be executed:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`apply_update()` takes care of saving the directory containing the data, "
+"checking its structure, downloading the FreshRSS package, deploying it and "
+"cleaning it all up. This function is pre-filled but adjustments can be made "
+"if necessary (e.g., reorganization of the `./data` structure). It returns "
+"`true` if no problem has occurred or a string indicating a problem;"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`need_info_update()` returns `true` if the user must intervene during the "
+"update or `false` if not;"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`ask_info_update()` displays a form to the user if `need_info_update()` has "
+"returned `true`;"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`save_info_update()` is responsible for saving the information filled out by "
+"the user (from the `ask_info_update()` form);"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:47
+msgid ""
+"`do_post_update()` is executed at the end of the update and takes into "
+"account the code of the new version (e.g., if the new version changes the "
+"`Minz_Configuration` object, you will benefit from these improvements)."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/05_Release_new_version.md:48
+#, no-wrap
+msgid "Updating the versions file"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:51
+msgid ""
+"Once the script has been written and versioned, it's necessary to update the "
+"`./versions.php' file which contains a mapping table indicating which "
+"versions are updated to which other versions."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:53
+msgid "Here's an example of a `versions.php` file:"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:54
+#, no-wrap
+msgid ""
+"<?php\n"
+"return array(\n"
+"\t// STABLE\n"
+"\t'0.8.0' => '1.0.0',\n"
+"\t'0.8.1' => '1.0.0',\n"
+"\t'1.0.0' => '1.0.1',  // doesn't exist (yet)\n"
+"\t// DEV\n"
+"\t'1.1.2-dev' => 'dev',\n"
+"\t'1.1.3-dev' => 'dev',\n"
+"\t'1.1.4-dev' => 'dev',\n"
+");\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:69
+msgid "And here's how this table works:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid "on the left you can find the N version, on the right the N+1 version;"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid "the `x.y.z.z-dev` versions are **all** updated to `dev`;"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid "stable versions are updated to stable versions;"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid ""
+"it's possible to skip several versions at once, provided that the update "
+"scripts support it;"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:75
+msgid ""
+"it's advisable to indicate the correspondence of the current version to its "
+"potential future version by specifying that this version does not yet "
+"exist. As long as the corresponding script does not exist, nothing will "
+"happen."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:77
+msgid ""
+"It's **very strongly** recommended to keep this file organized according to "
+"version numbers by separating stable and dev versions."
+msgstr ""
+
+#. type: Title ##
+#: en/./developers/05_Release_new_version.md:78
+#, no-wrap
+msgid "Deployment"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:81
+msgid ""
+"Before updating update.freshrss.org, it's better to test with "
+"dev.update.freshrss.org, which corresponds to pre-production. So update "
+"dev.update.freshrss.org and change the `FRESHRSS_UPDATE_WEBSITE` URL of your "
+"FreshRSS instance. Start the update and check that it's running correctly."
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:83
+msgid ""
+"When you're satisfied, update update.freshrss.org with the new script, test "
+"it again, and then move on."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:84
+#, no-wrap
+msgid "Updating the FreshRSS services"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:87
+msgid "Two services need to be updated immediately after the update."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:90
+msgid "rss.freshrss.org;"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:90
+msgid "demo.freshrss.org (public login: `demo` / `demodemo`)."
+msgstr ""
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:91
+#, no-wrap
+msgid "Publicly announce the release"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:94
+msgid "When everything's working, it's time to announce the release to the world!"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:99
+msgid ""
+"on GitHub by creating[a new "
+"release](https://github.com/FreshRSS/FreshRSS/releases/new)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:99
+msgid ""
+"on the freshrss.org blog, at least for stable versions (write the article "
+"on[FreshRSS/freshrss.org](https://github.com/FreshRSS/freshrss.org))"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:99
+msgid "on Twitter ([@FreshRSS](https://twitter.com/FreshRSS) account)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./developers/05_Release_new_version.md:99
+msgid "and on mailing@freshrss.org"
+msgstr ""
+
+#. type: Title #
+#: en/./developers/05_Release_new_version.md:100
+#, no-wrap
+msgid "Starting the next development version"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:102
+#, no-wrap
+msgid ""
+"$ git checkout dev\n"
+"$ vim constants.php\n"
+"# Update the FRESHRSS_VERSION\n"
+"$ vim CHANGELOG.md\n"
+"# Prepare the changelog for the next version\n"
+"$ git add CHANGELOG.md && git commit && git push\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./developers/05_Release_new_version.md:111
+msgid ""
+"Also remember to update update.freshrss.org so that it takes the current "
+"development version into account."
+msgstr ""
+
+#. type: Plain text
+#: en/./index.md:2
+msgid "![FreshRSS logo](img/logo_freshrss.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./index.md:4
+msgid ""
+"FreshRSS is an RSS aggregator and reader. It allows you to read and follow "
+"several news websites at a glance without the need to browse from one "
+"website to another."
+msgstr ""
+
+#. type: Plain text
+#: en/./index.md:6
+msgid "FreshRSS has a lot of features including:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "RSS and Atom aggregation"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Mark article as favorite if you liked it or if you want to read it later"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Filter and search functionality helps to easily find articles"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Statistics to show you the publishing frequency all the websites you follow"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Import/export of your feeds into OPML format"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Several themes created by the community"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "\"Google Reader\"-like API to connect Android applications"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid ""
+"The application is \"responsive,\" which means it adapts to small screens so "
+"you can bring articles in your pocket"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid ""
+"Self-hosted: the code is free (under AGPL3 licence), so you can host your "
+"own instance of FreshRSS"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "Multi-user, so you can also host for your friends and family"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:18
+msgid "And a lot more!"
+msgstr ""
+
+#. type: Plain text
+#: en/./index.md:20
+msgid "This documentation is split into different sections:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:24
+msgid ""
+"[User documentation](./users/02_First_steps.html), where you can discover "
+"all the possibilities offered by FreshRSS"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:24
+msgid ""
+"[Administrator documentation](./admins/01_Index.html) for detailed "
+"installation and maintenance related tasks"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:24
+msgid ""
+"[Developer documentation](./developers/01_First_steps.html) to guide you in "
+"the source code of FreshRSS and to help you if you want to contribute"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./index.md:24
+msgid ""
+"[Contributor guidelines](./contributing.md) for those who want to help "
+"improve FreshRSS"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:2
+msgid ""
+"Learning how to handle a new application is not always easy. We've tried to "
+"make FreshRSS as intuitive as possible, but you might still need a little "
+"help to master the program."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:4
+msgid ""
+"This section will guide you to the pages you need to get started. The order "
+"is tailored to newcomers."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:6
+msgid ""
+"[After installing the application](../admins/03_Installation.md), the first "
+"step is to add some feeds. You have a few options:"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./users/02_First_steps.md:10
+msgid "[Add a feed manually](04_Subscriptions.md#adding-a-feed)"
+msgstr ""
+
+#. type: Bullet: '2. '
+#: en/./users/02_First_steps.md:10
+msgid "[Import an OPML or JSON file](04_Subscriptions.md#import-and-export)"
+msgstr ""
+
+#. type: Bullet: '3. '
+#: en/./users/02_First_steps.md:10
+msgid "[Use the bookmarklet](04_Subscriptions.md#use-bookmarklet)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:12
+msgid ""
+"Once you have added your feeds to FreshRSS, it is time to read them. There "
+"are three availalbe reading modes:"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./users/02_First_steps.md:16
+msgid ""
+"[The normal view](03_Main_view.md#normal-view) enables you to quickly read "
+"new articles"
+msgstr ""
+
+#. type: Bullet: '2. '
+#: en/./users/02_First_steps.md:16
+msgid ""
+"[The global view](03_Main_view.md#global-view) shows you an overview of the "
+"status of your feeds in one glance"
+msgstr ""
+
+#. type: Bullet: '3. '
+#: en/./users/02_First_steps.md:16
+msgid ""
+"[The reader view](03_Main_view.md#reader-view) offers you a comfortable "
+"reading experience"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/02_First_steps.md:18
+msgid ""
+"Now that you've mastered basic use, it's time to configure FreshRSS to "
+"improve your reading experience. It's highly configurable, so it's "
+"recommended to play around with them to find a configuration that suits you "
+"well. Here are a few resources to help you improve your daily FreshRSS "
+"experience:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Organize your feeds in categories](04_Subscriptions.md#feed-management)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Change the home page](05_Configuration.md#changing-the-view)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Choose the reading options](05_Configuration.md#reading-options)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Refresh feeds](03_Main_view.md#refreshing-feeds)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid ""
+"[Filter articles](03_Main_view.md#filtering-articles) for a fast access to a "
+"selection"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid ""
+"[Search an article](03_Main_view.md#searching-articles) published some time "
+"ago"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Access your feeds on a mobile device](06_Mobile_access.md)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Add some extensions](https://github.com/FreshRSS/Extensions)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/02_First_steps.md:27
+msgid "[Frequently asked questions](07_Frequently_Asked_Questions.md)"
+msgstr ""
+
+#. type: Title #
+#: en/./users/03_Main_view.md:1
+#, no-wrap
+msgid "Normal view"
+msgstr ""
+
+#. type: Title #
+#: en/./users/03_Main_view.md:5
+#, no-wrap
+msgid "Global view"
+msgstr ""
+
+#. type: Title #
+#: en/./users/03_Main_view.md:9
+#, no-wrap
+msgid "Reader view"
+msgstr ""
+
+#. type: Title #
+#: en/./users/03_Main_view.md:13
+#, no-wrap
+msgid "Refreshing feeds"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:16
+msgid ""
+"To take full advantage of FreshRSS, it needs to retrieve new items from the "
+"feeds you have subscribed to. There are several ways to do this."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:17
+#, no-wrap
+msgid "Automatic update"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:20
+msgid ""
+"This is the recommended method since you can forget about it once it is "
+"configured."
+msgstr ""
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:21
+#, no-wrap
+msgid "With the actualize_script.php script"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:24
+msgid ""
+"This method is only available if you have access to the scheduled tasks of "
+"the machine on which your FreshRSS instance is installed."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:26
+msgid ""
+"The script is named *actualize_script.php* and is located in the *app* "
+"folder. The scheduled task syntax will not be explained here. However, here "
+"is [a quick introduction to "
+"crontab](http://www.adminschoice.com/crontab-quick-reference/) that might "
+"help you."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:28
+msgid "Here is an example to trigger article update every hour."
+msgstr ""
+
+#. type: Code fence info string
+#: en/./users/03_Main_view.md:29 en/./users/03_Main_view.md:61 en/./users/03_Main_view.md:79 en/./users/03_Main_view.md:85 en/./users/03_Main_view.md:93
+#, no-wrap
+msgid "cron"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:29
+#, no-wrap
+msgid ""
+"0 * * * * php /path/to/FreshRSS/app/actualize_script.php > /tmp/FreshRSS.log "
+"2>&1\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:34
+msgid "Special parameters to configure the script - all parameters can be combined:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:38
+msgid ""
+"- Parameter \"force\" "
+"https://freshrss.example.net/i/?c=feed&a=actualize&force=1 If *force* is set "
+"to 1 all feeds will be refreshed at once."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:42
+msgid ""
+"- Parameter \"ajax\" "
+"https://freshrss.example.net/i/?c=feed&a=actualize&ajax=1 Only a status site "
+"is returned and not a complete website. Example: \"OK\""
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:46
+msgid ""
+"- Parameter \"maxFeeds\" "
+"https://freshrss.example.net/i/?c=feed&a=actualize&maxFeeds=30 If *maxFeeds* "
+"is set the configured amount of feeds is refreshed at once. The default "
+"setting is \"10\"."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:50
+msgid ""
+"- Parameter \"token\" "
+"https://freshrss.example.net/i/?c=feed&a=actualize&token=542345872345734 "
+"Security parameter to prevent unauthorized refreshes. For detailed "
+"Documentation see \"Form authentication\"."
+msgstr ""
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:51
+#, no-wrap
+msgid "Online cron"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:54
+msgid ""
+"If you do not have access to the installation server scheduled task, you can "
+"still automate the update process."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:56
+msgid ""
+"To do so, you need to create a scheduled task, which need to call a specific "
+"URL: https://freshrss.example.net/i/?c=feed&a=actualize (it could be "
+"different depending on your installation). Depending on your application "
+"authentication method, you need to adapt the scheduled task."
+msgstr ""
+
+#. type: Title ####
+#: en/./users/03_Main_view.md:57
+#, no-wrap
+msgid "No authentication"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:60
+msgid ""
+"This is the most straightforward since you have a public instance; there is "
+"nothing special to configure:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:61
+#, no-wrap
+msgid "0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize'\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:65
+#, no-wrap
+msgid "Form authentication"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:68
+msgid ""
+"If you configure the application to allow anonymous reading, you can also "
+"allow anonymous users to update feeds (“Allow anonymous refresh of the "
+"articles”)."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:70
+msgid "![Anonymous access configuration](../img/users/anonymous_access.1.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:72
+msgid ""
+"The URL used in the previous section will now become accessible to "
+"anyone. Therefore you can use the same syntax for the scheduled task."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:74
+msgid ""
+"You can also configure an authentication token to grant special access on "
+"the server."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:76
+msgid "![Token configuration](../img/users/token.1.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:78
+msgid "The scheduled task syntax should look as follows:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:79
+#, no-wrap
+msgid ""
+"0 * * * * curl "
+"'https://freshrss.example.net/i/?c=feed&a=actualize&token=my-token'\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:84
+msgid ""
+"You can also target a different user by adding their username to the query "
+"string, with `&user=insert-username`:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:85
+#, no-wrap
+msgid ""
+"0 * * * * curl "
+"'https://freshrss.example.net/i/?c=feed&a=actualize&user=someone&token=my-token'\n"
+msgstr ""
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:89
+#, no-wrap
+msgid "HTTP authentication"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:92
+msgid ""
+"When using HTTP authentication, the syntax in the two previous sections is "
+"unusable. You'll need to provide your credentials to the scheduled "
+"task. **Note that this method is highly discouraged since it means that your "
+"credentials will be in plain sight!**"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:93
+#, no-wrap
+msgid ""
+"0 * * * * curl -u alice:password123 "
+"'https://freshrss.example.net/i/?c=feed&a=actualize'\n"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:97
+#, no-wrap
+msgid "Manual update"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:100
+msgid ""
+"If you can't or don't want to use the automatic method, you can update "
+"manually. There are two methods for updating all or some of the feeds."
+msgstr ""
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:101
+#, no-wrap
+msgid "Complete update"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:104
+msgid ""
+"This update occurs on all feeds. To trigger it, simply click on the update "
+"link in the navigation menu."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:106
+msgid "![Navigation menu](../img/users/refresh.1.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:108
+msgid ""
+"When the update starts, a progress bar appears and changes while feeds are "
+"processed."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:110
+msgid "![Progress bar](../img/users/refresh.5.png)"
+msgstr ""
+
+#. type: Title ###
+#: en/./users/03_Main_view.md:111
+#, no-wrap
+msgid "Partial update"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:114
+msgid ""
+"This update occurs on the selected feed only. To trigger it, simply click on "
+"the update link in the feed menu."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:116
+msgid "![Feed menu](../img/users/refresh.2.png)"
+msgstr ""
+
+#. type: Title #
+#: en/./users/03_Main_view.md:117
+#, no-wrap
+msgid "Filtering articles"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:120
+msgid ""
+"When the number of articles stored by FreshRSS inevitably grows larger, it's "
+"important to use efficient filters to display only a subset of the "
+"articles. There are several methods that filter with different "
+"criteria. Usually those methods can be combined."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:121
+#, no-wrap
+msgid "By category"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:124
+msgid ""
+"This is the easiest method. You only need to click on the category title in "
+"the side panel. There are two special categories at the top of the panel:"
+msgstr ""
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:127
+msgid ""
+"*Main feed* displays only articles from feeds marked as available in that "
+"category"
+msgstr ""
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:127
+msgid "*Favourites* displays only articles marked as favourites"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:128
+#, no-wrap
+msgid "By feed"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:131
+msgid "There are several methods to filter articles by feed:"
+msgstr ""
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:136
+msgid "by clicking the feed title in the side panel"
+msgstr ""
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:136
+msgid "by clicking the feed title in the article details"
+msgstr ""
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:136
+msgid "by filtering in the feed options from the side panel"
+msgstr ""
+
+#. type: Bullet: '  * '
+#: en/./users/03_Main_view.md:136
+msgid "by filtering in the feed configuration"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:138
+msgid "![Feed filter](../img/users/feed.filter.1.png)"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:139
+#, no-wrap
+msgid "By status"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:142
+msgid ""
+"Each article has two attributes that can be combined. The first attribute "
+"indicates whether or not the article has been read. The second attribute "
+"indicates if the article was marked as favorite or not."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:144
+msgid ""
+"In version 0.7, attribute filters are available in the article display "
+"dropdown list. With this version, it's not possible to combine filters. For "
+"instance, it's not possible to display only read and favorite articles."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:146
+msgid "![Attribute filters in 0.7](../img/users/status.filter.0.7.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:148
+msgid ""
+"Starting with version 0.8, all attribute filters are visible as toggle "
+"icons. They can be combined. As any combination is possible, some have the "
+"same result. For instance, the result for all filters selected is the same "
+"as no filter selected."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:150
+msgid "![Attribute filters in 0.8](../img/users/status.filter.0.8.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:152
+msgid "By default, this filter displays only unread articles"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:153
+#, no-wrap
+msgid "By content"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:156
+msgid ""
+"It is possible to filter articles by their content by inputting a string in "
+"the search field."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/03_Main_view.md:157
+#, no-wrap
+msgid "With the search field"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:160
+msgid "You can use the search field to further refine results:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by author: `author:name` or `author:'composed name'`"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by title: `intitle:keyword` or `intitle:'composed keyword'`"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by URL: `inurl:keyword` or `inurl:'composed keyword'`"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by tag: `#tag`"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/03_Main_view.md:199
+msgid "by free-text: `keyword` or `'composed keyword'`"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:199
+#, no-wrap
+msgid ""
+"* by date of discovery, using the [ISO 8601 time interval "
+"format](http://en.wikipedia.org/wiki/ISO_8601#Time_intervals): "
+"`date:<date-interval>`\n"
+"\t* From a specific day, or month, or year:\n"
+"\t\t* `date:2014-03-30`\n"
+"\t\t* `date:2014-03` or `date:201403`\n"
+"\t\t* `date:2014`\n"
+"\t* From a specific time of a given day:\n"
+"\t\t* `date:2014-05-30T13`\n"
+"\t\t* `date:2014-05-30T13:30`\n"
+"\t* Between two given dates:\n"
+"\t\t* `date:2014-02/2014-04`\n"
+"\t\t* `date:2014-02--2014-04`\n"
+"\t\t* `date:2014-02/04`\n"
+"\t\t* `date:2014-02-03/05`\n"
+"\t\t* `date:2014-02-03T22:00/22:15`\n"
+"\t\t* `date:2014-02-03T22:00/15`\n"
+"\t* After a given date:\n"
+"\t\t* `date:2014-03/`\n"
+"\t* Before a given date:\n"
+"\t\t* `date:/2014-03`\n"
+"\t* For a specific duration after a given date:\n"
+"\t\t* `date:2014-03/P1W`\n"
+"\t* For a specific duration before a given date:\n"
+"\t\t* `date:P1W/2014-05-25T23:59:59`\n"
+"\t* For the past duration before now (the trailing slash is optional):\n"
+"\t\t* `date:P1Y/` or `date:P1Y` (past year)\n"
+"\t\t* `date:P2M/` (past two months)\n"
+"\t\t* `date:P3W/` (past three weeks)\n"
+"\t\t* `date:P4D/` (past four days)\n"
+"\t\t* `date:PT5H/` (past five hours)\n"
+"\t\t* `date:PT30M/` (past thirty minutes)\n"
+"\t\t* `date:PT90S/` (past ninety seconds)\n"
+"\t\t* `date:P1DT1H/` (past one day and one hour)\n"
+"* by date of publication, using the same format: `pubdate:<date-interval>`\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:201
+msgid "Be careful not to enter a space between the operator and the search value."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:204
+msgid ""
+"Some operators can be used negatively, to exclude articles, with the same "
+"syntax as above, but prefixed by a `!` or `-`: `-author:name`, "
+"`-intitle:keyword`, `-inurl:keyword`, `-#tag`, `!keyword`."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:206
+msgid ""
+"It is also possible to combine keywords to create a more precise filter. For "
+"example, you can enter multiple instances of `author:`, `intitle:`, "
+"`inurl:`, `#`, and free-text."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/03_Main_view.md:208
+msgid ""
+"Combining several search criteria implies a logical *and*, but the keyword ` "
+"OR ` can be used to combine several search criteria with a logical *or* "
+"instead: `author:Dupont OR author:Dupond`"
+msgstr ""
+
+#. type: Title #
+#: en/./users/04_Subscriptions.md:1
+#, no-wrap
+msgid "Adding a feed"
+msgstr ""
+
+#. type: Title #
+#: en/./users/04_Subscriptions.md:5
+#, no-wrap
+msgid "Import and export"
+msgstr ""
+
+#. type: Title #
+#: en/./users/04_Subscriptions.md:9
+#, no-wrap
+msgid "Use bookmarklet"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/04_Subscriptions.md:12
+msgid ""
+"Bookmarklets are little scripts that you can execute to perform various "
+"tasks. FreshRSS offers a bookmarklet for subscribing to newsfeeds."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/04_Subscriptions.md:16
+msgid "Open \"Subscriptions management\"."
+msgstr ""
+
+#. type: Bullet: ' 2. '
+#: en/./users/04_Subscriptions.md:16
+msgid "Click on \"Subscription tools\"."
+msgstr ""
+
+#. type: Bullet: ' 3. '
+#: en/./users/04_Subscriptions.md:16
+msgid ""
+"Drag the \"Subscribe\" button to your bookmark toolbar or right click and "
+"choose your browser's \"Bookmark link\" action."
+msgstr ""
+
+#. type: Title #
+#: en/./users/04_Subscriptions.md:17
+#, no-wrap
+msgid "Feed management"
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:2
+#, no-wrap
+msgid "Display"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:4
+#, no-wrap
+msgid "Language"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:9
+msgid ""
+"FreshRSS is currently available in 14 languages. After confirming your "
+"choice, the interface will be displayed in your preferred language.  "
+"Depending on the language chosen, parts of the interface may not be not "
+"translated yet. If you're willing to help translate the missing bits or "
+"would like to add a new language, please take a look at how you can "
+"[contribute to the "
+"project](../contributing.md#contribute-to-internationalization-i18n)."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:11
+msgid ""
+"Some parts of FreshRSS aren't translated and aren't intended to be "
+"translated either. For now, this includes the logs visible in the "
+"application as well as the log generated by automatic update scripts."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:13
+msgid ""
+"Available languages are: cz, de, en, es, fr, he, it, kr, nl, oc, pt-br, ru, "
+"tr, zh-cn."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:14
+#, no-wrap
+msgid "Theme"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:17
+msgid ""
+"There's no accounting for tastes, which is why FreshRSS offers eight "
+"official themes:"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Blue Lagoon* by **Mister aiR**"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Dark* by **AD**"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Flat design* by **Marien Fressinaud**"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Origine* by **Marien Fressinaud**"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Origine-compact* by **Kevin Papst**"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Pafat* by **Plopoyop**"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Screwdriver* by **Mister aiR**"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:26
+msgid "*Swage* by **Patrick Crandol**"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:28
+msgid ""
+"If you can't find any themes you like, it's always possible to [create your "
+"own](../developers/04_Frontend/02_Design.md)."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:30
+msgid ""
+"To select a theme, simply scroll through the themes and select one that "
+"strikes your fancy. After confirmation, the theme will be applied to the "
+"interface."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:31
+#, no-wrap
+msgid "Content width"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:34
+msgid ""
+"Some people prefer short lines of text, while others prefer to maximize the "
+"available screen space. To satisfy the maximum number of people, it's "
+"possible to customize the width of the displayed content. There are four "
+"settings available:"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:39
+msgid "**Fine** displays content up to a maximum width of 550 pixels"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:39
+msgid "**Medium** displays content up to a maximum width of 800 pixels"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:39
+msgid "**Large** displays content up to a maximum width of 1000 pixels"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: en/./users/05_Configuration.md:39
+msgid "**No limit** displays the content on 100% of the available space"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:40
+#, no-wrap
+msgid "Article icons"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:43
+msgid "Please note that this section only affects normal view."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:45
+msgid "![Article icons configuration](../img/users/configuration.article.icons.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:48
+msgid ""
+"Each article is rendered with a header (top line) and a footer (bottom "
+"line).  In that section, you can choose what will be displayed in those."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:52
+msgid ""
+"If you disable every item in the top line, you'll still be able to see it "
+"since it contains the feed name and the article title. But if you do the "
+"same thing for the bottom line, it will be empty."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:53
+#, no-wrap
+msgid "HTML5 notification timout"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:56
+msgid ""
+"After automatically updating the feeds, FreshRSS can pop up a notification "
+"using the HTML5 notification API."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:58
+msgid "The duration of this notification can be set. By default, the value is 0."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:59
+#, no-wrap
+msgid "Show the navigation button"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:62
+msgid ""
+"By default, FreshRSS displays buttons to ease the article navigation when "
+"browsing on mobile. The drawback is that they eat up some precious space."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:64
+msgid ""
+"![navigation button "
+"configuration](../img/users/configuration.navigation.button.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:66
+msgid ""
+"If you don't use those buttons because you never browse on mobile or because "
+"you browse with gestures, you can disable them from the interface."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:67
+#, no-wrap
+msgid "Reading"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:71 en/./users/05_Configuration.md:154
+#, no-wrap
+msgid "Archival"
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:75
+#, no-wrap
+msgid "Sharing"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:78
+msgid "To make your life easier, you can share articles straight from FreshRSS."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:80
+msgid ""
+"At the moment, FreshRSS supports 18 sharing methods, ranging from "
+"self-hosted services (Shaarli, etc.) to proprietary services (Facebook, "
+"etc.)."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:83
+msgid ""
+"By default, the sharing list is empty.  ![Sharing "
+"configuration](../img/users/configuration.sharing.png)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:85
+msgid "To add a new item to the list, please follow the following simple steps:"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:90
+msgid "Select the desired sharing method in the drop-down list."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:90
+msgid "Press the ```✚``` button to add it to the list."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:90
+msgid ""
+"Configure the method in the list. All names can be modified in the "
+"display. Some methods need the sharing URL to be able to work properly (ex: "
+"Shaarli)."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:90 en/./users/05_Configuration.md:95
+msgid "Submit your changes."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:92
+msgid "To remove an item from the list, follow those simple steps:"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:95
+msgid "Press the ```❌``` button next to the share method you want to remove."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:96
+#, no-wrap
+msgid "Shortcuts"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:100
+msgid ""
+"To ease the use of the application, FreshRSS comes with a lot of predefined "
+"keyboard shortcuts.  They allow actions to improve the user experience with "
+"a keyboard."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:102
+msgid ""
+"Of course, if you're not satisfied with the key mapping, you can change you "
+"configuration to fit your needs."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:104
+msgid "There are 4 types of shortcuts:"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:109
+msgid "Views: they allow switching views with ease."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:109
+msgid "Navigation: they allow navigation through articles, feeds, and categories."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:109
+msgid ""
+"Article actions: they allow interactions with an article, like sharing or "
+"opening it on the original web-site."
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:109
+msgid ""
+"Other actions: they allow other interactions with the application, like "
+"opening the user queries menu or accessing the documentation."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:112
+msgid ""
+"It's worth noting that the share article action has two levels. Once you "
+"press the shortcut, a menu containing all the share options opens.  To "
+"choose one share option, you need to select it by its number. When there is "
+"only one option, it's selected automatically though."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:114
+msgid "The same process applies to the user queries."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:117
+msgid ""
+"Be aware that there is no validation on the selected shortcuts.  This means "
+"that if you assign a shortcut to more than one action, you'll end up with "
+"some unexpected behavior."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:118
+#, no-wrap
+msgid "User queries"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:122
+msgid ""
+"You can configure your [user queries](./03_Main_view.md) in that "
+"section. There is not much to say here as it is pretty straightforward.  You "
+"can only change user query titles or drop them."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:124
+msgid "At the moment, there is no helper to build a user query from here."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:125
+#, no-wrap
+msgid "Users"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:129
+#, no-wrap
+msgid "Authentication methods"
+msgstr ""
+
+#. type: Title ###
+#: en/./users/05_Configuration.md:131
+#, no-wrap
+msgid "HTTP Authentication (Apache)"
+msgstr ""
+
+#. type: Bullet: ' 1. '
+#: en/./users/05_Configuration.md:137
+msgid "User control is based on the `.htaccess` file."
+msgstr ""
+
+#. type: Bullet: ' 2. '
+#: en/./users/05_Configuration.md:137
+msgid ""
+"It is best practice to place the `.htaccess` file in the `./i/` subdirectory "
+"so the API and other third party services can work."
+msgstr ""
+
+#. type: Bullet: ' 3. '
+#: en/./users/05_Configuration.md:137
+msgid ""
+"If you want to limit all access to registered users only, place the file in "
+"the FreshRSS directory itself or in a parent directory. Note that WebSub and "
+"API will not work!"
+msgstr ""
+
+#. type: Bullet: ' 4. '
+#: en/./users/05_Configuration.md:137
+msgid "Example `.htaccess` file for a user \"marie\":"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:138
+#, no-wrap
+msgid ""
+"AuthUserFile /home/marie/repertoire/.htpasswd\n"
+"AuthGroupFile /dev/null\n"
+"AuthName \"Chez Marie\"\n"
+"AuthType Basic\n"
+"Require user marie\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:147
+msgid ""
+"More information can be found in the [Apache "
+"documentation](http://httpd.apache.org/docs/trunk/howto/auth.html#gettingitworking)."
+msgstr ""
+
+#. type: Title #
+#: en/./users/05_Configuration.md:148
+#, no-wrap
+msgid "Subscription management"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:150
+#, no-wrap
+msgid "Information"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:158
+#, no-wrap
+msgid "Login"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/05_Configuration.md:162
+#, no-wrap
+msgid "Advanced"
+msgstr ""
+
+#. type: Title ###
+#: en/./users/05_Configuration.md:164
+#, no-wrap
+msgid "Retrieve a truncated stream from within FreshRSS"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:167
+msgid ""
+"This question comes up regularly, so we'll try to clarify how one can "
+"retrieve a truncated RSS feed with FreshRSS. Please note that the process is "
+"absolutely not user friendly, but it works. :)"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:169
+msgid ""
+"Please be aware that this way you'll generate much more traffic to the "
+"originating sites, and they might block you accordingly. FreshRSS "
+"performance is also negatively affected, because you'll have to fetch the "
+"full article content one by one. So it's a feature to use sparingly!"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:171
+msgid ""
+"What's meant by \"CSS path of articles on the original site\" actually "
+"corresponds to the \"path\" consisting of IDs and classes (which in HTML, "
+"matches the id and class attributes) to retrieve only the interesting part "
+"that corresponds to the article. Ideally, this path starts with an id (which "
+"is unique to the page)."
+msgstr ""
+
+#. type: Title ####
+#: en/./users/05_Configuration.md:172
+#, no-wrap
+msgid "Example: Rue89"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:175
+msgid ""
+"To find this path, you have to go to the address of one of the truncated "
+"articles (for example, "
+"http://www.rue89.com/2013/10/15/prof-maths-jai-atteint-lextase-dihn-pedagogie-inversee-246635). "
+"You look have to look for the \"block\" of HTML that corresponds to article "
+"content (in the source code!)."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:177
+#, no-wrap
+msgid ""
+"Here we find that the block that encompasses nothing but the content of the "
+"article is ```<div class=\"content clearfix\">```. We'll only use the "
+"`.content` class here. Nevertheless, as said above, it's best to start the "
+"path with an id. If we go back to the parent block, we find ```<div "
+"id=\"article\">``` and that's perfect! The path will be ```#article "
+".content```.\n"
+msgstr ""
+
+#. type: Title ####
+#: en/./users/05_Configuration.md:178
+#, no-wrap
+msgid ""
+"Add the corresponding classes to the article CSS path on the feed "
+"configuration page. Examples:"
+msgstr ""
+
+#. type: Bullet: '*  '
+#: en/./users/05_Configuration.md:184
+msgid "Rue89: ```#article .content```"
+msgstr ""
+
+#. type: Bullet: '*  '
+#: en/./users/05_Configuration.md:184
+msgid "PCINpact: ```#actu_content```"
+msgstr ""
+
+#. type: Bullet: '*  '
+#: en/./users/05_Configuration.md:184
+msgid "Lesnumériques: ```article#body div.text.clearfix```"
+msgstr ""
+
+#. type: Bullet: '*  '
+#: en/./users/05_Configuration.md:184
+msgid "Phoronix: ```#main .content```"
+msgstr ""
+
+#. type: Title ###
+#: en/./users/05_Configuration.md:185
+#, no-wrap
+msgid "Retrieve a truncated stream with external tools"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/05_Configuration.md:188
+msgid "Complimentary tools can be used to retrieve full article content, such as:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/05_Configuration.md:190
+msgid "[RSS-Bridge](https://github.com/RSS-Bridge/rss-bridge)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/05_Configuration.md:190
+msgid "[Full-Text RSS](https://bitbucket.org/fivefilters/full-text-rss)"
+msgstr ""
+
+#. type: Title #
+#: en/./users/06_Fever_API.md:1
+#, no-wrap
+msgid "FreshRSS - Fever API implementation"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:5
+msgid ""
+"See the [page about our Google Reader compatible API](06_Mobile_access.md) "
+"for another possibility and general aspects of API access."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/06_Fever_API.md:6
+#, no-wrap
+msgid "RSS clients"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:11
+msgid ""
+"There are many RSS clients that support the Fever API, but they seem to "
+"understand the Fever API a bit differently.  If your favourite client "
+"doesn't work properly with this API, please create an issue and we'll have a "
+"look.  But we can **only** do that for free clients."
+msgstr ""
+
+#. type: Title ###
+#: en/./users/06_Fever_API.md:12
+#, no-wrap
+msgid "Usage & Authentication"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:16
+msgid ""
+"Before you can start using this API, you have to enable and setup API "
+"access, which is [documented "
+"here](https://freshrss.github.io/FreshRSS/en/users/06_Mobile_access.html), "
+"and then reset the user’s API password."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:18
+msgid ""
+"Then point your mobile application to the `fever.php` address "
+"(e.g. `https://freshrss.example.net/api/fever.php`)."
+msgstr ""
+
+#. type: Title #
+#: en/./users/06_Fever_API.md:19 en/./users/06_Mobile_access.md:44
+#, no-wrap
+msgid "Compatible clients"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:22
+msgid "Tested with:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:25
+#, no-wrap
+msgid ""
+"* Android\n"
+"  * "
+"[Readably](https://play.google.com/store/apps/details?id=com.isaiasmatewos.readably) "
+"(Closed source)\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:30
+#, no-wrap
+msgid ""
+"* iOS\n"
+"  * [Fiery "
+"Feeds](https://apps.apple.com/app/fiery-feeds-rss-reader/id1158763303) "
+"(Closed source)\n"
+"  * [Unread](https://apps.apple.com/app/unread-rss-reader/id1252376153) "
+"(Commercial)\n"
+"  * [Reeder](https://www.reederapp.com/) (Commercial) (Use its Google Reader "
+"API / native FreshRSS option when possible)\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:33
+#, no-wrap
+msgid ""
+"* MacOS\n"
+"  * [ReadKit](https://apps.apple.com/app/readkit/id588726889) (Commercial)\n"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/06_Fever_API.md:35
+#, no-wrap
+msgid "Features"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:38
+msgid "The following features are implemented:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "fetching categories"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "fetching feeds"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid ""
+"fetching RSS items (new, favorites, unread, by_id, by_feed, by_category, "
+"since)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "fetching favicons"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "setting read marker for item(s)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "setting starred marker for item(s)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "setting read marker for feed"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "setting read marker for category"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:48
+msgid "supports FreshRSS extensions, which use the `entry_before_display` hook"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:50
+msgid "The following features are not supported:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:52
+msgid ""
+"**Hot Links** aka **hot** as there is nothing in FreshRSS yet that is "
+"similar or could be used to simulate it."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/06_Fever_API.md:53
+#, no-wrap
+msgid "Testing and debugging"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:56
+msgid ""
+"If this API does not work as expected in your RSS reader, you can test it "
+"manually with a tool like [Postman](https://www.getpostman.com/)."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:58
+msgid ""
+"Configure a POST request to the URL "
+"https://freshrss.example.net/api/fever.php?api which should give you the "
+"result:"
+msgstr ""
+
+#. type: Code fence info string
+#: en/./users/06_Fever_API.md:58 en/./users/06_Fever_API.md:80
+#, no-wrap
+msgid "json"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:58
+#, no-wrap
+msgid ""
+"{\n"
+"\t\"api_version\": 3,\n"
+"\t\"auth\": 0\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:65
+msgid "Great, the base setup seems to work!"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:68
+msgid ""
+"Now lets try an authenticated call. Fever uses an `api_key`, which is the "
+"MD5 hash of `\"$username:$apiPassword\"`.  Assuming the user is `kevin` and "
+"the password `freshrss`, here is a command-line example to compute the "
+"resulting `api_key`"
+msgstr ""
+
+#. type: Code fence info string
+#: en/./users/06_Fever_API.md:69 en/./users/06_Fever_API.md:75 en/./users/06_Mobile_access.md:69 en/./users/07_Frequently_Asked_Questions.md:37 en/./users/07_Frequently_Asked_Questions.md:45
+#, no-wrap
+msgid "sh"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:69
+#, no-wrap
+msgid "api_key=`echo -n \"kevin:freshrss\" | md5sum | cut -d' ' -f1`\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:74
+msgid ""
+"Add a body to your POST request encoded as `form-data` and one key named "
+"`api_key` with the value `your-password-hash`:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:75
+#, no-wrap
+msgid ""
+"curl -s -F \"api_key=$api_key\" "
+"'https://freshrss.example.net/api/fever.php?api'\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:80
+msgid "This should give:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:80
+#, no-wrap
+msgid ""
+"{\n"
+"\t\"api_version\": 3,\n"
+"\t\"auth\": 1,\n"
+"\t\"last_refreshed_on_time\": \"1520013061\"\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:88
+msgid ""
+"Perfect, you're now authenticated and you can start testing the more "
+"advanced features. To do so, change the URL and append the possible API "
+"actions to your request parameters. Please refer to the [original Fever "
+"documentation](https://feedafever.com/api) for more information."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:90
+msgid "Some basic calls are:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&items"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&feeds"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&groups"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&unread_item_ids"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&saved_item_ids"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&items&since_id=some_id"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&items&max_id=some_id"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&mark=item&as=read&id=some_id"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/06_Fever_API.md:100
+msgid "https://freshrss.example.net/api/fever.php?api&mark=item&as=unread&id=some_id"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:102
+msgid ""
+"Replace `some_id` with a real ID from your `freshrss_username_entry` "
+"database."
+msgstr ""
+
+#. type: Title ###
+#: en/./users/06_Fever_API.md:103
+#, no-wrap
+msgid "Debugging"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:106
+msgid ""
+"If nothing helps and your client is still misbehaving, you can add the "
+"following lines to the beginning of the `fever.api` file to determine the "
+"cause of the problems:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:107
+#, no-wrap
+msgid ""
+"file_put_contents(__DIR__ . '/fever.log', $_SERVER['HTTP_USER_AGENT'] . ': ' "
+". json_encode($_REQUEST) . PHP_EOL, FILE_APPEND);\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:112
+msgid ""
+"Then use your RSS client to query the API and afterwards check the file "
+"`fever.log`."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/06_Fever_API.md:113
+#, no-wrap
+msgid "Credits"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Fever_API.md:115
+msgid ""
+"This plugin was inspired by the "
+"[tinytinyrss-fever-plugin](https://github.com/dasmurphy/tinytinyrss-fever-plugin)."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:2
+msgid ""
+"This page assumes you have completed the [server "
+"setup](../admins/02_Installation.md)."
+msgstr ""
+
+#. type: Title #
+#: en/./users/06_Mobile_access.md:3
+#, no-wrap
+msgid "Enable the API in FreshRSS"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./users/06_Mobile_access.md:9
+msgid ""
+"Under the section “Authentication”, enable the option “Allow API access "
+"(required for mobile apps)”."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:9
+#, no-wrap
+msgid ""
+"2. Under the section “Profile”, fill-in the field “API password (e.g., for "
+"mobile apps)”.\n"
+"\t* Every user must define an API password.\n"
+"\t* The reason for an API-specific password is that it may be used in less "
+"safe situations than the main password, and does not grant access to as many "
+"things.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:12
+msgid ""
+"The rest of this page is about the Google Reader compatible API.  See the "
+"[page about the Fever compatible API](06_Fever_API.md) for another "
+"possibility."
+msgstr ""
+
+#. type: Title #
+#: en/./users/06_Mobile_access.md:14
+#, no-wrap
+msgid "Testing"
+msgstr ""
+
+#. type: Bullet: '3. '
+#: en/./users/06_Mobile_access.md:21
+msgid ""
+"Under the section “Profile”, click on the link like "
+"`https://rss.example.net/api/` next to the field “API password”."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:21
+#, no-wrap
+msgid ""
+"4. Click on first link “Check full server configuration”:\n"
+"\t* If you get *PASS* then you are done, all is good: you may proceed to "
+"step 6.\n"
+"\t* If you get *Bad Request!* or *Not Found*, then your server probably does "
+"not accept slashes `/` that are escaped `%2F`. Proceed to step 5.\n"
+"\t* If you get any other error message, proceed to step 5.\n"
+msgstr ""
+
+#. type: Title #
+#: en/./users/06_Mobile_access.md:23
+#, no-wrap
+msgid "Fix server configuration"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:42
+#, no-wrap
+msgid ""
+"5. Click on the second link “Check partial server configuration (without "
+"`%2F` support)”:\n"
+"\t* If you get `PASS`, then the problem is indeed that your server does not "
+"accept slashes `/` that are escaped `%2F`.\n"
+"\t\t* With Apache, remember the directive [`AllowEncodedSlashes "
+"On`](http://httpd.apache.org/docs/trunk/mod/core.html#allowencodedslashes)\n"
+"\t\t* Or use a client that does not escape slashes (such as EasyRSS), in "
+"which case proceed to step 6.\n"
+"\t* If you get *Service Unavailable!*, then check from step 1 again.\n"
+"\t* With __Apache__:\n"
+"\t\t* If you get *FAIL getallheaders!*, the combination of your PHP version "
+"and your Web server does not provide access to "
+"[`getallheaders`](http://php.net/getallheaders)\n"
+"\t\t\t* Turn on Apache `mod_setenvif` (often enabled by default), or "
+"`mod_rewrite` with the following procedure:\n"
+"\t\t\t\t* Allow [`FileInfo` in "
+"`.htaccess`](http://httpd.apache.org/docs/trunk/mod/core.html#allowoverride): "
+"see the [server setup](../admins/02_Installation.md) again.\n"
+"\t\t\t\t* Enable "
+"[`mod_rewrite`](http://httpd.apache.org/docs/trunk/mod/mod_rewrite.html):\n"
+"\t\t\t\t\t* With Debian / Ubuntu: `sudo a2enmod rewrite`\n"
+"\t* With __nginx__:\n"
+"\t\t* If you get *Bad Request!*, check your server `PATH_INFO` "
+"configuration.\n"
+"\t\t* If you get *File not found!*, check your server "
+"`fastcgi_split_path_info`.\n"
+"\t* If you get *FAIL 64-bit or GMP extension!*, then your PHP version does "
+"not pass the requirement of being 64-bit and/or have PHP "
+"[GMP](http://php.net/gmp) extension.\n"
+"\t\t* The easiest is to add the GMP extension. On Debian / Ubuntu: `sudo apt "
+"install php-gmp`\n"
+"\t* Update and try again from step 3.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:48
+#, no-wrap
+msgid ""
+"6. On the same FreshRSS API page, note the address given under “Your API "
+"address”, like `https://freshrss.example.net/api/greader.php`\n"
+"\t* Type the API address in a client, together with your FreshRSS username, "
+"and the corresponding special API password.\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:63
+#, no-wrap
+msgid ""
+"7. Pick a client supporting a Google Reader-like API. Selection:\n"
+"\t* Android\n"
+"\t\t* "
+"[News+](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus) "
+"with [News+ Google Reader "
+"extension](https://play.google.com/store/apps/details?id=com.noinnion.android.newsplus.extension.google_reader) "
+"(Closed source)\n"
+"\t\t* [FeedMe "
+"3.5.3+](https://play.google.com/store/apps/details?id=com.seazon.feedme) "
+"(Closed source)\n"
+"\t\t* [EasyRSS](https://github.com/Alkarex/EasyRSS) (Open source, "
+"[F-Droid](https://f-droid.org/packages/org.freshrss.easyrss/))\n"
+"\t* Linux\n"
+"\t\t* [FeedReader 2.0+](https://jangernert.github.io/FeedReader/) (Open "
+"source)\n"
+"\t* MacOS\n"
+"\t\t* [Vienna RSS](http://www.vienna-rss.com/) (Open source)\n"
+"\t\t* [Reeder](https://www.reederapp.com/) (Commercial)\n"
+"\t* iOS\n"
+"\t\t* [Reeder](https://www.reederapp.com/) (Commercial)\n"
+"\t* Firefox\n"
+"\t\t* "
+"[FreshRSS-Notify](https://addons.mozilla.org/firefox/addon/freshrss-notify-webextension/) "
+"(Open source)\n"
+msgstr ""
+
+#. type: Title #
+#: en/./users/06_Mobile_access.md:65
+#, no-wrap
+msgid "Google Reader compatible API"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:68
+msgid "Examples of basic queries:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/06_Mobile_access.md:69
+#, no-wrap
+msgid ""
+"# Initial login, using API password (Email and Passwd can be given either as "
+"GET, or POST - better)\n"
+"curl "
+"'https://freshrss.example.net/api/greader.php/accounts/ClientLogin?Email=alice&Passwd=Abcdef123456'\n"
+"SID=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\n"
+"Auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\n"
+"\n"
+"# Examples of read-only requests\n"
+"curl -s -H \"Authorization:GoogleLogin "
+"auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  "
+"'https://freshrss.example.net/api/greader.php/reader/api/0/subscription/list?output=json'\n"
+"\n"
+"curl -s -H \"Authorization:GoogleLogin "
+"auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  "
+"'https://freshrss.example.net/api/greader.php/reader/api/0/unread-count?output=json'\n"
+"\n"
+"curl -s -H \"Authorization:GoogleLogin "
+"auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  "
+"'https://freshrss.example.net/api/greader.php/reader/api/0/tag/list?output=json'\n"
+"\n"
+"# Retrieve a token for requests making modifications\n"
+"curl -H \"Authorization:GoogleLogin "
+"auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  'https://freshrss.example.net/api/greader.php/reader/api/0/token'\n"
+"8e6845e089457af25303abc6f53356eb60bdb5f8ZZZZZZZZZZZZZZZZZ\n"
+"\n"
+"# Get articles, piped to jq for easier JSON reading\n"
+"curl -s -H \"Authorization:GoogleLogin "
+"auth=alice/8e6845e089457af25303abc6f53356eb60bdb5f8\" \\\n"
+"  "
+"'https://freshrss.example.net/api/greader.php/reader/api/0/stream/contents/reading-list' "
+"| jq .\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:2
+msgid ""
+"We may not have answered all of your questions in the previous sections. The "
+"FAQ contains some questions that have not been answered elsewhere."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:3
+#, no-wrap
+msgid "What is `/i` at the end of the application URL?"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:6
+msgid "Of course, ```/i``` has a purpose! It's used for performance and usability:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/07_Frequently_Asked_Questions.md:11
+msgid ""
+"It allows for serving icons, images, styles and scripts without "
+"cookies. Without that trick, those files would be downloaded more often, "
+"especially when form authentication is used. Also, HTTP requests would be "
+"heavier."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/07_Frequently_Asked_Questions.md:11
+msgid ""
+"The ```./p/``` public root can be served without any HTTP access "
+"restrictions. Whereas it could be implemented in ```./p/i/```."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/07_Frequently_Asked_Questions.md:11
+msgid ""
+"It avoids problems while serving public resources like ```favicon.ico```, "
+"```robots.txt```, etc."
+msgstr ""
+
+#. type: Bullet: '* '
+#: en/./users/07_Frequently_Asked_Questions.md:11
+msgid ""
+"It allows the logo to be displayed instead of a white page while hitting a "
+"restriction or a delay during the loading process."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:12
+#, no-wrap
+msgid "Why is `robots.txt` located in a sub-folder?"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:15
+msgid ""
+"To increase security, FreshRSS is hosted in two sections. The first section "
+"is public (the `./p` folder) and the second section is private (everything "
+"else). Therefore the `robots.txt` file is located in the `./p` sub-folder."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:17
+msgid ""
+"As explained in the [security "
+"section](/en/User_documentation/Installation/Security), it's highly "
+"recommended to make only the public section available at the domain "
+"level. With that configuration, `./p` is the root folder for "
+"http://demo.freshrss.org/, thus making `robots.txt` available at the root of "
+"the application."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:19
+msgid "The same principle applies to `favicon.ico` and `.htaccess`."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:20
+#, no-wrap
+msgid "Why do I have errors while registering a feed?"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:26
+msgid ""
+"There can be different origins for that problem.  The feed syntax can be "
+"invalid, it can be unrecognized by the SimplePie library, the hosting server "
+"can be the root of the problem, or FreshRSS can be buggy.  The first step is "
+"to identify what causes the problem.  Here are the steps to follow:"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./users/07_Frequently_Asked_Questions.md:30
+msgid ""
+"__Verify if the feed syntax is valid__ with the [W3C on-line "
+"tool](https://validator.w3.org/feed/ \"RSS and Atom feed validator\"). If "
+"it's not valid, there's nothing we can do."
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./users/07_Frequently_Asked_Questions.md:30
+msgid ""
+"__Verify SimplePie validation__ with the [SimplePie on-line "
+"tool](https://simplepie.org/demo/ \"SimplePie official demo\"). If it's not "
+"recognized, there's nothing we can do."
+msgstr ""
+
+#. type: Bullet: '1. '
+#: en/./users/07_Frequently_Asked_Questions.md:30
+msgid ""
+"__Verify FreshRSS integration__ with the [demo](https://demo.freshrss.org "
+"\"FreshRSS official demo\"). If it's not working, you need to [create an "
+"issue on Github](https://github.com/FreshRSS/FreshRSS/issues/new \"Create an "
+"issue for FreshRSS\") so we can have a look at it. If it's working, there's "
+"probably something fishy with the hosting server."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:31
+#, no-wrap
+msgid "How can you change a forgotten password?"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:35
+msgid ""
+"Since the [1.10.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.10.0) "
+"release, admins can change user passwords directly from the interface. This "
+"interface is available under ```Administration → Manage users```.  Select a "
+"user, enter a password, and validate."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:37
+msgid ""
+"Since the [1.8.0](https://github.com/FreshRSS/FreshRSS/releases/tag/1.8.0) "
+"release, admins can change user passwords using a terminal. It worth "
+"mentioning that you must have access to PHP CLI. Open a terminal, and type "
+"the following command:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:37
+#, no-wrap
+msgid "./cli/update_user.php --user <username> --password <password>\n"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:41
+msgid ""
+"For more information on that matter, please refer to the [dedicated "
+"documentation](../../cli/README.md)."
+msgstr ""
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:42
+#, no-wrap
+msgid "Permissions under SELinux"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:45
+msgid ""
+"Some Linux distribution, like Fedora or RedHat Enterprise Linux, have "
+"SELinux enabled. This acts similar to a firewall application, so that "
+"applications can't write or modify files under certain conditions. While "
+"installing FreshRSS, step 2 can fail if the httpd process can't write to "
+"some data sub-directories. The following command should be executed as root "
+"to fix this problem:"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:45
+#, no-wrap
+msgid ""
+"semanage fcontext -a -t httpd_sys_rw_content_t "
+"'/usr/share/FreshRSS/data(/.*)?'\n"
+"restorecon -Rv /usr/share/FreshRSS/data\n"
+msgstr ""
+
+#. type: Title ##
+#: en/./users/07_Frequently_Asked_Questions.md:50
+#, no-wrap
+msgid "Why do I have a blank page while trying to configure the sharing options?"
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:53
+msgid ""
+"The `sharing` word in the URL is a trigger word for some ad-blocker "
+"rules. Starting with version 1.16, `sharing` has been replaced by "
+"`integration` in the faulty URL while keeping the exact same wording "
+"throughout the application."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:55
+msgid ""
+"If you are using a version prior to 1.16, you can disable your ad-blocker "
+"for FreshRSS or you can add a rule to allow the `sharing` page to be "
+"accessed."
+msgstr ""
+
+#. type: Plain text
+#: en/./users/07_Frequently_Asked_Questions.md:57
+msgid "Examples with _uBlock_:"
+msgstr ""
+
+#. type: Bullet: '- '
+#: en/./users/07_Frequently_Asked_Questions.md:59
+msgid ""
+"Whitelist your FreshRSS instance by adding it in _uBlock > Open the "
+"dashboard > Whitelist_."
+msgstr ""
+
+#. type: Bullet: '- '
+#: en/./users/07_Frequently_Asked_Questions.md:59
+msgid ""
+"Authorize your FreshRSS instance to call `sharing` configuration page by "
+"adding the rule `*sharing,domain=~yourdomain.com` in _uBlock > Open the "
+"dashboard > My filters_"
+msgstr ""

docs/po4a.conf

@@ -0,0 +1,23 @@
+# WARNING: this file is generated with translation-update.sh
+# DO NOT modify this file manually!
+[po4a_langs] fr
+[po4a_paths] i18n/templates/freshrss.pot $lang:i18n/freshrss.$lang.po
+[type: text] en/./contributing.md $lang:$lang/./contributing.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/01_First_steps.md $lang:$lang/./developers/01_First_steps.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/02_Github.md $lang:$lang/./developers/02_Github.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/03_Backend/01_Database_schema.md $lang:$lang/./developers/03_Backend/01_Database_schema.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/03_Backend/02_Minz.md $lang:$lang/./developers/03_Backend/02_Minz.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/03_Backend/03_External_libraries.md $lang:$lang/./developers/03_Backend/03_External_libraries.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/03_Backend/04_Changing_source_code.md $lang:$lang/./developers/03_Backend/04_Changing_source_code.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/03_Backend/05_Extensions.md $lang:$lang/./developers/03_Backend/05_Extensions.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/04_Frontend/01_View_files.md $lang:$lang/./developers/04_Frontend/01_View_files.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/04_Frontend/02_Design.md $lang:$lang/./developers/04_Frontend/02_Design.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./developers/05_Release_new_version.md $lang:$lang/./developers/05_Release_new_version.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./index.md $lang:$lang/./index.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./users/02_First_steps.md $lang:$lang/./users/02_First_steps.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./users/03_Main_view.md $lang:$lang/./users/03_Main_view.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./users/04_Subscriptions.md $lang:$lang/./users/04_Subscriptions.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./users/05_Configuration.md $lang:$lang/./users/05_Configuration.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./users/06_Fever_API.md $lang:$lang/./users/06_Fever_API.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./users/06_Mobile_access.md $lang:$lang/./users/06_Mobile_access.md opt:"-o markdown" opt:"-M utf-8"
+[type: text] en/./users/07_Frequently_Asked_Questions.md $lang:$lang/./users/07_Frequently_Asked_Questions.md opt:"-o markdown" opt:"-M utf-8"