cpanorg

Repositorio de contenido cpan.org

Este repositorio es para mantener el contenido no Archivo sin código de código en cpan.org. La discusión relacionada con esto debería estar en la lista de correo de CPAN-Workers .

Reglas para editar contenido

• No agregue nuevos archivos de salida. Solo se deben agregar archivos ya en cpan.org (y luego a su ubicación actual). Generalmente, envíe un correo electrónico a [email protected] para que se incluyan nuevos archivos incluidos aquí. Hacer nuevas plantillas/scripts/etc para producir los archivos de salida está bien.

• Sea conservador en sus ediciones. Si bien se necesitan muchas actualizaciones, esto ha existido durante 20 años y lo será para muchos más. No hay prisa.

• No hay ediciones de estilo por ahora. Limpiezas sí; Pero un nuevo diseño/diseño esperará.

Cómo enviar cambios

Una 'solicitud de extracción' en GitHub es la mejor manera. Enviar un parche a la lista de trabajadores CPAN al mismo tiempo será una buena manera de obtener una revisión entre pares. Es más probable que un cambio con algunos votos "+1" de la lista sea extraído de manera expedente.

Cómo funciona

Instale el kit de herramientas de plantilla y los otros requisitos con cpanm ejecutando make install .

Para obtener los datos necesarios para el Sitio, ejecute make update-data update-daily .

Entonces corre make .

Esto a su vez ejecutará ttree y generará archivos de salida en el directorio html/ .

Los archivos de imagen se copian claramente al directorio html/ .

Todo lo demás se procesa a través del kit de herramientas de plantilla.

Solo los archivos .html obtienen la "plantilla maestra" aplicada automáticamente.

Correr bajo Docker

Experimental, puedes construir el contenido de esas plantillas con:

 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