Editing VLit (section)

==Invoking VLit==
===Simple Parameters===
A simple ''transclusion'' is achieved by adding the following to the end of the URL of a text/* document:


<code>
 ?xuversion=1.0&locspec=charrange:offset/length
</code>
Replacing "offset" and "length" with an integer. An offset of 0 and a length of 1 will return the first character. eg.


<code>
 http://www.weebleprints.co.uk/archive/00000543/01/notfalldown.txt
 ?xuversion=1.0&locspec=charrange:1403/130
</code>
(All one URL, only split to fit on the page) This will return characters from offset 1403 to 1533.

===Human Mode===
An optional "mode" parameter may by used. The "human" mode returns the character range as HTML with characters like & properly escaped and new line characters turned into HTML "br" break tags. It will place two links before the text: a (c) link which will link to an explanation of transcopyright - If you want to change this URL you'll have to hack VLit.pm - and a TRANS link which will take you to the context of the quote - 1024 extra characters before and after but with the quote highlighted in red. Clicking TRANS on the context view will take you to the full raw document.

===XML-Entity Mode===
You may also set mode to be xml-entity, eg:


<code>
 http://lemur1.ecs.soton.ac.uk/archive/00000134/01/xuDation-d18.txt?
 locspec=charrange:10429/488&xuversion=1.0&mode=xml-entity
</code>
This returns the transclusion as a piece of XML which can be included as an external entity by other XML documents.

eg:


<code>
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <transclusion xlmns="http://xanadu.net/transclusion/xu/1.0" 
 href="http://lemur1.ecs.soton.ac.uk/archive/00000134/01/xuDation-d18.txt" 
 offset="10429" length="488">A more recent interactive screen 
 implementation of transpointing windows (screen shot fig. 5) was created 
 by Ka-Ping Yee in 1999.  This was served, like Walker's, from our xu88 
 server (rechristened as Udanax Green).  Yee's PYXI is a skeleton front 
 end that shows and edits text, links and transclusions, and may be 
 extended to reach more of the server's functionality.  Both Udanax Green 
 and PYXI were released under an open source license in 1999 (120), and are 
 available at udanax.com. </transclusion>
</code>