incubator

Site da Apache Incubator

Este é o conteúdo e a criação de scripts para http://incubator.apache.org/

Contribuindo para o conteúdo do site

Você pode bifurcar em https://github.com/apache/incubator, testar suas alterações conforme descrito abaixo e aumentar uma solicitação de tração.

Use a lista de discussão [email protected] para entrar em contato com o PMC da incubadora que gerencia este site.

Publicação automatizada - dados do site e embreagem

Os compromissos com a filial master são automaticamente verificados e construídos usando o build_site.sh pelo site Git Incubator - Parte 2 Jenkins Job. Os resultados são empurrados para a pasta de content da filial asf-site , que, por sua vez, é publicada automaticamente para http://incubator.apache.org/ pelo mecanismo gitwcsub da ASF.

Os dados para http://incubator.apache.org/clutch/ leva mais tempo para ser construído, para que sejam tratados por uma análise de embreagem SVN separada-Parte 1 Jenkins Job que executa o script build_clutch.sh , que está programado para executar diariamente e também é acionado por SVN alterações. Os resultados são armazenados na pasta reserve da filial do asf-site

Por enquanto, os dados da embreagem ainda são gerenciados no SVN, em http://svn.apache.org/repos/asf/incubator/public/trunk/, consulte os scripts de construção para obter mais informações. A pasta Projects (páginas de status de podling) e as pastas de limpeza de IP também ainda estão no SVN e o HTML é construído usando ant docs no script build_clutch.sh .

Quaisquer falhas de compilação são relatadas como [email protected] Lista de discussão.

Pré -requisitos para a construção do site localmente

O site é construído usando modelos JBake e Groovy. As compilações para o site exigem acesso à Internet.

• Instale o jbake de http://jbake.org/download.html
  • Atualmente, parece que a versão 2.6.0 ou maior é necessária.
• Crie uma variável de ambiente JBAKE_HOME apontando para sua instalação de jbake, por exemplo
  • export JBAKE_HOME=/usr/local/Cellar/jbake/2.6.4
• Certifique -se de ter uma JVM localmente, por exemplo, OpenJdk

Construindo e testando o site localmente

Para testar o site localmente, use

 ./build_local.sh -b -s

Isso constrói o site, o serve localmente em http: // localhost: 8820/e reconstrua o conteúdo rapidamente se alguma alteração for feita.

Esse script pode ser chamado com qualquer um dos argumentos que você passaria para JBake.

Construindo o conteúdo da embreagem e o Legacy SVN (se você souber o que está fazendo)

Aviso Não execute os scripts de construção da embreagem, a menos que você tenha certeza de que os entenda e tenha cuidado para não comprometer nenhum dos ativos e páginas resultantes no ramo Git Master. Esse conteúdo e dados só estão comprometidos com a pasta reserve da filial asf-site conforme mencionado abaixo.

O script build_local_clutch.sh pode ser usado para criar os dados da embreagem, mas isso é atualizado automaticamente pelo Jenkins Builds como build_clutch.sh mencionado abaixo, para que não seja necessário, a menos que você queira testar isso.

Asidoctor

A maioria das páginas do site é escrita usando asidoctor. Embora seja uma forma de asciidoc, ele tem algumas diferenças de sintaxe que valem a pena revisar

Modelos groovy

Os modelos do site são escritos em scripts Groovy. Embora os arquivos terminem com .gsp , eles não são arquivos GSP e não têm acesso para marcar bibliotecas. Você pode executar o código personalizado neles, semelhante ao que é feito no homepage.gsp e no ProjectSpage.gsp.

Arquivos de dados da embreagem

Além das páginas da embreagem, vários arquivos de dados são fornecidos:

• Clutch.json contém a mais recente análise da embreagem para todos os podlings atuais.
• Clutch.txt contém uma lista dos podlings atuais,
• RELATÓRIO_DUE_1.TXT Listas de discussão dev para podlings Reporting no Grupo 1.
• RELATÓRIO_DUE_2.TXT Listas de discussão de dev para podlings Reporting no Grupo 2.
• RELATÓRIO_DUE_3.TXT Listas de discussão dev para podlings Reporting no Grupo 3.