You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by bu...@apache.org on 2011/08/08 00:55:42 UTC
svn commit: r793967 [3/3] - in /websites/staging/jena/trunk/content/jena: ./
about_jena/ documentation/ontology/ getting_involved/ images/
Added: websites/staging/jena/trunk/content/jena/documentation/ontology/ont-model-layers-import.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jena/trunk/content/jena/documentation/ontology/ont-model-layers-import.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: websites/staging/jena/trunk/content/jena/documentation/ontology/ont-model-layers.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jena/trunk/content/jena/documentation/ontology/ont-model-layers.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: websites/staging/jena/trunk/content/jena/documentation/ontology/ontology.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/documentation/ontology/ontology.html (original)
+++ websites/staging/jena/trunk/content/jena/documentation/ontology/ontology.html Sun Aug 7 22:55:41 2011
@@ -124,32 +124,28 @@
<div id="content">
<h1 class="title"></h1>
<h1 id="jena_ontology_api">Jena Ontology API</h1>
-<p>In this section I will give a general introduction to the the Jena2
-ontology API. I'll also describe a range of common user tasks. I
+<p>This section is a general introduction to the the Jena2
+ontology API, including some of the common tasks you may need
+to perform. We
won't go into all of the many details of the API here: you should
-expect to refer to the <a href="../javadoc/index.html">Jena2 Javadoc</a> to
-get full details of the capabilities of the API. Feedback, (via the
-<a href="http://tech.groups.yahoo.com/group/jena-dev">jena-dev</a> support
-list) is welcomed.</p>
+expect to refer to the <a href="/java/documentation/javadoc/">Javadoc</a> to
+get full details of the capabilities of the API.</p>
<h2 id="prerequisites">Prerequisites</h2>
-<p>I will assume that you have a basic familiarity with RDF and with
-Jena. There are many other Jena
-<a href="../documentation.html">help documents</a> you can read for background
-on these topics. There is also a
-<a href="../tutorial/index.html">Jena programming tutorial</a> you can follow
-through.</p>
+<p>We'll assume that you have a basic familiarity with RDF and with
+Jena. If not, there are other
+<a href="/jena/getting_started">Jena help documents</a> you can read for background
+on these topics, and a <a href="/jena/tutorials">collection of tutorials</a>.</p>
<p>Jena is a programming toolkit, using the Java programming language.
While there are a few command-line tools to help you perform some
key tasks using Jena, mostly you use Jena by writing Java programs.
The examples in this document will be primarily code samples.</p>
-<p>I also won't be explaining the OWL or RDFS ontology languages in
+<p>We also won't be explaining the OWL or RDFS ontology languages in
much detail in this document. You should expect to refer to
supporting documentation for details on those languages, for
example the <a href="http://www.w3.org/2004/OWL/">W3C OWL document index</a>.</p>
-<p><strong>Note:</strong> At the time of writing, work on OWL version 1.1 is still
-underway. No decision has yet been made about when Jena will
-support the new OWL 1.1 features. I will only use OWL 1.0 features
-in this document.</p>
+<p><strong>Note:</strong> Although OWL version 1.1 is now a W3C recommendation,
+Jena's support for OWL 1.1 features is limited. We will be addressing
+this in future versions Jena.</p>
<h2 id="overview">Overview</h2>
<p>The section of the manual is broken into a number of sections. You
do not need to read them in sequence, though later sections may
@@ -174,20 +170,19 @@ The sections are:</p>
<li><a href="common-problems.html">Common ontology application problems and sample programs</a></li>
</ol>
<h3 id="further_assistance">Further assistance</h3>
-<p>I hope that this document will be sufficient to help most readers
+<p>Hopefully, this document will be sufficient to help most readers
to get started using the Jena ontology API. For further support,
-please post questions to the Jena support list:
-<a href="http://tech.groups.yahoo.com/group/jena-dev">jena-dev@yahoogroups</a>.
-You can also report bugs directly into the
-<a href="https://sourceforge.net/tracker/?atid=430288&group_id=40417&func=browse">Jena bug tracker</a>
-on <a href="http://sourceforge.net/projects/jena">SourceForge</a>.</p>
-<p><em>Please note that we ask that you use the support list or the bug-tracker to communicate with the Jena team, rather than send email to the team members directly. This helps us manage Jena support more effectively, and facilitates contributions from other Jena community members.</em></p>
+please post questions to the <a href="/jena/help_and_support">Jena support list</a>,
+or <a href="/jena/help_and_support/bugs_and_suggestions.html">file a bug report</a>.</p>
+<p><em>Please note that we ask that you use the support list or the bug-tracker
+to communicate with the Jena team, rather than send email to the team
+members directly. This helps us manage Jena support more effectively,
+and facilitates contributions from other Jena community members.</em></p>
<h2 id="general_concepts">General concepts</h2>
<p>In a widely-quoted definition, an ontology is</p>
<blockquote>
-<p>"Â
a specification of a conceptualization"
-[<a href="http://www-ksl.stanford.edu/kst/what-is-an-ontology.html">Gruber, T.</a>
-1993]</p>
+<p>"a specification of a conceptualization"
+[<a href="http://www-ksl.stanford.edu/kst/what-is-an-ontology.html">Gruber, T.</a> 1993]</p>
</blockquote>
<p>Let's unpack that brief characterisation a bit. It means that an
ontology allows a programmer to specify, in an open, meaningful,
@@ -1190,7 +1185,7 @@ class extension  individuals that ar
using the following methods:</p>
<p>Method
Meaning
-listInstances()<br />
+listInstances()
listInstances( boolean direct )
Returns an iterator over those instances that include this class
among their <code>rdf:type</code> values. The <code>direct</code> flag can be used to
@@ -1199,7 +1194,7 @@ than indirectly through the class hierar
<code>rdf:type :Paper</code>, it will appear in the iterator returned by
<code>listInstances</code> on <code>:Artefact</code>, but not in the iterator returned by
<code>listInstances(false)</code> on <code>:Artefact</code>.
-createIndividual()<br />
+createIndividual()
createIndividual( String uri )
Adds a resource to the model, whose asserted <code>rdf:type</code> is this
ontology class. If no URI is given, the individual is an anonymous
@@ -2211,19 +2206,19 @@ regard it as an experimental facility fo
welcome feedback. The capabilities in <code>OntTools</code> are implemented as
static methods. Currently available tools are:</p>
<ul>
-<li><code>OntClass getLCA( OntModel m, OntClass u, OntClass v )</code><br />
+<li><code>OntClass getLCA( OntModel m, OntClass u, OntClass v )</code>
Determine the <em>lowest common ancestor</em> for classes u and v. This is
the class that is lowest in the class hierarchy, and which includes
both u and v among its sub-classes.</li>
-<li><code>Path findShortestPath( Model m, Resource start, RDFNode end, Filter onPath )</code><br />
+<li><code>Path findShortestPath( Model m, Resource start, RDFNode end, Filter onPath )</code>
Breadth-first search, including a cycle check, to locate the
shortest path from <code>start</code> to <code>end</code>, in which every triple on the
path returns <code>true</code> to the <code>onPath</code> predicate.</li>
-<li><code>List namedHierarchyRoots( OntModel m )</code><br />
+<li><code>List namedHierarchyRoots( OntModel m )</code>
Compute a list containing the uppermost fringe of the class
hierarchy in the given model which consists only of named classes.</li>
</ul>
-<p>Author: Ian Dickinson<br />
+<p>Author: Ian Dickinson
Last modified: $Id: index.html,v 1.32 2009-02-24 15:15:20
ian_dickinson Exp $</p>
</div>
Added: websites/staging/jena/trunk/content/jena/documentation/ontology/simple-hierarchy.png
==============================================================================
Binary file - no diff available.
Propchange: websites/staging/jena/trunk/content/jena/documentation/ontology/simple-hierarchy.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Modified: websites/staging/jena/trunk/content/jena/getting_involved/index.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/getting_involved/index.html (original)
+++ websites/staging/jena/trunk/content/jena/getting_involved/index.html Sun Aug 7 22:55:41 2011
@@ -130,14 +130,14 @@ welcome feature suggestions, bug reports
to post a question to the <code>jena-users</code> list as described below. Some Jena contributors
also hang out at <code>#jena</code> on <code>irc.freenode.net</code>.</p>
<h3 id="mailing_lists">Mailing lists</h3>
-<p>The dev mailing list is for discussion among developers and other contributors
-to the project itself. To subscribe, please send an email to
-<a href="mailto:jena-dev-subscribe@incubator.apache.org"><code>jena-dev-subscribe@incubator.apache.org</code></a>
-from the account you wish to subscribe from.</p>
-<p>The users mailing list is the place to get help with using Jena itself. To subscribe,
+<p>The <em>users</em> mailing list is the place to get help with using Jena itself. To subscribe,
please send an email to
<a href="mailto:jena-users-subscribe@incubator.apache.org"><code>jena-users-subscribe@incubator.apache.org</code></a>
from the account you wish to subscribe from.</p>
+<p>The <em>dev</em> mailing list is for discussion among developers and other contributors
+to the project itself. To subscribe, please send an email to
+<a href="mailto:jena-dev-subscribe@incubator.apache.org"><code>jena-dev-subscribe@incubator.apache.org</code></a>
+from the account you wish to subscribe from.</p>
<p>Archives of these mailing list archives are available
at <a href="http://mail-archives.apache.org/mod_mbox#incubating">mail-archives.apache.org</a> and
<a href="http://markmail.org/search/?q=list:org.apache.incubator.jena-*">markmail.org</a>.</p>
Modified: websites/staging/jena/trunk/content/jena/images/jena-architecture.svg
==============================================================================
--- websites/staging/jena/trunk/content/jena/images/jena-architecture.svg (original)
+++ websites/staging/jena/trunk/content/jena/images/jena-architecture.svg Sun Aug 7 22:55:41 2011
@@ -35,7 +35,7 @@
borderopacity="1.0"
inkscape:pageopacity="0.0"
inkscape:pageshadow="2"
- inkscape:zoom="4"
+ inkscape:zoom="1"
inkscape:cx="397.73741"
inkscape:cy="501.05092"
inkscape:document-units="px"
@@ -68,7 +68,9 @@
width="109.89949"
height="36.5"
x="333.7677"
- y="460.68542" />
+ y="460.68542"
+ inkscape:export-xdpi="100.06591"
+ inkscape:export-ydpi="100.06591" />
<rect
style="fill:#04a0d8;fill-opacity:0.34901961;stroke:none"
id="rect2985-32"
@@ -123,7 +125,9 @@
width="109.89949"
height="36.5"
x="446.3934"
- y="460.68542" />
+ y="460.68542"
+ inkscape:export-xdpi="100.06591"
+ inkscape:export-ydpi="100.06591" />
<text
xml:space="preserve"
style="font-size:16px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#ffffff;fill-opacity:1;stroke:none;font-family:FreeSans;-inkscape-font-specification:FreeSans"
Modified: websites/staging/jena/trunk/content/jena/index.html
==============================================================================
--- websites/staging/jena/trunk/content/jena/index.html (original)
+++ websites/staging/jena/trunk/content/jena/index.html Sun Aug 7 22:55:41 2011
@@ -20,7 +20,7 @@
-->
<link href="/jena/css/jena.css" rel="stylesheet" type="text/css">
- <title>Apache Jena - Apache Jena</title>
+ <title>Apache Jena - Welcome to Jena</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<script src="/jena/js/jquery-1.6.1.min.js" type="text/javascript"></script>
<script src="/jena/js/jena-navigation.js" type="text/javascript"></script>
@@ -122,7 +122,7 @@
</div>
<div id="content">
- <h1 class="title">Apache Jena</h1>
+ <h1 class="title">Welcome to Jena</h1>
<p>Welcome to the Apache Jena project! Jena is a Java framework for building
Semantic Web applications.
Jena provides a collection of tools and Java libraries to help you
@@ -151,6 +151,7 @@ of protocols, including SPARQL</li>
<li>... <a href="/jena/getting_started/index.html">see how to get started with Jena</a></li>
<li>... <a href="/jena/help_and_support/bugs_and_suggestions.html">report a bug</a></li>
<li>... <a href="/jena/help_and_support/index.html">get help using Jena</a></li>
+<li>... <a href="/jena/documentation/javadoc/">read the Javadoc</a></li>
<li>... <a href="/jena/getting_involved/index.html">contribute to the project!</a></li>
</ul>
</div>