From 59e91bc8931a386974a3817e9849aad1ca7fc186 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicolas=20L=C5=93uillet?= Date: Wed, 21 Oct 2015 14:14:51 +0200 Subject: add docs --- docs/fr/Administrateur/MAJ_wallabag.md | 22 ++++ docs/fr/Administrateur/Multi-utilisateurs.md | 35 ++++++ docs/fr/Administrateur/Options_cachees.md | 40 +++++++ .../Telechargement_et_installation.md | 121 +++++++++++++++++++++ docs/fr/Administrateur/sessions.md | 26 +++++ 5 files changed, 244 insertions(+) create mode 100644 docs/fr/Administrateur/MAJ_wallabag.md create mode 100644 docs/fr/Administrateur/Multi-utilisateurs.md create mode 100644 docs/fr/Administrateur/Options_cachees.md create mode 100644 docs/fr/Administrateur/Telechargement_et_installation.md create mode 100644 docs/fr/Administrateur/sessions.md (limited to 'docs/fr/Administrateur') diff --git a/docs/fr/Administrateur/MAJ_wallabag.md b/docs/fr/Administrateur/MAJ_wallabag.md new file mode 100644 index 00000000..57929e11 --- /dev/null +++ b/docs/fr/Administrateur/MAJ_wallabag.md @@ -0,0 +1,22 @@ +--- +language: Français +currentMenu: upgrade +subTitle: Mettre à jour wallabag +--- + +# Mettre à jour wallabag + + Pour mettre à jour votre installation, téléchargez et décompressez l’archive dans votre installation (ici `/var/www/html/wallabag/`) : + + wget http://wllbg.org/latest + unzip latest + rsync -ur wallabag-version-number/* /var/www/html/wallabag/ + +Supprimez le répertoire `install` et videz le cache : + + cd /var/www/html/wallabag/ + rm -r cache/* install/ + +Pour vider le cache, il est également possible d'aller dans la page de configuration et de cliquer sur le lien pour supprimer le cache. + +Vérifiez dans le bas de la page de configuration que la dernière version est bien installée. diff --git a/docs/fr/Administrateur/Multi-utilisateurs.md b/docs/fr/Administrateur/Multi-utilisateurs.md new file mode 100644 index 00000000..77a48d5e --- /dev/null +++ b/docs/fr/Administrateur/Multi-utilisateurs.md @@ -0,0 +1,35 @@ +--- +language: Français +currentMenu: multiusers +subTitle: wallabag multi-utilisateurs +--- + +# wallabag multi-utilisateurs + +## Créer un nouveau compte + +### Mode administrateur + +Si vous souhaitez utiliser wallabag pour plusieurs personnes, il est possible de créer de nouveaux comptes depuis la page de configuration. + +En bas de cette page se trouve un formulaire où vous devez saisir un nom d'utilisateur et un mot de passe. + +Il est maintenant possible de se connecter avec ce compte depuis la page d'identification de wallabag. + +Aucune information n'est partagée entre les différents comptes. + +### Mode libre + +A partir de la version 1.9, l'administrateur peut laisser libre la création de nouveaux comptes. Il doit pour cela l'autoriser en modifiant les lignes suivantes dans le fichier de configuration : + + // registration + @define ('ALLOW_REGISTER', FALSE); + @define ('SEND_CONFIRMATION_EMAIL', FALSE); + +Ensuite, l'utilisateur rentrera lui-même son nom d'utilisateur et son mot de passe pour se créer un compte. Selon la configuration, un courriel de confirmation peut être envoyé aux utilisateurs ayant fourni une adresse électronique. + +## Supprimer un compte + +Il est possible de supprimer son propre compte, depuis la page de configuration. Il suffit de saisir son mot de passe et de demander la suppression. + +Bien évidemment, lorsqu'il ne reste plus qu'un seul compte, il est impossible de le supprimer. diff --git a/docs/fr/Administrateur/Options_cachees.md b/docs/fr/Administrateur/Options_cachees.md new file mode 100644 index 00000000..5d4094d4 --- /dev/null +++ b/docs/fr/Administrateur/Options_cachees.md @@ -0,0 +1,40 @@ +--- +language: Français +currentMenu: hidden +subTitle: Options cachées +--- + +# Options cachées + +## Mise en garde + +**Attention**, cette partie concerne les utilisateurs avancés. Nous allons modifier un fichier important de wallabag, `inc/poche/config.inc.php`, il est donc conseillé de faire une sauvegarde de celui-ci avant toute modification. +**Toute erreur lors d'une modification d'un fichier de wallabag pourra entrainer des dysfonctionnements**. + +Ce fichier est créé lorsque vous installez wallabag. +Installez donc d'abord wallabag, faites une copie du fichier et ouvrez-le avec ~~Sublime Text~~ votre éditeur de texte préféré. + +Dans ce fichier sont définis des paramètres qui ne sont, aujourd'hui, pas encore disponibles dans la page **Configuration** de wallabag. + +## Modification des options avancées + +Chaque paramètre est défini de cette façon : + + @define ('NOM_DU_PARAMETRE', 'Valeur du paramètre'); + +Pour chaque ligne, vous ne pouvez modifier que la partie `Valeur du paramètre`. + +Listons maintenant les différents paramètres que vous pouvez changer : + +* `HTTP_PORT` (par défaut, `80`) : correspond au port HTTP de votre serveur web. À changer si votre serveur web est derrière un proxy. Valeur attendue : un nombre. +* `SSL_PORT` (par défaut, `443`) : correspond au port SSL de votre serveur web. À changer si votre serveur web utilises SSLH. Valeur attendue : un nombre. +* `DEBUG_POCHE` (par défaut, `FALSE`) : si vous rencontrez des problèmes avec wallabag, nous vous demanderons peut-être d'activer le mode Debug. Valeurs attendues : `TRUE` ou `FALSE`. +* `DOWNLOAD_PICTURES` (par défaut, `FALSE`) : permet de télécharger sur votre serveur les images des articles. Ce paramètre est désactivé par défaut pour ne pas surcharger votre serveur web. Nous préférons vous laisser activer vous-même ce paramètre. Valeurs attendues : `TRUE` ou `FALSE`. +* `SHARE_TWITTER` (par défaut, `TRUE`) : permet d'activer le partage vers twitter. Valeurs attendues : `TRUE` ou `FALSE`. +* `SHARE_MAIL` (par défaut, `TRUE`) : permet d'activer le partage par email. Valeurs attendues : `TRUE` ou `FALSE`. +* `SHARE_SHAARLI` (par défaut, `FALSE`) : permet d'activer le partage vers votre installation de Shaarli (gestionnaire de favoris). Valeurs attendues : `TRUE` ou `FALSE`. +* `SHAARLI_URL` (par défaut, `'http://myshaarliurl.com'`) : définit l'URL de votre installation de Shaarli. Valeur attendue : une URL. +* `FLATTR` (par défaut, `TRUE`) : permet d'activer la possibilité de flattrer un article ([Flattr est une plateforme de micro-dons](http://fr.wikipedia.org/wiki/Flattr)). Si un article est flattrable, une icône s'affichera et vous permet d'envoyer un micro-don à l'auteur de l'article. Valeurs attendues : `TRUE` ou `FALSE`. +* `SHOW_PRINTLINK` (par défaut, `'1'`) : permet d'afficher le lien pour imprimer un article. Valeurs attendues : `'0'` pour désactiver ou `'1'` pour activer. +* `SHOW_READPERCENT` (par défaut, `'1'`) : permet d'afficher (sur les thèmes `default`, `dark`, `dmagenta`, `solarized`, `solarized-dark`) le pourcentage de lecture de l'article. Valeurs attendues : `'0'` pour désactiver ou `'1'` pour activer. +* `PAGINATION` (par défaut, `'12'`) : définit le nombre d'articles affichés sur une liste. Valeur attendue : un nombre. \ No newline at end of file diff --git a/docs/fr/Administrateur/Telechargement_et_installation.md b/docs/fr/Administrateur/Telechargement_et_installation.md new file mode 100644 index 00000000..46eb4619 --- /dev/null +++ b/docs/fr/Administrateur/Telechargement_et_installation.md @@ -0,0 +1,121 @@ +--- +language: Français +currentMenu: install +subTitle: Télécharger et installer wallabag +--- + +# Télécharger et installer wallabag + +## Je ne souhaite pas installer wallabag + +Puisque vous ne voulez pas ou ne pouvez pas installer wallabag, nous vous proposons de créer un compte gratuit sur [Framabag](https://framabag.org/), lequel utilise notre logiciel. [Lisez la documentation complète](../Utilisateur/Framabag.md). + +## Je souhaite installer wallabag + +### Je souhaite télécharger wallabag manuellement + +[Télécharger la dernière version de wallabag](http://wllbg.org/latest) et décompresser-là : + + wget http://wllbg.org/latest + unzip latest + mv wallabag-version-number wallabag + +Copiez les fichiers sur votre serveur web. Dans le cas d'Ubuntu/Debian, il s'agit de /var/www/html/ : + + sudo mv wallabag /var/www/html/ + +Puis sautez le paragraphe suivant. + +### Je souhaite télécharger wallabag via composer + +Vous devez installer composer : + + curl -s http://getcomposer.org/installer | php + +Ensuite, sur votre serveur web, exécutez cette commande : + + composer create-project wallabag/wallabag . dev-master + +Tout est téléchargé dans le répertoire courant. + +#### Pré-requis pour votre serveur web + +Wallabag nécessite qu'un certain nombre de composants soient installées sur votre serveur web. +Pour être sûr que votre serveur possède tous les pré-requis, ouvrez dans votre navigateur la page `http://monserveur.com/wallabag/install/index.php`. + +Les composants sont : + +* [PHP 5.3.3 ou plus](http://php.net/manual/fr/install.php) **avec support [PDO](http://php.net/manual/en/book.pdo.php)** +* [XML pour PHP](http://php.net/fr/xml) +* [PCRE](http://php.net/fr/pcre) +* [ZLib](http://php.net/en/zlib) (son absence affectera le traitement des pages compressées) +* [mbstring](http://php.net/en/mbstring) et/ou [iconv](http://php.net/en/iconv) (sinon, certaines pages ne pourront pas être lues - même en anglais) +* L'extension [DOM/XML](http://php.net/manual/en/book.dom.php) +* [Filtrage des données](http://php.net/manual/fr/book.filter.php) +* [GD](http://php.net/manual/en/book.image.php) (son absence empèchera la sauvegarde des images) +* [Tidy pour PHP](http://php.net/fr/tidy) (son absence peut poser problème avec certaines pages) +* [cURL](http://php.net/fr/curl) avec `Parallel URL fetching` (optionel) +* [Parse ini file](http://uk.php.net/manual/en/function.parse-ini-file.php) +* [allow_url_fopen](http://www.php.net/manual/fr/filesystem.configuration.php#ini.allow-url-fopen) (optionel si cURL présent) +* [gettext](http://php.net/manual/fr/book.gettext.php) (nécessaire pour le support multilingues) + +Installez les composants manquants avant de poursuivre. Par exemple pour installer Tidy sur Ubuntu/Debian : + + sudo apt-get install php5-tidy + sudo service apache2 reload + +Note : si voux utilisez IIS comme serveur web, vous devez interdire l'*Authentification Anonyme* et [permettre L'*Authentification de base*](https://technet.microsoft.com/fr-fr/library/cc772009%28v=ws.10%29.aspx) pour autoriser la connexion. + +#### Twig installation + +Pour pouvoir fonctionner, wallabag a besoin de `Twig`, une bibliothèque de modèles. +Si vous ne pouvez pas installer `composer` (dans le cas d'hébergement mutualisé par exemple), nous vous proposons un fichier +incluant `Twig`. Ce fichier peut être télécharger depuis la page `http://monserveur.com/wallabag/install/index.php` (section INSTALLATION TWIG) ou directement ici [http://wllbg.org/vendor](http://wllbg.org/vendor). Décompressez-le dans votre répertoire wallabag. + +Alternativement, vous pouvez installer `Twig` en lançant `composer` depuis votre dossier wallabag (toujours dans le cas d'Ubuntu/Debian : /var/www/html/wallabag/) en exécutant les commandes : + + curl -s http://getcomposer.org/installer | php + php composer.phar install + +### Création de la base de données + +Wallabag peut s'installer sur différents types de bases de données : + +* [SQLite](http://php.net/manual/fr/book.sqlite.php). Le plus simple de tous. Rien de particulier à configurer. +* [MySQL](http://php.net/manual/fr/book.mysql.php). Un système de base de données bien connu, qui est dans la plupart des cas plus efficace que SQLite. +* [PostgreSQL](http://php.net/manual/fr/book.pgsql.php). Certaines personnes l'ont trouvé mieux que MySQL. + +Nous vous conseillons d'utiliser MySQL, plus performante. Il est alors nécessaire de créer une nouvelle base (par exemple `wallabag`), un nouvel utilisateur (par exemple `wallabag`) et un mot de passe (ici `VotreMotdePasse`). Vous pouvez pour cela utiliser `phpMyAdmin`, ou exécuter les commandes suivantes : + + mysql -p -u root + mysql> CREATE DATABASE wallabag; + mysql> GRANT ALL PRIVILEGES ON `wallabag`.* TO 'wallabag'@'localhost' IDENTIFIED BY 'VotreMotdePasse'; + mysql> exit + +*Note :* Si vous utilisez MySQL ou Postgresql, vous devrez **remplir tous les champs**, sinon l'installation ne fonctionera pas et un message d'erreur vous dira ce qui ne va pas. Vous devez créer manuellement la base de données qui sera utilisée par wallabag avec un outil comme PHPMyAdmin ou en ligne de commande. + +### Permissions + +Le serveur web doit avoir accès en écriture aux répertoires `assets`, `cache` et `db`. Sans cela, un message vous indiquera que l'installation est impossible : + + sudo chown -R www-data:www-data /var/www/html/wallabag + +### Installation de wallabag. Enfin. + +Accédez à wallabag depuis votre navigateur : `http://votreserveur.com/wallabag`. Si votre serveur est bien configuré, vous arrivez sur l'écran d'installation. + +Renseignez le type de votre base de données (`sqlite`, `mysql` ou `postgresql`) et les informations de votre base de données. Dans le cas de la base MySQL créée plus haut, la configuration standard sera : + + Database engine: MySQL + Server: localhost + Database: wallabag + Username: wallabag + Password: VotreMotdePasse + +Créez enfin votre premier utilisateur et son mot de passe (différents de l'utilisateur de la base de données). + +wallabag est maintenant installé. + +### Connexion + +Depuis votre navigateur, vous arrivez sur l'écran d'identification : saisissez votre identifiant et votre mot de passe et vous voici connecté. diff --git a/docs/fr/Administrateur/sessions.md b/docs/fr/Administrateur/sessions.md new file mode 100644 index 00000000..717e55e1 --- /dev/null +++ b/docs/fr/Administrateur/sessions.md @@ -0,0 +1,26 @@ +--- +language: Français +currentMenu: sessions +subTitle: Problème de sessions +--- + +Si vous vous retrouvez à être déconnecté même après avoir valider le *Stay signed in checkbox*, +lancez les commandes suivantes comme administrateur (ou avec sudo) : + +``` +mkdir /var/lib/wallabag-sessions +chown www-data:www-data /var/lib/wallabag-sessions +``` + +*NOTE : L'utilisateur et le groupe www-data pourrait ne pas exister. +Vous pouvez alors utiliser ```chown http:http /var/lib/wallabag-sessions``` à la place.* + +Ensuite, en utilisant apache, ajoutez : `php_admin_value session.save_path /var/lib/wallabag-sessions` +à votre vhost apache, tel que `wallabag-apache.conf`. +Enfin, redémarrez apache, en lançant par exemple : ```/etc/init.d/apache2 restart``` + +Si vous utilisez nginx, ajoutez `php_admin_value[session.save_path] = /var/lib/wallabag-sessions` +à votre fichier de configuration de nginx. +Ensuite, redémarrez nginx : ```/etc/init.d/nginx restart``` + +*NOTE : si vous utilisez systemd, vous devriez faire `systemctl restart apache2` (ou nginx).* -- cgit v1.2.3