Píšte a nechajte svet prepracovať svoju prácu s programom Prose.io pre program GitHub

Reklama

Písanie je tradične osamelým problémom. Ste to len vy a obrazovka alebo kus papiera. Človek verzus text v bitke vôle, rozumu a emócie, až sa zrazu - hotovo. Teraz je čas ukázať svetu, dať tam text a sledovať, čo sa stane. Ale v týchto digitálnych časoch to nie je jediný spôsob, ako písať.

Čo keby to bolo všetko vonku, po celú dobu? Čo keby svet videl vaše revízie a sledoval ich spolu s návrhmi? Na prvý pohľad sa to môže zdať ako hrozný nápad - ale pre niektoré druhy textov (a pre niektorých autorov) môže byť takáto otvorená spolupráca prínosom. próza je jednoduchá online publikačná platforma, ktorá je v rozhraní s GitHub, ktorá vám umožňuje online upravovať text a používať revízie Git Čo je to Git a prečo by ste mali používať kontrolu verzií, ak ste vývojárAko weboví vývojári veľa času máme tendenciu pracovať na stránkach miestneho rozvoja a potom, keď skončíme, všetko jednoducho odovzdáme. To je v poriadku, keď ste to len vy a zmeny sú malé, ... Čítaj viac .

Začíname

Ak chcete pracovať s programom Prose, musíte mať najprv účet GitHub. Za predpokladu, že ste prihlásení do služby Git, jednoducho kliknite na tlačidlo Autorizovať prózu:

Git sa potom opýta, či ste si istí, že chcete autorizovať program Prose. Próza vyžaduje pomerne málo povolení, ale všetky majú zmysel:

Ďalej sa ocitnete v Prose, kde nájdete zoznam všetkých vašich úložísk Git:

Ak sa vám páči, žiadne z vašich existujúcich úložísk sa nehodí pre veľa textu. To samozrejme nemusí platiť pre vás: Napríklad, ak používate Jekyll publikovanie rámca, možno už máte úložisko čaká na text. V skutočnosti sa zdá, že veľká časť Prose je postavená na užívateľoch Jekyll: Prose dokonca umožňuje publikovať na Jekyll. To znamená, že nie potreba Jekyll využiť Prose a ja som sa na to pozrel bez toho, aby som ju pripojil k čomukoľvek inému.

Na začiatok teda vytvorme nový domov pre náš text.

Vytvorenie nového úložiska GitHub

Ak chcete vytvoriť nové úložisko GitHub, musíte sa vrátiť k samotnému GitHub - toto nie je niečo, čo by ste mohli urobiť na Prose. Prose navrhuje pomenovať vaše nové úložisko „dokumenty“, takže som to urobil.

Ihneď po vytvorení úložiska sa v Prose objavilo:

Úpravy dokumentu

Po kliknutí na moje nové úložisko Dokumentov ma uvítal predvolený README.md od spoločnosti GitHub. MD v tomto prípade znamená Markdown - rovnaký jednoduchý formát, aký používa Dillinger.io Dillinger: Úpravy a zobrazenie poznámok v reálnom čase Čítaj viac , TextDown TextDown: Vytvorte editor výrazov zabudovaný do prehliadača Google Chrome Čítaj viac , WriteMonkey WriteMonkey - jednoduchý textový editor pre ľahko rozptýlené Čítaj viac a nespočet ďalších editorov. Ak ste písali text na použitie online už dlhší čas, je pravdepodobné, že ste narazili na Markdown viackrát.

Po kliknutí na dokument vzniklo jednoduché editovacie rozhranie:

Je blažene bez akýchkoľvek reklám a má stlmenú farebnú schému, ktorá je pre oči ľahká. Má tiež zvýraznenie syntaxe pre Markdown. Namiesto okamžitej tably ukážky (ako je tá, ktorá sa používa v Dillinger.io) si vyžaduje zobrazenie textu vykresleného do HTML rýchle kliknutie na panel s nástrojmi:

Na obrazovku náhľadu sa môžete dostať pomocou klávesov Ctrl + Shift + šípka doprava. Ctrl + Shift + šípka doľava vás zavedie na cheatový list Markdown pre prípad, že by ste chceli obnoviť svoju pamäť.

Editor je vkusný, ale nenabízí živú funkciu počítania slov, čo by som očakával od akéhokoľvek nástroja zameraného na spisovateľov. Zakáže tiež vstavanú kontrolu pravopisu v prehliadači Chrome, takže váš text bude oveľa viac náchylný k preklepom.

Vydavateľstvo (alebo ukladanie)

Pokiaľ nepoužívate Jekyll, publikovanie a ukladanie je skoro to isté: Akonáhle uložíte, váš text sa zaviaže do úložiska GitHub. Pokiaľ nie ste platiacim používateľom služby GitHub a nezvolili ste si súkromné ​​úložisko, znamená to, že váš text sa bude môcť zobraziť všetkým. Prvý záväzok vyzeral takto:

A po niekoľkých ďalších rýchlych čmáraninách vyzerala história odovzdania GitHubu pre úložisko takto:

Veľmi priehľadné, ale zároveň bezpečné: Vďaka revíziám je takmer nemožné prísť o prácu. Môžete uložiť a potom odstrániť veľkú časť dokumentu, ale vždy ju budete môcť získať späť. Je to ako funkcia neobmedzeného vrátenia, ktorá funguje, aj keď počítač vypnete alebo sa presuniete na iný.

Toto nie je zďaleka všetko, čo môže Prose urobiť: Napríklad by ste mohli použiť Prose na úpravu dokumentu inej osoby a odoslanie žiadosti o stiahnutie, aby prijali vaše revízie - rovnako ako to robia kódovači. S programom Prose môžete robiť aj mnoho ďalších vecí, ale jeho základný princíp zostáva rovnaký: Zostaňte pri písaní.

Záverečné myšlienky

Próza mi pripadá skôr ako pozvánka ako nástroj. Pozvánka na premyslenie, zostavenie, návrh, otvorene. Ak chcete prekonať „strach z publikovania“ neustálym publikovaním, ako píšete, tak, aby neexistoval jediný „Okamih pravdy“ - vaše myšlienky boli po celý čas na svete, preklepy, nezrovnalosti, a všetko. Existujú aj iné spôsoby, ako to dosiahnuť - od klientov wiki až po štandardných klientov Git, ale Prose nepredstiera, že je to exkluzívny nápad - veci sa iba úhľadne balia, aby vynikol koncept. Či je pre vás ten správny spôsob písania, je osobná voľba - voľba, o ktorej by som sa zaujímala, ak by ste mi to povedali v komentároch.