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

Reklama

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 dzisiejszych czasach cyfrowych to nie 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. Proza to prosta platforma publikowania online, która łączy się z GitHub, umożliwiając edycję tekstu online i korzystanie z poprawek Git Co to jest Git i dlaczego powinieneś używać kontroli wersji, jeśli jesteś programistąJako programiści stron internetowych często pracujemy nad lokalnymi witrynami programistycznymi, a następnie przesyłamy wszystko po zakończeniu. To dobrze, gdy jesteś tylko ty, a zmiany są niewielkie, ... Czytaj więcej .

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 ponownie znajdziesz się w Prose, przeglądając 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ć prawdą: Na przykład, jeśli używasz Jekyll ramy publikowania, możesz mieć już repozytorium, które tylko czeka na tekst. W rzeczywistości większość Prozy wydaje się być stworzona z myślą o użytkownikach Jekyll: Prose pozwala nawet publikować w Jekyll. To powiedziawszy, nie potrzeba Jekyll, aby skorzystać z Prozy, a ja patrzył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 - to nie jest coś, co możesz zrobić w Prose. Prose sugeruje nazwać twoje nowe repozytorium „dokumentami”, więc to właśnie 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 w GitHub. MD w tym przypadku oznacza Markdown - ten sam prosty format używany przez Dillinger.io Dillinger: Edycja i przeglądanie Markdown w czasie rzeczywistym Czytaj więcej , TextDown TextDown: Pobierz edytor Markdown wbudowany w Google Chrome Czytaj więcej , WriteMonkey WriteMonkey - prosty edytor tekstu dla osób łatwo rozpraszających się Czytaj więcej i niezliczoną liczbę innych redaktorów. Jeśli od jakiegoś czasu komponujesz tekst do użytku w Internecie, 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. Ma również podświetlanie składni dla Markdown, a zamiast panelu szybkiego podglądu (takiego jak 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 w 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 takie samo: jak tylko zapiszesz, twój 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 potrafi Prose: na przykład możesz użyć Prose do edycji dokumentu innej osoby i przesłać prośbę o zaakceptowanie zmian - tak jak robią to koderzy. Jest 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. Aby przezwyciężyć „strach przed publikacją” poprzez ciągłe publikowanie podczas pisania, tak aby nie było jednego „Chwila prawdy” - twoje myśli były cały czas na świecie, literówki, niespójności, i wszystkich. 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 wyróżniała się koncepcja. 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.