Jak hostować slajdy Reveal.js

Spakuj zbudowany folder Reveal.js, upuść go i dostajesz adres URL, który możesz wkleić do zaproszenia w kalendarzu. To całe zadanie. Oto co dostajesz:

• Link dla klienta w kilka sekund, a nie projekt GitHub Pages ani laptop z uruchomionym npm start.
• Wersje pod jednym adresem. Popraw wykres, wgraj ponownie, ten sam link pokazuje nowy build.
• Prezentacja bez udostępniania ekranu laptopa. W piątek otwórz tryb prelegenta z tego samego linku.

Reveal.js to solidny sposób na pisanie slajdów jako HTML. Ich udostępnianie to część, którą ludzie improwizują: wypychasz folder buildu na Pages albo pakujesz projekt i liczysz, że odbiorca będzie wiedział, który plik otworzyć. Żadne z tych nie jest jak udostępnić prezentację HTML jako adres URL dla klienta.

Czy jesteś programistą prezentującym badania, czy marketerem, któremu inżynier podał folder Reveal, efekt jest ten sam. Odbiorcy otwierają przeglądarkę. Nie klonują repo, nie uruchamiają Node ani nie zgadują, który plik jest prezentacją.

Co właściwie trzeba wgrać

Projekty Reveal.js zawierają więcej niż slajdy. Do hostowania wyślij zbudowany, samodzielny folder:

• Twój HTML wejściowy w katalogu głównym (albo w jednym folderze najwyższego poziomu, który jest za Ciebie rozpakowywany).
• CSS, motywy, fonty i obrazy, do których prezentacja odwołuje się ścieżkami względnymi.
• Zbundlowane skrypty, których prezentacja potrzebuje do działania.

Nie wgrywaj całego repo git z zależnościami. Uderzysz w darmowy limit 10 MB i wyślesz śmieci. Właściwym artefaktem jest ZIP eksportu, który upuściłbyś na dowolny statyczny host.

Host vs GitHub Pages vs npm start

Podejście	Dobre do	Ból
Lokalny serwer Reveal	Tworzenie	Odbiorcy nie otworzą Twojego localhosta
GitHub Pages / Netlify	Powtarzalne, wersjonowane strony	Konfiguracja, repo, “który URL to prod?”
Host prezentacji	Wystąpienia, wysyłka do klienta, prezentacja na żywo	Wgrywasz gotowe buildy; 10 MB na darmowym planie

Użyj Pages, gdy prezentacja to dokumentacja wdrażana przy każdym merge’u. Użyj hosta, gdy zadaniem jest “wyślij to do czwartku i zaprezentuj w piątek”.

Prezzly przyjmuje ZIP, zachowuje Twoje wersje i serwuje prezentację tak, że nawigacja po slajdach i sterowanie prelegenta działają w przeglądarce. Jeśli generujesz nową prezentację od zera, trzymanie się sugerowanej przez Prezzly struktury slajdów daje najczystszy wynik; większość istniejącego kodu Reveal nadal działa bez zmian.

Które funkcje Reveal dalej działają

Większość prezentacji po prostu działa: Twój układ, style, przejścia i skrypty, które napędzają slajdy. Kilka rzeczy warto sprawdzić, zanim na nich polegniesz:

• Cokolwiek zależy od zapamiętywania stanu przez przeglądarkę między wizytami (robią tak niektóre wtyczki do notatek) może się nie przenieść. Użyj zamiast tego własnych notatek prelegenta Prezzly. Zobacz notatki prelegenta w prezentacjach HTML.
• Bardzo szerokie albo bardzo wysokie własne motywy mogą mieć czarne pasy przy standardowym kadrze 16:9.

Zasada kciuka: otwórz hostowany link raz i przeklikaj go przed wystąpieniem. Jeśli coś wygląda nie tak, to prawie zawsze brakujący zasób w ZIP-ie, a nie sama prezentacja.

Warto też pamiętać, że Reveal działa najlepiej, gdy prezentacja jest samodzielna. Fonty pobierane z sieci, wykresy zaciągane z zewnętrznego API czy osadzone elementy zewnętrzne (mapy, widżety) mogą zachowywać się różnie w zależności od połączenia widza. Jeśli wystąpienie ma być niezawodne, dołącz fonty i zasoby do archiwum, a dane, które muszą być świeże, przygotuj tuż przed wgraniem. Statyczna, kompletna paczka to najpewniejsza droga do tego, żeby prezentacja wyglądała tak samo u Ciebie i u klienta.

Publikowanie z Cursora

Jeśli projekt Reveal już mieszka w repo, które edytujesz z agentem, pomiń ekran wgrywania w całości. Połącz się przez Model Context Protocol (MCP) i pozwól agentowi opublikować zbudowane pliki za Ciebie. MCP do prezentacji opisuje konfigurację.

Poproś agenta, żeby opublikował wynik buildu, a nie drzewo źródeł, i powiedz, że chcesz prezentację. Następnym razem, gdy zmienisz slajd, poproś, by zaktualizował tę samą prezentację, żeby link pozostał ten sam. To najszybsza pętla dla żyjącego wystąpienia: dalej edytujesz Reveal w repo, a każdy build jest o jeden prompt od bycia na żywo dla publiczności, bez ekranu wgrywania po drodze.

Prezentowanie hostowanej prezentacji Reveal

Nie musisz udostępniać ekranu laptopa z uruchomionym oknem prelegenta Reveal. Otwórz tryb prelegenta na hoście, wyślij widzom link i opcjonalnie włącz tryb na żywo, by podążali za Twoim slajdem. To ten sam przepływ co prezentować bez udostępniania ekranu.

Własne okienko widoku prelegenta Reveal to osobna rzecz. Prezzly pokazuje Ci notatki per slajd na Twoim ekranie, podczas gdy publiczność widzi samą prezentację. Możesz trzymać się dowolnego modelu myślowego, ale publiczność powinna być na hostowanym linku, a nie na kafelkowym udostępnieniu Twojego IDE.

Dla widza różnica jest odczuwalna od razu. Otwiera zwykły link, prezentacja renderuje się w pełnej rozdzielczości na jego ekranie, a nawigacja działa płynnie niezależnie od tego, jak szybkie jest Twoje łącze. Tak wygląda profesjonalna dostawa: żadnego “czy widzicie mój ekran?” na starcie i żadnego rozmytego tekstu w połowie wystąpienia.

Wersje, zasoby i pułap 10 MB

Poprawisz literówkę po próbie. Zbuduj lokalnie, wgraj ponownie do tej samej prezentacji. Widzowie z bieżącym linkiem widzą nowe pliki. Przywróć wcześniejszą wersję, jeśli “poprawka” była gorsza. Darmowy plan trzyma ostatnie 10 wersji, więc nie traktuj hosta jak nieskończonej historii git.

Jeśli motyw wygląda na pozbawiony stylów pod hostowanym adresem, zwykle zostawiłeś folder CSS albo zasobów poza archiwum. Jeśli ZIP przekracza 10 MB, zwykle wysyłasz nagrania, zależności albo nieskompresowane obrazy. Skompresuj obrazy, usuń wtyczki, których nie używasz, i spakuj tylko folder, który wdrożyłbyś na statyczny host. Dla wystąpienia, które dajesz raz, chudy build bije trzymanie przy życiu całego projektu Pages.

Najczęściej zadawane pytania (FAQ)

Czy mogę hostować prezentację Reveal.js bez GitHuba?

Tak. Spakuj zbudowany folder i wgraj go. Dostajesz adres podglądu. Repozytorium niepotrzebne.

Czy moje wtyczki Reveal dalej będą działać?

Większość tak. Cokolwiek polega na zapamiętywaniu stanu przez przeglądarkę między wizytami może nie działać. Otwórz hostowany link i przetestuj przed wystąpieniem.

Czy widzowie muszą wiedzieć, że to Reveal.js?

Nie. Otwierają link. Nie powinni instalować Reveal ani Node.

Czy mogę dalej używać slajdów w markdown Reveal?

Tak, jeśli Twój krok buildu zamienił już ten markdown w pliki HTML, które wgrywasz. Host serwuje Twoje zbudowane pliki.

Czy jest importer specyficzny dla Reveal?

Nie. Reveal to HTML. Traktuj go jak każdą inną samodzielną prezentację.

---

Masz gotowy zbudowany folder Reveal? Zhostuj prezentację Reveal.js metodą przeciągnij i upuść i wyślij link do podglądu zamiast adresu repo.