aksw.org Research Group dataset

AKSW Web Page Documentation

{{toc tag=”ul” depth=”3”}}

Big-Picture

This web page consists of linked data enabled resources. Each resource has a specific HTML5 representation (besides its RDF representation). This HTML representation is rendered by using a template and fill its variable parts with the content from these sources:

• values (Literals) of specific attributes from the resource
• output of helper markup (see below)
• content rendered from sub-templates

Resources and Properties

The following attributes and classes are used by the templates.

Classes

Currently, there are templates for the following classes of resources:

• [[foaf:Document]]: a basic web page without specific lists and queries
• [[aiiso:ResearchGroup]]: a (sub) research group with lists of member, research areas and projects
• [[foaf:Person]]: a person with lists of projects and research areas
• [[foaf:Project]]: an AKSW project. Can be a funded, a community or an open-source project.

Properties

These properties can be applied to all resources:

• [[rdfs:label]]: This is the overall headline, name or title of a resource.
• [[site:menuLabel]]: If the resource title is too long for the menu, use this property in addition to [[rdfs:label]].
• [[site:content]]: The main content property. The literal value should be of datatype [[sysont:Markdown]].
• [[dcterms:abstract]]: This is a plain text attribute (no markup). The content of this attribute is used in extended lists and build the header of the resource as a first summary paragraph.
• [[aksw:hookline]]: This a less than 100 character description of the resource. Hooklines are especially important for projects to advertise them in lists and on top of the project page.
• [[sioc:feed]]: Use this object property to relate a RSS or Atom feed to this resource. The content of this feed is shown in the right side content column.

In addition to the general properties, these class specific properties can be used:

• for Projects: [[foaf:homepage]]
• for Groups: [[aksw:researchAreas]], [[foaf:member]]
• for Person: [[foaf:name]], [[foaf:currentProject]], [[foaf:pastProject]], [[foaf:mbox]], [[aksw:room]], [[aksw:publicationTag]] (for the publication list)

Main Content

The suggested markup language to write pages is Markdown. Markdown is a text-to-HTML conversion language for web writers. Markdown is intended to be as easy-to-read and easy-to-write as is feasible.

All details on Markdown syntax are available on the syntax page. Besides its readability, one main advantage of Markdown is its integration with HTML. Wherever you need HTML markup, you can use it without any quote or special syntax as inline HTML. Have a look at the sources of this document to copy/paste specific style elements which you want to reuse, or add new stuff and share it.

The main content of each resource is saved as a Literal object with the attribute [[site:content]]. See the description of this property for details about its usage. In general: All attributes and classes have a proper documentation, so you just need to click on them inside of OntoWiki for more details.

Helper Markup

Helper markup is used in the same way as wiki actions. The general syntax of a helper tag is: {{tagname p1="value1" ... "pX"="valueX"}}.

The following helper exists so far.

Table of Content helper

The toc helper creates an javascript generated table of contents at the position where the helper tag was written.

The following options can be used

• tag: the toc type can be ol, ul or div, default is ol
• startlevel: which heading level to start? default is 1
• depth: how many TOC levels you want? default is 2

Examples (use a single = instead of ==):

• {{toc depth=="2"}}

link helper

The link helper creates an internal page link to a specific resource. If you need to link to an aksw.org resource, you should use this helper instead of using plain HTML-links or Markdown link syntax.

Possible parameters are:

• literal: search for this literal and link to its resource (the first found).
  • short form: l
• ‘uri’: instead of searching for a resource, use the given qname or uri string
  • short form: r
• property: search only for literals of the given property.
  • short form: p
• text: instead of using the resource title, use the given string as link text.
  • short form: t

Examples (use a single = instead of ==):

• {{link uri=="http://aksw.org/About"}}
  • result: {{link uri=”http://aksw.org/About”}}
• {{link r=="foaf:Person"}}
  • result: {{link r=”foaf:Person”}}
  • comment: use qnames where possible, use short values
• {{link literal=="Projects"}}
  • result: {{link literal=”Projects”}}
• {{link text=="our projects" literal="Projects"}}
  • result: {{link text=”our projects” literal=”Projects”}}
• {{link property=="site:menuLabel" literal="About"}}
  • result: {{link property=”site:menuLabel” literal=”About”}}
• {{link literal=="MyPage"}}
  • result: {{link literal=”MyPage”}}
  • comment: no links to non existing resources
• {{link uri=="no/uri"}}
  • result: {{link uri=”no/uri”}}
  • comment: wrong usage is indicated in this way, a mouseover tooltip over the error gives you more information about the problem
• {{link p=="foaf:nick" l="Seebi" t="my page"}}
  • result: {{link p=”foaf:nick” l=”Seebi” t=”my page”}}
  • comment: Example with short parameters, qname and given link text

Style Elements

There are specific style elements as two column sections or tables which you can add to your documents by using HTML markup.

Multi Columns

Tables

Use standard HTML tables with table head and cell tags to achieve a look like this

Navigation Structures

Menus are [[rdf:Seq]] resources of type [[aksw:Navigation]]. The rdf properties rdf:_1 till rdf:_x are used to arrange an ordererd list of resources which a used to render a navigation menu. Currently, we have these navigation resources:

• {{link literal=”Main Navigation”}}
• {{link literal=”Top Navigation”}}