how-to-play-id: Difference between revisions
Jump to navigation
Jump to search
m (→Pedoman) |
m (Replace <entry-title> with {{DISPLAYTITLE:}}) |
||
(2 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
Jika ini kunjungan pertama Anda, harap membaca halaman [[introduction-id|pendahuluan]]. | Jika ini kunjungan pertama Anda, harap membaca halaman [[introduction-id|pendahuluan]]. | ||
{{DISPLAYTITLE:Cara Penggunaan}} | |||
== Pedoman == | == Pedoman == | ||
Sebelum memulai kontribusi dimohon untuk mematuhi pedoman berikut: | Sebelum memulai kontribusi dimohon untuk mematuhi pedoman berikut: | ||
# Anda haru membuat akun sebelum melakukan penyuntingan/menambahkan halaman. Gunakan nama Anda dengan seksama, misalnya PemberianNama (Awal-Akhir), lihat juga [http://en.wikipedia.org/wiki/Wikipedia:Username panduan username Wikipedia]. Anda juga dipersilahkan menggunakan alias (misalnya [[User:Adactio]], [[User:Phae]]). Dimohon untuk tidak menggunakan nama organisasi atau kata benda (misalnya produk, teknologi). | # Anda haru membuat akun sebelum melakukan penyuntingan/menambahkan halaman. Gunakan nama Anda dengan seksama, misalnya PemberianNama (Awal-Akhir), lihat juga [http://en.wikipedia.org/wiki/Wikipedia:Username panduan username Wikipedia]. Anda juga dipersilahkan menggunakan alias (misalnya [[User:Adactio]], [[User:Phae]]). Dimohon untuk tidak menggunakan nama organisasi atau kata benda (misalnya produk, teknologi). | ||
# Baca tentang [[:Category:public_domain_license|Deklarasi Publik | # Baca tentang [[:Category:public_domain_license|Deklarasi Domain Publik]] microformats.org dan silahkan menambah [[Template:cc-public-domain-release]] ke halaman pengguna Anda untuk melepaskan kontribusi Anda kepada microformats.org sebelum 2008 menjadi domain publik. | ||
# Coba terlebih dahulu [http://microformats.org/discuss kanal irc (lebih baik) atau mailing lists] (dan baca halaman [[mailing-lists]] sebelum melalukannya). | # Coba terlebih dahulu [http://microformats.org/discuss kanal irc (lebih baik) atau mailing lists] (dan baca halaman [[mailing-lists]] sebelum melalukannya). | ||
# Jika Anda ingin menuliskan sebuah opini yang bukan alasan logis, tandai dengan username Anda - Anda juga dapat melakukannya dengan mudah dengan datetimestamp pada MediaWiki dengan empat tildes, contohnya: <nowiki>~~~~</nowiki> | |||
#* Pada beberapa kasus hal ini diperlukan ketika mengedit tanda tangan kontribusi lainnya (sebagai lawan dari konten umum), berhati-hatilah untuk tidak mengubah maknanya. | |||
#* Jika pernyataan alasan logis Anda adalah bagian dari diskusi dimana pernyataan tersebut tidak setuju dengan komentar sebelumnya, Anda dapat menandatanganinya dengan username Anda. Namun penandatanganan pernyataan seperti itu tidak diperlukan dan mungkin mengurangi alasan pernyataan logis berdiri sendiri (berkaitan: [[#avoid-personalizing-proposals|avoid personalizing proposals]]) dan dengan demikian dianggap meninggalkan pernyataan tersebut tanpa tanda tangan. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# Please only create pages directly relating to [[POSH]], microformats (and [[picoformats]]) on this wiki. [[data-portability]] in line with microformats [[principles]] is also encouraged. Other pages will likely be deleted. | # Please only create pages directly relating to [[POSH]], microformats (and [[picoformats]]) on this wiki. [[data-portability]] in line with microformats [[principles]] is also encouraged. Other pages will likely be deleted. | ||
# <span id="naming">Please obey the [[naming-conventions| naming conventions]] for pages. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] </span> | # <span id="naming">Please obey the [[naming-conventions| naming conventions]] for pages. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] </span> |
Latest revision as of 16:27, 18 July 2020
Jika ini kunjungan pertama Anda, harap membaca halaman pendahuluan.
Pedoman
Sebelum memulai kontribusi dimohon untuk mematuhi pedoman berikut:
- Anda haru membuat akun sebelum melakukan penyuntingan/menambahkan halaman. Gunakan nama Anda dengan seksama, misalnya PemberianNama (Awal-Akhir), lihat juga panduan username Wikipedia. Anda juga dipersilahkan menggunakan alias (misalnya User:Adactio, User:Phae). Dimohon untuk tidak menggunakan nama organisasi atau kata benda (misalnya produk, teknologi).
- Baca tentang Deklarasi Domain Publik microformats.org dan silahkan menambah Template:cc-public-domain-release ke halaman pengguna Anda untuk melepaskan kontribusi Anda kepada microformats.org sebelum 2008 menjadi domain publik.
- Coba terlebih dahulu kanal irc (lebih baik) atau mailing lists (dan baca halaman mailing-lists sebelum melalukannya).
- Jika Anda ingin menuliskan sebuah opini yang bukan alasan logis, tandai dengan username Anda - Anda juga dapat melakukannya dengan mudah dengan datetimestamp pada MediaWiki dengan empat tildes, contohnya: ~~~~
- Pada beberapa kasus hal ini diperlukan ketika mengedit tanda tangan kontribusi lainnya (sebagai lawan dari konten umum), berhati-hatilah untuk tidak mengubah maknanya.
- Jika pernyataan alasan logis Anda adalah bagian dari diskusi dimana pernyataan tersebut tidak setuju dengan komentar sebelumnya, Anda dapat menandatanganinya dengan username Anda. Namun penandatanganan pernyataan seperti itu tidak diperlukan dan mungkin mengurangi alasan pernyataan logis berdiri sendiri (berkaitan: avoid personalizing proposals) dan dengan demikian dianggap meninggalkan pernyataan tersebut tanpa tanda tangan. [src:A]
- Please only create pages directly relating to POSH, microformats (and picoformats) on this wiki. data-portability in line with microformats principles is also encouraged. Other pages will likely be deleted.
- Please obey the naming conventions for pages. [src:A]
- Don't use talk pages. See #3. [src:A]
- Please try to ensure that you produce valid XHTML.
- When you paste code, add some line breaks at a reasonable width.
- Please do not use "?" or other punctuation in the headings - it helps to keep the URLs to their fragment identifiers shorter and easier to read, copy/paste etc. [src:A]
- Consider using lowercase words in headings (except for proper nouns), and avoid repeating the page title in headings. This helps with shortening permalinks to sections (thereby increasing fidelity of URL transfer, e.g. across email), and keeping their URLs all lowercase makes them easier to type. [src:A]
- Headings may be explicitly marked up with <h1> <h2> tags etc. in order to avoid having them show up / pollute the Table of Contents. If you find such headings in a page, please do not change them to "=" or "==" style headings. [src:A]
- Avoid renaming/changing heading text, including even just their capitalization or to comply with above rules that apply to headings. Headings are often used as permalinks, and changing the heading breaks such permalinks that have already been used. Thus be careful when creating headings. If you change a heading please leave a
<div id="oldheadingID"></div>
around the new heading with oldHeadingID set to the necessary value to maintain heading permalinks.[src:A] - Start headings with a letter (or underscore a letter doesn't work), in order to generate valid ID attributes on heading elements.
- Avoid global editorial wiki changes / edits (e.g. the same or similar edits applied to numerous pages, say, more than a dozen or so pages). If you have an opinion on how to globally improve something stylistically or editorially on the wiki, please add it to your section on the to-do page, and then perhaps ask the community using the microformats-discuss mailing list what folks think of it. Interpret absence of response(s) as disinterest and thus implicit rejection. Admins may from time to time do global wiki changes to remove spam, repair damage done by other global wiki edits etc.[src:A]
- Please avoid simple contradictory responses such as "No" to questions and issues. Instead provide at least a short sentence with a reason which provides information beyond what is provided in the question or issue. Simple contradictions (like just inverting other statements on a page as if such an inversion was an argument), are a waste of time and space and to be avoided.[src:A]
- Do not remove "red links", nor create empty / placeholder "..." pages for them just to make them not red. The red links usefully communicate a need or a desire for that page to exist, and the person expressing that desire may not be the same person that is able to take the time, or has the necessary skill/background to draft such a page. The links to pages not yet created often serve as an effective (and easy to execute) "to do" list. Removing those links makes it harder, less convenient to do so. (One exception noted so far: red links to non-existent microformats e.g. "hbib", should be delinked, as it is desirable for it to be harder/less convenient to create new microformats). Finally, as such links do provide information, they are not redundant. [src:A]
- Please do not add MediaWiki Categories. With the upgrade to the wiki we have begun using a very limited number of categories in order to present specifications and drafts differently than other wiki pages. For now if you think additional Categories would help the community, please make suggestions on the category-suggestions page. [src:TI]. Previously: Do not use the MediaWiki "Categories" mechanism. As with "Talk" pages, this community does not use all the features of MediaWiki.[src:A]
- Do not create new "User:" links by hand. User: links should only created as a result of users actually signing their edits with ~~~ or ~~~~. That way each User: page will correspond to an actual login, rather than accidentally linking to a page which doesn't represent a login. If you see a red link which appears like it should be a User: link, e.g. [[DavidJanes]], rather than editing the link in place, create a redirect at the destination of the link to the person's User: page.[src:A]
- Check "what links here" before moving pages, and fix any links to the page you're moving, if appropriate.
- Please use U.S. English (en-US) spellings of common words on English microformats pages. This is by convention, following the W3C Manual of Style Spelling Editorial Guideline. [src:A]. Exception: Please use and maintain the proper native spellings of proper nouns, e.g. "BT Centre", "Business Design Centre, London, UK", "Centre of Canadian Studies", etc. [src:AD([1])]
- Use templates for RFC 2119 terms such as MUST.
- References to (X)HTML element names should be lowercase and marked up with <code>...</code>, e.g. the
input
element. This convention is adopted from the practice used in the W3C Manual of Style. - Add whitespace to markup examples for readability. Real world markup examples are often whitespace collapsed, often with all the markup/content on a single line of text. Please add whitespace (e.g. returns between elements, indentation to indicate element depth) to markup examples.
- Use example.org for hypothetical URL examples rather than a fake domain name (which may eventually be registered, used for spam etc.). When doing so, be sure to use
<nowiki>
tags, e.g.:<nowiki>http://example.org/</nowiki>
so that the URLs are not auto-hyperlinked by MediaWiki. Where interactions between multiple domains need to be illustrated, you may use example.net or example.com or subdomains of example.org like foo.example.org. - If you notice that someone is iteratively editing a page (say by watching the IRC channel, or the Special:Recentchanges page) that you'd like to edit, consider waiting at least 10 minutes after the most recent edit before doing so, as the person iteratively editing the page may have further edits to make, and thus waiting a few minutes would likely save you both time by avoiding potential/likely edit conflicts. Similarly, if you plan to make multiple edits to a page, consider using Template:inuse by placing {{Template:inuse}} at the head of the page. Please don't forget to remove it, when you're done! [src:A]
- Please do not remove apparently broken links (404 etc.). If you cannot fix them, de-link them using <nowiki> and note (perhaps with a nested list item or parenthetical remark) that the links appear to have stopped working as of a certain date. This way whoever added the links or is responsible for them may discover that they need to fix them, and those researching the links can still look them up in the Internet Archive. [src:A]
- Avoid labeling proposals with people's names. Instead please label a proposal using a summary of some (perhaps unique) technical aspect of the proposal. The reasons for this are to avoid overly "personalizing" an idea and having the idea be judged (positively or negatively) by the author associated with it rather than the merits of the idea itself, to avoid having criticisms of the idea even remotely appear as if they are criticisms of the person, and to avoid having a specific person feel like they must defend attacks on an idea as if they were attacks on their person. [src:A]
- Avoid splitting most pages. Do not split, divide, sub-divide, or otherwise reorganize pages unless you are one of the primary authors of such pages. The reason is that you may not understand what the authors/creators of that page had/have in mind for the organization and growth of the content of the page, and by splitting it or reorganizing it, you might actually cause them more work and inconvenience, as well as raising the barrier to editing and/or contributing to the page for new folks as well, thus discouraging community participation. Admins will likely revert such splits. [src:A([2] [3])]
- If you do see a need to split a page which you are not one of the primary authors of, first add notes in the page in-place where you think splits need to occur, and how you think they should occur, before making any split, so that the primary author(s) have a chance to see and follow-up with refinements/changes on how the pages should be split. When deciding how to split pages, consider doing so in ways that both make it easier for new contributors to add information, making it easier for people to iterate, and making it easier for people looking from a real world perspective to find the information. See how-to-split-pages for more details. [src:A([4])]
- In general, avoid doing large "clean up" operations on the wiki for the same reasons as avoiding splitting most pages. Admins will likely revert such large re-organizations of pages and encourage incremental improvements, and suggesting larger improvements to the primary page authors. [src:A]
Accessibility
- Use upper case for acronyms like HTML but use
<strong style="text-transform:uppercase">
to add strength to phrases like "do not". This improves accessibility for people using text-reading software and other assistive technologies ([5] PDF) (list and versions of text-reading software & other agents affected needed). - Do not use styles or write in ways which contravene Web Content Accessibility Guidelines 1.0. For example, do not rely on color alone to convey information; mark up lists and list items properly.
Membersihkan Wiki
Kunjungi spam-removal.
If you see something which you think needs massive cleanup on the wiki, please point it out to admins on the irc channel or microformats-discuss list rather than doing it yourself. [src:A]
Terkait
- mediawiki-customization - brief notes on how the microformats wiki is different from a "typical" MediaWiki install, in many ways to help with how-to-play and naming-conventions.
- wiki2
- wiki-better-than-email