MediaWiki/Editing/Advanced: Difference between revisions

From Bibliotheca Anonoma
No edit summary
Line 99: Line 99:
== Creating Templates ==
== Creating Templates ==


=== Documentation Method 2: Wikipedia-style /doc Subpage ===
{{Note|Template documentation is set up the same way as in the Arch Wiki: inside <code><nowiki><includeonly></includeonly></nowiki></code> tags. This is simpler, if less clean than the Wikipedia template documentation, which puts it in a subpage.}}
 
Subpages are a cleaner way of keeping the documentation separate from the main template, while still allowing the documentation to appear on the template page.
 
While Wikipedia's documentation system has become incredibly complex through the addition of Lua modules, templates from a simpler time still exist out there and we can use them.
 
http://pathfinderwiki.com/mediawiki/index.php?title=Template:Documentation
 
=== Documentation Method 1: Arch Wiki-style <nowiki><noinclude></nowiki> ===


When creating a template meant for users to utilize, you should place a <code><nowiki>{{Template}}</nowiki></code> header into it.
When creating a template meant for users to utilize, you should place a <code><nowiki>{{Template}}</nowiki></code> header into it.
Line 121: Line 113:
</pre>
</pre>


A brief description of the template, usage instructions, and output example should also be added between the 'noinclude' tags (as in this template).
Documentation of the template, usage instructions, and output example should also be added between the 'noinclude' tags (as in this template).


The template wikitext must be written between 'includeonly' tags:
The actual template code must be written between 'includeonly' tags:


<pre>
<pre>
<includeonly>...</includeonly>
<includeonly>...</includeonly>
</pre>
</pre>
{{Note|Template documentation is set up the same way as in the Arch Wiki: inside <code><nowiki><includeonly></includeonly></nowiki></code> tags. This is simpler than the Wikipedia template documentation, which puts it in a subpage.}}

Revision as of 16:31, 9 January 2017

Some advanced features are supported on this wiki.

Creating Infoboxes

Infoboxes on the Bibliotheca Anonoma Wiki are created using Capiunto, a Lua module is relatively easier to install and create infoboxes with than the opaque and puzzling template language. It will take a bit of reading to understand how to make one, but it's worth it.

Basic Usage Guide for Capiunto

Here's an example infobox:

Module:Infobox_Test
local p = {}
 
function p.default(frame)
	local capiunto = require 'capiunto'
	return capiunto.create( {
		top = tostring(mw.title.getCurrentTitle()),
		topStyle = 'background:#cfc;',
		bottom = frame.args["description"]; -- description
	} )
	:addImage(
		string.format('[[File:%s|200px]]', frame.args["img_url"]), -- featured image
		frame.args["caption"] -- caption
	)
	:addRow('URL', frame.args["url"])
	:addRow('Project Status', frame.args["project_status"])
	:addRow('Archiving Status', frame.args["archiving_status"])
	:addRow('Project Source', frame.args["project_source"])
end

return p
Note: As you see from the infobox call below, it calls the "default" function. You can also have other functions in one module, perhaps for using a smaller infobox (e.g. with no image) when the situation calls for it.
MediaWiki/Editing/Advanced
File:Test.png
This image is a test image that is found on Wikimedia Commons.
URL url
Project Status project status
Archiving Status archiving status
Project Source project source
This is a test of the Infobox system. The description would go here: though maybe it should go on the page instead and only semantic data here.

You can then use this infobox with the following method call, and the example appears on the right:

{{#invoke: Infobox_Test | default 
| description      = This is a test of the Infobox system. The description would go here: though maybe it should go on the page instead and only semantic data here.
| img_url          = test.png
| caption          = This '''image''' is a test image that is found on Wikimedia Commons. 
| url              = url
| project_status   = project status
| archiving_status = archiving status
| project_source   = project source
}}

Cargo (Semantic Infoboxes)

The infoboxes on the Bibliotheca Anonoma are augmented with Cargo, a Semantic Web extension (designed to replace Semantic MediaWiki). This gives the infobox elements the power to be indexed in a semantic metadata database. That way, queries and reports can be made to sort out the data for easier searching.

A full Cargo Cheatsheet can be found here.

Basic Components of a Cargo Subject

A single Cargo subject is made up of a three basic elements:

  1. Template - Defines the table schema.
  2. Table - Indexes the data for queries.
  3. Form - Helps users create a new page with fields for metadata.
  4. Page - Use the form to create a new page.

1. Create a Cargo Template

The Cargo Template defines the table's schema: what kind of columns it has, and how it looks to the user.

2. Create a Cargo Table

  1. Open the Cargo Template you need to create a template for.
  2. Click More at the top right next to the search bar.
  3. Click Create Cargo Table.

The cargo table must be recreated each time the schema is modified in the template.

3. Create a Cargo Form

  1. Go to Special:Forms.
  2. Choose the template to create the form for.
  3. Name the Form with the same base name as the Template. (e.g. for Template:Book, type in Book.)

4. Create a Cargo Page

  1. Go to the page Form:Cargo Title, replacing "Table Title" with the actual title of the cargo subject.
  2. Enter the title of the page you want to create.
  3. Fill out the form. In the "Free Text" box, you can create a normal wikipage.

Creating Templates

Note: Template documentation is set up the same way as in the Arch Wiki: inside <includeonly></includeonly> tags. This is simpler, if less clean than the Wikipedia template documentation, which puts it in a subpage.

When creating a template meant for users to utilize, you should place a {{Template}} header into it.

Note: Templates meant for internal template use only do not need this header.

This template should be added at the very beginning of all template pages between 'noinclude' tags:

<noinclude>
{{Template}}
</noinclude>

Documentation of the template, usage instructions, and output example should also be added between the 'noinclude' tags (as in this template).

The actual template code must be written between 'includeonly' tags:

<includeonly>...</includeonly>