This project aims at converting mindmapping files to hdoc files.
This project aims at converting mindmapping files (.mm) to hdoc files. If you use another tool to create mindmapping files, you can probably export it to a .mm file and use it in this converter.
User documentation
------------------
* Use a terminal and go to the root of the folder (mindmapping_to_hdoc).
* Please refer to the part *Rules to follow* to understand the rules that can help you to personalize the output
* Put your files in a folder 'mindmapping_to_hdoc/input'
* Put your files in a folder 'mindmapping_to_hdoc/input'. The file has to be a Freemind file (.mm).
* Enter the command line corresponding to your OS :
* On Linux : 'sh run.sh'
* On Windows : 'run.bat'
...
...
@@ -44,14 +44,12 @@ Unsupported
Known bugs
----------
* All hdoc samples given in the "Download" section have been tested and should work well. If you want to use your own hdoc files, make sure that container.xml's root contains version="1.0" and xmlns="urn:utc.fr:ics:hdoc:container" attributes. Otherwise ant building will fail.
* It is not specified in hdoc's standard but I assume that hdoc's content file (usually named "content.xml") fullpath is a relative path that begins at the root of the hdoc archive. That means that the full-path attribute of <rootfile> (in container.xml) begins with a character, and not a special sequence such as ".", ".." or "/". It is already the case for my samples, but if you want to use your own samples make sure this full-path attribute is ok.
Todo
----
* Mindmap to Lexique conversion
* Mindmap to Optim conversion
* Check the compatibility of version and software (files exported from Xmind etc.)
@@ -19,7 +19,7 @@ It is based on the work of Guillaume GOMEZ in 2014.
## Presentation
The project aims at converting Freemind files in Opale files.
The project aims at converting Freemind files in Opale files. If you use another tool to create mindmapping files, you can probably export it to a .mm file and use it in this converter.
- the level of unit of content for the Opal conversion if basically set to sections witch doesn't contains any section but some could need it to be set to another level. Create a selection of this level could be a next step for this project
- qualify supported version of Optim
- the level of unit of content for the Opal conversion if basically set to sections witch doesn't contains any section but some could need it to be set to another level. Create a selection of this level could be a next step for this project
- maybe define it from the opale root file (paper, section, website, slideshow and webpage)
- and/or define it from the command line
- and/or choose it terms of heuristic (size of content, number of imbricated parts...)
@@ -73,4 +73,4 @@ During all the process it also prints some basic information both on screen and
Capitalization
--------------
While working on this project, we have learned more about ANT scripting (more specifically bulding an multi-os script and running scripts by detecting the OS) and about problem solving in general (how to go from one specific need to a result).
2 - Display the table on the right in the introduction (text and images)
Concerning images :
1 - Extract the metadata information from the meta.xml file for each image. You can do that by creating an XSL file that will be called from the ant task generated by xslt/get_ressources_urls.xsl. In that file you have the hand on each meta.xml File.
...
...
@@ -85,12 +94,11 @@ Concerning tables :
2 - Change Hdoc Scheme in order to accept images in tables?
3 - Display complex tables as tables in Opale (not as extern files)
3 - Display complex tables as tables in Opale (not as extern files).
Technical notes
---------------
For images you can refer to the get-ressources-with-meta.xsl and official-meta.xml. Read the commentary and it will help you
to finish the to do task regarding images. These files are included just for the seek of Capitalization.
For images you can refer to the get-ressources-with-meta.xsl and official-meta.xml. Read the commentary and it will help you finish the to do task regarding images. These files are included just for the needs of Capitalization.
1 - Linux sh files doesn't work with UTC proxy but works outside of UTC.
2 - Random errors might occur
Wikipedia is a great tool : everyone can participe. However, it does not provide contributors with best practices that everyone follows. The result is a lot of different ways to write articles. This is why this converter might not handle some situations (even if all files I have tried worked), and it might not be able to output some Wikipedia articles at its current state.
Wikipedia is a great tool : everyone can participe. However, it does not provide contributors with best practices that everyone follows. The result is a lot of different ways to write articles. This is why this converter might not handle some situations (even if all files tried worked), and it might not be able to output some Wikipedia articles at its current state.
3 - Small issues with Opale
Links can be invisible if you use an old version of Opale. This is not a problem coming from the Wikipedia to Hdoc converter. Make sure you use an updated version of Opale to test your scar archives.
1 - Copy the content of the Wikipedia article you want to convert in the directory named “input” and in a file called “source.xml".
2 - Run the comand corresponding to your OS
Display the source code of the wikipedia page, copy it and paste it in the new file source.xml
Make sure to copy/paste the source code and not save it directly as a file.
2 - Run the command corresponding to your OS
On windows :
runFile.bat
...
...
@@ -76,20 +77,17 @@ BUG
Unsupported
-----------
1 Images:
- images inside text are not supported because of schema validation.
Known Bugs
----------
- Images inside text are not supported because of schema validation.
To do
-----
1 Images:
- Do a preposition to modify the hdoc schema so that we will be able to manage images inside text
- Complete the extraction of the metadata information of images
Technical notes
---------------
Capitalisation
--------------
For images you can refer to the get-ressources-with-meta.xsl and official-meta.xml in the hdoc_to_wikipedia/xslt Folder Read the commentary. It will help you to finish the task regarding images. These files are included to give you a solution to start from.
