web.dev

web.dev [archivé]

Remarque: Ce site est migré vers une nouvelle plate-forme et ce référentiel est disponible en mode en lecture seule. Nous ne fusions pas de nouvelles demandes de traction . Veuillez soulever des problèmes de contenu dans le nouveau suivi des numéros.

web.dev est la ressource ultime pour les développeurs de tous les horizons pour apprendre, créer et résoudre sur le Web. Il est censé non seulement éduquer les développeurs, mais les aider à appliquer ce qu'ils ont appris sur tout site sur lequel ils travaillent, que ce soit personnel ou commercial.

---

[Readme archivé]

Construire le site?

Vous aurez besoin d'une version récente de Node: V14 (LTS) ou plus. Pour vérifier votre version de nœud, exécutez node -v dans votre terminal.

Si vous n'avez pas de nœud ou si vous devez mettre à niveau, nous vous recommandons d'utiliser le Node Version Manager (NVM).

Cloner le repo

git clone https://github.com/GoogleChrome/web.dev.git

Changer le répertoire dans le dossier créé

 cd web.dev

Installer des dépendances

npm ci

Démarrer un serveur local pour prévisualiser le site

npm run dev

Ouvrez http://localhost:8080/ pour voir le site localement. Les modifications apportées aux actifs reconstruiront le site. Actualiser pour voir vos modifications.

Configurer des drapeaux de construction

La construction de l'ensemble du site peut prendre un certain temps car elle est d'environ mille pages. Si vous souhaitez accélérer massivement vos temps de construction, nous vous suggérons de définir des drapeaux de construction pour ignorer certaines sections.

• Créez un fichier .env à la racine de votre projet
• Ajouter ce qui suit:

 # Ignore ALL site content
ELEVENTY_IGNORE=true

# Only build the directories you're working on.
# Note, this is a JSON string so you must use double quotes.
ELEVENTY_INCLUDE=["blog", "vitals"]

Environnements?

Réglez ELEVENTY_ENV=prod pour forcer les constructions de production. Il s'agit de la valeur par défaut lors de l'exécution de "stade" ou de "déploiement". Aucune autre option pour ELEVENTY_ENV n'est prise en charge, bien que notre configuration d'Eleventy Site ne soit pas par défaut si non spécifiée.

La construction de production nécessite actuellement beaucoup de mémoire, au point où node peut sortir avec des erreurs le long de la ligne de

FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory

v8::internal::V8::FatalProcessOutOfMemory(v8::internal::Isolate * , char const * , bool) [node]

La quantité exacte d'espace de tas requise varie d'un ordinateur à l'autre et d'une version du node . Si vous avez besoin d'une version de production locale, mais à court de mémoire, vous pouvez augmenter la taille du tas en ajoutant --node-options '--max_old_space_size=8192' (pour attribuer 8 Go d'espace de tas) à la commande npm , avant d' run . Par exemple:

ELEVENTY_ENV=prod npm --node-options ' --max_old_space_size=8192 ' run build

Mise en scène?

Lorsque vous envoyez une demande de traction, il sera automatiquement mis en scène pour vous. Gardez un œil sur le netlify bot pour commenter la demande de traction avec votre URL unique.

Déploiement du site

Déploiements automatiques

Le site créera et déploiera automatiquement la succursale principale toutes les heures, le lundi. Si vous venez de fusionner un article, il devrait être mis en ligne en haut de l'heure suivante.

Déploiements manuels

Pour déployer manuellement le site, vous devrez être membre de l'une de ces équipes Google:

• web.dev-Eng
• web.dev-propriétaires

1. Accédez à la page Cloud Build Triggers.
2. Cliquez sur le bouton Exécuter pour le déclencheur nommé Deploy .
3. Dans le tiroir latéral qui s'ouvre, cliquez sur le bouton Exécuter le déclencheur pour le déclencheur de la branche principale .

Remarque: Web.dev se déploie automatiquement toutes les heures s'il y a un nouvel engagement dans la branche main . Les déploiements manuels ne doivent se produire que lorsqu'une build échoue ou si les déploiement automobile sont désactivés.

Débogage?

Si vous devez déboguer le processus de construction du site:

1. Ajoutez une déclaration debugger à .eleventy.js
2. Run npm run debug:eleventy
3. Allez à about://inspect pour attacher au processus en cours.