Changes for page Exports

Last modified by Vincent Massol on 2024/01/05

<
From version < 44.1 >
edited by Silvia Macovei
on 2014/12/09
To version < 48.2 >
edited by Vincent Massol
on 2015/09/17
>
Change comment: More precision

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.SilviaRusu
1 +XWiki.VincentMassol
Content
... ... @@ -2,12 +2,14 @@
2 2  {{toc/}}
3 3  {{/box}}
4 4  
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 hover over the "Export" menu and select the type of export you wish to perform as you can see in the following screenshot:
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 click on "Export" in the "More actions" menu, then click "Export as PDF".
6 6  
7 -{{image reference="ExportColibri.png"/}}
7 +{{image reference="ExportFlamingo.png"/}}
8 8  
9 -// "Export" as it appears using the Colibri Skin when logged in. //
9 +{{image reference="ExportFlamingoPDF.png"/}}
10 10  
11 +// "Export" as it appears using the Flamingo Skin. //
12 +
11 11  {{warning}}
12 12  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.
13 13  {{/warning}}
... ... @@ -41,14 +41,14 @@
41 41  * ##attachments##: if set to ##1## then also export the attachments (only if they are images).
42 42  
43 43  {{info}}
44 -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]]
46 +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]]
45 45  {{/info}}
46 46  
47 47  = ODT Export =
48 48  
49 -{{image reference="exportAsODT.png"/}}
51 +{{image reference="ExportFlamingoPDF.png"/}}
50 50  
51 -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).
53 +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 modal popup (as long as you are connected to the office server).
52 52  
53 53  {{info}}
54 54  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.
... ... @@ -64,27 +64,33 @@
64 64  
65 65  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.
66 66  
67 -To export a page as a XAR use the action menu as explained above or use the following type of URL:
69 +To export a page as a XAR use the action menu as explained above or 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):
68 68  
69 69  {{code language="none"}}
70 -http://server/xwiki/bin/export/Space/Page?format=xar
72 +http://server/xwiki/bin/export/Space/Page?format=xar&pages=Space.Page
71 71  {{/code}}
72 72  
73 73  In addition the following URL parameters can be added to refine what should be exported:
74 74  
75 -* ##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##(((
76 -* ##wikiid##: the name of the wiki from where to get the wiki pages
77 +* ##pages##: there can be several such parameters, each representing a pattern of pages to export (prior to XWiki 6.3, only fixed page names could be specified, not patterns). Here is the format of an export pattern:(((
78 +wikiid:pageFullNamePattern* ##wikiid##: the name of the wiki from where to get the wiki pages
79 +
77 77  * ##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.
78 78  
79 79  Some examples:
83 +
80 80  * Exports all pages in the ##Main## wiki:(((
81 81  {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=xar&pages=Main.%25{{/code}}
82 82  )))
83 83  * Exports all pages in the current wiki:(((
84 -{{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=xar&pages=%25.%25{{/code}}
88 +{{code language="none"}}
89 +http://server/xwiki/bin/export/Space/Page?format=xar&pages=%25.%25
90 +{{/code}}
85 85  )))
86 86  * Exports the pages ##Main.WebHome## and ##Blog.WebHome##:(((
87 -{{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=xar&pages=Main.WebHome&pages=Blog.WebHome{{/code}}
93 +{{code language="none"}}
94 +http://server/xwiki/bin/export/Space/Page?format=xar&pages=Main.WebHome&pages=Blog.WebHome
95 +{{/code}}
88 88  )))
89 89  )))
90 90  * ##history##: if defined then also export the page's history. Example: ##&history=true##
... ... @@ -108,11 +108,13 @@
108 108  
109 109  * ##name##: the name of the generated Zip file.
110 110  * ##description##: the comment in the generated Zip file.
111 -* ##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##(((
112 -* ##wikiid##: the name of the wiki from where to get the wiki pages
119 +* ##pages##: there can be several such parameters, each representing a pattern of pages to export. Here is the format of an export pattern:(((
120 +wikiid:pageFullNamePattern* ##wikiid##: the name of the wiki from where to get the wiki pages
121 +
113 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.
114 114  
115 115  Some examples:
125 +
116 116  * Exports the current page from the current wiki:(((
117 117  {{code language="none"}}http://server/xwiki/bin/export/Space/Page?format=html{{/code}}
118 118  )))
ExportFlamingo.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.SilviaRusu
Size
... ... @@ -1,0 +1,1 @@
1 +11.2 KB
Content

Get Connected