GitBook, skriv dokumentation för dina projekt från Ubuntu

I nästa artikel ska vi ta en titt på GitBook. Det här är en plattforms-GUI-applikation, vars huvudsakliga funktion är att ta med GitBook-arbetsflödet till vårt skrivbord i Ubuntu. Om du tittar på dess gränssnitt kan du se att det är genomtänkt för att redigera text och arbeta med liveförhandsgranskningen av projektet.

GitBook skapades i mitten av 2014. Det föddes för att skapa en Modern och enkel lösning för att skapa dokument, digitalt skrivande och publicering av innehåll. Projektets filosofi är att vara enkel utan att förlora elegansen. Distraktioner och oro för innehållsskapare elimineras, så att de kan skriva fritt.

Hundratusentals användare använder GitBook för att skriva dokumentation (bibliotek, API, verktyg etc.) eller kunskapsbaser (t.ex. vanliga frågor). Människor använder också detta program för att publicera tekniska böcker, läromedel och många andra saker.

GitBook Allmänna funktioner

Det här är en online-plattform för att skriva och vara värd för dokumentation. Det ger ett öppen källkodsformat och verktygskedjor.

Detta program kommer att erbjuda oss inbyggda Git-kontroller. Vi kommer också att ha en innehållsförteckningspanel, en filtree-panel och snabbformatsknappar för att underlätta struktureringen av våra dokument.

Dessutom erbjuder GitBook oss möjligheten att visa vårt innehåll som en webbplats (anpassningsbar och utdragbar) eller som en e-bok (PDF, ePub eller Mobi).

GitBook.com är onlineplattformen för att skapa och vara värd för böcker som skapats i applikationsformatet. Erbjuder värd, samarbetsfunktioner och en lättanvänd redigerare. Detta program låter oss använda vårt team för att skapa lokala böcker, på GitHub eller på plattformen för att vara värd för dem.

För att börja använda detta program, skaparna skapar tillgängliga för användarna möjligheten att konsultera installations instruktioner i dokumentationen. Om någon användare vill eller behöver det kan de läsa källkoden för denna applikation på sidan GitHub av denna ansökan.

GitBook-installation

Om du vill ladda ner programpaketet kan du ladda ner det från din Officiell webbplats. Där kan vi ladda ner den med webbläsaren. Vi kan också få paketet med wget-kommando öppnar en terminal (Ctrl + Alt + T) och skriver följande:

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

När paketet har laddats ner kan vi installera det genom att utföra följande kommando i samma terminal:

dpkg -i linux-64-bit

När installationen är klar kan du använda sökfältet i Ubuntu Dash och skriva gitbook. Applikationsikonen visas på skärmen.

När vi har loggat in, antingen med en GitBook-konto eller med vårt sociala mediekontokan vi nu skapa en ny bok. Vi kan göra detta genom att klicka på alternativet Ny bok som finns på skärmen.

Nu kan du börja skriv din egen bok i redigeraren. Glöm inte att välja i redigeraren förvaret som vi vill ladda upp ändringarna till.

Hur synkroniserar man Gitbook med Github?

Något mycket intressant med detta program är att det ger oss möjligheten att arbeta med GitHub. Jag har läst att detta har varit ett problem för vissa människor synkronisera ett Github-arkiv med GitBook-plattformen.

Det första vi måste göra är skapa ett offentligt arkiv på Github. Vi kommer också att behöva skapa en bok på Gitbook-webben. Det rekommenderas, även om jag tycker att det inte är väsentligt att båda förvaren har samma namn.

När boken har skapats är det viktigt att komma åt Bokinställningsverktyg och gå till avsnittet Github. Väl inne, kommer du att fortsätta till välj integration med GitHub-arkivet som du vill synkronisera med. När förvaret har valts fortsätter vi att acceptera och spara hela processen.

När denna åtgärd har genomförts, om allt har gått bra, bör ett grönt meddelande visas som indikerar att integration med Github det fungerar.

För att kontrollera att allt fungerar. Nu börjar vi sessionen med GitBook-klienten som vi har installerat i vår Ubuntu. När det börjar kan vi göra de ändringar som vi anser vara relevanta. Nu kan vi ladda upp dem till vårt nyskapade GitHub-förvar.