how-to-play-ja: Difference between revisions
how-to-play-ja
Jump to navigation
Jump to search
IwaiMasaharu (talk | contribs) m (→â€: 表ç¾ã®å¤‰æ›´) |
m (Replace <entry-title> with {{DISPLAYTITLE:}}) Â |
||
(12 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
<!-- english: | <!-- english: 2010-07-06T07:55:36 --> | ||
__NOTOC__ | |||
åˆã‚ã¦ã®æ–¹ã¯[[introduction-ja|Microformatsã®æ‰‹å¼•ã]]ã‚’ã”覧ãã ã•ã„。 | |||
Please also review the in-progress [[how-to-play-2]] page and provide feedback on it! | |||
{{DISPLAYTITLE:How to Play}} | |||
== ガイドライン == | |||
å”力ã™ã‚‹å‰ã«ã“れらã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã‚’èªã‚“ã§ãã ã•ã„。ã¾ãŸã€ã“ã®å†…容ã¯éµå®ˆã—ã¦ãã ã•ã„。 | å”力ã™ã‚‹å‰ã«ã“れらã®ã‚¬ã‚¤ãƒ‰ãƒ©ã‚¤ãƒ³ã‚’èªã‚“ã§ãã ã•ã„。ã¾ãŸã€ã“ã®å†…容ã¯éµå®ˆã—ã¦ãã ã•ã„。 | ||
# | # ページを編集ã—ãŸã‚Šä½œæˆã—ãŸã‚Šã™ã‚‹å‰ã«ã‚¢ã‚«ã‚¦ãƒ³ãƒˆã‚’作æˆã—ã¦ãã ã•ã„。Please consider using your name, e.g. GivenFamily (FirstLast). [http://en.wikipedia.org/wiki/Wikipedia:Username 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). | ||
# ã¯ã˜ã‚ã«[http://microformats.org/discuss | # microformats.orgã®[[:Category:public_domain_license|Public Domain Declarations]]ã‚’ã”覧ãã ã•ã„。ãã—ã¦ã€[[Template:public-domain-release]]を自分ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ãƒšãƒ¼ã‚¸ã«è¿½åŠ ã—ã¦ã€ã‚ãªãŸã®microformats.orgサイトã¸ã®2008年以å‰ã®è²¢çŒ®ã‚’パブリック・ドメインã¸è§£æ”¾ã™ã‚‹ã“ã¨ã‚‚検討ã—ã¦ã¿ã¦ãã ã•ã„。 | ||
# | # ã¯ã˜ã‚ã«[http://microformats.org/discuss IRCãƒãƒ£ãƒ³ãƒãƒ«ï¼ˆã“ã¡ã‚‰ãŒãŠå‹§ã‚)ã‹ã€ãƒ¡ãƒ¼ãƒªãƒ³ã‚°ãƒªã‚¹ãƒˆ]ã«å‚åŠ ã—ã¦ã¿ã¦ãã ã•ã„。(ãã®å‰ã«ã¯[[mailing-lists]]ã‚’èªã‚“ã§ä¸‹ã•ã„) | ||
# | # ã‚‚ã—ã€è«–ç†çš„ãªç†ç”±ã‚’è¶Šãˆã¦ä½•ã‹æ„見を書ã„ãŸãªã‚‰ã°ã€ã‚ãªãŸã®ãƒ¦ãƒ¼ã‚¶åã‚‚ä¸€ç·’ã«æ›¸ã„ã¦ãã ã•ã„。- ã“れã¯MediaWikiã®datetimestampを使ã£ã¦ç°¡å˜ã«ã§ãã¾ã™ã€‚4ã¤ã®åŠè§’「~ã€ã‚’以下ã®ã‚ˆã†ã«ä¸¦ã¹ã¾ã™: <nowiki>~~~~</nowiki> | ||
# ページã®[[naming-conventions-ja|命åè¦å‰‡]]ã«å¾“ã£ã¦ãã ã•ã„。 | #*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. | ||
# Wikiã®ãƒšãƒ¼ã‚¸ã§ä¼šè©±ã‚’ã—ã¦ã¯ã„ã‘ã¾ã›ã‚“。ãã®ç”¨é€”ã«ã¯# | #*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|avoid personalizing proposals]]), and thus consider leaving such statements unsigned. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | ||
# ã“ã®Wikiã«ã¯ã€[[POSH-ja|POSH]]ã‚„microformats(ã¨[[picoformats]])ã«ç›´æŽ¥é–¢ä¿‚ã‚るページã ã‘を作æˆã—ã¦ãã ã•ã„。[[data-portability]] in line with microformats [[principles]] is also encouraged. 無関係ãªãƒšãƒ¼ã‚¸ã¯å‰Šé™¤ã•れã¾ã™ã€‚ | |||
# <span id="naming">ページã®[[naming-conventions-ja|命åè¦å‰‡]]ã«å¾“ã£ã¦ãã ã•ã„。[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] </span> | |||
# Wikiã®ãƒšãƒ¼ã‚¸ã§ä¼šè©±ã‚’ã—ã¦ã¯ã„ã‘ã¾ã›ã‚“。ãã®ç”¨é€”ã«ã¯#3ã§æŒ™ã’ãŸ[http://microformats.org/discuss mailing lists]を使ã£ã¦ãã ã•ã„。[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# 妥当ãªXHTMLã§è¨˜è¿°ã™ã‚‹ã‚ˆã†ã«ã—ã¦ãã ã•ã„。 | # 妥当ãªXHTMLã§è¨˜è¿°ã™ã‚‹ã‚ˆã†ã«ã—ã¦ãã ã•ã„。 | ||
# ソースコードを貼りã¤ã‘ã‚‹å ´åˆã€é©å½“ãªé•·ã•ã§æ”¹è¡Œã‚’入れã¦ãã ã•ã„。 | # ソースコードを貼りã¤ã‘ã‚‹å ´åˆã€é©å½“ãªé•·ã•ã§æ”¹è¡Œã‚’入れã¦ãã ã•ã„。 | ||
# 見出ã—ã«ã€Œ?ã€ã‚„å¥èªç‚¹è¨˜å·ã‚’入れãªã„ã§ãã ã•ã„。ã“れã¯ã€URLã®ãƒ•ラグメントè˜åˆ¥å(リンクã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã‚’表ã™éƒ¨åˆ†ï¼‰ã‚’çŸãã™ã‚‹ã“ã¨ã«ã‚ˆã‚Šã€å¯èªæ€§ã‚’高ã‚ãŸã‚Šã€ã‚³ãƒ”ー&ペーストãªã©ã‚’ã—ã‚„ã™ãã™ã‚‹ãŸã‚ã§ã™ã€‚[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# <span id="lowercase-headings">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. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>]</span> | |||
# 目次ã«è¡¨ç¤ºã•ã›ãŸããªã„見出ã—ã«ã¯ <h1> ã‚¿ã‚°ã‚„ <h2> ã‚¿ã‚°ãªã©ã‚’使ã£ã¦ã‚‚ã‹ã¾ã„ã¾ã›ã‚“。ã“ã†ã„ã£ãŸã‚¿ã‚°ã‚’見ã¤ã‘ã¦ã‚‚ã€ã€Œ=〠や 「==〠ãªã©ã‚’使ã£ãŸã‚¹ã‚¿ã‚¤ãƒ«ã®è¦‹å‡ºã—ã«<strong style="text-transform:uppercase">変更ã—ãªã„ã§ãã ã•ã„</strong>。[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# 見出ã—ã®ãƒ†ã‚ストを変更ã—ãªã„よã†ã«ã—ã¦ãã ã•ã„(大文å—ã¨å°æ–‡å—é–“ã®å¤‰æ›ã‚„ã€ä¸Šè¨˜ã®ãƒ«ãƒ¼ãƒ«ã«å¾“ãŠã†ã¨ã™ã‚‹ãŸã‚ã®å¤‰æ›´ã‚‚å«ã‚€ï¼‰ã€‚見出ã—ã¯ãƒ‘ーマリンクã¨ã—ã¦ä½¿ã‚れるã“ã¨ãŒå¤šã„ãŸã‚ã€å¤‰æ›´ã«ã‚ˆã£ã¦ä»–ã§ä½¿ã‚れã¦ã„るリンク切れãªã©ã‚’ã²ãèµ·ã“ã™å¯èƒ½æ€§ãŒã‚りã¾ã™ã€‚ã“れらをãµã¾ãˆã€è¦‹å‡ºã—ã‚’ã¤ã‘ã‚‹å ´åˆã¯æ³¨æ„ã—ã¦è¨€è‘‰ã‚’é¸ã‚“ã§ãã ã•ã„。ã©ã†ã—ã¦ã‚‚変更ãŒå¿…è¦ãªå ´åˆã€<code><nowiki><div id="oldheadingID"></div></nowiki></code> ã¨ã„ã†ã‚³ãƒ¼ãƒ‰ã§æ–°ã—ã„見出ã—を囲ã¿ã€"oldHeadingID" ã®éƒ¨åˆ†ã‚’見出ã—パーマリンクを残ã™ãŸã‚ã«å¿…è¦ãªå€¤ã«ã™ã‚‹ã“ã¨ã§ã€ãƒªãƒ³ã‚¯åˆ‡ã‚Œã‚’防ãã“ã¨ã¯ã§ãã¾ã™ã€‚[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# 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全体ã«é–¢ã‚ã‚‹å¤‰æ›´ã‚’åŠ ãˆã‚‹ã“ã¨ãŒã‚りã¾ã™ã€‚[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# 質å•ã‚„å•題æè°ã«å¯¾ã—ã€ã€Œå´ä¸‹ã€ã ã‘ãªã©ã®<span id="avoid-simple-contradictions">å˜ç´”ãªå対æ„見ã§å応ã™ã‚‹ã®ã¯ã‚„ã‚ã¾ã—ょã†</span>。ã‹ã‚りã«ã€çŸãã¦ã‚‚ã„ã„ã®ã§ã€å…ƒã®è³ªå•ã‚„æ„見ã«ã¯å«ã¾ã‚Œã¦ã„ãªã‹ã£ãŸæƒ…å ±ã‚’åŠ ãˆã€å対ã®ç†ç”±ã‚’è¿°ã¹ã¦ãã ã•ã„。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.[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# 赤文å—ã®ãƒªãƒ³ã‚¯ã‚’削除ã—ãŸã‚Šã€ãƒ€ãƒŸãƒ¼ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã‚’ç½®ã„ãŸç©ºã®æ–°è¦ãƒšãƒ¼ã‚¸ã‚’作æˆã—ãªã„ã§ãã ã•ã„。赤文å—ã®ãƒªãƒ³ã‚¯ã¯ã€æ–°è¦ãƒšãƒ¼ã‚¸ä½œæˆã®å¿…è¦æ€§ãŒã‚ã‚‹ã¨ã„ã†åˆ¤æ–より作æˆã•れãŸã‚‚ã®ã§ã™ãŒã€ãƒªãƒ³ã‚¯å…ˆãŒç·¨é›†ã•れã¦ã„ãªã„ã®ã¯ã€ãƒªãƒ³ã‚¯ã®ä½œæˆè€…ãŒå¿…ãšã—ã‚‚ãã®ãƒšãƒ¼ã‚¸ã®å†…容ã«è©³ã—ããªã‹ã£ãŸã‚Šã€æ™‚é–“ãŒãªã‹ã£ãŸã‚Šã¨ã„ã†ç†ç”±ã‹ã‚‰ã§ã™ã€‚(ãŸã ã—ã€ç¾å˜ã—ãªã„マイクãƒãƒ•ォーマット・タイプã®ãƒšãƒ¼ã‚¸ã¸ã®ãƒªãƒ³ã‚¯ãªã©ã¯å¤–ã™ã¹ãã§ã™ï¼‰[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# Please do not add MediaWiki Categories. With the [[wiki-2|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. [<abbr title="guideline created due to one or more actions by Toby Inkster">src:TI</abbr>]. 以å‰ã¯æ¬¡ã®ã‚ˆã†ã«ãªã£ã¦ã„ã¾ã—ãŸã€‚『MediaWiki ã®ã€Œã‚«ãƒ†ã‚´ãƒªãƒ¼ã€æ§‹é€ を使ã‚ãªã„ã§ãã ã•ã„。ã“ã®ã‚³ãƒŸãƒ¥ãƒ‹ãƒ†ã‚£ã¯ã€MediaWikiã®å…¨æ©Ÿèƒ½ã‚’使ã‚ãªã„ã“ã¨ã«ã—ã¦ã„ã‚‹ã‹ã‚‰ã§ã™ã€‚(ãã®ä»–ã®ä¾‹ï¼šã€ŒTalkã€ãƒšãƒ¼ã‚¸ï¼‰ã€[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# æ‰‹å‹•ã§æ–°è¦ "User:" リンクを作æˆã—ãªã„ã§ãã ã•ã„。"User:" リンクã¯ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ãŒè‡ªèº«ã®ç·¨é›†ã« <nowiki>~~~</nowiki> ã¾ãŸã¯ <nowiki>~~~~</nowiki> ã®ç½²åã‚’åŠ ãˆãŸã¨ãã®ã¿ã€è‡ªå‹•ã§ä½œæˆã•れるよã†ã«ã—ã¾ã—ょã†ã€‚ã“ã†ã™ã‚‹ã“ã¨ã§ã€é–“é•ã£ãŸãƒã‚°ã‚¤ãƒ³åã«ãƒªãƒ³ã‚¯ã‚’作æˆã—ãŸã‚Šã™ã‚‹ã“ã¨ãªãã€å„ "User:" ページãŒå®Ÿéš›ã®ãƒã‚°ã‚¤ãƒ³ã¨ãã¡ã‚“ã¨å¯¾å¿œã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚ã‚‚ã—〠"User:" リンクã«ã™ã‚‹ã¹ã赤文å—ã®ãƒªãƒ³ã‚¯ã‚’発見ã—ãŸå ´åˆï¼ˆä¾‹: <nowiki>[[DavidJanes]]</nowiki>)ã€ãƒªãƒ³ã‚¯ã‚’編集ã™ã‚‹ã®ã§ã¯ãªãã€å®Ÿéš›ã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ãƒšãƒ¼ã‚¸ã¸ã®ãƒªãƒ€ã‚¤ãƒ¬ã‚¯ãƒˆã‚’作æˆã—ã¦ãã ã•ã„。[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# ã‚‚ã—ページを移動ã•ã›ã‚‹æ™‚ã¯ã€ãƒ¡ãƒ‹ãƒ¥ãƒ¼ã«ã‚る「ã“ã“ã«ãƒªãƒ³ã‚¯ã—ã¦ã„ã‚‹ä»–ã®ãƒšãƒ¼ã‚¸ã€ã‚’確èªã—ã€ãƒªãƒ³ã‚¯åˆ‡ã‚ŒãŒãªã„よã†ä¿®æ£ã—ã¦ãã ã•ã„。 | |||
# Please use U.S. English ([[en-US]]) spellings of common words on English microformats pages. This is by convention, following the [http://www.w3.org/2001/06/manual/#Spelling W3C Manual of Style Spelling Editorial Guideline].[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>]. 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. [<abbr title="guideline created due to numerous edits by Ameer Dawood">src:AD</abbr>([http://microformats.org/wiki/Special:Contributions/AmeerDawood])] | |||
# Use [[rfc-2119#Templates|templates]] for RFC 2119 terms such as {{must}}. | |||
# References to (X)HTML element names should be lowercase and marked up with <nowiki><code>...</code></nowiki>, e.g. the <code>input</code> element. This convention is adopted from the practice used in the [http://www.w3.org/2001/06/manual/ 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 <nowiki>example.org</nowiki> 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 <code><nowiki></code> tags, e.g.: <code><nowiki><nowiki>http://example.org/</nowiki></nowiki></code> so that the URLs are not auto-hyperlinked by MediaWiki. Where interactions between multiple domains need to be illustrated, you may use <nowiki>example.net or example.com</nowiki> or subdomains of <nowiki>example.org like foo.example.org</nowiki>. | |||
# 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 '''<nowiki>{{Template:inuse}}</nowiki>''' at the head of the page. Please don't forget to remove it, when you're done! [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# Please do not remove apparently <span id="brokenlinks">broken links</span> (404 etc.). If you cannot fix them, de-link them using <nowiki><nowiki></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 [http://archive.org/ Internet Archive]. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# <span id="avoid-personalizing-proposals">Avoid labeling proposals with people's names.</span> 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. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
# <span id="avoidsplitting">Avoid splitting most pages.</span> 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 <strong>more</strong> 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. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>([http://microformats.org/wiki?title=to-do&diff=24428&oldid=24400] [http://microformats.org/wiki?title=to-do&diff=24992&oldid=24707])] | |||
# 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. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>([http://microformats.org/wiki?title=hcard-examples-in-wild&diff=0&oldid=24726])] | |||
# 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. [<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
== Accessibility == | |||
#Use upper case for acronyms like HTML but use <code><nowiki><strong style="text-transform:uppercase"></nowiki></code> to add strength to phrases like "<strong style="text-transform:uppercase">do not</strong>". This improves accessibility for people using text-reading software and other assistive technologies ([http://www.kent.gov.uk/NR/rdonlyres/489181F9-B134-455E-98A3-EE75722400E2/11935/technicalguidance0708.pdf] PDF) <strong>(list and versions of text-reading software & other agents affected needed)</strong>. | |||
#Do not use styles or write in ways which contravene [http://www.w3.org/TR/WCAG10/full-checklist.html 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 == | |||
「[[spam-removal|スパムã®å‰Šé™¤]]ã€ã‚’ã”覧ãã ã•ã„。 | |||
Wiki上ã§å¤§æŽ›ã‹ã‚Šãªå‰Šé™¤ä½œæ¥ãŒå¿…è¦ã¨æ€ã‚れる状æ³ã‚’発見ã—ãŸå ´åˆã€ã‚ãªãŸè‡ªèº«ã§ä½œæ¥ã™ã‚‹ã‚ˆã‚Šã‚‚IRCãƒãƒ£ãƒ³ãƒãƒ«ã¾ãŸã¯ microformats-discuss メーリングリストã‹ã‚‰ç®¡ç†è€…ã«ã”連絡ãã ã•ã„。[<abbr title="guideline created due to one or more actions by Andy Mabbett">src:A</abbr>] | |||
== Related == | |||
* [[mediawiki-customization|MediaWiki ã®ã‚«ã‚¹ã‚¿ãƒ 化]]ã€- ã“ã®ãƒžã‚¤ã‚¯ãƒãƒ•ォーマットWikiã¨å…¸åž‹çš„㪠MediaWiki ã®é•ã„ã«ã¤ã„ã¦ã®ç°¡å˜ãªèª¬æ˜ŽãŒã‚りã¾ã™ã€‚主ã«ã€[[how-to-play-ja|how-to-play]] ãŠã‚ˆã³ [[naming-conventions-ja|命åè¦å‰‡]]を使ã„ã‚„ã™ãã™ã‚‹ãŸã‚ã«ã‚«ã‚¹ã‚¿ãƒ åŒ–ã‚’åŠ ãˆã¦ã„ã¾ã™ã€‚ | |||
* [[wiki2]] | |||
* [[wiki-better-than-email]] | |||
* [[how-to-play-2]] |
Latest revision as of 16:27, 18 July 2020
åˆã‚ã¦ã®æ–¹ã¯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. microformats 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. microformats 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 ãŠã‚ˆã³ 命åè¦å‰‡ã‚’使ã„ã‚„ã™ãã™ã‚‹ãŸã‚ã«ã‚«ã‚¹ã‚¿ãƒ åŒ–ã‚’åŠ ãˆã¦ã„ã¾ã™ã€‚
- Microformats.org Wiki 2.0
- Wiki is better than email
- how-to-play-2