filecoin foundation site

Веб-сайт Фонда Filecoin

Примечание. Эти документы будут расширены в будущей версии сайта.

Обзор

• Это репозиторий веб-сайта Filecoin Foundation (fil.org).

• Этот репозиторий представляет собой статический сайт, который требует компиляции, но затем может служить статическим ресурсом.

• Этот сайт размещен на IPFS и совместим с относительными URL-адресами для путей шлюза IPFS и IPNS.

• Ресурсы сайта обслуживаются статически, но внутренняя навигация виртуализируется: другими словами, сайт действует как SPA при просмотре на клиенте.

• Хотя это статический сайт, это приложение можно в любой момент расширить до полноценного приложения, изменив target в настройках.

Куча

• Требуется nodeJS, протестировано на узле 16.
• Использует фреймворк Vue nuxtJS, развернутый в статическом режиме.

Строить

Чтобы создать этот сайт локально

• Клонировать этот репозиторий
• Убедитесь, что установлен NodeJS 16 или новее.
• Чтобы создать статический сайт
  • Запустите npm ci && npm run generate
  • Создается каталог dist , который содержит выходные данные статического сайта.
• Для локального запуска для таких функций, как горячая перезагрузка
  • Запустите npm ci && npm run dev
  • Сайт будет доступен в режиме реального времени через URL-адрес локального хоста.
  • В ходе этого процесса компилируются ресурсы; например, все стили SCSS преобразуются в CSS и подвергаются древовидному преобразованию.

Структура

Ключевые области этого репо включают в себя

• /pages — все шаблоны страниц.
• /components — каждая повторно используемая коллекция элементов абстрагируется до компонента, и большинство компонентов принимают различные свойства, определяющие способ их отображения.
• /static — Статические ресурсы, которые будут доступны после компиляции.
• /assets/scss — глобальные стили для приложения доступны здесь, в SASS/SCSS, более конкретные стили можно найти внизу страниц и компонентов .vue (однофайловые компоненты на vuejs.org).
• /assets/svgs — содержит иконку или другие небольшие векторные изображения в формате SVG.
• /content — Содержимое сайта, редактируемое с помощью Forestry CMS.

URL-адреса и ветки

• Промежуточный этап — develop сборок для a non public url
• Производство — main сборки на fil.org
• Контент — content — это ветка, в которую пишет CMS
  • При запросе pull для main ветка content будет автоматически одобрена действием Github.
• Каждый PR также будет генерировать ссылку предварительного просмотра сборки IPFS, чтобы ее можно было проверить перед объединением.

Управление контентом

• Редактирование контента напрямую
  • Структурированный контент можно найти в файлах json .
  • Письменный контент типа абзаца можно найти в файлах md в формате уценки.
  • См. каталог content/pages/
• Редактирование контента через CMS
  • Контент можно редактировать через Forestry.io, для этого требуется вход в систему.
  • Глобальный контент сайта, например метаданные по умолчанию, можно редактировать в general разделе.
  • Структурированный контент отображается блоками для каждой страницы (см. раздел pages ).
  • Содержимое блога полностью редактируется в редакторе уценки wysiwyg.
  • Медиафайлы можно загрузить непосредственно в репозиторий через раздел media , после чего их можно будет использовать в любом мультимедийном поле.