Guide: Difference between revisions

From
Jump to navigation Jump to search
No edit summary
Tag: Reverted
(transformed)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:


NB: this guide will require updating as the sites progresses.


This site uses MediaWiki software, which provides general editing facilities,  
This site uses MediaWiki software, which provides general editing facilities,  
with the addition of software from Semantic Mediawiki,  
with the addition of software from Semantic Mediawiki,  
which adds database like features based on subject-predicate-object links
which adds database like features based on subject-predicate-object links (tripes).
(triples, also the foundation of graph databases).  
Typically, the subject of the triple is a page.
Typically, the subject of the triple is a page.


Line 16: Line 14:
== Main Page ==
== Main Page ==


The [[Main Page]] provides links to [[#Rights_pages|Rights pages]] and a timeline view.
The [[Main Page]] provides links to [[#Rights_pages|Rights pages]].  
The timeline view shows Probable Years from all Rights.
On clicking Timeline items the user is brought to that specific right section.


Below the Timeline view is a list of Explore links, including a link to this guide.
Below the links is a list of Explore links, including a link to this guide.


== Rights pages ==
== Rights pages ==
Line 26: Line 22:
Rights pages are generated by queries using [[:Category:Right]] and [[Property:Section]].   
Rights pages are generated by queries using [[:Category:Right]] and [[Property:Section]].   
View the page source to see how they are composed.
View the page source to see how they are composed.
Each Right's History page has a timeline view, which shows Probable Years from that Right.
On clicking Timeline items the user is brought to that specific right section.


The following taxonomy is used for Right structure: <strong>Right > Topic > Question > Breakout</strong>.  
The following taxonomy is used for Right structure: <strong>Right > Topic > Question > Breakout</strong>.  
Line 31: Line 30:
Some Questions have nested Questions.
Some Questions have nested Questions.


For each Right, an [edit] link is provided for an existing section, or a [create] link.
For each Right, an 🖉 edit link is provided for an existing section, or a create link.
Breakouts are edited by selecting their heading.  
Breakouts are edited by selecting their heading.  
A widget,  
A widget,  
Line 37: Line 36:
is provided to create breakouts that don't exist yet.
is provided to create breakouts that don't exist yet.


Every right except Freedom and Association, which has heading consistency issues,
== Explore pages (Country, Philosophy) ==
and Right to Education, which was unavailable at time of export,
are imported as of the data export.
 
== Explore pages ==
 
=== [[Rights by country]], [[Rights by philosophy]] ===


These page shows how section data can be queried and developed independant of Rights pages.  
These page shows how section data can be queried and developed independant of Rights pages.  
Line 75: Line 68:
such as tag clouds and graphs can be used to explore content and relationships
such as tag clouds and graphs can be used to explore content and relationships
and address site issues such as missing content.
and address site issues such as missing content.
== Issues ==
* Normally, using the form to edit a Right Section should cause the overall Right page to refresh.  Instead, the user is directed to refresh the page after editing a section. The page can also be refreshed using the Page More > Refresh button can trigger an immediate update.
* [[todo::Right "here" menus should be fixed at the top of the screen.]] This will allow switching between sections without having to scroll to the page top.
== To do items ==
{{ #ask: [[todo::+]]|?todo }}

Latest revision as of 13:52, 5 January 2023


This site uses MediaWiki software, which provides general editing facilities, with the addition of software from Semantic Mediawiki, which adds database like features based on subject-predicate-object links (tripes). Typically, the subject of the triple is a page.

Accounts and access

An account is required to edit content on the site. End users can't create their own accounts, instead a Sysop user should user the Special:CreateAccount page.

Main Page

The Main Page provides links to Rights pages.

Below the links is a list of Explore links, including a link to this guide.

Rights pages

Rights pages are generated by queries using Category:Right and Property:Section. View the page source to see how they are composed.

Each Right's History page has a timeline view, which shows Probable Years from that Right. On clicking Timeline items the user is brought to that specific right section.

The following taxonomy is used for Right structure: Right > Topic > Question > Breakout. A breakout is a country or philosophical system. Some Questions have nested Questions.

For each Right, an 🖉 edit link is provided for an existing section, or a + create link. Breakouts are edited by selecting their heading. A widget, populated by the full list of country or philosophical systems, is provided to create breakouts that don't exist yet.

Explore pages (Country, Philosophy)

These page shows how section data can be queried and developed independant of Rights pages. Pages, categories, properties and queries can be changed or added as required.

Data development

Semantic Mediawiki supports a range of data types, from numbers, dates, pages, text, units of measure, and so on. Triples build on the concept of links to type the association (named links). Therefore, they provide a strong way to indicate relationships between subjects, which can be queried.

Data can be assigned in templates, or inline by extending MediaWiki links using :: notation. For example, a simple form of data extraction is used to create Property:Probable year links. These links can be transformed into specific dates via manual editing.

Additionally, simple inference can be used. For example, a Probable year is a type of Date, so general Dates can be queried, or more specific Date types.

Data elements are in Special:Properties, Special:Templates, Special:Forms and Special:Categories.

Here's the site taxonomy:

TLC(3 C)
Breakouts(2 C)
Right(9 C, 6 P)
Section(9 P)

Data can also be explored on an ad hoc basis using Special:Ask.

Further opportunities

In addition to the above, bibliography entries could be consolidated across the site.

Other formats, Mediawiki and Semantic Mediawiki tools and extensions are available such as tag clouds and graphs can be used to explore content and relationships and address site issues such as missing content.