AI и Albireo CMS

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

Обучение ИИ

Для того, чтобы обучить ИИ основам работы с Albireo CMS, предложите ему прочитать ссылку на llms.txt — этот файл специально используется нейросетями для изучения сайтов.

Здесь https://maxsite.org/albireo/llms.txt находится описание Albireo CMS. Прочти и изучи его.

Если ваша нейросеть не может получить доступ к сайту, то самостоятельно скопируйте этот файл и загрузите его вручную в диалог чата.

Использование Berry CSS

Скорее всего ИИ попробует самостоятельно использовать классы Berry CSS при верстке страниц. В этом ему поможет готовый обучающий промпт berry CSS. Современные модели ИИ хорошо понимают семантику классов и допускают мало ошибок.

Создание готовых страниц для Albireo CMS

Вы можете попросить ИИ создавать сразу готовые страницы для публикации на сайте. Для этого загрузите в ИИ свой master-файл с исходной разметкой страницы. Например _master/new.php по умолчанию такой:

<?php defined('BASE_DIR') or exit('Access denied');
/**
title: Заголовок
category: blog

type: blog
date: %%DATE-NOW%%
extras.start[info1-header.php]: +
images-dir: [UPLOADS_URL]
image-large: [UPLOADS_URL]%%SLUG%%.webp

draft: +

# use.glightbox: +
# use.highlight: +
# use.clipboard: +
# use.mermaid: +

description: [announce]
announce: -
llms: -

**/ ?>

_(t-italic) Announce

Text

ИИ будет его использовать как начальный каркас для всех новых страниц. В своём промпте задайте какие поля должен генерировать ИИ, например он может делать description, announce, llms, добавлять метки, рубрики и т.п. То есть он будет сразу создавать все необходимые поля без дополнительного указания.

Если у вас часто стоит задача создания подобных страниц, то создайте единый системный промпт, где сразу приведите ссылки на llms.txt, обучающий промпт Berry CSS, master-каркас и свои требования.

Особенности TextSimple

Как правило, ИИ хорошо понимают разметку TextSimple и редко в ней ошибаются. Но у ИИ есть одна особенность — они часто любят излишне форматировать итоговый текст, что может приводить к сбоям. Например отступы для маркеров списка - должны быть строго с начала строки, но ИИ может добавить ведущие пробелы, что будет восприниматься уже как вложенный список.

Или ИИ может использовать сложные div или bq для одной строки, хотя лучше будет использовать __ и >.

Если ИИ допускает такие ошибки, то укажите ему прямую ссылку на документацию TextSimple — он перестроит своё поведение.

Примеры на github.com

Для того, чтобы ИИ понимал как лучше всего программировать, вы можете предложить ему ссылку на lite-версию, которая размещается на github.com: https://github.com/maxsite/albireo-lite

Здесь размещаются готовые файлы шапок, подвалов, сниппеты, extras, модули, tpl-файлы и т.п. ИИ может использовать их для анализа, чтобы потом выполнять ваши задачи. Например если вам нужная новая шапка, приведите примеры из templates/default/modules/headers.

Создание md-файлов

Albireo CMS обладает уникальной возможностью загружать md-файлы (формат Markdown) в котором сразу будут хранится все изображения. См. Единый md-файл для текста и изображений.

Поэтому вы можете создавать страницы для Albireo CMS не только как php, но и как md-файлы, например в Obsidian. После того, как они будут готовы, можно их загрузить в Albireo CMS, которая создаст корректные php-файлы, а все вложенные изображения будут преобразованы в самостоятельные файлы.

Для этого просто укажите ИИ, чтобы он отдавал страницы в md-формате (в разметке TextSimple!).

Важно! По умолчанию ИИ-чат отдаёт код страницы как блок кода, обрамляя его через ```markdown. Но в коде md-страницы будет вставка ```albireo, что сломает вывод в чате. Чтобы этого избежать попросите обрамлять вывод кода через блок ~~~~markdown ... ~~~~. Используйте такой промпт:

Для вывода готового MD-файла оформляй внешний блок кода с помощью тильд (~~~~markdown ... ~~~~), чтобы не конфликтовать с внутренними блоками ```albireo ... ``` для Obsidian.

Генерация текстов для статей

Процесс создания текстов для сайта сам по себе достаточно прост: пишется промпт для ИИ, после чего получается готовый текст, который просто вставляется в файл. Более подробно об этом рассказано в статье «Создание статей с помощью ИИ в Albireo CMS».

Как правило, ИИ создаёт тексты в формате Markdown. Albireo CMS по умолчанию работает с парсером TextSimple, который хорошо понимает md-разметку. Поэтому в большинстве случаев текст, сгенерированный нейросетью, можно использовать без изменений: TextSimple превратит его в корректную html-разметку.

В редких случаях могут потребоваться мелкие правки, поэтому желательно проверить итоговый html-код страницы. Это можно сделать нажав Ctrl+U в браузере. Если у вас FireFox, то он сразу подсветит html-ошибки красным цветом.

Создание изображений

В целом подход такой же: ИИ по вашему промпту создаёт изображение. Это изображение может быть сразу вставлено через текстовый редактор. Для этого исходное изображение нужно скопировать в браузере в буфер обмена Ctrl+C, а в редакторе Albireo CMS нажать вставку Ctrl+V. Albireo CMS уточнит желаемую ширину изображения (по умолчанию это 1200px) и качество (по умолчанию 80). Дальше система сама получит файл из буфера, загрузит его на сервер и в текстовом редакторе появится ссылка на это изображение. Система сама преобразует его в современный формат WebP.

Часто ИИ не может выставить правильный размер изображения, поэтому иногда проще сохранить файл на свой компьютер, отредактировать его через графическую программу, а потом просто перетащить его мышкой (или через буфер обмена) в текстовый редактор Albireo CMS. Система сама выполнит конвертацию в WebP.

Если у вас есть трудности с придумыванием промптов, то почитайте статью «Как создавать изображения с помощью ИИ»

Готовые промпты

В комплекте Albireo CMS есть небольшая коллекция готовых промптов, доступных по адресу сайт/prompts. Чтобы получить к ним доступ нужно залогиниться как admin.

Эти промпты можно использовать как заготовки для своих задач.

Шаблон для написания текстов
Адаптация поста под платформу
Генерация идей для постов
Написание поста для блога
Создание контент-плана
Анализ и улучшение контента
Создание сторис
Написание цепляющих заголовков
Ответы на комментарии
Шаблон для генерации изображений
Шаблоны для изображения по фото
Сценарий для видео/рилс

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

Анализ рубрики и выявление пробелов
Генерация новых идей
Кластеризация и структура
Обновление старых статей
Оценка понятности для аудитории
План для мини-курса или гида
Предложение форматов публикаций
Улучшение заголовков и описаний

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

Промпты для страниц сайта

В Albireo CMS в «шапке» статьи (там где дата, рубрики и т.п.) может выводиться выпадающий блок с готовым промптами для посетителей сайта.

Проанализировать статью
Выделить главные тезисы
Объяснить простыми словами
Сделать шпаргалку
Вопросы для обсуждения
Аргументы "за" и "против"
Применение на практике

Если это админ сайта, то будут доступны ещё промпты:

Идеи для развития темы
Придумать анонсы
Улучшить текст
SEO-резюме

При выборе любого пункта, происходит открытие страницы ChatGPT с уже готовым промптом и ссылкой на статью.

ChatGPT пока единственная нейросеть, которая умеет принимать текст промпта через URL. Сами промпты задаются в конфигурационном файле prompts-info1.php.

ИИ-приложения

При желании вы можете сделать собственное ИИ-приложение, которое можно настроить под свою задачу. Например прописать промпты, выбор опций и т.д. Сейчас многие ИИ предлагают подобный функционал. В качестве примера см. «Создание ИИ-приложений в Google AI Studio».

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

ИИ для кодинга

Современные ИИ достаточно легко создают HTML/CSS/JS/PHP-код, который можно добавить на свой сайт.

Albireo CMS предлагает достаточно простой способ интеграции любого стороннего кода. Поскольку стек разработки очень большой, то всегда есть соблазн работать только в рамках какой-то одной системы. Но правда в том, что программисты используют огромное количество библиотек, которые невозможно включить в комплект системы.

Поэтому Albireo CMS использует другой принцип: вместо переделки стороннего кода, предложить его лёгкую интеграцию.

Это касается всех частей системы:

Интеграция произвольного php-кода в виде отдельный файлов, функций, классов. При этом поддерживается PSR4, карта классов для библиотек вне PSR4, Composer.
Произвольный html-код. То есть Albireo CMS не накладывает на код ограничений. Это касается всех частей html-документа: head, body, html, lazy-включения и т.д.
Произвольный css-код. То есть можно использовать как свои точечные css-стили, css-файлы или css-фреймворки.
Произвольный js-код. Это свободное использование любого js-файлы, функции или js-библиотеки. При желании можно интегрировать даже такие сложные вещи как React.JS.

Рабочий стек Albireo CMS

Базис системы это:

PHP 8.3+.
SQLite (для кэша и динамических данных).
Berry CSS.
AlpineJS.
Прочие ресурсы, которые могут использоваться точечно.

Ресурсы — это возможность получить нужную функциональность сразу в рамках единой комплектации системы. Например в комплекте есть jQuery 2/3, Bootstrap Icons, Bootstrap CSS, Google-шрифты, FontAwesome-шрифты и т.д. Многие ресурсы не используются в шаблоне Albireo CMS, но могут использоваться как раз при интеграции со сторонними библиотеками.

Например часто в лендингах используется Bootstrap CSS и jQuery. Поскольку они уже есть в комплекте системы, то нет необходимости заниматься их подключением.

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

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

Стек JavaScript

Albireo CMS использует AlpineJS в качестве основной библиотеки JavaScript. В большинстве случаев нет необходимости от неё отказываться, поскольку она работает в пределах изолированных блоков и никак не влияет на сторонний js-код.

Это позволяет без труда добавлять любые js-библиотеки на сайт. Делается это с помощью полей записи в самых разных вариантах, зависящих от задачи.

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

Albireo CMS поддерживает все официальные плагины AlpineJS, которые также подключаются через поля страниц. Если нужно, то можно указать ИИ использовать эти плагины.

Поэтому ИИ можно сразу предложить использовать AlpineJS в качестве основной библиотеки.

Web-билдеры для генерации сайтов/лендингов

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

В большинстве случаев, такие сервисы работают в своём кодовом стеке: это собственные js-файлы и css-стили. Даже если такой сервис использует ИИ для своей работы, то он всё равно обучен именно на своём коде и своих шаблонах.

Поэтому нет никакого смысла пытаться его обучить или попросить создать лендинг на классах Berry CSS с использованием AlpineJS, он всё равно не сможет этого сделать: будет очень много ошибок.

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

После этого задача сводится только к интеграции лендинга к Albireo CMS. В общих чертах — это нужно будет прописать css/js-файлы в полях страницы, чтобы они автоматически подключились, а также поправить пути к изображениям в css-стилях и в html-коде. После этого лендинг может работать ровно так, как и было задумано.

Более подробно об этом написано в статье «Создание лендингов».

Если создание таких страниц поставлено «на поток», то можно продумать промпт, который заставит ИИ создавать страницы по заданным правилам. Например в каждый файл добавлять секцию полей Albireo CMS или даже использовать мастер-шаблон. Для url-путей можно использовать php-вставки, например с UPLOADS_URL и т.д.