Hur Författare Kan Använda GitHub för att Lagra Sitt Arbete

0
400

Det finns många sätt du kan hantera och lagra ditt skrivande projekt. En del människor föredrar moln lagring tjänst (som Dropbox) eller online redaktörer (såsom Google Docs), medan andra använder desktop-applikationer (som till exempel Microsoft Word). Jag använder något som kallas GitHub.

GitHub: Det är Mer Än Bara Kod

Jag använder Git och GitHub för att lagra och få tillgång till alla för mitt skrivande. Git är ett effektivt verktyg som du kan använda för att spåra förändringar av dokument, plus att du kan ladda upp till GitHub super-snabbt. Det är också snabb och enkel att ladda ner ditt arbete för en andra eller tredje enhet.

Om du har aldrig hört talas om GitHub, det är världens mest populära destination för att lagra och upprätthålla en öppen-källkod. Det kan låta som en galen plats för att hålla ditt skrivande, men det är det inte. Efter alla, koden är bara och raderna av text, gillar din artikel, berättelse eller avhandling.

Runt 2013, GitHub började uppmuntra människor att skapa slutförvar för alla typer av information, inte bara kod. GitHub har aldrig riktigt lämnat sin kodning rötter, men vissa människor fortfarande använda den för att lagra skriver och andra icke-kodande projekt. Till exempel, en person som använt Git och GitHub för att skriva en instruktions bok, medan en annan skrev en roman. Peta runt på Google, och du finner alla typer av galna använder för GitHub.

Vad Är Git och GitHub?

Den informativa delen av ett GitHub repository.

Git är ett open-source program som skapats av Linus Torvalds, av Linux fame. Git spår ändringar i dokument och gör det lättare för flera personer att arbeta på samma dokument på distans. I tech-tala, det kallas distributed version control system (eller distribueras VCS). Git inte godtyckligt spara versioner av dina dokument med jämna mellanrum. I stället lagrar ändringar i dina dokument bara när du säger det till.

Dina dokument utgör en förvaringsplats (eller repa), som ligger bara en fancy term för din projektmapp. Din Dokument-mapp i Windows, till exempel, skulle vara ett arkiv om du har använt Git för att hantera det (men gör inte det).

När du sparar ändringar i dina dokument i Git, det kallas en “commit.” Ett åtagande är bara ett register över de senaste ändringarna som du har gjort i ett dokument. Varje begå har tilldelats en lång rad av siffror och bokstäver som dess ID.

Om du ringer upp en tidigare begå av dess ID, du behöver inte se hela projektet som du gör i Word-dokumentet historia. Du bara se de senaste ändringarna när som begår gjordes. Men detta betyder inte att hela projektet var inte registreras. Du kan ta bort alla dina skriver från en projekt-mapp och ändå få den senaste versionen tillbaka med några git-kommandon. Du kan även gå tillbaka och se hur projektet såg ut för en vecka sedan, eller sex månader sedan.

Du kan också omfatta meddelanden till varje begå, som är mycket användbart. Till exempel, om du skriver något men är inte säker på att du vill behålla det, bara gör en commit. Avsnittet då överlever i din begå historia även om du tar bort det från projektet senare.

Git fungerar bäst på kommandoraden, vilket är en stor fördel men har också sina nackdelar. Kommandoraden är bra för att skapa begår och ladda upp ändringar. Men om du vill visa en commit historia, det är inte idealiskt.

Detta är anledningen till att många människor som GitHub—en populär online-tjänst som erbjuder ett webb-gränssnitt för din Git-arkiv. På GitHub, kan du enkelt visa tidigare begår, samt ladda ner ditt skrivande till flera Datorer.

Tillsammans, Git och GitHub låt mig kontrollera min version av historien på en detaljerad nivå. Och det är lätt att ta mitt skrivande på vilken DATOR som helst som kan köra en Bash kommando som i dessa dagar inkluderar Windows, Mac, Linux och Chrome OS maskiner.

Filer Med Oformaterad Text Gör Det Enkelt

Git kan hjälpa till att spara ditt skrivande, men det kan inte göra dig till en bättre skribent.

Git och GitHub göra begår på ganska mycket varje filtyp för att skriva, även om det fungerar bäst med oformaterad text. Om du skriver i Microsoft Word, det kommer att fungera, men du kommer inte att kunna se dina tidigare begår på kommandoraden eller i GitHub. Du har i stället för att ringa upp ett tidigare begå på kommandoraden (kallas en “kassan”), och öppna sedan Word-fil. Den Word-fil som sedan ser ut precis som det gjorde när du gjorde den ursprungliga begå, och du kan gå tillbaka till din nuvarande version med en annan snabbt kommandot.

Om du använder Scrivener, som fungerar också. Scrivener sparar filer som text, så som det visar också tidigare begår på GitHub och kommandoraden. Men Scrivener också sparar data som är viktig för programmet, men inte till dig. I varje begå, du kommer att hamna med en massa skräp som gör det svårt att läsa.

Jag använder filer med oformaterad text för det är allt du behöver för att string ord tillsammans, i synnerhet i ditt första utkast.

Komma Igång med Git

Låt oss gå in på tekniska detaljer om hur det hela fungerar. Vi kommer att börja med PC, och sedan flytta upp till molnet med GitHub.

För att komma igång behöver du ett terminalprogram på macOS eller Linux. Om din dator kör Windows 10, har du installerar Ubuntu eller någon annan Linux-distribution via Windows Delsystem för Linux (WSL), vilket är ganska lätt. Du kan kolla in vår handledning om hur man installerar Linux-skalet Bash på Windows-10. Eller, om du använder en äldre version av Windows, kan du använda Cygwin för att få ett Bash-skalet.

Öppna din terminal och navigera till den mapp du vill använda som ett Git-repository. För vårt ändamål, låt oss säga att vi har en mapp som heter “MyNovel” i mappen Dokument. Observera att det inte är något mellanrum mellan orden av våra Git-repo. Du kommer att göra ditt liv enklare om du gör det på detta sätt som Bash inte gillar utrymmen, och ta itu med dem blir förvirrande.

Nästa, navigera till MyNovel mapp i terminalen. För att göra detta i Windows 10, kommandot är:

cd /mnt/c:/Users/[Användarnamn]/Dokument/MyNovel

Någon WSL kommando som interagerar med filer som sparats i Windows måste använda /mnt/. Observera också att ett litet “c” anger den enhet du är på. Om dina filer är på “D:/” – enhet, då du använder /d/.

För macOS och Linux-kommandot är mycket enklare:

cd ~/Documents/MyNovel

Här kommandona är de samma.

Nu har vi för att initiera MyNovel mapp som ett Git-repository. Detta kommando fungerar oavsett om du bara starta en ny roman eller som redan har några sparade filer inuti.

git init

Din mapp är nu ett Git-repository. Tror mig inte? Typ detta:

ls-a

Kommandot frågar datorn att lista allt i den aktuella mappen, inklusive dolda objekt. Du bör se någonting som anges mot toppen heter “.git” (not perioden). Det dolda “.git” mappen där dokumentet version historik sparas. Du ska aldrig behöva öppna detta, men det måste vara det.

Den Första Begå

Innan vi gör vårt första åta Git vill veta ditt namn och din e-postadress. Git använder denna information för att identifiera vem som har gjort åtagandet, och att information som ingår i commit-logga. För praktiska ändamål, detta spelar ingen roll eftersom författarna är oftast flyger solo, men Git fortfarande kräver det.

Ange din e-postadress och adress göra följande:

git-config –globala användare.e-post “[Din e-post]”

git-config –globala användare.namnet “[Ditt namn]”

Det är det. Nu till den första begå.

Låt oss anta att det finns tre dokument i “MyNovel” mapp som heter: “Kapitel 1,” “Kapitel 2,” och “Kapitel3.” För att spara ändringar har vi säga Git för att spåra dessa filer. För att göra detta skriver du:

git add .

Perioden berättar Git för att övervaka alla spårats filer i mappen (dvs filer som du vill skapa historia). Detta kommando också berättar Git för att förbereda alla för närvarande spåras filer som har ändrats. Denna process kallas staging-filer för att arkivera.

För våra syften, staging är inte så viktigt, men det kan vara användbart. Om du gör ändringar i Kapitel 2 och Kapitel 3, men bara vill bekräfta ändringarna i Kapitel 2, skulle du skede Kapitel 2 som så:

git add Chapter2.doc

Här berättar Git du vill få ändringar i Kapitel 2 redo för att begå, men inte Kapitel 3.

Nu är det dags för den första commit:

Git commit-m “Detta är mitt första begå.”

Det “-m” kallas en flagga, och det säger Git du vill göra en commit och tack för ett meddelande, som du ser mellan citattecken. Jag gillar att använda min begå meddelanden för att markera ord räknas. Jag har också använda dem för att observera speciell information, till exempel: “Detta åtagande ingår en intervju med VD för Acme Widgets.”

Om jag skriver en historia, jag kan innefatta ett meddelande som säger: “Detta åtagande har den nya scenen där hund går bort.” Hjälpsamma meddelanden gör det enklare att hitta din begår senare.

Att vi nu har börjat spåra våra handlingar, är det dags att sätta våra skriva i molnet med GitHub. Jag använder GitHub som en extra backup, en tillförlitlig plats för att titta på mina dokument ändras, och ett sätt att komma åt mina grejer på flera Datorer.

Komma Igång med GitHub

Du fyller i formuläret för att skapa ett nytt GitHub repository.

Först måste du registrera dig för ett gratis konto på GitHub (du behöver inte ett betalt konto för att skapa eget arkiv). Du kan dock bara samarbeta med upp till tre personer på en egen repo. Om du har ett team av fem eller fler arbetar på en artikel, måste du registrera dig för ett Pro-konto ($7 per månad, när det här skrivs).

Efter att du skapat ditt konto, låt oss göra en ny repa. Logga in på ditt konto och gå till https://github.com/new.

Det första vi behöver göra är vilket namn arkivet. Du kan använda samma namn som du använde för den mapp på din DATOR. Under “Arkiv Namn,” typ “MyNovel.”

“Beskrivning” är valfritt, men jag gillar att använda den. Kan du skriva något i stil med “Mina fantastiska nya roman om en pojke, en flicka, och deras hund,” etc.

Därefter väljer du “Privat” knappen, men inte markera rutan som heter “Initiera denna repository med en README-fil.” Vi vill inte göra det, eftersom vi redan har ett arkiv på vår DATOR. Om vi skapar en README-fil just nu, det gör det svårare.

Nästa, klicka på “Skapa Arkiv.” Under “Quick setup—om du har gjort denna typ av sak innan,” kopiera URL: en. Det bör se ut ungefär så här:

https://github.com/[Ditt GitHub Användarnamn]/MyNovel.git

Nu är det tillbaka till skrivbordet och vår älskade kommandoraden.

Tryck Skrivbordet Förrådet till Molnet

Med hjälp av Git på kommandoraden.

Första gången du ansluter en repa till GitHub, du måste använda ett fåtal specialiserade kommandon. Den första är:

git remote lägga ursprung https://github.com/[Ditt GitHub Användarnamn]/MyNovel.git

Här berättar Git ett fjärrarkiv är ursprunget till “MyNovel.” URL: en är punkterna Git mot att avlägsna ursprung. Inte få alltför hängas upp på begreppet “ursprung;” det är bara en konvention. Du kan kalla det “fluffiga” om du vill ursprung är bara lättare eftersom det är det vanligaste sättet att använda Git.

När du laddar upp nya förändringar med Git, det kallas “push”. När du hämtar förändringar, det kallas en “pull” eller “hämta.” Nu är det dags att driva din första förbinda sig till GitHub. Här är vad du gör:

git push-u ursprung master

Du kommer att bli tillfrågad att ange ditt GitHub användarnamn och lösenord. Om du skriver dina referenser på rätt sätt, allt inlagda, och du är bra att gå.

Om du vill ha mer säkerhet för ditt GitHub inlagda, kan du använda en SSH-nyckel. Detta gör att du kan använda ett lösenord för SSH-nyckel för att ladda upp, så att du inte behöver skriva in hela ditt GitHub autentiseringsuppgifter varje gång. Plus, bara någon med SSH-nyckel kan ladda upp filen ändras.

Om du vill ha mer info om SSH-nycklar, GitHub har fullständiga instruktioner om hur man använder dem. Du kan också spara dina Git referenser på din DATOR.

Det är det! Nu, när du vill lägga in ändringar till dina filer, kan du göra så med dessa tre korta kommandon (efter att du navigera till “MyNovel” – mappen):

git add .

Översättning: “Hej, Git scenen för att begå alla spårats filer, såväl som att nya förändringar i filer som du redan spårar.”

git commit-m “1000 ord på den nya iPhone granskning.”

Översättning: “Hej Git, spara dessa förändringar tillsammans med detta meddelande.”

git push origin master

Översättning: “Hej Git, ladda upp ändringarna till ursprunget versionen av detta projekt på GitHub från min herre kopia på denna PC.”

Git och GitHub Bonus Tips

Det är ganska mycket det, men här är några extra tips för att göra din upplevelse med Git och GitHub ännu bättre:

Visa Tidigare Begår

Du kan använda GitHub att se förbi begår.

Visa tidigare historik, gå till din MyNovel arkivet på GitHub. Överst på huvudsidan, under “Kod < >” – fliken, du ser ett avsnitt som säger, “[X] begår.”

Klicka på den och du kan se en lista över alla dina begår. Klicka på de begår du vill, och du ser din text (om du skrev det i klartext och inte Ord, det är). Allt som markerade i grönt var nytt sms: a när de begår skapades, allt i rött togs bort.

Använd Dra-Kommandot

Det är lätt att ta en ny databas på en annan dator. Bara navigera till den plats där du vill spara räntan på den nya maskinen, såsom cd ~/Documents. Skriv sedan:

git pull https://github.com/[Ditt GitHub Användarnamn]/MyNovel.git

Skriv dina inloggningsuppgifter, om du uppmanas till det, och i ett par sekunder, kommer du vara redo att gå. Nu, begå nya förändringar, och sedan skicka dem tillbaka till GitHub via git push origin master. När du kommer tillbaka till DATORN där du arbetar oftast är det bara att öppna kommandoraden, navigera till ditt projekt mapp, och typ i git pull. De nya förändringarna kommer att ladda ner, och precis som att ditt skrivande projektet är uppdaterad på dina olika enheter.

Inte Korsa Vattendrag

De flesta av den tid som skrivandet är inte ett lagarbete och innebär endast en person. På grund av att denna artikel använder Git på ett sätt som inte skulle fungera för en multi-person-projektet. Specifikt har vi gjort redigeringar direkt till master-version av vår nya istället för att skapa så kallade “grenar.” En filial är en praxis version av romanen där du kan göra ändringar utan att påverka den ursprungliga master. Det är som att ha två olika kopior av din roman parallellt med varken påverkar andra. Om du vill förändringar i praxis gren du kan koppla dem till master-version (eller master-branch). Om du inte vill göra det, det är bra också. Bara kasta bort den praxis gren.

Grenarna är mycket kraftfull, och med hjälp av dem skulle vara det primära arbetsflödet med flera författare på en och samma projekt. Solo författare egentligen inte behöver använda grenar, i min mening—så länge du inte göra olika förändringar för att master-branch samtidigt på flera Datorer.

Till exempel, bör du fylla i ditt arbete på skrivbordet, gör din historik, och tryck sedan ändringarna till GitHub. Gå sedan till din bärbara dator och dra alla nya förändringar ned innan du gör några ytterligare ändringar. Om du inte gör det kan du sluta med vad Git samtal “konflikter.” Det är när Git säger, “Hallå, det är förändringar i GitHub och på denna PC som inte stämmer. Hjälp mig att lista ut detta.”

Sortering din väg ut ur en konflikt kan vara en smärta, så det är bäst att undvika den så mycket som möjligt.

När du väl kommer igång med Git, det finns massor av saker du kan lära dig, såsom grenar, skillnaden mellan en hämta och dra, vad GitHub s dra önskemål är, och hur man handskas med den fruktade konflikt.

Git kan verka komplicerat att nykomlingar, men när du får kläm på det, är det ett kraftfullt verktyg som du kan använda för att hantera och lagra ditt skrivande.

LÄS NÄSTA

  • “Hur Enkelt kan Återvinna den Gamla Elektronik Du inte Kan Sälja
  • “Hur kan man Kontrollera om Din Chromecast Är Fortfarande Få Uppdateringar
  • “Hur man Spelar Adobe Flash SWF-Filer Utanför Din Webbläsare
  • “Kommando Rader: Varför Människor Fortfarande Bry Sig Om Dem?
  • “Vad Gör du När Din Mac Kommer inte att Stänga av