Einführung
Die Versionskontrolle gilt nicht nur für Code. Es ist für alles, was Sie verfolgen möchten, einschließlich Inhalt. Wenn SieGit zum Verwalten Ihres nächsten Schreibprojekts verwenden, können Sie mehrere Entwürfe gleichzeitig anzeigen, Unterschiede zwischen diesen Entwürfen erkennen und sogar auf eine frühere Version zurücksetzen. Und wenn Sie dies möchten, können Sie Ihre Arbeit auf GitHub oder anderen zentralen Git-Repositorys mit anderen teilen.
In diesem Tutorial verwenden Sie Git, um ein kleines Markdown-Dokument zu verwalten. Sie speichern eine Erstversion, schreiben sie fest, nehmen Änderungen vor, zeigen den Unterschied zwischen diesen Änderungen an und überprüfen die vorherige Version. Wenn Sie fertig sind, steht Ihnen ein Workflow zur Verfügung, den Sie auf Ihre eigenen Schreibprojekte anwenden können.
Voraussetzungen
-
Git auf Ihrem lokalen Computer installiert. Das TutorialHow to Contribute to Open Source: Getting Started with Git führt Sie durch die Installation von Git und enthält einige Hintergrundinformationen, die Sie möglicherweise nützlich finden.
[[Schritt-1 - Erstellen eines Arbeitsbereichs für Ihr Schreibprojekt]] == Schritt 1 - Erstellen eines Arbeitsbereichs für Ihr Schreibprojekt
Um Ihre Änderungen zu verwalten, erstellen Sie ein lokales Git-Repository. Ein Git-Repository befindet sich in einem vorhandenen Verzeichnis. Erstellen Sie daher zunächst ein neues Verzeichnis für Ihren Artikel:
mkdir articleWechseln Sie in das neue Verzeichnis vonarticle:
cd articleDer Befehlgit init erstellt ein neues leeres Git-Repository im aktuellen Verzeichnis. Führen Sie diesen Befehl jetzt aus:
git initSie sehen die folgende Ausgabe, die bestätigt, dass Ihr Repository erstellt wurde:
OutputInitialized empty Git repository in /Users/sammy/article/.git/Mit der.gitignore-Datei können Sie Git mitteilen, dass einige Dateien ignoriert werden sollen. Sie können dies verwenden, um temporäre Dateien, die Ihr Texteditor erstellt, oder Betriebssystemdateien zu ignorieren. Unter macOS erstellt die Finder-Anwendung beispielsweise.DS_Store Dateien in Verzeichnissen. Erstellen Sie eine.gitignore-Datei, die sie ignoriert:
nano .gitignoreFügen Sie der Datei die folgenden Zeilen hinzu:
# Ignore Finder files
.DS_storeDie erste Zeile ist ein Kommentar, anhand dessen Sie erkennen können, was Sie in Zukunft ignorieren. Die zweite Zeile gibt die zu ignorierende Datei an.
Speichern Sie die Datei und beenden Sie den Editor.
Wenn Sie weitere Dateien entdecken, die Sie ignorieren möchten, öffnen Sie die Datei.gitignoreund fügen Sie für jede Datei oder jedes Verzeichnis, das Sie ignorieren möchten, eine neue Zeile hinzu.
Nachdem Ihr Repository konfiguriert ist, können Sie mit der Arbeit beginnen.
[[Schritt 2 - Speichern Ihres ersten Entwurfs]] == Schritt 2 - Speichern Ihres ersten Entwurfs
Git kennt nur Dateien, von denen Sie es erzählen. Nur weil eine Datei in dem Verzeichnis existiert, in dem sich das Repository befindet, bedeutet das nicht, dass Git die Änderungen nachverfolgen wird. Sie müssen dem Repository eine Datei hinzufügen und die Änderungen dann festschreiben.
Erstellen Sie eine neue Markdown-Datei mit dem Namenarticle.md:
nano article.mdFügen Sie der Datei Text hinzu:
article.md
# How To Use Git to Manage Your Writing Project
### Introduction
Version control isn't just for code. It's for anything you want to track, including content. Using Git to manage your next writing project gives you the ability to view multiple drafts at the same time, see differences between those drafts, and even roll back to a previous version. And if you're comfortable doing so, you can then share your work with others on GitHub or other central git repositories.
In this tutorial you'll use Git to manage a small Markdown document. You'll store an initial version, commit it, make changes, view the difference between those changes, and review the previous version. When you're done, you'll have a workflow you can apply to your own writing projects.Speichern Sie die Änderungen und beenden Sie den Editor.
Der Befehlgit statuszeigt Ihnen den Status Ihres Repositorys. Es zeigt Ihnen, welche Dateien hinzugefügt werden müssen, damit Git sie nachverfolgen kann. Führen Sie diesen Befehl aus:
git statusSie sehen diese Ausgabe:
OutputOn branch master
No commits yet
Untracked files:
(use "git add ..." to include in what will be committed)
.gitignore
article.md
nothing added to commit but untracked files present (use "git add" to track) In der Ausgabe zeigt der AbschnittUntracked files die Dateien, die Git nicht betrachtet. Diese Dateien müssen zum Repository hinzugefügt werden, damit Git sie auf Änderungen überwachen kann. Verwenden Sie dazu den Befehlgit add:
git add .gitignore
git add article.mdFühren Sie nungit status aus, um zu überprüfen, ob diese Dateien hinzugefügt wurden:
OutputOn branch master
No commits yet
Changes to be committed:
(use "git rm --cached ..." to unstage)
new file: .gitignore
new file: article.md Beide Dateien werden jetzt im AbschnittChanges to be committed aufgelistet. Git kennt sie, hat jedoch noch keinen Schnappschuss der Arbeit erstellt. Verwenden Sie dazu den Befehlgit commit.
Wenn Sie ein neues Commit erstellen, müssen Sie eine Commit-Nachricht bereitstellen. In einer guten Festschreibungsmeldung wird angegeben, wie Ihre Änderungen lauten. Wenn Sie mit anderen zusammenarbeiten, ist es umso besser, je detaillierter Ihre Festschreibungsnachrichten sind.
Verwenden Sie den Befehlgit commit, um Ihre Änderungen festzuschreiben:
git commit -m "Add gitignore file and initial version of article"Die Ausgabe des Befehls zeigt, dass die Dateien festgeschrieben wurden:
Output[master (root-commit) 95fed84] Add gitignore file and initial version of article
2 files changed, 9 insertions(+)
create mode 100644 .gitignore
create mode 100644 article.mdVerwenden Sie den Befehlgit status, um den Status des Repositorys anzuzeigen:
git statusDie Ausgabe zeigt, dass keine Änderungen hinzugefügt oder festgeschrieben werden müssen.
OutputOn branch master
nothing to commit, working tree cleanSchauen wir uns nun an, wie Sie mit Änderungen arbeiten.
[[Schritt 3 - Speichern von Revisionen]] == Schritt 3 - Speichern von Revisionen
Sie haben Ihre ursprüngliche Version des Artikels hinzugefügt. Jetzt fügen Sie weiteren Text hinzu, damit Sie sehen können, wie Sie Änderungen mit Git verwalten.
Öffnen Sie den Artikel in Ihrem Editor:
nano article.mdFügen Sie am Ende der Datei weiteren Text hinzu:
## Prerequisites
* Git installed on your local computer. The tutorial [How to Contribute to Open Source: Getting Started with Git](https://www.digitalocean.com/community/tutorials/how-to-contribute-to-open-source-getting-started-with-git) walks you through installing Git and covers some background information you may find useful.Speicher die Datei.
Verwenden Sie den Befehlgit status, um zu sehen, wo sich die Dinge in Ihrem Repository befinden:
git statusDie Ausgabe zeigt, dass es Änderungen gibt:
OutputOn branch master
Changes not staged for commit:
(use "git add ..." to update what will be committed)
(use "git checkout -- ..." to discard changes in working directory)
modified: article.md
no changes added to commit (use "git add" and/or "git commit -a") Wie erwartet hat die Dateiarticle.mdÄnderungen.
Verwenden Siegit diff, um zu sehen, was sie sind:
git diff article.mdDie Ausgabe zeigt die Zeilen, die Sie hinzugefügt haben:
diff --git a/article.md b/article.md
index 77b081c..ef6c301 100644
--- a/article.md
+++ b/article.md
@@ -5,3 +5,7 @@
Version control isn't just for code. It's for anything you want to track, including content. Using Git to manage your next writing project gives you the ability to view multiple drafts at the same time, see differences between those drafts, and even roll back to a previous version. And if you're comfortable doing so, you can then share your work with others on GitHub or other central git repositories.
In this tutorial you'll use Git to manage a small Markdown document. You'll store an initial version, commit it, make changes, view the difference between those changes, and review the previous version. When you're done, you'll have a workflow you can apply to your own writing projects.
+
+## Prerequisites
+
+* Git installed on your local computer. The tutorial [How to Contribute to Open Source: Getting Started with Git](https://www.digitalocean.com/community/tutorials/how-to-contribute-to-open-source-getting-started-with-git) walks you through installing Git and covers some background information you may find useful.In der Ausgabe sind Zeilen, die mit einem Pluszeichen (+) beginnen, von Ihnen hinzugefügte Zeilen. Entfernte Zeilen werden mit einem Minuszeichen (-) angezeigt. Zeilen, die unverändert waren, hätten keines dieser Zeichen vor sich.
Die Verwendung vongit diff undgit status ist eine hilfreiche Methode, um festzustellen, was Sie geändert haben. Sie können das Diff auch in einer Datei speichern, um es später mit dem folgenden Befehl anzuzeigen:
git diff article.md > article_diff.diffWenn Sie die Erweiterung.diffverwenden, kann Ihr Texteditor die richtige Syntaxhervorhebung anwenden.
Das Speichern der Änderungen in Ihrem Repository erfolgt in zwei Schritten. Fügen Sie zuerst die Dateiarticle.md erneut hinzu und schreiben Sie sie dann fest. Git möchte, dass Sie ihm explizit mitteilen, welche Dateien in jedem Commit enthalten sind. Obwohl Sie die Datei zuvor hinzugefügt haben, müssen Sie sie erneut hinzufügen. Beachten Sie, dass die Ausgabe des Befehlsgit status Sie daran erinnert.
Fügen Sie die Datei hinzu und schreiben Sie die Änderungen fest. Geben Sie dabei eine Festschreibungsmeldung ein:
git add article.md
git commit -m "add prerequisites section"Die Ausgabe überprüft, ob das Festschreiben funktioniert hat:
Output[master 1fbfc21] add prerequisites section
1 file changed, 4 insertions(+)Verwenden Siegit status, um Ihren Repository-Status anzuzeigen. Sie werden sehen, dass nichts anderes zu tun ist.
git statusOutputOn branch master
nothing to commit, working tree cleanSetzen Sie diesen Vorgang fort, während Sie Ihren Artikel überarbeiten. Nehmen Sie Änderungen vor, überprüfen Sie sie, fügen Sie die Datei hinzu und bestätigen Sie die Änderungen mit einer detaillierten Meldung. Übernehmen Sie Ihre Änderungen so oft oder so wenig, wie Sie möchten. Sie können ein Commit ausführen, nachdem Sie die einzelnen Entwürfe fertiggestellt haben, oder unmittelbar bevor Sie die Struktur Ihres Artikels grundlegend überarbeiten.
Wenn Sie einen Entwurf eines Dokuments an eine andere Person senden und diese Änderungen daran vornimmt, nehmen Sie deren Kopie und ersetzen Sie Ihre Datei durch ihre. Verwenden Sie danngit diff, um die vorgenommenen Änderungen schnell anzuzeigen. Git wird die Änderungen sehen, unabhängig davon, ob Sie sie direkt eingegeben oder die Datei durch eine Datei ersetzt haben, die Sie aus dem Internet, per E-Mail oder anderswo heruntergeladen haben.
Lassen Sie uns nun die Versionen Ihres Artikels verwalten.
[[Schritt 4 - Änderungen verwalten]] == Schritt 4 - Änderungen verwalten
Manchmal ist es hilfreich, sich eine frühere Version eines Dokuments anzusehen. Wann immer Siegit commit verwendet haben, haben Sie eine hilfreiche Nachricht geliefert, die zusammenfasst, was Sie getan haben.
Der Befehlgit log zeigt Ihnen den Festschreibungsverlauf Ihres Repositorys. Jede Änderung, die Sie festschreiben, enthält einen Eintrag im Protokoll.
git logOutputcommit 1fbfc2173f3cec0741e0a6b21803fbd0be511bc4
Author: Sammy Shark
Date: Thu Sep 19 16:35:41 2019 -0500
add prerequisites section
commit 95fed849b0205c49eda994fff91ec03642d59c79
Author: Sammy Shark
Date: Thu Sep 19 16:32:34 2019 -0500
Add gitignore file and initial version of article Jedes Commit hat eine bestimmte Kennung. Sie verwenden diese Nummer, um auf die Änderungen eines bestimmten Commits zu verweisen. Sie benötigen jedoch nur die ersten Zeichen des Bezeichners. Mit dem Befehlgit log --oneline erhalten Sie eine komprimierte Version des Protokolls mit kürzeren Bezeichnern:
git log --onelineOutput1fbfc21 add prerequisites section
95fed84 Add gitignore file and initial version of articleVerwenden Siegit show und die Festschreibungskennung, um die ursprüngliche Version Ihrer Datei anzuzeigen. Die Bezeichner in Ihrem Repository unterscheiden sich von denen in diesen Beispielen.
git show 95fed84 article.mdDie Ausgabe zeigt das Commit-Detail sowie die Änderungen, die während des Commits aufgetreten sind:
Outputcommit 95fed849b0205c49eda994fff91ec03642d59c79
Author: Sammy Shark
Date: Thu Sep 19 16:32:34 2019 -0500
Add gitignore file and initial version of article
diff --git a/article.md b/article.md
new file mode 100644
index 0000000..77b081c
--- /dev/null
+++ b/article.md
@@ -0,0 +1,7 @@
+# How To Use Git to Manage Your Writing Project
+
+### Introduction
+
+Version control isn't just for code. It's for anything you want to track, including content. Using Git to manage your next writing project gives you the ability to view multiple drafts at the same time, see differences between those drafts, and even roll back to a previous version. And if you're comfortable doing so, you can then share your work with others on GitHub or other central git repositories.
+
+In this tutorial you'll use Git to manage a small Markdown document. You'll store an initial version, commit it, make changes, view the difference between those changes, and review the previous version. When you're done, you'll have a workflow you can apply to your own writing projects. Ändern Sie den Befehl leicht, um die Datei selbst anzuzeigen. Ersetzen Sie anstelle eines Leerzeichens zwischen der Festschreibungskennung und der Datei Folgendes durch:./:
git show 95fed84:./article.mdSie sehen den Inhalt dieser Datei bei dieser Überarbeitung:
Output# How To Use Git to Manage Your Writing Project
### Introduction
Version control isn't just for code. It's for anything you want to track, including content. Using Git to manage your next writing project gives you the ability to view multiple drafts at the same time, see differences between those drafts, and even roll back to a previous version. And if you're comfortable doing so, you can then share your work with others on GitHub or other central git repositories.
In this tutorial you'll use Git to manage a small Markdown document. You'll store an initial version, commit it, make changes, view the difference between those changes, and review the previous version. When you're done, you'll have a workflow you can apply to your own writing projects.Sie können diese Ausgabe in einer Datei speichern, wenn Sie sie für etwas anderes benötigen:
git show 95fed84:./article.md > old_article.mdWenn Sie weitere Änderungen vornehmen, wächst Ihr Protokoll und Sie können alle Änderungen überprüfen, die Sie im Laufe der Zeit an Ihrem Artikel vorgenommen haben.
Fazit
In diesem Tutorial haben Sie ein lokales Git-Repository verwendet, um die Änderungen in Ihrem Schreibprojekt zu verfolgen. Auf diese Weise können Sie einzelne Artikel, alle Posts für Ihr Blog oder sogar Ihren nächsten Roman verwalten. Und wenn Sie Ihr Repository an GitHub senden, können Sie andere Personen einladen, die Sie bei der Bearbeitung Ihrer Arbeit unterstützen.