Rakstiet un ļaujiet pasaulei pārskatīt savu darbu ar Prose.io vietnei GitHub

Reklāma

Rakstīšana tradicionāli ir vientuļa lieta. Tas ir tikai jūs un ekrāns, vai papīra gabals. Cilvēks pret tekstu gribas, prāta un emociju cīņā, līdz pēkšņi - esat pabeidzis. Tagad ir laiks parādīt pasaulei, izvietot tur savu tekstu un skatīties, kas notiek. Bet šajos digitālajos laikos tas nav vienīgais veids, kā rakstīt.

Kas būtu, ja būtu visiem ārā ārā, visā garumā? Ko darīt, ja pasaule varētu redzēt jūsu labojumus un sekot līdzi, sniedzot priekšlikumus? Raugoties uz to, tā var šķist briesmīga ideja - bet dažu veidu tekstiem (un dažiem rakstniekiem) šāda atklāta sadarbība var būt svētīgs. Proza ir vienkārša tiešsaistes publicēšanas platforma, kas ir saskarne ar GitHub, lai jūs varētu rediģēt tekstu tiešsaistē un saglabāt labojumus, izmantojot Git Kas ir Git un kāpēc jums vajadzētu izmantot versiju vadību, ja esat izstrādātājsBūdami tīmekļa izstrādātāji, mēs bieži strādājam vietējās attīstības vietnēs, un pēc tam vienkārši augšupielādējiet visu, kad tas ir paveikts. Tas ir labi, ja tas ir tikai jūs un izmaiņas ir mazas, ... Lasīt vairāk .

Darba sākšana

Lai strādātu ar Prose, vispirms ir jābūt GitHub kontam. Pieņemot, ka esat pieteicies Git, vienkārši noklikšķiniet uz pogas Prozas pilnvarot:

Tad Git jautās, vai esat pārliecināts, ka vēlaties atļaut prozu. Prozai ir vajadzīgas diezgan maz atļauju, taču tām visām ir jēga:

Tālāk jūs atradīsit sevi Prozā, apskatot visu jūsu Git krātuvju sarakstu:

Ja jūs esat tāds kā es, neviena no jūsu esošajām krātuvēm nav piemērota teksta kopai. Protams, tas neattiecas uz jums: Piemēram, ja izmantojat Džekils publicēšanas ietvars, iespējams, ka jums jau ir krātuve, kas tikai gaida tekstu. Faktiski šķiet, ka liela daļa prozas tiek veidota, paturot prātā Jekyll lietotājus: Proza pat ļauj jums publicēties vietnē Jekyll. Tas nozīmē, ka jums nav vajag Jekyll, lai izmantotu prozu, un es to apskatīju, nesaistot to ar kaut ko citu.

Tātad, lai sāktu, izveidosim jaunas mājas mūsu tekstam.

Jauna GitHub repozitorija izveidošana

Lai izveidotu jaunu GitHub repozitoriju, jums vajadzētu atgriezties pašā GitHub - tas nav kaut kas, ko jūs varat darīt Prose. Proza iesaka savu jauno repozitoriju nosaukt par “dokumentiem”, lai es to izdarītu.

Tūlīt pēc repozitorija izveidošanas tas parādījās prozā:

Dokumenta rediģēšana

Noklikšķinot uz manu jauno dokumentu krātuvi, mani sagaida GitHub noklusējuma README.md. MD šajā gadījumā apzīmē Markdown - to pašu vienkāršo formātu, kuru izmanto Dillinger.io Dillingers: rediģēt un skatīt atzīmi reāllaikā Lasīt vairāk , Teksts TextDown: iegūstiet atzīmju redaktoru, kas iebūvēts pārlūkā Google Chrome Lasīt vairāk , WriteMonkey WriteMonkey - vienkāršs teksta redaktors, kas ļauj viegli novērst uzmanību Lasīt vairāk un neskaitāmi citi redaktori. Ja jūs kādu laiku esat rakstījis tekstu izmantošanai tiešsaistē, iespējams, ka esat vairāk nekā vienu reizi saskāries ar atzīmi.

Noklikšķinot uz dokumenta, parādījās vienkāršs rediģēšanas interfeiss:

Tajā svētlaimīgi nav nekādu reklāmu, un tai ir izslēgta krāsu shēma, kas ir viegli pie acīm. Tam ir arī sintakses izcelšana Markdown, un tūlītēja priekšskatījuma paneļa (piemēram, tā, kas izmantota Dillinger.io) vietā priekšskatot HTML pārveidoto tekstu, ir nepieciešams ātrs rīkjoslas klikšķis:

Jūs varat nokļūt priekšskatījuma ekrānā, izmantojot Ctrl + Shift + labo bultiņu. Ar Ctrl + Shift + bultiņu pa kreisi nokļūsit pie Markdown krāpšanās lapas, ja vēlaties atjaunināt atmiņu.

Redaktors ir gaumīgs, bet nepiedāvā reālu vārdu skaitīšanas funkciju, ko es varētu gaidīt no jebkura rīka, kas paredzēts rakstniekiem. Tas arī atspējo pārlūkā Chrome iebūvēto pareizrakstības pārbaudi, padarot jūsu tekstu daudz vairāk pakļautu drukas ierakstiem.

Izdevējdarbība (vai saglabāšana)

Ja vien jūs neizmantojat Jekyll, publicēšana un saglabāšana ir gandrīz viens un tas pats: Tiklīdz saglabājat, jūsu teksts tiek nodots GitHub krātuvei. Ja vien jūs neesat maksājošs GitHub lietotājs un esat izvēlējies privātu krātuvi, tas nozīmē, ka visi tagad var redzēt jūsu tekstu. Pirmā apņemšanās izskatījās šādi:

Un pēc vēl dažiem ātriem aprakstiem GitHub repozitorija saistību vēsture izskatījās šādi:

Ļoti caurspīdīgs, bet arī drošs: pārskatīšana padara gandrīz neiespējamu zaudēt darbu. Jūs varat saglabāt un pēc tam noņemt lielu dokumenta daļu, taču vienmēr varat to atgūt. Tas ir kā neierobežota atsaukšanas funkcija, kas turpina darboties pat tad, ja izslēdzat datoru vai pārejat uz citu.

Tas ir tālu no visa, ko var darīt Prosa: Piemēram, jūs varat izmantot programmu Proza, lai rediģētu citas personas dokumentu un iesniegtu atkārtotu pieprasījumu, lai šī persona pieņemtu jūsu labojumus - tāpat kā koderi. Ir daudz citu lietu, ko jūs varētu darīt ar Prozu, bet tās pamatprincips paliek tāds pats: Git rakstīšanai.

Noslēguma domas

Man Proza vairāk šķiet kā ielūgums, nevis kā rīks. Aicinājums domāt, komponēt, veidot, atklātībā. Lai pārvarētu “bailes no publikācijām”, pastāvīgi publicējot, rakstot, lai nebūtu viena “Patiesības brīdis” - jūsu domas visā pasaulē ir bijušas visā pasaulē, drukas kļūdas, neatbilstības, un viss. Ir arī citi veidi, kā to izdarīt, sākot ar wikiem un beidzot ar standarta Git klientiem, taču Prose neizliekas par ekskluzīvu ideju - tā vienkārši lietas glīti iesaiņo tā, lai šī koncepcija izceltos. Tas, vai tas ir pareizais veids, kā jūs varat rakstīt, ir personīga izvēle - izvēle, par kuru man būtu interesanti dzirdēt, ja jūs man teiktu komentāros.