GitBook, shkruaj dokumentacionin për projektet e tua nga Ubuntu

Në artikullin vijues do të hedhim një vështrim në GitBook. Ky është një Aplikimi ndër-platformor GUI, funksioni kryesor i të cilit është të sjellë rrjedhën e punës GitBook në desktopin tonë në Ubuntu. Duke hedhur një vështrim në ndërfaqen e tij mund të shihni se është menduar mirë për redaktimin e tekstit dhe për të punuar me vrojtimin drejtpërdrejt të projektit.

GitBook u krijua në mes të vitit 2014. Lindi në kërkim të krijimit të një Zgjidhje moderne dhe e thjeshtë për krijimin e dokumenteve, shkrimin dixhital dhe botimin e përmbajtjes. Filozofia e projektit është të jetë e thjeshtë pa humbur pikën e elegancës. Shpërqendrimet dhe shqetësimet për krijuesit e përmbajtjes eliminohen, kështu që ata mund të shkruajnë lirshëm.

Qindra mijëra përdorues përdorin GitBook për të shkruaj dokumentacionin (biblioteka, API, mjetet, etj.) ose bazat e njohurive (të tilla si FAQ). Njerëzit gjithashtu e përdorin këtë program për të botuar libra teknikë, materiale mësimore dhe shumë gjëra të tjera.

Karakteristikat e Përgjithshme të GitBook

Kjo eshte nje platformë online për shkrimin dhe mbajtjen e dokumentacionit. Ai siguron një format të burimit të hapur të formatit dhe mjeteve.

Ky program do të na ofrojë të integruara në kontrollet e Git. Ne gjithashtu do të kemi në dispozicion një panel të përmbajtjes, një panel pemë skedarësh dhe butona të formatit të shpejtë për të lehtësuar strukturimin e dokumenteve tona.

Për më tepër, GitBook na ofron mundësinë e shfaqni përmbajtjen tonë si një faqe në internet (i përshtatshëm dhe i zgjerueshëm) ose si një ebook (PDF, ePub ose Mobi).

GitBook.com është platforma online për krijimin dhe pritjen e librave të krijuar në formatin e aplikimit. Ofron pritje, veçori bashkëpunimi dhe një redaktor të lehtë për t’u përdorur. Ky program na lejon të përdorim ekipin tonë për të krijuar libra vendas, në GitHub ose në platformë për t'i pritur ata.

Për të filluar përdorimin e këtij programi, krijuesit u japin në dispozicion përdoruesve mundësinë e konsultimit me udhezime Instalimi në dokumentacion. Nëse ndonjë përdorues dëshiron ose ka nevojë për të, ai mund të konsultohet me kodin burimor të këtij aplikacioni në faqen e GitHub të kësaj kërkese.

Instalimi i GitBook

Nëse dëshironi të shkarkoni paketën e programit, mund ta shkarkoni nga programi juaj Faqja zyrtare. Aty mundemi shkarkoni atë duke përdorur shfletuesin. Ne gjithashtu mund të marrim paketën duke përdorur komanda wget hapja e një terminali (Ctrl + Alt + T) dhe shtypja e mëposhtme:

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

Pasi të shkarkohet paketa, mund ta instalojmë duke ekzekutuar komandën e mëposhtme në të njëjtin terminal:

dpkg -i linux-64-bit

Pasi të keni mbaruar instalimin, do të jeni në gjendje të përdorni fushën e kërkimit të Ubuntu Dash dhe të shkruani gitbook. Ikona e aplikacionit do të shfaqet në ekran.

Kur të kemi hyrë, ose me një Llogaria e GitBook ose me llogarinë tonë të mediave sociale, tani mund të krijojmë një Libër të ri. Ne mund ta bëjmë këtë duke klikuar në opsionin Libri i Ri i disponueshëm në ekran.

Tani mund ta filloni shkruani Librin tuaj në Redaktor. Mos harroni të zgjidhni në redaktues depon në të cilën duam të ngarkojmë ndryshimet.

Si të sinkronizoni Gitbook me Github?

Diçka shumë interesante për këtë program është se ai na ofron mundësinë e punës me GitHub. Kam lexuar që për disa njerëz ky ka qenë problem sinkronizoni një depo Github me platformën GitBook.

Gjëja e parë që do të duhet të bëjmë është krijoni një depo publike në Github. Ne gjithashtu do të kemi nevojë krijoni një libër në uebfaqen e Gitbook. Rekomandohet, megjithëse mendoj se nuk është thelbësore që të dy depot të kenë të njëjtin emër.

Sapo të krijohet libri është e rëndësishme të keni qasje në Mjetet e vendosjes së librit dhe shkoni te seksioni Github. Sapo të hyni brenda, do të vazhdoni të zgjidhni integrimin me depon e GitHub me të cilën dëshironi të sinkronizoni. Pasi të jetë zgjedhur depoja, ne do të vazhdojmë të pranojmë dhe ruajmë të gjithë procesin.

Pasi të jetë kryer ky operacion, nëse gjithçka ka shkuar mirë, duhet të shfaqet një mesazh i gjelbër që tregon se integrimi me Github po punon.

Për të kontrolluar që gjithçka funksionon. Tani do të fillojmë sesionin me klientin GitBook që kemi instaluar në Ubuntu tonë. Kur të fillojë, ne mund të bëjmë ndryshimet që ne i konsiderojmë përkatëse. Tani ne mund t'i ngarkojmë ato te sapo krijuar Magazinimi i GitHub.