README.md 2.47 KB
Newer Older
cliclac's avatar
cliclac committed
1
Hdoc to Epub2
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
------------

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 Epub2" is an hdoc converter to epub version 2.0 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 35 36 37

Unsupported
-----------

Asus-PC's avatar
Asus-PC committed
38 39
### EPUB2

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

Asus-PC's avatar
Asus-PC committed
42 43 44 45 46 47 48 49 50
CSS3

HTML5

SVG

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

### Conversion
cliclac's avatar
cliclac committed
51

cliclac's avatar
cliclac committed
52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99
Ce qui n'est pas implémenté dans la conversion opale_to_hdoc c'est-à-dire :
* Module
	* Titre court
	* Références générales
	* Activité d'auto évaluation
	* Exercice rédactionnel
	* Exercice QCM
	* Exercice QCM graphique
	* Exercice QCU
	* Exercice QCU graphique
	* Exercice catégorisation
	* Exercice ordonnancement
	* Exercice texte à trous
	* Exercice question à réponse courte
	* Liste d'exercice

* Activité d'apprentissage
	* Titre court
	* Exercice rédactionnel
	* Exercice QCU
	* Exercice QCU graphique
	* Exercice QCM
	* Exercice QCM graphique
	* Exercice catégorisation
	* Exercice ordonnancement
	* Exercice texte à trous
	* Exercice question à réponse courte
	* Liste d'exercice

* Grain de contenu
	* Titre court

* Blocs
	* All bloc types are supported

* Types de texte
	* Ressources (ressources de type animation non supporté)
	* Fichier en téléchargement

* Éléments présents dans un texte
	* Formule mathématique
	* Abréviation
	* Glossaire
	* Références
	* Lien vers un document
	* Renvoi vers une ressource
	* Renvoi vers un grain de contenu
	* Animation
cliclac's avatar
cliclac committed
100

101 102 103
Known bugs
----------

104
data-hdoc-type="references" : liste à puce inversé (<li><ul></ul><ul></ul></li>)
105 106 107 108

Todo list
---------

cliclac's avatar
cliclac committed
109
Faire les conversions nécessaires lorsque la conversion opale_to_hdoc évoluera.
cliclac's avatar
cliclac committed
110

111 112
Technical Notes
---------------
Asus-PC's avatar
Asus-PC committed
113 114

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