aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/fr/Developpeur
diff options
context:
space:
mode:
authorNicolas Lœuillet <nicolas@loeuillet.org>2015-10-22 17:02:06 +0200
committerNicolas Lœuillet <nicolas@loeuillet.org>2015-10-22 17:02:06 +0200
commite686b5e6fe37b476d70eeadce34616d65572245b (patch)
tree850a783f53671a3ad71892c5d6bd41d1c4595043 /docs/fr/Developpeur
parent71200c4155490cb47b64172c3c2159f44cb80eca (diff)
parent59e91bc8931a386974a3817e9849aad1ca7fc186 (diff)
downloadwallabag-e686b5e6fe37b476d70eeadce34616d65572245b.tar.gz
wallabag-e686b5e6fe37b476d70eeadce34616d65572245b.tar.zst
wallabag-e686b5e6fe37b476d70eeadce34616d65572245b.zip
Merge pull request #1495 from wallabag/v2-docs
add docs
Diffstat (limited to 'docs/fr/Developpeur')
-rw-r--r--docs/fr/Developpeur/Creer_un_nouveau_theme.md9
-rw-r--r--docs/fr/Developpeur/Depot_git.md23
-rw-r--r--docs/fr/Developpeur/Docker.md9
-rw-r--r--docs/fr/Developpeur/Ecrire_fichier_configuration.md39
-rw-r--r--docs/fr/Developpeur/Vagrant.md34
-rw-r--r--docs/fr/Developpeur/v2.md9
6 files changed, 123 insertions, 0 deletions
diff --git a/docs/fr/Developpeur/Creer_un_nouveau_theme.md b/docs/fr/Developpeur/Creer_un_nouveau_theme.md
new file mode 100644
index 00000000..15e89ce3
--- /dev/null
+++ b/docs/fr/Developpeur/Creer_un_nouveau_theme.md
@@ -0,0 +1,9 @@
1---
2language: Français
3currentMenu: theme
4subTitle: Créer un nouveau thème
5---
6
7# Créer un nouveau thème
8
9TODO \ No newline at end of file
diff --git a/docs/fr/Developpeur/Depot_git.md b/docs/fr/Developpeur/Depot_git.md
new file mode 100644
index 00000000..458e32ca
--- /dev/null
+++ b/docs/fr/Developpeur/Depot_git.md
@@ -0,0 +1,23 @@
1---
2language: Français
3currentMenu: repo
4subTitle: Dépôt git de wallabag
5---
6
7# Dépôt git de wallabag
8
9Si vous souhaitez contribuer au projet en proposant de nouvelles fonctionnalités ou en corrigeant des bugs, il faut suivre les recommandations que vous lirez ci-dessous concernant le dépôt Git disponible à cette adresse : [https://github.com/wallabag/wallabag](https://github.com/wallabag/wallabag).
10
11## État des lieux
12
13Pour la gestion des différentes versions de wallabag, nous utilisons Git.
14
15Nous utilisons plusieurs branches pour le code source de l'application web de wallabag :
16
17* la branche `master` : c'est la branche stable, celle qui est téléchargée pour tous ceux qui souhaitent installer wallabag pour leur utilisation.
18* la branche `dev` : avant d'être sur la branche `master`, toutes les corrections de bugs et nouvelles fonctionnalités doivent passer par cette branche. Cette branche n'est pas conseillée pour une utilisation en production.
19* la branche `v2-symfony` : c'est la branche de la refonte de wallabag. Un chapitre complet lui est consacré.
20
21## Workflow
22
23Toutes les consignes concernant le dépôt Git se trouve dans [le fichier CONTRIBUTING.md de wallabag](https://github.com/wallabag/wallabag/blob/master/CONTRIBUTING.md). Merci de le lire attentivement avant toute modification. \ No newline at end of file
diff --git a/docs/fr/Developpeur/Docker.md b/docs/fr/Developpeur/Docker.md
new file mode 100644
index 00000000..b5c9af81
--- /dev/null
+++ b/docs/fr/Developpeur/Docker.md
@@ -0,0 +1,9 @@
1---
2language: Français
3currentMenu: docker
4subTitle: Docker
5---
6
7# Docker
8
9TODO \ No newline at end of file
diff --git a/docs/fr/Developpeur/Ecrire_fichier_configuration.md b/docs/fr/Developpeur/Ecrire_fichier_configuration.md
new file mode 100644
index 00000000..e90b6526
--- /dev/null
+++ b/docs/fr/Developpeur/Ecrire_fichier_configuration.md
@@ -0,0 +1,39 @@
1---
2language: Français
3currentMenu: site_config
4subTitle: Écrire un fichier de configuration
5---
6
7# Écrire un fichier de configuration
8
9wallabag peut utiliser des fichiers de configuration spécifiques à un site pour lire les articles de ce site. Ces fichiers sont stockés dans le répertoire [`inc/3rdparty/site_config/standard`](https://github.com/wallabag/wallabag/tree/master/inc/3rdparty/site_config/standard).
10
11Le format utilisé pour ces fichiers est [XPath](http://www.w3.org/TR/xpath20/). Inspirez-vous des exemples dans le répertoire pour en créer de nouveaux.
12
13## Génération automatique de fichiers de configuration
14
15@FiveFilters a créé un [outil très utile](http://siteconfig.fivefilters.org/) pour créer des fichiers de configuration. Vous devez taper l'adresse d'un article qui vous intéresse. puis vous sélectionnez le contenu que vous souhaitez.
16
17![siteconfig](https://lut.im/RNaO7gGe/l9vRnO1b)
18
19Vous devez confirmer cette zone en essayant avec d'autres articles.
20Quand vous avez trouvé la bonne zone, cliquez simplement sur *Download Full-Text RSS site config* (Téléchargez la configuration du site Full-Text RSS) pour télécharger le fichier à inclure dans le répertoire.
21
22## Génération manuelle de fichiers de configuration
23
24Si l'outil de FiveFilters ne marche pas tel qu´attendu, regardez la source d'un article (Ctrl+U sur Firefox ou Chromium). Cherchez votre contenu parmi le code source et repérez l'attribut `class` ou `id` de la zone que vous souhaitez.
25
26Une fois que vous avez obtenu l'attribut `id` ou `class`, vous pouvez écrire par exemple l'une ou l'autre de ces lignes :
27
28```
29body: //div[@class='myclass']
30body: //div[@id='myid']
31```
32
33Ensuite, testez votre fichier de configuration avec d'autres articles du même site. Si vous avez trouvé le bon contenu mais que vous voulez enlever des parties inutiles, ajoutez la ligne suivante (avec l'attribut `class` correspondant à la partie inutile) :
34
35```
36strip: //div[@class='hidden']
37```
38
39Vous pouvez regarder d'autres options pour les fichiers de configuration de sites [sur l'aide du site de FiveFilters](http://help.fivefilters.org/customer/portal/articles/223153-site-patterns).
diff --git a/docs/fr/Developpeur/Vagrant.md b/docs/fr/Developpeur/Vagrant.md
new file mode 100644
index 00000000..b2f83bc8
--- /dev/null
+++ b/docs/fr/Developpeur/Vagrant.md
@@ -0,0 +1,34 @@
1---
2language: Français
3currentMenu: vagrant
4subTitle: Vagrant
5---
6
7# Vagrant
8
9Pour vous permettre de mettre en place rapidement la configuration requise pour wallabag, nous vous proposons un fichier Vagrantfile.
10
11[Définition Wikipedia](http://fr.wikipedia.org/wiki/Vagrant)
12
13 Vagrant est un logiciel libre et open-source pour la création et la configuration des environnements de développement virtuel. Il peut être considéré comme un wrapper autour du logiciel de virtualisation comme VirtualBox.
14
15## Utiliser Vagrant pour wallabag
16
17Voici la procédure pour exécuter wallabag au sein d'un conteneur Vagrant :
18
19 wget -O wallabag-dev.zip https://github.com/wallabag/wallabag/archive/dev.zip
20 unzip wallabag-dev.zip
21 cd wallabag-dev
22 vagrant up
23
24Accédez maintenant à `http://localhost:8003` et à vous de jouer !
25
26## Qu'a installé le Vagrantfile ?
27
28Le script installe un serveur LAMP, à savoir :
29
30* Ubuntu 14.04
31* Un serveur web Apache2
32* PHP5
33* SQLite ou MySQL ou PostgreSQL pour PHP
34* XDebug pour PHP
diff --git a/docs/fr/Developpeur/v2.md b/docs/fr/Developpeur/v2.md
new file mode 100644
index 00000000..470213d0
--- /dev/null
+++ b/docs/fr/Developpeur/v2.md
@@ -0,0 +1,9 @@
1---
2language: Français
3currentMenu: v2
4subTitle: wallabag v2 / symfony2
5---
6
7# wallabag v2 / symfony2
8
9TODO \ No newline at end of file