svn commit: r531963 - /lenya/docu/src/documentation/content/xdocs/docs/1_4/concepts/urlMapping.xml

[an...@apache.org]

Author: andreas
Date: Tue Apr 24 07:45:33 2007
New Revision: 531963

URL: http://svn.apache.org/viewvc?view=rev&rev=531963
Log:
Updated docs about URL mapping

Modified:
    lenya/docu/src/documentation/content/xdocs/docs/1_4/concepts/urlMapping.xml

Modified: lenya/docu/src/documentation/content/xdocs/docs/1_4/concepts/urlMapping.xml
URL: http://svn.apache.org/viewvc/lenya/docu/src/documentation/content/xdocs/docs/1_4/concepts/urlMapping.xml?view=diff&rev=531963&r1=531962&r2=531963
==============================================================================
--- lenya/docu/src/documentation/content/xdocs/docs/1_4/concepts/urlMapping.xml (original)
+++ lenya/docu/src/documentation/content/xdocs/docs/1_4/concepts/urlMapping.xml Tue Apr 24 07:45:33 2007
@@ -31,17 +31,45 @@
       <p> This is reflected in the following methods: </p>
       <source> DocumentBuilder.buildDocument(...) 
  DocumentBuilder.buildCanonicalUrl(...)</source>
-      <p> At the moment, the concept of multiple URLs per document is typically 
+      <p>The concept of multiple URLs per document is typically 
         used for language versions (foo_{defaultlanguage}.html = foo.html) and 
-        to support different URL suffixes (foo, foo.htm, foo.html). </p>
-      <p> The site structure is currently tightly connected to the URL space. 
-        Link URLs are derived directly from the site structure:</p>
-      <source> <![CDATA[<node id="foo">
-    <node id="bar"/>
- </node>]]> </source>
-      <p>is interpreted as <code>/foo/bar</code> </p>
-      <p>The language version is handled orthogonally to the site structure. 
-        The URL is determined by combining both document ID and language.</p>
+        to support different URL suffixes (foo, foo.htm, foo.html, foo.pdf). </p>
+      <p>The site structure is tightly connected to the URL space. 
+        Link URLs are derived directly from the site structure.
+        The <code>bar</code> node in the following example</p>
+      <source><![CDATA[<node id="foo">
+  <node id="bar"/>
+</node>]]></source>
+      <p>is accessed using an URL containing the snippet <code>/foo/bar</code>. </p>
+    </section>
+    <section>
+      <title>Language Versions</title>
+      <p>
+        The different language versions of a document can either be accessed
+        using suffixes (<code>foo_en</code>, <code>foo_de</code>), or by attaching them to
+        different nodes with the same UUID attribute in the site structure.
+        In the following example, the top-level nodes "en" and "de" are used
+        as entry points for the respective language.
+      </p>
+      <source xml:space="preserve"><![CDATA[<site>
+  <node id="en">
+    <node id="welcome" uuid="def456...">
+      <label xml:lang="en">Welcome</label>
+    </node>
+  </node>
+  <node id="de">
+    <node id="willkommen" uuid="def456...">
+      <label xml:lang="de">Willkommen</label>
+    </node>
+  </node>
+</site>]]></source>
+      <p>
+        This results in the following URLs:
+      </p>
+      <ul>
+        <li><code>/en/welcome</code> - "Welcome"</li>
+        <li><code>/de/willkommen</code> - "Willkommen"</li>
+      </ul>
     </section>
   </body>
 </document>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@lenya.apache.org
For additional commands, e-mail: commits-help@lenya.apache.org