Документация Tagix

Полная документация по сайту и платформе

На этой странице собраны основные правила работы с Tagix: структура сайта, TGX DSL, домены, sandbox, SEO, юридические документы и ответы на частые вопросы.

1. Старт работы

  1. Зарегистрируйтесь на /register/ и войдите через /login/.
  2. Откройте кабинет /dashboard/ и создайте проект.
  3. Настройте структуру страниц и базовые блоки (header/footer/components).
  4. Проверьте шаблоны в sandbox, затем публикуйте на прод.

2. Как устроен сайт в Tagix

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

  • Страницы: маршруты сайта, которые открываются по URL.
  • Компоненты: переиспользуемые блоки (например, header, footer, cookie-consent).
  • Вложенность: корневые разделы находятся в /, дальше идут записи/подстраницы.
  • Публичные разделы slot=0: /blog/, /sandbox/, /faq/, /legal/*, /contacts/.

Для единообразия используйте понятные slug, логичную иерархию и уникальные title/description для каждой важной страницы.

3. TGX DSL: базовые директивы

TGX позволяет добавить динамику в обычную HTML-верстку без тяжелого backend-кода в шаблонах.

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

<tgx tgx:component="header"></tgx>
<main>...</main>
<tgx tgx:component="footer"></tgx>

Локальные переменные и условия

<tgx tgx:set="showPromo=true"></tgx>
<div tgx:if="showPromo" class="alert alert-success">Акция активна</div>
<div tgx:else>Акция завершена</div>

Повтор записей

<article tgx:repeat="../?filter[status]=active">
  <h3></h3>
  <p></p>
</article>

4. AJAX и API

Для динамики используйте TGX-атрибуты с HTMX-совместимым поведением.

  • tgx:ajax-get/post/put/patch/delete для запросов.
  • tgx:ajax-target и tgx:swap для обновления нужного блока.
  • tgx:ajax-loader для контроля анимации загрузки.
<form tgx:ajax-post="/api/v1/contact" tgx:ajax-target="#result" tgx:swap="#result,innerHTML">
  ...
</form>
<div id="result"></div>

5. Подключение домена

  1. Добавьте домен в каталог в кабинете.
  2. Пройдите TXT-верификацию (verify -> confirm).
  3. Привяжите подтвержденный домен к проекту.

Подробный практический разбор: Как подключить свой домен в Tagix.

6. Sandbox для безопасных тестов

Перед публикацией шаблонов тестируйте код в песочнице:

  • изолированное превью через iframe;
  • быстрая проверка TGX-разметки;
  • возможность поделиться примером по ссылке.

Расширенный гайд: как тестировать TGX-шаблоны до публикации.

7. SEO и контент

  • У каждой важной страницы должны быть уникальные title, Description, Keywords.
  • Используйте понятные slug и логичную вложенность URL.
  • Добавляйте внутренние ссылки между /blog/, /faq/, /legal/, /contacts/.
  • Публикуйте практические статьи с решением конкретной задачи пользователя.

Примеры статей и кейсов: /blog/.

9. Частые вопросы

Нет. Платформа подходит и для верстальщиков, и для команд, которые хотят контролировать HTML/CSS, но ускорить функционал через TGX DSL.

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

Сначала домен добавляется в каталог, затем подтверждается через TXT, после чего привязывается к проекту. Детали в гайде по доменам в блоге.

Основные обновления и практические кейсы публикуются в блоге Tagix.

Перейдите на страницу контактов и отправьте запрос в поддержку с URL страницы и описанием проблемы.