Un site axé sur la communauté avec Eleventy: Préparer les contributions

Eleventy (11ty) est devenu mon générateur de sites statique incontournable. Sa vitesse, sa flexibilité et sa nature non opinée le rendent idéal pour divers projets, y compris des sites Web communautaires comme Style Stage, une vitrine CSS propulsée par les contributions communautaires. Les forces d'Eleventy pour ce type de projet incluent: les versions de feux de foudre, la flexibilité du modèle, la création et le rendu de fichiers polyvalents, la prise en charge de plusieurs langues de modèles (HTML, Markdown, Nunjucks) et des performances élevées en raison de sa sortie HTML statique.

La clé d'un site à succès axé sur la communauté avec Eleventy est sa capacité à générer dynamiquement des pages à partir de sources de données. Cet article décrit les étapes essentielles précodantes pour construire un tel site.

Aperçu de la série:

1. Préparation des contributions (article en cours)
2. Construire le site (article suivant)

Construire un site Web de communauté florissante: considérations clés

La création d'un site axé sur la communauté était complexe. Cependant, avec des outils modernes et autres, le processus est considérablement rationalisé. Avant d'inviter des contributeurs, considérez ces étapes cruciales:

1. Définir l'accès des contributeurs

Décidez quels contributeurs de contenu peuvent modifier. Pour l'étape de style, un fichier JSON permet aux contributeurs de soumettre des demandes de traction avec des métadonnées utilisées pour générer leurs pages. Vous pouvez également autoriser les téléchargements d'actifs ou plusieurs fichiers de données pour la catégorisation. Considérez la portée des contributions et votre capacité d'examen pour assurer une communauté gérable. Les actions GitHub peuvent automatiser les vérifications des fichiers non valides.

2. Établir des directives claires

Des directives bien définies sont essentielles. Ces directives doivent être documentées dans un fichier CONTRIBUTING.md dans votre référentiel GitHub. Ce fichier apparaît automatiquement lorsque les contributeurs créent des demandes de traction ou des problèmes. Adressez les licences de contenu, l'attribution d'auteur et les politiques de contenu acceptables. Le stade de style, par exemple, spécifie les critères de rejet pour des images inappropriées ou des violations de lignes directrices.

3. Implémentez le flux de travail et l'automatisation

Eleventy gère la construction du site, mais d'autres outils comme Netlify et GitHub améliorent le processus de contribution. Netlify crée des aperçus de déploiement pour chaque demande de traction, permettant aux contributeurs de tester leurs soumissions et de gagner du temps. GitHub facilite la discussion publique et la responsabilité. Pour des mises à jour de données plus fréquentes, envisagez d'utiliser IFTTT ou Zapier pour planifier des déploiements réguliers. Notez que ce flux de travail oblige les contributeurs à avoir des comptes GitHub.

4. Choisissez une méthode de communication

Déterminez l'importance de notifier les contributeurs des mises à jour. Style Stage utilise une newsletter hebdomadaire (gérée à l'aide de Forms Netlify, de NetLify Fonctions et Buttondown, comme détaillé dans l'article de Matthew Ström "Utilisation de Formulaires NetLify et Netlify pour créer un widget d'inscription par e-mail"). Les alternatives incluent les notifications ou les versions du repo GitHub.

5. Recruter et engager les contributeurs

Promouvoir votre projet pour trouver des contributeurs. Style Stage a utilisé des sondages Twitter et une campagne "Call pour les contributeurs", s'engager avec des contributeurs potentiels et les transformer en défenseurs du projet. Un lancement en direct a également contribué à susciter l'intérêt. N'oubliez pas de vous engager activement avec votre communauté et de fournir des voies pour la participation. Mettez en surbrillance les opportunités de contribution dans le contenu de votre site.

6. Configurer les paramètres du référentiel

Assurez-vous que votre référentiel est public et comprend des fichiers essentiels de «santé communautaire»:

• README.md : Description du projet.
• CONTRIBUTING.md : directives de soumission.
• Tirez le modèle de demande: un modèle structuré pour les soumissions.

Implémentez les règles de protection des succursales (paramètres → branches) pour exiger des avis de demande de traction avant de fusionner vers la branche principale.

Étapes suivantes

Cet article fournit une base pour construire un site axé sur la communauté avec Eleventy. Le prochain article se plongera dans le code, créant un projet de démarrage Eleventy que vous pouvez adapter pour votre propre communauté ou votre site Web personnel.

Aperçu de la série:

1. Préparation des contributions (article en cours)
2. Construire le site (article suivant)

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!