RichMorin: Automated import of articles

2010-07-27T20:56:11Z

Automated import of articles

New page

__NOTOC__

== Entity Rendering ==

<noinclude>{{Pr4_UG_h2_TOC}}<div id='pr4_ug'></noinclude>

Because URIs will often be fairly long strings,
{{#var:Pr4}} uses a '''renderer''' to show a shortened form of the name.
(See [[Pr4_UG_h2_En_Name|entity naming]] for details.)

The renderer can be changed in the preferences (see below)
and can show the fragment or ending part of the URI,
or can show a name provided by an annotation on the entity.

So '''Pizza''' is actually just a rendering
of the URI http://www.co-ode.org/ontologies/pizza/pizza.owl#Pizza.

The full URI can always be viewed
by hovering over an entity in its tree (the tooltip shows the full name).
Also, the "Refactor | Rename entity" menu item always works with the URI -
in fact, you can see the full URI
by just clicking on the checkbox in the rename dialog.

=== Rendering preferences ===

There are 4 options for the type of renderer you can select:

<ul>
<li> '''URI fragment''' -
the part of the URI following the '''#''' or last '''/''' character

<li> '''qnames''' (qualified name) -
the fragment but with a [[#Prefixes...|prefix]] set

<li> '''annotation values''' -
uses the value of an entity annotation
specified in [[#Annotations...|Annotations...]]

<li> '''annotation values with prefixes''' -
uses a combination of the [[#Annotations...|annotation]] value
and the qname [[#Prefixes...|prefixes]]
</ul>

When using the 3rd and 4th option,
you will probably wish to also set the "new entities" preferences;
this creates labels when a new entity is created.

[[Image:Pr4_UG_h2_Renderer-prefs.png|400px]]

==== Prefixes... ====

URIs are long.
A short form (prefix) can be specified
to represent the commonly used leftmost part of a URI.

eg. if we have a prefix mapping:

<blockquote>
<tt><nowiki>pizza = http://www.co-ode.org/ontologies/pizza/pizza.owl#</nowiki></tt>
</blockquote>

then the following class:

<blockquote>
<tt><nowiki>http://www.co-ode.org/ontologies/pizza/pizza.owl#CheeseTopping</nowiki></tt>
</blockquote>

can be written much more concisely:

<blockquote>
<tt><nowiki>pizza:CheeseTopping</nowiki></tt>
</blockquote>

The prefixes... option is available for both the '''qname'''
and the '''annotation values with prefixes''' renderers.

The table that is brought up allows the user to add new prefixes by hand
or get P4 to generate them from the loaded ontologies.
Several prefixes are available as default.

[[Image:Pr4_UG_h2_Prefix-mappings.png|400px]]

==== Annotations... ====

If you have set the renderer to be either of the annotations versions,
this option will be available.

You can specify a list of which annotations are searched
for a rendering in order of preference.
In addition, for each given annotation,
you can specify a comma-separated list of languages
(again in order of preferences).

eg the setup on the right will first try
to find a '''label''' annotation in English,
followed by one with no language set, followed by any language.
If it fails, then it will look for any '''prefLabel''' it can find.

If the annotations renderer fails to find an appropriate label,
it will default to the fragment.

[[Image:Pr4_UG_h2_Annotation-label-prefs.png|400px]]

</div>

Pr4 UG h2 En Render - Revision history

RichMorin: Automated import of articles