sona pona

sona pona:Guide: Difference between revisions

Project page Discussion

sona pona:Guide (edit)

Revision as of 16:39, 26 June 2024

1,016 bytes added ,  7 days ago
→‎Be messy
VisualWikitext
No edit summary
 
(20 intermediate revisions by 3 users not shown)
Line 1:
{{Wiki essay}}
{{Shortcut|guideSP:G|SP:GUIDE}}
Welcome, aspiring editor! This work-in-progress guide will hopefully help you get your bearings on the wiki.
 
==What do I do here?==
Any help is welcome—you can even just fix typos—but there are many larger projects you may like to participate in:
{{Needs work|WIP|section}}
 
* makeCreating [[sona ponaProject:Requests|requested pages]], or onesarticles for other things that you know about▼
* even just fix typos
* Writing and expanding [[Project:Word articles|word articles]]
* sources
* Expanding lists of [[media]]
* formatting
* Writing [[:Category:Essays|essays]]
* media
* Adding missing information, especially to [[:Category:Articles needing work|articles marked as needing work]]
▲* make [[sona pona:Requests|requested pages]] or ones you know about
* [[#Source what you can|Adding sources to articles]], especially in [[:Category:Articles with unsourced statements|articles with the <code><nowiki>{{citation needed}}</nowiki></code> template]]
* write essays
* Fixing [[#Formatting|formatting]], especially in [[:Category:Unadapted imported pages|unadapted imported pages]]
* And many more projects tracked in the <code>#{{tok|pali}}</code> forum thread on the [[Project:Discord|Discord server]]
 
==Technical==
 
===Moderation===
Your first edit won't appear immediately and will instead be sent to the moderators for approval. This is to prevent trolls from making new accounts purely to grief the wiki.<ref group="lower-alpha">And if they insist, they'll have to make at least one useful edit per account, which is a net win for us!</ref>
 
==Policy==
 
===Be bold===
{{Hatnote|See also [[{{w:Wikipedia|Project:Be bold|the Wikipedia policy]]}}.}}
{{Shortcut|SP:BOLD}}
 
If you have an idea for an edit or page, but you're not sure whether others will like it, just do it! Everyone can easily bring a page back to a previous version, so it's impossible to permanently "ruin" anything. [[mw:Help:Patrolling|Patrolling]] ensures that every edit will be inspected by at least one other person.
 
===Be messy===
{{Hatnote|See also [https://mspaintadventures.fandom.com/wiki/MSPA_Wiki:Sloppy_is_fine the MS Paint Adventures Wiki policy] and the talk page for this article.}}
 
An unfinished or messy page is infinitely better than no page at all. Even if you never come back to it, [[Special:AncientPages|someone else surely will]].<ref group="lower-alpha">Heck, this very guide started as barely more than an outline!</ref> Slap a <code><nowiki>{{Needs work}}</nowiki></code> template on top and let others work their magic.
 
(But as a corollary, do make the page however good you can, so that others can work off of it as easily as possible.)
 
===Notability===
{{Hatnote|See [[Project:Notability]].}}
 
===Source what you can===
{{Main|Project:Citing sources}}
Unlike topics covered by Wikipedia, there aren't many public reliable sources for Toki Pona. (In fact, this very wiki was made to fill that gap!) As such, it's fine if an article doesn't have any citations, though they're always appreciated (and encouraged for [[Project:lipu pona|{{tp|lipu pona}}]] status). Primary sources are fine, and are even preferable in many cases, such as when tracking the history of a subject.
It might be difficult to find sources, so just source what you can (if anything)! Primary sources are fine. For general information, we have lists of common resources and [[:Category:Citation templates|citation templates]] to use.
 
If you cite anything, please [[Project:Citing sources#Archiving sources|archive it]]! Links to Discord uploads are temporary, and so must be archived.
Potential resources include:
* The ''[[Official Toki Pona]]'' books ({{pu}}, {{ku}}, and {{su}}), if you have them
** Freely available sections, such as the [[Dictionary (pu)|{{tp|pu}} dictionary]], or {{tp|ku}}'s "[[Notes on lipu pu|Notes on {{tp|lipu pu}}]]" section
* Other materials by {{tok|[[jan Sonja]]}}, e.g. [//jan-ne.github.io/tp/tpize the tokiponization guidelines]
* Other [[:Category:Source texts|source texts]] on the wiki
* {{tp|[[lipu Linku]]}}
* Anything listed on the [[Recommended learning resources]] article
* The [[Toki Pona census]]
 
===Details and organization===
When using a proficient speaker's thoughts as a source, remember to note whether they reflect consensus or are rather their personal {{tp|[[nasin]]}}. This includes what you may consider "official" material:
There are some useful rules of thumb for coming up with details to include, and deciding how to organize them.
*'''{{w|Inverted pyramid (journalism)|Inverted pyramid}} style:''' Give important info and "conclusions" first. For example, explain common [[style]]s and prototypical usages before [[:Category:Experimental sections|experiments]].
*'''{{w|Five Ws}} (and H):''' The details "who, what, when, where, why, how" are important background information. If these are missing, you can tag the sentence with <code><nowiki>{{wh|</nowiki>''who?''<nowiki>}}</nowiki></code> or similar.
*'''Follow established layouts:''' You can check articles on similar topics to see how they're laid out and what details they tend to include. (Not a hard rule; some articles do call for unique section headings.)
*'''No {{w|Project:Manual of Style/Trivia sections|trivia sections}}.''' This has a few prongs:
**Put new facts in relevant sections. The lead section counts! If no section fits yet, you can add one&mdash;just make it specific. The heading can be any {{w|noun phrase}}, after all.
**No lists of miscellaneous information. These grow rampant and disorganized into [//tvtropes.org/Administrivia/ThreadMode walls of contradictory points], where even general info becomes impossible for the reader to find.
**Something literally {{wikt|trivial}} ("of little value") need not be on a wiki. (But many "trivia" points sell themselves short, and would be useful if better placed!)
 
===Red links are not bad===
<blockquote>
{{Hatnote|See also {{w|Wikipedia:Red link}}.}}
This is the way I use Toki Pona. {{Indent|—{{tp|pu}}, p. 7}}
{{Shortcut|SP:RED}}
</blockquote>
{{w|MediaWiki#Wikilinks|Red links}} point to [[Special:WantedPages|wanted pages]] that don't exist yet. This is good:
 
*It shows gaps in our knowledge base.
Resources with open submissions, such as [[Tatoeba]] and [[Glosbe]], often attract overconfident beginners and so should be treated with care.
*It helps us keep track of pages to create. (See [[Special:WantedPages]].)
*It prevents pages from starting out [[Special:OrphanedPages|orphaned]].
 
Don't remove red links just for being red links. Only remove one if it wouldn't be reasonable to create a page at that title. (And remember that a page can be a redirect or a [[:Category:Disambiguation pages|disambiguation page]].)
 
===Trans rights===
Line 58 ⟶ 70:
 
===Italics===
{{Shortcut|SP:ITAL}}
Mark emphasized text with <code><nowiki><em>emphasized text</em></nowiki></code>.
 
Line 68 ⟶ 81:
 
===Language===
{{Shortcut|SP:LANG}}
Mark the language of non-English text with [[Template:lang]].
 
{{Indent|This lets technologies like screen readers treat the text according to its language (see [[ISO 639-3]]).}}
{{Indent|<code><nowiki>''{{lang|fr|''je parle bien''}}''</nowiki></code> outputs ''{{lang|fr|''je parle bien''}}''. Hover to see the language name.}}
 
{{Indent|
Line 85 ⟶ 99:
 
==={{tp|sitelen pona}}===
{{Shortcut|SP:SP}}
Display {{tp|[[sitelen Lasina]]}} or [[UCSUR]] codepoints as {{tp|[[sitelen pona]]}} with [[Template:sp]].
 
Line 103 ⟶ 118:
 
===Citations===
{{Hatnote|See {{sect|Project:Citing sources#Formatting}}.}}
Citations are wrapped in <code>[[mw:Help:Cite|<nowiki><ref>…</ref></nowiki>]]</code> tags. Any page with citations should have a references section at the end:
<syntaxhighlight lang="html+handlebars">
==References==
<references />
</syntaxhighlight>
 
There are many [[:Category:Citation templates|citation templates]] for different media, sites, and even specific sources that are frequently cited. Most sources will probably be cited with [[Template:cite web]] and derivatives, [[Template:cite pu]], and [[Template:cite ku]].
 
Please consider archiving a source with the [//web.archive.org/save Wayback Machine] or [//archive.is archive.is]. This is especially necessary for Discord uploads; unarchived links will start to expire so that the files can only be accessed through Discord, which requires knowing where it was originally uploaded. {{Indent|
You can add a JavaScript {{w|bookmarklet}} to quickly archive a webpage to the Wayback Machine. Create a bookmark and set this as the "URL":
<syntaxhighlight lang="javascript" line="1" start="1">
javascript:void(location.href='https://web.archive.org/save/'+location.href);
</syntaxhighlight>
Then, whenever you press the bookmarklet, a snapshot of the currently viewed webpage will be saved.
}}
 
===Notice templates===
SeveralThere are several <span class="plainlinks">[{{fullurl:Special:WhatLinksHere/Template:Notice|namespace=10&hidelinks=1&hideredirs=1}} notice templates]</span> that should be used to tell the reader about the nature of an article's topic, such as if it pertains to an unusual [[style of Toki Pona]]. We don't want to mispresent nonstandard features as common if they aren't widely understood or accepted.
 
===Maintenance templates===
If you find an issue with an article and can't fix it yourself, or not immediately, add a maintenance template. These include:
*[[Template:citation needed]]
*[[Template:dead link]]
*<span class="plainlinks">[{{fullurl:Special:WhatLinksHere/Template:Issue|namespace=10&hidelinks=1&hideredirs=1}} All templates derived from Template:Issue]</span>
 
Line 137 ⟶ 139:
==Notes==
<references group="lower-alpha"/>
{{Project}}
Retrieved from "https://sona.pona.la/wiki/Special:MobileDiff/11998...18097"