Ваши данные входят, развёрнутый сайт выходит, а всё операционное остаётся рядом.

Что входит

Всё, что слева от потока, ваше и остаётся вашим. Ничего из этого не код платформы.

• Конфигурация

  Идентичность, языки, навигация, переключатели функций и решения об интерфейсе — проверяемые настройки, а не разбросанные константы.

• Контент

  Ваши страницы и коллекции как файлы в вашем репозитории, каждая со своим заголовком и текстом.

• Переводы

  Словарь интерфейса для каждого языка и каталог контента этого языка.

• Бренд и ресурсы

  Логотипы, favicon, превью для соцсетей и любая необязательная графика, каждая в именованной роли.

Любой из этих элементов можно менять, не затрагивая архитектуру основы.

Что Foundation с ними делает

Foundation читает входные данные и создаёт сайт. Это та часть, которую вам не нужно было создавать, и она работает при сборке и развёртывании, а не пока посетитель ждёт.

1. 1

   Валидация

   Конфигурация и словари проверяются по схемам, поэтому ошибочная настройка останавливает сборку вместо того, чтобы дойти до посетителя.

2. 2

   Контент и маршрутизация

   Страницы загружаются через интерфейс контента, получают стабильные адреса и постранично возвращаются к языку по умолчанию, если перевода нет.

3. 3

   Представление

   Контент и идентичность собираются общей системой токенов в светлой или тёмной схеме при любой ширине экрана.

4. 4

   Видимость и метаданные

   Заголовки, канонические адреса, языковые аннотации, структурированные данные и вывод sitemap и robots генерируются из вашей конфигурации.

5. 5

   Точки интеграции

   Там, где вы включили возможность, Foundation рисует подключение и передаёт намерение посетителя вашему провайдеру.

6. 6

   Выход

   Статический сайт, собранный и развёрнутый в вашем аккаунте и на вашем домене.

Здесь нет сервиса в аренду: тот же репозиторий можно собрать везде, где вы можете его запустить.

Что работает рядом с Foundation, а не внутри

Foundation выражает намерение — записаться, получить маршрут, отправить сообщение — и назначение за этим намерением определяете вы. Сам Foundation этими системами не становится.

Внешний сервис подключается через точку интеграции; сервис сохраняет свои данные, правила и аккаунт.

От получения Foundation до сайта, который вы поддерживаете

Десять практических шагов. Детали — в руководствах репозитория; эта страница показывает форму работы.

1. 1

   Получить

   Клонируйте или форкните публичный репозиторий в свой аккаунт.

2. 2

   Запустить

   Установите и запустите, чтобы увидеть работающий сайт до любых изменений.

3. 3

   Настроить

   Определите идентичность, языки, навигацию и переключатели функций в конфигурации.

4. 4

   Добавить идентичность

   Замените именованные визуальные роли своими логотипами, favicon и превью.

5. 5

   Написать контент

   Опишите страницы и коллекции как файлы в репозитории.

6. 6

   Выбрать возможности

   Включите только нужное; неиспользуемая возможность не добавляет маршрутов и заполнителей.

7. 7

   Подключить провайдеров

   Направьте каждую включённую точку интеграции на уже используемый сервис.

8. 8

   Проверить

   Запустите шлюз качества и проверку в браузере, чтобы проблемы нашли раньше посетителей.

9. 9

   Развернуть

   Соберите и разверните в своём аккаунте и на своём домене.

10. 10

    Поддерживать

    Храните контент и конфигурацию у себя и принимайте будущие улучшения тогда, когда решите.

Руководства

Этот сайт никогда не становится второй копией руководств на GitHub.

Кто чем владеет

Foundation — это инфраструктура, которой вы владеете, а не сервис в аренду. Разделение намеренно простое.

Вы можете уйти, и всё, чем вы владеете, уйдёт с вами: репозиторий — ваш источник.

Что происходит при изменении чего-либо

Два осознанных правила делают это предсказуемым: контент определяет существование, конфигурация определяет представление, и ни один не может молча создать другой.

• Название, слоган или описание сайта

  Шапка, подвал, заголовки страниц, метаданные соцсетей и структурированные данные.

• Файл самой страницы

  Контент этой страницы и сгенерированный sitemap.

• Файл словаря

  Строки интерфейса этого языка.

• Токен акцентного цвета

  Все брендовые и акцентные элементы сайта.

• Логотип, favicon или превью

  Только соответствующая визуальная роль.

• Конфигурация навигации

  Порядок и подписи меню, но никогда наличие самой страницы.

• Переключатель функции

  Существуют ли маршруты и поверхность этой возможности.

• Место работы

  Статус работы, адрес, маршруты и структурированные данные этого места.

Отсутствующий необязательный элемент не рисует ничего: ни страницы-заполнителя, ни заимствованной графики, ни пустой оболочки.

Почему ошибочное изменение падает рано

Конфигурация проверяется при сборке сайта, а не когда приходит посетитель, поэтому ошибки видны сразу.

• Неизвестная или неверно написанная настройка отклоняется, а не игнорируется
• Структурно недопустимое значение останавливает сборку, называя настройку
• Настроенная, но неполная возможность падает, а не молча ничего не рисует
• Объявленный язык без словаря падает, а не тихо показывает другой язык

Поэтому цикл такой: изменить файл, собрать и увидеть правду, а не обнаружить её в продакшене.

Принимать улучшения, не теряя работу

Конфигурация, контент, словари и ресурсы находятся в своих областях, и именно это позволяет принять последующее улучшение, не переписывая сайт.

• Области самого сайта остаются вашими при обновлении
• Вы решаете, когда принимать улучшение, а не вас к нему подталкивают
• Репозиторий фиксирует, что и почему изменилось, чтобы решение было обоснованным

Читать руководство по обновлению

Это документированная модель. Это не сервис автоматического обновления, и проект его не заявляет.

Начните с работающей основы

Прочитайте возможности, посмотрите два бизнеса, которые уже работают на ней, и начните с того, что уже работает.

• Открыть демо
• Смотреть на GitHub