Hoe Schrijvers Kunnen Gebruiken GitHub voor het Opslaan van Hun Werk

Er zijn vele manieren die u kunt beheren en opslaan van uw schrijven van projecten. Sommige mensen geven de voorkeur cloud storage diensten (zoals Dropbox) of online editors (zoals Google Docs), terwijl anderen gebruik maken van desktop applicaties (zoals Microsoft Word). Ik gebruik de naam iets GitHub.

GitHub: Het is voor Meer Dan Alleen Code

Ik gebruik Git en GitHub voor het opslaan van en toegang tot al mijn schrijven. Git is een effectieve tool die u gebruiken kunt voor het bijhouden van veranderingen in het document, en je kunt uploaden naar GitHub super-snel. Het is ook snel en eenvoudig downloaden van uw werk naar een tweede of derde apparaat.

Als je nog nooit hebt gehoord van GitHub, het is ‘ s werelds meest populaire bestemming voor het opslaan en onderhouden van open-source code. Dat klinkt misschien als een gekke plek voor het hosten van uw schrijven, maar het is niet! Immers, de code is slechts lijnen en lijnen van de tekst, als je artikel, verhaal, of proefschrift.

Rond 2013, GitHub gestart met het stimuleren van mensen tot het maken van archieven voor alle soorten informatie, niet alleen de code. GitHub nooit echt verlaten van de codering wortels, maar sommige mensen gebruiken het nog steeds om te slaan schrijven en andere niet-coderende projecten. Bijvoorbeeld, een persoon wordt gebruikt, Git en GitHub schrijven van een instructie-boek, terwijl een ander schreef een roman. Rondneuzen op Google, en je vindt allerlei gekke gebruikt voor GitHub.

Wat Zijn Git en GitHub?

Het informatieve gedeelte van een GitHub repository.

Git is een open-source programma gemaakt door Linus Torvalds, Linux roem. Git tracks wijzigingen aan documenten en maakt het makkelijker om meerdere mensen te werken aan hetzelfde document op afstand. In tech-spreken, het is wel een gedistribueerd versiebeheersysteem (of gedistribueerd VCS). Git is niet willekeurig opslaan versies van uw documenten bij de ingestelde intervallen. In plaats daarvan slaat wijzigingen aan uw documenten alleen als u aangeeft dat het moet.

Uw documenten vormen een repository (of repo ‘ s), dat is gewoon een fancy term voor je project map. Uw Documenten map in Windows, bijvoorbeeld, zou een archief als u gebruikt Git beheren (maar doen dat niet).

Wanneer u de wijzigingen bewaren van uw documenten in Git, het is wel een “plegen.” Een vastlegging is gewoon een verslag van de meest recente wijzigingen aan een document. Iedere commit die is toegewezen aan een lange reeks cijfers en letters als ID.

Als u een verleden begaan door haar ID, zie je niet het hele project als u in het Word-document van de geschiedenis. Ziet u alleen de meest recente wijzigingen wanneer die begaan was. Echter, dit betekent niet dat het hele project niet opgenomen. U kunt alle uw schrijven van een project map en nog steeds de meest recente versie terug met een paar git commando ‘ s. U kunt ook terug gaan en zien hoe het project er een week geleden, of zes maanden geleden.

U kunt ook berichten naar iedere commit, wat erg handig is. Bijvoorbeeld, als u iets te schrijven, maar zijn niet zeker dat u wilt om het te houden, net commit. De sectie overleeft in je commit geschiedenis, zelfs als u het verwijderen uit het project later.

Git werkt het beste op de commando-regel, en dat is een groot voordeel, maar het heeft ook zijn nadelen. De commando-regel is fijn te maken, verbindt en wijzigingen uploaden. Echter, als u wilt bekijken een commit geschiedenis, het is niet ideaal.

Dit is de reden waarom veel mensen zoals GitHub—een populaire online dienst die beschikt over een web-interface voor uw Git repositories. Op GitHub, kunt u gemakkelijk bekijken verleden verbindt, evenals het downloaden van uw schrijven naar meerdere Pc ‘ s.

Samen, Git en GitHub laat me mijn versie van de geschiedenis op granulair niveau. En het is gemakkelijk om mijn schrijven op een PC met een Bash commando-regel die, in deze dagen, inclusief Windows, Mac, Linux en Chrome OS machines.

Platte Tekst Bestanden Dingen Makkelijk Te Maken

Git kan helpen bij het opslaan van uw schrijven, maar het kan niet zorgen dat u een betere schrijver.

Git en GitHub doen pleegt op vrijwel elk bestandstype voor het schrijven, hoewel het werkt het best met tekst zonder opmaak. Als je schrijft in Microsoft Word, het zal werken, maar u zult niet in staat zijn om uw verleden commits toe op de opdrachtregel of in GitHub. U moet in plaats daarvan een verleden begaan op de commando-regel (ook wel een “checkout”), en open vervolgens uw Word-bestand. De Word-bestand ziet er net zo uit als wanneer je de originele commit, en u kunt teruggaan naar de huidige versie met een snelle opdracht.

Als u gebruik Scrivener, dat werkt ook. Scrivener bestanden worden opgeslagen als tekst, dus het toont ook het verleden pleegt op GitHub en de commando-regel. Maar Scrivener slaat ook gegevens die belangrijk is voor het programma, maar niet voor u. In iedere commit, je zult eindigen met een hoop rommel, dat maakt het moeilijk om te lezen.

Ik gebruik de platte tekst bestanden, want dat is alles wat je moet string woorden aan elkaar, vooral in je eerste paar concepten.

Aan de Slag met Git

Laten we in de technische details van hoe dit allemaal werkt. We beginnen met een PC, en vervolgens omhoog naar de cloud met GitHub.

Om te beginnen, moet u de terminal programma op macOS of Linux. Als uw computer Windows 10 installeren van Ubuntu of een andere Linux-distributie via de Windows-Subsysteem voor Linux (WSL), dat is vrij eenvoudig. U kunt controleren onze tutorial over het installeren van de Linux Bash shell op Windows-10. Of, als u een oudere versie van Windows, kunt u gebruik maken van Cygwin om een Bash-shell.

Open je terminal en ga naar de map die u wilt gebruiken als een Git repository. Voor onze doeleinden, laten we zeggen we hebben een map met de naam “MyNovel” in de map Documenten. Let op dat er geen spatie tussen de woorden van onze Git repo. U zult uw leven gemakkelijker maken als je het op deze manier als Bash niet zoals spaties, en het omgaan met hen wordt verwarrend.

Navigeer naar de MyNovel map in de terminal. Om dit te doen in de Windows-10, de opdracht is:

cd /mnt/c/Gebruikers/[Jouwgebruikersnaam]/Documenten/MyNovel

Elke WSL opdracht die samenwerkt met bestanden die zijn opgeslagen in Windows moet gebruiken voor de /mnt/. Let ook op dat de kleine “c” geeft aan dat de drive bent u op. Als uw bestanden zich op een “D:/” drive, dan kunt u gebruik /d/.

Voor macOS en Linux het commando is veel eenvoudiger:

cd ~/Documenten/MyNovel

Vanaf hier, de commando ‘ s zijn hetzelfde.

Nu, we hebben voor het initialiseren van de MyNovel map als een Git repository. Dit commando werkt of u nu net begint met een frisse nieuwe of hebben al een aantal opgeslagen bestanden in.

git init

De map is nu een Git repository. Mij niet gelooft? Typ dit in:

ls-a

Die opdracht vraagt de computer om een lijst van alles wat in de huidige map, met inbegrip van verborgen items. Je moet er iets worden vermeld in de richting van de top genoemd “.git” (let op de punt). De verborgen “.git” is de map waar uw document versie-geschiedenis wordt opgeslagen. U hoeft nooit open, maar het is er.

De Eerste Commit

Voordat we onze eerste commit Git wil je weten wat jouw naam en e-mailadres. Git gebruikt deze informatie om bij te identificeren die het vastleggen en die informatie is opgenomen in het commit-log. Voor praktische doeleinden, is dit niet van belang, omdat schrijvers zijn meestal solo vliegen, maar Git nog steeds vereist.

Voor het instellen van uw e-mail adres doet u het volgende:

git config –global gebruiker.e-mail “[Jouw mail]”

git config –global gebruiker.de naam “[Jouw naam]”

Dat is het. Nu op naar de eerste vastlegging.

Stel er zijn drie documenten in de “MyNovel” map met de naam: “Chapter1,” “Hoofdstuk 2,” en “Hoofdstuk 3.” De wijzigingen op te slaan, hebben we Git te vertellen dat het bijhouden van deze bestanden. Om dit te doen, typt u:

git add .

De periode verteld Git te controleren untracked bestanden in de map (d.w.z. bestanden die u wilt maken geschiedenissen). Deze opdracht wordt ook verteld Git te bereiden momenteel bijgehouden bestanden die zijn gewijzigd. Dit proces heet de tijdelijke bestanden van commit.

Voor onze doeleinden, staging is niet zo belangrijk, maar het kan nuttig zijn. Als u wijzigingen aanbrengt in Hoofdstuk 2 en Hoofdstuk 3, maar je wilt alleen de wijzigingen vast te leggen in Hoofdstuk 2, zou je het podium Hoofdstuk 2 als volgt:

git add Chapter2.doc

Dit vertelt Git u wilt krijgen van de wijzigingen in Hoofdstuk 2 klaar voor plegen, maar niet Hoofdstuk 3.

Nu is het tijd voor de eerste commit:

Git commit -m “Dit is mijn eerste plegen.”

De “m” wordt genoemd, een vlag, en het vertelt Git wilt u een commit en tack over een bericht, dat zie je tussen de aanhalingstekens. Ik gebruik graag mijn berichten te markeren woord telt. Ook gebruik ik ze op te merken speciale informatie, zoals: “Deze vastlegging een interview met de CEO van Acme Widgets.”

Als ik bezig ben met een verhaal, ik kan ook een bericht dat zegt: “Dit is begaan, heeft de nieuwe scène waar de hond loopt weg.” Nuttige berichten maken het eenvoudiger vinden van uw pleegt later.

Nu dat we zijn begonnen met het bijhouden van onze documenten, het is tijd om ons te schrijven in de cloud met GitHub. Ik gebruik GitHub als een extra back-up, een betrouwbare plek om te kijken naar mijn veranderingen in het document, en een manier om mijn spullen op meerdere Pc ‘ s.

Aan de Slag met GitHub

U vult het formulier in voor het maken van een nieuwe GitHub repository.

Eerste, moet u zich aanmelden voor een gratis account op GitHub (het is niet nodig om een betaalde account aan te maken private repositories). U kunt echter alleen samen met maximaal drie personen op een eigen repo. Als je een team van vijf of meer te werken aan een artikel, moet u zich aanmelden voor een Pro-account ($7, – per maand, bij dit schrijven).

Nadat je een account hebt aangemaakt, laten we een nieuwe repo. Meld u aan bij uw account en gaat u naar https://github.com/new.

Het eerste wat we moeten doen is de naam van de gegevensopslagruimte. U kunt gebruik maken van de zelfde naam die u gebruikt voor de map op je PC. Onder “Archief Naam,” type “MyNovel.”

De “Beschrijving” is optioneel, maar ik wil om het te gebruiken. Je kunt iets als “Mijn prachtige nieuwe roman over een jongen, een meisje, en hun hond,” enz.

Selecteer vervolgens de “Eigen” radio knop, maar niet het vakje genaamd “Initialiseren van de repository met een LEESMIJ-bestand.” We willen niet te doen, want we hebben al een gegevensopslagruimte op onze PC. Als we maken een LEESMIJ-bestand nu, het maakt het wat moeilijker.

Volgende, klik op ‘ Maak Archief.” Onder “Quick setup—als je gedaan hebt met dit soort dingen voor,” de URL te kopiëren. Het moet er als volgt uitzien:

https://github.com/[Uw GitHub gebruikersnaam]/MyNovel.git

Nu is het terug naar het bureaublad en onze geliefde commando-regel.

Druk Uw Desktop-Gegevensopslagruimte naar de Cloud

Met behulp van Git op de commando-regel.

De eerste keer dat u verbinding maakt met een repo te GitHub, moet u gebruik maken van een paar gespecialiseerde opdrachten. De eerste is:

git remote add oorsprong https://github.com/[Uw GitHub gebruikersnaam]/MyNovel.git

Dit vertelt Git een remote repository is de oorsprong van “MyNovel.” De URL vervolgens punten Git in de richting van externe oorsprong. Niet te opgehangen te krijgen op het begrip “oorsprong;” het is slechts een conventie. Je kunt noemen het “zachte” als je dat wilt—oorsprong is gewoon makkelijker omdat het is de meest voorkomende manier om het gebruik van Git.

Als u het uploaden van nieuwe veranderingen met Git, het is wel een “push.” Wanneer u het downloaden van de wijzigingen, het heet een “trek” of “halen.” Nu is het tijd om uw eerste commit naar GitHub. Hier is wat je doet:

git push -u oorsprong master

U zult worden gevraagd om uw GitHub gebruikersnaam en wachtwoord. Als u uw referenties correct, alles uploads, en je bent goed om te gaan.

Wilt u meer zekerheid voor uw GitHub uploadt, kunt u gebruik maken van een SSH-sleutel. Dit kunt u gebruik maken van een enkel wachtwoord voor de SSH-sleutel uploaden, zodat u niet uw volledige GitHub referenties elke keer. Plus, alleen iemand met de SSH-sleutel kunt uploaden bestand wijzigt.

Wilt u meer informatie over SSH sleutels, GitHub heeft de volledige instructies over hoe ze te gebruiken. U kunt ook uw Git referenties op uw PC.

Dat is het! Nu, als je wilt om de wijzigingen toe te voegen aan uw bestanden, kunt u dat doen met deze drie korte opdrachten (nadat u navigeren naar de “MyNovel” map):

git add .

Vertaling: “Hey, Git podium voor de vastlegging van alle untracked bestanden, evenals nieuwe wijzigingen aan de bestanden die u al bijhoudt.”

git commit -m “1.000 woorden op de nieuwe iPhone te beoordelen.”

Vertaling: “Hey Git, sla deze wijzigingen naast dit bericht.”

git push origin master

Vertaling: “Hey Git, het uploaden van de wijzigingen naar de oorspronkelijke versie van dit project op GitHub van mijn master copy op deze PC.”

Git en GitHub Bonus Tips

Dat is vrij veel, maar hier zijn een paar extra tips om uw ervaring met Git en GitHub nog beter:

Bekijk Verleden Verbindt

U kunt gebruik maken van GitHub te zien langs pleegt.

Weergeven verleden verbindt, gaat u naar uw MyNovel repository op GitHub. De richting van de bovenkant van de belangrijkste pagina, onder de “Code < >” tabblad zie je een gedeelte dat zegt, “[X] begaat.”

Klik erop en je ziet een lijst van alle commits. Klik op de commit die je wilt, en je ziet je tekst (als deze is ingevoerd in platte tekst en niet het Woord, dat is). Alles in het groen is de nieuwe tekst als de commit is gemaakt; alles in het rood is verwijderd.

Gebruik het Pull-Opdracht

Het is gemakkelijk om te grijpen een nieuwe op de gegevensopslagruimte op een andere machine. Gewoon navigeren naar de plaats waar u wilt opslaan van het archief op de nieuwe machine, zoals cd ~/Documenten. Vervolgens typt u:

git pull https://github.com/[Uw GitHub gebruikersnaam]/MyNovel.git

Typ uw referenties als u hierom wordt gevraagd, en in een paar seconden ben je klaar om te gaan. Nu, plegen van nieuwe veranderingen, en dan stuurt ze terug naar GitHub via git push origin master. Wanneer u terug bent op de PC waar u normaal gesproken werkt, open je gewoon de commando-regel gebruikt, navigeer dan naar je project map en typ in git pull. De nieuwe wijzigingen downloaden, en net als dat het schrijven van uw project is up-to-date op al je apparaten.

Niet over Beken

De meeste van de tijd aan het schrijven is niet een team inspanning en gaat het om één persoon. Omdat dat in dit artikel wordt Git op een manier die niet zou werken voor een multi-persoon-project. Specifiek, we gemaakt bewerkingen direct naar de master versie van onze roman in plaats van het creëren van zogenaamde “takken.” Een tak is een praktijk versie van de roman, waar u wijzigingen kunt aanbrengen zonder dat de originele master. Het is als het hebben van twee verschillende exemplaren van je boek bestaande parallel met noch invloed op de andere. Als je van de veranderingen in de praktijk tak die je kunt samenvoegen tot de master versie (of master branch). Als u niet wilt dat te doen, is dat ook goed. Gewoon weggooien in de praktijk tak.

De takken zijn zeer krachtig, en ze zou de eerste workflow met meerdere schrijvers op een enkel project. Solo schrijvers hoeven niet echt te gebruiken vestigingen, in mijn mening, zolang je niet verschillende wijzigingen in de master branch op hetzelfde moment op meerdere Pc ‘ s.

Bijvoorbeeld, moet u uw werk laten voltooien op je bureaublad, laat je commits, en duw vervolgens de wijzigingen op GitHub. Ga dan naar uw laptop en trek alle nieuwe wijzigingen voordat u verdere wijzigingen. Als u dat niet, je zou kunnen eindigen met wat Git oproepen “conflicten.” Dat is als Git zegt, “Hey, er zijn veranderingen in GitHub en op deze PC die niet overeenkomen. Help mij dit uitzoeken.”

Het sorteren van jouw manier van een conflict kan een pijn zijn, dus het is best om het te vermijden wanneer mogelijk.

Zodra je aan de slag met Git, er zijn vele dingen die je kunt leren, zoals vertakkingen, het verschil tussen een vennootschap en een trek, wat GitHub ‘ s trekken verzoeken zijn, en hoe om te gaan met de gevreesde conflict.

Git kan ingewikkeld lijken te nieuwkomers, maar als je eenmaal onder de knie, het is een krachtige tool die u kunt gebruiken voor het beheren en opslaan van uw schrijven.

LEES VERDER

• “Hoe Gemakkelijk het Recyclen van de Oude Elektronica Kan Je niet Verkopen
• “Hoe om te Controleren of Uw Chromecast Is Nog steeds het Krijgen van Updates
• “Hoe om Adobe Flash SWF-Bestanden Buiten Uw Web-Browser
• “Opdrachtregels: Waarom Doen Mensen Nog De Moeite?
• “Wat te Doen Als Je Mac niet Afsluiten