cpanorg

cpan.orgコンテンツリポジトリ

このリポジトリは、cpan.orgの非ソースコード、非アーチブコンテンツを維持するためのものです。これに関連する議論は、CPAN労働者のメーリングリストにあるべきです。

コンテンツを編集するためのルール

• 新しい出力ファイルを追加しないでください。 cpan.org上にすでにファイルのみを追加する必要があります（そして、現在の場所に）。通常、ここに新しいファイルが含まれているように[email protected]にメールしてください。出力ファイルを生成するために新しいテンプレート/スクリプト/などを作成することは問題ありません。

• あなたの編集で保守的になります。多くの更新が必要ですが、これは20年前から存在しており、さらに多くのものになります。急いでいません。

• 今のところスタイルの編集はありません。クリーンアップはい。しかし、新しいデザイン/レイアウトが待ちます。

変更を送信する方法

GitHubの「プルリクエスト」が最良の方法です。 CPAN労働者リストにパッチを同時に送信することは、ピアレビューを得るための良い方法です。リストから数票の数票を獲得した変更は、適切に引き込まれる可能性が高くなります。

それがどのように機能するか

[テンプレートツールキット]およびその他の要件を、実行してインストールしてcpanmを使用しmake install 。

サイトに必要なデータを取得するには、 make update-data update-daily 。

次に、 makeします。

これにより、 ttreeが実行され、 html/ディレクトリで出力ファイルが生成されます。

画像ファイルは、 html/ディレクトリにはっきりとコピーされます。

他のすべては、テンプレートツールキットを介して処理されます。

.htmlファイルのみが「マスターテンプレート」を自動的に適用します。

Dockerの下で実行します

実験的に、次のテンプレートからコンテンツを作成できます。

 mkdir -p root/tmp root/CPAN
docker run --rm -ti 
  -v `pwd`:/cpan/content -v `pwd`/root:/cpan 
  -w /cpan/content 
  quay.io/perl/cpanorg:master 
    make build update-data update-master