Pisz i pozwól światu zrewidować Twoją pracę z Prose.io dla GitHub

Tradycyjnie pisanie jest samotną sprawą. To tylko ty i ekran lub kartka papieru. Człowiek kontra tekst w bitwie woli, sprytu i emocji, aż nagle - skończysz. Teraz nadszedł czas, aby pokazać światu, umieścić tam swój tekst i obserwować, co się stanie. Ale w tych czasach cyfrowych nie jest to jedyny sposób na pisanie.

Co jeśli tak było wszystko cały czas na zewnątrz? Co by było, gdyby świat mógł zobaczyć Twoje poprawki i podążać za nimi, zgłaszając sugestie? Na pierwszy rzut oka może to wydawać się okropnym pomysłem - ale w przypadku niektórych rodzajów tekstów (i niektórych pisarzy) taka otwarta współpraca może być dobrodziejstwem. Prose to prosta platforma publikowania online, która łączy się z GitHub, aby umożliwić edytowanie tekstu online i utrzymywanie poprawek za pomocą Git Czym jest Git i dlaczego warto używać kontroli wersji, jeśli jesteś programistą Czym jest Git i dlaczego powinieneś używać kontroli wersji, jeśli jesteś programistą Jako twórcy stron internetowych często pracujemy nad lokalnymi witrynami programistycznymi, a następnie przesyłamy wszystko, gdy skończymy. To dobrze, gdy jesteś tylko ty, a zmiany są niewielkie… .

Pierwsze kroki

Aby pracować z Prose, musisz najpierw mieć konto GitHub. Zakładając, że jesteś zalogowany do Git, po prostu kliknij przycisk Autoryzuj prozę:

Git zapyta, czy na pewno chcesz autoryzować Prozę. Proza wymaga sporo pozwoleń, ale wszystkie mają sens:

Następnie wrócisz do Prozy i przeglądasz listę wszystkich repozytoriów Git:

Jeśli jesteś podobny do mnie, żadne z twoich istniejących repozytoriów nie nadaje się na kilka tekstów. Oczywiście może to nie być dla ciebie prawdą: na przykład, jeśli używasz frameworka Jekyll, być może repozytorium już czeka na tekst. W rzeczywistości większość Prose wydaje się być stworzona z myślą o użytkownikach Jekyll: Prose pozwala nawet publikować w Jekyll. Powiedział, że nie potrzeba Jekyll, aby skorzystać z Prozy, a ja spojrzałem na to, nie łącząc go z niczym innym.

Na początek stwórzmy nowy dom dla naszego tekstu.

Tworzenie nowego repozytorium GitHub

Aby utworzyć nowe repozytorium GitHub, musisz wrócić do samego GitHub - tego nie możesz zrobić w Prose. Prose sugeruje nazewnictwo nowego repozytorium “dokumenty,” więc to zrobiłem.

Natychmiast po utworzeniu repozytorium pojawiło się w Prose:

Edycja dokumentu

Po kliknięciu mojego świeżego repozytorium dokumentów wita mnie domyślny plik README.md GitHub. MD w tym przypadku oznacza Markdown - ten sam prosty format używany przez Dillinger.io Dillinger: Edycja i wyświetlanie Markdown w czasie rzeczywistym Dillinger: Edycja i wyświetlanie Markdown w czasie rzeczywistym, TextDown TextDown: Pobierz edytor Markdown wbudowany w Google Chrome TextDown : Pobierz edytor Markdown wbudowany w Google Chrome, WriteMonkey i niezliczoną liczbę innych edytorów. Jeśli komponujesz tekst do użytku online przez dłuższy czas, istnieje prawdopodobieństwo, że spotkałeś Markdown więcej niż raz.

Po kliknięciu dokumentu pojawił się prosty interfejs edycji:

Jest błogo wolny od reklam i ma stonowaną kolorystykę, która jest przyjemna dla oczu. Posiada również podświetlanie składni dla Markdown, a zamiast panelu szybkiego podglądu (takiego jak ten używany w Dillinger.io), podgląd tekstu renderowanego w HTML wymaga szybkiego kliknięcia paska narzędzi:

Możesz przejść do ekranu podglądu za pomocą Ctrl + Shift + strzałka w prawo. Ctrl + Shift + strzałka w lewo przenosi cię do ściągawki Markdown, na wypadek gdybyś chciał odświeżyć pamięć.

Edytor jest gustowny, ale nie oferuje funkcji liczenia słów na żywo, czego oczekiwałbym od jakiegokolwiek narzędzia skierowanego do pisarzy. Wyłącza także wbudowany moduł sprawdzania pisowni Chrome, dzięki czemu tekst jest znacznie bardziej podatny na literówki.

Publikowanie (lub zapisywanie)

O ile nie używasz Jekyll, publikowanie i zapisywanie jest prawie tym samym: po zapisaniu tekst jest zapisywany w repozytorium GitHub. Jeśli nie jesteś płatnym użytkownikiem GitHub i nie zdecydowałeś się na prywatne repozytorium, oznacza to, że każdy może teraz zobaczyć Twój tekst. Pierwsze zatwierdzenie wyglądało tak:

Po kilku szybkich bazgrołach historia zatwierdzeń GitHub dla repozytorium wyglądała następująco:

Bardzo przejrzysty, ale także bezpieczny: poprawki sprawiają, że utrata pracy jest prawie niemożliwa. Możesz zapisać, a następnie usunąć dużą część dokumentu, ale zawsze będziesz w stanie go odzyskać. To jak nieograniczona funkcja cofania, która działa nawet po wyłączeniu komputera lub przejściu na inny.

Jest to dalekie od wszystkiego, co Prose może zrobić: na przykład możesz użyć Prose do edycji dokumentu innej osoby i wysłać prośbę, aby zaakceptowała twoje poprawki - tak jak robią to koderzy. Istnieje wiele innych rzeczy, które możesz zrobić z Prozą, ale jej podstawowa zasada pozostaje ta sama: Git for writing.

Końcowe przemyślenia

Dla mnie Proza przypomina raczej zaproszenie niż narzędzie. Zaproszenie do myślenia, komponowania, szkicowania, na otwartej przestrzeni. Przezwyciężyć “strach przed publikacją” przez ciągłe publikowanie w trakcie pisania, aby nie było jednego “moment prawdy” - wasze myśli były cały czas na świecie, literówki, niespójności i tak dalej. Są na to inne sposoby, od stron wiki po standardowe klienty Git, ale Prose nie udaje wyłącznego pomysłu - po prostu porządnie pakuje rzeczy, aby koncepcja się wyróżniała. To, czy jest to właściwy sposób pisania, jest osobistym wyborem - chciałbym usłyszeć o nim, jeśli powiedziałbyś mi w komentarzach.