Changes for page Exports

Last modified by Vincent Massol on 2024/01/05

<
From version < 16.2 >
edited by Silvia Macovei
on 2009/10/15
To version < 18.2 >
edited by Silvia Macovei
on 2010/02/24
>
Change comment: Fixed Title; Changed TOC; Aligned Code

Summary

Details

Page properties
Title
... ... @@ -1,0 +1,1 @@
1 +Exports
Content
... ... @@ -1,12 +1,5 @@
1 +{{box cssClass="floatinginfobox" title="**Contents**"}}{{toc/}}{{/box}}
1 1  
2 -(% class="floatinginfobox" %)(((
3 -**Contents**
4 -
5 -{{toc start=2 depth=3 numbered=false scope=page /}}
6 -)))
7 -
8 -= Exports =
9 -
10 10  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:
11 11  
12 12  image:export.png
... ... @@ -19,7 +19,7 @@
19 19  
20 20  {{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}}
21 21  
22 -== PDF Export ==
15 += PDF Export =
23 23  
24 24  To export a page as PDF use the action menu as explained above or use the following type of URL:
25 25  
... ... @@ -26,6 +26,7 @@
26 26  {{code language="none"}}http://server/xwiki/bin/export/Spave/Page?format=pdf{{/code}}
27 27  
28 28  In addition the following URL parameters can be added to refine what should be exported:
22 +
29 29  * ##pages##: there can be several such parameters, each representing a page to export. For example: ##&pages=Main.WebHome&pages=Blog.WebHome##.
30 30  * ##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.
31 31  * ##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.
... ... @@ -33,13 +33,16 @@
33 33  * ##comments##: if set to ##1## then also export the comments.
34 34  * ##attachments##: if set to ##1## then also export the attachments (only if they are images).
35 35  
36 -{{info}}It's also possible to [[customize how the generated PDF looks like>>platform:AdminGuide.Configuration#HCustomizingthePDFexportLook26Feel]].{{/info}}
30 +{{info}}
31 +It's also possible to [[customize how the generated PDF looks like>>platform:AdminGuide.Configuration#HCustomizingthePDFexportLook26Feel]].
32 +There's a panel that provides [[an UI for PDF Export options.>>code:Applications.PDFExportPanelApplication]]
33 +{{/info}}
37 37  
38 -== RTF Export ==
35 += RTF Export =
39 39  
40 40  The RTF export works exactly in the same manner as the PDF export.
41 41  
42 -== XAR Export ==
39 += XAR Export =
43 43  
44 44  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.
45 45  
... ... @@ -57,7 +57,7 @@
57 57  * ##license##: if defined, specifies the license to the XAR export which can later be viewed when reimporting into an XWiki instance.
58 58  * ##version##: if defined, specifies the version of the export to the XAR.
59 59  
60 -== HTML Export ==
57 += HTML Export =
61 61  
62 62  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.
63 63  
... ... @@ -69,28 +69,25 @@
69 69  
70 70  * ##name##: the name of the generated Zip file.
71 71  * ##description##: the comment in the generated Zip file.
72 -* ##pages##: there can be several such parameters, each representing a pattern of pages to export. Here is the format of an export pattern: ##wikinamepattern:pageFullNamePattern##
73 - ** ##wikinamepattern##: the name of the wiki based on [[Java regular expressions>>http://java.sun.com/j2se/1.5.0/docs/api/java/util/regex/Pattern.html#construct]]
74 - ** ##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.
69 +* ##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##
70 +** ##wikiid##: the name of the wiki from where to get the wiki pages
71 +** ##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.
75 75  
76 76  Some examples :
77 77  
78 78  * Exports the current page from the current wiki:
79 -
76 +(((
80 80  {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html{{/code}}
81 -
78 +)))
82 82  * Exports the current page from the current wiki in ##packagename.zip##:
83 -
80 +(((
84 84  {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html&name=packagename{{/code}}
85 -
82 +)))
86 86  * Exports all the pages from the ##Space## space as well as the ##Space2.Page## page from the current wiki:
87 -
84 +(((
88 88  {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html&pages=Space.%25&pages=Space2.Page{{/code}}
89 -
86 +)))
90 90  * Exports all the pages from the ##Space## space located in the ##wiki2## subwiki:
91 -
88 +(((
92 92  {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html&pages=wiki2:Space.%25{{/code}}
93 -
94 -* Exports all the pages from all wikis/subwikis:
95 -
96 -{{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html&pages=.*:%25{{/code}}
90 +)))

Get Connected