Scrie și lasă lumea să-ți revizuiască lucrarea cu Prose.io pentru GitHub

Publicitate

În mod tradițional, scrisul este o afacere solitară. Ești doar tu și ecranul sau o bucată de hârtie. Omul versus textul într-o luptă de voințe, inteligență și emoție, până deodată - ați terminat. Acum este timpul să arătați lumii, să vă puneți textul acolo și să urmăriți ce se întâmplă. Dar în aceste vremuri digitale, aceasta nu este singura cale de a merge despre scriere.

Dacă ar fi fost toate în aer liber, tot timpul? Ce se întâmplă dacă lumea ar putea vedea reviziunile tale și le-ar putea urma, făcând sugestii? În această privință, aceasta poate părea o idee oribilă - dar pentru anumite tipuri de texte (și pentru anumiți scriitori), o astfel de colaborare deschisă poate fi o amănuntie. Proză este o simplă platformă de publicare online care interfețează cu GitHub pentru a vă permite să editați text online și să păstrați reviziile folosind git Ce este Git și de ce ar trebui să utilizați controlul versiunii dacă sunteți dezvoltatorÎn calitate de dezvoltatori web, de multe ori avem tendința de a lucra pe site-uri de dezvoltare locală, atunci doar încărcăm totul când am terminat. Este în regulă când ești doar tu, iar modificările sunt mici, ...

Citeste mai mult .

Noțiuni de bază

Pentru a lucra cu Prose, trebuie mai întâi să ai un cont GitHub. Presupunând că v-ați conectat la Git, trebuie doar să faceți clic pe butonul Autorizare pentru proză:

Git vă va întreba dacă sunteți sigur că doriți să autorizați Proza. Proza necesită câteva permisiuni, dar toate au sens:

În continuare, te vei regăsi în Proză, uitându-te la o listă cu toate depozitele Git:

Dacă sunteți ca mine, niciunul dintre depozitele dvs. existente nu este potrivit pentru o grămadă de text. Desigur, acest lucru nu poate fi adevărat pentru dvs.: De exemplu, dacă utilizați Jekyll cadru de publicare, este posibil să aveți deja un depozit care așteaptă doar text. De fapt, o mare parte din Prose pare a fi construită cu utilizatorii Jekyll în minte: Prose chiar vă permite să publicați în Jekyll. Acestea fiind spuse, nu nevoie Jekyll să folosească Proza și am privit-o fără să o conectez la altceva.

Deci, pentru a începe, să facem o casă nouă pentru textul nostru.

Crearea unui nou depozit GitHub

Pentru a crea un nou depozit GitHub, va trebui să vă întoarceți la GitHub în sine - acest lucru nu poate fi realizat pe Prose. Proza sugerează numirea noului dvs. depozit „documente”, așa că am făcut asta.

Imediat după crearea depozitului, acesta a apărut în Proză:

Editarea unui document

Dând clic în noul meu depozit de documente, sunt întâmpinat de README.md implicit de GitHub. MD, în acest caz, înseamnă Markdown - același format simplu folosit de Dillinger.io Dillinger: editați și vizualizați marcarea în timp real Citeste mai mult , TextDown TextDown: Obțineți un editor Markdown încorporat în Google Chrome Citeste mai mult , WriteMonkey WriteMonkey - un simplu editor de text pentru cei mai ușor distrași Citeste mai mult și nenumărați editori. Dacă compuneți text pentru utilizare online pentru o perioadă lungă de timp, este posibil să întâlniți Markdown de mai multe ori.

Făcând clic pe document, a apărut o simplă interfață de editare:

Este fericit de orice reclame și are o schemă de culori dezactivată care este ușor pentru ochi. De asemenea, are evidențierea sintaxei pentru Markdown și în loc de un panou de previzualizare instant (cum este cel folosit în Dillinger.io), previzualizarea textului redat în HTML necesită un clic rapid în bara de instrumente:

Puteți ajunge la ecranul de previzualizare folosind Ctrl + Shift + săgeata dreapta. Ctrl + Shift + săgeata stângă vă duce la o foaie de înșelăciune Markdown, în cazul în care doriți să vă reîmprospătați memoria.

Editorul are gust, dar nu oferă o caracteristică live de numărare a cuvintelor, lucru pe care l-aș aștepta de la orice instrument adresat scriitorilor. Dezactivează de asemenea funcția ortografică încorporată de Chrome, ceea ce face ca textul dvs. să fie mult mai predispus la dactilografieri.

Publicare (sau salvare)

Cu excepția cazului în care utilizați Jekyll, publicarea și salvarea este cam același lucru: de îndată ce salvați, textul dvs. este angajat într-un depozit GitHub. Cu excepția cazului în care sunteți un utilizator GitHub plătitor și ați optat pentru un depozit privat, acest lucru înseamnă că toată lumea vă poate vedea textul. Primul angajament arăta astfel:

Și după alte câteva scrieri rapide, istoricul de angajare al GitHub pentru depozit arăta astfel:

Foarte transparent, dar și sigur: revizuirile fac aproape imposibil să vă pierdeți munca. Puteți salva, apoi elimina o bucată mare din documentul dvs., dar veți putea întotdeauna să îl recuperați. Este ca o caracteristică de anulare nelimitată, care continuă să funcționeze chiar dacă opriți computerul sau vă mutați în altul.

Acest lucru este departe de tot ce poate face Prose: De exemplu, ai putea folosi Prose pentru a edita documentul altei persoane și pentru a trimite o solicitare de tragere pentru ca aceștia să accepte reviziunile tale - așa cum fac codificatorii. Există multe alte lucruri pe care le-ai putea face cu Proza, dar principiul său principal rămâne același: Git pentru scris.

Gânduri finale

Pentru mine, Proza se simte mai mult ca o invitație decât ca un instrument. O invitație de a gândi, compune, redacta, în aer liber. Pentru a depăși „frica de publicare” publicând constant în timp ce scrii, astfel încât să nu existe unul singur „Moment al adevărului” - gândurile tale au fost acolo în toată lumea, dactilografii, neconcordanțe, si tot. Există și alte modalități de a face acest lucru, de la wikis la clienții Git standard, dar Prose nu se preface a fi o idee exclusivă - ci doar pachetează lucrurile astfel încât conceptul să iasă în evidență. Indiferent dacă este sau nu calea potrivită pentru tine de a scrie este o alegere personală - o alegere despre care aș fi curios să aflu, dacă mi-ai spune în comentarii.