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)
(add MoS and Citoid)
(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))
 
(20 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]].
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, though.
 
See '''[[Help]]''' for more about editing a wiki, or for specific information about [[MediaWiki]].
 
== Style ==
The rest of this page is for help with Electowiki-specific features (or lack thereof).
{{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, thoughthe 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 ==
The [[Mw:Citoid|Citoid extension]] is now enabled, and should automatically generate a citation when you give it a unique identifier, such as a URL, ISBN or DOI.
Wikipedia has the ability to automatically generate a citation from a unique identifier. While we've [[Mw:Citoid|enabled this functionality]], it doesn't work for all sources yet, so you may have to use one of these other options:
 
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 58 ⟶ 87:
 
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]]