<body><em><s><u>Liens utiles :</u></s></em><br>gitlab : <ahref="https://gitlab.utc.fr/crozatst/hdoc">https://gitlab.utc.fr/crozatst/hdoc</a><br>hdoc : <ahref="http://hdoc.crzt.fr/2014/co/hdocConverter.html">http://hdoc.crzt.fr/2014/co/hdocConverter.html</a><br>hdoc etherpad converter : <ahref="http://hdoc.crzt.fr/2014/co/etherpad.html">http://hdoc.crzt.fr/2014/co/etherpad.html</a><br>informations sur le format hdoc : <ahref="http://hdoc.crzt.fr/2014/co/hdoc.html">http://hdoc.crzt.fr/2014/co/hdoc.html</a><br>Changeset : <ahref="http://policypad.readthedocs.org/en/latest/changesets.html">http://policypad.readthedocs.org/en/latest/changesets.html</a><br><br><olclass="number"><li><strong>Product Backlog</strong></li><li><strong>Lister les tâches à réaliser pour améliorer le module actuel, et évaluer leur durée de réalisation.</strong></li><li><strong>Dépasser le volume horaire disponible, soit 18 h/pers * 3 pers = 54h</strong></li></ol><br><ulclass="bullet"><li>*markdown*</li><li>Prise en main du projet (1h)</li></ul>Configurer Git (1h)<br><br><ulclass="indent"><li>Restructuration antce (1h)</li><li>Etude du schéma Hdoc (3h)</li></ul>Etude du schéma etherpad (3h)<br><em>Etudier les possibilités d'xsl avec en entrée un fichier texte (3h)</em><br><em>Etudier les possibilités d'xsl en terme d'expressions régulières (2h)</em><br><em>Analyse de ce qu'ils faut enlever des fichiers .etherpad (2h)</em><br>Réécrire les fonctionalités du script perl dans le XSL. (5h)<br>Identifier pourquoi le projet actuel ne correspond pas au format HDoc (2h)<br>Corriger le projet pour que la sortie corresponde au schéma HDoc (10h)<br>Etudier la solution MarkDown et comment l'implémenter (3h)<br>Implémenter l'utilisation des balises Markdown dans etherpad. (3h)<br>Analyser comment fonctionne la notion d'auteur dans etherpad et comment l'implémenter en Hdoc (3h)<br>Implémenter une mise en forme en Hdoc pour distinguer ce que les différents auteurs ont écrits ( {& author text &} (3h)<br>Corriger le projet pour avoir un format Hdoc destination compatible avec les modules Opale et Optim (3h)<br>Creer les applications de etherpad vers Optim/Opale en utilisant les modules existants (3h)<br>Rendre compte des tâches réalisées et de la TODO restante à la fin de la période (1h)<br>Comprendre en quoi l'ancien site web d'exemple est considéré obsolète (1h)<br>Mettre à niveau le site web d'exemple (1h)<br>Mise à jour de la rubrique correspondant au projet sur le site Hdoc (1h)<br>Réaliser un rapport de projet (2h)<br><br><br>XSL1 du html a xHTML<br>-> fermer les br.<br>-> enlever la balise meta<br><s>->rajouter attribut type='css' dans la balilse style.</s><br>->Rajouter une balise <div>à la fin et au début du texte<br><ulclass="indent"><li><br></li></ul>XSL2 du xHTML à HDOC<br><br><br>A la fin, on doit livrer quoi ? Application ? Antce ?<br><br>-de etherpad vers hdoc<br><br>Et en plus potentiellement de etherpad vers d'autres modules (Optim ou Opale par exemple) qui utilisent ces deux premières applications directement.<br>Oui non à priori y'a pas de hdoc vers etherpad<br>La chaine visée c'est Etherpad - Hdoc - Optim/Opale<br></body>
How to transform an etherpad document in lexique document.
Filepath in this document are relative to this file readme.
## Dependence
- Etherpad2Hdoc
- Hdoc2Lexique
## User Documentation
1. Download an etherpad document in html format.
1. Create or join an etherpad document then export it in html format (Import/Export Button) in the `/input` directory (if the directory does not exists, you have to create it).
2. Name it pad.html
2. Execute the file `/run.bat` or `/run.sh` depending on the OS. A `.scar` file is created in the directory `/output`
*If the `/input` directory contains multiple files, they won't be all treated.
*If the `/input` directory contains multiple files, they won't be all treated.*
3. Open the document with Scenari
1. Open Scenari, and choose "UTC-etu_lexique" as distant depot.
2. Go in the directory `sandBox/etherpad-to-lexique.`
3. Import your `.scar` file in the directory.
4. Open the file Main.xml created.
##Unsupported
## Unsupported
- MarkDown
- Timeline and author paternity
- Chat
##Known bugs
## Known bugs
Nested lists in lists are not supported
example :
Example :
`<ul>
<li>
<ul>
...
...
@@ -43,33 +56,29 @@ example :
## TODO
- Work with markdown
- Correct nested lists
## Technical notes
### Description of etherpad_to_hdoc.ant
#### Prelude
- Importation of necessary classes (antlib, htmlcleaner, jing)
- Creation of directories architecture tree
- Importation of necessary classes (antlib, htmlcleaner, jing)
- Creation of directories architecture tree
#### Transformations
- Use of htmlcleaner to transform the input file from html to xhtml. For more info, see http://htmlcleaner.sourceforge.net/index.php.
- Apply html2xhtml.xsl : this xsl extracts the content into <body> tags
- Apply html2xhtmlv1.xsl : this xsl is used as a fix and adds br tag at the end of lists (ul and ol)
- Apply html2xhtmlv2.xsl : this xsl surround text line with p tags and transforms non-hdoc tags into hdoc tags as s, u, strong tags.
- Apply html2xhtml3.xsl : this xsl is used as a fix, it deletes p tags when its child is ul or ol
- Apply xhtml2hdoc.xsl : this xsl transforms the content into hdoc structure
- Use of htmlcleaner to transform the input file from html to xhtml. For more info, see http://htmlcleaner.sourceforge.net/index.php.
- Apply html2xhtml.xsl : this xsl extracts the content into <body> tags
- Apply html2xhtmlv1.xsl : this xsl is used as a fix and adds br tag at the end of lists (ul and ol)
- Apply html2xhtmlv2.xsl : this xsl surround text line with p tags and transforms non-hdoc tags into hdoc tags as s, u, strong tags.
- Apply html2xhtml3.xsl : this xsl is used as a fix, it deletes p tags when its child is ul or ol
- Apply xhtml2hdoc.xsl : this xsl transforms the content into hdoc structure
#### Post-transformations actions
- Build hdoc structure
- Jing checks if the output file is validated with the right rng schema
- Zip the directory into hdoc archive
- Build hdoc structure
- Jing checks if the output file is validated with the right rng schema
- Zip the directory into hdoc archive
## Capitalisation
We have to change how we get the input file:
1 Get the first file of the input directory
2 Make the run with the name of the file as parameter
Finally, ant should be changed to manage multiple entries
Finally, ant should be changed to manage multiple entries
How to transform an etherpad document in opale document.
Filepath in this document are relative to this file readme.
Filepaths in this document are relative to this readme file.
## Dependence
- Etherpad2Hdoc
- Hdoc2Opale
## User Documentation
1. Download an etherpad document in html format.
1. Create or join an etherpad document then export it in html format (Import/Export Button) in the `/input` directory (if the directory does not exists, you have to create it).
...
...
@@ -22,13 +33,17 @@ Filepath in this document are relative to this file readme.
2. Go in the directory `sandBox/etherpad-to-opale.`
3. Import your `.scar` file in the directory.
4. Open the file Main.xml created.
##Unsupported
## Unsupported
- MarkDown
- Timeline and author paternity
- Chat
##Known bugs
Nested lists in lists are not supported
example :
## Known bugs
Nested lists in lists are not supported.
Here's an example :
`<ul>
<li>
<ul>
...
...
@@ -42,32 +57,29 @@ example :
## TODO
- Work with markdown
- Correct nested lists
## Technical notes
### Description of etherpad_to_hdoc.ant
#### Prelude
- Importation of necessary classes (antlib, htmlcleaner, jing)
- Creation of directories architecture tree
- Importation of necessary classes (antlib, htmlcleaner, jing)
- Creation of directories architecture tree
#### Transformations
- Use of htmlcleaner to transform the input file from html to xhtml. For more info, see http://htmlcleaner.sourceforge.net/index.php.
- Apply html2xhtml.xsl : this xsl extracts the content into <body> tags
- Apply html2xhtmlv1.xsl : this xsl is used as a fix and adds br tag at the end of lists (ul and ol)
- Apply html2xhtmlv2.xsl : this xsl surround text line with p tags and transforms non-hdoc tags into hdoc tags as s, u, strong tags.
- Apply html2xhtml3.xsl : this xsl is used as a fix, it deletes p tags when its child is ul or ol
- Apply xhtml2hdoc.xsl : this xsl transforms the content into hdoc structure
- Use of htmlcleaner to transform the input file from html to xhtml. For more info, see http://htmlcleaner.sourceforge.net/index.php.
- Apply html2xhtml.xsl : this xsl extracts the content into <body> tags
- Apply html2xhtmlv1.xsl : this xsl is used as a fix and adds br tag at the end of lists (ul and ol)
- Apply html2xhtmlv2.xsl : this xsl surround text line with p tags and transforms non-hdoc tags into hdoc tags as s, u, strong tags.
- Apply html2xhtml3.xsl : this xsl is used as a fix, it deletes p tags when its child is ul or ol
- Apply xhtml2hdoc.xsl : this xsl transforms the content into hdoc structure
#### Post-transformations actions
- Build hdoc structure
- Jing checks if the output file is validated with the right rng schema
- Zip the directory into hdoc archive
- Build hdoc structure
- Jing checks if the output file is validated with the right rng schema
- Zip the directory into hdoc archive
## Capitalisation
We have to change how we get the input file:
1 Get the first file of the input directory
2 Make the run with the name of the file as parameter
Finally, ant should be changed to manage multiple entries
Finally, ant should be changed to manage multiple entries