Wiki source code of Exports
Version 27.3 by Silvia Macovei on 2010/12/15
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}}{{toc/}}{{/box}} | ||
| 2 | |||
| 3 | XWiki offers the ability to export a single wiki page or a set of wiki pages into several formats. To perform a page export simply go to the page, select the "Print" menu (in the Albatross/Toucan skins) and select the type of export you wish to perform as shown in the following screenshot: | ||
| 4 | |||
| 5 | [[image:ToucanExportScreen.png||style="border:1px solid black;]] | ||
| 6 | // "Print" as it appears using the Toucan Skin // | ||
| 7 | |||
| 8 | If you are using the Colibri skin to perform a page export go to the page, hover over the "Export" menu and select the type of export you wish to perform as you can see in the following screenshot: | ||
| 9 | |||
| 10 | |||
| 11 | [[image:ColibriExportScreen.png||style="border:1px solid black;]] | ||
| 12 | // "Export" as it appears using the Colibri Skin when logged in // | ||
| 13 | |||
| 14 | {{warning}}Right now we don't have any user interface for exporting a set of wiki pages. This is a [[work in progress>>http://jira.xwiki.org/jira/browse/XWIKI-1289]]. However it's possible to export a set of pages by following the instructions below for each export format.{{/warning}} | ||
| 15 | |||
| 16 | = PDF Export = | ||
| 17 | |||
| 18 | To export a page as PDF use the action menu as explained above or use the following type of URL: | ||
| 19 | |||
| 20 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=pdf{{/code}} | ||
| 21 | |||
| 22 | In addition the following URL parameters can be added to refine what should be exported: | ||
| 23 | |||
| 24 | * ##pages##: there can be several such parameters, each representing a page to export. For example: ##&pages=Main.WebHome&pages=Blog.WebHome##. | ||
| 25 | * ##includechilds##: the value is a number specifying the depth of children pages to include in the PDF export. For example ##&includechilds=2## will include all children pages of the page to export, all its children (i.e. pages which have the page as its parent) and all the children's children. | ||
| 26 | * ##includelinks##: the value is a number specifying the depth of linked pages to include in the PDF export. For example ##&includelinks=2## will include all pages linked from the page to export and the links in the linked pages. | ||
| 27 | * ##pagebreaks##: if the value is set to ##1## then a page break is inserted between all exported pages. | ||
| 28 | * ##comments##: if set to ##1## then also export the comments. | ||
| 29 | * ##attachments##: if set to ##1## then also export the attachments (only if they are images). | ||
| 30 | |||
| 31 | {{info}} | ||
| 32 | It's also possible to [[customize how the generated PDF looks like>>platform:AdminGuide.Configuration#HCustomizingthePDFexportLook26Feel]]. | ||
| 33 | There's a panel that provides [[an UI for PDF Export options.>>extensions:Extension.PDF Export Panel Application]] | ||
| 34 | {{/info}} | ||
| 35 | |||
| 36 | = RTF Export = | ||
| 37 | |||
| 38 | The RTF export works exactly in the same manner as the PDF export. | ||
| 39 | |||
| 40 | = XAR Export = | ||
| 41 | |||
| 42 | The XAR export allows exporting pages in the internal XML format used by XWiki. This is the format that you can use to [[Import/Export>>platform:AdminGuide.ImportExport]] pages and applications into/from XWiki instances. | ||
| 43 | |||
| 44 | To export a page as a XAR use the action menu as explained above or use the following type of URL: | ||
| 45 | |||
| 46 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=xar{{/code}} | ||
| 47 | |||
| 48 | In addition the following URL parameters can be added to refine what should be exported: | ||
| 49 | |||
| 50 | * ##pages##: there can be several such parameters, each representing a page to export. For example: ##&pages=Main.WebHome&pages=Blog.WebHome##. | ||
| 51 | * ##history##: if defined then also export the page's history. Example: ##&history=true## | ||
| 52 | * ##backup##: if defined then the XWiki document author of each page remains the same as the one exported when reimporting into an XWiki instance. | ||
| 53 | * ##author##: if defined, specifies the author's name in the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| 54 | * ##description##: if defined, gives a description added to the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| 55 | * ##license##: if defined, specifies the license to the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| 56 | * ##version##: if defined, specifies the version of the export to the XAR. | ||
| 57 | |||
| 58 | = HTML Export = | ||
| 59 | |||
| 60 | The HTML export allows exporting wiki pages as static HTML pages independent from the XWiki engine. All pages are exported in view mode. That way you can export a whole space containing documentation and access it on your computer without any web server. The export is done with the current skin. | ||
| 61 | |||
| 62 | To export a page as HTML use the action menu as explained above or use the following type of URL: | ||
| 63 | |||
| 64 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html{{/code}} | ||
| 65 | |||
| 66 | In addition the following URL parameters can be added to refine what should be exported: | ||
| 67 | |||
| 68 | * ##name##: the name of the generated Zip file. | ||
| 69 | * ##description##: the comment in the generated Zip file. | ||
| 70 | * ##pages##: there can be several such parameters, each representing a pattern of pages to export. Here is the format of an export pattern: ##wikiid:pageFullNamePattern## | ||
| 71 | ** ##wikiid##: the name of the wiki from where to get the wiki pages | ||
| 72 | ** ##pageFullNamePatern##: the full name pattern of the page based on [[HQL "LIKE" comparator>>http://www.techonthenet.com/sql/like.php]]. Remember that the character % has to be converted in %25 in an URL. | ||
| 73 | |||
| 74 | Some examples : | ||
| 75 | |||
| 76 | * Exports the current page from the current wiki: | ||
| 77 | ((( | ||
| 78 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html{{/code}} | ||
| 79 | ))) | ||
| 80 | * Exports the current page from the current wiki in ##packagename.zip##: | ||
| 81 | ((( | ||
| 82 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html&name=packagename{{/code}} | ||
| 83 | ))) | ||
| 84 | * Exports all the pages from the ##Space## space as well as the ##Space2.Page## page from the current wiki: | ||
| 85 | ((( | ||
| 86 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html&pages=Space.%25&pages=Space2.Page{{/code}} | ||
| 87 | ))) | ||
| 88 | * Exports all the pages from the ##Space## space located in the ##wiki2## subwiki: | ||
| 89 | ((( | ||
| 90 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html&pages=wiki2:Space.%25{{/code}} | ||
| 91 | ))) |
