cpanorg

Référentiel de contenu cpan.org

Ce référentiel est destiné à maintenir le contenu non archisif du code non source sur cpan.org. La discussion liée à cela devrait figurer sur la liste de diffusion des travailleurs du CPAN .

Règles pour modifier le contenu

• N'ajoutez pas de nouveaux fichiers de sortie. Seuls les fichiers déjà sur cpan.org doivent être ajoutés (puis à leur emplacement actuel). Envoyez généralement un e-mail à [email protected] pour que de nouveaux fichiers incluent ici. Faire de nouveaux modèles / scripts / etc. pour produire les fichiers de sortie est bien.

• Soyez conservateur dans vos modifications. Bien que de nombreuses mises à jour soient nécessaires, cela existe depuis 20 ans et le sera pour bien d'autres. Il n'y a pas de précipitation.

• Aucune modification de style pour l'instant. Nettoyage oui; Mais un nouveau design / mise en page attendra.

Comment soumettre des modifications

Une «demande de traction» sur GitHub est le meilleur moyen. L'envoi d'un correctif à la liste des travailleurs CPAN en même temps sera un bon moyen d'obtenir un examen par les pairs. Un changement avec quelques votes "+1" de la liste est plus susceptible d'être insuffisant.

Comment ça marche

Installez la boîte à outils du modèle et les autres exigences avec cpanm en exécutant make install .

Pour récupérer les données nécessaires pour le site, exécutez make update-data update-daily .

Ensuite, exécutez make .

Cela exécutera à son tour ttree et générera des fichiers de sortie dans le répertoire html/ .

Les fichiers image sont copiés clairement dans le répertoire html/ .

Tout le reste est traité via la boîte à outils du modèle.

Seuls les fichiers .html s'appliquent automatiquement au "modèle maître".

Courir sous Docker

Expérimental, vous pouvez créer le contenu à partir de ces modèles avec:

 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