GitBook, napiši dokumentaciju za svoje projekte iz Ubuntua

U sljedećem ćemo članku pogledati GitBook. Ovo je jedno višeplatformska GUI aplikacija, čija je glavna funkcija prenijeti GitBook tijek rada na našu radnu površinu u Ubuntuu. Bacivši pogled na njegovo sučelje, možete vidjeti da je dobro promišljeno za uređivanje teksta i rad s pregledom projekta uživo.

GitBook je stvoren sredinom 2014. Rođen je u potrazi za stvaranjem a Moderno i jednostavno rješenje za izradu dokumenata, digitalno pisanje i objavljivanje sadržaja. Filozofija projekta je biti jednostavan bez gubljenja smisla elegancije. Uklanjaju se smetnje i brige za kreatore sadržaja, tako da mogu slobodno pisati.

Stotine tisuća korisnika koriste GitBook za napisati dokumentaciju (knjižnica, API, alati itd.) ili baze znanja (poput često postavljanih pitanja). Ljudi također koriste ovaj program za objavljivanje tehničkih knjiga, nastavnih materijala i mnogih drugih stvari.

Opće značajke GitBook-a

Ovo je mrežna platforma za pisanje i hosting dokumentacije. Pruža format knjige otvorenog koda i lance alata.

Ovaj program će nam ponuditi ugrađene Git kontrole. Također ćemo imati na raspolaganju ploču sa sadržajem, ploču stabla datoteka i gumbe za brzo oblikovanje kako bismo olakšali strukturiranje naših dokumenata.

Uz to, GitBook nam nudi mogućnost prikazati naš sadržaj kao web mjesto (prilagodljivo i proširivo) ili poput e-knjige (PDF, ePub ili Mobi).

GitBook.com je mrežna platforma za stvaranje i hosting knjiga stvorenih u aplikacijskom formatu. Nudi hosting, značajke suradnje i jednostavan uređivač. Ovaj nam program omogućuje korištenje našeg tima za stvaranje lokalnih knjiga, na GitHubu ili na platformi za njihovo hostiranje.

Da bi počeli koristiti ovaj program, kreatori stavljaju na raspolaganje korisnicima mogućnost savjetovanja s upute za instalaciju u dokumentaciji. Ako ga bilo koji korisnik želi ili treba, može pogledati izvorni kod ove aplikacije na stranici GitHub ove prijave.

Instalacija GitBook-a

Ako želite preuzeti programski paket, možete ga preuzeti s vašeg službene stranice. Tamo možemo preuzmite ga pomoću preglednika. Paket također možemo dobiti pomoću naredba wget otvaranje terminala (Ctrl + Alt + T) i u njega upišite sljedeće:

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

Nakon preuzimanja paketa, možemo ga instalirati izvršavanjem sljedeće naredbe na istom terminalu:

dpkg -i linux-64-bit

Nakon završetka instalacije moći ćete koristiti polje za pretraživanje Ubuntu Dash-a i upisati gitbook. Ikona aplikacije prikazat će se na zaslonu.

Kada smo se prijavili, bilo s GitBook račun ili s našim računom na društvenim mrežama, sada možemo stvoriti novu knjigu. To možemo učiniti klikom na opciju Nova knjiga koja je dostupna na zaslonu.

Sad možete početi napišite svoju knjigu u Editoru. Ne zaboravite u uređivaču odabrati spremište u koje želimo prenijeti promjene.

Kako sinkronizirati Gitbook s Githubom?

Nešto vrlo zanimljivo u vezi s ovim programom jest to što nam nudi mogućnost rada s GitHubom. Čitao sam da je nekim ljudima to predstavljalo problem sinkronizirajte spremište Github s GitBook platformom.

Prvo što ćemo morati učiniti je stvoriti javno spremište na Githubu. Trebat ćemo i mi stvoriti knjigu na Gitbook webu. Preporučuje se, iako mislim da nije bitno da oba spremišta imaju isto ime.

Jednom kad je knjiga stvorena, važno joj je pristupiti Rezervirajte alate za postavljanje knjiga i idite na odjeljak Github. Kad uđete unutra, nastavit ćete odaberite integraciju s GitHub spremištem s kojim se želite sinkronizirati. Nakon odabira spremišta, nastavit ćemo prihvaćati i spremati cijeli postupak.

Nakon što je ova operacija izvedena, ako je sve prošlo u redu, trebala bi se pojaviti zelena poruka koja označava da integracija s Githubom radi.

Da provjerim radi li sve. Sada ćemo započeti sesiju s GitBook klijentom koji smo instalirali u naš Ubuntu. Kad započne, možemo uvesti promjene koje smatramo relevantnima. Sada ih možemo prenijeti u naš novostvoreni GitHub spremište.