cpanorg

Repositório de conteúdo cpan.org

Este repositório é para manter o conteúdo não-código não-código no cpan.org. A discussão relacionada a isso deve estar na lista de discussão dos trabalhadores da CPAN .

Regras para editar conteúdo

• Não adicione novos arquivos de saída. Somente arquivos já no cpan.org devem ser adicionados (e depois ao seu local atual). Geralmente, envie um email para [email protected] para obter novos arquivos incluídos aqui. Fazer novos modelos/scripts/etc para produzir os arquivos de saída é bom.

• Seja conservador em suas edições. Embora muitas atualizações sejam necessárias, isso existe há 20 anos e será para muito mais. Não há pressa.

• Sem edições de estilo por enquanto. Limpeza sim; Mas um novo design/layout esperará.

Como enviar mudanças

Uma 'solicitação de tração' no Github é a melhor maneira. Enviar um patch para a lista de trabalhadores da CPAN ao mesmo tempo será uma boa maneira de obter uma revisão por pares. Uma mudança com alguns votos "+1" da lista tem maior probabilidade de ser expedida.

Como funciona

Instale o modelo de ferramentas do modelo e os outros requisitos com cpanm , executando make install .

Para buscar os dados necessários para o site, execute make update-data update-daily .

Em seguida, execute make .

Isso, por sua vez, executará ttree e gerará arquivos de saída no diretório html/ .

Os arquivos de imagem são copiados claramente para o diretório html/ .

Todo o resto é processado através do modelo de ferramenta de modelo.

Somente os arquivos .html obtêm o "Modelo Master" aplicado automaticamente.

Corra sob o Docker

Experimental, você pode criar o conteúdo a partir desses modelos com:

 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