Difference between revisions of "Documentation"

From Beyond Social
 
(10 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
=Tips &nd tricks for BS administrators=
 
=Tips &nd tricks for BS administrators=
  
−
==Topics==
+
==Categories==
−
''Topic'' is the custom name that we use to refer to a ''category''.  
+
To add a Category: make a page in the format [[:Category:yourtopichere]].
  
−
A list of topics that we work with can be found here: [[:Topic:Topics]].
+
==Data Structures==
  
−
To add a topic: make a page in the format [[:Topic:yourtopichere]] and copy/paste the smw (Semantic MediaWiki) query + category tag from another topic page, for example from [[:Topic:Activism]]:
+
Read more about the current data structures that we use here: [[Data Structures]]
  
−
<pre>
+
===Semantic MediaWiki (SMW)===
−
<div class="overview">
 
−
{{#ask:[[Category:{{PAGENAME}}]]
 
−
|?Thumb
 
−
|?Category
 
−
|?Modification date
 
−
|?Creation date
 
−
|?Last editor is
 
−
|format=template
 
−
|template=Articles
 
−
}}
 
  
−
[[Category:Topics]]
+
We're using Semantic MediaWiki to store and query the data structures of:
−
</div>
 
−
</pre>
 
  
−
(We use these queries and templates to make the overview pages with the thumbnails.)
+
* Article pages
 +
* Event pages
 +
* User profile pages
 +
* Stack pages
  
−
Save the page, and it will be listed in the [[:Topic:Topics]] page.
+
===Cargo===
  
−
Also, it will show up as one of the options in the drop-down menu of topics when you make a new article .... (hmm... i need to check this!) [[User:Manetta|Manetta]] ([[User talk:Manetta|talk]]) 14:58, 2 November 2018 (CET)
+
We decided to not use Cargo in the end. It was interesting to try it out, but we feel that SMW provides us the tools that we need to store data structures and query pages.
  
−
To '''remove''' a topic from the list, remove the <nowiki>[[Category:Topics]]</nowiki> element from your Topic:MyCategory page.
+
We're currently still using Cargo for the [[:Category:Frictionary]].
  
−
==Vocabulary==
+
Read more about how to use the Frictionary here: [[Frictionary]].
 +
 
 +
Our documentation about Cargo can be found here: [[Cargo]].
 +
 
 +
 
 +
==Changing interface text==
 
The system's modes of address can be edited here: [[Special:AllMessages]].  
 
The system's modes of address can be edited here: [[Special:AllMessages]].  
  
Line 43: Line 39:
 
* [[MediaWiki:Othercontribs]] > Page info text, list of all previous editors of page > ("Based on work by ...")
 
* [[MediaWiki:Othercontribs]] > Page info text, list of all previous editors of page > ("Based on work by ...")
 
* http://beyond-social.org/wiki/index.php?title=Special%3AAllMessages&prefix=Upload-form&filter=all&lang=en&limit=50 > Upload Dialog, specially helpful to edit the license texts.
 
* http://beyond-social.org/wiki/index.php?title=Special%3AAllMessages&prefix=Upload-form&filter=all&lang=en&limit=50 > Upload Dialog, specially helpful to edit the license texts.
 +
* [[MediaWiki:Uploadtext]] > text info for upload file page
  
 
  Trick! You can add "?uselang=qqx" to the url of a page to view the system message names.
 
  Trick! You can add "?uselang=qqx" to the url of a page to view the system message names.

Latest revision as of 12:00, 27 July 2020

Tips &nd tricks for BS administrators

Categories

To add a Category: make a page in the format Category:yourtopichere.

Data Structures

Read more about the current data structures that we use here: Data Structures

Semantic MediaWiki (SMW)

We're using Semantic MediaWiki to store and query the data structures of:

  • Article pages
  • Event pages
  • User profile pages
  • Stack pages

Cargo

We decided to not use Cargo in the end. It was interesting to try it out, but we feel that SMW provides us the tools that we need to store data structures and query pages.

We're currently still using Cargo for the Category:Frictionary.

Read more about how to use the Frictionary here: Frictionary.

Our documentation about Cargo can be found here: Cargo.


Changing interface text

The system's modes of address can be edited here: Special:AllMessages.

A couple of useful ones are the following ones: 

Trick! You can add "?uselang=qqx" to the url of a page to view the system message names.

Layout

We can use the MediaWiki:Common.css page to make a couple of (small) changes in the style & layout of the wiki.

However, as there are many css files active for this layout, most of the styling is defined in the skin files that sit on the server. You can see them here: https://github.com/wdka-publicationSt/BeyondSocial-wiki/tree/alive/skins/BeyondSocial/components