EPrints 2.0.1 Documentation - VLit Transclusion Support |
** This feature is still experimental **
VLit is a method for quoting a part of a document directly. It is available on any file in the public documents area of a text mime-type (text/plain
, text/html
etc). It allows a range of characters to be extracted rather than the entire document. This allows external systems, rather than quote by cut-and-paste, to quote in context of the original.
If you use it, please edit the vlit page in /opt/eprints2/archives/foo/cfg/static/en/vlit.xpage
to indicate under what terms the feature may be used. When using ``human'' mode, described below, this page is what the (c) copyright symbol links to, by default.
Don't forget to re-run generate_static.
If for some reason you want to disable VLit, you may do so in ArchiveConfig.pm - you will then need to re-run generate_apacheconf
and restart the web server.
Edit the vlit page (as described above) to indicate that the feature is not available on your archive.
A simple transclusion is achieved by adding the following to the end of the URL of a text/* document:
?xuversion=1.0&locspec=charrange:offset/length
Replacing ``offset'' and ``length'' with an integer. An offset of 0 and a length of 1 will return the first character. eg.
http://www.weebleprints.co.uk/archive/00000543/01/notfalldown.txt ?xuversion=1.0&locspec=charrange:1403/130
(All one URL, only split to fit on the page) This will return characters from offset 1403 to 1533.
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.
You may also set mode to be xml-entity, eg:
http://lemur1.ecs.soton.ac.uk/archive/00000134/01/xuDation-d18.txt? locspec=charrange:10429/488&xuversion=1.0&mode=xml-entity
This returns the transclusion as a piece of XML which can be included as an external entity by other XML documents.
eg:
<?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>
There is an 'area' locspec which requires the 'convert' unix command. It returns an area of an image specified as locspec=area:topx,topy/width,height
- It is not yet supported and it's use is not recommended.
EPrints 2.0.1 Documentation - VLit Transclusion Support |