Item:OSW7113f5cf921a4c82ad1872afeff9d01d - Revision history

Admin: Protected "Item:OSW7113f5cf921a4c82ad1872afeff9d01d": Protected as read-only import via Page Exchange extension ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

2026-01-13T05:05:32Z

Protected "Transcend wikitext to store and edit structured & linked data": Protected as read-only import via Page Exchange extension ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

← Older revision

Revision as of 05:05, 13 January 2026

Admin: Update package: OSW Docs - Core

2026-01-13T05:05:31Z

Update package: OSW Docs - Core

jsondata
← Older revision		Revision as of 05:05, 13 January 2026
Line 1:		Line 1:
	{		{
	"recommended_successor": [		"recommended_successor": [
	"Item:OSWf1df064239044b8fa3c968339fb93344"		"Item:OSWf1df064239044b8fa3c968339fb93344"
	],		],
	"type": [		"type": [
	"Category:OSW494f660e6a714a1a9681c517bbb975da"		"Category:OSW494f660e6a714a1a9681c517bbb975da"
	],		],
	"uuid": "7113f5cf-921a-4c82-ad18-72afeff9d01d",		"uuid": "7113f5cf-921a-4c82-ad18-72afeff9d01d",
	"name": "TranscendWikitextToStoreAndEditStructuredLinkedData",		"name": "TranscendWikitextToStoreAndEditStructuredLinkedData",
	"label": [		"label": [
	{		{
	"text": "Transcend wikitext to store and edit structured \u0026 linked data",		"text": "Transcend wikitext to store and edit structured \u0026 linked data",
	"lang": "en"		"lang": "en"
	}		}
	],		],
	"statements": [		"statements": [
	{		{
	"uuid": "65cb09b2-cbab-4bf0-8e0b-0aa21ec68c2f",		"uuid": "65cb09b2-cbab-4bf0-8e0b-0aa21ec68c2f",
	"predicate": "Property:IsRelatedTo",		"predicate": "Property:IsRelatedTo",
	"object": "Item:OSWab674d663a5b472f838d8e1eb43e6784"		"object": "Item:OSWab674d663a5b472f838d8e1eb43e6784"
	}		}
	]		]
	}		}

Admin: Update package: OSW Docs - Core

2024-04-29T02:03:16Z

Update package: OSW Docs - Core

← Older revision		Revision as of 02:03, 29 April 2024
Line 328:		Line 328:
	}		}
	}		}
	</syntaxhighlight>~~Original jsondata~~		</syntaxhighlight>
	~~<syntaxhighlight lang="json">~~
	{
	~~"my_list": ["Page1", "Page2", "Page3"]~~
	}
	~~</syntaxhighlight>Processed jsondata~~
	~~<syntaxhighlight lang="json">~~
	{
	~~"my_list": " * [[Page1]] <br> * [[Page2]] <br> * [[Page3]] <br> "~~
	}
	~~</syntaxhighlight>'''Result'''~~
	~~Entries of my_list:~~
	* [[Page1]]
	* [[Page2]]
	* [[Page3]]
	</div>		</div>
	</div>		</div>

	<nowiki>Wiki-side feature are implemented in Lua => To be rewritten in PHP</nowiki>		<nowiki>Wiki-side feature are implemented in Lua => To be rewritten in PHP</nowiki>
	*Why are parser calls needed at all? Currently there seems no options to provide a hook from the core that allows injecting slot-specific content ~~/ existing hooks are not aware of the current slot~~		*Why are parser calls needed at all? Currently there seems no options to provide a hook from the core that allows injecting slot-specific content

	== Further links ==		== Further links ==

Admin at 05:14, 13 December 2023

2023-12-13T05:14:13Z

← Older revision		Revision as of 05:14, 13 December 2023
Line 339:		Line 339:
	}		}
	</syntaxhighlight>'''Result'''		</syntaxhighlight>'''Result'''
			Entries of my_list:
	* [[Page1]]		* [[Page1]]
	* [[Page2]]		* [[Page2]]

Admin at 05:13, 13 December 2023

2023-12-13T05:13:21Z

← Older revision		Revision as of 05:13, 13 December 2023
Line 338:		Line 338:
	"my_list": " * [[Page1]] <br> * [[Page2]] <br> * [[Page3]] <br> "		"my_list": " * [[Page1]] <br> * [[Page2]] <br> * [[Page3]] <br> "
	}		}
	</syntaxhighlight>		</syntaxhighlight>'''Result'''
			* [[Page1]]
			* [[Page2]]
			* [[Page3]]
	</div>		</div>
	</div>		</div>

Admin: update examples

2023-12-13T05:10:58Z

update examples

← Older revision		Revision as of 05:10, 13 December 2023
Line 327:		Line 327:
	}		}
	}		}
			}
			</syntaxhighlight>Original jsondata
			<syntaxhighlight lang="json">
			{
			"my_list": ["Page1", "Page2", "Page3"]
			}
			</syntaxhighlight>Processed jsondata
			<syntaxhighlight lang="json">
			{
			"my_list": " * [[Page1]] <br> * [[Page2]] <br> * [[Page3]] <br> "
	}		}
	</syntaxhighlight>		</syntaxhighlight>
Line 333:		Line 343:

	<nowiki>Wiki-side feature are implemented in Lua => To be rewritten in PHP</nowiki>		<nowiki>Wiki-side feature are implemented in Lua => To be rewritten in PHP</nowiki>
	*Why are parser calls needed at all? Currently there seems no options to provide a hook from the core that allows injecting slot-specific content		*Why are parser calls needed at all? Currently there seems no options to provide a hook from the core that allows injecting slot-specific content / existing hooks are not aware of the current slot

	== Further links ==		== Further links ==

Admin: Install package: OSW Docs - Core

2023-06-27T08:53:23Z

Install package: OSW Docs - Core

New page

==Conventional approach: Using a single slot (main) and multiple pages==
<div style="column-count: 2;">
<div style="break-inside: avoid;">You can have <code>content-model = wikitext</code> for pages, templates, forms, etc.
<syntaxhighlight lang="text">
Some unstructured text
{{MyTemplate
|param1=value1
}}
{{#aparserfunction:}}
</syntaxhighlight>
</div>
<div style="break-inside: avoid;">or <code>content-model = json</code> without any specific rendering
<syntaxhighlight lang="json">
{
"param1": "value1"
}
</syntaxhighlight>
</div>
</div>

Problems:

*you can have rendered page content or structured page content
*content is distributed over multiple pages

==Conventional approach: Using a single slot (main) and a single page==
<div style="column-count: 3;">
<div style="break-inside: avoid;">Store structured data within nested templates in wikitext
<syntaxhighlight lang="text">
Some unstructured text
{{MyDataTemplate
|text=some text
|number=123
|array=1;two;3.0
|nested={{MySubDataTemplate
|param=value
}}
watch out, i am a nested string
{{MySubDataTemplate
|param=value2
}}
}}
{{#aparserfunction:}}
</syntaxhighlight>
</div>
<div style="break-inside: avoid;">json-equivalent
<syntaxhighlight lang="json">
{
"@type": "MyDataTemplate",
"text": "some text",
"number": 123,
"array": [1,"two",3.0],
"nested": [{
"@type": "MySubDataTemplate",
"param": "value"
},
"watch out, i am a nested string",
{
"@type": "MySubDataTemplate",
"param": "value"
}]
}
</syntaxhighlight>
</div>
<div style="break-inside: avoid;">Problems
*Extensions like SMW only cover reading mappend template params as json
*Extensions like PageForms require a individual form to edit the data
*=> In general you need a template-parser (e. g. wikitext to json) in your client software at least to edit/write data in general
*=> Doing so requires guessing of data types and correct interpretation of arrays
</div>
</div>

==Luckily we have Multi-Content-Revisions (MCR)==
Lets add a <code>jsondata</code> slot
<div style="column-count: 3;">
<div style="break-inside: avoid;">
{| class="wikitable"
|+
!Slot!!Content Model
|-
|main||wikitext
|-
|jsondata
|json
|}
</div>
<div style="break-inside: avoid;"> <code>main</code>
<syntaxhighlight lang="text">
Some unstructured text

{{#aparserfunction:}}
</syntaxhighlight>
</div>
<div style="break-inside: avoid;"> <code>jsondata</code>
<syntaxhighlight lang="json">
{
"@type": "MyDataTemplate",
"text": "some text",
"number": 123,
"array": [1,"two",3.0]
}
</syntaxhighlight>
</div>
</div>

==Would be nice to validate the json data==
Lets add a <code>jsonschema</code> slot for Category pages
<div style="column-count: 3;">
<div style="break-inside: avoid;">
{| class="wikitable"
|+
!Slot!!Content Model
|-
|main||wikitext
|-
|'''jsondata'''||json
|-
|'''jsonschema'''||json
|}
</div>
<div style="break-inside: avoid;"> Category:MyCategory <code>jsonschema</code>
<syntaxhighlight lang="json">
{
"type": "object",
"properties": {
"text": { "type": "string" },
"number": { "type": "number" },
"array": { "type": "array" }
}
}
</syntaxhighlight>
</div>
<div style="break-inside: avoid;"> Item:MyInstance <code>jsondata</code>
<syntaxhighlight lang="json">
{
"@type": "MyDataTemplate",
"text": "some text",
"number": 123,
"array": [1,"two",3.0]
}
</syntaxhighlight>
</div>
</div>

==If we have a jsonschema, we get the editor & validator for free==
https://github.com/json-editor/json-editor
<div style="column-count: 3;">
<div style="break-inside: avoid;"> Category:MyCategory <code>jsonschema</code>
<syntaxhighlight lang="json">
{
"type": "object",
"title": "My Form",
"title*": {"de": "Mein Formular"} ,
"properties": {
"color": {
"type": "string",
"format": "color"
},
"number": {
"type": "number",
"description": "not a string!"
}
}
}
</syntaxhighlight>
</div>
<div style="break-inside: avoid;"> Item:MyInstance <code>jsondata</code>
<syntaxhighlight lang="json">
{
"color": "#ff0000",
"number": "123"
}
</syntaxhighlight>
</div>
<div style="break-inside: avoid;">
<div class="JsonEditor json-editor-compact" style="font-size:medium" data-config='{"schema": {
"type": "object",
"title": "My Form",
"title*": {"de": "Mein Formular"} ,
"properties": {
"color": {
"type": "string",
"format": "color"
},
"number": {
"type": "number",
"description": "not a string!"
}
}
}, "data": {
"color": "#ff0000",
"number": "one"
}, "mode":"default"}'></div>
</div>
</div>

==Classes, Instances, Inheritance? ==
Lets add a <code>jsonschema</code> slot for Category pages
<div style="column-count: 3;">
<div style="break-inside: avoid;">
{| class="wikitable"
|+
! Slot!!Content Model
|-
|main|| wikitext
|-
|'''jsondata'''|| json
|-
|'''jsonschema'''|| json
|}
</div>
<div style="break-inside: avoid;"> Category:MyCategory <code>jsonschema</code>
<syntaxhighlight lang="json">
{
"type": "object",
"properties": {
"text": { "type": "string" },
"number": { "type": "number" },
"array": { "type": "array" }
}
}
</syntaxhighlight>
</div>
<div style="break-inside: avoid;"> Category:MySubCategory <code>jsonschema</code>
<syntaxhighlight lang="json">
{
"type": "object",
"allOf": "/wiki/Category:MyCategory?action=raw&slot=jsonschema",
"properties": {
"additional_property": { "type": "string" }
}
}
</syntaxhighlight>
</div>
</div>

==Context and Semantic MediaWiki==
Lets add a json-ld context within the <code>jsonschema</code> slot for Category pages
<div style="column-count: 2;">
<div style="break-inside: avoid;">
{| class="wikitable"
|+
!Slot!!Content Model
|-
|main||wikitext
|-
|jsondata||json
|-
|'''jsonschema'''||json
|}
</div>
<div style="break-inside: avoid;"> Category:MySubCategory <code>jsonschema</code>
<syntaxhighlight lang="json">
{
"@context": [
"/wiki/Category:MyCategory?action=raw&slot=jsonschema",
{
"schema": "https://schema.org/",
"Property": "<my.domain>/id/",
"image": "schema:image",
"image*": "Property:HasProperty"
}
],
"allOf": "/wiki/Category:MyCategory?action=raw&slot=jsonschema",
"properties": {
"additional_property": { "type": "string" }
}
}
</syntaxhighlight>
</div>
</div>

Item:MyInstance <code>jsondata</code>

=> <nowiki>[[HasProperty:{{{additional_property|}}}]]</nowiki>

==Interconnection with the wikiparser==
<div style="column-count: 2;">
<div style="break-inside: avoid;">Additional slots rendered by the wiki parser
</div>
{| class="wikitable"
!Slot
!Content Model
!Description
|-
|main
|wikitext
|default content slot, rendered between the page header and footer
|-
|jsondata
|json
|structured data
|-
|jsonschema
|json
|stored within a category (=class) page, defining the schema for the jsondata slot of any category member (instance)
|-
|'''header_template'''
|wikitext
|stored within a category (=class) page, renders the '''page header''' of any '''category member (instance)'''
|-
|'''footer_template'''
|wikitext
|stored within a '''category''' (=class) page, renders the '''page footer''' of any '''category member (instance)'''
|-
|'''header'''
|wikitext
|renders the '''page header'''<nowiki> via {{#invoke: Entity|header}}*</nowiki>
|-
|'''footer'''
|wikitext
|renders the '''page footer'''<nowiki> via {{#invoke: Entity|footer}}*</nowiki>
|}<div style="break-inside: avoid;">Footer / Header template<syntaxhighlight lang="text">
Entries of my_list:
{{{my_list|}}}
</syntaxhighlight>Property-specific templates within the schema
<syntaxhighlight lang="json">
{
"type": "object",
"properties": {
"my_list": {
"type": "array",
"eval_template": {
"type": "mustache-wikitext",
"value": "{{#my_list}} * [[{{{.}}}]] <br> {{/my_list}}"
}
}
}
}
</syntaxhighlight>
</div>
</div>

*<nowiki>*Wiki-side feature are implemented in Lua => To be rewritten in PHP</nowiki>
*Why are parser calls needed at all? Currently there seems no options to provide a hook from the core that allows injecting slot-specific content

== Further links ==

* https://github.com/OpenSemanticLab (The software stack behind)
* Google structured data validator: https://search.google.com/test/rich-results/result?id=hbvnEP-_VO0pG-KPPLLkDQ
* Schema PagePackages: https://github.com/orgs/OpenSemanticWorld-Packages/repositories