Scrieți și lăsați lumea să vă revizuiască lucrarea cu Prose.io Pentru GitHub

În mod tradițional, scrierea este o afacere solitară. Numai tu și ecranul sau o bucată de hârtie. Omul versus text într-o bătălie de voințe, inteligență și emoție, până când brusc - ați terminat. Acum este momentul să arătați lumii, să vă puneți textul acolo și să urmăriți ce se întâmplă. Dar în aceste momente digitale, nu este singura modalitate de a scrie.

Dacă ar fi fost toate în aer liber, tot timpul? Ce se întâmplă dacă lumea ar putea vedea reviziile tale și să urmeze, făcând sugestii? Pe chip, 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 un avantaj. Prose este o platformă simplă de publicare online care interfețează cu GitHub pentru a vă permite să editați text online și să păstrați revizuiri folosind Git Ce este Git și de ce ar trebui să utilizați controlul versiunii Dacă sunteți un dezvoltator Ce este Git și de ce ar trebui să utilizați controlul versiunii Dacă 're un dezvoltator Ca dezvoltatori web, o mulțime de timp avem tendința de a lucra pe site-uri de dezvoltare locală apoi încărcați totul atunci când am terminat. Acest lucru este bine când este doar tine și schimbările sunt mici, ... Citește mai mult .

Noțiuni de bază

Pentru a lucra cu Prose, trebuie să aveți mai întâi un cont GitHub. Presupunând că sunteți conectat (ă) la Git, faceți clic pe butonul Autorizare a Prozei:

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

Apoi, te vei regăsi în Proză, privind o listă a tuturor depozitelor tale Git:

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

Deci, pentru a începe, să facem o nouă casă 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 - nu este ceva ce puteți face pe Prose. Proza sugerează să-ți numești noul depozit “documente,” așa că am făcut-o.

Imediat după crearea repozitorului, a apărut în cadrul Prozei:

Editarea unui document

Făcând clic pe repozitorul meu de Documente proaspete, sunt salutat de implicit README.md al lui GitHub. MD, în acest caz, înseamnă Markdown - același format simplu folosit de Dillinger.io, TextDown, WriteMonkey și nenumărați editori. Dacă ați compune text pentru utilizarea online pentru orice perioadă de timp, probabil că ați întâlnit Markdown de mai multe ori.

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

Este fericit gratuit de orice anunț și are o schemă de culori mutată, care este ușor pe ochi. De asemenea, are o evidențiere a sintaxei pentru Markdown, iar în loc de un panou de previzualizare instantanee (ca cel utilizat în Dillinger.io), previzualizarea textului dvs. redat în HTML necesită o bara rapidă de clic:

Puteți accesa ecranul de previzualizare utilizând Ctrl + Shift + săgeată dreapta. Ctrl + Shift + săgeata stânga vă duce la o foaie de înșelătorie Markdown, în cazul în care doriți să vă reîmprospătați memoria.

Editorul este gustos, dar nu oferă o caracteristică live-count, ceva ce mă așteptam de la orice instrument destinat scriitorilor. De asemenea, dezactivează verificarea de spații încorporate Chrome, făcând textul dvs. mult mai predispus la greșeli.

Publicarea (sau salvarea)

Dacă nu utilizați Jekyll, publicarea și salvarea este aproape același lucru: Imediat ce salvați, textul dvs. este dedicat unui depozit GitHub. Cu excepția cazului în care sunteți un utilizator GitHub plătit și ați optat pentru un depozit privat, aceasta înseamnă că toată lumea vă poate vedea acum textul. Prima comitere a arătat astfel:

Și după câteva scripeți mai rapizi, istoria comitetului lui GitHub pentru depozit a arătat astfel:

Foarte transparent, dar și sigur: Revizuirile fac aproape imposibil să-ți pierzi munca. Puteți salva, apoi elimina o bucată mare de document, dar veți fi întotdeauna în stare să-l înapoi. Este ca o caracteristică Undo nelimitat care continuă să funcționeze chiar dacă opriți calculatorul sau treceți la altul.

Acest lucru este departe de tot ceea ce face Proza: de exemplu, ați putea folosi Proza pentru a edita un document al unei alte persoane și pentru a trimite o solicitare de tragere pentru ca ei să accepte revizuirile dvs. - la fel ca și coderii. Există multe alte lucruri pe care le puteți face cu Proza, dar principiul său principal rămâne același: Git pentru scriere.

Gândurile finale

Pentru mine, Proza simte mai degrabă o invitație decât o unealtă. O invitație de a gândi, de a compune, de a schița, în aer liber. A trece peste “frica de publicitate” prin publicarea constantă pe măsură ce scrieți, astfel încât să nu existe niciun singur “momentul adevarului” - gândurile tale au fost acolo în lume de-a lungul timpului, greșeli, inconsecvențe și tot. Există și alte modalități de a face acest lucru, de la wiki la clienții standard Git, dar Prose nu se pretinde a fi o idee exclusivă - ci doar împachetează lucrurile frumos, astfel încât conceptul să iasă în evidență. Indiferent dacă este sau nu calea potrivită pentru a scrie este o alegere personală - o alegere pe care aș fi curioasă să o aud, dacă mi-ați spune în comentarii.

Explorați mai multe despre: Instrumente de colaborare, Editor de text, Dezvoltare web, Instrumente pentru webmasteri.