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

Werbung

Traditionell ist Schreiben eine Einzelangelegenheit. Es sind nur Sie und der Bildschirm oder ein Stück Papier. Mann gegen Text in einem Kampf von Willen, Verstand und Gefühl, bis plötzlich - du bist fertig. Jetzt ist es an der Zeit, der Welt zu zeigen, deinen Text dort hinzustellen und zu beobachten, was passiert. Aber in diesen digitalen Zeiten ist das nicht der einzige Weg, um zu schreiben.

Was, wenn es die ganze Zeit draußen war? Was wäre, wenn die Welt deine Revisionen sehen und mitmachen könnte, Vorschläge machen? Auf den ersten Blick scheint dies eine schreckliche Idee zu sein - 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 interagiert, damit Sie Text online bearbeiten und Überarbeitungen mit Git beibehalten können. Was ist Git? Warum sollten Sie Version Control verwenden? Wenn Sie ein Entwickler sind Was ist Git & Warum sollten Sie Version Control Wenn Sie Ein Entwickler Als Webentwickler arbeiten wir oft auf lokalen Entwicklungsseiten und laden dann einfach alles hoch, wenn wir fertig sind. Das ist in Ordnung, wenn es nur Sie und die Änderungen sind klein, ... Lesen Sie mehr.

Anfangen

Um mit Prose arbeiten zu können, müssen Sie zuerst ein GitHub-Konto haben. Angenommen, Sie sind bei Git angemeldet, klicken Sie einfach auf den Autorisierungsknopf von Prose:

Git wird dann fragen, ob Sie sicher sind, dass Sie Prosa autorisieren wollen. Prosa erfordert ziemlich viele Berechtigungen, aber alle ergeben Sinn:

Als nächstes werden Sie sich wieder in Prosa wiederfinden und eine Liste aller Ihrer Git-Repositories ansehen:

Wenn Sie wie ich sind, passt keines Ihrer vorhandenen Repositories für eine Menge Text. Natürlich trifft das möglicherweise nicht auf Sie zu: Wenn Sie beispielsweise das Jekyll-Veröffentlichungsframework verwenden, haben Sie möglicherweise bereits ein Repository, das nur auf Text wartet. In der Tat scheint ein Großteil der Prosa mit Jekyll-Nutzern im Hinterkopf zu sein: Prosa lässt dich sogar in Jekyll veröffentlichen. Das heißt, Sie brauchen Jekyll nicht, um Prosa zu benutzen, und ich habe es angeschaut, ohne es mit irgendetwas anderem zu verbinden.

Also, lasst uns ein neues Zuhause für unseren Text schaffen.

Erstellen eines neuen GitHub-Repositorys

Um ein neues GitHub-Repository zu erstellen, müssen Sie zurück zu GitHub selbst gehen - das können Sie bei Prose nicht tun. Prose schlägt vor, dein neues Repository "Dokumente" zu nennen, also habe ich das gemacht.

Unmittelbar nach dem Erstellen des Repositories, erschien es in Prosa:

Bearbeiten eines Dokuments

Wenn ich auf mein neues Documents-Repository klicke, werde ich von GitHubs Standard-Readme.md begrüßt. MD steht in diesem Fall für Markdown - das gleiche einfache Format, das Dillinger.io, TextDown, WriteMonkey und unzählige andere Editoren verwenden. Wenn Sie Text für längere Zeit online verfassen, ist es möglich, dass Sie Markdown mehr als einmal gesehen haben.

Beim Klicken auf das Dokument erschien eine einfache Bearbeitungsoberfläche:

Es ist gnadenlos frei von Werbung und hat ein gedämpftes Farbschema, das die Augen schont. Es hat auch Syntax-Highlighting für Markdown, und anstelle einer sofortigen Vorschau-Bereich (wie der in Dillinger.io verwendet), Vorschau in Ihrem Text in HTML gerendert erfordert einen schnellen Klick auf die Symbolleiste:

Sie gelangen zum Vorschaufenster mit Strg + Umschalt + Pfeil nach rechts. Ctrl + Shift + Pfeil nach links bringt Sie zu einem Markdown-Spickzettel, falls Sie Ihren Speicher auffrischen möchten.

Der Editor ist geschmackvoll, bietet aber kein Live-Wortzähl-Feature, etwas, das ich von jedem Tool für Autoren erwarten würde. Außerdem wird die integrierte Rechtschreibprüfung von Chrome deaktiviert, so dass Ihr Text anfälliger für Tippfehler ist.

Veröffentlichen (oder Speichern)

Wenn Sie Jekyll nicht verwenden, ist das Veröffentlichen und Speichern ungefähr das Gleiche: Sobald Sie speichern, wird Ihr Text an ein GitHub-Repository übergeben. Wenn Sie kein bezahlter 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 so aus:

Und nach ein paar weiteren schnellen Scribblings sah GitHubs Commit-Verlauf für das Repository so aus:

Sehr transparent, aber auch sicher: Überarbeitungen machen es fast unmöglich, Ihre Arbeit zu verlieren. Sie können einen großen Teil Ihres Dokuments speichern und anschließend entfernen, aber Sie können es immer wieder abrufen. Es ist wie eine unbegrenzte Rückgängig-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önnten zum Beispiel Prosa verwenden, um das Dokument einer anderen Person zu bearbeiten und eine Pull-Anforderung zu senden, damit sie Ihre Revisionen akzeptieren - genau wie Codierer. Es gibt viele andere Dinge, die man mit Prosa machen kann, aber sein Kernprinzip bleibt gleich: 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. Um "Publikationsangst" zu überwinden, indem Sie während des Schreibens ständig publizieren, so dass es keinen einzigen "Moment der Wahrheit" gibt - Ihre Gedanken waren die ganze Zeit über in der Welt, Tippfehler, Inkonsistenzen und alles andere. Es gibt andere Wege, dies zu tun, von Wikis zu Standard-Git-Clients, aber Prose gibt nicht vor, eine exklusive Idee zu sein - es packt einfach Dinge ordentlich, so dass das Konzept herausragt. Ob es der richtige Weg für dich ist, zu schreiben, ist eine persönliche Entscheidung - eine Entscheidung, über die ich neugierig sein würde, wenn du es mir in den Kommentaren erzählst.