filecoin foundation site

Filecoin 基金会网站

注意：这些文档将在站点的未来迭代中扩展

概述

• 这是Filecoin 基金会网站 (fil.org) 的存储库

• 该存储库代表一个需要编译的静态站点，但随后可以用作静态资源

• 该站点托管在 IPFS 上，并且与 IPFS 和 IPNS 网关路径的相对 URL 兼容

• 站点的资源是静态提供的，但内部导航是虚拟化的：换句话说，当在客户端上浏览时，站点充当 SPA

• 虽然是静态站点，但该应用程序可以随时通过更改设置中的target扩展为完整的应用程序

堆

• 需要nodeJS并已在node 16上测试
• 使用Vue框架nuxtJS，以静态模式部署

建造

在本地构建此站点

• 克隆这个仓库
• 确保安装了 NodeJS 16 或更高版本
• 构建静态站点
  • 运行npm ci && npm run generate
  • 创建目录dist ，其中包含静态站点输出
• 在本地运行，用于热重载等功能
  • 运行npm ci && npm run dev
  • 该站点将通过本地主机 URL 实时可用
  • 资源在此过程中被编译；例如，所有 SCSS 样式都转换为 CSS 并进行 tree-shaken

结构

该回购协议的关键领域包括

• /pages - 所有页面模板
• /components - 每个可重用的元素集合都被抽象为一个组件，并且大多数组件接受决定它们呈现方式的各种属性
• /static - 编译后可用的静态资源
• /assets/scss - 应用程序的全局样式可在 SASS/SCSS 中找到，更具体的样式可以在.vue页面和组件的底部找到（vuejs.org 上的单文件组件）
• /assets/svgs - 包含 SVG 格式的图像或其他小矢量
• /content - 站点的内容，使用 Forestry CMS 编辑

URL 和分支

• 暂存 - develop构建到a non public url
• 生产 - fil.org的main构建
• 内容 - content是 CMS 写入的分支
  • 当针对main请求拉取时， content分支将由 Github 操作自动批准
• 每个 PR 还将生成一个 IPFS 构建预览链接，因此可以在合并之前进行验证

管理内容

• 直接编辑内容
  • 结构化内容可以在json文件中找到
  • 书面段落式内容可以在md文件中找到，markdown格式
  • 查看content/pages/目录
• 通过 CMS 编辑内容
  • 内容可以通过 Forestry.io 进行编辑，并且需要登录
  • 全局站点内容（如默认元数据）可在general部分中编辑
  • 结构化内容以每页的块形式显示（请参阅pages部分）
  • 博客内容可以在所见即所得的 Markdown 编辑器中完全编辑
  • 媒体可以通过media部分直接上传到存储库，之后可以在任何富媒体领域使用