Pišite, i neka svijet pregleda vaš rad sa Prose.io za GitHub

Oglas

Tradicionalno je pisanje samotna stvar. To ste samo vi i ekran ili komad papira. Čovjek nasuprot tekstu u bitci volje, pameti i osjećaja, sve dok odjednom - gotovi ste. Sada je vrijeme pokazati svijetu, staviti svoj tekst i gledati što se događa. Ali u ovim digitalnim vremenima, to nije jedini način na koji možete pisati.

Što ako je bilo svi na otvorenom, cijelo vrijeme? Što ako svijet može vidjeti vaše revizije i slijediti ih, dajući prijedloge? Uprkos tome, ovo se može činiti groznom idejom, ali za neke vrste tekstova (i za određene pisce) takva otvorena suradnja može biti dobra. Proza je jednostavna internetska izdavačka platforma koja sučelja s GitHub-om omogućava vam uređivanje teksta na mreži i održavanje revizija koristeći Git Što je Git i zašto biste trebali upotrebljavati kontrolu verzija ako ste programerKao web programeri, puno vremena radimo na lokalnim razvojnim mjestima, a zatim samo prenosimo sve kad završimo. To je u redu kada ste samo vi, a promjene su male, ... Čitaj više .

Početak rada

Da biste radili s Prozom, prvo morate imati GitHub račun. Pod pretpostavkom da ste prijavljeni u Git, jednostavno kliknite gumb Autorizirajte Prozu:

Git će vas pitati želite li autorizirati Prose. Proza zahtijeva dosta dopuštenja, ali svi oni imaju smisla:

Zatim ćete se naći u Proseu i pogledati popis svih vaših Git spremišta:

Ako ste poput mene, nijedno vaše postojeće spremište nije pogodno za gomilu teksta. Naravno, to možda ne vrijedi za vas: Na primjer, ako upotrebljavate Jekyll okvir za izdavanje, možda već imate spremište koje čeka tekst. Zapravo, čini se da je većina Proze izgrađena s obzirom na Jekylove korisnike: Proza vam čak omogućuje objavljivanje u Jekyllu. Rečeno je, potreba Jekyll koristi Prozu, a ja sam gledao to ne povezujući ga ni sa čim drugim.

Za početak, napravimo novi dom za naš tekst.

Stvaranje novog GitHub spremišta

Da biste stvorili novo GitHub skladište, morali biste se vratiti u sam GitHub - to na Prozi nije nešto. Proza predlaže imenovanje vašeg novog skladišta "dokumenti", tako sam to učinio.

Neposredno nakon stvaranja spremišta, pokazalo se unutar proze:

Uređivanje dokumenta

Klikom u moje spremište svježih dokumenata dočeka me GitHub zadani README.md. MD, u ovom slučaju, znači Markdown - isti jednostavan format koji koristi Dillinger.io Dillinger: Uredi i pogledaj obračun u stvarnom vremenu Čitaj više , TextDown TextDown: Nabavite Markdown Editor ugrađen u Google Chrome Čitaj više , WriteMonkey WriteMonkey - jednostavan uređivač teksta za lako ometane Čitaj više i bezbroj drugih urednika. Ako već neko vrijeme sastavljate tekst za internetsku upotrebu, vjerojatno ćete naići na Markdown više puta.

Klikom na dokument pojavilo se jednostavno sučelje za uređivanje:

Blago je bez ikakvih oglasa i ima prigušenu shemu boja koja je laka za oči. Također ima označavanje sintakse za Markdown, a umjesto okna za trenutačni pregled (poput onog koji se koristi u Dillinger.io), pretpregled teksta pretvorenog u HTML zahtijeva brz klik alatne trake:

Do zaslona pregleda možete doći pomoću Ctrl + Shift + strelica desno. Ctrl + Shift + strelica ulijevo vodi vas do Markdown varalice, u slučaju da želite osvježiti pamćenje.

Uređivač je ukusan, ali ne nudi značajku brojanja riječi uživo, nešto što bih očekivao od bilo kojeg alata namijenjenog piscima. Također onemogućuje Chrome ugrađenu provjeru pravopisa, čineći vaš tekst mnogo sklonijim pogreškama.

Objavljivanje (ili spremanje)

Ako ne upotrebljavate Jekyll, objavljivanje i spremanje je gotovo ista stvar: Čim spremite, vaš se tekst predaje u GitHub skladište. Ako niste korisnik GitHub-a koji plaća i odlučite se za privatno skladište, to znači da sada svi mogu vidjeti vaš tekst. Prva obveza izgledala je ovako:

A nakon još nekoliko brzih pisanja, GitHub povijest povijesti skladišta izgledao je ovako:

Vrlo transparentno, ali i sigurno: revizijama je gotovo nemoguće izgubiti posao. Možete spremiti, a zatim ukloniti veliki komad dokumenta, ali uvijek ćete ga moći vratiti. To je poput neograničene značajke Poništi koja nastavlja raditi čak i ako isključite računalo ili prebacite na drugo.

To je daleko od svega što Proza može učiniti: Na primjer, mogli biste pomoću Proze uređivati ​​dokument druge osobe i podnijeti zahtjev za povlačenje da prihvate vaše izmjene - baš kao što to čine i koderi. Mnogo je drugih stvari koje biste mogli učiniti s Prozom, ali njegovo temeljno načelo ostaje isto: Git za pisanje.

Završne misli

Meni se Proza više sviđa kao pozivnica nego kao sredstvo. Poziv za razmišljanje, pisanje, pisanje, na otvorenom. Prevladati "strah od objavljivanja" neprestanim objavljivanjem dok pišete kako ne bi bilo niti jednog "Trenutak istine" - vaše misli su cijelo vrijeme bile vani u svijetu, pogrešaka u pogreškama, nedosljednosti, i sve. Postoje i drugi načini za to, od wikija do standardnih Git klijenata, ali Prose se ne pretvara da je to ekskluzivna ideja - on jednostavno pakira stvari tako da se koncept ističe. Bez obzira jeste li to pravi način pisanja ili ne, osobni je izbor - izbor bih rado rado čuo da mi kažete u komentarima.