Руководство по публикации документации 2025 | Развертывание программной документации | Технические писатели Разработчики Продакт-менеджеры | Порталы управления знаниями Контроль версий | Платформы документации
Product Documentation AI

Как опубликовать документацию к продукту в одной строке кода

Tal F.

Tal F.

June 30, 2021

Это пояснение о том, как опубликовать документацию к вашему продукту с помощью одной строки кода, используя Docsie


Поделиться статьей:

Всем привет!

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

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

Вот краткое руководство о том, как публиковать контент в Docsie.

Публикация в портале знаний Docsie может осуществляться несколькими способами. В этом видео я объясняю, как публиковать порталы знаний, книги, полки или статьи с помощью одной простой строки кода.

В этом примере я хочу опубликовать книгу под названием 'Writing your first Django app, part 2'

Как видно, в моей уже созданной документации есть версия с названием "Brand new portal that I am working on". Если нажать на значок 'карандаша' рядом с ней, вы можете сделать ваш опубликованный портал 'активным' или 'основным', либо отключить эти функции. Это очень удобно, поскольку позволяет вам и вашей команде писать или обновлять документацию, не показывая её клиентам, пока вы не будете готовы опубликовать её на своем сайте:

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

Оказавшись на странице профиля и настроек, нажмите на вкладку "Deployments". Это приведет вас на страницу развертывания и поможет создать код для встраивания, который будет размещен на вашем сайте.

Теперь нажмите "Configure a new deployment +"

Отлично! Теперь, когда у вас есть доступ к панели управления, вам нужно развернуть пользовательский домен. Это делается легко: откройте вкладку "Deploy a domain" и нажмите 'custom deployment'

Следующие два шага очень просты:

  1. Первый шаг — ввести ваш домен (не забудьте использовать http:// или https:// перед названием домена)

  2. Второй шаг — выбрать, что вы хотите опубликовать: у вас есть выбор между публикацией Книги или целой Полки. В этом примере я публикую книгу под названием: 'Writing your first Django app, part 2'

Отлично! Теперь последний шаг перед получением нашего кода — нажать "+More Options"

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

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

После этого нажмите 'Create web portal'.

Теперь прокрутите вниз и нажмите "+ Get deployment script"

Скопируйте скрипт и вставьте его в свой HTML:

Теперь, когда у вас есть доступ к скрипту, вы можете улучшить внешний вид с помощью нашего руководства по CSS. Оно поможет вам создать стильный портал знаний Docsie, соответствующий дизайну вашего бренда. Пожалуйста, ознакомьтесь с нашим руководством по стилизации по этой ссылке: Руководство по стилизации Docsie

Надеюсь, вам понравился этот урок! Следите за новыми обучающими материалами по Docsie в ближайшем будущем!

Если у вас есть вопросы о том, как Docsie может помочь вам, и вы хотите, чтобы мы продемонстрировали наши инструменты, нажмите здесь, чтобы запланировать демонстрацию.

Ключевые термины и определения

Централизованная веб-платформа, предоставляющая доступ к документации, руководствам и информационным ресурсам для пользователей или клиентов. Узнать больше →
Техническое содержание, объясняющее, как использовать, внедрять или устранять неполадки в программном продукте или услуге. Узнать больше →
Процесс предоставления программного обеспечения или документации конечным пользователям, обычно путем публикации в рабочей среде. Узнать больше →
Фрагмент HTML или JavaScript кода, который позволяет отображать содержимое одного веб-сайта внутри другого веб-сайта. Узнать больше →
Письменные материалы, описывающие функциональность, архитектуру и инструкции по использованию программных приложений. Узнать больше →
(HyperText Markup Language)
Язык гипертекстовой разметки - стандартный язык разметки, используемый для создания и структурирования содержимого веб-страниц. Узнать больше →
(Cascading Style Sheets)
Каскадные таблицы стилей - язык таблиц стилей, используемый для управления визуальным представлением и форматированием веб-страниц. Узнать больше →

Frequently Asked Questions

Система публикации Docsie позволяет командам работать над документацией, не влияя на опубликованную версию.

Docsie позволяет создавать и редактировать версии документации, которые можно установить как "активные" или "основные" с помощью инструмента-карандаша, или оставить неактивными. Это значит, что ваша команда может писать и обновлять документацию в фоновом режиме, не показывая её клиентам, пока вы не будете готовы опубликовать её в продакшн.

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

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

Могу ли я настроить внешний вид моего документационного портала Docsie в соответствии с моим брендом?

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

Насколько просто встроить документацию Docsie в существующий веб-сайт?

Встраивание документации Docsie предельно просто — для этого требуется всего одна строка кода. После настройки параметров развертывания Docsie генерирует скрипт, который вы просто копируете и вставляете в ваш HTML. Это обеспечивает безупречную интеграцию независимо от существующей конфигурации вашего сайта.

Какие дополнительные функции и плагины доступны для улучшения моего документационного портала?

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

Похожие статьи

Готовы преобразить вашу документацию?

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

Tal F.

Tal F.

VP of Customer Success @ Docsie.io