サポート » WordPress への貢献と参加 » 日本語版ドキュメンテーションのコンテンツ

  • モデレーター Naoko Takano

    (@nao)


    新日本語版ドキュメンテーションのコンテンツについてのトピックです。
    関連トピック: http://ja.forums.wordpress.org/topic.php?id=31&replies=6#post-42

    上記トピックでは、英語版Codex 和訳および日本語独自コンテンツが必要だろう、という意見が出ていましたが、私も同意です。

    ぼのさんがWPJ Codexのデータをお持ちですのでCodexの内容はいずれ復帰できると思いますが、高度なカスタマイズの内容よりも基本的なリファレンス(テンプレートタグなど)をまず充実&最新情報に更新していくのが大事だと思います。

    具体的には

    ・テンプレートタグリファレンス(使い方、書き方、タグ一覧)
    ・条件分岐タグ
    ・関数リファレンス
    ・フックAPIリファレンス

    あたりでしょうか。
    新サイト立ち上げ次第、更新に参加できます。

    クイックスタートガイドみたいなものもあるといいですね(例: Drupal)。

    wordpress.xwd.jpにMEについてのページがありましたしCodexでも似たようなコンテンツがあったと思いますが、日本語版のローカルサイトのインストールページはそれに比べると少し敷居が高いかも。スクリーンショットも含め数ページに分かりやすくまとめたものを、公式サイトからのリンクとして提供するのが親切だと思います。

10件の返信を表示中 - 1 - 10件目 (全10件中)
  • bonops

    (@bonops)

    目次で太字になっているのはほぼ最新版の和訳があります。
    全ページ一覧
    2.5 関連のページと更新状況
    WPJ Codex にあったページ一覧と当時の状態

    急ぎなのは、
    ・各テンプレートタグ
    ・条件分岐タグ
    でしょうか。あと、初心者向けには
    ・ページ
    ・ループ
    もあるといいと思います。

    テンプレートタグ以外の 3つは、WPJ Codex で bleuさんとNaoさんが訳してくださった和訳&履歴があるので、週末まで待ってもらえると助かります。

    テンプレートタグの需要が高そうなのから訳していってみますね。

    bonops

    (@bonops)

    現在、上述のようなリファレンス系ページと WP2.5 に関するページを優先して、複数人体制で更新・和訳を進めています。
    仮サイトですみませんが、WordPress ドキュメントとしてご活用ください。

    http://bono.s206.xrea.com/pswiki/Codex

    なお、WP2.0.x 以前からあったテンプレートタグは、今のところ 2.0.x 時点の情報となっています。最新英語版と合わせてご覧ください。英語版へのリンクは、各ページまたはテンプレートタグ一覧ページにあります。

    WordPress 2.5 についての FAQ ページも(まだ英文ですが)掲載しました。
    このフォーラムでも質問のあった「カテゴリとpageのIDが見えない」件などがまとまっています。(Weblog Tools Collection で記事になったものとソースの作成者はは同じ)
    翻訳を考えている方がいらっしゃれば、ご協力いただけると助かります。

    他に、早めにドキュメントが揃った方がいいページがあれば、このスレッドでご提案ください。(参考)進捗状況と予定

    # サーバスペースを無料で借りているため、広告表示が義務付けられています。しばらくご容赦ください。。

    WPJ Codex のデータ(WP2.0.x 時点)と移転先サイトについても、並行して進めています。もうしばらくお時間ください。

    KKT

    (@kvex)

    どこで表明すればいいのかわからなかったので、ここに書いてます。
    けっこう時間があるので、そこそこお手伝いできると思うのですが、人手は足りましたか?

    bonops

    (@bonops)

    kvex さん、こんにちは。お返事が遅くなってごめんなさい。><
    ご協力ありがとうございます。もしよかったら参加してください。 🙂

    ご希望の編集用アカウント名(先頭大文字)をメールでお知らせいただけますか?
    例: 現在の参加者
    宛て先は wpja.team[あっと]gmail.com で、件名か本文に「日本語Codex」という文字を入れてください。
    よろしくお願いいたします。

    bonops

    (@bonops)

    <クイックスタートガイド

    画像付きで分かりやすく案内していくようなページですよね。
    私が初めて WordPress をインストールしたときは、WordPress Japan のスタートガイドを見ながらでした。分かりやすかったです。 🙂

    wiki で作るとしたらこんな感じ?
    クイックスタートガイド

    Naoさんが例に挙げてくださった Drupal のリンク先に飛べないので、もう一度 URL を教えていただいてもいいですか?

    モデレーター Naoko Takano

    (@nao)

    Drupal のリンク、すみません。修正しました。ちなみにこちらです。
    http://drupal.jp/node/517

    これくらいざっくりと、1ページに見渡せるくらいにまとめると見やすいかなーと思います。

    wiki のクイックスタートガイドもいいですね!
    ただ、各見出し項目の詳細を埋めていくとページがかなり長くなってしまうと思うので、できるだけこのページ自体はすっきりとまとめて、他のページへのリンクで詳細を説明するような形にした方が圧倒されずにすむ気がします(もしくは各項目の説明をかなりはしょる)。

    また、ja.wp.org サイト運営チームのMLのほうで、「保守やインストールに関わる内容から先に作成されてゆくことを希望いたします。」という声がありました。
    これは例えば、インストール、投稿、管理画面の使い方、バックアップの作成とかバックアップからのリストア、まあいわゆる 英語版の Getting Started カテゴリにのっているような初心者&WPが初めての人向けの記事という事になるでしょうか。それから用語集もぜひ含めたいですね。

    英語 Codex にはかなりの情報量があるので難しいとは思いますが、例えば「投稿が望まれているページ」などをもとに、優先順位をつけたリストをまず作成し、それに対して作業予約をしていくのはどうでしょうか。

    作業者の視点から言うとつい上級トピックに目がいってしまいがちですが、確かにまずドキュメンテーションが必要なのはそういった基本的な項目ですね。

    bonops

    (@bonops)

    「クイックスタートガイド」と、次の「スクリーンショットも含め数ページに分かりやすくまとめたもの」とをごっちゃにしてました。私が作ったのは後者の方でした。忘れてくださいー。(^-^;;

    > 「保守やインストールに関わる内容から先に作成されてゆくことを希望いたします。」

    具体的なページをリストアップしますので、それに優先順位をつけていきましょう。
    Tasks ページに書いたら、またここでお知らせします。
    ja.wp.org サイト運営チームやフォーラム参加者のみなさんからも、優先順位のコメントをいただけるとありがたいです。

    bonops

    (@bonops)

    リストアップしました。コメントお願いします。

    pswiki:Tasks

    wiki 参加者の方は直接、そうでない方はこのスレッドでページ名を挙げてくだされば反映します。

    wiki はどなたでも参加できますので、直接書き込んでくださる方は上記の方法でご連絡ください。普段は編集作業をできない方でも大丈夫です。 🙂

    モデレーター JOTAKI, Taisuke

    (@tai)

    bonops

    (@bonops)

    taiさん、どうもありがとうございます。:-) 状態を確認して Tasks に反映しました。
    これらは 5月初予定の 2.5.1 で sf.jp の URL を入れられるように、ページを用意しましょうか?

    和訳は今のところ少人数で作業しているので、特に優先度の高いものがあればコメントお願いします。 >みなさま

10件の返信を表示中 - 1 - 10件目 (全10件中)
  • トピック「日本語版ドキュメンテーションのコンテンツ」には新たに返信することはできません。