GitBook, napiši dokumentaciju za svoje projekte iz Ubuntu-a

U sljedećem članku ćemo 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. Uvidom u njegovo sučelje možete vidjeti da je dobro osmišljen za uređivanje teksta i rad sa 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, a da se ne izgubi poanta elegancije. Uklanjaju se smetnje i brige za kreatore sadržaja, tako da mogu slobodno pisati.

Stotine hiljada korisnika koriste GitBook za napisati dokumentaciju (biblioteka, API, alati itd.) ili baze znanja (poput često postavljanih pitanja). Ljudi takođe koriste ovaj program za objavljivanje tehničkih knjiga, nastavnih materijala i mnogih drugih stvari.

Opšte karakteristike 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 tablu sa sadržajem, ploču stabla datoteka i gumbe za brzo oblikovanje kako bismo olakšali strukturiranje naših dokumenata.

Pored toga, GitBook nam nudi mogućnost prikažite naš sadržaj kao web stranicu (prilagodljivo i proširivo) ili poput e-knjige (PDF, ePub ili Mobi).

GitBook.com je mrežna platforma za kreiranje i hosting knjiga stvorenih u aplikacijskom formatu. Nudi hosting, funkcije za suradnju i uređivač lak za upotrebu. Ovaj program omogućava nam da koristimo naš tim za stvaranje lokalnih knjiga, na GitHub-u 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 bilo koji korisnik to želi ili treba, može pogledati izvorni kod ove aplikacije na stranici GitHub ove aplikacije.

Instalacija GitBook-a

Ako želite preuzeti programski paket, možete ga preuzeti sa svog službena stranica. Tamo možemo preuzmite ga pomoću pregledača. Paket takođe možemo dobiti pomoću wget naredba otvaranje terminala (Ctrl + Alt + T) i u njega upišite sljedeće:

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

Jednom kada se paket preuzme, 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 ekranu.

Kada smo se prijavili, bilo sa 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 ekranu.

Sada 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 sinhronizirati Gitbook s Githubom?

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

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

Jednom kada je knjiga stvorena, važno joj je pristupiti Rezervirajte alate za postavljanje knjiga i idite na odjeljak Github. Kad uđete, nastavit ćete odaberite integraciju s GitHub spremištem sa kojom želite da se sinhronizujete. 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 sa Githubom to radi.

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