Editing MediaWiki/Editing/Advanced

Some advanced features are supported on this wiki.

== 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 [[mediawikiwiki:Extension:Cargo/Other documentation|Cargo Cheatsheet can be found here.]]

=== Basic Components of a Cargo Subject ===

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

# '''Infobox''' - Defines an infobox that holds all the metadata on the right side of an article.
# '''Template''' - Defines the table schema.
# '''Table''' - Indexes the data for queries.
# '''Form''' - Helps users create a new page with fields for metadata.
# '''Page''' - Use the form to create a new page.

=== 1. Creating Infoboxes ===

Infoboxes are created using [[mediawikiwiki:Extension:Capiunto|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.

[[mediawikiwiki:Extension:Capiunto/Infobox/Basic_usage|Basic Usage Guide for Capiunto]]

Here's an example infobox:

{{hc|Module:Infobox_Test|<nowiki>
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
</nowiki>}}

{{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.}}

{{#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
}}

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

{{bc|<nowiki>
{{#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
}}
</nowiki>}}

{{Note|When documenting the Lua module, you must use the provided subpage under /doc, unlike our documentation standard for templates. This is because the lua code does not provide any wikitext processing.}}

Now, you need to integrate the infobox into the Cargo template.

=== 2. 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.

Just go here to create a cargo template visually: [[Special:CreateTemplate]]

Make sure to add a category in the template's includeonly tags with the same name as the template. This will be crucial in allowing the "Edit with Form" tab to appear.

For good examples, check out the [http://wiki.travellerrpg.com/Special:CargoTables Traveller Wiki's Cargo Tables.]

Use the infobox you made in the previous step to show the data in this cargo template.

=== 3. Create a Cargo Table ===

{{Warning|Make sure the [[mw:Manual:Job_queue|job queue]] is flushed after you create (and each time you edit) a Cargo Template, otherwise '''Create Cargo Table''' won't appear, or an outdated table schema will be used. Contact the administrator for more details.}}

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

The cargo table must be recreated each time the schema is modified in the template. See the [[mw:Special:MyLanguage/Extension:Cargo/Storing_data#Creating_or_recreating_a_table|Cargo Documentation]] for further details.

=== 4. Create a Cargo Form ===

# Go to [[Special:CreateForm]].
# Choose the template to create the form for.
# Change or capitalize the titles of each column, and add {<code>cargo table=ThisTable|cargo field=this_cargo_field</code> to the end of each link.
#* If the fields are insufficient for your needs, you can check the [[mw:Extension:PageForms]] documentation on how to add more input types.
# Name the Form with the same base name as the Template. (e.g. for <code>Template:Book</code>, type in <code>Book</code>.)
# To get an [[mw:Extension:Page_Forms/The_"edit_with_form"_tab|Edit with Form tab]], set up a default form in your template's category page (e.g. for [[Template:Fangame]], [[:Category:Fangame]]) by adding this code to the top of it:
#* <code><nowiki><span style="display:none">{{#default_form:YourFormName}}</span></nowiki></code>

For good, detailed examples of Cargo Forms, check out the [http://absitomen.com/wiki/index.php?title=Form:Character&action=edit Absit Omen Lexicon Wiki].

=== 5. Create a Cargo Page ===

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

{{Note|If you ever recreate the Cargo table and you have existing pages, the older pages will not appear until those pages get edited: this launches a process in the job queue.}}

== Creating Templates ==

{{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.}}

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

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

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

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:

<pre>
<includeonly>...</includeonly>
</pre>