How to Play
Jump to navigation
Jump to search
初めての方はMicroformatsの手引きをご覧ください。
Please also review the in-progress how-to-play-2 page and provide feedback on it!
ガイドライン
協力する前にこれらのガイドラインを読んでください。また、この内容は遵守してください。
- ページを編集したり作成したりする前にアカウントを作成してください。Please consider using your name, e.g. GivenFamily (FirstLast). Wikipedia Username guidelines もご覧ください。You may use an alias (e.g. User:Adactio, User:Phae). Please do not use organization names or other proper nouns (e.g. products, technologies).
- microformats.orgのPublic Domain Declarationsをご覧ください。そして、Template:public-domain-releaseを自分のユーザーページに追加して、あなたのmicroformats.orgサイトへの2008年以前の貢献をパブリック・ドメインへ解放することも検討してみてください。
- はじめにIRCチャンネル(こちらがお勧め)か、メーリングリストに参加してみてください。(その前にはmailing-listsを読んで下さい)
- もし、論理的な理由を越えて何か意見を書いたならば、あなたのユーザ名も一緒に書いてください。- これはMediaWikiのdatetimestampを使って簡単にできます。4つの半角「~」を以下のように並べます: ~~~~
- On the few occasions when it is necessary to edit others signed contributions (as opposed to general content), take care not to change their meaning.
- If your logically reasoned statement is part of a discussion which disagrees with a previous comment, you may sign it with your username. However signing such statements is both not required, and may detract from the logically reasoned statement standing on its own (related: avoid personalizing proposals), and thus consider leaving such statements unsigned. [src:A]
- このWikiには、POSHやmicroformats(とpicoformats)に直接関係あるページだけを作成してください。data-portability in line with microformats principles is also encouraged. 無関係なページは削除されます。
- ページの命名規則に従ってください。[src:A]
- Wikiのページで会話をしてはいけません。その用途には#3で挙げたmailing listsを使ってください。[src:A]
- 妥当なXHTMLで記述するようにしてください。
- ソースコードを貼りつける場合、適当な長さで改行を入れてください。
- 見出しに「?」や句読点記号を入れないでください。これは、URLのフラグメント識別子(リンクのターゲットを表す部分)を短くすることにより、可読性を高めたり、コピー&ペーストなどをしやすくするためです。[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]
- 目次に表示させたくない見出しには <h1> タグや <h2> タグなどを使ってもかまいません。こういったタグを見つけても、「=」 や 「==」 などを使ったスタイルの見出しに変更しないでください。[src:A]
- 見出しのテキストを変更しないようにしてください(大文字と小文字間の変換や、上記のルールに従おうとするための変更も含む)。見出しはパーマリンクとして使われることが多いため、変更によって他で使われているリンク切れなどをひき起こす可能性があります。これらをふまえ、見出しをつける場合は注意して言葉を選んでください。どうしても変更が必要な場合、
<div id="oldheadingID"></div>
というコードで新しい見出しを囲み、"oldHeadingID" の部分を見出しパーマリンクを残すために必要な値にすることで、リンク切れを防ぐことはできます。[src:A] - Start headings with a letter (or underscore a letter doesn't work), in order to generate valid ID attributes on heading elements.
- 当Wiki全体に関する変更や編集(例: 10数ページ以上のページに影響する編集など)を行わないでください。もしWiki全体のスタイルや編集のやり方を改善できるような意見があるようでしたら、その内容をto-doページの該当セクションに追加した上で、メーリングリストなどを使ってコミュニティの他のメンバーがどう思うか聞いてみましょう。返事がない場合は、あまり興味がない、つまり暗黙的な却下というふうに理解してください。ただしWiki管理人は、スパム削除や他の編集によって壊れた部分の修正などのために、Wiki全体に関わる変更を加えることがあります。[src:A]
- 質問や問題提議に対し、「却下」だけなどの単純な反対意見で反応するのはやめましょう。かわりに、短くてもいいので、元の質問や意見には含まれていなかった情報を加え、反対の理由を述べてください。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]
- 赤文字のリンクを削除したり、ダミーコンテンツを置いた空の新規ページを作成しないでください。赤文字のリンクは、新規ページ作成の必要性があるという判断より作成されたものですが、リンク先が編集されていないのは、リンクの作成者が必ずしもそのページの内容に詳しくなかったり、時間がなかったりという理由からです。(ただし、現存しないマイクロフォーマット・タイプのページへのリンクなどは外すべきです)[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]. 以前は次のようになっていました。『MediaWiki の「カテゴリー」構造を使わないでください。このコミュニティは、MediaWikiの全機能を使わないことにしているからです。(その他の例:「Talk」ページ)』[src:A]
- 手動で新規 "User:" リンクを作成しないでください。"User:" リンクは、ユーザーが自身の編集に ~~~ または ~~~~ の署名を加えたときのみ、自動で作成されるようにしましょう。こうすることで、間違ったログイン名にリンクを作成したりすることなく、各 "User:" ページが実際のログインときちんと対応するようになります。もし、 "User:" リンクにするべき赤文字のリンクを発見した場合(例: [[DavidJanes]])、リンクを編集するのではなく、実際のユーザーページへのリダイレクトを作成してください。[src:A]
- もしページを移動させる時は、メニューにある「ここにリンクしている他のページ」を確認し、リンク切れがないよう修正してください。
- 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.
Wiki Cleaning
「スパムの削除」をご覧ください。
Wiki上で大掛かりな削除作業が必要と思われる状況を発見した場合、あなた自身で作業するよりもIRCチャンネルまたは microformats-discuss メーリングリストから管理者にご連絡ください。[src:A]
Related
- MediaWiki のカスタム化」- このマイクロフォーマットWikiと典型的な MediaWiki の違いについての簡単な説明があります。主に、how-to-play および 命名規則を使いやすくするためにカスタム化を加えています。
- wiki2
- wiki-better-than-email
- how-to-play-2