Changes for page Standard URL Format

Last modified by Anca Luca on 2023/11/10

<
From version < 50.3 >
edited by Manuel Smeria
on 2013/01/16
To version < 51.1 >
edited by Vincent Massol
on 2013/03/11
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ManuelSmeria
1 +XWiki.VincentMassol
Content
... ... @@ -32,13 +32,13 @@
32 32  
33 33  It can be:
34 34  
35 -* /bin/: this calls the Struts servlet which will call the right action for the following part of the URL
36 -* /wiki/[wikialias]: calls the same servlet but will be used to determine the subwiki to access if ##xwiki.virtiual.usepath## is enabled in ##xwiki.cfg##. Note that you can change the "wiki" part with anything else using ##xwiki.virtual.usepath.servletpath## and by modifying web.xml to reflect the new Struts action name (see [[the URL path based wiki access>>platform:AdminGuide.AccessWiki#HTheURLpathbasedwikiaccess]] for more details)
37 -* /xmlrpc/: call xmlrpc servlet (see [[platform:Features.XMLRPC]] for more details)
38 -* /webdav/: call webdav servlet (see [[Web DAV>>platform:Features.WebDAV]] for more details)
39 -* /rest/: call REST servlet (see [[XWiki RESTful API>>platform:Features.XWikiRESTfulAPI]] for more details)
35 +* ##/bin/##: this calls the Struts servlet which will call the right action for the following part of the URL
36 +* ##/wiki/[wikialias]##: calls the same servlet but will be used to determine the subwiki to access if ##xwiki.virtual.usepath## is enabled in ##xwiki.cfg##. Note that you can change the "wiki" part with anything else using ##xwiki.virtual.usepath.servletpath## and by modifying web.xml to reflect the new Struts action name (see [[the URL path based wiki access>>platform:AdminGuide.AccessWiki#HTheURLpathbasedwikiaccess]] for more details)
37 +* ##/xmlrpc/##: call xmlrpc servlet (see [[platform:Features.XMLRPC]] for more details)
38 +* ##/webdav/##: call webdav servlet (see [[Web DAV>>platform:Features.WebDAV]] for more details)
39 +* ##/rest/##: call REST servlet (see [[XWiki RESTful API>>platform:Features.XWikiRESTfulAPI]] for more details)
40 40  
41 -= Struts action (OPTIONAL) =
41 += Action (OPTIONAL) =
42 42  
43 43  See the [[struts action name>>platform:Main.ShortURLs#HIII.Strutsactionname]] section for more details on how to remove this part of the url.
44 44  
... ... @@ -56,41 +56,48 @@
56 56  
57 57  The page contains wiki contents, objects/classes and attachments.
58 58  
59 -If no page is specified like in the url ##http://host/xwiki/bin/view/Space/ ## the "WebHome" page name is used.
59 +When no page is specified like in the url ##http:~//host/xwiki/bin/view/Space/ ## the "WebHome" page name is used.
60 60  
61 -= Attachment =
61 += Attachment (OPTIONAL) =
62 62  
63 63  This part indicates the attachment you want to download from a particular page.
64 64  
65 65  See [[platform:Features.Attachments]] for more details about attachments.
66 66  
67 -= Query string =
67 += Query string (OPTIONAL) =
68 68  
69 69  == Standard parameters ==
70 70  
71 -Some of the parameters in the URL have a "system" meaning depending of the context.
71 +Some of the parameters in the URL have a "system" meaning depending of the action.
72 72  
73 -=== view mode ===
73 +=== ##view## Action ===
74 74  
75 75  ==== xpage ====
76 76  
77 -* ##plain##: this value indicates that only the content of the page is printed (no UI). With a document that's not using the 1.0 syntax you can control the output syntax using ##outputSyntax## and ##outputSyntaxVersion##. You can also pass another parameter named ##raw## which allows you more control:
77 +* ##plain##: this value indicates that only the content of the page is printed (no UI). With a document that's not using the XWiki 1.0 syntax you can control the output syntax using ##outputSyntax## and ##outputSyntaxVersion##. You can also pass another parameter named ##raw## which allows you more control:
78 78  ** ##raw=1##: Returns the page source as is without any formatting but XML-escaped
79 79  ** ##raw=2##: Returns the page source as is without any formatting (without any escaping)
80 80  * ##xml##: print the exported form of a document. This is what you can find in the xar for each document.
81 +* ##rev##: when specified, redirects to the ##viewrev## action (see below)
81 81  
82 82  ==== outputSyntax and outputSyntaxVersion ====
83 83  
84 -With a document that's not using the 1.0 syntax it's possible to explicitly indicate the renderer to use for the page content. For example with ##outputSyntax=plain## you will get the result in plain text. ##outputSyntaxVersion## is an optional parameter, if it's not provided XWiki will search for the last version of the renderer for the given ##outputSyntax## syntax name. Note that outputSyntax controls only the document content output syntax. If you only want the document content you can use ##xpage=plain##.
85 +With a document that's not using the XWiki 1.0 syntax it's possible to explicitly indicate the renderer to use for the page content. For example with ##outputSyntax=plain## you will get the result in plain text. ##outputSyntaxVersion## is an optional parameter, if it's not provided XWiki will search for the last version of the renderer for the given ##outputSyntax## syntax name. Note that outputSyntax controls only the document content output syntax. If you only want the document content you can use ##xpage=plain##.
85 85  
86 86  See [[extensions:Extension.Rendering Module]] for more details on renderers.
87 87  
88 -=== export mode ===
89 +=== ##export## Action ===
89 89  
90 90  See [[platform:Features.Exports]].
91 91  
92 -== Generic ==
93 +=== ##viewrev## Action ===
93 93  
95 +This action is the same as the ##view## action but allowing to address a given revision of the document asked.
96 +
97 +* ##rev##: the version to get, e.g. ##2.3## in ##http:~//host/xwiki/bin/view/MySpace/MyPage?rev=2.3##
98 +
99 +== Custom parameters ==
100 +
94 94  Actions can use URL parameters to modify their action depending on their value.
95 95  
96 96  For example you can make a velocity script that prints the content of this value with:

Get Connected