Schreiben Sie und lassen Sie die Welt Ihre Arbeit mit Prose.io für GitHub überarbeiten

Das Schreiben ist traditionell eine einsame Angelegenheit. Es ist nur Sie und der Bildschirm oder ein Stück Papier. Mann gegen Text in einem Kampf von Willen, Verstand und Emotionen, bis plötzlich - Sie sind fertig. Jetzt ist es Zeit, der Welt zu zeigen, Ihren Text zu veröffentlichen und zu beobachten, was passiert. Aber in diesen digitalen Zeiten ist das nicht der einzige Weg, um zu schreiben.

Was wäre wenn? alles die ganze Zeit im Freien? Was wäre, wenn die Welt Ihre Überarbeitungen sehen und mit Vorschläge machen könnte? Auf den ersten Blick mag dies wie eine schreckliche Idee erscheinen - aber für einige Arten von Texten (und für bestimmte Autoren) kann eine solche offene Zusammenarbeit ein Segen sein. Prose ist eine einfache Online-Publishing-Plattform, die mit GitHub eine Schnittstelle bietet, mit der Sie Text online bearbeiten und Änderungen mit Git beibehalten können. Was ist Git? Warum sollten Sie die Versionskontrolle verwenden? Als Entwickler Als Webentwickler arbeiten wir meistens auf lokalen Entwicklungsseiten und laden dann einfach alles hoch, wenn wir fertig sind. Dies ist in Ordnung, wenn es nur Sie sind und die Änderungen klein sind .

Fertig machen

Um mit Prose arbeiten zu können, müssen Sie zunächst ein GitHub-Konto haben. Vorausgesetzt, Sie sind bei Git angemeldet, klicken Sie einfach auf die Schaltfläche Autorisieren der Prosa:

Git fragt dann, ob Sie sicher sind, dass Sie Prose autorisieren möchten. Prosa erfordert einige Berechtigungen, aber alle machen Sinn:

Als Nächstes befinden Sie sich wieder in Prose und sehen sich eine Liste aller Ihrer Git-Repositories an:

Wenn Sie wie ich sind, ist keines Ihrer vorhandenen Repositories für einen Haufen Text geeignet. Natürlich trifft dies möglicherweise nicht für Sie zu: Wenn Sie beispielsweise das Jekyll Publishing Framework verwenden, verfügen Sie möglicherweise bereits über ein Repository, das nur auf Text wartet. Tatsächlich scheint ein großer Teil von Prose auf Jekyll-Benutzer ausgerichtet zu sein: Mit Prose können Sie sogar in Jekyll veröffentlichen. Das sagst du nicht brauchen Jekyll, um Prosa zu gebrauchen, und ich habe es mir angesehen, ohne es mit irgendetwas anderem zu verbinden.

Lassen Sie uns zu Beginn ein neues Zuhause für unseren Text schaffen.

Erstellen eines neuen GitHub-Repositorys

Um ein neues GitHub-Repository zu erstellen, müssen Sie zu GitHub selbst zurückkehren. Dies ist bei Prose nicht möglich. Prosa schlägt vor, Ihr neues Repository zu benennen “Unterlagen,” also habe ich das gemacht.

Unmittelbar nach dem Erstellen des Repositorys wurde es in Prose angezeigt:

Ein Dokument bearbeiten

Ich klicke in mein neues Documents-Repository und werde von GitHub's Standard-README.md begrüßt. MD steht in diesem Fall für Markdown - dasselbe einfache Format, das von Dillinger.io, TextDown, WriteMonkey und unzähligen anderen Editoren verwendet wird. Wenn Sie für längere Zeit Text für die Online-Verwendung verfasst haben, sind Sie wahrscheinlich mehr als einmal auf Markdown gestoßen.

Klicken Sie auf das Dokument, um eine einfache Bearbeitungsoberfläche aufzurufen:

Es ist völlig frei von jeglicher Werbung und hat ein gedämpftes Farbschema, das für die Augen angenehm ist. Außerdem enthält Markdown Syntax-Hervorhebungen. Statt eines Schnellansichtsfensters (wie in Dillinger.io verwendet) erfordert die Vorschau des in HTML gerenderten Textes einen schnellen Klick auf die Symbolleiste:

Sie können den Vorschaubildschirm mit Strg + Umschalttaste + Rechtspfeil aufrufen. Mit Strg + Umschalt + Pfeil nach links gelangen Sie zu einem Markdown-Spickzettel, falls Sie Ihr Gedächtnis auffrischen möchten.

Der Editor ist geschmackvoll, bietet jedoch keine Funktion zur Wortzählung im Livebetrieb, was ich von jedem Tool für Autoren erwarten würde. Es deaktiviert auch die integrierte Rechtschreibprüfung von Chrome, wodurch Ihr Text für Tippfehler viel anfälliger wird.

Veröffentlichen (oder Speichern)

Wenn Sie nicht Jekyll verwenden, ist das Veröffentlichen und Speichern fast das Gleiche: Sobald Sie speichern, wird Ihr Text einem GitHub-Repository zugewiesen. Wenn Sie kein zahlender GitHub-Benutzer sind und sich für ein privates Repository entschieden haben, bedeutet dies, dass nun jeder Ihren Text sehen kann. Das erste Commit sah folgendermaßen aus:

Und nach ein paar schnellen Scribblings sah GitHubs Commit-Historie für das Repository folgendermaßen aus:

Sehr transparent, aber auch sicher: Revisionen machen es fast unmöglich, Ihre Arbeit zu verlieren. Sie können ein großes Stück Ihres Dokuments speichern und dann entfernen, aber Sie können es immer wieder erhalten. Es ist wie eine unbegrenzte Undo-Funktion, die auch dann funktioniert, wenn Sie Ihren Computer ausschalten oder zu einem anderen wechseln.

Dies ist bei weitem nicht alles, was Prose tun kann: Sie können Prose beispielsweise dazu verwenden, das Dokument einer anderen Person zu bearbeiten und eine Pull-Anfrage an sie zu senden, damit Sie Ihre Revisionen akzeptieren können - genau wie Programmierer. Es gibt viele andere Dinge, die Sie mit Prose machen können, aber das Kernprinzip bleibt dasselbe: Git zum Schreiben.

Abschließende Gedanken

Für mich ist Prosa eher eine Einladung als ein Werkzeug. Eine Einladung zum Nachdenken, Komponieren, Entwurf, im Freien. Überwinden “Publikationsangst” durch ständige Veröffentlichung wie Sie schreiben, so dass es keine Single gibt “Moment der Wahrheit” - Deine Gedanken waren schon immer auf der Welt, Tippfehler, Inkonsistenzen und so weiter. Es gibt andere Möglichkeiten, dies zu tun, von Wikis bis hin zu Standard-Git-Clients, aber Prose gibt nicht vor, eine exklusive Idee zu sein. Ob es der richtige Weg für Sie ist zu schreiben, ist eine persönliche Entscheidung - eine Entscheidung, die ich gerne hören würde, wenn Sie mir in den Kommentaren sagen würden.

Erfahren Sie mehr über: Tools für die Zusammenarbeit, Texteditor, Webentwicklung, Webmaster-Tools.