MediaWiki/Editing: Difference between revisions

From Bibliotheca Anonoma
No edit summary
 
(36 intermediate revisions by the same user not shown)
Line 1: Line 1:
The Bibliotheca Anonoma Wiki has special features and extensions that editors can make use of.
The Bibliotheca Anonoma Wiki has special features and extensions that editors can make use of.


== Cargo (Semantic Infoboxes) ==
There are also more advanced features that can be utilized, found in this guide: [[MediaWiki/Editing/Advanced]].


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.
== Miscellaneous Templates ==


=== Basic Components of a Cargo Subject ===
* [[Template:Quotation]] - Quotes in a little textbox, with author and publication specifiable.
* [[:Category:Color Templates|Color Templates]] - Color templates you can use to give text different colors.
* [[Special:Interwiki]] - You can have interwiki links to related pages on other wikis or websites: {{ic|<nowiki>[[mw:Help:Editing Pages]]</nowiki>}}. Ask an admin if you want to create more.
** The Know Your Meme interwiki link uses subdirectories under the main {{ic|/memes}} directory, so if it were {{ic|/memes/subcultures/association-football}}, use {{ic|<nowiki>{{kym:subcultures/association-football}}</nowiki>}}.


A single Cargo subject is made up of a three basic elements:
=== 4chan Templates ===


# '''Template''' - Defines the table schema.
* [[Template:Greentext]]/[[Template:Gt]] - If you have greentext from 4chan, just copy and paste, enclose the lines with this template and it will look perfect.
# '''Table''' - Indexes the data for queries.
** [[Template:GreentextTalk]]/[[Template:Gtt]] - Use greentext in a single line without having to add an arrow. Meant for comments on talk pages or image captions.
# '''Form''' - Helps users create a new page with fields for metadata.
* [[Template:Fortune]] (proposed) - Using the [https://www.mediawiki.org/wiki/Extension:RandomSelection RandomSelection] extension, randomly display a line from a preset array. Could be used to resurrect the 4chan fortunes function: or provide BSD-style fortunes.
# '''Page''' - Use the form to create a new page.


=== 1. Create a Cargo Template ===
== Code ==


The Cargo Template defines the table's schema: what kind of columns it has, and how it looks to the user.
* Use [[Template:bc]] for block code without line numbers.
* Use [[Template:lc]] for block code with line numbers.
* Use [[Template:hc]] for block code with header.
* Use [[Template:ic]] for inline code.


=== 2. Create a Cargo Table ===
=== Inline Code ===


# Open the Cargo Template you need to create a template for.
You can use {{Ic|inline code}} here:
# 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.
<pre>
{{Ic|your inline code}}
</pre>
 
If there are errors, enclose your code in nowiki blocks.
 
<pre>
{{Ic|&lt;nowiki&gt;Weird HTML block code here: <p></p>&lt;/nowiki&gt;}}
</pre>
 
=== Block Code ===
 
Block code can just be indented with spaces to turn them into monospaced blocks with no text wrapping.
 
You can also avoid adding spaces by using [[Template:Bc]] (or [[Template:Lc]] for line numbers):
 
<pre>{{bc|
block
code
}}</pre>
 
{{bc|
block
code
}}


=== 3. Create a Cargo Form ===
By specifying the language to use, you can get syntax highlighting as well. Here's a [[mw:Extension:SyntaxHighlight#Supported_languages|long list of supported languages.]]


# Go to [[Special:Forms]].
<pre>{{Bc|
# Choose the template to create the form for.
# says hello
# Name the Form with the same base name as the Template. (e.g. for <code>Template:Book</code>, type in <code>Book</code>.)
print "hello world"


=== 4. Create a Cargo Page ===
# says goodbye
print "goodbye world"
|lang=python}}</pre>


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


== Creating Templates ==
# says goodbye
print "goodbye world"
|lang=python}}


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


{{Note|Templates meant for internal template use only do not need this header.}}
=== Code with Header ===


This template should be added at the very beginning of all template pages between 'noinclude' tags:
{{Note|Header code is currently not highlighted and may need nowiki tags, but we're working on it.}}
 
Just like on the Arch Wiki, it might be useful to provide a header to the code to state a filename or something.
 
{{hc|/path/to/filename.sh|<nowiki>
# The content of a file is included here.
echo "Hello World"
</nowiki>}}


<pre>
<pre>
<noinclude>
{{hc|/path/to/filename.sh|&lt;nowiki&gt;
{{Template}}
# The content of a file is included here.
</noinclude>
echo "Hello World"
&lt;/nowiki&gt;}}
</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).
=== Advanced Block Code ===
 
The [[mw:Extension:SyntaxHighlight_GeSHi#Usage|SyntaxHighlight Extension]] is utilized in the code formatting templates above, but you can use it directly to make use of special features.
 
<syntaxhighlight lang="python" line='line'>
def quickSort(arr):
less = []
pivotList = []
more = []
if len(arr) <= 1:
return arr
else:
pass
</syntaxhighlight>
 
<pre><nowiki>
<syntaxhighlight lang="python" line='line'>
def quickSort(arr):
less = []
pivotList = []
more = []
if len(arr) <= 1:
return arr
else:
pass
</syntaxhighlight>
</nowiki></pre>


The template wikitext must be written between 'includeonly' tags:
== Uploading Files ==


<pre>
You can upload images, pdfs, or webms (strongly preferred over gif, please convert) for media that is closely tied to the wiki at [[Special:Upload]]. You can even upload multiple files using [[Special:BatchUpload]]. File size limit is 50MB.
<includeonly>...</includeonly>
 
</pre>
=== Some Files Go on Eikonos ===
 
{{#eimage:https://img.bibanon.org/data/image/4c/4a/4c4a18aeb28ad5bff49ab24664627562.jpg|200x100px|thumb|inline|Eikonos image embed test.}}
 
Some ''media is interesting in itself'', such as screencaps, greentext, and reaction images. [https://img.bibanon.org Eikonos] is our image tag database system that works as an online museum gallery to sort and organize our large collection of images.
 
These should be posted to Eikonos and linked back here instead. The exact size of the preview must be specified. See the syntax below, and an example to the right.
 
<pre>{{#eimage:https://img.bibanon.org/data/image/4c/4a/4c4a18aeb28ad5bff49ab24664627562.jpg|200x100px|thumb|inline|Eikonos image embed test.}}</pre>
 
=== Embedding Videos or Music ===
 
Use the [[mw:Extension:EmbedVideo|EmbedVideo]] extension to embed YouTube videos and such.
 
== Categories ==
 
Categories are crucial to the organization of data on this wiki. Despite their name, they function similarly to tags: they can be user generated and pages can have multiples of them.
 
Subcategories are easily made by marking a parent category in a category page. https://commons.wikimedia.org/wiki/Commons:How_to_create_new_categories_or_subcategories
 
* In the editor, at least on a desktop, there is a MsCatSelect system allowing you to visually choose which categories to apply from a combobox (whereas the manual way requires you to think them up).
* Dynamic Page List can also be used to produce a list of pages matching a certain category.
* Category Functions can be used in tables showing pages with columns marking which ones are in which categories.
 
== Adding Images ==
 
=== Adding External Images ===
{{#eimage:YH1xBez|800px|thumb|float|Downloading the entire internet via dialup.}}
 
While it is much better to upload images to this wiki to prevent dead links, in some cases you can use an [[mediawikiwiki:Extension:EImage|EImage]] link to embed an external image, such as from Eikonos, and in rare cases, Imgur or Flickr. An example is shown on the right.
 
In general, the external image format is as follows. More details can be found at the [[mediawikiwiki:Extension:EImage|EImage Documentation.]] Imgur IDs can be used straight up.
 
{{bc|<nowiki>
{{#eimage:your_url_or_id|options|caption}}
</nowiki>}}
 
== Table Design ==
 
You might find it useful to have table column coloring templates, which can highlight table cells with some text. [[wp:Category:Unified_table_cell_templates]]
 
See [[wp:Template:Yes#Templates|this guide]] for usage instructions. Note that templates that are not yet on the wiki need to be copied over to work.
 
== Citing and Archiving Sources ==
 
All URLs that you post should be archived, in case they ever go down or suffer link rot.


{{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.}}
This handy form and API from our sister project provides an easy way to archive through all three known public URL scraping systems. This way when we see a URL, we will not lose it. http://archivenow.memestudies.org


== Design Models ==
== Design Models ==
Line 66: Line 175:
The Bibliotheca Anonoma is descended from various model wikis that templates were directly copied from, or otherwise inspired the MediaWiki instance.
The Bibliotheca Anonoma is descended from various model wikis that templates were directly copied from, or otherwise inspired the MediaWiki instance.


* Arch Wiki - The code templates and Note boxes are inherited from here.
* Arch Wiki - The code templates, template documentation system, and Note boxes are inherited from here.
* Chakra Wiki - The i18n templates are inherited from here. We would prefer to use the Translate extension instead, but it has no support for PostgreSQL. Maybe when we need it we will switch to MariaDB.
* [http://wiki.travellerrpg.com/Special:CargoTables Traveller RPG Wiki] - The cargo templates are heavily influenced by their implementation here.
* Tanasinn.info - Their VIP quality templates are just plain hilarious.
* Tanasinn.info - Their VIP quality templates are just plain hilarious.
* Wikimedia - Lua templates and other complex templates are imported from the less complex Mediawiki instances at the Wikimedia Foundation.
** Templates from Wikipedia are generally avoided since they tend to be significantly more complex to provide all features for its broad userbase.

Latest revision as of 19:20, 2 September 2018

The Bibliotheca Anonoma Wiki has special features and extensions that editors can make use of.

There are also more advanced features that can be utilized, found in this guide: MediaWiki/Editing/Advanced.

Miscellaneous Templates[edit]

  • Template:Quotation - Quotes in a little textbox, with author and publication specifiable.
  • Color Templates - Color templates you can use to give text different colors.
  • Special:Interwiki - You can have interwiki links to related pages on other wikis or websites: [[mw:Help:Editing Pages]]. Ask an admin if you want to create more.
    • The Know Your Meme interwiki link uses subdirectories under the main /memes directory, so if it were /memes/subcultures/association-football, use {{kym:subcultures/association-football}}.

4chan Templates[edit]

  • Template:Greentext/Template:Gt - If you have greentext from 4chan, just copy and paste, enclose the lines with this template and it will look perfect.
  • Template:Fortune (proposed) - Using the RandomSelection extension, randomly display a line from a preset array. Could be used to resurrect the 4chan fortunes function: or provide BSD-style fortunes.

Code[edit]

Inline Code[edit]

You can use inline code here:

{{Ic|your inline code}}

If there are errors, enclose your code in nowiki blocks.

{{Ic|<nowiki>Weird HTML block code here: <p></p></nowiki>}}

Block Code[edit]

Block code can just be indented with spaces to turn them into monospaced blocks with no text wrapping.

You can also avoid adding spaces by using Template:Bc (or Template:Lc for line numbers):

{{bc|
block
code
}}
block
code

By specifying the language to use, you can get syntax highlighting as well. Here's a long list of supported languages.

{{Bc|
# says hello
print "hello world"

# says goodbye
print "goodbye world"
|lang=python}}
# says hello
print "hello world"

# says goodbye
print "goodbye world"


Code with Header[edit]

Note: Header code is currently not highlighted and may need nowiki tags, but we're working on it.

Just like on the Arch Wiki, it might be useful to provide a header to the code to state a filename or something.

/path/to/filename.sh
# The content of a file is included here.
echo "Hello World"
{{hc|/path/to/filename.sh|<nowiki>
# The content of a file is included here.
echo "Hello World"
</nowiki>}}

Advanced Block Code[edit]

The SyntaxHighlight Extension is utilized in the code formatting templates above, but you can use it directly to make use of special features.

def quickSort(arr):
	less = []
	pivotList = []
	more = []
	if len(arr) <= 1:
		return arr
	else:
		pass
<syntaxhighlight lang="python" line='line'>
def quickSort(arr):
	less = []
	pivotList = []
	more = []
	if len(arr) <= 1:
		return arr
	else:
		pass
</syntaxhighlight>

Uploading Files[edit]

You can upload images, pdfs, or webms (strongly preferred over gif, please convert) for media that is closely tied to the wiki at Special:Upload. You can even upload multiple files using Special:BatchUpload. File size limit is 50MB.

Some Files Go on Eikonos[edit]

{{#eimage:https://img.bibanon.org/data/image/4c/4a/4c4a18aeb28ad5bff49ab24664627562.jpg%7C200x100px%7Cthumb%7Cinline%7CEikonos image embed test.}}

Some media is interesting in itself, such as screencaps, greentext, and reaction images. Eikonos is our image tag database system that works as an online museum gallery to sort and organize our large collection of images.

These should be posted to Eikonos and linked back here instead. The exact size of the preview must be specified. See the syntax below, and an example to the right.

{{#eimage:https://img.bibanon.org/data/image/4c/4a/4c4a18aeb28ad5bff49ab24664627562.jpg|200x100px|thumb|inline|Eikonos image embed test.}}

Embedding Videos or Music[edit]

Use the EmbedVideo extension to embed YouTube videos and such.

Categories[edit]

Categories are crucial to the organization of data on this wiki. Despite their name, they function similarly to tags: they can be user generated and pages can have multiples of them.

Subcategories are easily made by marking a parent category in a category page. https://commons.wikimedia.org/wiki/Commons:How_to_create_new_categories_or_subcategories

  • In the editor, at least on a desktop, there is a MsCatSelect system allowing you to visually choose which categories to apply from a combobox (whereas the manual way requires you to think them up).
  • Dynamic Page List can also be used to produce a list of pages matching a certain category.
  • Category Functions can be used in tables showing pages with columns marking which ones are in which categories.

Adding Images[edit]

Adding External Images[edit]

{{#eimage:YH1xBez|800px|thumb|float|Downloading the entire internet via dialup.}}

While it is much better to upload images to this wiki to prevent dead links, in some cases you can use an EImage link to embed an external image, such as from Eikonos, and in rare cases, Imgur or Flickr. An example is shown on the right.

In general, the external image format is as follows. More details can be found at the EImage Documentation. Imgur IDs can be used straight up.

{{#eimage:your_url_or_id|options|caption}}

Table Design[edit]

You might find it useful to have table column coloring templates, which can highlight table cells with some text. wp:Category:Unified_table_cell_templates

See this guide for usage instructions. Note that templates that are not yet on the wiki need to be copied over to work.

Citing and Archiving Sources[edit]

All URLs that you post should be archived, in case they ever go down or suffer link rot.

This handy form and API from our sister project provides an easy way to archive through all three known public URL scraping systems. This way when we see a URL, we will not lose it. http://archivenow.memestudies.org

Design Models[edit]

The Bibliotheca Anonoma is descended from various model wikis that templates were directly copied from, or otherwise inspired the MediaWiki instance.

  • Arch Wiki - The code templates, template documentation system, and Note boxes are inherited from here.
  • Traveller RPG Wiki - The cargo templates are heavily influenced by their implementation here.
  • Tanasinn.info - Their VIP quality templates are just plain hilarious.
  • Wikimedia - Lua templates and other complex templates are imported from the less complex Mediawiki instances at the Wikimedia Foundation.
    • Templates from Wikipedia are generally avoided since they tend to be significantly more complex to provide all features for its broad userbase.