この2部構(gòu)成のシリーズでは、パート1のドキュメントに焦點を當てたPHPプロジェクトに貢獻する方法を探ります。 アカウントのリクエストと承認後の手順をカバーします

キーポイント：

PHPのドキュメントに貢獻することで、言語が強化され、PHPの専門知識が向上します。また、PHP.NETアカウントにつながり、言語の指示に影響を與えます。

ドキュメントでは、Docbook XMLを使用しています。親しみやすさは役立ちますが、必須ではありません

初心者は、単純なパッチにオンラインエディターを使用できます。 事前にスタイルのガイドラインをレビューすることをお勧めします
• 頻繁な貢獻者または大規(guī)模な編集が必要な編集者は、ドキュメントをローカルに設(shè)定し、PHP.NETアカウントを要求する必要があります。これには、ディレクトリの作成、ドキュメントのクローニング、SVNキーワードの構(gòu)成が含まれます。
貢獻には、バグの修正、翻訳、既存のコンテンツの拡大、文書化されていない機能の文書化、および一般的な改善が含まれます。
• なぜ貢獻するのか？
• オープンソースであるPHPは、コミュニティの関與に繁栄します。 參加の増加は皆に利益をもたらします。ドキュメントの改善、バグの修正、機能の追加など、すべての貢獻が重要です。 積極的な參加により、PHPの知識が深まり、PHP.NETアカウントをリクエストして、言語の將來を形作ることができます。
• PHPのドキュメントを理解

ドキュメントはDocbook XMLにあります。 事前知識は厳密に必要ではありません。 XML構(gòu)文は簡単に學習できます ディレクトリ構(gòu)造は次のとおりです

XMLドキュメントを変換するためのツールが含まれています。 英語のドキュメントを保持しています（他の言語は2文字のコードを使用します）。 拡張固有のディレクトリ（手続き型拡張機能の関數(shù)、オブジェクト指向のフォルダー用のクラス名のフォルダー）が含まれています。 各拡張機能フォルダーには、

（ランディングページ）と

（バージョン化情報）が含まれています。

ドキュメントは現(xiàn)在SVNベースです（ただし、GITに移行しています）。 ローカルセットアップには、SVNの親しみやすさが必要です

初めての貢獻者

オンラインドキュメントエディターを使用することから始めます。 これにより、OAUTHログインと簡単なパッチの提出が可能になります。一貫したアカウントの使用は、將來のPHP.NETアカウントアプリケーションの追跡貢獻を簡素化します。 パッチを送信する前に、スタイルガイドラインに精通しています。

doc-baseen例：バグ＃71716 referencebook.xmlの解決 versions.xmlこのバグは、サンプル內(nèi)の誤って名前の付いたmongodbクライアントクラスを報告しています。確認後、オンラインエディターを使用して名前空間を修正します。

ビデオ埋め込み：https：//m.miracleart.cn/link/14aa36297925d3c82891d74fa28d7df1（必要に応じて実際の埋め込みコードと置き換えます）

ローカルセットアップ

オンラインエディターは限られています。より多大な貢獻については、ドキュメントをローカルに設(shè)定し、PHP.NETアカウントをリクエストしてください。

1. ディレクトリを作成します。phpdocs
SVNを使用してドキュメントをクローンします：
2. svn checkout https://svn.php.net/repository/phpdoc/modules/doc-en
クローンPHD（レンダリングツール）：
3. git clone http://git.php.net/repository/phd.git
PHP.NET Webサイトをクローンします：
4. ; git clone http://git.php.net/repository/web/php.git web-phpを削除し、レンダリングされたドキュメントへのシンボリックリンクを作成します。 web-php/manual/en：
5. で構(gòu)成します ~/.subversion/config（オプション）局所的にドキュメントを検証、構(gòu)築、および表示するためのコマンドを備えた*.xml = svn:eol-style=native;svn:keywords=Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URLファイルを作成します。
6. refdocsワークフロー（ローカル）

セットアップ後、リポジトリ（および）を更新します。 関連するXMLファイルを編集し、

を使用して検証し、PHDでビルドし、ローカルサーバーを起動します。 SVNを使用して変更をコミットします（

、バグ番號を參照します。変化した後、「開発者」タブからバグレポートを閉じます。 svn upgit pullphp.netアカウントの要求php ~/phpdocs/doc-en/doc-base/configure.php svn ci -m "Resolve doc bug #...")

ローカルセットアップの後、docs karmaを使用してphp.netアカウントをリクエストします。 厳格な前提條件は存在しませんが、積極的な貢獻を示すことが重要です。 アカウントリクエストフォームとメールを送信し、Phpdoc@lists.php.netにメールを送信します。意図、wikiユーザー名、および過去の貢獻を説明してください。

ドキュメントタスク

バグの修正を超えて：

翻訳 部分的に文書化された材料の拡大

文書化されていない機能のドキュメント

一般的な改善
• 一般的なヒント
スタイルのガイドラインに従ってください。

バグを修正するときに関連する側(cè)面をチェックします。

簡潔に書く。

出力からの例の個別のコード。

• 正しいページの注文を確認してください。
• PHP 4參照を削除します
適切にバージョンの新しいファイル。
支援については、ドキュメントのFAQまたはPHP-DOCSメーリングリストに相談してください。
• 結(jié)論
• このパートは、オンラインエディターとローカルセットアップの2つのワークフローをカバーしました。パート2では、PHPのコアへの貢獻について説明します
• faqs
（より良い流れのために最後に移動）
• • プロセスの寄稿：アカウントの作成、コンテンツの編集/作成、翻訳、ガイドラインのフォロー。
  • 貢獻の重要性：ドキュメントの品質(zhì)を向上させ、最新の狀態(tài)に保ち、コミュニティを育てます。
  受け入れを確保する：
  • ガイドラインに従って、正確性と明確さを確保し、フィードバックを取得します。 非ネイティブ英語講演者：
  貢獻は大歓迎です。翻訳は貴重な貢獻です。
  • 一般的な間違い：
  ガイドラインに従わない、不正確/不明確な情報、校正の欠如、不必要な変更。
  • ヘルプの取得：オンラインフォーラム、ディスカッショングループ、ドキュメントガイドラインを使用しています。
  • 匿名の貢獻：可能性がありますが、アカウントが奨勵されています。
  • 貢獻頻度：は、可用性と関心に基づいて異なります。
  • 補償：一般的にボランティア活動
  • 間違いの報告：貢獻者がコミュニティに報告している場合は修正します。
  プレースホルダーの畫像URLを?qū)g際の畫像URLに置き換えることを忘れないでください。 畫像のフォーマットを保存し、要求に従って畫像を元の位置に保持しました。

以上がPHPへの貢獻：PHPのマニュアルに貢獻する方法の詳細內(nèi)容です。詳細については、PHP 中國語 Web サイトの他の関連記事を參照してください。