filecoin foundation site

Site da Fundação Filecoin

Observação: esses documentos serão expandidos em uma iteração futura do site

Visão geral

• Este é o repositório do site da Filecoin Foundation (fil.org)

• Este repositório representa um site estático que requer compilação, mas pode ser servido como um recurso estático

• Este site está hospedado em IPFS e é compatível com URLs relativos, para caminhos de gateway IPFS e IPNS

• Os recursos do site são atendidos estaticamente, mas a navegação interna é virtualizada: ou seja, o site funciona como um SPA quando navegado no cliente

• Embora seja um site estático, este aplicativo pode ser estendido a qualquer momento para um aplicativo completo, alterando o target nas configurações

Pilha

• Requer nodeJS e foi testado no nó 16
• Usa uma estrutura Vue, nuxtJS, implantada em modo estático

Construir

Para construir este site localmente

• Clonar este repositório
• Certifique-se de que o NodeJS 16 ou mais recente esteja instalado
• Para construir um site estático
  • Execute npm ci && npm run generate
  • Um diretório dist é criado, contendo a saída do site estático
• Para executar localmente, para recursos como hot reload
  • Execute npm ci && npm run dev
  • O site estará disponível em tempo real através de uma URL localhost
  • Os recursos são compilados neste processo; por exemplo, todos os estilos SCSS são convertidos em CSS e agitados em árvore

Estrutura

As principais áreas deste repositório incluem

• /pages – Todos os modelos de página
• /components – Cada coleção reutilizável de elementos é abstraída para um componente, e a maioria dos componentes aceita várias propriedades que determinam a forma como são renderizados.
• /static - Recursos estáticos que estarão disponíveis após a compilação
• /assets/scss - Os estilos globais para o aplicativo estão disponíveis aqui em SASS/SCSS, estilos mais específicos podem ser encontrados na parte inferior das páginas e componentes .vue (componentes de arquivo único em vuejs.org)
• /assets/svgs - Contém iconografia ou outros pequenos vetores, em formato SVG
• /content - O conteúdo do site, que é editado usando o Forestry CMS

URLs e ramificações

• Preparação - develop compilações para a non public url
• Produção - main compilações para fil.org
• Conteúdo - content é um ramo no qual o CMS grava
  • Quando pull solicitado em main , o branch content será aprovado automaticamente por uma ação do Github
• Cada PR também gerará um link de visualização de compilação do IPFS, para que possa ser validado antes de ser mesclado

Gerenciando conteúdo

• Editando conteúdo diretamente
  • O conteúdo estruturado pode ser encontrado em arquivos json
  • O conteúdo escrito do tipo parágrafo pode ser encontrado em arquivos md , em formato markdown
  • Veja o diretório content/pages/
• Edição de conteúdo via CMS
  • O conteúdo pode ser editado via Forestry.io e requer login
  • O conteúdo global do site, assim como os metadados padrão, é editável na seção general
  • O conteúdo estruturado é mostrado em blocos por página (consulte a seção pages )
  • O conteúdo do blog é totalmente editável em um editor de descontos wysiwyg
  • A mídia pode ser carregada diretamente no repositório por meio da seção media e, após esse ponto, ela pode ser usada em qualquer campo de rich media