Changes between Version 38 and Version 39 of WikiExportPlugin


Ignore:
Timestamp:
Jan 15, 2021, 8:32:56 PM (5 months ago)
Author:
figaro
Comment:

Rearranging paragraphs for legibility

Legend:

Unmodified
Added
Removed
Modified
  • WikiExportPlugin

    v38 v39  
    66
    77This plugin allows you to export wiki pages to PDF, ODT and DOC format. This plugin is licensed under LGPL.
    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.
    808
    819When this plugin is active, the following options appear in the wiki pages:
     
    10836}}}
    10937
     38== Bugs/Feature Requests
     39
     40Existing bugs and feature requests for WikiExportPlugin are
     41[report:9?COMPONENT=WikiExportPlugin here].
     42
     43If 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
     50Download the zipped source from [export:wikiexportplugin here].
     51
     52== Source
     53
     54You can check out WikiExportPlugin from [/svn/wikiexportplugin here] using Subversion, or [source:wikiexportplugin browse the source] with Trac.
     55
     56== Installation
     57
     58This 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
     62Python-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
     76Before use, you must start Open Office in service mode. To start Office in this mode, use a command like this:
     77
     78{{{#!sh
     79soffice "-accept=socket,host=localhost,port=8100;urp;" -headless              (1)
     80soffice -accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager (2)
     81}}}
     82
     83The 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
     88A possible configuration of this plugin is the following:
     89
     90{{{#!ini
     91[openOffice-exporter]
     92user = john
     93psswrd = 1234
     94host = localhost
     95port = 8100
     96para-styles = Text Body, Default, Heading 1, Heading 2, Heading 3, ..., Heading 10
     97list-styles = List 1, Numbering 1, Numbering 2, Numbering 3
     98char-styles = Default, Source Text, Internet Link
     99isPersonalizeAttribute = False
     100}}}
     101
     102A 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
     108All these fields are optional, but the default configuration of this plugin is for the Spanish version of Open Office.
     109
    110110== Recent Changes
    111111