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部分直接上傳到儲存庫，之後可以在任何富媒體領域使用