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

Annonse

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

Hva om det var helt ute i det hele tatt? Hva om verden kunne se dine revisjoner og følge med, lage forslag? På forsiden av dette kan det virke som en forferdelig ide - men for enkelte typer tekster (og for enkelte forfattere), kan et slikt åpent samarbeid være en velsignelse. Prose er en enkel nettbasert publiseringsplattform som grensesnitt til GitHub, slik at du kan redigere tekst på nettet og holde revisjoner ved hjelp av Git. Hva er Git og hvorfor du bør bruke Versjonskontroll Hvis du er utvikler Hva er Git og hvorfor du bør bruke Versjonskontroll hvis du er en utvikler Som webutviklere har mye av tiden vi pleier å jobbe med på lokale utviklingssteder, så laster vi opp alt når vi er ferdige. Dette er greit 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 inn i Git, klikker du bare på Prose's Authorize-knappen:

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

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

Hvis du er som meg, er ingen av dine eksisterende repositorier en god form for en gjeng med tekst. Selvfølgelig kan dette ikke være sant for deg: Hvis du for eksempel bruker Jekyll Publishing Framework, kan du allerede ha et lager som bare venter på tekst. Faktisk synes mye av Prose å bli bygget med Jekyll-brukere i tankene: Prose lar deg også publisere til Jekyll. Når det er sagt, trenger du ikke Jekyll å bruke Prose, og jeg har sett på den uten å koble den til noe annet.

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

Opprette et nytt GitHub Repository

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

Umiddelbart etter å ha opprettet depotet, viste det seg innenfor Prose:

Redigerer et dokument

Ved å klikke inn i mitt nye Dokumenter-depot, 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, TextDown, WriteMonkey og utallige andre redaktører. Hvis du har komponert tekst for online bruk i lengre tid, er det sjansene for at du har kommet over Markdown mer enn én gang.

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

Det er blissfully fri for annonser, og har en dempet fargevalg som er lett på øynene. Den har også syntaxutheving for Markdown, og i stedet for en forhåndsvisningsrude (som den som brukes i Dillinger.io), forutsetter teksten din gjengitt i HTML, en hurtig verktøylinjeklikk:

Du kan komme til forhåndsvisningsskjermen ved å bruke Ctrl + Shift + høyre pil. Ctrl + Shift + venstre pil tar deg til et Markdown cheat sheet, hvis du vil oppdatere minnet ditt.

Redaktøren er smakfull, men tilbyr ikke en levende ord-count-funksjon, noe jeg forventer fra ethvert verktøy rettet mot forfattere. Det deaktiverer også Chrome's innebygde stavekontroll, noe som gjør teksten din så mye mer tilbøyelig til skrivefeil.

Publisering (eller lagring)

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

Og etter noen få raskere scribblings så GitHubs fortolkningshistorie for depotet slik ut:

Meget gjennomsiktig, men også sikker: Revisjoner gjør det nesten umulig å miste arbeidet ditt. Du kan lagre, og deretter fjerne en stor del av dokumentet ditt, men du vil alltid kunne få det tilbake. Det er som en ubegrenset Angre 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: For eksempel kan du bruke Prose til å redigere en persons persons dokument og sende inn en trekkforespørsel for at de skal godta dine revisjoner - akkurat som kodere gjør. Det er mange andre ting du kan gjøre med Prose, men kjerneprinsippet er det samme: Git for writing.

Siste tanker

For meg føles Prose mer som en invitasjon enn et verktøy. En invitasjon til å tenke, komponere, utkast, ut i det åpne. For å overvinne "publikasjonsfrykt" ved å publisere hele tiden mens du skriver, slik at det ikke finnes noen eneste "øyeblikk av sannhet" - har dine tanker vært der ute i verden hele tiden, typografier, inkonsekvenser og alt. Det finnes andre måter å gjøre dette, fra wikis til standard Git-klienter, men Prose ligner ikke på å være en eksklusiv idé - det pakker bare ting pent slik at konseptet skiller seg ut. Hvorvidt det er riktig måte å skrive på, er et personlig valg - et valg jeg ville være nysgjerrig på å høre om, hvis du vil fortelle meg i kommentarene.