cpanorg

CPAN.org Repositori Konten

Repositori ini adalah untuk mempertahankan konten non-kode, non-archive di cpan.org. Diskusi yang terkait dengan ini harus ada di milis CPAN-pekerja .

Aturan untuk mengedit konten

• Jangan menambahkan file output baru. Hanya file yang sudah ada di cpan.org yang harus ditambahkan (dan kemudian ke lokasi mereka saat ini). Umumnya email [email protected] untuk memasukkan file baru di sini. Membuat templat/skrip baru/dll untuk menghasilkan file output baik -baik saja.

• Menjadi konservatif dalam pengeditan Anda. Sementara banyak pembaruan diperlukan, ini telah ada selama 20 tahun dan akan lebih banyak lagi. Tidak ada terburu -buru.

• Tidak ada pengeditan gaya untuk saat ini. Pembersihan ya; Tapi desain/tata letak baru akan menunggu.

Cara mengirimkan perubahan

'Permintaan tarik' di GitHub adalah cara terbaik. Mengirim tambalan ke daftar CPAN-pekerja pada saat yang sama akan menjadi cara yang baik untuk mendapatkan peer review. Perubahan dengan beberapa suara "+1" dari daftar lebih cenderung ditarik secara cepat.

Cara kerjanya

Instal Template Toolkit dan persyaratan lainnya dengan cpanm dengan menjalankan make install .

Untuk mengambil data yang dibutuhkan untuk situs, jalankan, make update-data update-daily .

Lalu jalankan make .

Ini pada gilirannya akan menjalankan ttree dan menghasilkan file output di direktori html/ .

File gambar disalin dengan jelas ke direktori html/ .

Segala sesuatu yang lain diproses melalui Template Toolkit.

Hanya .html File Dapatkan "Template Master" yang diterapkan secara otomatis.

Jalankan di bawah Docker

Eksperimental, Anda dapat membangun konten dari templat tersebut dengan:

 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