ConfluenceConverter

Changeset

118:cfb5c203b6f4
2013-11-01 Paul Boddie raw files shortlog changelog graph Added details of the ExportPDF action.
README.txt (file) TO_DO.txt (file) scripts/redirect.py (file)
     1.1 --- a/README.txt	Fri Nov 01 19:30:16 2013 +0100
     1.2 +++ b/README.txt	Fri Nov 01 19:30:41 2013 +0100
     1.3 @@ -67,6 +67,33 @@
     1.4  python moinsetup.py -m edit_theme_stylesheet screen.css includecomments.css
     1.5  python moinsetup.py -m edit_theme_stylesheet print.css includecomments.css
     1.6  
     1.7 +Additional Software
     1.8 +-------------------
     1.9 +
    1.10 +PDF export support requires the ExportPDF action:
    1.11 +
    1.12 +http://moinmo.in/ActionMarket/ExportPDF
    1.13 +
    1.14 +This in turn requires Apache FOP for PDF production using XSL-FO:
    1.15 +
    1.16 +http://xmlgraphics.apache.org/fop/
    1.17 +
    1.18 +(On Debian systems, the fop package provides this tool.)
    1.19 +
    1.20 +To produce XSL-FO from DocBook output, xsltproc is required from the libxslt
    1.21 +distribution:
    1.22 +
    1.23 +http://xmlsoft.org/XSLT/
    1.24 +
    1.25 +(On Debian systems, the xsltproc package provides this tool.)
    1.26 +
    1.27 +And DocBook output requires the DocBook resources to be installed, described
    1.28 +in the following guide:
    1.29 +
    1.30 +http://www.sagehill.net/docbookxsl/ToolsSetup.html
    1.31 +
    1.32 +(On Debian systems, the docbook-xsl package provides these resources.)
    1.33 +
    1.34  Quick Start
    1.35  -----------
    1.36  
    1.37 @@ -161,17 +188,23 @@
    1.38  sense. To support this, the following resources are involved:
    1.39  
    1.40    * scripts/dashboard.py
    1.41 +  * scripts/redirect.py
    1.42    * scripts/search.py
    1.43    * config/mailmanwiki-redirect
    1.44  
    1.45  The latter configuration file is also involved in identifier-to-page mapping,
    1.46 -but in this case it causes requests to the "dashboard" and "dosearchsite"
    1.47 -actions to be directed to the dashboard.py and search.py scripts respectively.
    1.48 +but in this case it causes requests to the "dashboard", "doexportpage" and
    1.49 +"dosearchsite" actions to be directed to the dashboard.py, redirect.py and
    1.50 +search.py scripts respectively.
    1.51  
    1.52  The dashboard.py script merely redirects requests to the root of the site,
    1.53  thus assuming that the front page is configured to show dashboard-like
    1.54  information.
    1.55  
    1.56 +The redirect.py script, apart from supporting identifier-to-page redirects,
    1.57 +also supports PDF page exports since the "doexportpage" action uses
    1.58 +identifiers to indicate which page is to be exported.
    1.59 +
    1.60  The search.py script redirects search requests in a suitable form to the
    1.61  MoinMoin "fullsearch" action.
    1.62  
     2.1 --- a/TO_DO.txt	Fri Nov 01 19:30:16 2013 +0100
     2.2 +++ b/TO_DO.txt	Fri Nov 01 19:30:41 2013 +0100
     2.3 @@ -58,7 +58,7 @@
     2.4  
     2.5    http://wiki.list.org/pages/doexportpage.action?pageId=786442&type=TYPE_PDF
     2.6  
     2.7 -  ...can be supported using the RenderAsPDF action)
     2.8 +  ...can be supported using the ExportPDF action)
     2.9  
    2.10    (Note that viewpage actions like the following...
    2.11  
     3.1 --- a/scripts/redirect.py	Fri Nov 01 19:30:16 2013 +0100
     3.2 +++ b/scripts/redirect.py	Fri Nov 01 19:30:41 2013 +0100
     3.3 @@ -46,7 +46,7 @@
     3.4      sys.exit(0)
     3.5  
     3.6  def redirect(pagename, export=False):
     3.7 -    location = "%s/%s%s" % (URL_PREFIX, quote(pagename), export and "?action=RenderAsPDF" or "")
     3.8 +    location = "%s/%s%s" % (URL_PREFIX, quote(pagename), export and "?action=ExportPDF" or "")
     3.9  
    3.10      print """\
    3.11  Status: 302 Redirect to page