Electowiki:The electowiki handbook: Difference between revisions

Making it possible to link to Electowiki:Manual of Style by adding a #Style section (and I'll be adding a redirect after saving this)
(image annotations)
(Making it possible to link to Electowiki:Manual of Style by adding a #Style section (and I'll be adding a redirect after saving this))
 
(24 intermediate revisions by 2 users not shown)
Line 1:
{{ambox|text=As of Monday, June 15, 2020, this page is now known as the '''The electowiki handbook'''. I came up with this name as I was trying to rewrite [[Help:Contents]] and other "Help" pages on this wiki. There's a lot more documentation work to do on this wiki, but we should take baby steps.-- [[User:RobLa|RobLa]] ([[User talk:RobLa|talk]]) 01:17, 16 June 2020 (UTC)}}
Electowiki runs on the MediaWiki engine, just like Wikipedia and many other wikis, so for help with basic markup and editing, you can consult existing pages on those topics:
 
:''parent: [[Help:Contents]]
 
This page is "''[[The electowiki handbook]]''" ([[Electowiki:The electowiki handbook]]). If you are new here, and you don't understand terms like "MediaWiki", "Wikipedia" or "wiki markup" please see '''[[Help:Contents]]'''. Once you have done that, then this page might be helpful.
 
If you have read [[Help:Contents]], and you want to learn more, please keep reading!
 
 
==About==
:''main page: [[Electowiki:About]]''
 
'''electowiki''' is a [[wiki]] which tries to make a plethora of [[electoral systems]] more understandable for [[advocacy|advocates]] of electoral reform. It has existed since 2005, and still enjoys frequent updates. We attempt to learn from online discussions in a number of [[forum]]s, helping new participants more quickly get up to speed, and summarize the conclusions of many different discussions.
 
'''electowiki''' has a long history, divided into two phases: the "[[Electorama wiki]]" phase and the [[electowiki]] phase. There are wiki pages describing each of them.
 
* '''[[Project:About Electorama wiki]]''' - This page describes the [[Electorama wiki]] phase (note the uppercase "E"). It started in 2005 and historians will hopefully say it more-or-less ended in 2018. It was the phase prior to [[Miraheze]] hosting it. It was an instance of [[MediaWiki]] that [[User:RobLa]] started hosting as an offshoot of the [[Electorama]] project.
* '''[[Project:About electowiki]]''' - this was the "[[electowiki]]" phase (2018-now) - the current phase as of this writing in June 2020. This started around the time that [[User:psephomancy]] migrated the [[Electorama wiki]] over to [[Miraheze]] (sometime in 2018). See [[electowiki:About]] to learn about this phase.
 
== Wiki ==
:''main: [[Help]]''
Electowiki''electowiki'' runs on the [[MediaWiki]] engine, just like Wikipedia and many other wikis[[wiki]]s, so for help with basic markup and editing, you can consult existing pages on those topics:
 
* [[Mw:Help:Contents|MediaWiki help contents]]
* Wikipedia's [[W:Wikipedia:Tutorial/Editing|Editing tutorial]]
 
To practice using wiki markup, please use [[Electowiki:Sandbox|the sandbox]].
The rest of this page is for help with Electowiki-specific features (or lack thereof).
 
See '''[[Help]]''' for more about editing a wiki, or for specific information about [[MediaWiki]].
 
== Style ==
{{Wikipedia|Wikipedia:Manual of Style}}
''electowiki'' uses a style as similar as possible to English Wikipedia. Best practices for formatting articles generally follow the same rules as [[W:Wikipedia:Manual of Style|Wikipedia's Manual of style]]. This covers the rules for bolding key words in article intros, using sentence case for article titles and headings, using written-out titles instead of abbreviations, which order to put article sections, etc. We may make our own amendments to this if necessary. As of 2022-11-11, the most active administrator on this wiki believes other editors should follow [[W:Wikipedia:Manual of Style|Wikipedia's Manual of style]] almost verbatim.
 
== Automatic citations ==
WikipediaThe has[[Mw:Citoid|Citoid theextension]] abilityis tonow enabled, and should automatically generate a citation fromwhen you give it a unique identifier., such Weas don't havea that functionality (yet?)URL, soISBN youror options are:DOI.
 
If it doesn't work in some case, you can try one of these other options:
 
# Enter your URL or unique identifier into [https://tools.wmflabs.org/citer/citer.fcgi Citer] and it will generate wiki markup for a citation that you can copy and paste into the article.
# Open [[Wikipedia:Sandbox|Wikipedia's Sandbox]] and use their citation generator tool to create a citation, then copy and paste into the article. Copying from VisualEditor to VisualEditor works.
# Fill out the citation template manually
 
(Note that Citoid generates dates in the form YYYY-MM, but the citation templates can't handle these, because they are ambiguous with week number format. You can convert them to another month format or just add another <code>-01</code> to the end, to make it a complete date.)
 
== Images ==
Line 26 ⟶ 57:
 
[[File:Voting system Euler diagram.svg|340x340px|alt=]]
 
To add annotations to an image, click the image to view its description page, and then click the "Add a note" button underneath.
 
== Video ==
Line 37 ⟶ 70:
 
See [[mw:Extension:YouTube]] for more information.
 
<!-- Video files can't be transcluded from Commons? [[File:Commercial-LBJ1964ElectionAdDaisyGirl.ogv|thumb]] doesn't work in preview? -->
 
== Dynamic page Lists ==
The [[mw:Extension:DynamicPageList3]] extension is enabled, which can generate lists of pages using many different criteria. One application is to put voting methods into categories according to their properties, and then generate lists of methods that have certain properties. For example, a list of cardinal, proportional voting methods can be generated using this markup:
<pre><DPL>
category = **Cardinal voting methods
category = **Proportional voting methods
</DPL></pre>
 
<DPL>
category = **Cardinal voting methods
category = **Proportional voting methods
</DPL>
 
The two asterisks mean that two levels of subcategories will also be included. It is not possible to include more sub-levels than two, unfortunately.
 
A complete '''[http://help.gamepedia.com/Extension:DPL3/Manual manual]''' is available with full parameter documentation.
==Categories==
We have a category hierarchy for articles starting at [[:Category:Contents]]. Please put new articles in appropriate categories, especially articles about voting methods. If you write an article about a Condorcet-compliant ranked method, put it in [[:Category:Condorcet methods]], for instance. Generally an article should be placed in a more-specific child category and not in its parent, even if the parent also applies. So a Condorcet method does not need to be placed in [[:Category:Preferential voting methods]], for instance, since that is already implied by being in [[:Category:Condorcet methods]].
 
== Templates ==
 
Templates are one of the most complicated aspects of [[MediaWiki]]. See [[Special:PrefixIndex/Template:]] for a full list of templates on this wiki.
 
=== Election-related templates ===
When writing an official definition of a voting method, place it in a [[Template:Definition|definition template]]:<syntaxhighlight>
{{definition|
If every voter's preference between X and Y remains unchanged, then the group's preference between X and Y will also remain unchanged with the addition of a new candidate
}}
</syntaxhighlight>
 
Currently this just produces a block quote:
 
{{definition|
If every voter's preference between X and Y remains unchanged, then the group's preference between X and Y will also remain unchanged with the addition of a new candidate
}}
 
but we might make this prettier in the future, which would affect all instances of the template simultaneously. Discuss any formatting suggestions on [[Template talk:Definition]].
 
Similarly, the usual "list of ranked ballots" format can be placed in a [[Template:Ballots|Ballots]] template:
 
<syntaxhighlight>
{{Ballots|
3: A>B>C
4: B>A>C
2: C>A>B
}}
</syntaxhighlight>
 
{{Ballots|
3: A>B>C
4: B>A>C
2: C>A>B
}}
 
and likewise, style suggestions can be made on [[Template talk:Ballots]]
 
 
[[Category:electowiki]]
[[Category:Help]]