Skriv, og la verden revidere arbeidet ditt med prosa.io for GitHub

Annonse

Tradisjonelt er skriving en enslig affære. Det er bare deg og skjermen, eller et stykke papir. Mann versus tekst i en kamp om vilje, vits og følelser, helt til du plutselig er ferdig. Nå er det på tide å vise verden, legge teksten der ute og se hva som skjer. Men i disse digitale tider er det ikke den eneste måten å skrive på.

Hva om det var alle ute i det fri, hele tiden? Hva om verden kunne se revisjonene dine og følge med og komme med forslag? På grunn av det kan dette virke som en fryktelig idé - men for noen slags tekster (og for visse forfattere) kan et slikt åpent samarbeid være en velsignelse. prosa er en enkel publiseringsplattform på nettet som grensesnitt mot GitHub for å la deg redigere tekst online og holde revisjoner ved bruk Git Hva er git og hvorfor du bør bruke versjonskontroll hvis du er en utviklerSom webutviklere, mye av tiden vi pleier å jobbe med lokale utviklingsnettsteder, er det bare å laste opp alt når vi er ferdige. Dette er bra når det bare er deg og endringene er små, ... Les mer .

Starter

For å jobbe med Prose, må du først ha en GitHub-konto. Forutsatt at du er logget på Git, klikker du bare på Prose's Authorize-knappen:

Git vil deretter spørre om du er sikker på at du vil autorisere Prose. Prosa krever ganske mange tillatelser, men de er alle fornuftige:

Deretter finner du deg tilbake i Prose, og ser på en liste over alle Git-lagringene dine:

Hvis du er som meg, er det ingen av de eksisterende lagringene dine som passer for en haug med tekst. Selvfølgelig kan dette ikke stemme for deg: Hvis du for eksempel bruker Jekyll publiseringsramme, har du kanskje allerede et depot som bare venter på tekst. Faktisk ser det ut til at mye av Prose er bygget med Jekyll-brukere i tankene: Prose lar deg til og med publisere til Jekyll. Når det er sagt, det gjør du ikke trenge Jekyll for å benytte meg av Prose, og jeg har sett på den uten å koble den til noe annet.

Så for å begynne, la oss lage et nytt hjem for teksten vår.

Opprette et nytt GitHub-arkiv

For å opprette et nytt GitHub-lager, må du gå tilbake til GitHub selv - dette er ikke noe du kan gjøre på Prose. Prose foreslår å navngi de nye dokumentets "dokumenter", så det var det jeg gjorde.

Umiddelbart etter opprettelsen av depotet, dukket det opp innen Prose:

Redigere et dokument

Når jeg klikker på det ferske dokumentoppbevaringsstedet mitt, blir jeg møtt av GitHubs standard README.md. MD, i dette tilfellet, står for Markdown - det samme enkle formatet som brukes av Dillinger.io Dillinger: Rediger og vis markdown i sanntid Les mer , TextDown TextDown: Få en Markdown Editor bygget inn i Google Chrome Les mer , WriteMonkey WritMonkey - En enkel tekstredigeringsprogram for lett distraherte Les mer , og utallige andre redaktører. Hvis du har komponert tekst til nettbruk over lengre tid, er sjansen stor for at du har kommet over Markdown mer enn en gang.

Ved å klikke på dokumentet kom det opp et enkelt redigeringsgrensesnitt:

Den er salig fri for annonser, og har et dempet fargevalg som er lett for øynene. Den har også syntaksutheving for Markdown, og i stedet for en øyeblikkelig forhåndsvisningsrute (som den som brukes i Dillinger.io), krever du et raskt verktøylinjeklikk for å forhåndsvise teksten din som er gjengitt i HTML:

Du kan komme til forhåndsvisningsskjermen ved å bruke Ctrl + Shift + høyre pil. Ctrl + Shift + venstre pil tar deg til et Markdown-jukseark, i tilfelle du vil oppdatere minnet.

Redaktøren er smakfull, men tilbyr ikke en levende ordtelling-funksjon, noe jeg forventer av noe verktøy rettet mot forfattere. Den deaktiverer også Chrome innebygde stavekontroll, noe som gjør teksten din mye mer utsatt for skrivefeil.

Publisering (eller lagring)

Med mindre du bruker Jekyll, er publisering og lagring stort sett det samme: Så snart du lagrer, er teksten forpliktet til et GitHub-arkiv. Med mindre du er en betalende GitHub-bruker og har valgt et privat depot, betyr dette at alle nå kan se teksten din. Den første forpliktelsen så ut slik:

Og etter noen kjappe skrifter, så GitHubs forpliktelseshistorikk for depotet slik ut:

Veldig gjennomsiktig, men også sikkert: Revisjoner gjør det nesten umulig å miste arbeidet. Du kan lagre og deretter fjerne en stor del av dokumentet, men du vil alltid kunne få det tilbake. Det er som en ubegrenset Undo-funksjon som fortsetter å fungere selv om du slår av datamaskinen eller flytter til en annen.

Dette er langt fra alt Prose kan gjøre: Du kan for eksempel bruke Prose til å redigere en annen persons dokument og sende inn en forespørsel om at de skal godta revisjonene dine - akkurat som kodere gjør. Det er mange andre ting du kan gjøre med Prose, men kjerneprinsippet er det samme: Git for skriving.

Siste tanker

For meg føles Prose mer som en invitasjon enn et verktøy. En invitasjon til å tenke, komponere, utkast, i det fri. Å overvinne "publikasjonsangst" ved å stadig publisere mens du skriver, slik at det ikke er noen "Sannhetens øyeblikk" - tankene dine har vært der ute i verden hele tiden, skrivefeil, uoverensstemmelser, og alt. Det er andre måter å gjøre dette på, fra wikier til standard Git-klienter, men Prose later ikke som en eksklusiv idé - den pakker bare ting pent slik at konseptet skiller seg ut. Hvorvidt det er den riktige måten for deg å skrive er et personlig valg - et valg jeg vil være nysgjerrig på å høre om, hvis du vil fortelle meg i kommentarfeltet.