<
From version < 50.1 >
edited by Vincent Massol
on 2012/12/04
To version < 50.2 >
edited by Manuel Smeria
on 2013/01/16
>
Change comment: minor fixes

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.VincentMassol
1 +XWiki.ManuelSmeria
Content
... ... @@ -1,52 +1,54 @@
1 -{{box cssClass="floatinginfobox" title="**Contents**"}}{{toc/}}{{/box}}
1 +{{box cssClass="floatinginfobox" title="**Contents**"}}
2 +{{toc/}}
3 +{{/box}}
2 2  
3 3  In a single instance of XWiki you have many sections and the URLs need to reflect all that. This documentation details the way URLs are parsed by XWiki and what each part of it means.
4 4  
5 -[[[[image:url.png||style="border:1px solid silver; padding:1px; display:block; width: 900px"]]>>attach:url.png]]
7 +{{image reference="url.png"/}}
6 6  
7 7  = Protocol =
8 8  
9 9  By default "http" is used when generating an url in XWiki.
10 10  
11 -In virtual mode, you can set "secure" parameter to true in a wiki descriptor to generate urls with "https" instead of "http". See [[How to edit wiki descriptor>>manager:AdminGuide.EditWikiDescriptor]].
13 +In virtual mode, you can set the "secure" parameter to true in a wiki descriptor to generate URLs with "https" instead of "http". See [[how to modify the wiki descriptor>>manager:AdminGuide.EditWikiDescriptor]].
12 12  
13 13  = Host =
14 14  
15 -In virtual mode it is used to determine the wiki to access. See [[Access Wiki>>manager:AdminGuide.AccessWiki#HThedomainnamebasedwikiaccess]] for more details.
17 +In virtual mode it is used to determine the wiki to access. See [[the domain name based wiki access>>platform:AdminGuide.AccessWiki#HThedomainnamebasedwikiaccess]] for more details.
16 16  
17 17  In non-virtual mode is has no effect.
18 18  
19 19  = Application context (OPTIONAL) =
20 20  
21 -See [[Short URLs>>platform:Main.ShortURLs#HApplicationname]] for more details on how to remove this part of the url.
23 +See [[Short URLs>>platform:Main.ShortURLs#HI.Applicationname]] for more details on how to remove this part of the url.
22 22  
23 23  It's what the web container (jetty, tomcat, glassfish, etc.) use to find XWiki in all the web applications it contains. Removing it mainly depends on the possibilities and configuration of your web container.
24 24  
25 25  = Servlet mapping name (OPTIONAL) =
26 26  
27 -See [[Short URLs>>platform:Main.ShortURLs#HServletmappingname]] for more details on how to remove this part of the url.
29 +See [[Short URLs>>platform:Main.ShortURLs#HII.Servletmappingname]] for more details on how to remove this part of the url.
28 28  
29 29  This is used by the container to call the right servlet.
30 30  
31 31  It can be:
32 32  
33 -* /bin/: this calls the Struts servlet which will call the right action for the following part of the URL.
34 -* /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 [[Access Wiki>>manager:AdminGuide.AccessWiki#HTheURLpatchbasedwikiaccess]] for more details.
35 -* /xmlrpc/: call xmlrpc servlet. See [[platform:Features.XMLRPC]] for more details.
36 -* /webdav/: call webdav servlet. See [[Web DAV>>platform:Features.WebDAV]] for more details.
37 -* /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.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)
38 38  
39 39  = Struts action (OPTIONAL) =
40 40  
41 -See [[Short URLs>>platform:Main.ShortURLs#HStrutsactionname]] for more details on how to remove this part of the url.
43 +See the [[struts action name>>platform:Main.ShortURLs#HIII.Strutsactionname]] section for more details on how to remove this part of the url.
42 42  
43 -When the servlet mapping name is ##bin## or the value of ##xwiki.virtual.usepath.servletpath##, XWikis use "action" identifiers to determine what the goal of the user when going to a page is.
45 +When the servlet mapping name is ##bin## or the value of ##xwiki.virtual.usepath.servletpath## XWiki uses "action" identifiers to determine what the goal of the user when going to a page is.
44 44  
45 -For example if the action is "edit", XWiki will print the editor the user used to modify a page content but if the "view" action is used, XWiki will execute the page content to print/render the content.
47 +For example if the action is "edit" XWiki will print the editor the user used to modify the page content but if the "view" action is used, XWiki will execute the page content to print/render the content.
46 46  
47 47  = Space =
48 48  
49 -Any wiki pages is located in what is called a "space".
51 +Any wiki page is located in what is called a "space".
50 50  
51 51  See [[platform:Features.Spaces]] for more details about spaces.
52 52  
... ... @@ -72,17 +72,16 @@
72 72  
73 73  ==== xpage ====
74 74  
75 -* ##plain##: this value indicates that only the content of the page is printed (no UI). With document not in 1.0 syntax you can control the output syntax using ##outputSyntax## and ##outputSyntaxVersion##. You can also pass another parameter named ##raw## which allow 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 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:
76 76  ** ##raw=1##: Returns the page source as is without any formatting but XML-escaped
77 77  ** ##raw=2##: Returns the page source as is without any formatting (without any escaping)
78 78  * ##xml##: print the exported form of a document. This is what you can find in the xar for each document.
79 79  
80 -
81 81  ==== outputSyntax and outputSyntaxVersion ====
82 82  
83 -With non 1.0 syntax document its 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##.
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##.
84 84  
85 -See [[code:Modules.RenderingModule]] for more details on renderers.
86 +See [[extensions:Extension.Rendering Module]] for more details on renderers.
86 86  
87 87  === export mode ===
88 88  
... ... @@ -90,7 +90,7 @@
90 90  
91 91  == Generic ==
92 92  
93 -Actions can use URL parameters to modify their action depending of their value.
94 +Actions can use URL parameters to modify their action depending on their value.
94 94  
95 95  For example you can make a velocity script that prints the content of this value with:
96 96  

Get Connected