8 | | |
9 | | == Bugs/Feature Requests |
10 | | |
11 | | Existing bugs and feature requests for WikiExportPlugin are |
12 | | [report:9?COMPONENT=WikiExportPlugin here]. |
13 | | |
14 | | If you have any issues, create a |
15 | | [/newticket?component=WikiExportPlugin new ticket]. |
16 | | |
17 | | [[TicketQuery(component=WikiExportPlugin&group=type,format=progress)]] |
18 | | |
19 | | == Download |
20 | | |
21 | | Download the zipped source from [export:wikiexportplugin here]. |
22 | | |
23 | | == Source |
24 | | |
25 | | You can check out WikiExportPlugin from [/svn/wikiexportplugin here] using Subversion, or [source:wikiexportplugin browse the source] with Trac. |
26 | | |
27 | | == Installation and Configuration |
28 | | |
29 | | This plugin has been developed with '''python-uno''' 2.4.1, '''[http://www.crummy.com/software/BeautifulSoup/ BeautifulSoup]''' 3.0.7a and '''python-imaging-library (PIL)'''. |
30 | | |
31 | | '''Note''': The plugin has been tested with !OpenOffice 3.2, Python UNO 3.2 and Trac 0.12.1 and works as designed. |
32 | | |
33 | | Python-uno is not installed by default. The exact installation instruction depend on the operating system you are using: |
34 | | * Linux: If your Linux uses apt, you can install python-uno as follows: |
35 | | {{{#!sh |
36 | | apt-get install python-uno python-beautifulsoup python-imaging |
37 | | }}} |
38 | | * With Debian Lenny 5.0, if you want to run '''soffice''' with `-headless` option, install these packages also: |
39 | | {{{#!sh |
40 | | apt-get install openoffice.org openoffice.org-headless openoffice.org-java-common |
41 | | }}} |
42 | | * Mac: I can't install python-uno on Mac OS. |
43 | | * Windows: The following article can be useful: http://wiki.services.openoffice.org/wiki/Using_Python_on_Windows |
44 | | |
45 | | Before use, you must start Open Office in service mode. To start Office in this mode, use a command like this: |
46 | | |
47 | | {{{#!sh |
48 | | soffice "-accept=socket,host=localhost,port=8100;urp;" -headless (1) |
49 | | soffice -accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager (2) |
50 | | }}} |
51 | | |
52 | | The version of Open Office used in the development of the plugin was the 2.4. |
53 | | |
54 | | 1. Openoffice 2.4 with headless without framebuffer. |
55 | | 1. Standard Openoffice server with X. |
56 | | |
57 | | == Example |
58 | | |
59 | | A possible configuration of this plugin is the following: |
60 | | |
61 | | {{{#!ini |
62 | | [openOffice-exporter] |
63 | | user = john |
64 | | psswrd = 1234 |
65 | | host = localhost |
66 | | port = 8100 |
67 | | para-styles = Text Body, Default, Heading 1, Heading 2, Heading 3, ..., Heading 10 |
68 | | list-styles = List 1, Numbering 1, Numbering 2, Numbering 3 |
69 | | char-styles = Default, Source Text, Internet Link |
70 | | isPersonalizeAttribute = False |
71 | | }}} |
72 | | |
73 | | A brief description of the fields: |
74 | | |
75 | | * '''user''' and '''psswrd''': If the trac project needs authentication, for export the images you need to pass a user and a password for construct a url that urllib can open. |
76 | | * '''host''' and '''port''': When you start the soffice in service mode, you must specify a host and a port where the service accepts the connections. By default in this plugin, these values are localhost and 8100. |
77 | | * '''para-styles''', '''list-styles''' and '''char-styles''': Are the styles that you want to use of the open office to export the wiki pages. |
78 | | |
79 | | All these fields are optional, but the default configuration of this plugin is for the Spanish version of Open Office. |
| 38 | == Bugs/Feature Requests |
| 39 | |
| 40 | Existing bugs and feature requests for WikiExportPlugin are |
| 41 | [report:9?COMPONENT=WikiExportPlugin here]. |
| 42 | |
| 43 | If you have any issues, create a |
| 44 | [/newticket?component=WikiExportPlugin new ticket]. |
| 45 | |
| 46 | [[TicketQuery(component=WikiExportPlugin&group=type,format=progress)]] |
| 47 | |
| 48 | == Download |
| 49 | |
| 50 | Download the zipped source from [export:wikiexportplugin here]. |
| 51 | |
| 52 | == Source |
| 53 | |
| 54 | You can check out WikiExportPlugin from [/svn/wikiexportplugin here] using Subversion, or [source:wikiexportplugin browse the source] with Trac. |
| 55 | |
| 56 | == Installation |
| 57 | |
| 58 | This plugin has been developed with '''python-uno''' 2.4.1, '''[http://www.crummy.com/software/BeautifulSoup/ BeautifulSoup]''' 3.0.7a and '''python-imaging-library (PIL)'''. |
| 59 | |
| 60 | '''Note''': The plugin has been tested with !OpenOffice 3.2, Python UNO 3.2 and Trac 0.12.1 and works as designed. |
| 61 | |
| 62 | Python-uno is not installed by default. The exact installation instruction depend on the operating system you are using: |
| 63 | * Linux: If your Linux uses apt, you can install python-uno as follows: |
| 64 | {{{#!sh |
| 65 | $ apt-get install python-uno python-beautifulsoup python-imaging |
| 66 | }}} |
| 67 | * With Debian Lenny 5.0, if you want to run '''soffice''' with `-headless` option, install these packages also: |
| 68 | {{{#!sh |
| 69 | $ apt-get install openoffice.org openoffice.org-headless openoffice.org-java-common |
| 70 | }}} |
| 71 | * Mac: untested |
| 72 | * Windows: The following article can be useful: http://wiki.services.openoffice.org/wiki/Using_Python_on_Windows |
| 73 | |
| 74 | == Configuration |
| 75 | |
| 76 | Before use, you must start Open Office in service mode. To start Office in this mode, use a command like this: |
| 77 | |
| 78 | {{{#!sh |
| 79 | soffice "-accept=socket,host=localhost,port=8100;urp;" -headless (1) |
| 80 | soffice -accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager (2) |
| 81 | }}} |
| 82 | |
| 83 | The version of Open Office used in the development of the plugin was the 2.4. |
| 84 | |
| 85 | 1. Openoffice 2.4 with headless without framebuffer. |
| 86 | 1. Standard Openoffice server with X. |
| 87 | |
| 88 | A possible configuration of this plugin is the following: |
| 89 | |
| 90 | {{{#!ini |
| 91 | [openOffice-exporter] |
| 92 | user = john |
| 93 | psswrd = 1234 |
| 94 | host = localhost |
| 95 | port = 8100 |
| 96 | para-styles = Text Body, Default, Heading 1, Heading 2, Heading 3, ..., Heading 10 |
| 97 | list-styles = List 1, Numbering 1, Numbering 2, Numbering 3 |
| 98 | char-styles = Default, Source Text, Internet Link |
| 99 | isPersonalizeAttribute = False |
| 100 | }}} |
| 101 | |
| 102 | A brief description of the fields: |
| 103 | |
| 104 | * '''user''' and '''psswrd''': If the trac project needs authentication, for export the images you need to pass a user and a password for construct a url that urllib can open. |
| 105 | * '''host''' and '''port''': When you start the soffice in service mode, you must specify a host and a port where the service accepts the connections. By default in this plugin, these values are localhost and 8100. |
| 106 | * '''para-styles''', '''list-styles''' and '''char-styles''': Are the styles that you want to use of the open office to export the wiki pages. |
| 107 | |
| 108 | All these fields are optional, but the default configuration of this plugin is for the Spanish version of Open Office. |
| 109 | |