Schrijf en laat de wereld je werk herzien met Prose.io voor GitHub

Advertentie

Traditioneel is schrijven een eenzame zaak. Het is alleen jij en het scherm, of een stuk papier. Mens versus tekst in een strijd van wil, verstand en emotie, tot plotseling - je bent klaar. Nu is het tijd om de wereld te laten zien, om je tekst daar te plaatsen en te kijken wat er gebeurt. Maar in deze digitale tijden is dat niet de enige manier om te schrijven.

Wat als het allemaal al de hele tijd in de openbaarheid was? Wat als de wereld je revisies zou kunnen zien en meevolgen, met suggesties? Op het eerste gezicht lijkt dit misschien een vreselijk idee - maar voor sommige soorten teksten (en voor bepaalde schrijvers) kan zo'n open samenwerking een zegen zijn. Prose is een eenvoudig online publicatieplatform dat interfaces biedt met GitHub om je tekst online te laten bewerken en revisies te houden met behulp van Git What Is Git & Why You Should Version Control gebruiken als je een ontwikkelaar bent Wat is Git en waarom zou je versiebeheer moeten gebruiken als je zijn een ontwikkelaar Als webontwikkelaars werken we vaak vaak op lokale ontwikkelsites en uploaden we vervolgens alles wanneer we klaar zijn. Dit is prima als je alleen bent en de veranderingen klein zijn, ... Lees meer.

Ermee beginnen

Om met Prose te werken, moet je eerst een GitHub-account hebben. Ervan uitgaande dat u bent aangemeld bij Git, klikt u op de knop Autoriseren van Prose:

Git zal dan vragen of je zeker weet dat je Prose wilt autoriseren. Prose vereist nogal wat toestemmingen, maar ze kloppen allemaal:

Vervolgens kom je terug in Prose, kijkend naar een lijst van al je Git-repositories:

Als je op mij lijkt, zijn geen van je bestaande opslagplaatsen geschikt voor een hoop tekst. Natuurlijk is dit misschien niet waar voor u: als u bijvoorbeeld het Jekyll-publicatiekader gebruikt, hebt u mogelijk al een repository die wacht op tekst. In feite lijkt veel van Prose te zijn gebouwd met Jekyll-gebruikers in gedachten: Prose laat je zelfs publiceren aan Jekyll. Dat gezegd hebbende, je hebt Jekyll niet nodig om Prose te gebruiken, en ik heb ernaar gekeken zonder het met iets anders te verbinden.

Laten we dus, om te beginnen, een nieuw thuis maken voor onze tekst.

Een nieuwe GitHub-gegevensopslagruimte maken

Om een ​​nieuwe GitHub-repository te maken, zou je terug moeten gaan naar GitHub zelf - dit is niet iets dat je kunt doen met Prose. Prose stelt voor de naam van uw nieuwe repository "documenten", dus dat is wat ik deed.

Onmiddellijk na het maken van de repository, kwam het binnen Prose:

Een document bewerken

Als ik in mijn nieuwe Documenten-repository klik, word ik begroet door GitHub's standaard README.md. MD, in dit geval, staat voor Markdown - hetzelfde eenvoudige formaat dat wordt gebruikt door Dillinger.io, TextDown, WriteMonkey en talloze andere editors. Als je al lang tekst aan het maken bent voor online gebruik, is de kans groot dat je Markdown meer dan eens bent tegengekomen.

Door op het document te klikken, kwam er een eenvoudige bewerkingsinterface:

Het is zalig vrij van advertenties, en heeft een gedempt kleurenschema dat gemakkelijk is te onthouden. Het heeft ook syntaxisaccentuering voor Markdown, en in plaats van een instant preview-paneel (zoals dat gebruikt in Dillinger.io), is het previewen van je tekst in HTML vereist een snelle klik op de werkbalk:

U kunt het voorbeeldscherm openen met Ctrl + Shift + pijl naar rechts. Ctrl + Shift + pijl naar links brengt u naar een markdown-spiekbriefje voor het geval u uw geheugen wilt vernieuwen.

De editor is smaakvol, maar biedt geen live functie voor het tellen van woorden, iets wat ik zou verwachten van elke tool die op schrijvers is gericht. Het schakelt ook de ingebouwde spellingcontrole van Chrome uit, waardoor uw tekst veel meer vatbaar is voor typefouten.

Publiceren (of opslaan)

Tenzij je Jekyll gebruikt, is publiceren en opslaan vrijwel hetzelfde: zodra je opslaat, is je tekst toegewijd aan een GitHub-repository. Tenzij u een betalende GitHub-gebruiker bent en hebt gekozen voor een privé-repository, betekent dit dat iedereen uw tekst nu kan zien. De eerste commit zag er als volgt uit:

En na een paar snelle krabbels zag de commit-geschiedenis van GitHub voor de repository er als volgt uit:

Zeer transparant, maar ook veilig: Revisies maken het bijna onmogelijk om uw werk te verliezen. U kunt een groot deel van uw document opslaan en vervolgens verwijderen, maar u kunt het altijd terugkrijgen. Het is als een onbeperkte Ongedaan maken-functie die blijft werken, zelfs als u uw computer uitschakelt of naar een andere verplaatst.

Dit is allesbehalve alles wat Prose kan doen: u kunt bijvoorbeeld Proza gebruiken om het document van een andere persoon te bewerken en een pull-aanvraag voor hen in te dienen om uw revisies te accepteren - net zoals coders dat doen. Er zijn veel andere dingen die je met Prose kunt doen, maar het basisprincipe blijft hetzelfde: Git voor schrijven.

Laatste gedachten

Voor mij voelt Prose meer als een uitnodiging dan als een hulpmiddel. Een uitnodiging om na te denken, te componeren, op te stellen, in de open lucht. Om "publicatievrees" te overwinnen door constant te publiceren terwijl je schrijft, zodat er geen enkel "moment van de waarheid" is - je gedachten zijn overal in de wereld geweest, typefouten, inconsistenties en alles. Er zijn andere manieren om dit te doen, van wiki's tot standaard Git-clients, maar Prose pretendeert geen exclusief idee te zijn - het pakt dingen netjes in, zodat het concept opvalt. Of het de juiste manier is om te schrijven, is een persoonlijke keuze - een keuze waarover ik graag zou horen, als je me dat in de comments zou vertellen.