Wiki source code of Exports
Version 117.1 by Thomas Mortagne on 2023/10/10
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
29.2 | 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} |
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
 |
1.1 | 4 | |
| |
116.2 | 5 | = Usage = |
| 6 | |||
 |
108.1 | 7 | As a user, you can export a single wiki page or a set of wiki pages into several formats. To perform a page export click on "Export" in the "More actions" menu. |
 |
16.1 | 8 | |
| |
108.1 | 9 | {{image reference="ExportFlamingo.png" /}} |
 |
25.1 | 10 | |
| |
108.1 | 11 | This opens the Export Modal from where you can select the export format. |
| |
16.1 | 12 | |
| |
108.1 | 13 | {{image reference="exportDialog.png" /}} |
| |
46.1 | 14 | |
| |
114.2 | 15 | The next step depends on whether the selected format supports multi-page export or not and whether the current page is [[a nested page or a terminal page>>xwiki:Documentation.UserGuide.Features.ContentOrganization.WebHome]]: |
| |
108.1 | 16 | |
| |
114.2 | 17 | * if multi-page export is supported, like in the case of XAR export, and the current page is a nested page then the Export Tree Modal is shown((( |
| |
108.1 | 18 | {{image reference="exportTreeModal.png" /}} |
| 19 | ))) | ||
| 20 | * otherwise the user is taken directly to the dedicated page for the selected export format | ||
| 21 | |||
 |
117.1 | 22 | In addition, Admins can also export all the pages of the wiki through the [[Import/Export Admin feature>>Documentation.AdminGuide.ImportExport]]. |
| |
65.2 | 23 | |
| |
116.2 | 24 | = Export Types = |
| |
1.1 | 25 | |
| |
116.2 | 26 | == ODT Export == |
| 27 | |||
| |
114.2 | 28 | 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>>extensions:Extension.Office Importer Application]] you'll notice a new entry in the Export Modal (as long as you are connected to the office server). Only single-page ODT export is supported at the moment. |
| 29 | |||
| |
90.1 | 30 | {{info}} |
| |
114.2 | 31 | 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. |
| |
90.1 | 32 | {{/info}} |
| |
34.1 | 33 | |
| |
116.2 | 34 | == PDF Export == |
| |
93.4 | 35 | |
| |
114.2 | 36 | {{version since="14.10"}} |
| 37 | Support for PDF export is provided by the [[PDF Export Application>>extensions:Extension.PDF Export Application.WebHome]] which is bundled by default in XWiki Standard. Checkout its documentation for more information. | ||
| 38 | {{/version}} | ||
| |
90.1 | 39 | |
| |
114.2 | 40 | {{version before="14.10"}} |
| 41 | On older versions of XWiki the PDF export was implemented using Apache FOP (Formatting Objects Processor). This implementation is replaced, by default, by the browser-based (client-side) PDF export provided by the PDF Export Application. You can restore the old implementation, if you want, from the PDF Export Application configuration. | ||
| 42 | |||
| 43 | The old PDF Export has a UI interface to manage the export: | ||
| 44 | |||
| |
40.1 | 45 | {{image reference="pdfExportOptions.png"/}} |
| |
34.1 | 46 | |
| |
116.3 | 47 | === Advanced === |
| |
3.1 | 48 | |
| |
116.3 | 49 | A PDF export can also be triggered by using the following type of URLs: |
| 50 | |||
| |
29.2 | 51 | {{code language="none"}} |
| 52 | http://server/xwiki/bin/export/Space/Page?format=pdf | ||
| 53 | {{/code}} | ||
| |
12.1 | 54 | |
| |
116.5 | 55 | The old PDF export (unlike the new one) doesn't provide an UI for multipage export. However it's possible to export a set of pages, using the following type of URL: |
| |
32.1 | 56 | |
 |
31.1 | 57 | {{code language="none"}} |
| |
32.1 | 58 | http://server/xwiki/bin/export/Space/Page?format=pdf&pages=Admin.Page_A&pages=Admin.Page_B&pages=Admin.Page_C... |
| |
31.1 | 59 | {{/code}} |
| 60 | |||
| |
3.1 | 61 | In addition the following URL parameters can be added to refine what should be exported: |
| |
18.1 | 62 | |
 |
40.3 | 63 | * ##pages##: there can be several such parameters, each representing a page to export. For example: ##&pages=Main.WebHome&pages=Blog.WebHome##. |
| 64 | {{info}}When ##pages## parameters are specified, the current document specified in the URL isn't used{{/info}} | ||
| |
12.3 | 65 | * ##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 | 66 | * ##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. |
| 67 | * ##pagebreaks##: if the value is set to ##1## then a page break is inserted between all exported pages. | ||
| |
12.3 | 68 | * ##comments##: if set to ##1## then also export the comments. |
| 69 | * ##attachments##: if set to ##1## then also export the attachments (only if they are images). | ||
| 70 | |||
 |
17.1 | 71 | {{info}} |
| |
65.3 | 72 | Notes: |
| |
75.1 | 73 | |
| |
117.1 | 74 | * It's also possible to [[customize how the generated PDF looks like>>Documentation.AdminGuide.Configuration#HCustomizingthePDFexportLook26Feel]]. |
| |
17.1 | 75 | {{/info}} |
| |
114.2 | 76 | {{/version}} |
| |
3.1 | 77 | |
| |
116.2 | 78 | == RTF Export == |
| |
4.2 | 79 | |
| |
114.2 | 80 | The RTF export works in the same manner as the ODT export, so it also requires an office server to be configured and connected. Similarly, only single-page RTF export is supported at the moment. |
| |
4.1 | 81 | |
| |
116.2 | 82 | == XAR Export == |
| |
1.1 | 83 | |
| |
117.1 | 84 | 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>>Documentation.AdminGuide.ImportExport]] pages and applications into/from XWiki instances. |
| |
12.3 | 85 | |
| |
114.3 | 86 | Multipage XAR export is supported, so if the current page is nested then the Export Tree Modal is shown upon selecting the XAR format. From there you can chose the child pages that you want to export along with the current page. You can filter the tree to exclude extension pages (e.g. //Created pages//, //Created and modified pages// or //All pages//). Check out the [[Administration Application>>extensions:Extension.Administration Application#HExport]] for more information about the export tree. |
| |
4.1 | 87 | |
 |
63.1 | 88 | {{info}} |
| 89 | Naturally, this tree is not displayed if the current page is terminal, which means it cannot have children. | ||
| 90 | {{/info}} | ||
| 91 | |||
 |
86.3 | 92 | Notes: |
| 93 | |||
| |
114.3 | 94 | * The "XAR" export format option will only appear if you are logged in with an admin user. |
| |
86.3 | 95 | * To import back a XAR file, you also need to be an admin user and use the [[Import section in Administration>>Documentation.AdminGuide.ImportExport]] |
| 96 | |||
| |
116.2 | 97 | === Advanced === |
| |
65.1 | 98 | |
| |
63.1 | 99 | You could also use the following type of URL (note that the ##Space/Page## part in the URL is ignored and the Export action only takes into account the ##pages## Query String parameter): |
| 100 | |||
| |
29.2 | 101 | {{code language="none"}} |
| |
48.1 | 102 | http://server/xwiki/bin/export/Space/Page?format=xar&pages=Space.Page |
| |
29.2 | 103 | {{/code}} |
| |
12.1 | 104 | |
| |
4.1 | 105 | In addition the following URL parameters can be added to refine what should be exported: |
| |
12.1 | 106 | |
| |
106.2 | 107 | * ##pages##: there can be several such parameters, each representing a pattern of pages to export. Here is the format of an export pattern:((( |
| |
49.1 | 108 | {{code language="none"}} |
| 109 | wikiid:pageFullNamePattern | ||
| 110 | {{/code}} | ||
| |
47.1 | 111 | |
| |
49.1 | 112 | * ##wikiid##: the name of the wiki from where to get the wiki pages |
| |
42.1 | 113 | * ##pageFullNamePattern##: the full name pattern of the page based on [[SQL "LIKE" comparator>>http://www.techonthenet.com/sql/like.php]]. Remember that the character {{{%}}} has to be converted in {{{%25}}} in an URL. |
| |
50.1 | 114 | ))) |
| |
106.4 | 115 | * ##excludes##: there can also be several such parameter, each representing a pattern, or list of pages associated to a ##pages## pattern. The format is the same as for pages except all special characters must be encoding in the URL. Also, as the parameter is attached to a ##pages## parameter, be careful with the order. See the examples below. |
| |
56.3 | 116 | * ##name##: the name of the exported XAR file. If not specified, a default name will be used. |
| |
50.1 | 117 | * ##history##: if defined then also export the page's history. Example: ##&history=true## |
| 118 | * ##backup##: if defined then the XWiki document author of each page remains the same as the one exported when reimporting into an XWiki instance. | ||
| 119 | * ##author##: if defined, specifies the author's name in the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| 120 | * ##description##: if defined, gives a description added to the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| 121 | * ##license##: if defined, specifies the license to the XAR export which can later be viewed when reimporting into an XWiki instance. | ||
| 122 | * ##version##: if defined, specifies the version of the export to the XAR. | ||
| |
42.1 | 123 | |
| 124 | Some examples: | ||
| |
47.1 | 125 | |
| |
49.1 | 126 | * Exports all pages in the ##Main## space:((( |
 |
89.2 | 127 | {{code language="none"}} |
| 128 | http://server/xwiki/bin/export/Space/Page?format=xar&pages=Main.%25 | ||
| 129 | {{/code}} | ||
| |
42.1 | 130 | ))) |
| 131 | * Exports all pages in the current wiki:((( | ||
| |
47.1 | 132 | {{code language="none"}} |
| 133 | http://server/xwiki/bin/export/Space/Page?format=xar&pages=%25.%25 | ||
| 134 | {{/code}} | ||
| |
42.1 | 135 | ))) |
| 136 | * Exports the pages ##Main.WebHome## and ##Blog.WebHome##:((( | ||
| |
47.1 | 137 | {{code language="none"}} |
| 138 | http://server/xwiki/bin/export/Space/Page?format=xar&pages=Main.WebHome&pages=Blog.WebHome | ||
| 139 | {{/code}} | ||
 |
86.1 | 140 | ))) |
| |
83.2 | 141 | * Exports all pages in the ##Main## space except pages under ##Main.Space1## space, and all pages under ##Other## space:((( |
| |
89.2 | 142 | {{code language="none"}} |
| 143 | http://server/xwiki/bin/export/Space/Page?format=xar&pages=Main.%25&excludes=Main.Space1.%25&pages=Other.%25 | ||
| 144 | {{/code}} | ||
| |
83.2 | 145 | ))) |
| 146 | * Exports all pages in the ##subwiki:Main## space except a page named ##subwiki:Main.Excluded&Other## and ##subwiki:Main.WebHome##:((( | ||
| 147 | {{code language="none"}} | ||
| 148 | http://server/xwiki/bin/export/Space/Page?format=xar&pages=subwiki:Main.%25&excludes=subwiki%3AMain.Excluded%26Other&subwiki%3AMain.WebHome | ||
| 149 | {{/code}} | ||
| 150 | ))) | ||
| |
85.1 | 151 | * Exports all pages in the ##Main## space and all in the ##Other## space except ##Other.Excluded## (see the empty excludes for respecting the order):((( |
| 152 | {{code language="none"}} | ||
| 153 | http://server/xwiki/bin/export/Space/Page?format=xar&pages=Main.%25&excludes=&pages=Other.%25&excludes=Other.Excluded | ||
| 154 | {{/code}} | ||
| 155 | ))) | ||
| |
4.1 | 156 | |
| |
116.2 | 157 | == HTML Export == |
| |
1.1 | 158 | |
 |
55.1 | 159 | 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. |
| 160 | |||
| |
114.3 | 161 | Multipage HTML export is supported, so if the current page is nested then the Export Tree Modal is shown upon selecting the HTML format. From there you can chose the child pages that you want to export along with the current page. You can filter the tree to exclude extension pages (e.g. //Created pages//, //Created and modified pages// or //All pages//). Check out the [[Administration Application>>extensions:Extension.Administration Application#HExport]] for more information about the export tree. |
| |
9.1 | 162 | |
| |
68.1 | 163 | The HTML export is packaged as a ZIP. Here's an example of its content and how it's organized: |
| 164 | |||
| 165 | {{image reference="htmlexport-content.png"/}} | ||
| 166 | |||
| 167 | A basic index page is also generated and provides a list (and links) of all pages that have been exported. For example: | ||
| 168 | |||
| 169 | {{image reference="htmlexport-index.png"/}} | ||
| 170 | |||
| |
116.2 | 171 | === Advanced === |
| |
64.1 | 172 | |
| 173 | You could also use the following type of URL: | ||
| 174 | |||
| |
29.2 | 175 | {{code language="none"}} |
| 176 | http://server/xwiki/bin/export/Space/Page?format=html | ||
| 177 | {{/code}} | ||
| |
12.1 | 178 | |
| |
5.1 | 179 | In addition the following URL parameters can be added to refine what should be exported: |
| |
12.1 | 180 | |
| |
12.6 | 181 | * ##name##: the name of the generated Zip file. |
| 182 | * ##description##: the comment in the generated Zip file. | ||
| |
48.1 | 183 | * ##pages##: there can be several such parameters, each representing a pattern of pages to export. Here is the format of an export pattern:((( |
| |
49.1 | 184 | {{code language="none"}} |
| 185 | wikiid:pageFullNamePattern | ||
| 186 | {{/code}} | ||
| |
48.1 | 187 | |
| |
49.1 | 188 | * ##wikiid##: the name of the wiki from where to get the wiki pages |
| |
42.1 | 189 | * ##pageFullNamePattern##: the full name pattern of the page based on [[SQL "LIKE" comparator>>http://www.techonthenet.com/sql/like.php]]. Remember that the character {{{%}}} has to be converted in {{{%25}}} in an URL. |
| |
50.1 | 190 | ))) |
| |
106.6 | 191 | * ##excludes##: there can also be several such parameter, each representing a pattern, or list of pages associated to a ##pages## pattern. The format is the same as for pages except all special characters must be encoding in the URL. Also, as the parameter is attached to a ##pages## parameter, be careful with the order. See the examples below. |
| |
12.3 | 192 | |
| |
42.1 | 193 | Some examples: |
| |
47.1 | 194 | |
| |
29.2 | 195 | * Exports the current page from the current wiki:((( |
| |
89.2 | 196 | {{code language="none"}} |
| 197 | http://server/xwiki/bin/export/Space/Page?format=html | ||
| 198 | {{/code}} | ||
| |
18.2 | 199 | ))) |
| |
29.2 | 200 | * Exports the current page from the current wiki in ##packagename.zip##:((( |
| 201 | {{code language="none"}} | ||
| 202 | http://server/xwiki/bin/export/Space/Page?format=html&name=packagename | ||
| 203 | {{/code}} | ||
| |
18.2 | 204 | ))) |
| |
29.2 | 205 | * Exports all the pages from the ##Space## space as well as the ##Space2.Page## page from the current wiki:((( |
| |
89.2 | 206 | {{code language="none"}} |
| 207 | http://server/xwiki/bin/export/Space/Page?format=html&pages=Space.%25&pages=Space2.Page | ||
| 208 | {{/code}} | ||
| |
18.2 | 209 | ))) |
| |
29.2 | 210 | * Exports all the pages from the ##Space## space located in the ##wiki2## subwiki:((( |
| 211 | {{code language="none"}} | ||
| 212 | http://server/xwiki/bin/export/Space/Page?format=html&pages=wiki2:Space.%25 | ||
| 213 | {{/code}} | ||
| |
18.2 | 214 | ))) |
| |
86.1 | 215 | * Exports all pages in the ##Main## space except pages under ##Main.Space1## space, and all pages under ##Other## space:((( |
| |
89.2 | 216 | {{code language="none"}} |
| 217 | http://server/xwiki/bin/export/Space/Page?format=html&pages=Main.%25&excludes=Main.Space1.%25&pages=Other.%25 | ||
| 218 | {{/code}} | ||
| |
86.1 | 219 | ))) |
| 220 | * Exports all pages in the ##subwiki:Main## space except a page named ##subwiki:Main.Excluded&Other## and ##subwiki:Main.WebHome##:((( | ||
| 221 | {{code language="none"}} | ||
| 222 | http://server/xwiki/bin/export/Space/Page?format=html&pages=subwiki:Main.%25&excludes=subwiki%3AMain.Excluded%26Other&subwiki%3AMain.WebHome | ||
| 223 | {{/code}} | ||
| 224 | ))) | ||
| 225 | * Exports all pages in the ##Main## space and all in the ##Other## space except ##Other.Excluded## (see the empty excludes for respecting the order):((( | ||
| 226 | {{code language="none"}} | ||
| 227 | http://server/xwiki/bin/export/Space/Page?format=html&pages=Main.%25&excludes=&pages=Other.%25&excludes=Other.Excluded | ||
| 228 | {{/code}} | ||
| 229 | ))) |
