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

Werbung

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

Was wäre, wenn es so wäre? alle die ganze Zeit im Freien? Was wäre, wenn die Welt Ihre Revisionen sehen und mitmachen und 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. Prosa ist eine einfache Online-Publishing-Plattform, die mit GitHub verbunden ist, damit Sie Text online bearbeiten und Revisionen verwenden können Git Was ist Git und warum sollten Sie die Versionskontrolle verwenden, wenn Sie Entwickler sind?Als Webentwickler arbeiten wir häufig an lokalen Entwicklungswebsites und laden dann einfach alles hoch, wenn wir fertig sind. Dies ist in Ordnung, wenn es nur Sie sind und die Änderungen gering sind, ...

Weiterlesen .

Anfangen

Um mit Prose arbeiten zu können, müssen Sie zuerst einen GitHub-Account haben. Angenommen, Sie sind bei Git angemeldet, klicken Sie einfach auf die Schaltfläche "Autorisieren" der Prosa:

Git fragt Sie dann, ob Sie Prosa wirklich 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-Repositorys an:

Wenn Sie wie ich sind, passt keines Ihrer vorhandenen Repositorys gut zu einer Reihe von Texten. Dies kann natürlich nicht für Sie zutreffen: Zum Beispiel, wenn Sie das verwenden Jekyll Beim Veröffentlichen des Frameworks wartet möglicherweise bereits ein Repository auf Text. Tatsächlich scheint ein Großteil von Prose für Jekyll-Benutzer gedacht zu sein: Mit Prose können Sie sogar in Jekyll veröffentlichen. Das heißt, du nicht brauchen Jekyll, um Prosa zu benutzen, und ich habe es mir angesehen, ohne es mit irgendetwas anderem zu verbinden.

Lassen Sie uns zunächst 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 können Sie in Prose nicht tun. Prose schlägt vor, Ihr neues Repository "Dokumente" zu nennen. Das habe ich also getan.

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

Bearbeiten eines Dokuments

Wenn ich in mein neues Dokumenten-Repository klicke, werde ich von GitHubs Standard-README.md begrüßt. MD steht in diesem Fall für Markdown - das gleiche einfache Format, das von verwendet wird Dillinger.io Dillinger: Markdown in Echtzeit bearbeiten und anzeigen Weiterlesen , TextDown TextDown: Holen Sie sich einen in Google Chrome integrierten Markdown-Editor Weiterlesen , WriteMonkey WriteMonkey - Ein einfacher Texteditor für leicht abgelenkte Personen Weiterlesen und unzählige andere Redakteure. Wenn Sie längere Zeit Text für die Online-Verwendung verfasst haben, sind Sie wahrscheinlich mehrmals auf Markdown gestoßen.

Durch Klicken auf das Dokument wurde eine einfache Bearbeitungsoberfläche angezeigt:

Es ist wunderbar frei von Werbung und verfügt über ein gedämpftes Farbschema, das die Augen schont. Es verfügt auch über eine Syntaxhervorhebung für Markdown. Anstelle eines Sofortvorschaubereichs (wie in Dillinger.io verwendet) erfordert die Vorschau Ihres in HTML gerenderten Textes einen schnellen Klick in der Symbolleiste:

Sie können mit Strg + Umschalt + Rechtspfeil zum Vorschaubildschirm gelangen. Strg + Umschalt + Pfeil nach links führt Sie zu einem Markdown-Spickzettel, falls Sie Ihr Gedächtnis auffrischen möchten.

Der Editor ist geschmackvoll, bietet jedoch keine Live-Funktion zum Zählen von Wörtern, was ich von jedem Tool erwarten würde, das sich an Autoren richtet. Außerdem wird die integrierte Rechtschreibprüfung von Chrome deaktiviert, wodurch Ihr Text anfälliger für Tippfehler wird.

Veröffentlichen (oder Speichern)

Wenn Sie Jekyll nicht verwenden, ist das Veröffentlichen und Speichern so ziemlich dasselbe: Sobald Sie speichern, wird Ihr Text in ein GitHub-Repository übertragen. Sofern Sie kein zahlender GitHub-Benutzer sind und sich für ein privates Repository entschieden haben, kann jetzt jeder Ihren Text sehen. Das erste Commit sah folgendermaßen aus:

Und nach ein paar weiteren kurzen Skizzen sah der Commit-Verlauf von GitHub für das Repository folgendermaßen aus:

Sehr transparent, aber auch sicher: Überarbeitungen machen es nahezu unmöglich, Ihre Arbeit zu verlieren. Sie können einen großen Teil Ihres Dokuments speichern und dann entfernen, aber Sie können es immer wieder zurückerhalten. 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önnen beispielsweise Prose verwenden, um das Dokument einer anderen Person zu bearbeiten und eine Pull-Anfrage zu senden, damit diese Ihre Überarbeitungen akzeptiert - genau wie es Codierer tun. Es gibt viele andere Dinge, die Sie mit Prose tun könnten, 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 Denken, Komponieren, Zeichnen im Freien. Um die „Publikationsangst“ zu überwinden, veröffentlichen Sie ständig, während Sie schreiben, damit es keine einzige gibt "Moment der Wahrheit" - Ihre Gedanken waren die ganze Zeit auf der Welt, Tippfehler, Inkonsistenzen, und alles. 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 - es verpackt die Dinge nur ordentlich, damit das Konzept auffällt. Ob es für Sie die richtige Art zu schreiben ist oder nicht, ist eine persönliche Entscheidung - eine Entscheidung, über die ich gespannt sein würde, wenn Sie es mir in den Kommentaren mitteilen würden.