Dla mnie, najlepszym platform膮 na blogging jest Google Docs, bo obs艂uguje poni偶sze:

  • Wsp贸艂pracowa膰 na 偶ywo.
  • Pozostawia膰 komentarze bezpo艣rednio w tek艣cie, a nie w ograniczonym obszarze.
  • Sugerowa膰 zmiany bezpo艣rednio w tek艣cie. C贸偶 mi艂y spos贸b na poprawianie tekstu!
    • Z tego powodu r贸wnie偶 wol臋 Wikis od Git鈥檃, je艣li chodzi o pisanie dokumentacji, bo bariera wej艣cia jest znacznie mniejsza.

Niestety, Google Docs nie jest zw艂aszcza dost臋pny:

  • Wydaje si臋, 偶e nie b臋dzie indeksowany przez wyszukiwarki?
  • Wymaga Javascript.
  • Wymaga Google, czemu niekt贸rzy ludzie sprzeciwiaj膮 si臋 ze wzgl臋du na prywatno艣膰.

Dlatego nie wydaj臋 w ten spos贸b post贸w na blogu.

Ale w dobie hipermedi贸w te funkcje powinny by膰 standardem! Powinni艣my dyskutowa膰, a nie wyrzuca膰 artyku艂y w pr贸偶ni臋!

Medium wy艣wietla艂o komentarze w tek艣cie, ale ju偶 tego nie robi (nie 偶ebym chcia艂 wydawa膰 posty na Medium). Nie widzia艂em wielu innych blog贸w, kt贸re zapraszaj膮 do dyskusji za pomoc膮 interaktywnych funkcji.

Kiedy艣 czyta艂em Real World OCaml, kiedy jego drugie wydanie by艂o w wersji roboczej. Po ka偶dym zdaniu znajdowa艂 si臋 link na pozostawianie komentarza. To jest naprawd臋 fajny spos贸b na pisanie ksi膮偶ki! Dlaczego akurat ksi膮偶ka jest聽bardziej interaktywna ni偶 nasze blogi?

Niech 偶yje ten blog

Od niedawna mo偶na pozostawia膰 komentarze na akapitach mojego blogu, naje偶d偶aj膮c/dotykaj膮c i klikaj膮c link 鈥淪komentuj鈥, kt贸ry si臋 pojawi.

  • Inne rozwi膮zania:
    • https://utteranc.es
    • Disqus
      • U偶ywany ju偶 do komentarzy na tym blogu, chocia偶 jest troch臋 podejrzany, je艣li chodzi o korzystanie plik贸w cookie.
    • Ka偶da z tych opcji wymaga tworzenie w艂asnego w膮tku komentarza dla ka偶dego akapitu, na kt贸rym mo偶na skomentowa膰.
      • Ich UIs nie zosta艂y zaprojektowane tak, aby by艂y zwarte, wi臋c nie pasuj膮 dobrze mi臋dzy akapitami na blogu. By艂oby ogromny formularz po ka偶dym akapitu.
      • Spowodowa艂oby to niepotrzebne obci膮偶enie serwer贸w komentarzy, troch臋 niegrzecznie dla nich.
      • Spowodowa艂oby to wolniejsze 艂adowanie strony podczas zapytania do kilku w膮tk贸w komentarzy.
    • Mo偶esz czerpa膰 inspiracj臋 z projektu takiego jak SideComments.js.
    • Moja implementacja niestety opiera si臋 na GitHub jako dostawcy uwierzytelniania i bazie danych. Jestem pewien, 偶e wielu czytelnik贸w nie b臋dzie mia艂o kont GitHub鈥檃.
      • To by艂 dla mnie naj艂atwiejszy spos贸b na zaimplementowanie.
      • GitHub API jest wystarczaj膮co wyrazisty, aby wys艂a膰 zapytanie o wszystkie komentarze dla pewnego dokumentu w jednym 偶膮daniu.
      • GitHub API nie wymaga uwierzytelniania ani klucza API do wysy艂ania 偶膮da艅!
        • Przypuszczalnie b臋dziesz ograniczany bardziej agresywnie ni偶 w przypadku uwierzytelnienia.
      • Otwarcie nowej strony GitHub Issues鈥檃 w celu pozostawiania komentarza jest niewygodnie.
      • Patrz膮c wstecz, by膰 mo偶e powinienem by艂 u偶y膰 GitHub Discussions鈥檃 zamiast GitHub Issues鈥檃 jako bazy daty, poniewa偶 s膮 to鈥 dyskusje.
    • Akapity s膮 identyfikowane za pomoc膮 permalinku/鈥漵lug鈥 i poprzez pobranie kilku pierwszych znormalizowanych bajt贸w danych w akapicie i zakodowanie jako base64.
      • Teoretycznie identyfikatory akapit贸w nie s膮 zatem stabilne, je艣li tre艣膰 zmienia si臋 p贸藕niej, ale wydaje si臋, 偶e jest to niewielki problem.
    • Oto implementacja w momencie pisania tego tekstu (137 linii kodu): github-comment-links.js.
      • Nowoczesne API przegl膮darki sprawiaj膮, 偶e zapytanie do API GitHub鈥檃 jest do艣膰 proste.

Komentarze