wiki:PageToDocIntegration

Version 10 (modified by markm, 14 years ago) (diff)

Various improvements to the installation instructions

A Trac plugin for export of wiki pages to MS Word

Hi
Mark here.
As Lucas is moving on - I would like to thank him for this plugin. I have some ideas for change - but for now will restrict myself to trying to fix the issues already logged.
Mark

Description

The aim of the plugin is to transform a wiki page so that it can be imported using the HTML import capability of MS Word. After that, a format template can be applied, and the text might be copied into a document template.

The plugin works as follows:

  • Ask's Trac to generate the HTML
  • Cleanup and validation using HTML Tidy.
  • Transformation using a XSLT stylesheet
  • Offering a zip file with wiki page and images for downloading.

Installation:

Dependencies

  • HTML Tidy Install HTML Tidy (Windows: www.paehl.com/open_source/?download=tidy.zip).
  • XSLTProc Make sure xsltproc is available. If not, install from http://xmlsoft.org/XSLT/xsltproc2.html (Windows: www.zlatkovic.com/pub/libxml/)
    • From the linked page Click Downloads and download iconv, libxslt, libxml2, zlib
    • Test that it has been installed correctly by running xsltproc (it should output a help page)
    • On windows - the binaries for all the XSLTProc tools either need to be in one directory (if this directory is not on the search path then please specify the xsltprocpath configuration setting)

PageToDocIntegration Plugin

  • Use easy_install.py PageToDocIntegration
  • or
    • Download or checkout the source
    • Compile the plugin setup.py bdist_egg
    • Copy the .egg file into your Trac Environment plugins directory
  • Save the XSLT stylesheet onto your disk.
  • Create the following section in your trac.ini (modify path):
    [pagetodoc]
    xsltfile = /path/to/your/xsltfile.xslt
    
  • Install plugin.
    • The same can be done by adding the following line to the [components] section of your trac.ini file e.g.
      [components]
      PageToDoc.* = enabled
      

The plugin is in a alpha state. There are a couple of things to be enhanced. Please enter feedback and bugs (good idea to email me also - see my email address at the bottom of this page).

Configuration

Configuration options are made in trac\environment\path\conf\trac.ini and the parameters are in the [pagetodoc] section (which you will need to add as documented in the installation instructions).

xsltfile (Required) The path to the XSLT file to use for transforming the wiki HTML output. Specify the filepath of html_filtered.xslt shipped with PageToDocIntegration
tidypath (Optional) Path to tidy executable. If left empty then the executable search path is used.
Added in [5406] hoping it helps to resolve issues like #4396
xsltprocpath (Optional) Path to xlstproc executable. If left empty then the executable search path is used.
Added in [5406] hoping it helps to resolve issues like #4396
replace_host (Optional) Two strings separated by a comma. A replace operation is performed on the image URL finding the first part and replacing with the 2nd part.
Added in [5401] hoping it fixes #3507
img_max_x (Optional) max image width? Used to calculate if image needs to be resized. Default is 0
img_max_y (Optional) max image height? Used to calculate if image needs to be resized. Default is 0
dpi (Optional) dots per inch? Used to calculate if image needs to be resized. Default is 96
[pagetodoc]
xsltfile = /path/to/your/xsltfile.xslt
replace_host = man-wwl-sw, localhost
xsltprocpath = path/to/xsltproc.exe
tidypath = /path/to/tidy.exe
img_max_x = 500
img_max_y = 200
dpi = 96

Bugs/Feature Requests

Existing bugs and feature requests for PageToDocIntegration are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from [download:pagetodocintegration here].

Source

You can check out PageToDocIntegration from here using Subversion, or browse the source with Trac.

Example

Once installed, a new entry shows up below the Download in other formats section at the end of the page. Click and save to disk. Extract and open with Word.

Recent Changes

16518 by rjollos on 2017-04-16 01:49:04
Fix indentation
7642 by markm on 2010-02-18 09:38:54
Fixed spelling errors regarding xslt (was xlst)
7641 by markm on 2010-02-18 09:36:38
Fixes:6522
The order of the parameters to xsltproc were wrong.
(more)

Author/Contributors

Author: lei
Current Maintainer: markm (mark dot m dot mcmahon at gmail dot com) (please email me if you encounter a bug as I do not check here very frequently)
Contributors: