filecoin foundation site

Sitio web de la Fundación Filecoin

Nota: estos documentos se ampliarán en una versión futura del sitio.

Descripción general

• Este es el repositorio del sitio web de la Fundación Filecoin (fil.org)

• Este repositorio representa un sitio estático que requiere compilación, pero que luego puede servir como un recurso estático.

• Este sitio está alojado en IPFS y es compatible con URL relativas, para rutas de puerta de enlace IPFS e IPNS

• Los recursos del sitio se sirven de forma estática, pero la navegación interna está virtualizada: en otras palabras, el sitio actúa como un SPA cuando se navega en el cliente.

• Si bien es un sitio estático, esta aplicación se puede ampliar en cualquier momento a una aplicación completa cambiando el target en la configuración.

Pila

• Requiere nodeJS y ha sido probado en el nodo 16
• Utiliza un marco Vue, nuxtJS, implementado en modo estático

Construir

Para construir este sitio localmente

• Clonar este repositorio
• Asegúrese de que NodeJS 16 o posterior esté instalado
• Para construir un sitio estático
  • Ejecute npm ci && npm run generate
  • Se crea un directorio dist , que contiene la salida del sitio estático.
• Para ejecutar localmente, para funciones como recarga en caliente
  • Ejecute npm ci && npm run dev
  • El sitio estará disponible en tiempo real a través de una URL de localhost
  • Los recursos se recopilan en este proceso; por ejemplo, todos los estilos SCSS se convierten a CSS y se agitan en árbol.

Estructura

Las áreas clave de este repositorio incluyen

• /pages - Todas las plantillas de páginas
• /components : cada colección reutilizable de elementos se abstrae en un componente y la mayoría de los componentes aceptan varias propiedades que determinan la forma en que se representan.
• /static : recursos estáticos que estarán disponibles después de la compilación
• /assets/scss : los estilos globales para la aplicación están disponibles aquí en SASS/SCSS; se pueden encontrar estilos más específicos en la parte inferior de las páginas y componentes .vue (componentes de un solo archivo en vuejs.org)
• /assets/svgs : contiene iconografía u otros vectores pequeños, en formato SVG
• /content : el contenido del sitio, que se edita utilizando el CMS forestal.

URL y ramas

• Puesta en escena: develop compilaciones en a non public url
• Producción: compilaciones main para fil.org
• Contenido: content es una rama en la que escribe el CMS.
  • Cuando se solicita extracción contra main , la rama content se aprobará automáticamente mediante una acción de Github.
• Cada PR también generará un enlace de vista previa de compilación de IPFS, para que pueda validarse antes de fusionarse.

Gestión de contenido

• Editar contenido directamente
  • El contenido estructurado se puede encontrar en archivos json
  • El contenido escrito tipo párrafo se puede encontrar en archivos md , en formato Markdown.
  • Ver el content/pages/ directorio
• Editar contenido a través del CMS
  • El contenido se puede editar a través de Forestry.io y requiere iniciar sesión
  • El contenido global del sitio, como los metadatos predeterminados, se puede editar en la sección general .
  • El contenido estructurado se muestra en bloques por página (consulte la sección pages )
  • El contenido del blog es completamente editable en un editor de rebajas de wysiwyg
  • Los medios se pueden cargar directamente al repositorio a través de la sección media , después de lo cual se pueden usar en cualquier campo de medios enriquecidos.