MDC:Getting started
出典: MDC
- How to help: 目次
- (MDC各言語共通)
- 一覧
- Documentation wishlist
- 編集/レビューが必要な項目一覧
- 移設リスト
- ガイド
- はじめるには
- 記述者ガイド (英語版の訳)
- Writing interface reference documentation
- ページ命名ガイド
- あいまい性除去のページ
- MDCの新しいローカライズをはじめる
- 著作権とライセンス
- リファレンス
- Wiki マークアップリファレンス
- カスタム CSS クラス
- カスタムテンプレート
- MediaWiki 拡張
- 外部リダイレクト
- リダイレクトが必要なページ
- MDC日本語版
- 日本語版
- 翻訳
- 井戸端会議
- 通信
MDC の手助けをするのは、ブラウザを使うのと同じくらい簡単なことです。すでにウェブ入力画面に書き込みをしたことや、ウェブログを書くために入力画面 (textarea) を利用したことがあるなら、MDC での作業を始めるためのブラウザ操作技術は全て持っています。
目次 |
[編集] はじめに
この wiki にあるどんな文書でも、書く、編集する、レビューする、翻訳するのを手伝っていただけるようお願いします。 ただ、協力して改良するという精神でお願いします。誰かが後であなたの貢献を修正や改良しても失望したり怒ったりしないでください。ここに集う全ての人 (一部のスパマーを除いてですが) は、Mozilla についての文書をよりよくし、協力し、お互いに助け合い、励ましあっている人たちです。
[編集] 基本的な事柄
ここには、MDC wiki にある記事を編集、作成するための短い解説です。wiki の編集の練習のために Sandbox を自由に利用できます。
なお、実際の MDC における記事の作成については、MDC:日本語版 も参照してください。
[編集] 記事の編集
記事を編集するためには、最初に wiki のアカウントを作る必要があります。まず、ログインページ へ行って、フォームへ記入、送信してください。すでにアカウントを作っているならば、自動的にログインし、編集できるようになります。
各記事の右側には "編集" リンクがあります。(サイドバーの中です。wiki の表示 skin によっては他の場所、右側のサイドバーや最下部などに表示されることもあります。) このリンクをクリックすると、記事の編集フォームが表示されます。あなたの好きなように編集し、変更をプレビューし、wiki へ保存することができます。編集内容を保存すれば、すぐに記事に反映されます。
[編集] 新しいページをはじめる
最も簡単な方法は、あなたのユーザページに作成したい新しい記事へのリンクを作成し、そのリンクから記事の "編集" モードに入る方法です。
あなたのユーザページへは、wiki の最上部にある青いバーのあなたのユーザ名をクリックしてください。まだユーザページになにも追加していなければ、直接ユーザページの編集フォームが表示されることになります。
追加したい記事へのリンクの作成は、二重角括弧で記事のタイトルで囲んで記述するという簡単な方法で行えます。たとえば、[[これはサンプルです]] という形です。保存すると、次のようなリンクに変わります。これはサンプルです
もし記事がまだ存在しなければ、リンクは赤く表示されます。それが 既に 存在しれ居れば、リンクは青く表示されます。作ろうとしていた新しい記事のタイトルが既に利用されていた場合、その記事の編集や改善ができないかを最初に確認してください。それらができなければ、新しい記事には他のタイトルを考え、リンクを作ってください。
新しいページに中身を書く時には、単純に赤いリンクをクリックすれば書き始めることができます。編集フォームの下にある "ページを保存する" ボタンを利用して、(長い編集作業をするなら時々) 編集した内容を忘れずに保存してください。
[編集] ページ名の付け方
新しいページの作成と命名についての詳細は、ページの命名ガイドを見てください。
なお、MDC 日本語版では、MDC 英語版の翻訳により作成する記事については、MDC 英語版とまったく同じページ名を利用する方針を採用しています。
[編集] Wiki マークアップ
いま右側の "編集" をクリックすると、この記事についての特殊文字入りのテキストを見ることができます。たとえば、"==" マークが見出しを囲み、"[[ ]]" 括弧がリンクを囲んでいます。これは、Wiki システム独自の非常に簡単なテキストマークアップ方式です。このマークアップ方式の利点は、非常に簡単に学べること、そして、記述間違いに寛大である傾向があることです。
[編集] Wiki マークアップリファレンス
あなたがWikiを編集するためにマークアップ言語について学べる完全な Wiki マークアップリファレンス があります。
[編集] 作成、編集、そしてレビュー
MDC での文書作成者、編集者、そしてレビューアー向けの MDC の少し長めの紹介です。
[編集] 文書作成者
MDC はいつでも新しいコンテンツに興味を持っていますので、現在 wiki でカバーされているどんな 話題 についてでも、あなたが新しい項目を書いてくれることを期待します。新しいコンテンツは、単純な 1 ページの "tip" (ヒント、情報) でも、複雑で本格的な書籍になるくらいの量があるプログラミングガイドやリファレンスでも構いません。貢献する新しいコンテンツの量については完全にあなた次第です。
Mozilla プロジェクトの Bugzilla にあるバグのうち文書に影響を与えるものは、dev-doc-needed キーワードが設定され、タグ付けられるようになっています。このキーワードを見ることは、必要とされる文書を発見するためのもう一つの有用な手段になります。通常、バグによってのみソースコードに変更が入り、文書化する必要がでてきます。文書に必要とされる修正が行われれば、dev-doc-complete キーワードがバグに設定されます。
もし、あなたが大きなプロジェクトを始めるならば、他の人が似たようなプロジェクトを計画し (もしくは既に始めている) かもしれませんので、MDC コミュニティ に参加して、最初に話し合っておくことをおすすめします。
Wiki のスタイルや利用方針についての質問があれば、まずは 記述者ガイド を参照してください。
[編集] 編集者
この wiki の編集はいつでも歓迎します。特に、記述スタイル、文法、スペルの改善・訂正は歓迎いたします。詳細については、記述者ガイド を参照してください。
[編集] レビューア
技術的な改善やレビューはいつでも歓迎していますので、記事を読んでいて (コードや文章に) 技術的な間違いがあれば、遠慮せずに修正してください。もし、議論の余地のある変更なら、"議論 (ノート)" ページ (右側の欄の "議論" のリンクをクリックして開けます) にあなたの変更理由についてメモを残してください。
なお、この "議論 (ノート)" ページについては、MDC 日本語版では全てをメーリングリスト上で行うことを検討しております。詳細は、アナウンスをおまちください。
[編集] 記述者ガイド
記述者ガイド で、MDC wiki における記述スタイルの慣習についての解説があります。もし、この解説に含まれていない用法やスタイルについての疑問があれば、エコノミストスタイルガイド もしくはここにもなければ シカゴスタイルマニュアル を参考にすることをおすすめします。(注 : 二つとも英語です。)
わたしたちは、時間とともにガイドを拡張していますので、(英語版について) もし 記述者ガイド でカバーされていない具体的な質問があれば、なにを追加すべきかを認識するためにも MDC メーリングリスト もしくは MDC プロジェクトリーダー に送ってください。
MDC 日本語版でのみ独自に利用している分については、解説を作成する予定です。質問等がありましたら、MDC:井戸端会議 もしくは irc などであげてください。
[編集] 古い資料の移動
[編集] 英語版 (en:) について
長期的に進められている MDC (英語版) のサブプロジェクトのひとつとして、mozilla.org のウェブサイトから MDC wiki へ既存の全ての開発者向け資料を移行する作業が行われています。手順は非常に簡単です :
- 既存文書一覧 (en) から移動したい文書を選択
- ページ命名ガイド を参照し、wiki でのページ名を決定
- ページを作成し、内容を移動し、wiki マークアップリファレンス をガイドとして利用しながら最適な形にマークアップ
- 既存文書一覧 (en) から項目を削除
- リダイレクトが必要な文書 一覧に項目を追加
もし、広範囲に作業を行うならば、次の手順も可能です :
- MDC 検索システム を使って、wiki 内からオリジナルの文書へのリンクを探し、新しく作成した wiki ページを指すように変更
- 外部リダイレクト で原文へのリンクを探し、
[[:en:Category:Junk]]を追加することで "Junk" カテゴリに追加し、削除フラグを立てる
[編集] 日本語版について
すでに Mozilla Japan 翻訳部門などのプロジェクトで翻訳された、既存の翻訳済み mozilla.org の文書について、該当する物を Mozilla Japan から MDC 日本語版へ移行するための検討作業を始めています。こちらについては、動きがあり次第公表します。
[編集] MDCのローカライズ
MDC wiki にあるどの文書についてでも、他言語への翻訳に興味があれば、その言語の wiki において簡単に翻訳文書を編集/作成することができます。
[編集] 既存の地域化プロジェクト
現在 MDC には次の言語のwikiがあります: Català, 中文(简体), Deutsch, English, Français, Italiano, 日本語, Nederlands, Polski, Português, Español, 한국어.
[編集] 地域化プロジェクトのはじめかた
もし、まだ wiki にない新しい言語で地域化プロジェクトをはじめたければ、地域化プロジェクト ページを読んで、そこの指示に従ってください。
[編集] "編集合戦" やその他の衝突の回避
もし、あるページで "編集合戦" 状態に陥ってしまったなら、つまり二人もしくはそれ以上の人が連続して繰り返し変更や差し戻しを繰り返す状態になったなら、関係者同士で解決するようにしてください。
解決策が無い場合、(理想的には) MDC メーリングリスト にもしくは (最終手段として) MDC プロジェクトリーダー に連絡を取ってください。他の技術エキスパート、著者、編集者が必要な場合には調整し、もしくは専門技術を持って問題を解決するでしょう。
[編集] ページの削除要請
間違えて新しいページを作ってしまったり、削除するべきページを偶然みつけたら、ページの最下部に [[Category:Junk]] を追加することで、ページを "Junk" カテゴリへ追加してください。
Junk カテゴリ は定期的に wiki 管理者がチェックし、そこにあるページを評価して、必要なら削除します。
注意: "Junk" のフラグを立てた記事にある内容やカテゴリは絶対に削除しないでください。
[編集] MDC コミュニティに参加する
Mozilla Developer Center のほとんどがボランティアグループの手仕事で運営されており、私たちはいつでも喜んで新しい著者 (翻訳者) や編集者の参加を助けます。
[編集] Mailing list / newsgroup
- MDC フォーラムを見る...
[編集] IRC チャンネル
私たちは、 irc.mozilla.org サーバの #devmo チャンネルに集まっています (英語です) : #devmo on irc.mozilla.org
日本語ではもじら組サーバの #MDC-ja チャンネルにたむろしていたりします。 irc.mozilla.gr.jp の #MDC-ja
[編集] MDC プロジェクトリーダー
MDC プロジェクトは Deb Richardson の管理下にあります。
文書については Eric Shepherd の管理下にあります。