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
readme    
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
readme    
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
readme    
cliclac committed
78
79
80
81

Repérer le problème avec le css

Faire l'affichage des exercices
82

cliclac's avatar
readme    
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.