Większość narzędzi do dokumentacji eksportuje statyczny HTML. MkDocs, Sphinx, Docusaurus, Hugo, wygenerowana dokumentacja API: efektem jest samodzielny folder, zaprojektowany do działania bez połączenia. Dokładnie to jest ci potrzebne w samolocie, w piwnicy centrum danych albo u klienta, którego wifi odrzuca twojego laptopa.
Pozostaje otworzyć go na tablecie, który zabrałeś.
Dlaczego PDF nie jest odpowiedzią
Odruchem jest wyeksportowanie dokumentacji do PDF. To działa i przy krótkim dokumencie często jest właściwym wyborem. Ale dokumentacja techniczna dużo traci na konwersji.
- Znika nawigacja boczna, zastąpiona przewijaniem kilkuset stron.
- Odnośniki między sekcjami stają się w najlepszym razie odsyłaczami do stron, w najgorszym martwym tekstem.
- Kolorowanie składni i zwijane bloki kodu nie zawsze przetrwają.
- Każda aktualizacja wymusza ponowny eksport.
Tymczasem eksport HTML już istnieje i zawiera to wszystko.
Zachować dokumentację taką, jaka została wygenerowana
Pagira otwiera folder eksportu tak, jak zrobiłaby to przeglądarka: pasek boczny, odnośniki między stronami, kolorowanie kodu. Korzystasz z dokumentacji, a nie z jej fotografii.
- Skopiuj folder eksportu do Plików albo do iCloud Drive.
- Otwórz go w Pagirze.
- Poruszaj się jak po stronie: pasek narzędzi daje wstecz, dalej i odśwież.
iCloud Drive i kwestia trybu offline
Wygenerowana dokumentacja waży często kilkaset megabajtów, wraz z obrazami i czcionkami. Umieszczona w iCloud Drive, pobiera się w trakcie czytania, bez czekania przed pojawieniem się pierwszej strony.
Przed wyjazdem pobierz trwałą kopię offline. Pobieranie można wznowić, więc zerwane połączenie nie zaczyna od nowa, a baner jasno pokazuje, co pozostaje dostępne bez sieci. Zobacz strumieniowanie z iCloud Drive albo kopię offline.
Przygotować strony, których będziesz potrzebować
Jest offline, który cię zaskakuje, i offline przygotowany. Jeśli już wiesz, z których dokumentów skorzystasz, pobierz je do trybu offline przed wyjazdem, a najprzydatniejsze dodaj do ulubionych: czekają na ciebie na ekranie głównym, a każdy otwiera się na stronie, na której go zostawiłeś. Zobacz ulubione.
Przypadek dokumentacji mieszanej
Dokumentacja firmowa niemal zawsze miesza strony HTML i pliki PDF: specyfikację, schemat architektury, załącznik umowny. Jedno i drugie otwiera się w tej samej aplikacji, a odnośnik ze strony do PDF otwiera się na miejscu.
Najczęstsze pytania
A dokumentacja ważąca kilka gigabajtów?
Strumieniowanie z iCloud pozwala uniknąć pobierania wszystkiego naraz. Przy pełnym trybie offline granicą jest miejsce dostępne na urządzeniu.
Moja dokumentacja jest poufna
Nic nie jest wysyłane. Wszystko renderuje się lokalnie, co jest właśnie argumentem wobec usługi online do wyświetlania dokumentów.
Czy mogę czytać ją także na iPhonie?
Tak, jedna aplikacja obsługuje oba. Dzięki iCloud strona, na której jesteś, i twoje ulubione przechodzą z jednego urządzenia na drugie, w przypadku dokumentów przechowywanych na iCloud Drive.
Jak otworzyć ją z innego narzędzia?
Przez menu udostępniania, poleceniem Otwórz w Pagirze, z Plików albo z dowolnej aplikacji. Zobacz otwieranie zewsząd.
