GitBook, escriu documentació per als teus projectes des d'Ubuntu

En el següent article anem a fer una ullada a GitBook. Aquesta és una aplicació GUI multiplataforma, Que té com a principal funció portar el flux de treball de GitBook al nostre escriptori en Ubuntu. Fent-li un cop d'ull a la seva interfície es veu que està ben pensada per editar text i treballar amb la vista prèvia en viu de el projecte.

GitBook es va crear a mitjans de 2014. Va néixer buscant crear una solució moderna i simple a la creació a la documentació, l'escriptura digital i la publicació de continguts. La filosofia de el projecte és ser simple sense perdre el punt d'elegància. S'eliminen distraccions i preocupacions dels creadors de contingut, perquè puguin escriure lliurement.

Centenars de milers d'usuaris utilitzen GitBook per escriure documentació (Biblioteca, API, eines, etc.) o bases de coneixement (com les FAQ). La gent també usa aquest programa per publicar llibres tècnics, material didàctic i moltes altres coses.

Característiques generals de GitBook

Aquesta és un plataforma en línia per a escriure i allotjar documentació. Aporta un format de llibres de codi obert i cadenes d'eines.

Aquest programa ens va a oferir controls Git integrats. També tindrem a la nostra disposició un panell de taula de contingut, un panell d'arbre d'arxius i botons de format ràpid per facilitar l'estructuració dels nostres documents.

A més GitBook ens ofereix la possibilitat de mostrar el nostre contingut com un lloc web (Personalitzable i extensible) o com un ebook (PDF, ePub o Mobi).

GitBook.com és la plataforma en línia per crear i allotjar books creats amb el format de l'aplicació. Ofereix allotjament, característiques de col·laboració i un editor fàcil d'utilitzar. Aquest programa ens permet utilitzar el nostre equip per a crear books locals, en GitHub oa la plataforma per allotjar-los.

Per començar a utilitzar aquest programa, els creadors posen a disposició dels usuaris la possibilitat de consultar les instruccions d'instal·lació en la documentació. Si algun usuari ho vol o ho necessita, podrà consultar el codi font d'aquesta aplicació en la pàgina de GitHub d'aquesta aplicació.

Instal·lació de GitBook

Si vols descarregar-te el paquet programa, podràs descarregar-des de la seva pàgina oficial. allà podrem descarregar-utilitzant el navegador. També podrem fer-nos amb el paquet utilitzant el comandament wget obrint una terminal (Ctrl + Alt + T) i escrivint-hi el següent:

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

Una vegada que descarregat el paquet, podrem instal·lar executant la següent comanda a la mateixa terminal:

dpkg -i linux-64-bit

Després de finalitzar la instal·lació, vas a poder usar el camp de recerca de l'Dash d'Ubuntu i escriure gitbook. La icona de l'aplicació es mostrarà a la pantalla.

Quan hàgim iniciat sessió, bé sigui amb una compte de GitBook o amb el nostre compte de xarxes socials, Ja podrem crear un nou Book. Això podrem fer-ho fent clic a l'opció New Book disponible a la pantalla.

Ara ja pots començar a escriure el teu propi Book a l'Editor. Cal no oblidar-se de seleccionar en l'editor el repositori a què volem pujar els canvis.

Com sincronitzar Gitbook amb Github?

Una cosa molt interessant d'aquest programa és que ens ofereix la possibilitat de treballar amb GitHub. Tinc llegit que per a alguna gent això ha estat un problema a la de sincronitzar un repositori Github amb la plataforma GitBook.

El primer que haurem de fer és crear un repositori públic en Github. També necessitarem crear un book al web de Gitbook. És recomanable, tot i que crec que no imprescindible que tinguin el mateix nom dos dipòsits.

Un cop creat el book és important accedir a les eines de l'book Setting i anar a l'apartat de Github. Un cop dins, es procedirà a triar la integració amb el repositori de GitHub amb el qual es vol sincronitzar. Elegit el repositori, continuarem acceptant i guardant tot el procés.

Un cop realitzada aquesta operació, si tot ha sortit bé hauria d'aparèixer un missatge en verd indicant que la integració amb Github està funcionant.

Per comprovar que tot funciona. Ara iniciarem la sessió amb el client GitBook que hem instal·lat al nostre Ubuntu. Quan s'iniciï ja podem realitzar els canvis que considerem pertinents. Ara ja podrem pujar-los al nostre recentment creat repositori de GitHub.