cpanorg

CPAN.org Content Repository

Этот репозиторий предназначен для поддержания некопада, неархативного содержания на cpan.org. Обсуждение, связанное с этим, должно быть в списке рассылки CPAN-работников .

Правила редактирования контента

• Не добавляйте новые выходные файлы. Должны быть добавлены только файлы на cpan.org (а затем в их текущее местоположение). Обычно по электронной почте [email protected], чтобы получить новые файлы, включенные здесь. Создание новых шаблонов/сценариев/и т. Д. Для получения выходных файлов хорошо.

• Будьте консервативны в своих изменениях. Хотя необходимо много обновлений, это существует уже 20 лет и будет для многих других. Там нет спешки.

• На данный момент нет практических изменений. Уборки да; Но новый дизайн/макет будет ждать.

Как отправить изменения

«Запрос на вытягивание» на GitHub - лучший способ. Отправка патча в список работников CPAN одновременно будет хорошим способом просмотра сверстников. Изменение с несколькими голосами «+1» из списка, скорее всего, будет сразу же привлечено.

Как это работает

Установите инструментарий шаблона и другие требования с cpanm , запустив make install .

Чтобы получить данные, необходимые для сайта, запустите make update-data update-daily .

Затем make .

Это, в свою очередь, запустит ttree и генерирует выходные файлы в каталоге html/ .

Файлы изображений четко копируются в каталог html/ .

Все остальное обрабатывается с помощью Template Toolkit.

Только файлы .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