1# odtplus2dw Plugin 2 3Create a dokuwiki page from a file. 4 5- More information about odtplus2dw at http://www.dokuwiki.org/plugin:odtplus2dw 6- More information about odt2dw at http://www.dokuwiki.org/plugin:odt2dw 7- More information about dokuwiki at http://www.dokuwiki.org 8 9## Description 10 11odtplus2dw is a plugin for dokuwiki (forked from odt2dw to add doc/docx support). This plugin lets you import a document into Dokuwiki. It supports (at least) .odt, .doc, .docx formats. It should also work with any other document format that pandoc supports, but it has not been tested yet. 12 13## Usage 14 15From a Dokuwiki page, click on the "Import file" button in the Page Tools. Select a File and click upload. 16 17## Installation 18 19**External requirements:** This plugin requires the following additional components that must be installed separately: 20 21- php xsltProcessor class (ex : php-xml, php5-xsl) 22- php zipArchive class 23- pandoc 24- soffice (ex: libreoffice-writer) 25 26If you run the Dokuwiki server on Debian, you can accomplish this requirements following this directions: 27 28- Install some packages needed: 29 30`sudo apt-get install wget default-jre php5-xsl libreoffice-writer` 31 32- If you wish, you can execute the script `installLatestPandoc.sh` (included with this plugin) to install the latest version of pandoc. Or you can install pandoc any other way (check that version installed is not very outdated, or the conversion can fail). 33 34### soffice conversion (.doc support) 35 36PHP code (at least in my system) is executed by the user `daemon`. I had problems running a Java application with this user (it seems soffice is a Java application) so I decided to run the soffice conversion using `sudo`. To make it work, I had to add a line to the file `/etc/sudoers`. You can do the same executing: 37 38`sudo echo "daemon ALL=(root)NOPASSWD:/usr/bin/soffice" >> /etc/sudoers` 39 40I'm not a security expert, but I think that this should not be a problem for anybody. If you do not use the soffice conversion (.doc support), you don't need to do this. 41 42If PHP code is executed by any other user on your system, you only have to change it in the previous command. 43 44## Configuration and Settings 45 46They are almost self-explanatory. 47 48## Change Log 49 50### v0.12 beta 51 52- Fixed: https://github.com/qky666/dokuwiki-plugin-odtplus2dw/issues/8 53 54### v0.11 beta 55 56- Now the names of uploaded files can contain spaces. 57- Added French translation (thank you jmgfr!). 58 59### v0.10 beta 60 61- Changed name to odtplus2dw. 62- Added doc/docx support. 63- Added spanish translation. 64- Removed some translations (I can't update them, so I had to remove). 65 66### v0.09 beta 67 68- Adjust method signatures to match parent. 69- Add import button. 70 71### v0.08 beta 72 73- Fixed : bug #9. 74- Fixed : bug #14. 75 76### v0.07 beta 77 78- Fixed : parserPostDisplay now works with choice edit or preview. 79- Fixed : better class existence control. 80 81### v0.06 beta 82 83- Fixed : some small fixes to the english messages. 84- Add : message translation in Dutch (By mprins). 85- Fixed : check for mime type was too specific : It could be set in config panel. 86- Fixed : submit button was not translated and stay in french : His value depend of the dokuwiki lang file now. 87 88### v0.05 beta 89 90- Fixed : display an error if the parserUploadDir directory doesn't exists. Now it will be create if needed. 91