Spisywanie notatek ze spotkania przez jedną osobę, podczas gdy reszta zespołu czeka albo dopisuje uwagi na czacie obok, jest wolniejsze niż wspólne pisanie tego samego dokumentu na żywo. Notion i Dropbox Paper to potrafią, ale za cenę konta w cudzej chmurze i abonamentu, który rośnie wraz z liczbą osób w zespole. HedgeDoc to open source edytor Markdown, w którym kilka osób pracuje nad tym samym dokumentem jednocześnie, widzi kursory i zmiany innych w czasie rzeczywistym, a całość stawiasz na własnym Boxie. Poniżej krok po kroku, jak postawić HedgeDoc na Saplo.
Dlaczego HedgeDoc zamiast Notion czy Dropbox Paper
Płatne narzędzia do wspólnej edycji dokumentów mają dwie cechy, które najbardziej doskwierają małym zespołom i freelancerom:
- cena rośnie z liczbą osób - darmowy plan zwykle wystarcza jednej osobie, a doliczenie każdego kolejnego współpracownika do zespołu w Notion czy podobnym narzędziu to osobna pozycja na fakturze co miesiąc,
- treść dokumentów siedzi na cudzym serwerze - notatki ze spotkań, plany projektów i szkice tekstów są w rękach zewnętrznej firmy, nie u Ciebie.
HedgeDoc działa jako kontener Docker z własnym kontenerem PostgreSQL na Twoim Boxie, więc treść wszystkich dokumentów i historia edycji zostają na Twojej infrastrukturze, bez opłaty za osobę i bez limitu liczby dokumentów.
HedgeDoc a Trilium i Wiki.js/BookStack, czyli trzy różne nisze notatek w katalogu Saplo
W katalogu Saplo są już Trilium Notes oraz Wiki.js i BookStack, więc naturalne pytanie brzmi, czym różni się od nich HedgeDoc. Odpowiedź jest w tym, do czego każde z tych narzędzi służy:
- Trilium Notes to notatnik jednej osoby - hierarchiczna baza notatek i wiedzy, budowana przez pojedynczego użytkownika przez dłuższy czas, bez nacisku na edycję na żywo przez kilka osób naraz,
- Wiki.js i BookStack to wiki firmowe z wersjonowaniem stron, strukturą kategorii i uprawnieniami - dobre do dokumentacji, która ma stałą strukturę i historię zmian, ale nie do szybkiego wspólnego szkicu na żywo,
- HedgeDoc skupia się wyłącznie na żywej, jednoczesnej edycji pojedynczego dokumentu Markdown - widzisz kursory innych uczestników i ich zmiany na bieżąco, bez struktury całej bazy wiedzy i bez systemu uprawnień jak w wiki firmowym.
Jeśli budujesz osobistą bazę wiedzy, sprawdź Trilium. Jeśli zespół potrzebuje ustrukturyzowanej dokumentacji z historią wersji, wybierz Wiki.js albo BookStack. Jeśli chodzi o wspólne pisanie notatek ze spotkania albo szkicu tekstu na żywo, tu, teraz, razem z kimś, HedgeDoc pasuje najlepiej.
Wymagania
Żeby postawić HedgeDoc na Saplo, potrzebujesz:
- Boxa z uruchomionym Dockerem (silnik włącza go automatycznie przy instalacji z katalogu, wymagane jest nesting w kontenerze, co Saplo ma domyślnie),
- minimum 1 GB RAM wolnego na Boxie i 2 GB miejsca na dysku, czyli plan Box M lub wyższy,
- domeny albo subdomeny
*.saploapp.plw cenie każdego planu, pod którą stanie edytor, - osobnej bazy danych NIE zakładasz ręcznie - HedgeDoc wymaga bazy SQL, a silnik stawia do tego dedykowany kontener PostgreSQL w tym samym docker-compose (współdzielona baza Saplo obsługuje tylko MySQL/MariaDB).
Instalacja krok po kroku
- W panelu Saplo wejdź w Katalog aplikacji i wybierz HedgeDoc (kategoria "Biznes").
- Wskaż Box z minimum 1 GB wolnego RAM, na którym ma stanąć edytor, oraz domenę albo subdomenę, pod którą będzie działał.
- Zatwierdź instalację. Silnik stawia kontener z oficjalnego obrazu
quay.io/hedgedoc/hedgedocrazem z dedykowanym kontenerempostgres:15-alpine, generuje losowe hasło do bazy i losowy sekret sesji, po czym wystawia aplikację wyłącznie na loopback Boxa, podpięty pod nginx, który serwuje ją pod wskazaną domeną z darmowym SSL. Na zewnątrz wystawiony jest tylko port 443, nie surowy port kontenera. - Po
docker compose upsilnik dodatkowo sprawdza, czy strona HedgeDoc faktycznie odpowiada po HTTP, bo pierwszy start kontenera robi migracje schematu bazy i potrafi potrwać dłużej niż typowe kilka sekund, więc sam status "kontener działa" nie oznacza jeszcze gotowej aplikacji. - Wspólna edycja działa przez websocket na tej samej domenie co aplikacja - nie wymaga żadnej dodatkowej konfiguracji po stronie klienta ani osobnego portu.
Pierwsza konfiguracja
HedgeDoc, w odróżnieniu od Directusa czy Wiki.js, nie ma pojęcia konta administratora - każdy, kto się zarejestruje, jest zwykłym użytkownikiem i widzi wyłącznie własne dokumenty oraz te, do których dostał link.
- Wejdź pod adres domeny, na przykład
notatki.saploapp.pl, i załóż pierwsze konto w kreatorze rejestracji przy pierwszym wejściu na stronę. - Utwórz nowy dokument przyciskiem New note - dostajesz unikalny link do edycji, który wysyłasz każdemu, kto ma dołączyć do wspólnej pracy nad treścią.
- Współpracownicy otwierają ten sam link i od razu widzą kursory oraz zmiany innych na bieżąco, bez potrzeby zakładania własnego konta, jeśli dokument ma otwarty dostęp do edycji.
- Gotowy dokument eksportujesz do PDF, HTML albo surowego pliku Markdown z menu dokumentu, albo udostępniasz go dalej wyłącznie do odczytu osobnym linkiem.
- Historię wersji dokumentu podglądasz w widoku Revision, co pozwala wrócić do wcześniejszej treści bez ręcznego kopiowania kopii zapasowych.
HedgeDoc na Saplo kontra Notion i Dropbox Paper
| Notion / Dropbox Paper w chmurze | HedgeDoc na Saplo | |
|---|---|---|
| Cena za dodatkową osobę w zespole | zwykle osobna pozycja w abonamencie | brak, liczy się tylko koszt Boxa |
| Gdzie leży treść dokumentów | na serwerze dostawcy | na Twoim Boxie |
| Konto wymagane do współedycji | tak, zwykle w całym zespole | nie, wystarczy link do dokumentu |
| Koszt | abonament miesięczny rosnący z zespołem | koszt samego Boxa |
Najczęstsze pytania
Czy HedgeDoc potrzebuje osobnej bazy danych? Tak, w przeciwieństwie do części aplikacji w katalogu Saplo HedgeDoc wymaga bazy SQL, więc silnik stawia dla niego dedykowany kontener PostgreSQL w tym samym docker-compose, nie korzysta ze współdzielonej bazy Saplo dostępnej tylko dla MySQL/MariaDB.
Czym HedgeDoc różni się od Trilium Notes, skoro oba są w katalogu Saplo? Trilium to hierarchiczny notatnik jednej osoby budowany przez dłuższy czas, HedgeDoc skupia się na jednoczesnej edycji pojedynczego dokumentu przez kilka osób naraz, na żywo.
Czy trzeba zakładać konto, żeby wspólnie edytować dokument? Nie, jeśli dokument ma otwarty dostęp do edycji, wystarczy link - konto zakładasz sam wyłącznie po to, żeby mieć listę własnych dokumentów zapisaną na stałe.
Czy da się wyeksportować gotowy dokument poza HedgeDoc? Tak, z menu dokumentu eksportujesz treść do PDF, HTML albo surowego pliku Markdown.
Jeśli zespół pisze notatki i szkice razem, na żywo, i szuka do tego prostego edytora bez abonamentu na osobę, napisz do nas, pomożemy dobrać Box pod Twój zespół.