sona pona

sona pona:Guide: Difference between revisions

Project page Discussion

sona pona:Guide (edit)

Revision as of 16:39, 26 June 2024

1,310 bytes removed ,  7 days ago
→‎Be messy
VisualWikitext
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 1:
{{Wiki essay}}
{{Shortcut|SP:G|SP:GUIDE}}
Welcome, aspiring editor! This work-in-progress guide will hopefully help you get your bearings on the wiki.
 
Line 16:
 
==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.)
===Source what you can===▼
{{Shortcut|SP:CITE}}
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.
 
===Notability===
Potential resources include:
{{Hatnote|See [[Project:Notability]].}}
* 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
* Anything listed on the [[Recommended learning resources]] article
* The [[Toki Pona census]]
* {{tok|[[Linku]]}} <em>if necessary</em>; it does not cite its own sources (such as {{tp|[[nimi ale pona]]}}), so more direct citations are preferred. (Some other dictionaries like {{tok|[[nimi.li]]}} are forks of {{tok|Linku}}, and still lack sources regardless.)
 
▲===Source what you can===
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:
{{Main|Project:Citing sources}}
 
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.
<blockquote>
This is the way I use Toki Pona. {{Indent|—{{tp|pu}}, p. 7}}
</blockquote>
 
If you cite anything, please [[Project:Citing sources#Archiving sources|archive it]]! Links to Discord uploads are temporary, and so must be archived.
Resources with open submissions, such as [[Tatoeba]] and [[Glosbe]], often attract overconfident beginners and so should be treated with care.
 
===Details and organization===
See also {{sect|#Citations|#Formatting#Citations}}.
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===
Line 89 ⟶ 85:
 
{{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 122 ⟶ 118:
 
===Citations===
{{Hatnote|See {{sect|Project:Citing sources#Formatting}}.}}
{{Shortcut|SP:REF}}
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]].
 
Miraheze currently doesn't support Citoid, which automatically handles citation formatting on sites like Wikipedia. Instead, you can use an external tool, such as:
* [https://citer.toolforge.org/ Citer] (simplest to use)
* [https://refill.toolforge.org/ng/ reFill NG] (good for mass conversion; add a dummy title, click "Use custom wikicode", paste links within <code><nowiki><ref>…</ref></nowiki></code> tags)
* See more at [[wikipedia:Help:Citation tools]]
 
To prevent [[link rot]], please consider <strong>archiving a source</strong> 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===
Line 163 ⟶ 139:
==Notes==
<references group="lower-alpha"/>
{{Project}}
Retrieved from "https://sona.pona.la/wiki/Special:MobileDiff/13707...18097"