GitBook, kirjoita dokumentaatio projektiisi Ubuntusta

Seuraavassa artikkelissa aiomme tarkastella GitBookia. Tämä on yksi cross-platform GUI -sovellus, jonka päätehtävänä on tuoda GitBook-työnkulku työpöydällemme Ubuntussa. Katsomalla sen käyttöliittymää näet, että se on hyvin suunniteltu tekstin muokkaamiseen ja työskentelyyn projektin suoran esikatselun kanssa.

GitBook luotiin vuoden 2014 puolivälissä. Se syntyi luomalla Moderni ja yksinkertainen ratkaisu asiakirjojen luomiseen, digitaaliseen kirjoittamiseen ja sisällön julkaisemiseen. Projektin filosofia on olla yksinkertainen menettämättä eleganssia. Sisällöntuottajien häiriötekijät ja huolet poistetaan, jotta he voivat kirjoittaa vapaasti.

Sadat tuhannet käyttäjät käyttävät GitBookia kirjoita dokumentaatio (kirjasto, sovellusliittymä, työkalut jne.) tai tietopohjat (kuten usein kysytyt kysymykset). Ihmiset käyttävät tätä ohjelmaa myös teknisten kirjojen, opetusmateriaalien ja monien muiden asioiden julkaisemiseen.

GitBookin yleiset ominaisuudet

Tämä on online-alusta asiakirjojen kirjoittamiseen ja ylläpitoon. Se tarjoaa avoimen lähdekoodin kirjamuodon ja työkaluketjut.

Tämä ohjelma tarjoaa meille sisäänrakennettu Git-ohjaus. Käytössämme on myös sisällysluettelo, tiedostopuu-paneeli ja pikamuotoilunäppäimet asiakirjojemme jäsentämisen helpottamiseksi.

Lisäksi GitBook tarjoaa meille mahdollisuuden näyttää sisältöämme verkkosivustona (muokattavissa ja laajennettavissa) tai kuin e-kirja (PDF, ePub tai Mobi).

GitBook.com on online-foorumi sovellusmuodossa luotujen kirjojen luomiseen ja ylläpitoon. Tarjoaa isännöinnin, yhteistyöominaisuudet ja helppokäyttöisen editorin. Tämän ohjelman avulla voimme käyttää tiimiämme paikallisten kirjojen luomiseen GitHubissa tai alustalla niiden isännöimiseksi.

Aloittaakseen tämän ohjelman luomisen sisällöntuottajat tarjoavat käyttäjien saataville mahdollisuuden tutustua ohjelmaan asennusohjeet dokumentaatiossa. Jos joku käyttäjä haluaa tai tarvitsee sitä, hän voi tutustua sovelluksen lähdekoodiin sivulta GitHub tämän sovelluksen.

GitBookin asennus

Jos haluat ladata ohjelmapaketin, voit ladata sen omalta Virallinen sivusto. Siellä voimme lataa se selaimen avulla. Voimme myös saada paketin käyttämällä wget-komento avaamalla pääte (Ctrl + Alt + T) ja kirjoittamalla siihen seuraava:

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

Kun paketti on ladattu, voimme asentaa sen suorittamalla seuraavan komennon samassa terminaalissa:

dpkg -i linux-64-bit

Asennuksen valmistuttua voit käyttää Ubuntu Dashin hakukenttää ja kirjoittaa gitbook. Sovelluskuvake näkyy näytöllä.

Kun olemme kirjautuneet sisään, joko a GitBook-tili tai sosiaalisen median tilillä, voimme nyt luoda uuden kirjan. Voimme tehdä tämän napsauttamalla näytöllä olevaa Uusi kirja -vaihtoehtoa.

Nyt voit aloittaa kirjoita oma kirjasi editoriin. Älä unohda valita editorista arkistoa, johon haluamme ladata muutokset.

Kuinka synkronoida Gitbook Githubin kanssa?

Jotain erittäin mielenkiintoista tässä ohjelmassa on, että se tarjoaa meille mahdollisuuden työskennellä GitHubin kanssa. Olen lukenut, että joillekin ihmisille tämä on ollut ongelma synkronoi Github-arkisto GitBook-alustan kanssa.

Ensimmäinen asia, joka meidän on tehtävä, on luoda julkinen arkisto Githubiin. Tarvitsemme myös luo kirja Gitbook-verkossa. Sitä suositellaan, vaikka mielestäni ei ole välttämätöntä, että molemmilla arkistoilla on sama nimi.

Kun kirja on luotu, on tärkeää käyttää Kirja-asetustyökalut ja siirry Github-osioon. Kun olet sisällä, jatkat valitse integrointi GitHub-arkistoon jonka kanssa haluat synkronoida. Kun arkisto on valittu, jatkamme koko prosessin hyväksymistä ja tallentamista.

Kun tämä toimenpide on suoritettu, jos kaikki on mennyt hyvin, vihreän ilmoituksen pitäisi ilmoittaa, että integraatio Githubin kanssa Se toimii.

Tarkista, että kaikki toimii. Nyt aloitamme istunnon GitBook-asiakkaalla, jonka olemme asentaneet Ubuntuun. Kun se alkaa, voimme tehdä tarpeellisina pitämiämme muutoksia. Nyt voimme ladata ne äskettäin luotuun GitHub-arkisto.