blob: 6382551f8ca454c709118b4e92bed1498c6f9f22 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
<document>
<header>
<title>Samples</title>
</header>
<body>
<section id="intro">
<title>Introduction</title>
<p>This area contains some example documents, some are local, some are remote to try and be varied. The last section contains instructions on how
to request random remote addresses via the address bar of your browser. We welcome more examples and also feedback on how they are working
for you.</p>
<p>Check out the How To sections (links on the left navigation) for more detailed instructions on how to construct your own remote document requests.</p>
</section>
<section id="samples">
<title>Samples</title>
<p>Some local content examples :-</p>
<ul>
<li><a href="xdoc.html">Sample 1</a> A basic TEI xml document rendered as HTML</li>
<li><a href="document-v20.html">Sample 2</a> Our document-v20 xdoc in HTML</li>
<li>Local wiki example coming soon...</li>
</ul>
<note label="Hint">Go to the above documents and click on the ODT icon to download as .odt in OpenOffice 2.3+</note>
<p>Some remote content examples :-</p>
<ul>
<li><a href="/osswatch/resources/beginners.html">OSSWatch 'Open Source for absolute beginners'</a></li>
<li><a href="osswatch/resources/precurement-infopack.html">OSSWatch 'Decision Factors...'</a></li>
<li>Simal Docs example to go here</li>
<li>Google Wiki example to go here</li>
<li>Another wiki example to go here</li>
<li>Something else...</li>
</ul>
<note>Remote documents need to be processed 'on the fly' for displaying, so you will notice a delay - this is normal.</note>
</section>
<section id="remote">
<title>Requesting remote documents.</title>
<p>Currently, requesting remote documents are limited to the 'resources' area of the <a href="http://www.oss-watch.ac.uk">OSSWatch site</a>. This limitation
is mainly by choice; combined with some instructions in the How To section, we aim to expand our choices and help you to be able to do the same.</p>
<section id="remote_osswatch_resources">
<title>Remote resources from OSSWatch</title>
<p>In our sites locationamp.xml file we have chosen a match so that requests made to /osswatch/resources/ will go and retrieve those requests from http://www.osswatch.ac.uk/resources/ and bring them back to Forrest for further processing. That further processing could be 'display in my current site as a regular HTML file' or if an .odt extension is specified it means 'convert to ODT format and allow download for displaying in OpenOffice' (or a number of other things).</p>
<p>So, go ahead and request a document from the OSSWatch resources area. If you are running this site in localhost then your address bar would end up looking something like <code>http://localhost:8888/osswatch/resources/beginners.html</code>.</p>
</section>
<note label="Hint">By requesting any of the above documents with the <code>.odt</code> extension, we can bypass HTML viewing and download direct for opening into OpenOffice.org Writer.</note>
</section>
</body>
</document>