„GitBook“, parašykite savo projektų dokumentaciją iš „Ubuntu“

Kitame straipsnyje apžvelgsime „GitBook“. Tai yra vienas kelių platformų GUI programa, kurios pagrindinė funkcija yra perkelti „GitBook“ darbo eigą į mūsų darbalaukį „Ubuntu“. Pažvelgus į jo sąsają, galite pamatyti, kad jis yra gerai apgalvotas redaguoti tekstą ir dirbti su tiesiogine projekto peržiūra.

„GitBook“ buvo sukurtas 2014 m. Viduryje. Jis gimė norėdamas sukurti „ Modernus ir paprastas dokumentų kūrimo, skaitmeninio rašymo ir turinio leidybos sprendimas. Projekto filosofija yra paprasta, neprarandant elegancijos taško. Turinio kūrėjams išsiblaškymas ir rūpesčiai pašalinami, todėl jie gali laisvai rašyti.

Šimtai tūkstančių vartotojų naudoja „GitBook“ rašyti dokumentus (biblioteka, API, įrankiai ir kt.) arba žinių bazės (pvz., DUK). Žmonės taip pat naudoja šią programą techninėms knygoms, mokymo medžiagai ir daugeliui kitų dalykų leisti.

„GitBook“ bendrosios funkcijos

Tai yra internetinė platforma dokumentams rašyti ir talpinti. Tai suteikia atvirojo kodo knygų formatą ir įrankių grandines.

Ši programa mums pasiūlys įmontuotas „Git“ valdymas. Mes taip pat turėsime turinio lentelę, failų medžio skydelį ir greito formato mygtukus, kad palengvintume dokumentų struktūrizavimą.

Be to, „GitBook“ siūlo mums galimybę rodyti mūsų turinį kaip svetainę (pritaikoma ir išplečiama) arba kaip elektroninė knyga (PDF, ePub arba Mobi).

„GitBook.com“ yra internetinė platforma, skirta kurti ir talpinti knygas, sukurtas programos formatu. Siūlo prieglobą, bendradarbiavimo funkcijas ir lengvai naudojamą redaktorių. Ši programa leidžia mums naudoti savo komandą vietinėms knygoms kurti „GitHub“ arba platformoje, kurioje jas galima laikyti.

Norėdami pradėti naudoti šią programą, kūrėjai suteikia galimybę vartotojams susipažinti su montavimo instrukcijos dokumentacijoje. Jei kuris nors vartotojas to nori ar jam to reikia, jis gali ieškoti šios programos šaltinio kodo GitHub šios programos.

„GitBook“ diegimas

Jei norite atsisiųsti programos paketą, galite jį atsisiųsti iš savo Oficiali svetainė. Ten mes galime atsisiųskite ją naudodamiesi naršykle. Mes taip pat galime gauti paketą naudodami wget komanda atidarydami terminalą („Ctrl“ + „Alt“ + T) ir įvesdami jį taip:

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

Atsisiuntę paketą, mes galime jį įdiegti vykdydami šią komandą tame pačiame terminale:

dpkg -i linux-64-bit

Baigę diegimą galėsite naudoti „Ubuntu Dash“ paieškos lauką ir įvesti „gitbook“. Ekrane bus rodoma programos piktograma.

Kai būsime prisijungę, arba su „GitBook“ paskyra arba su mūsų socialinės žiniasklaidos paskyra, dabar galime sukurti naują knygą. Tai galime padaryti spustelėdami ekrane esančią parinktį Nauja knyga.

Dabar galite pradėti parašykite savo knygą redaktoriuje. Nepamirškite redaktoriuje pasirinkti saugyklą, į kurią norime įkelti pakeitimus.

Kaip sinchronizuoti „Gitbook“ su „Github“?

Kažkas labai įdomu šioje programoje yra tai, kad ji suteikia mums galimybę dirbti su „GitHub“. Skaičiau, kad kai kuriems žmonėms tai buvo problema sinchronizuoti „Github“ saugyklą su „GitBook“ platforma.

Pirmas dalykas, kurį turėsime padaryti, yra sukurti viešą „Github“ saugyklą. Mums taip pat reikės sukurti knygą „Gitbook“ tinkle. Tai rekomenduojama, nors manau, kad nėra būtina, kad abi saugyklos turėtų tą patį pavadinimą.

Sukūrus knygą svarbu prieiti prie knygą Nustatymo įrankiai ir eikite į skyrių „Github“. Įėję į vidų, eisite toliau pasirinkite integraciją su „GitHub“ saugykla su kuriais norite sinchronizuoti. Pasirinkę saugyklą, mes ir toliau priimsime ir išsaugosime visą procesą.

Atlikus šią operaciją, jei viskas pavyko gerai, turėtų pasirodyti žalias pranešimas, nurodantis, kad integracija su „Github“ Veikia.

Norėdami patikrinti, ar viskas veikia. Dabar pradėsime sesiją su „GitBook“ klientu, kurį įdiegėme savo „Ubuntu“. Kai jis prasideda, galime atlikti pakeitimus, kurie, mūsų manymu, yra svarbūs. Dabar galime juos įkelti į naujai sukurtus „GitHub“ saugykla.