Scrivi e lascia che il mondo riveda il tuo lavoro con Prose.io per GitHub

Annuncio pubblicitario

Tradizionalmente, la scrittura è un affare solitario. Sei solo tu e lo schermo o un pezzo di carta. L'uomo contro il testo in una battaglia di volontà, ingegno ed emozione, fino all'improvviso - hai finito. Ora è il momento di mostrare al mondo, di mettere il tuo testo là fuori e guardare cosa succede. Ma in questi tempi digitali, non è l'unico modo per scrivere.

E se fosse tutti sempre all'aperto? E se il mondo potesse vedere le tue revisioni e seguirle, dare suggerimenti? A prima vista, può sembrare un'idea orribile - ma per alcuni tipi di testi (e per alcuni scrittori), tale collaborazione aperta può essere un vantaggio. Prosa è una semplice piattaforma di pubblicazione online che si interfaccia con GitHub per consentirti di modificare il testo online e mantenere le revisioni utilizzando Idiota Che cos'è Git e perché dovresti utilizzare il controllo versione se sei uno sviluppatoreCome sviluppatori web, per la maggior parte del tempo tendiamo a lavorare su siti di sviluppo locali per poi caricare tutto quando abbiamo finito. Questo va bene quando sei solo tu e le modifiche sono piccole, ...

Leggi di più .

Iniziare

Per lavorare con Prose, devi prima avere un account GitHub. Supponendo che tu abbia effettuato l'accesso a Git, fai semplicemente clic sul pulsante Autorizza Prose:

Git ti chiederà quindi se sei sicuro di voler autorizzare Prose. La prosa richiede alcune autorizzazioni, ma tutte hanno un senso:

Successivamente, ti ritroverai in Prose, guardando un elenco di tutti i tuoi repository Git:

Se sei come me, nessuno dei tuoi archivi esistenti è adatto a un mucchio di testo. Naturalmente, questo potrebbe non essere vero per te: ad esempio, se stai usando Jekyll framework di pubblicazione, potresti già avere un repository in attesa di testo. In effetti, gran parte di Prose sembra essere costruita pensando agli utenti di Jekyll: Prose ti consente persino di pubblicare su Jekyll. Detto questo, non lo fai bisogno Jekyll farà uso di Prose, e l'ho guardato senza collegarlo a nient'altro.

Quindi, per cominciare, creiamo una nuova casa per il nostro testo.

Creazione di un nuovo repository GitHub

Per creare un nuovo repository GitHub, dovresti tornare a GitHub stesso - questo non è qualcosa che puoi fare su Prose. Prose suggerisce di nominare il tuo nuovo repository "documenti", quindi è quello che ho fatto.

Immediatamente dopo aver creato il repository, è apparso in Prose:

Modifica di un documento

Facendo clic sul mio nuovo repository di documenti, sono accolto dal README.md predefinito di GitHub. MD, in questo caso, sta per Markdown, lo stesso formato semplice usato da Dillinger.io Dillinger: modifica e visualizza il markdown in tempo reale Leggi di più , TextDown TextDown: ottieni un editor Markdown integrato in Google Chrome Leggi di più , WriteMonkey WriteMonkey - Un semplice editor di testo per persone facilmente distratte Leggi di più e innumerevoli altri editor. Se hai composto del testo per l'uso online per un certo periodo di tempo, è probabile che ti sia imbattuto in Markdown più di una volta.

Facendo clic sul documento, è emersa una semplice interfaccia di modifica:

È beatamente privo di pubblicità e ha una combinazione di colori tenui che è facile per gli occhi. Ha anche l'evidenziazione della sintassi per Markdown e invece di un riquadro di anteprima istantanea (come quello usato in Dillinger.io), l'anteprima del testo reso in HTML richiede un rapido clic sulla barra degli strumenti:

Puoi arrivare alla schermata di anteprima usando Ctrl + Maiusc + freccia destra. Ctrl + Maiusc + freccia sinistra ti porta a un cheat sheet Markdown, nel caso in cui desideri aggiornare la tua memoria.

L'editor è di buon gusto, ma non offre una funzione di conteggio delle parole dal vivo, cosa che mi aspetterei da qualsiasi strumento rivolto agli scrittori. Disabilita anche il controllo ortografico integrato di Chrome, rendendo il tuo testo molto più incline agli errori di battitura.

Pubblicazione (o salvataggio)

A meno che tu non stia usando Jekyll, pubblicare e salvare è praticamente la stessa cosa: non appena salvi, il tuo testo viene trasferito in un repository GitHub. A meno che tu non sia un utente GitHub a pagamento e abbia optato per un repository privato, ciò significa che ora tutti possono vedere il tuo testo. Il primo commit era simile al seguente:

E dopo qualche altro rapido scarabocchio, la cronologia degli impegni di GitHub per il repository sembrava così:

Molto trasparente, ma anche sicuro: le revisioni rendono quasi impossibile perdere il lavoro. Puoi salvare, quindi rimuovere una grande parte del documento, ma sarai sempre in grado di recuperarlo. È come una funzione Undo illimitata che continua a funzionare anche se si spegne il computer o si passa a un'altra.

Questo è tutt'altro che tutto ciò che Prose può fare: ad esempio, puoi usare Prose per modificare il documento di un'altra persona e inviare una richiesta pull affinché accetti le tue revisioni, proprio come fanno i programmatori. Ci sono molte altre cose che potresti fare con Prose, ma il suo principio fondamentale rimane lo stesso: Git per la scrittura.

Pensieri finali

Per me, la prosa sembra più un invito che uno strumento. Un invito a pensare, comporre, redigere, allo scoperto. Per superare la "paura della pubblicazione" pubblicando costantemente mentre scrivi, in modo che non ci sia nessuno "Momento della verità": i tuoi pensieri sono sempre stati là fuori nel mondo, errori di battitura, incoerenze, e tutto. Esistono altri modi per farlo, dai wiki ai client Git standard, ma Prose non pretende di essere un'idea esclusiva: impacchetta semplicemente le cose in modo che il concetto si distingua. Se sia o meno il modo giusto per te di scrivere è una scelta personale - una scelta di cui sarei curioso di sapere, se me lo dicessi nei commenti.