[fanfix.git] / README-fr.md

[English](README.md) Français

# Fanfix
Fanfix est un petit programme Java qui peut télécharger des histoires sur internet et les afficher hors ligne.

## Description

(Si vous voulez juste voir les derniers changements, vous pouvez regarder le [Changelog](changelog-fr.md) -- remarquez que le programme affiche le changelog si une version plus récente est détectée depuis la version 1.4.0.)

(Il y a aussi une [TODO list](TODO.md) sur le site parlant du futur du programme.)

TODO: screenshots TUI + Android (+ FR quand traduit)

![Main GUI](screenshots/fanfix-1.3.2.png?raw=true "Main GUI")

Le fonctionnement du programme est assez simple : il converti une URL venant d'un site supporté en un fichier .epub pour les histoires ou .cbz pour les comics (d'autres options d'enregistrement sont disponibles, comme du texte simple, du HTML...)

Pour vous aider à organiser vos histoires, il peut aussi servir de bibliothèque locale vous permettant :

- d'importer une histoire depuis son URL (ou depuis un fichier)
- d'exporter une histoire dans un des formats supportés vers un fichier
- d'afficher une histoire en mode texte
- d'afficher une histoire en mode GUI **en appelant un programme natif pour lire le fichier** (mais Fanfix peut convertir le fichier en HTML avant, pour que n'importe quel navigateur web puisse l'afficher)

## Sites supportés

Pour le moment, les sites suivants sont supportés :

- http://FimFiction.net/ : fanfictions dévouées à la série My Little Pony
- http://Fanfiction.net/ : fanfictions venant d'une multitude d'univers différents, depuis les shows télévisés aux livres en passant par les jeux-vidéos
- http://mangafox.me/ : un site répertoriant une quantité non négligeable de mangas
- https://e621.net/ : un site Furry proposant des comics, y compris de MLP
- https://sofurry.com/ : même chose, mais orienté sur les histoires plutôt que les images
- https://e-hentai.org/ : support ajouté sur demande : n'hésitez pas à demander un site !

## À propos des types de fichiers supportés

Nous supportons les types de fichiers suivants (aussi bien en entrée qu'en sortie) :

- epub : les fichiers .epub créés avec Fanfix (nous ne supportons pas les autres fichiers .epub, du moins pour le moment)
- text : les histoires enregistrées en texte (.txt), avec quelques règles spécifiques :
	- le titre doit être sur la première ligne
	- l'auteur (précédé de rien, ```Par ```, ```De ``` ou ```©```) doit être sur la deuxième ligne, optionnellement suivi de la date de publication entre parenthèses (i.e., ```Par Quelqu'un (3 octobre 1998)```)
	- les chapitres doivent être déclarés avec ```Chapitre x``` ou ```Chapitre x: NOM DU CHAPTITRE```, où ```x``` est le numéro du chapitre
	- une description de l'histoire doit être donnée en tant que chaptire 0
	- une image de couverture peut être présente avec le même nom de fichier que l'histoire, mais une extension .png, .jpeg ou .jpg
- info_text : fort proche du format texte, mais avec un fichier .info accompagnant l'histoire pour y enregistrer quelques metadata (le fichier de metadata est supposé être créé par Fanfix, ou être compatible avec)
- cbz : les fichiers .cbz (une collection d'images zipées), de préférence créés avec Fanfix (même si les autres .cbz sont aussi supportés, mais sans la majorité des metadata de Fanfix dans ce cas)
- html : les fichiers HTML que vous pouvez ouvrir avec n'importe quel navigateur ; remarquez que Fanfix créera un répertoire pour y mettre les fichiers nécessaires, dont un fichier ```index.html``` pour afficher le tout -- nous ne supportons en entrée que les fichiers HTML créés par Fanfix

## Plateformes supportées

Toute plateforme supportant Java 1.6 devrait suffire.

Le programme a été testé sur Linux (Debian, Slackware et Ubuntu), MacOS X et Windows pour le moment, mais n'hésitez pas à nous informer si vous l'essayez sur un autre système.

Si vous avez des difficultés pour le compiler avec une version supportée de Java (1.6+), contactez-nous.

## Utilisation

Vous pouvez démarrer le programme en mode graphique (comme dans le screenshot en haut) :

- ```java -jar fanfix.jar```

Les arguments suivants sont aussi supportés :

- ```--import [URL]```: importer une histoire dans la librairie
- ```--export [id] [output_type] [target]```: exporter l'histoire "id" vers le fichier donné
- ```--convert [URL] [output_type] [target] (+info)```: convertir l'histoire vers le fichier donné, et forcer l'ajout d'un fichier .info si +info est utilisé
- ```--read [id] ([chapter number])```: afficher l'histoire "id"
- ```--read-url [URL] ([chapter number])```: convertir l'histoire et la lire à la volée, sans la sauver
- ```--list```: lister les histoires presentes dans la librairie et leurs IDs
- ```--set-reader [reader type]```: changer le type de lecteur pour la commande en cours sur CLI, TUI ou GUI
- ```--server [key] [port]```: démarrer un serveur d'histoires sur ce port
- ```--stop-server [key] [port]```: arrêter le serveur distant sur ce port (key doit avoir la même valeur)
- ```--remote [key] [host] [port]```: contacter ce server au lieu de la librairie habituelle (key doit avoir la même valeur)
- ```--help```: afficher la liste des options disponibles
- ```--version```: retourne la version du programme

### Variables d'environnement

Certaines variables d'environnement sont reconnues par le programme :

- ```LANG=en```: forcer la langue du programme en anglais
- ```CONFIG_DIR=$HOME/.fanfix```: utilise ce répertoire pour les fichiers de configuration du programme (et copie les fichiers de configuration par défaut si besoin)
- ```NOUTF=1```: essaye d'utiliser des caractères non-unicode quand possible (cela peut avoir un impact sur les fichiers générés, pas uniquement sur les messages à l'utilisateur)
- ```DEBUG=1```: force l'option ```DEBUG=true``` du fichier de configuration (pour afficher plus d'information en cas d'erreur)

## Compilation

```./configure.sh && make```

Vous pouvez aussi importer les sources java dans, par exemple, [Eclipse](https://eclipse.org/), et faire un JAR exécutable depuis celui-ci.

Quelques tests unitaires sont disponibles :

```./configure.sh && make build test run-test```

### Librairies dépendantes (incluses)

Nécessaires :

- libs/nikiroo-utils-sources.jar: quelques utilitaires partagés
- [libs/unbescape-sources.jar](https://github.com/unbescape/unbescape): une librairie sympathique pour convertir du texte depuis/vers beaucoup de formats ; utilisée ici pour la partie HTML
- [libs/jsoup-sources.jar](https://jsoup.org/): une libraririe pour parser du HTML

Optionnelles :

- [libs/jexer-sources.jar](https://github.com/klamonte/jexer): une petite librairie qui offre des widgets en mode TUI

Rien d'autre, si ce n'est Java 1.6+.

À noter : ```make libs``` exporte ces librairies dans le répertoire src/.

## Auteur

Fanfix a été écrit par Niki Roo <niki@nikiroo.be>
Commit	Line	Data
10ccd649	1	[English](README.md) Français
eab9e01c NR	2
eab9e01c NR	3	# Fanfix
eab9e01c NR	4	Fanfix est un petit programme Java qui peut télécharger des histoires sur internet et les afficher hors ligne.
eab9e01c NR	5
42375f55 NR	6	## Description
42375f55 NR	7
eab9e01c NR	8	(Si vous voulez juste voir les derniers changements, vous pouvez regarder le [Changelog](changelog-fr.md) -- remarquez que le programme affiche le changelog si une version plus récente est détectée depuis la version 1.4.0.)
	9
	10	(Il y a aussi une [TODO list](TODO.md) sur le site parlant du futur du programme.)
	11
	12	TODO: screenshots TUI + Android (+ FR quand traduit)
	13
	14	![Main GUI](screenshots/fanfix-1.3.2.png?raw=true "Main GUI")
	15
	16	Le fonctionnement du programme est assez simple : il converti une URL venant d'un site supporté en un fichier .epub pour les histoires ou .cbz pour les comics (d'autres options d'enregistrement sont disponibles, comme du texte simple, du HTML...)
	17
	18	Pour vous aider à organiser vos histoires, il peut aussi servir de bibliothèque locale vous permettant :
42375f55	19
eab9e01c NR	20	- d'importer une histoire depuis son URL (ou depuis un fichier)
	21	- d'exporter une histoire dans un des formats supportés vers un fichier
	22	- d'afficher une histoire en mode texte
	23	- d'afficher une histoire en mode GUI en appelant un programme natif pour lire le fichier (mais Fanfix peut convertir le fichier en HTML avant, pour que n'importe quel navigateur web puisse l'afficher)
	24
	25	## Sites supportés
	26
	27	Pour le moment, les sites suivants sont supportés :
42375f55	28
eab9e01c NR	29	- http://FimFiction.net/ : fanfictions dévouées à la série My Little Pony
	30	- http://Fanfiction.net/ : fanfictions venant d'une multitude d'univers différents, depuis les shows télévisés aux livres en passant par les jeux-vidéos
	31	- http://mangafox.me/ : un site répertoriant une quantité non négligeable de mangas
	32	- https://e621.net/ : un site Furry proposant des comics, y compris de MLP
	33	- https://sofurry.com/ : même chose, mais orienté sur les histoires plutôt que les images
	34	- https://e-hentai.org/ : support ajouté sur demande : n'hésitez pas à demander un site !
	35
	36	## À propos des types de fichiers supportés
	37
	38	Nous supportons les types de fichiers suivants (aussi bien en entrée qu'en sortie) :
42375f55	39
eab9e01c NR	40	- epub : les fichiers .epub créés avec Fanfix (nous ne supportons pas les autres fichiers .epub, du moins pour le moment)
eab9e01c NR	41	- text : les histoires enregistrées en texte (.txt), avec quelques règles spécifiques :
42375f55 NR	42	- le titre doit être sur la première ligne
	43	- l'auteur (précédé de rien, ```Par ```, ```De ``` ou ```©```) doit être sur la deuxième ligne, optionnellement suivi de la date de publication entre parenthèses (i.e., ```Par Quelqu'un (3 octobre 1998)```)
	44	- les chapitres doivent être déclarés avec ```Chapitre x``` ou ```Chapitre x: NOM DU CHAPTITRE```, où ```x``` est le numéro du chapitre
	45	- une description de l'histoire doit être donnée en tant que chaptire 0
	46	- une image de couverture peut être présente avec le même nom de fichier que l'histoire, mais une extension .png, .jpeg ou .jpg
eab9e01c NR	47	- info_text : fort proche du format texte, mais avec un fichier .info accompagnant l'histoire pour y enregistrer quelques metadata (le fichier de metadata est supposé être créé par Fanfix, ou être compatible avec)
	48	- cbz : les fichiers .cbz (une collection d'images zipées), de préférence créés avec Fanfix (même si les autres .cbz sont aussi supportés, mais sans la majorité des metadata de Fanfix dans ce cas)
	49	- html : les fichiers HTML que vous pouvez ouvrir avec n'importe quel navigateur ; remarquez que Fanfix créera un répertoire pour y mettre les fichiers nécessaires, dont un fichier ```index.html``` pour afficher le tout -- nous ne supportons en entrée que les fichiers HTML créés par Fanfix
	50
	51	## Plateformes supportées
	52
	53	Toute plateforme supportant Java 1.6 devrait suffire.
	54
	55	Le programme a été testé sur Linux (Debian, Slackware et Ubuntu), MacOS X et Windows pour le moment, mais n'hésitez pas à nous informer si vous l'essayez sur un autre système.
	56
	57	Si vous avez des difficultés pour le compiler avec une version supportée de Java (1.6+), contactez-nous.
	58
	59	## Utilisation
	60
	61	Vous pouvez démarrer le programme en mode graphique (comme dans le screenshot en haut) :
42375f55	62
eab9e01c NR	63	- ```java -jar fanfix.jar```
	64
	65	Les arguments suivants sont aussi supportés :
42375f55	66
eab9e01c NR	67	- ```--import [URL]```: importer une histoire dans la librairie
	68	- ```--export [id] [output_type] [target]```: exporter l'histoire "id" vers le fichier donné
	69	- ```--convert [URL] [output_type] [target] (+info)```: convertir l'histoire vers le fichier donné, et forcer l'ajout d'un fichier .info si +info est utilisé
	70	- ```--read [id] ([chapter number])```: afficher l'histoire "id"
	71	- ```--read-url [URL] ([chapter number])```: convertir l'histoire et la lire à la volée, sans la sauver
	72	- ```--list```: lister les histoires presentes dans la librairie et leurs IDs
	73	- ```--set-reader [reader type]```: changer le type de lecteur pour la commande en cours sur CLI, TUI ou GUI
	74	- ```--server [key] [port]```: démarrer un serveur d'histoires sur ce port
10ccd649	75	- ```--stop-server [key] [port]```: arrêter le serveur distant sur ce port (key doit avoir la même valeur)
eab9e01c NR	76	- ```--remote [key] [host] [port]```: contacter ce server au lieu de la librairie habituelle (key doit avoir la même valeur)
	77	- ```--help```: afficher la liste des options disponibles
	78	- ```--version```: retourne la version du programme
	79
	80	### Variables d'environnement
	81
	82	Certaines variables d'environnement sont reconnues par le programme :
42375f55	83
eab9e01c NR	84	- ```LANG=en```: forcer la langue du programme en anglais
	85	- ```CONFIG_DIR=$HOME/.fanfix```: utilise ce répertoire pour les fichiers de configuration du programme (et copie les fichiers de configuration par défaut si besoin)
	86	- ```NOUTF=1```: essaye d'utiliser des caractères non-unicode quand possible (cela peut avoir un impact sur les fichiers générés, pas uniquement sur les messages à l'utilisateur)
	87	- ```DEBUG=1```: force l'option ```DEBUG=true``` du fichier de configuration (pour afficher plus d'information en cas d'erreur)
	88
	89	## Compilation
	90
	91	```./configure.sh && make```
	92
	93	Vous pouvez aussi importer les sources java dans, par exemple, [Eclipse](https://eclipse.org/), et faire un JAR exécutable depuis celui-ci.
	94
	95	Quelques tests unitaires sont disponibles :
	96
	97	```./configure.sh && make build test run-test```
	98
	99	### Librairies dépendantes (incluses)
	100
	101	Nécessaires :
42375f55	102
eab9e01c NR	103	- libs/nikiroo-utils-sources.jar: quelques utilitaires partagés
eab9e01c NR	104	- [libs/unbescape-sources.jar](https://github.com/unbescape/unbescape): une librairie sympathique pour convertir du texte depuis/vers beaucoup de formats ; utilisée ici pour la partie HTML
0ffa4754	105	- [libs/jsoup-sources.jar](https://jsoup.org/): une libraririe pour parser du HTML
eab9e01c NR	106
eab9e01c NR	107	Optionnelles :
42375f55	108
eab9e01c NR	109	- [libs/jexer-sources.jar](https://github.com/klamonte/jexer): une petite librairie qui offre des widgets en mode TUI
	110
	111	Rien d'autre, si ce n'est Java 1.6+.
	112
	113	À noter : ```make libs``` exporte ces librairies dans le répertoire src/.
	114
42375f55 NR	115	## Auteur
	116
	117	Fanfix a été écrit par Niki Roo <niki@nikiroo.be>
	118