README.md 1.86 KB
Newer Older
1
README.md
Antoine's avatar
Antoine committed
2 3
# Converter lexique_to_hdoc

4 5 6 7 8 9 10 11 12
License GPL.3.0
http://www.gnu.org/licenses/gpl-3.0.txt

Crédits
Estelle de Magondeaux
Antoine Aufrechter
Marouane Hammi

Install
Antoine's avatar
Antoine committed
13
In order to use this converter, follow those steps :
Antoine's avatar
Antoine committed
14 15 16 17
1. Create a dictionnary "dictionnaire.xml" which referenciate every definition you want to put in your hdoc. This dictionnary must respect the "dictionnaire.rng" schema
2. Copy the referenciated definitions in the same folder than the dictionnary (input)
3. Your input folder must contain the dictionnary (dictionnaire.xml) and the lexique definitions (**.term).
4.  Execute the run that corresponds to your OS. (run.sh for Linux, run.bat for Windows) 
18 19 20 21 22 23
5.  You will find the result into the output directory: it is named "content.xml".

Dependances
none.

User documentation
Antoine's avatar
Antoine committed
24 25
You will find a "help" directory that contains: 
- A sample of dictionnary that you need to write and call "dictionnaire.xml".
26 27
- the lexique definition that you can choose to put into your hdoc (help/available_definition folder).
The generated folder is a .xml . If you desire to see the output in you browser, you need to rename it as a .html.
Antoine's avatar
Antoine committed
28
If you want to create more definitions with images and tables, you will need to put this ressources in the folder named "&". It contains all the ressources which are copy-pasted in the output folder so they can e seen in the hdoc.
29 30 31 32 33 34 35 36

Unsupported
Audio and video transformation

Known bugs


TODO
Antoine's avatar
Antoine committed
37
create a better transformation for the ressources. At the moment the user needs to copy the ressources in a folder named "&". The best would be to match the ressources in every definitions, and to call an Ant which automatically copy the ressources needed in this folder.
38 39 40
Create a transformation which allows every audio resources to be seen in the hdoc.

Technical notes
Antoine's avatar
Antoine committed
41
If folders' names are changed, you will need to change the tasks of the ANT file.
42 43 44 45

Capitalisation