Do dokumentowania kodu korzystam z narzędzia o nazwie doxygen . Stworzyło to folder .htmlplików, plików .jsjavascript i plików .pnggraficznych oraz tworzy naprawdę ładną dokumentację opartą na przeglądarce, uruchamiając index.htmlw tym folderze.
Jednak nie jest bardzo przyjazny dla użytkownika - ponieważ użytkownik musi znaleźć index.htmlw pliku z setkami innych. Próbowałem połączyć je wszystkie w jeden .htmlza pomocą różnych narzędzi online, takich jak HTMLDOC, z których żadne nie działało.
Zastanawiałem się: a) jeżeli istnieje sposób łączenia tej kolekcji html, .jsa .pngpliki w jednym pliku lub b) jeżeli nie, czy istnieje sposób na stworzenie swego rodzaju „pakiet”, który ukrywa pliki bazowe i uruchamia indeks strona po kliknięciu? Ostatecznie chcę to zrobić, aby użytkownik mógł kliknąć pojedynczy plik / pakiet zwany „dokumentacją”, zamiast przeglądać ogromną listę!
Dziękuję bardzo,
David
Odpowiedzi:
Niestety istnieje kilka konkurencyjnych formatów „archiwum internetowego” i nie znam żadnych obsługiwanych przez wszystkie przeglądarki.
źródło