filecoin foundation site

Site Web de la Fondation Filecoin

Remarque : ces documents seront développés dans une prochaine itération du site.

Aperçu

• Ceci est le référentiel du site Web de la Fondation Filecoin (fil.org)

• Ce dépôt représente un site statique qui nécessite une compilation, mais peut ensuite être servi comme ressource statique

• Ce site est hébergé sur IPFS et est compatible avec les URL relatives, pour les chemins de passerelle IPFS et IPNS

• Les ressources du site sont servies de manière statique, mais la navigation interne est virtualisée : autrement dit, le site fait office de SPA lors de la navigation sur le client.

• Bien qu'il s'agisse d'un site statique, cette application peut être étendue à tout moment vers une application complète en modifiant la target dans les paramètres.

Empiler

• Nécessite nodeJS et a été testé sur le nœud 16
• Utilise un framework Vue, nuxtJS, déployé en mode statique

Construire

Pour construire ce site localement

• Cloner ce dépôt
• Assurez-vous que NodeJS 16 ou plus récent est installé
• Pour créer un site statique
  • Exécutez npm ci && npm run generate
  • Un répertoire dist est créé, qui contient la sortie statique du site
• À exécuter localement, pour des fonctionnalités telles que le rechargement à chaud
  • Exécutez npm ci && npm run dev
  • Le site sera disponible en temps réel via une URL localhost
  • Les ressources sont compilées au cours de ce processus ; par exemple, tous les styles SCSS sont convertis en CSS et arborescents

Structure

Les domaines clés de ce dépôt comprennent

• /pages - Tous les modèles de pages
• /components - Chaque collection d'éléments réutilisables est résumée en un composant, et la plupart des composants acceptent diverses propriétés qui déterminent la façon dont ils sont rendus.
• /static - Ressources statiques qui seront disponibles après la compilation
• /assets/scss - Les styles globaux de l'application sont disponibles ici dans SASS/SCSS, des styles plus spécifiques peuvent être trouvés au bas des pages et des composants .vue (composants à fichier unique sur vuejs.org)
• /assets/svgs - Contient de l'iconographie ou d'autres petits vecteurs, au format SVG
• /content - Le contenu du site, qui est édité à l'aide du CMS Forestry

URL et branches

• Staging - develop des builds vers a non public url
• Production - versions main sur fil.org
• Contenu - content est une branche dans laquelle le CMS écrit
  • Lorsqu'un pull est demandé contre main , la branche content sera automatiquement approuvée par une action Github
• Chaque PR générera également un lien d'aperçu de build IPFS, afin qu'il puisse être validé avant d'être fusionné

Gestion du contenu

• Modifier le contenu directement
  • Le contenu structuré peut être trouvé dans les fichiers json
  • Le contenu écrit de type paragraphe peut être trouvé dans les fichiers md , au format markdown
  • Voir le répertoire content/pages/
• Modification du contenu via le CMS
  • Le contenu peut être modifié via Forestry.io et nécessite une connexion
  • Le contenu global du site, comme les métadonnées par défaut, est modifiable dans la section general
  • Le contenu structuré est affiché en blocs par page (voir la section pages )
  • Le contenu du blog est entièrement modifiable dans un éditeur de démarques Wysiwyg
  • Les médias peuvent être téléchargés directement dans le référentiel via la section media , après quoi ils peuvent être utilisés dans n'importe quel domaine Rich Media.