GitBook, напишите документацию для своих проектов из Ubuntu

веб-гитбук

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

GitBook был создан в середине 2014 года. Он был создан для создания Современное и простое решение для создания документов, цифрового письма и публикации контента. Философия проекта - быть простым, но без потери элегантности. Создатели контента не будут отвлекаться и беспокоиться, поэтому они могут свободно писать.

Сотни тысяч пользователей используют GitBook для написать документацию (библиотека, API, инструменты и т. д.) или базы знаний (например, часто задаваемые вопросы). Люди также используют эту программу для публикации технических книг, учебных материалов и многого другого.

Общие функции GitBook

Это онлайн-платформа для написания и размещения документации. Он предоставляет формат книги с открытым исходным кодом и наборы инструментов.

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

Кроме того, GitBook предлагает нам возможность отображать наш контент как веб-сайт (настраиваемый и расширяемый) или как электронная книга (PDF, ePub или Mobi).

GitBook.com - это онлайн-платформа для создания и размещения книг, созданных в формате приложения. Предлагает хостинг, функции совместной работы и простой в использовании редактор.. Эта программа позволяет нам использовать нашу команду для создания локальных книг на GitHub или на платформе для их размещения.

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

Установка GitBook

Если вы хотите скачать пакет программы, вы можете скачать его со своего Официальный сайт. Там мы можем скачать его с помощью браузера. Мы также можем получить посылку, используя команда wget открыв терминал (Ctrl + Alt + T) и набрав в нем следующее:

wget http://downloads.editor.gitbook.com/download/linux-64-bit

После загрузки пакета мы можем установить его, выполнив следующую команду в том же терминале:

dpkg -i linux-64-bit

После завершения установки вы сможете использовать поле поиска Ubuntu Dash и ввести gitbook. Значок приложения отобразится на экране.

Редактор GitBook добавить новый

Когда мы вошли в систему, либо с Учетная запись GitBook или наша учетная запись в социальной сети, теперь мы можем создать новую книгу. Мы можем сделать это, щелкнув опцию «Новая книга» на экране.

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

Как синхронизировать Gitbook с Github?

Что очень интересно в этой программе, так это то, что она предлагает нам возможность работать с GitHub. Я читал, что для некоторых людей это было проблемой синхронизировать репозиторий Github с платформой GitBook.

Конфигурация GitHub

Настройка репозитория GitHub

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

конфигурация gitbook

Настройки книги в GitBook

После создания книги важно получить доступ к Закажите Инструменты настройки и перейдите в раздел Github. Оказавшись внутри, вы перейдете к выберите интеграцию с репозиторием GitHub с которым вы хотите синхронизироваться. После выбора репозитория мы продолжим принимать и сохранять весь процесс.

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

Редактор Gitbook

Проверить, что все работает. Теперь мы начнем сеанс с клиентом GitBook, который мы установили в нашей Ubuntu. Когда он начнется, мы сможем внести изменения, которые сочтем уместными. Теперь мы можем загрузить их в наш только что созданный Репозиторий GitHub.


Комментарий, оставьте свой

Оставьте свой комментарий

Ваш электронный адрес не будет опубликован. Обязательные для заполнения поля помечены *

*

*

  1. Ответственный за данные: Мигель Анхель Гатон
  2. Назначение данных: контроль спама, управление комментариями.
  3. Легитимация: ваше согласие
  4. Передача данных: данные не будут переданы третьим лицам, кроме как по закону.
  5. Хранение данных: база данных, размещенная в Occentus Networks (ЕС)
  6. Права: в любое время вы можете ограничить, восстановить и удалить свою информацию.

  1.   Браллан Санчес сказал

    Дани Галисия, Франк Паласиос, Хайме Мехиа, Титан Фер