incubator

Сайт инкубатора Apache

Это сценарии контента и сборки для http://incubator.apache.org/

Вклад в контент веб -сайта

Вы можете раскошелиться на https://github.com/apache/incubator, проверить свои изменения, как описано ниже, и поднять запрос на вытяжение.

Используйте список рассылки [email protected], чтобы связаться с инкубатором PMC, который управляет этим веб -сайтом.

Автоматизированная публикация - данные веб -сайта и сцепления

Коммитами в master ветвь автоматически проверяются и создаются с использованием build_site.sh на сайте инкубатора GIT - Часть 2 Jenkins Jab. Результаты перемещаются в папку content ветви asf-site , которая, в свою очередь, автоматически опубликована по адресу http://incubator.apache.org/ с помощью механизма gitwcsub ASF.

Данные для http://incubator.apache.org/clutch/ требуется больше времени для строительства, поэтому его обрабатывается отдельным анализом сцепления SVN-задание Jenkins Часть 1, которая запускает сценарий build_clutch.sh , который планируется работать ежедневно, а также запускается с помощью SVN-изменений, используя Job Jobs Jonkins-Jenkins. Результаты хранятся в reserve папке филиала asf-site

На данный момент, когда данные сцепления все еще управляются в SVN, по адресу http://svn.apache.org/repos/asf/incubator/public/trunk/, см. Сценарии сборки для получения дополнительной информации. Папка Projects (страницы состояния моклина) и папки IP-Clearance также все еще находятся в SVN, а HTML строится с использованием ant docs в сценарии build_clutch.sh .

Любые сбои сборки сообщаются в список рассылки [email protected] .

Предварительные условия для построения сайта на местном уровне

Сайт построен с использованием шаблонов JBAKE и Groovy. Сборки для веб -сайта требуют доступа к Интернету.

• Установить jbake с http://jbake.org/download.html
  • В настоящее время требуется версия 2.6.0 или более.
• Создайте переменную среды JBAKE_HOME указывающая на вашу установку Jbake, например,
  • export JBAKE_HOME=/usr/local/Cellar/jbake/2.6.4
• Убедитесь, что у вас есть JVM на местном уровне, например, OpenJDK

Создание и тестирование сайта на местном уровне

Чтобы проверить сайт локально, используйте

 ./build_local.sh -b -s

Это создает сайт, обслуживает его на локальном уровне по адресу http: // localhost: 8820/и восстанавливает контент довольно быстро, если внесены какие -либо изменения.

Этот сценарий может быть вызван с любым из аргументов, которые вы бы провели в JBAKE.

Создание контента сцепления и устаревшего SVN (если вы знаете, что делаете)

Предупреждение. Не запускайте сценарии сборки сцепления, если вы не уверены, что понимаете их, и, пожалуйста, будьте осторожны, чтобы не совершать ни одного из полученных активов и страниц в Master Branch Git. Этот контент и данные привязаны только к reserve папке филиала asf-site как упомянуто ниже.

Сценарий build_local_clutch.sh может использоваться для создания данных сцепления, но это автоматически обновляется сборщиками Jenkins, как build_clutch.sh упомянутое ниже, так что это не требуется, если вы не хотите проверить это.

Аскидоктор

Большинство страниц на сайте написаны с использованием Asciidoctor. Хотя это форма Asciidoc, у него есть некоторые синтаксические различия, которые стоит рассмотреть

Групкие шаблоны

Шаблоны сайта написаны в Groovy сценариях. Несмотря на то, что файлы заканчиваются .gsp , они не являются файлами GSP и не имеют доступа к библиотекам тегов. Вы можете запустить пользовательский код в них, аналогично тому, что делается в Homepage.gsp и ProjectSpage.gsp.

Файлы данных сцепления

В дополнение к страницам сцепления предоставлено несколько файлов данных:

• clutch.json содержит последний анализ сцепления для всех токовых накопителей.
• clutch.txt содержит список текущих подделок,
• report_due_1.txt Dev Списки рассылки для подбодников отчетности в группе 1.
• report_due_2.txt Dev Списки рассылки для подбодников отчетности в группе 2.
• report_due_3.txt Dev Списки рассылки для подбодников отчетности в группе 3.