Перейти к содержимому

Внедрение

Возьмите исходный код и сделайте его своим

Foundation открыт и рассчитан на самостоятельную работу. Получите репозиторий, запустите, замените идентичность и контент, проверьте и разверните в своём аккаунте. Публичный репозиторий — канонический технический источник, а эта страница — самый короткий честный путь к нему.

  • Чтобы пользоваться программным обеспечением, не нужны аккаунт Foundation и лицензионные платежи. Хостинг и домен — ваши расходы.
  • Каждый документ, упомянутый здесь, находится в публичном репозитории и версионируется вместе с описываемым кодом.
  • Ничто на этой странице не нужно принимать на веру: репозиторий в одном клике.

Три законных способа внедрения

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

  • Сделать самому

    Для технически подготовленных внедренцев: получите репозиторий, запустите локально, настройте идентичность, напишите контент, проверьте и разверните. Всё необходимое есть в публичном репозитории, и ничто там не зависит от Provelopment.

  • Использовать своего разработчика или агентство

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

  • Попросить помощи у Provelopment

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

Ни один из путей не является рекомендуемым: сайт, к которому вы придёте, один и тот же, и исходный код остаётся у вас при любом выборе. Привлекать помощь или обойтись без неё — решение о сервисе, которое можно принять или отменить в любой момент.

Путь от репозитория до работающего сайта

Это вся последовательность внедрения по порядку. Ничего из неё здесь не повторяется: каждый шаг называет документ, который владеет деталями, чтобы этот сайт никогда не стал второй копией, расходящейся с инструкциями репозитория.

  1. 1

    Посмотреть работающие сайты

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

    Открыть демо

  2. 2

    Изучить проект на GitHub

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

    README

  3. 3

    Получить исходный код

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

    Руководство по внедрению

  4. 4

    Запустить локально

    Начальный сайт отображается сразу после установки зависимостей и запуска сервера разработки: это работающий сайт, а не пустая папка, которую нужно заполнить.

    README › быстрый старт

  5. 5

    Настроить идентичность и параметры сайта

    Замените заполнитель идентичности в конфигурации сайта (URL, название, слоган и описание) и определите нужные необязательные возможности. У каждой возможности есть явное отключённое состояние.

    Настройка Foundation

  6. 6

    Написать контент и ресурсы

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

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

  7. 7

    Подключить внешние сервисы при необходимости

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

    Настройка сайта

  8. 8

    Проверить до публикации

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

    Руководство по валидации

  9. 9

    Развернуть в своём аккаунте

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

    Руководство по развёртыванию

  10. 10

    Поддерживать и обновлять

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

    Руководство по обновлению

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

Что нужно перед началом

Foundation — настоящая кодовая база, а не хостинговый конструктор сайтов, поэтому у внедрения есть честные предпосылки. Они скромны, и ни одна не требует провайдера, которого вы не выбирали.

  • Уверенность в современном веб-проекте: один файл конфигурации, файлы Markdown и несколько команд терминала.
  • Аккаунт хостинга, которым вы управляете, и домен, если нужен свой адрес. Руководство по развёртыванию описывает Vercel от начала до конца.
  • Ваша идентичность, контент и изображения вместо заполнителей.
  • Аккаунты внешних сервисов только там, где вы включили интеграцию, которая их требует.

Больше ничего не обязательно. Foundation не требует аккаунта у Provelopment, платного уровня, конкретного хостинг-провайдера или конкретного разработчика.

Ваш сайт принадлежит вам

Foundation — это программное обеспечение, а сайт ваш. Оставаться с Provelopment — решение о сервисе, а не техническая привязка.

  • Исходный код ваш, чтобы его хранить

    Копия репозитория — это ваше развёртывание. Нет шага активации, сервера лицензий и аккаунта, от которого зависит работающий сайт.

  • Развёртывание ваше

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

  • Выбор разработчика ваш

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

  • Выбор провайдеров ваш

    Приём обращений, бронирование, маршруты на карте и аналитика настраиваются для каждого сайта, поэтому провайдеров выбираете вы, а не наследуете готовый набор.

  • Дальнейшая работа остаётся отделимой

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

Foundation — открытый код под Apache License 2.0. Вы можете использовать, изменять, распространять и коммерчески применять собственный код и документацию проекта, в том числе внутри своего проприетарного сайта, при соблюдении условий лицензии: сохраняется копия лицензии и указания об авторстве, изменения не искажаются, а программное обеспечение предоставляется без гарантий. Это лицензия на авторское право: она не даёт прав на название, логотипы и бренд Provelopment, а включённые сторонние материалы сохраняют свою лицензию и указание авторства. Этот абзац — резюме; главенствует текст лицензии.

Читать лицензию

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

Документы, владеющие деталями

Документация Foundation поставляется вместе с кодом, поэтому не может от него отойти. Каждый документ ниже авторитетен в своей теме, даже там, где эта страница иначе повторяла бы его.

  • README

    Что это за проект, как начать, структура репозитория и реальные команды проверки.

  • CUSTOMIZING.md

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

  • ARCHITECTURE.md

    Архитектурный стиль, границы, направление зависимостей и шаблоны интеграции — самый короткий путь от «никогда не видел Foundation» до продуктивной работы.

  • BRAND_ASSETS.md

    Контракт замены брендовых ресурсов: каждая заменяемая визуальная роль в порядке замены.

  • DEPLOYMENT.md

    Runbook выпуска: первое развёртывание, защита непрерывной интеграции, собственный домен и список проверок после развёртывания.

  • instruction-manuals/

    Процедуры: внедрение, настройка, контент, бренд, валидация, развёртывание, обновление и устранение неполадок.

  • LICENSE

    Текст Apache License 2.0, регулирующий использование, изменение и распространение.

Если эта страница и репозиторий когда-нибудь разойдутся, прав репозиторий. Эта страница объясняет форму внедрения, репозиторий его выполняет.

Если нужна помощь, она доступна

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

  • Внедрить Foundation, развернуть его самостоятельно и ни разу не обратиться в Provelopment — полностью успешный результат.
  • Ни одна часть программного обеспечения не зависит от Provelopment, и ни документация, ни код не удерживаются за платным уровнем.
  • Поддержка согласуется отдельно от проекта, и этот сайт не является каналом продаж или поддержки.

Как работает помощь

Порядок важен: сначала Foundation на своих условиях, помощь — потом, если она нужна.

Начните с того места, где вы находитесь

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