Ang GitBook, sumulat ng dokumentasyon para sa iyong mga proyekto mula sa Ubuntu

Sa susunod na artikulo ay titingnan namin ang GitBook. Ito ang isa application ng cross-platform GUI, na ang pangunahing pagpapaandar ay upang dalhin ang daloy ng trabaho ng GitBook sa aming desktop sa Ubuntu. Sa pagtingin sa interface nito, makikita mo na mahusay itong naisip para sa pag-edit ng teksto at pagtatrabaho sa live na preview ng proyekto.

Ang GitBook ay nilikha noong kalagitnaan ng 2014. Ipinanganak itong naghahanap upang lumikha ng isang Moderno at simpleng solusyon sa paggawa ng dokumento, digital na pagsulat at paglathala ng nilalaman. Ang pilosopiya ng proyekto ay maging simple nang hindi nawawala ang punto ng gilas. Ang mga pagkagambala at pag-aalala para sa mga tagalikha ng nilalaman ay tinanggal, upang malayang sila makapagsulat.

Daan-daang libo ng mga gumagamit ang gumagamit ng GitBook sa sumulat ng dokumentasyon (silid-aklatan, API, mga tool, atbp.) o mga base ng kaalaman (tulad ng mga FAQ). Ginagamit din ng mga tao ang program na ito upang mag-publish ng mga teknikal na libro, materyales sa pagtuturo, at maraming iba pang mga bagay.

Pangkalahatang Mga Tampok ng GitBook

Ito ay online na platform para sa pagsulat at pag-host ng dokumentasyon. Nagbibigay ito ng isang bukas na mapagkukunan ng format ng libro at mga toolchain.

Mag-aalok sa amin ang program na ito mga kontrol sa built-in na Git. Magkakaroon din kami ng aming talahanayan ng isang panel ng mga nilalaman, isang panel ng file ng puno at mga pindutan ng mabilis na format upang mapabilis ang pagbubuo ng aming mga dokumento.

Bilang karagdagan, inaalok sa amin ng GitBook ang posibilidad ng ipakita ang aming nilalaman bilang isang website (napapasadyang at napapalawak) o tulad ng isang ebook (PDF, ePub o Mobi).

Ang GitBook.com ay ang online platform para sa paglikha at pagho-host ng mga aklat na nilikha sa format ng application. Nag-aalok ng pagho-host, mga tampok sa pakikipagtulungan, at isang madaling gamiting editor. Pinapayagan kami ng program na ito na gamitin ang aming koponan upang lumikha ng mga lokal na libro, sa GitHub o sa platform upang ma-host ang mga ito.

Upang simulang gamitin ang program na ito, ginawang magagamit ng mga tagalikha ang mga gumagamit ng posibilidad na kumonsulta sa mga tagubilin sa pag-install sa dokumentasyon. Kung ang sinumang gumagamit ay nagnanais o nangangailangan nito, maaari silang kumunsulta sa source code ng application na ito sa pahina ng GitHub ng application na ito.

Pag-install ng GitBook

Kung nais mong i-download ang pakete ng programa, maaari mo itong i-download mula sa iyong Official Site. Doon kaya natin i-download ito gamit ang browser. Maaari rin nating makuha ang package gamit ang utos ng wget pagbubukas ng isang terminal (Ctrl + Alt + T) at pagta-type dito ang sumusunod:

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

Kapag na-download na ang pakete, maaari namin itong mai-install sa pamamagitan ng pagpapatupad ng sumusunod na utos sa parehong terminal:

dpkg -i linux-64-bit

Matapos matapos ang pag-install, magagawa mong gamitin ang patlang sa paghahanap ng Ubuntu Dash at i-type ang gitbook. Ang icon ng application ay ipapakita sa screen.

Kapag nag-log in kami, alinman sa a Ang GitBook account o kasama ang aming social media account, maaari na kaming lumikha ng isang bagong Aklat. Magagawa natin ito sa pamamagitan ng pag-click sa pagpipiliang Bagong Aklat na magagamit sa screen.

Ngayon ay maaari ka nang magsimula sumulat ng iyong sariling Aklat sa Editor. Huwag kalimutang piliin sa editor ang lalagyan kung saan nais naming i-upload ang mga pagbabago.

Paano mai-sync ang Gitbook sa Github?

Isang bagay na napaka-kagiliw-giliw tungkol sa program na ito ay inaalok sa amin ang posibilidad ng pagtatrabaho sa GitHub. Nabasa ko na para sa ilang mga tao naging problema ito i-sync ang isang repository ng Github sa GitBook platform.

Ang unang bagay na kailangan nating gawin ay lumikha ng isang pampublikong imbakan sa Github. Kakailanganin din natin lumikha ng isang libro sa Gitbook web. Inirerekumenda, bagaman sa palagay ko hindi mahalaga na ang parehong mga repository ay may parehong pangalan.

Kapag nilikha ang libro mahalaga na i-access ang Mga tool sa Pagtatakda ng Aklat at pumunta sa seksyong Github. Kapag nasa loob na, magpapatuloy ka sa pumili ng pagsasama sa repository ng GitHub kung saan nais mong i-synchronize. Kapag napili na ang repository, magpapatuloy kaming tanggapin at i-save ang buong proseso.

Kapag natupad ang operasyong ito, kung naging maayos ang lahat, isang berdeng mensahe ang dapat na lumitaw na isinasaad iyon pagsasama sa Github gumagana ito

Upang suriin na gumagana ang lahat. Ngayon ay sisimulan namin ang sesyon sa GitBook client na na-install namin sa aming Ubuntu. Kapag nagsimula ito, maaari naming gawin ang mga pagbabago na isinasaalang-alang namin na may kaugnayan. Ngayon ay maaari na nating mai-upload ang mga ito sa aming bagong nilikha Repository ng GitHub.