incubator

Site Web d'Apache Incubator

Ceci est le contenu et la création de scripts pour http://incubator.apache.org/

Contribution du contenu du site Web

Vous pouvez vous débarrasser de https://github.com/apache/incubator, tester vos modifications comme décrit ci-dessous et soulever une demande de traction.

Utilisez la liste de diffusion géné[email protected] pour contacter l'incubateur PMC qui gère ce site Web.

Publication automatisée - Données sur le site Web et l'embrayage

Les engagements dans la branche master sont automatiquement vérifiés et construits à l'aide de build_site.sh par le site GIT de l'incubateur - Part 2 Jenkins Job. Les résultats sont poussés au dossier content de la branche asf-site qui est à son tour publié automatiquement vers http://incubator.apache.org/ par le mécanisme gitwcsub de l'ASF.

Les données de http://incubator.apache.org/clutch/ prennent plus de temps à construire afin qu'elle soit gérée par une analyse d'embrayage SVN distincte - le travail de Jenkins de la partie 1 qui exécute le script build_clutch.sh qui est planifié pour exécuter quotidiennement et est également déclenché par les modifications SVN en utilisant le travail de jenkins SVN. Les résultats sont stockés dans le dossier reserve de la branche asf-site

Pour l'instant, les données d'embrayage sont toujours gérées dans SVN, sur http://svn.apache.org/repos/asf/incubator/public/trunk/, voir les scripts de construction pour plus d'informations. Le dossier des projets (pages d'état de podling) et les dossiers de protection IP sont également toujours en SVN et le HTML est construit à l'aide ant docs dans le script build_clutch.sh .

Toute échec de construction est signalée sur [email protected] la liste de diffusion.

Prérequis pour créer le site Web localement

Le site Web est construit à l'aide de modèles JBake et Groovy. Les versions du site Web nécessitent un accès Internet.

• Installez JBake à partir de http://jbake.org/download.html
  • Actuellement, il semble que la version 2.6.0 ou plus soit requise.
• Créez une variable d'environnement JBAKE_HOME pointant vers votre installation JBake, par exemple
  • export JBAKE_HOME=/usr/local/Cellar/jbake/2.6.4
• Assurez-vous que vous avez un JVM localement, par exemple OpenJDK

Construire et tester le site localement

Pour tester le site localement, utilisez

 ./build_local.sh -b -s

Cela construit le site, le sert localement sur http: // localhost: 8820 / et reconstruit le contenu assez rapidement si des modifications sont apportées.

Ce script peut être appelé avec l'un des arguments que vous transmetriez à JBake.

Construire le contenu SVN d'embrayage et de héritage (si vous savez ce que vous faites)

AVERTISSEMENT NE PAS exécuter les scripts de construction d'embrayage, sauf si vous êtes sûr de les comprendre, et veillez à ne commettre aucun des actifs et pages résultants à la branche Git Master. Ce contenu et les données ne sont engagés que dans le dossier reserve de la branche asf-site comme mentionné ci-dessous.

Le script build_local_clutch.sh peut être utilisé pour construire les données d'embrayage, mais cela est mis à jour automatiquement par les builds Jenkins comme build_clutch.sh mentionné ci-dessous, donc il n'est pas nécessaire à moins que vous ne vouliez tester cela.

Asciidoctor

La plupart des pages du site sont écrites à l'aide d'Asciidoctor. Bien qu'il s'agisse d'une forme d'Asciidoc, il a des différences de syntaxe qui méritent d'être examinées

Modèles groovy

Les modèles de site sont écrits en scripts groovy. Même si les fichiers se terminent par .gsp ce ne sont pas des fichiers GSP et n'ont pas accès aux bibliothèques de balises. Vous pouvez y exécuter du code personnalisé, similaire à ce qui est fait dans HomePage.gsp et projectSpage.gsp.

Fichiers de données d'embrayage

En plus des pages d'embrayage, plusieurs fichiers de données sont fournis:

• Clutch.json contient la dernière analyse d'embrayage pour tous les podlings actuels.
• Clutch.txt contient une liste de podlings actuels,
• Report_Due_1.txt Listes de diffusion de diffusion pour Podlings Reporting dans le groupe 1.
• Report_Due_2.txt Listes de diffusion de diffusion pour Podlings Reporting dans le groupe 2.
• Report_Due_3.txt Listes de diffusion de diffusion pour Podlings Reporting dans le groupe 3.