From bc5068cb4ce8d10c8c3051f32eb1af9f245f0e59 Mon Sep 17 00:00:00 2001 From: Administrator Date: Wed, 15 Nov 2023 16:25:30 +0000 Subject: [PATCH] docs: create Soft/Notes/Gitbook --- Soft/Notes/Gitbook.html | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 Soft/Notes/Gitbook.html diff --git a/Soft/Notes/Gitbook.html b/Soft/Notes/Gitbook.html new file mode 100644 index 0000000..122eefb --- /dev/null +++ b/Soft/Notes/Gitbook.html @@ -0,0 +1,18 @@ + + +

Хочу рассказать вам про удобный сервис для создания документации - Gitbook. Он работает по модели SaaS с бесплатным тарифным планом. С его помощью можно вести документацию в обычном git репозитории, а затем публиковать в виде веб сайта, а так же электронной книги в формате PDF, ePub или Mobi (платные функции).

+

Пример подобной документации можно оценить по очень известной серии статей на тему настройки сети - Сети для самых маленьких (https://linkmeup.gitbook.io/sdsm/). Они с некоторых пор живут на gitbook. Думаю, вы часто сталкивались с документацией на этом сервисе. Он популярен.

+

Одно время у Gitbook был опенсорсный клиент с cli (https://github.com/GitbookIO/gitbook), который можно было поставить на Linux. С его помощью можно было локально вести документацию и синхронизировать с сервисом. Но не так давно его перестали поддерживать и развивать, хотя он пока всё ещё работает.

+

Я не совсем понял, что там с оплатой. Заявлен бесплатный тарифный план для open source проектов. При этом я без проблем зарегистрировался и нигде не увидел ограничений или срок действия триала, если он активирован. Проверил очень старые проекты, где вели документацию еще несколько лет назад, они все живы, доки открываются по старым ссылкам, хотя проекты уже мёртвые и давно не обновлялись.

+

В общем, если ищите инструмент для ведения документации, посмотрите на Gitbook. Это удобное специализированное решение для этих целей.

+

Посмотреть, как всё это работает:
https://www.youtube.com/watch?v=KzOcIopMNjU

+

 

+