Начните с одного товара: SKU.md для Shopify, SHOPLINE, WooCommerce и BigCommerce
Материалы о v1.0.0
Сравните условия публикации на четырёх платформах и подготовьте проверяемый пилот SKU.md на одном товаре.
Подготовка знаний для торговых агентов не требует перестройки магазина. Продавец на Shopify, SHOPLINE, WooCommerce или BigCommerce может выбрать один товар, собрать достоверные материалы, выяснить способ выдачи файла и затем решить, расширять ли охват.
SKU.md v1.0.0 дополняет карточки, структурированные данные и канальные Feed открытым проверяемым представлением. Остатки, оплата и заказы остаются в существующих системах. Ниже описаны пути для оценки, а не заявления о встроенной поддержке SKU.md четырьмя платформами.
Сначала выясните, что может отдавать витрина
Точность содержания и правильная выдача в интернете — разные задачи. Команда магазина готовит характеристики, варианты, ограничения и источники. Разработчик или подрядчик проверяет реальный ответ на домене магазина.
Таблица основана на официальных материалах, но не сертифицирует отдельный магазин. Решение зависит от хостинга, разрешений и теста ответа. Возможности загрузить файл недостаточно.
| Платформа | Что контролирует продавец | Предпосылка | Что проверить |
|---|---|---|---|
| Shopify | Тему; маршруты собственной витрины зависят от архитектуры | Ограниченный префикс App Proxy не даёт произвольного корневого пути | Markdown, а не HTML темы |
| SHOPLINE | Данные товара и разрешённые перенаправления | Перенаправление само по себе не доказывает соответствие; нужна выдача с того же origin | Адрес назначения, тело и цепочку переходов |
| WooCommerce | Маршруты WordPress или файлы при наличии прав хостинга | Нужен правильный ответ, а не только правило переписывания | Статус, тип содержимого, кеш и байты |
| BigCommerce | Шаблоны Stencil либо маршруты собственной витрины | Шаблон страницы не доказывает выдачу Markdown из корня | Отличие HTML-страницы от файла |
Это выводы о реализации на основе возможностей платформ. Если подходящего пути нет, сначала улучшайте данные товара и поручите подрядчику оценку. Не меняйте платформу ради одного файла.
Как работает обнаружение
Предпочтителен точный путь /sku.md на том же сайте. Только после точного HTTP 404 потребитель может проверить одно однозначное объявление на главной странице того же origin:
<link rel="alternate" type="text/markdown" title="SKU.md" href="/catalog.md">Объявленный файл тоже должен соответствовать спецификации: HTTPS, тот же origin, отсутствие query и fragment. Тайм-аут, ошибка сервера и неправильный документ не означают отсутствия корня.
Это условный путь спецификации, а не универсальный приём для любой темы. Нужно контролировать и проверять объявление и сам файл. Загрузка с CDN, HTML-описание или переход на другой origin автоматически не подтверждают соответствие.
Подготовьте минимальный каталог
Ниже вымышленный магазин. Замените имя, краткое описание, домен и адрес каталога реальными значениями перед генерацией и проверкой. Один корень не описывает все характеристики товара.
# Example Outdoor Gear
> Lightweight outdoor equipment for hikers.
SKU.md: [1.0.0](https://sku.md/spec/1.0.0/)
Website: [example-outdoor.com](https://www.example-outdoor.com/)
## Catalog
- [All products](https://www.example-outdoor.com/collections/all)Документы знаний необязательны. При добавлении первого явно сошлитесь на него из корня, а в документе оставьте обратную ссылку на каталог, страницу товара и источники отдельных фактов. Укажите, относится факт ко всему товару или конкретному варианту.
Пять шагов проверяемого пилота
- Выберите товар. Лучше с полноценной публичной документацией и частыми вопросами о характеристиках. Обход всего магазина не нужен.
- Проверьте факты. Сверьте идентичность, характеристики, ограничения и основания с реальными страницами. Не подменяйте неизвестность предположением.
- Создайте и проверьте файл. Используйте генератор для корня и оптимизатор для атрибутов.
- Опубликуйте и подтвердите. Ответственный за магазин размещает файл, затем проверка опубликованного URL оценивает реальный адрес. Для документов товара проверьте связи с каталогом.
- Назначьте сопровождение. Определите ответственного, сохраняйте основания и повторяйте проверки при изменении характеристик, вариантов или источников.
Приёмка включает публичный HTTPS, HTTP 200, Markdown в UTF-8 и разрешённый тип text/markdown или text/plain. Нужны проверки безопасных переходов, связей и источников. Видимый в браузере текст не доказывает успех всех слоёв.
Когда расширять охват
Полезный пилот показывает доступность файла, происхождение фактов, правильную область вариантов и вопросы для актуальных систем. Проверьте это до расширения вместо подсчёта созданных файлов.
SKU.md не входит в админку, не публикует товары автоматически и не отправляет их во внешние каналы. Продавец решает, что раскрывать; использование агентами проверяется отдельно. Цена, наличие и обещания доставки остаются в актуальных системах.
Следуйте быстрому старту и передайте проверенные знания об одном товаре ответственному за витрину. Это конкретный и небольшой первый шаг.