Apache Tomcat コネクタ - その他のドキュメント

Ant をインストールします。私からのアドバイスは、シンプルなインストールパスを選択することです。次に、ANT_HOME の環境変数を設定し、Ant/bin ディレクトリの場所を PATH 変数に追加します。この方法については、オペレーティングシステムのドキュメントを参照してください。終了したら、コマンドラインから ant を実行できることを確認します。

Ant は、とりわけドキュメントをビルドするために使用され、build.xml というファイルを確認できる必要があります。このファイルは xdocs ディレクトリにあります。build.xml ファイルには、ドキュメントをビルドするために使用される all という名前のターゲットがあります。

tomcat-connectors のソースを git リポジトリから取得します。git クライアントが必要です。まだクライアントをお持ちでない場合は、お好みのクライアントをインストールしてください。

これで、ソースをダウンロードする準備ができました。リポジトリを置きたい場所にディレクトリを変更します。簡単にするために、これを GIT_HOME と呼びます。私の場合は C:\build にあります。

初めてソースを クローン するには、次のコマンドを実行します。これは一度だけ行う必要があります。

C:\build\>git clone https://github.com/apache/tomcat-connectors tomcat-connectors

これで、すべてのダウンロードが表示されるはずです。これでソースがマシンにダウンロードされたので、難しい部分は終わりです。今後、ソースを更新するには、リポジトリ内の任意のディレクトリに cd し、git pull コマンドを実行するだけです。

コマンドプロンプトウィンドウを開き、ソースをダウンロードしたディレクトリに cd します。次に、Ant が build.xml ファイルを確認できるように、xdocs ディレクトリに cd します。次に、コマンドプロンプトから、次のコマンドを実行します。

C:\build\tomcat-connectors> cd xdocs
C:\build\tomcat-connectors\xdocs> ant all

ant コンパイラのメッセージがすばやくスクロールして、次のメッセージで停止するはずです。

[style] Transforming into C:\build\tomcat-connectors\build\docs\news\printer>
[style] Processing C:\build\tomcat-connectors\xdocs\news\20041100.xml 
to
C:\build\tomcat-connectors\build\docs\news/20041100.html
[style] Loading stylesheet C:\build\tomcat-connectors\xdocs\style.xsl
[style] Processing C:\build\tomcat-connectors\xdocs\news\20050101.xml 
to
C:\build\tomcat-connectors\build\docs\news/20050101.html
[style] Processing C:\build\tomcat-connectors\xdocs\news\20060101.xml 
to
C:\build\tomcat-connectors\build\docs\news/20060101.html
[style] Transforming into C:\build\tomcat-connectors\build\docs>
[style] Processing C:\build\tomcat-connectors\xdocs\index.xml 
to
C:\build\tomcat-connectors\build\docs\index.html
[style] Loading stylesheet C:\build\tomcat-connectors\xdocs\style.xsl
 
BUILD SUCCESSFUL
Total time: 10 seconds
C:\build\tomcat-connectors>

xdocs ディレクトリ構造に存在するすべての xml ファイルは html に変換され、GIT_HOME\tomcat-connectors\build\docs ディレクトリにコピーされました。ブラウザで html ファイルの 1 つを開き、どのように表示されるかを確認してください。

更新中は、2 つのウィンドウを使用する方が簡単だと思います。1 つは build ウィンドウと呼びます。これは GIT_HOME\tomcat-connectors\xdocs ディレクトリに保持し、このウィンドウでは 2 つのコマンドのみを実行します。まず、次を実行します。

ant clean

ant all

2 つ目のウィンドウは edit ウィンドウと呼び、編集、差分、git pull を行う GIT_HOME\tomcat-connectors\xdocs ディレクトリに保持します。

編集を開始する前に、競合を避けるために常にローカルリポジトリを更新する必要があります。

C:\build\tomcat-connectors> git pull

これで、リポジトリが最新になったので、編集を開始できます。ドキュメントで編集する何かを見つけてください。何かを見つけたら、ファイルの名前を覚えておいてください。edit ウィンドウで、同じ名前の xml ソースファイルを見つけて編集します。終了したら、build ウィンドウに戻り、GIT_HOME\tomcat-connectors\xdocs ディレクトリで次を実行します。

C:\build\tomcat-connectors\xdocs> ant clean

これにより、以前のすべての html ファイルが削除され、更新されたマテリアルを準備する領域が作成されます。次に、変更を組み込んだ新しいドキュメントを作成するには、次を実行します。

C:\build\tomcat-connectors\xdocs> ant all

ブラウザを使用して、GIT_HOME\tomcat-connectors\build\docs サブツリーにある編集した内容を表示します。問題なく、送信する準備ができたら、残りの作業はパッチを作成して送信することだけです。

edit ウィンドウから、作業中の xml ファイルが含まれているディレクトリに cd し、git pull コマンドを実行します。たとえば、index.xml ファイルの差分を作成して patch.txt と呼ぶには、index.xml ファイルが含まれているディレクトリに cd し、次のようにします。

C:\build\tomcat-connectors\xdocs\>git diff index.xml >  
patch.txt.

これで、パッチが作成され、送信する準備ができました。

ドキュメントへのパッチは、バグレポートと同じように処理されます。http://issues.apache.org/bugzilla/ にパッチを送信し、適切な 1 行の件名を含める必要があります。バグデータベースを初めて使用する場合は、http://issues.apach e.org/bugzilla/bugwritinghelp.html. を参照してください。ユーザーアカウントを作成する必要があります。Web サイトで、パッチを Web フォームに貼り付け、パッチの目的を説明することを忘れないでください。遅かれ早かれ、コミット権限を持つ誰かがあなたの提案を確認します。