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, lo schermo o un pezzo di carta. L'uomo contro il testo in una battaglia di volontà, ingegno ed emozione, fino a quando improvvisamente - hai finito. Ora è il momento di mostrare il 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 tutto allo scoperto, da sempre? E se il mondo potesse vedere le tue revisioni e seguire, dare suggerimenti? A prima vista, questa può sembrare un'idea orribile - ma per alcuni tipi di testi (e per alcuni scrittori), tale collaborazione aperta può essere un vantaggio. Prose è una semplice piattaforma di pubblicazione online che si interfaccia con GitHub per permetterti di modificare il testo online e mantenere le revisioni usando Git Cos'è Git e Perché dovresti usare il controllo della versione Se sei uno sviluppatore Cos'è Git e perché dovresti usare il controllo della versione Se Sei uno sviluppatore Come sviluppatori web, molto spesso tendiamo a lavorare su siti di sviluppo locali, quindi basta caricare tutto quando abbiamo finito. Questo va bene quando sei solo tu e le modifiche sono piccole, ... Per saperne di più.

Iniziare

Per lavorare con Prose, devi prima avere un account GitHub. Supponendo di aver effettuato l'accesso a Git, è sufficiente fare clic sul pulsante Autorizzazione della prosa:

Git 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 repository esistenti è adatto per un sacco di testo. Ovviamente, questo potrebbe non essere vero per te: ad esempio, se stai usando il framework di pubblicazione di Jekyll, potresti già avere un repository che aspetta solo il 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 hai bisogno che Jekyll faccia uso di Prose, e io l'ho guardato senza collegarlo a nient'altro.

Quindi, per iniziare, 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. La prosa suggerisce di nominare il tuo nuovo repository "documenti", quindi è quello che ho fatto.

Subito dopo aver creato il repository, è apparso all'interno di Prose:

Modifica di un documento

Cliccando nel mio nuovo repository di Documenti, sono accolto dal README.md predefinito di GitHub. MD, in questo caso, sta per Markdown, lo stesso formato semplice utilizzato da Dillinger.io, TextDown, WriteMonkey e innumerevoli altri editor. Se hai scritto testo per uso online per un certo periodo di tempo, è probabile che ti sia capitato di incontrare Markdown più di una volta.

Cliccando sul documento, è apparso un'interfaccia di modifica semplice:

E 'beatamente libero da qualsiasi pubblicità, e ha uno schema di colori tenui che è facile per gli occhi. Ha anche l'evidenziazione della sintassi per Markdown, e invece di un pannello di anteprima istantanea (come quello utilizzato in Dillinger.io), l'anteprima del tuo testo reso in HTML richiede una barra degli strumenti rapida:

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

L'editor è di buon gusto, ma non offre una funzione di conteggio delle parole dal vivo, qualcosa che mi aspetterei da qualsiasi strumento rivolto agli scrittori. Disabilita anche il correttore 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, la pubblicazione e il salvataggio sono praticamente la stessa cosa: non appena salvi, il tuo testo è impegnato in un repository GitHub. A meno che tu non sia un utente GitHub a pagamento e hai optato per un repository privato, questo significa che ora tutti possono vedere il tuo testo. Il primo commit assomigliava a questo:

E dopo alcuni scribacchi più veloci, la cronologia dei commit di GitHub per il repository era simile a questa:

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

Questo è lontano da tutto ciò che può fare Prose: ad esempio, è possibile utilizzare Prose per modificare il documento di un'altra persona e inviare una richiesta di pull per accettare le proprie revisioni, proprio come fanno i programmatori. Ci sono molte altre cose che potresti fare con Prose, ma il suo principio di base rimane lo stesso: Git for writing.

Pensieri finali

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