HERON

Начните здесь

Основы

Эти страницы для тех, кто никогда не делал сайт. Каждая занимает десять–двадцать минут и заканчивается тем, что можно проверить: Docker отвечает, страница открывается, push проходит.

Учить программирование или Linux не нужно. Нужны несколько программ и понятная картина того, что происходит с вашим текстом по дороге в интернет. Именно это здесь и есть.

Установка DockerDocker в одном абзаце, установка по шагам на macOS, Windows и Linux, проверка двумя командами и решения частых проблем.РедакторКакой редактор поставить, как открыть папку сайта, найти страницу, посмотреть Markdown в превью и сохранить правки.MarkdownЗаголовки, абзацы, жирный текст, списки, ссылки, картинки, код и таблицы, а затем блок настроек и секции страницы HERON.Git и GitHubЧто такое git и GitHub, как создать аккаунт, репозиторий и токен и отправить папку сайта первым push.Как работает сборкаЧто происходит при heron build: файлы становятся страницами, секции блоками, фото получают размеры. И как читать ошибки сборки.ДоменЧто такое домен, где его купить, что делает DNS, какие записи добавить (A, AAAA, CNAME), сколько ждать и откуда берётся HTTPS.Если что-то не такDocker не запущен, порт занят, нет прав на файлы, коды ошибок сборки, страница не появилась, сайт не обновился после push.

Простыми словами

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

Чтобы работать с этой папкой, нужны три вещи:

  • Docker запускает HERON без установки. Одна программа, одинаковая на любом компьютере.
  • Текстовый редактор открывает файлы, чтобы менять слова.
  • Git и GitHub хранят контент с историей каждой правки, а GitHub может собирать свежий образ сайта при каждом push. На старте можно без них.

Всё остальное, от вёрстки страницы до карты сайта для поисковиков, HERON делает сам.

Путь по порядку

  1. 1

    Установите Docker Начните здесь

    Единственная программа, которая нужна HERON. Десять минут на macOS, Windows или Linux.
  2. 2

    Выберите редактор

    Откройте папку сайта и увидите каждую страницу как файл.
  3. 3

    Освойте Markdown

    Простой способ писать страницы: решётка — заголовок, дефис — пункт списка.
  4. 4

    Создайте первый сайт

    Одна команда даёт папку с демо-страницами и темой.
  5. 5

    Поймите сборку

    Что происходит между вашим файлом и страницей в браузере и как читать ошибку.
  6. 6

    Настройте git и GitHub

    Храните контент с историей каждой правки; свежий образ собирается при каждом push.
  7. 7

    Подключите домен

    Свой адрес вроде vashe-imya.com с HTTPS.

Сколько это занимает

ШагВремяЧто у вас есть после него
Docker10–20 минdocker run --rm hello-world печатает приветствие
Редактор5 минПапка сайта открыта слева в редакторе
Markdown10 минВы умеете написать заголовок, список и ссылку
Первый сайт10 минСайт открывается на localhost:8000
Git и GitHub20 минПапка сайта лежит на GitHub
Домен15 мин и ожидание до нескольких часовvashe-imya.com открывает ваш сайт

Что не понадобится

Программирование

Страницы — это текст. Код нужен только для своей темы, и для этого есть отдельный гайд.

Сервер на старте

Сайт видно на своём компьютере. Для публикации есть бесплатные варианты: см. Публикация.

Знание Linux

Вы наберёте несколько команд. Любую команду на этом сайте можно скопировать как есть, и у каждой написано, что она делает.

Деньги

HERON бесплатный и открытый. Хостинг тоже может быть бесплатным. Домен стоит примерно как обед в год.

Если что-то пошло не так

Все новички спотыкаются об одни и те же пять-шесть проблем: Docker не запущен, порт занят, файл лежит не в той папке. Они собраны с решениями на одной странице: Если что-то пошло не так. А сама сборка называет файл, строку и что сделать.

Вопросы

Какой компьютер нужен?

Любой компьютер последних пяти-шести лет с macOS, Windows 10 или 11 или Linux и хотя бы 8 ГБ памяти. Docker занимает часть её, пока работает.

Можно без Docker?

Да, если есть Python 3.12 или новее: HERON ставится как программа через pip. Но Docker проще, потому что везде работает одинаково. Оба способа — на странице С чего начать.

Git нужен сразу?

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

Может ли ИИ-ассистент сделать всё за меня?

ИИ-агент может заполнить и перевести страницы, но Docker вы ставите сами и результат тоже смотрите сами. См. HERON для ИИ-агентов.