Wie Schriftsteller Verwenden Können, GitHub zum Speichern Ihrer Arbeit

0
989

Es gibt viele Möglichkeiten, wie Sie können verwalten und speichern Sie Ihre schreiben Projekte. Einige Leute bevorzugen cloud-storage-Dienste (wie Dropbox) oder online-Editoren (wie Google Docs), während andere desktop-Anwendungen (wie Microsoft Word). Ich habe etwas namens GitHub.

GitHub: Es ist für Mehr Als Nur Code

Ich nutze Git und GitHub zu speichern und Zugriff auf alle meine schreiben. Git ist ein wirksames Werkzeug, das Sie verwenden können, um die track-Dokument änderungen, plus können Sie das hochladen auf GitHub super-schnell. Es ist auch schnell und einfach herunterladen, um Ihre Arbeit zu einem zweiten oder Dritten Gerät.

Wenn Sie noch nie gehört haben von GitHub, es ist der weltweit beliebteste Ziel zum speichern und verwalten open-source-code. Das klingt vielleicht wie eine verrückte Ort, um Ihre Gastgeber zu schreiben, aber es ist nicht! Nachdem alle, code ist nur die Linien und Textzeilen, wie Ihr Artikel, Geschichte oder dissertation.

Um 2013, GitHub fing an, die Leute repositories erstellen für Sie alle Arten von Informationen, nicht nur code. GitHub nie wirklich verlassen und Ihre Codierung Wurzeln, aber einige Leute immer noch verwenden Sie es zum speichern schreiben und andere non-coding-Projekte. Zum Beispiel kann eine person verwendet Git und GitHub zu schreiben, ein Lehr-Buch, während ein anderer schrieb einen Roman. Stöbern Sie auf Google und finden Sie alle Arten von verrückten verwendet für GitHub.

Was Sind Git und GitHub?

Der informative Abschnitt von einem GitHub-repository.

Git ist ein open-source-Programm erstellt von Linus Torvalds, der Linux-fame. Git verfolgt änderungen an Dokumenten und macht es einfacher für mehrere Personen am selben Dokument arbeiten aus der Ferne. In tech-sprechen, spricht man von einem distributed-version-control-system (oder distributed VCS). Git nicht beliebig speichern von Versionen Ihrer Dokumente in festgelegten Intervallen. Stattdessen speichert die änderungen an Ihren Dokumenten nur, wenn Sie sagen, es zu.

Ihre Dokumente bilden ein repository (oder repo), das ist nur ein schicker Begriff für Ihr Projekt-Ordner. Ihr Ordner “Dokumente” in Windows, zum Beispiel, würde ein repository, wenn Sie mit Git zu verwalten (aber nicht tun).

Wenn Sie speichern die änderungen Ihrer Dokumente in Git es einen “Begehen.” Ein Begehen ist nur eine Aufzeichnung der jüngsten änderungen, die Sie an einem Dokument vorgenommen. Jeder commit zugeordnet ist, eine lange Reihe von zahlen und Buchstaben als ID.

Wenn Sie rufen eine Vergangenheit Begehen, durch Ihre ID, die Sie nicht sehen, das gesamte Projekt, wie Sie in Word das Dokument der Geschichte. Sehen Sie nur die letzten änderungen, wenn das commit gemacht wurde. Dies bedeutet jedoch nicht, dass das gesamte Projekt nicht erfasst. Können Sie löschen alle Ihre schreiben vom Projekt-Ordner und bekomme immer noch die aktuellste version wieder mit ein paar git-Befehle. Sie können auch zurück gehen und sehen, wie das Projekt sah vor einer Woche oder vor sechs Monaten.

Sie können auch Nachrichten an jeden zu Begehen, was sehr hilfreich ist. Zum Beispiel, wenn Sie etwas schreiben, aber nicht sicher sind, ob Sie es behalten wollen, nur ein commit. Der Abschnitt dann überlebt in Ihrem commit-Geschichte, auch wenn Sie es löschen aus dem Projekt später.

Git funktioniert am besten auf der Kommandozeile, das ist ein großer Vorteil, sondern hat auch seine Schattenseiten. Der Befehl Zeile ist in Ordnung zu erstellen, commits und änderungen hochladen. Jedoch, wenn Sie wollen, um eine commit-Historie, es ist nicht ideal.

Dies ist, warum viele Menschen wie GitHub—ein beliebter online-Dienst, bietet ein web-interface für Git-repositories. Auf GitHub können Sie sich bequem Vergangenheit begeht, als auch als download Ihrem schreiben an mehrere PCs.

Zusammen, Git und GitHub-lassen Sie mich die Kontrolle meiner version der Geschichte auf einer granularen Ebene. Und es ist leicht zu bekommen auf mein schreiben, die auf jedem PC ausgeführt werden können, ist eine Bash-Kommandozeile, die in diesen Tagen, einschließlich Windows, Mac, Linux und Chrome OS-Maschinen.

Nur-Text-Dateien Machen Sie Die Dinge Einfach

Git kann helfen, speichern Sie Ihre schreiben, aber es kann nicht machen Sie ein besserer Schriftsteller.

Git und GitHub tun verpflichtet auf so ziemlich jedem Dateityp für das schreiben, obwohl es funktioniert am besten mit text. Wenn Sie schreiben in Microsoft Word, es wird funktionieren, aber Sie werden nicht in der Lage, um zu sehen, Ihre Vergangenheit verpflichtet, die auf der Kommandozeile oder im GitHub. Stattdessen müssen Sie rufen Sie einen der letzten commit auf der Befehl-Linie (genannt eine “Kasse”), und öffnen Sie Ihre Word-Datei. Die Word-Datei dann sieht genauso aus wie damals, als Sie aus den ursprünglichen commit, und Sie können zurück zu Ihrer aktuellen version mit einem weiteren kurzen Befehl.

Wenn Sie Scrivener, das funktioniert auch. Scrivener speichert Dateien als text, so dass es auch zeigt die letzten commits auf GitHub und über die Befehlszeile. Aber Scrivener speichert auch Daten, die wichtig für das Programm, aber nicht für Sie. In jedem Begehen, werden Sie am Ende mit einer Menge von junk, die es schwer macht zu Lesen.

Ich verwenden nur-text-Dateien, weil das ist alles, was Sie brauchen, um string Wörter zusammen, vor allem in Ihren ersten Entwürfen.

Erste Schritte mit Git

Lassen Sie uns in die technischen Einzelheiten, wie das alles funktioniert. Wir beginnen mit PC, und verschieben Sie dann bis zu den Wolken mit GitHub.

Um loszulegen, müssen Sie das Programm terminal auf Mac OS oder Linux. Wenn Ihr computer läuft Windows 10 installiert man Ubuntu oder eine andere Linux-distribution, die über das Windows-Subsystem für Linux (WSL), das ist ziemlich einfach. Sie können schauen Sie sich unsere Anleitung zur Installation des Linux-Bash-shell auf Windows 10. Oder, wenn Sie eine ältere version von Windows verwenden, können Sie Cygwin um eine Bash-shell.

Öffnen Sie Ihr terminal und navigieren Sie zu dem Ordner, den Sie verwenden möchten, als ein Git-repository. Für unsere Zwecke nehmen wir an, wir haben einen Ordner namens “MyNovel” in den Ordner “Dokumente”. Beachten Sie, dass es keine Leerzeichen zwischen den Wörtern von unserem Git-repo. Sie werden Ihr Leben leichter machen, wenn Sie es so machen, wie Bash nicht, wie z.B. das Leerzeichen, und der Umgang mit Ihnen verwirrend.

Als Nächstes navigieren Sie zu der MyNovel Ordner in das terminal. Um dies zu tun in Windows 10, der Befehl ist:

cd /mnt/c/Benutzer/[Benutzername]/Dokumente/MyNovel

Alle WSL-Befehl die Interaktion mit Dateien in Windows muss /mnt/. Beachten Sie auch, dass die Kleinbuchstaben “c” gibt das Laufwerk an, du bist auf. Wenn Sie Ihre Dateien auf “D:/” – Laufwerk, dann verwenden Sie /d/.

Für macOS und Linux der Befehl ist viel einfacher:

cd ~/Dokumente/MyNovel

Von hier aus werden die Befehle sind die gleichen.

Nun, wir haben zum initialisieren der MyNovel folder in einem Git-repository. Dieser Befehl funktioniert egal, ob man gerade einen frischen Roman oder haben bereits einige gespeicherte Dateien im inneren.

git init

Ihr Ordner ist nun ein Git-repository. Glauben Sie mir nicht? Geben Sie diese in:

ls-a

Dieser Befehl fragt den computer, um alles aufzulisten, was in den aktuellen Ordner, auch versteckte Elemente. Sie sollten nun etwas sehen, aufgeführt in Richtung der oben genannten “.git” (beachten Sie die Frist). Die verborgenen “.git” – Ordner ist, wo Ihre Dokument-Versionsverlauf gespeichert. Sollten Sie nie brauchen, um dies zu öffnen, aber es muss da sein.

Der Erste Commit

Bevor wir jedoch unseren ersten commit Git will wissen, Ihren Namen und Ihre E-Mail-Adresse. Git verwendet diese Informationen, um zu identifizieren, wer Sie Begehen, und diese information ist enthalten in der commit-log. Für praktische Zwecke, das spielt keine Rolle, da Autoren in der Regel Fliegen solo, aber Git immer noch erfordert.

Richten Sie Ihre E-Mail-Adresse und Folgendes tun:

git config –global user.E-Mail “[Your-email]”

git config –global user.name “[Ihr name]”

Das ist es. Nun zu den ersten commit.

Nehmen wir an, es gibt drei Dokumente, die in der “MyNovel” Ordner namens: “Kapitel1,” “Kapitel2” und “Chapter3.” Um die änderungen zu speichern, müssen wir sagen, Git verfolgen diese Dateien. Um dies zu tun, geben Sie ein:

git add .

Die Zeit erzählt Git überwachen alle nicht verfolgte Dateien in den Ordner (d.h. Dateien, für die Sie erstellen möchten Geschichten). Dieser Befehl sagt auch, Git vorbereiten, die derzeit verfolgt Dateien, die geändert wurden. Dieser Vorgang wird als staging-Dateien für den commit.

Für unsere Zwecke, die Inszenierung ist nicht so wichtig, aber es kann nützlich sein. Wenn Sie änderungen an Kapitel 2 und Kapitel 3, aber nur wollen, um die änderungen in Kapitel 2, Sie würde Etappe Kapitel 2 so auf:

git add Chapter2.doc

Dies sagt Git, die Sie wollen, um die änderungen in Kapitel 2 bereit für den commit, aber nicht Kapitel 3.

Jetzt ist es Zeit für den ersten commit:

Git commit -m “mein Erster commit.”

Die “-m” genannt wird, ein flag, und erzählt es Git ein commit und tack auf eine Nachricht, die Sie sehen, zwischen den Anführungszeichen. Ich möchte meine commit-Nachrichten zu markieren Wort zählt. Ich benutze auch diese zu beachten spezielle Informationen, wie zum Beispiel: “Diese verpflichten enthält ein interview mit dem CEO von Acme Widgets.”

Wenn ich eine Geschichte Schreibe, könnte ich eine Nachricht, die sagt: “Diese Begehung hat der neue Szene, wo der Hund läuft Weg.” Hilfreich Nachrichten machen es leichter zu finden, Ihr begeht später.

Jetzt haben wir begonnen, die Verfolgung der Dokumente, es ist an der Zeit, unser schreiben in der cloud bei GitHub. Ich benutze GitHub als ein zusätzliches backup auf eine zuverlässige Ort zu suchen in meinem Dokument geändert wird, und ein Weg, um Zugriff auf meine Sachen auf mehreren PCs.

Erste Schritte mit GitHub

Füllen Sie das Formular zum erstellen eines neuen GitHub-repository.

Erste, Sie brauchen, um sich für einen kostenlosen account auf GitHub (Sie brauchen nicht einen bezahlten account zu erstellen, private repositories). Sie können jedoch nur gemeinsam mit bis zu drei Personen auf ein eigenes repo. Wenn Sie haben ein team von fünf oder mehr arbeite an einem Artikel, die Sie brauchen, um sich für einen Pro-account ($7 pro Monat, in diesem schreiben).

Nachdem Sie Ihr Konto erstellen, machen wir eine neue repo. Melden Sie sich in Ihrem Konto und gehen Sie zu https://github.com/new.

Das erste, was wir tun müssen, ist den Namen der repository. Sie können den gleichen Namen verwenden, den Sie für den Ordner auf Ihrem PC. Unter “Repository-Name,” type “MyNovel.”

Die “Beschreibung” ist optional, aber ich mag, es zu benutzen. Können Sie geben so etwas wie, “Meine fabelhaften neuen Roman über einen Jungen, ein Mädchen und Ihr Hund” etc.

Als Nächstes wählen Sie die “Private” radio-button, aber nicht markieren Sie das Kästchen “Initialisiert das repository mit einer README-Datei.” Wir wollen nicht zu tun, denn wir haben bereits ein repository auf unserem PC. Wenn wir es schaffen, eine README-Datei gerade jetzt, es macht die Dinge schwieriger.

Weiter, klicken Sie auf “Create Repository”. Unter “Schnell-setup—wenn Sie das getan haben diese Art der Sache vor,” die URL kopieren. Es sollte in etwa so Aussehen:

https://github.com/[Ihr GitHub-Benutzer-Name]/MyNovel.git

Nun, es ‘ s zurück auf den desktop und unserem geliebten Befehlszeile.

Schieben Sie Ihren Desktop-Repository in der Cloud

Mit Git auf der Kommandozeile.

Das erste mal, wenn Sie ein repo auf GitHub, Sie müssen verwenden Sie ein paar spezielle Befehle. Die erste ist:

git remote add origin https://github.com/[Ihr GitHub-Benutzer-Name]/MyNovel.git

Dies sagt Git-remote-repository ist die Herkunft von “MyNovel.” Die URL verweist dann Git Richtung, dass die remote-Herkunft. Nicht bekommen auch aufgehängt auf den Begriff “Ursprung”; Sie ist nur eine Konvention. Sie können es nennen, “fluffy”, wenn Sie wollen—origin ist nur einfacher, da es die häufigste Art der Verwendung von Git.

Beim hochladen von neuen änderungen mit Git, nennt man das einen “push”. Wenn Sie den download verpasst, nennt man das einen “pull” oder “zu Holen.” Nun, es ist Zeit, zu schieben Sie Ihre ersten commit auf GitHub. Hier ist was Sie tun:

git push -u origin master

Sie werden aufgefordert, geben Sie Ihren GitHub-Benutzernamen und Passwort. Wenn Sie geben Sie Ihre Anmeldeinformationen korrekt, alles hochgeladen, und du bist gut zu gehen.

Wenn Sie wollen mehr Sicherheit für Ihre GitHub-uploads, können Sie einen SSH-Schlüssel. Diese können Sie verwenden ein einziges Kennwort für die SSH-Schlüssel hochladen, so dass Sie nicht haben, um geben Sie Ihren vollständigen GitHub Anmeldeinformationen jedes mal. Plus, nur jemand mit dem SSH-Schlüssel hochladen von Datei änderungen.

Wenn Sie wollen mehr Informationen über SSH-Schlüssel, GitHub hat eine vollständige Anleitung, wie man Sie benutzt. Sie können auch speichern Sie Ihre Git Anmeldeinformationen auf Ihrem PC.

Das ist es! Nun, wenn Sie wollen, um änderungen an Ihren Dateien, die Sie tun können, so mit diesen drei kurzen Befehlen (nachdem Sie navigieren Sie zu dem “MyNovel” Ordner):

git add .

Übersetzung: “Hey, Git Bühne verpflichten sich, alle nicht verfolgte Dateien, sowie neue änderungen an Dateien, die Sie bereits verfolgen.”

git commit -m ” – 1.000 Wörter auf das neue iPhone abgeben.”

Übersetzung: “Hey Git, speichern Sie diese änderungen neben dieser Nachricht.”

git push origin master

Übersetzung: “Hey Git, laden Sie die änderungen an der origin version von diesem Projekt auf GitHub von meinem master-Kopie auf dem PC.”

Git und GitHub-Bonus-Tipps

Das ist ziemlich viel es, aber hier sind ein paar zusätzliche Tipps, um Ihre Erfahrung mit Git und GitHub noch besser:

Ansicht Die Vergangenheit Verpflichtet

Sie können GitHub zu sehen, Vergangenheit verpflichtet.

Anzeigen Vergangenheit verpflichtet, gehen Sie zu Ihrem MyNovel-repository auf GitHub. In Richtung der Spitze der Hauptseite, unter dem Code “< > ” – Registerkarte, sehen Sie einen Abschnitt, der sagt, “[X] verpflichtet.”

Klicken Sie darauf und Sie sehen eine Liste aller commits. Klicken Sie auf ” bestätigen Sie möchten, und sehen Sie Ihren text (bei Eingabe im Klartext und nicht Word, das ist). Alles in grün hervorgehoben wurde der neue text, wenn die commit erstellt wurde; alles in rot wurde gelöscht.

Verwenden Sie das Pull-Befehl

Es ist leicht zu greifen, ein neues repository auf einem anderen Rechner. Navigieren Sie einfach zu, wo Sie wollen speichern Sie die repo auf der neuen Maschine, wie z.B. cd ~/Dokumente. Geben Sie dann:

git pull https://github.com/[Ihr GitHub-Benutzer-Name]/MyNovel.git

Geben Sie Ihre Anmeldeinformationen, wenn Sie dazu aufgefordert werden, und in ein paar Sekunden werden Sie bereit zu gehen. Jetzt übernehmen neue änderungen, und schicken Sie dann zurück zu GitHub mit git push origin master. Wenn du wieder an den PC, wo Sie in der Regel arbeiten, öffnen Sie einfach die Befehlszeile, navigieren Sie zu Ihrem Projekt-Ordner, und geben Sie im git-pull. Die neuen änderungen heruntergeladen, und genau wie Ihr schreiben Projekt ist up-to-date über Ihre Geräte.

Nicht Cross-Streams

Die meisten der Zeit mit dem schreiben ist nicht eine Teamleistung und erfordert nur eine person. Weil das so ist, dieser Artikel Git benutzt, in einer Weise, dass würde nicht funktionieren, für ein multi-person-Projekt. Insbesondere haben wir gemacht Bearbeitungen direkt an der master-version des neuartigen anstelle der Schaffung von sogenannten “Branchen.” Ein Zweig ist eine Praxis-version des Romans, wo Sie änderungen vornehmen können, ohne die original-master. Es ist wie haben von zwei verschiedenen Exemplaren Ihres Romans vorhandenen parallel weder Auswirkungen auf die anderen. Wenn Sie mit den änderungen in der Praxis-Filiale können Sie verschmelzen Sie in der master-version (oder master-branch). Wenn Sie nicht wollen, das zu tun, das ist auch in Ordnung. Einfach wegwerfen, die Praxis-Zweig.

Die Zweige sind sehr mächtig, und mit Ihnen wäre der primäre workflow mit mehreren Autoren an einem Projekt. Solo Autoren nicht wirklich brauchen, um zu verwenden, Zweige, meiner Meinung nach, solange Sie keine abweichende änderungen des master-branch in der gleichen Zeit auf mehreren PCs.

Zum Beispiel, sollten Sie Ihre Arbeit auf Ihrem desktop, tun Ihr begeht, und drücken Sie dann die änderungen auf GitHub. Dann gehen Sie zu Ihrem laptop und ziehen Sie alle neuen änderungen ab, bevor Sie weitere Bearbeitungen. Wenn Sie nicht, Sie könnten am Ende mit dem, was Git ruft “Konflikte.” Das ist, wenn Git sagt, “Hey, es gibt änderungen in GitHub und auf diesem PC, die nicht übereinstimmen. Mir helfen dies herauszufinden.”

Sortieren Sie Ihren Weg aus einem Konflikt kann ein Schmerz, so ist es am besten, es zu vermeiden, Wann immer möglich.

Sobald Sie die ersten Schritte mit Git, es gibt Tonnen von Dingen, die Sie lernen können, wie Verzweigungen, der Unterschied zwischen fetch und ein ziehen, was GitHub ist pull-Anforderungen sind, und wie Sie sich mit den gefürchteten Konflikt.

Git kann scheinen kompliziert für Neulinge, aber sobald man den Dreh raus, es ist ein leistungsfähiges Werkzeug, das Sie verwenden können, zu verwalten und speichern Sie Ihre schreiben.

LESEN SIE WEITER

  • › So Einfach Recyceln Sie die Alte Elektronik Kann Man nicht Verkaufen
  • › Wie Sie Überprüfen, wenn Sie Ihre Chromecast Ist Noch Immer Updates
  • › How to Play Adobe Flash SWF-Dateien Außerhalb des Web-Browser
  • › Befehlszeilen: Warum Die Menschen Immer Noch Mühe Mit Ihnen?
  • › Was ist zu Tun, Wenn Ihr Mac nicht Herunterfahren