Help:Gantt format

From semantic-mediawiki.org
(Redirected from Help:Gantt format)
This result format has not yet been merged into the code base1.
Gantt format
Outputs the result as Gantt charts.
Further Information
Provided by: Extension "Semantic Result Formats"
Added: 3.1.0
Removed: still supported
Requirements: Mermaid extension
Format name: gantt
Enabled? Indicates whether the result format is enabled by default upon installation of the respective extension. no
Authors: Sebastian Schmid
Categories: charts
Table of Contents

The result format gantt is used to format query results as Gantt charts. It was introduced with version 3.1.01 of extension "Semantic Result Formats"Provides additional formats for semantic queries and requires version 2.0.0 of extension "Mermaid" (MediaWiki.org).

Parameters

A fatal error occurred in the #smwdoc parser function

The following parameters are available2:

  • axisformat = Allows to format the axis of your chart. Defaults to "%m/%d/%Y"3.
  • diagramtitle = Allows to set the title of the chart. Defaults to "" meaning no title.
  • sortkey = Allows to set how the task in should be sorted in the chart. Defaults to "" meaning natural sorting. Possible predefined values are title, startdate and enddate.
  • statusmapping = Allows to map internal values set to the property holding the data values for the status of the tasks. Defaults to "" meaning no mapping is provided. Available values are active and done. It is possible to map multiple properties to a task status.
Example: |statusmapping=2 (in progress)=>active;3 (completed)=>done
  • prioritymapping = Allows to map internal values set to the property holding the data values for the priority of the tasks. Defaults to "" meaning no mapping is provided. Available value is crit. It is possible to map multiple properties to a task priority.
Example: |prioritymapping=1 (high)=>crit; 2 (normal)=>crit
  • leftpadding = Allows to set the width of the section title. Defaults to "75".
  • titletopmargin = Allows to set the margin of the chart title. Defaults to "25".
  • barheight = Allows to set the height of the tasks. Defaults to "20".
  • bargap = Allows to set the vertical distance between the tasks. Defaults to "4".

Example[edit]

This result format is currently not available on this wiki. Thus an example output cannot be provided.
Syntax
{{#ask:
 [[Category:Issue]]
 |?Display Title=task
 |?Issue Status=status
 |?Start Date=startdate
 |?End Date=enddate
 |?Related To Epic=section
 |?Issue Priority=priority
 |format=gantt
 |axisformat=%d/%m/%Y
 |diagramtitle=Title of the chart
 |statusmapping=2 (in progress)=>active;3 (completed)=>done
 |prioritymapping=1 (high)=>crit; 2 (normal)=>crit
 |sortkey=title
 |leftpadding=120
 |titletopmargin=25
 |bargap=10
 |barheight=50
}}

Installation[edit]

This section describes how to install the required extension "Mermaid" (MediaWiki.org) with Composer. To do this add the following as the last line of the "require" section in your "composer.local.json" file not forgetting to add a comma to the end of the preceding line:

"mediawiki/mermaid": "~2.1"

Now run the following command from the root directory of your wiki to complete the installation:

composer update --no-dev

Finally add the following line to your "LocalSettings.php" after the inclusion of the Semantic Result Formats extension:

wfLoadExtension( 'Mermaid' );
$srfgFormats[] = 'gantt';


References

  1. a b  Semantic Result Formats: GitHub pull request gh:srf:467
  2. ^  For more info see Gantt chart: general documentation
  3. ^  For more info see Gantt charts: scale parameter documentation