Help:Eventline format

From semantic-mediawiki.org
(Redirected from Help:Eventline format)
Help:Eventline formatEventline format/de
Eventline format
Displays query results in interactive eventlines
Further Information
Provided by: Extension "Semantic Result Formats"
Added: 1.4.0
Removed: still supported
Requirements: none
Format name: eventline
Enabled? Indicates whether the result format is enabled by default upon installation of the respective extension. No
Authors: Markus Krötzsch , Jeroen De Dauw
Categories: time
Keywords
Table of Contents
This result format is not currently maintained. It might not work with the latest version of Semantic MediaWiki.

The result format eventline are used to display query results in interactive eventlines. This format was part of Semantic MediaWiki until Semantic MediaWiki 1.3.0Released on 7 September 2008 and compatible with MW 1.12.x - 1.15.x. and is now part of extension "Semantic Result Formats"Provides additional formats for semantic queries. Obviously, only results that include dates can be displayed in this way. This format only works when JavaScript is enabled. It is similar to the timeline format.

Usage[edit]

The eventline format uses printout statements in queries for properties of datatype "Date"Holds particular points in time. If the eventline remains empty even though there are results, this is usually because no printouts for dates were specified. Eventline will display all dates in the printout as separate points. So a query with five data printouts would create five points on the eventline for each result. Different colors are used to maintain some visual hint of which points belong to which result. Again the tooltip shows all details. All other printout statements are shown in the tooltips that appear when clicking on items.

Parameters[edit]

Parameter Type Default Description
timelinesize text 300px The height of the timeline
timelineposition text middle Defines where the timeline initially focuses at.
timelinestart text empty A property name used to define a first time point
timelineend text empty A property name used to define a second time point
timelinebands list of texts MONTH, YEAR Defines which bands are displayed in the result.
template text empty The name of a template with which to display the printouts
named args yes/no no Name the arguments passed to the template

Available values for parameters:

  • timelinebands: Available bands are DECADE, YEAR, MONTH, WEEK, DAY, HOUR and MINUTE. Bands should be given from finer to coarser, and be separated by commas as in the example below.
  • timelineposition: Possible values are start (earliest entry), middle (middle entry), end (latest entry), today.
NoteNote: The eventline format is derived from the timeline format. This is why the parameter names are identical to the ones used in the timeline format.

Example[edit]

{{#ask:
 [[News date::+]]
 [[Language code::en]]
 |?News date
 |sort=News date
 |order=descending
 |format=eventline
 |timelinebands=WEEK,MONTH,YEAR
 |timelineposition=end
 |limit=500
}}

This produces the following output:

Remarks[edit]

Page load times can be slowed down by eventlines, especially if a large number of events is displayed. It is useful to use a smaller limit to keep the eventline more manageable for browsers.

Sorting results has no impact on the display of the timeline, since it always displays events chronologically. However, sorting can be very useful to select, e.g., the ten latest events instead of ten arbitrary events for display.