README.md 1.74 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
Hdoc to Epub
------------

License
-------

http://www.gnu.org/licenses/gpl-3.0.txt

Credits
-------

### Autumn 2016

* Biagianti Marie

* Couturier Valentin

Presentation
------------

cliclac's avatar
cliclac committed
21
"Hdoc to Epub" is an hdoc converter to epub files. It's a set of ANT scripts and XSL files
22 23 24 25

Dependencies
------------

cliclac's avatar
cliclac committed
26
There's no particular dependencies needed to run the converter.
27 28 29 30

User Documentation
------------------

cliclac's avatar
cliclac committed
31
### Scenario
cliclac's avatar
cliclac committed
32
La personne possède un (ou des) hdoc et voudrait le convertir en epub. Il se dirige vers le site hdoc et télécharge le zip. Il extrait le zip et se rend vers le dossier hdoc_to_epub. Il lit le README.md et suit les directives pour obtenir son format epub. Pour cela, il doit coller son (ou ses) hdoc dans le dossier input et lancer l'exécutable "run". Enfin, il aura son (ou ses) epub dans le dossier output.
cliclac's avatar
cliclac committed
33

34

cliclac's avatar
cliclac committed
35 36 37
Supported
---------

Asus-PC's avatar
Asus-PC committed
38
Image : JPEG, JPG, PNG
cliclac's avatar
cliclac committed
39 40 41

Gestion du multifichiers en input

cliclac's avatar
cliclac committed
42 43
Hypertexte

44 45 46
Unsupported
-----------

Asus-PC's avatar
Asus-PC committed
47 48
### EPUB2

cliclac's avatar
cliclac committed
49 50
ODG : non supporté en EPUB => "Élément non supporté en EPUB : <xsl:value-of select="@data"/>"

Asus-PC's avatar
Asus-PC committed
51 52 53 54 55 56 57 58 59
CSS3

HTML5

SVG

(voir https://mpsltd.wordpress.com/2011/05/25/epub-3-vs-epub-2-0-2/)

### Conversion
cliclac's avatar
cliclac committed
60 61 62 63 64

Exercices

Méthode et Rappels (data-hdoc-type)

65 66 67
Known bugs
----------

68 69
Problème dans le hdoc : contient des images mais ne sont pas référencées.

cliclac's avatar
cliclac committed
70 71
Problème dans le hdoc : impossible de savoir quand il y a du code.

72
Problème avec les keywords : le hdoc contient des keywords mais nous ne savons pas où les utiliser.
73 74 75 76

Todo list
---------

Asus-PC's avatar
Asus-PC committed
77
tester avec SVG
cliclac's avatar
cliclac committed
78 79 80 81

Repérer le problème avec le css

Faire l'affichage des exercices
82

cliclac's avatar
cliclac committed
83
Faire l'affichage des nouveaux types : Méthode et Rappels
cliclac's avatar
cliclac committed
84

85 86
Technical Notes
---------------
Asus-PC's avatar
Asus-PC committed
87 88

Il est déconseillé de justifier le texte pour des raisons de lisibilité sur les liseuses.