# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1383330641 -3600
# Node ID cfb5c203b6f4d9b49a49280fd0c0bd0010837421
# Parent  df5d43ec612facbd2c1718a881d29c16efbccb3e
Added details of the ExportPDF action.

diff -r df5d43ec612f -r cfb5c203b6f4 README.txt
--- a/README.txt	Fri Nov 01 19:30:16 2013 +0100
+++ b/README.txt	Fri Nov 01 19:30:41 2013 +0100
@@ -67,6 +67,33 @@
 python moinsetup.py -m edit_theme_stylesheet screen.css includecomments.css
 python moinsetup.py -m edit_theme_stylesheet print.css includecomments.css
 
+Additional Software
+-------------------
+
+PDF export support requires the ExportPDF action:
+
+http://moinmo.in/ActionMarket/ExportPDF
+
+This in turn requires Apache FOP for PDF production using XSL-FO:
+
+http://xmlgraphics.apache.org/fop/
+
+(On Debian systems, the fop package provides this tool.)
+
+To produce XSL-FO from DocBook output, xsltproc is required from the libxslt
+distribution:
+
+http://xmlsoft.org/XSLT/
+
+(On Debian systems, the xsltproc package provides this tool.)
+
+And DocBook output requires the DocBook resources to be installed, described
+in the following guide:
+
+http://www.sagehill.net/docbookxsl/ToolsSetup.html
+
+(On Debian systems, the docbook-xsl package provides these resources.)
+
 Quick Start
 -----------
 
@@ -161,17 +188,23 @@
 sense. To support this, the following resources are involved:
 
   * scripts/dashboard.py
+  * scripts/redirect.py
   * scripts/search.py
   * config/mailmanwiki-redirect
 
 The latter configuration file is also involved in identifier-to-page mapping,
-but in this case it causes requests to the "dashboard" and "dosearchsite"
-actions to be directed to the dashboard.py and search.py scripts respectively.
+but in this case it causes requests to the "dashboard", "doexportpage" and
+"dosearchsite" actions to be directed to the dashboard.py, redirect.py and
+search.py scripts respectively.
 
 The dashboard.py script merely redirects requests to the root of the site,
 thus assuming that the front page is configured to show dashboard-like
 information.
 
+The redirect.py script, apart from supporting identifier-to-page redirects,
+also supports PDF page exports since the "doexportpage" action uses
+identifiers to indicate which page is to be exported.
+
 The search.py script redirects search requests in a suitable form to the
 MoinMoin "fullsearch" action.
 
diff -r df5d43ec612f -r cfb5c203b6f4 TO_DO.txt
--- a/TO_DO.txt	Fri Nov 01 19:30:16 2013 +0100
+++ b/TO_DO.txt	Fri Nov 01 19:30:41 2013 +0100
@@ -58,7 +58,7 @@
 
   http://wiki.list.org/pages/doexportpage.action?pageId=786442&type=TYPE_PDF
 
-  ...can be supported using the RenderAsPDF action)
+  ...can be supported using the ExportPDF action)
 
   (Note that viewpage actions like the following...
 
diff -r df5d43ec612f -r cfb5c203b6f4 scripts/redirect.py
--- a/scripts/redirect.py	Fri Nov 01 19:30:16 2013 +0100
+++ b/scripts/redirect.py	Fri Nov 01 19:30:41 2013 +0100
@@ -46,7 +46,7 @@
     sys.exit(0)
 
 def redirect(pagename, export=False):
-    location = "%s/%s%s" % (URL_PREFIX, quote(pagename), export and "?action=RenderAsPDF" or "")
+    location = "%s/%s%s" % (URL_PREFIX, quote(pagename), export and "?action=ExportPDF" or "")
 
     print """\
 Status: 302 Redirect to page