Wiki source code of Exports
Version 38.2 by Silvia Macovei on 2012/03/06
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
29.2 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
 |
1.1 | 4 | |
 |
16.1 | 5 | 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: |
| 6 | |||
| |
29.2 | 7 | [[image:ExportToucan.png]] |
| |
16.1 | 8 | // "Print" as it appears using the Toucan Skin // |
| |
1.1 | 9 | |
| |
16.2 | 10 | 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: |
| |
16.1 | 11 | |
| |
38.2 | 12 | [[image:ExportColibri.png||style="border: 1px solid silver;"]] |
 |
25.1 | 13 | |
| |
24.1 | 14 | // "Export" as it appears using the Colibri Skin when logged in // |
| |
16.1 | 15 | |
| |
29.2 | 16 | {{warning}} |
| 17 | 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. | ||
| 18 | {{/warning}} | ||
| |
3.1 | 19 | |
| |
18.2 | 20 | = PDF Export = |
| |
1.1 | 21 | |
| |
34.1 | 22 | Since XWiki Enterprise 3.1, PDF Export has also an UI interface to manage the PDF Export |
| 23 | |||
| |
38.2 | 24 | [[image:pdfExportOptions.png||style="border: 1px solid silver;"]] |
| |
34.1 | 25 | |
| |
12.1 | 26 | To export a page as PDF use the action menu as explained above or use the following type of URL: |
| |
3.1 | 27 | |
| |
29.2 | 28 | {{code language="none"}} |
| 29 | http://server/xwiki/bin/export/Space/Page?format=pdf | ||
| 30 | {{/code}} | ||
| |
12.1 | 31 | |
| |
32.1 | 32 | To export several pages as PDF use the following type of URL (see the ##pages## parameter below): |
| 33 | |||
 |
31.1 | 34 | {{code language="none"}} |
| |
32.1 | 35 | http://server/xwiki/bin/export/Space/Page?format=pdf&pages=Admin.Page_A&pages=Admin.Page_B&pages=Admin.Page_C... |
| |
31.1 | 36 | {{/code}} |
| 37 | |||
| |
3.1 | 38 | In addition the following URL parameters can be added to refine what should be exported: |
 |
18.1 | 39 | |
| |
32.1 | 40 | * ##pages##: there can be several such parameters, each representing a page to export. For example: ##&pages=Main.WebHome&pages=Blog.WebHome##. {{info}}When ##pages## parameters are specified, the current document specified in the URL isn't used{{/info}} |
| |
12.3 | 41 | * ##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. |
| |
12.7 | 42 | * ##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. |
| 43 | * ##pagebreaks##: if the value is set to ##1## then a page break is inserted between all exported pages. | ||
| |
12.3 | 44 | * ##comments##: if set to ##1## then also export the comments. |
| 45 | * ##attachments##: if set to ##1## then also export the attachments (only if they are images). | ||
| 46 | |||
 |
17.1 | 47 | {{info}} |
| |
37.5 | 48 | It's also possible to [[customize how the generated PDF looks like>>platform:AdminGuide.Configuration#HCustomizingthePDFexportLook26Feel]].There's a panel that provides [[an UI for PDF Export options.>>extensions:Extension.PDF Export Panel Application]] |
| |
17.1 | 49 | {{/info}} |
| |
3.1 | 50 | |
| |
35.2 | 51 | = ODT Export = |
| 52 | |||
| |
38.2 | 53 | [[image:exportAsODT.png||style="border: 1px solid silver;"]] |
| |
35.2 | 54 | |
| 55 | If you configure your wiki to work with an office server ([[LibreOffice>>http://www.libreoffice.org/]] or [[OpenOffice>>http://www.openoffice.org/]]) as described in the [[Office Importer Application>>http://extensions.xwiki.org/xwiki/bin/view/Extension/Office+Importer+Application]] you'll notice a new entry in the export menu (as long as you are connected to the office server). By default only the ODT ([[OpenDocument>>http://opendocument.xml.org/]] Text format) export is exposed but you can tweak the export URL to export to other office formats supported by your office server. For instance ##/xwiki/bin/export/Sandbox/WebHome?format=doc## exports Sandbox.WebHome page to Microsoft Word's proprietary DOC format. | ||
| 56 | |||
| |
18.2 | 57 | = RTF Export = |
| |
4.2 | 58 | |
| |
4.1 | 59 | The RTF export works exactly in the same manner as the PDF export. |
| 60 | |||
| |
18.2 | 61 | = XAR Export = |
| |
1.1 | 62 | |
| |
14.1 | 63 | 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. |
| |
12.3 | 64 | |
| |
4.1 | 65 | To export a page as a XAR use the action menu as explained above or use the following type of URL: |
| 66 | |||
| |
29.2 | 67 | {{code language="none"}} |
| 68 | http://server/xwiki/bin/export/Space/Page?format=xar | ||
| 69 | {{/code}} | ||
| |
12.1 | 70 | |
| |
4.1 | 71 | In addition the following URL parameters can be added to refine what should be exported: |
| |
12.1 | 72 | |
| |
12.6 | 73 | * ##pages##: there can be several such parameters, each representing a page to export. For example: ##&pages=Main.WebHome&pages=Blog.WebHome##. |
| 74 | * ##history##: if defined then also export the page's history. Example: ##&history=true## | ||
| |
12.8 | 75 | * ##backup##: if defined then the XWiki document author of each page remains the same as the one exported when reimporting into an XWiki instance. |
| 76 | * ##author##: if defined, specifies the author's name in the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| 77 | * ##description##: if defined, gives a description added to the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| 78 | * ##license##: if defined, specifies the license to the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| |
12.6 | 79 | * ##version##: if defined, specifies the version of the export to the XAR. |
| |
4.1 | 80 | |
| |
18.2 | 81 | = HTML Export = |
| |
1.1 | 82 | |
| |
10.2 | 83 | 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. |
| |
12.3 | 84 | |
| |
10.1 | 85 | To export a page as HTML use the action menu as explained above or use the following type of URL: |
| |
9.1 | 86 | |
| |
29.2 | 87 | {{code language="none"}} |
| 88 | http://server/xwiki/bin/export/Space/Page?format=html | ||
| 89 | {{/code}} | ||
| |
12.1 | 90 | |
| |
5.1 | 91 | In addition the following URL parameters can be added to refine what should be exported: |
| |
12.1 | 92 | |
| |
12.6 | 93 | * ##name##: the name of the generated Zip file. |
| 94 | * ##description##: the comment in the generated Zip file. | ||
| |
18.1 | 95 | * ##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## |
| 96 | ** ##wikiid##: the name of the wiki from where to get the wiki pages | ||
| 97 | ** ##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. | ||
| |
12.3 | 98 | |
| |
5.1 | 99 | Some examples : |
| 100 | |||
| |
29.2 | 101 | * Exports the current page from the current wiki:((( |
| |
12.1 | 102 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html{{/code}} |
| |
18.2 | 103 | ))) |
| |
29.2 | 104 | * Exports the current page from the current wiki in ##packagename.zip##:((( |
| 105 | {{code language="none"}} | ||
| 106 | http://server/xwiki/bin/export/Space/Page?format=html&name=packagename | ||
| 107 | {{/code}} | ||
| |
18.2 | 108 | ))) |
| |
29.2 | 109 | * Exports all the pages from the ##Space## space as well as the ##Space2.Page## page from the current wiki:((( |
| |
12.1 | 110 | {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html&pages=Space.%25&pages=Space2.Page{{/code}} |
| |
18.2 | 111 | ))) |
| |
29.2 | 112 | * Exports all the pages from the ##Space## space located in the ##wiki2## subwiki:((( |
| 113 | {{code language="none"}} | ||
| 114 | http://server/xwiki/bin/export/Space/Page?format=html&pages=wiki2:Space.%25 | ||
| 115 | {{/code}} | ||
| |
18.2 | 116 | ))) |
