Mediawiki Extension PageSchema - Revision history

DochyJP: Text replacement - "[{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]" to ""

2021-04-14T12:56:13Z

Text replacement - "[{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]" to ""

DochyJP: Text replacement - " " to " [{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]"

2021-04-14T12:47:43Z

Text replacement - " " to " [{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]"

DochyJP: Added template version in infobox for future updates

2021-04-13T07:04:52Z

Added template version in infobox for future updates

DochyJP: Changed Infobox

2021-02-26T13:23:59Z

Changed Infobox

DochyJP: Text replacement - "Template-uk:Class-Infobox-Software" to "Template:Class-Infobox-Software"

2021-02-25T12:32:50Z

Text replacement - "Template-uk:Class-Infobox-Software" to "Template:Class-Infobox-Software"

DochyJP: Added infobox and semantic variables

2021-02-15T12:44:53Z

Added infobox and semantic variables

DochyJP: Page creation

2021-01-04T16:20:49Z

Page creation

New page

'''<span style="color:white; background:white">[[PageName::{{PAGENAME}}|]]</span>'''

{{Template-uk:Class-Infobox-Software
|image = 
|Source = [[Source::DataSource]]
|Version = [[Version::MW-1.31-LTS]]
|Language = [[Language::English]]
|Subject = [[Subject::Mediawiki]]
|DocumentType = [[DocumentType::Extension]]
|LastEditBy = [[LastEditBy::{{REVISIONUSER}}]]
|LastEdit = [[LastEdit::{{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}]]
|DocumentStatus = [[DocumentStatus::Active]] 
}}


== Description ==
Page Schemas is a MediaWiki extension that allows for defining all the schema information about a "class", or data type - for naming, display, data input, and browsing - within a single piece of XML contained within a category page. This XML then is used to generate all the necessary additional pages needed to put the schema into effect, such as template pages and, for instance, if Page Forms is installed, form pages. The XML can be created and edited via a helper form, preventing users from having to generate or modify it manually.

Page Schemas allows other extensions to define their own fields to add to the XML, using hooks. Currently, the following extensions hook into Page Schemas:
:*Cargo
:*Page Forms
:*Semantic MediaWiki
:*Semantic Drilldown
:*Semantic Internal Objects
== Installation ==

=== Download ===
You can [https://github.com/wikimedia/mediawiki-extensions-PageSchemas/archive/0.5.zip download] the Page Schemas code, in .zip format, [https://github.com/wikimedia/mediawiki-extensions-PageSchemas/archive/0.5.zip here].

You can also download the code via Git from the MediaWiki source code repository. From a command line, you can call the following:
<pre>git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PageSchemas.git</pre>
=== Activation ===
After you've obtained a 'PageSchemas' directory, place this directory within the main MediaWiki 'extensions' directory. Then, in the file 'LocalSettings.php' in the main MediaWiki directory, add either one of the following lines:
<pre>wfLoadExtension( "PageSchemas" );</pre>
or
<pre>include_once( "$IP/extensions/PageSchemas/PageSchemas.php" );</pre>

=== Configuration ===
Page Schemas defines two pages that can show up as tabs on category pages: "Edit schema" (which appears as "Create schema" if no schema exists yet) and "Generate pages". "Edit schema" allows for creating or editing the XML via the helper form, while "Generate pages" provides a button that lets the administrator create the template(s), semantic properties, form etc. automatically from the XML definition. "Generate pages" also includes checkboxes for each of the pages to be generated, to let administrators choose not to override certain wiki pages that already exist.

Any user who is allowed to edit a certain category page will see the "Edit schema/Create schema" tab for that category, and will be allowed to use that page to modify the schema.

In order to generate pages, a user must have the 'generatepages' permission. By default, this permission is given only to members of the 'sysop' user group. You can add to or modify the set of allowed users, though, by modifying the $wgGroupPermissions array in LocalSettings.php. To enable all registered users to generate pages from the schema, for instance, you would add the following:
<pre>$wgGroupPermissions['user']['generatepages'] = true;</pre>

=== Tutorial video ===
You can see a screencast video for Page Schemas created by Yury Katkov, explaining how it's used and why it can be useful.
{{#evt:
service=youtube
|id=https://www.youtube.com/watch?v=R3VNRvt4G6w
|alignment=right
}}
=== Sample XML structure ===
Here is some sample XML, to be contained within a page called "Category:Cities", used to define the schema for pages within that category. This section defines the name of the form, and information for a single field of that class, "Population".

<PageSchema>
<pageforms_Form name="City">
<standardInputs/>
</pageforms_Form>
<Template name="City" format="standard">
<Field name="Population">
<Label>Pop.</Label>
<semanticmediawiki_Property name="Has population">
<Type>Number</Type>
</semanticmediawiki_Property>
<pageforms_FormInput>
<InputType>text</InputType>
<Parameter name="size">20</Parameter>
<Parameter name="mandatory"/>
</pageforms_FormInput>
</Field>
...
</Template>
...
<Section name="History" level="2">
<pageforms_PageSection>
<Parameter name="rows">10</Parameter>
<Parameter name="mandatory"/>
</pageforms_PageSection>
</Section>
...
</PageSchema>

<br><br>[[#top|Back to top of page]] - [[English|Back to Welcome Page]] <br><br>

[[Category:Mediawiki]]

@@ Line 15: / Line 15: @@
 }}
 <!-- End of Template Infobox Generic-->
-[{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]
 == Description ==
 Page Schemas is a MediaWiki extension that allows for defining all the schema information about a "class", or data type - for naming, display, data input, and browsing - within a single piece of XML contained within a category page. This XML then is used to generate all the necessary additional pages needed to put the schema into effect, such as template pages and, for instance, if Page Forms is installed, form pages. The XML can be created and edited via a helper form, preventing users from having to generate or modify it manually.

@@ Line 11: / Line 11: @@
 	|LastEdit = [[LastEdit::{{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}]]
 	|Status = [[Status::Active]] <!--[[Status::Active]]  [[Status::Development]] [[Status::Obsolete]] [[Status::Archived]] [[Status::To Delete]]-->
 }}
 <!-- End of Template Infobox Generic-->

@@ Line 1: / Line 1: @@
-'''<span style="color:white; background:white">[[PageName::{{PAGENAME}}|]]</span>'''
+<!-- Template Infobox Generic-->
-<!-- Template Infobox Software -->
+{{Template:Class-Infobox-Generic<!-- ALL MUST BE FILLED IN -->
 	|image = <!-- If an logo is required, enter the link here -->
 	|Section = [[Section::{{PAGENAME}}]]
-	|Source =  [[Source::DataSource]]<!-- [[Source::DataSource]], [[Source::Semantic Query]], ... -->
+	|Source = [[Source::DataSource]]  <!-- [[Source::DataSource]], [[Source::Query]] ... -->
-	|Version = [[Version::MW-1.31-LTS]]<!-- [[Version::MW-1.31-LTS]] -->
+	|Language = [[Language::English]] <!-- [[Language::English]], [[Language::Français]], [[Language::Nederlands]] -->
-	|Language = [[Language::English]]<!-- [[Language::English]], [[Language::Français]] -->
+	|Topic =  [[Topic::Mediawiki]] <!-- [[Topic::Mediawiki]], [[Subject::Microsoft]], ... -->
-	|Subject =  [[Subject::Mediawiki]]<!-- [[Subject::Mediawiki]], ... -->
+	|SubTopic = [[SubTopic::Mediawiki Extension]] <!-- [[SubTopic::Mediawiki Extension]], [[SubTopic::Office 365]] , ... -->
-         |DocumentType =  [[DocumentType::Extension]]<!-- [[DocumentType::Extension]] -->
+         |DocumentType =  [[DocumentType::Documentation]] <!-- [[DocumentType::User Guide]], [[DocumentType::Procedure]], [[DocumentType::Script]], [[DocumentType::Gallery]], ...-->
 	|LastEditBy = [[LastEditBy::{{REVISIONUSER}}]]
 	|LastEdit = [[LastEdit::{{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}]]
-	|DocumentStatus = [[DocumentStatus::Active]] <!--[[DocumentStatus::Active]]  [[DocumentStatus::Development]] [[DocumentStatus::Obsolete]] -->
+	|Status = [[Status::Active]] <!--[[Status::Active]]  [[Status::Development]] [[Status::Obsolete]] [[Status::Archived]] [[Status::To Delete]]-->
 }}
-<!-- End of Template Infobox Software -->
+<!-- End of Template Infobox Generic-->
 == Description ==