NAZWA

       man2html - formatuje stronę man w html-u

SKŁADNIA

       man2html [opcje] [plik]

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       man2html  wykonuje konwersję strony podręcznika systemowego zapisanej w podanym pliku (lub
       pobieranej z stdin, w przypadku gdy nie podano nazwy pliku  lub  nazwę  "-")  z  używanego
       przez  man  formatu  nroff  na html i drukuje wynik na stdout.  Obsługuje tbl, ale nie zna
       eqn.  Kod zakończenia wynosi 0. Jeśli coś się nie powiedzie, to na stdout  drukowana  jest
       strona z komunikatem błędu.

       Może  być  wykorzystywane  jako samodzielne narzędzie, ale zasadniczo zaprojektowano je do
       zastosowań  pomocniczych,  by  umożliwić  użytkownikom  przeglądanie   stron   podręcznika
       systemowego  za  pomocą  przeglądarki  html,  takiej  jak  np.   lynx(1),  xmosaic(1)  czy
       netscape(1).

       Główną część man2html stanowi konwerter troff-na-html napisany przez  Richarda  Verhoevena
       (rcb5@win.tue.nl).  Dodaje on odnośniki hipertekstowe do następujących konstrukcji:

       foo(3x)            "http://localhost/cgi-bin/man/man2html?3x+foo"
       metoda://łańcuch   "metoda://łańcuch"
       www.nazwa.hosta    "http://www.nazwa.hosta"
       ftp.nazwa.hosta    "ftp://ftp.nazwa.hosta"
       nazwa@host         "mailto:nazwa@host"
       <string.h>         "file:/usr/include/string.h"

       (Pierwsza  z  nich może być dopasowywana do potrzeb przez opcje - zobacz niżej).  Nie jest
       wykonywane żadne wyszukiwanie - obiekty wskazywane  przez  tworzone  odnośniki  nie  muszą
       istnieć.   Tworzony  jest  też  indeks  wewnętrznych odnośników hipertekstowych do różnych
       sekcji strony, co ułatwia orientację w dużych stronach jak bash(1).

OPCJE

       Przy odczycie z stdin nie zawsze jest jasne, jak wykonać rozwinięcie żądania .so. Opcja -D
       pozwala skryptowi na zdefiniowanie katalogu roboczego.

       -D ścieżka
              Przed rozpoczęciem konwersji obcina ostatnie dwie części ścieżki i w odniesieniu do
              pozostałej części wykonuje chdir(dir).

       Opcja -E umożliwia skryptowi cgi łatwe tworzenie komunikatów o błędach.

       -E łańcuch
              Tworzy w wyniku stronę zawierającą zadany komunikat o błędzie.

       Ogólną postacią odnośnika hipertekstowego generowanego dla odsyłacza strony man jest

              <metoda:ścieżkacgi><ścieżkaman2html><separator><stronaman>

       z wartością domyślną pokazaną powyżej. Składowe tego odnośnika ustawiane  są  przy  pomocy
       różnych opcji.

       -h     Ustawia metoda:ścieżkacgi na http://localhost. Jest to ustawienie domyślne.

       -HP host[.domena][:port]
              Ustawia metoda:ścieżkacgi na http://host.domena:port.

       -l     Ustawia metoda:ścieżkacgi na lynxcgi:/home/httpd.

       -L katalog
              Ustawia metoda:ścieżkacgi na lynxcgi:katalog.

       -M ścieżkaman2html
              Ustawia   ścieżkę   man2html,   jaka   ma   być  użyta.  Domyślnie  jest  to  /cgi-
              bin/man/man2html.

       -p     Ustawia separator na '/'.

       -q     Ustawia separator na '?'. Jest to separator domyślny.

       -r     Używa relatywnych ścieżek html, zamiast ścieżek typu cgi-bin.

       Na maszynach, na których nie jest uruchomiony  httpd,  można  do  przeglądania  stron  man
       używać  przeglądarki  lynx, wykorzystując metodę lynxcgi. Jeżeli pracuje jakiś demon http,
       do przeglądania można użyć lynx-a, czy  jakiejkolwiek  innej  przeglądarki,  wykorzystując
       metodę http. Opcja -l (oznaczająca `lynxcgi') wybiera pierwsze z opisanych zachowań.  Przy
       jej zastosowaniu domyślną ścieżką cgi jest /home/httpd.

       Ogólnie skrypt cgi wywołuje się przez

              <ścieżka_do_skryptu>/<dalej_ścieżka>?<zapytanie>

       a zmiennym środowiska PATH_INFO i QUERY_STRING zostaną przypisane  wartości,  odpowiednio,
       <dalej_ścieżka>  i <zapytanie>. Ponieważ lynxcgi nie obsługuje części PATH_INFO, domyślnie
       tworzymy odnośniki z '?' jako  separatorem.   Opcja  -p  (`path'  -  ścieżka)  wybiera  za
       separator znak ukośnika '/', zaś -q (`query' - zapytanie) znak zapytania '?'.

       Opcja  -H  host  określa  nazwę hosta, jaki ma być używany (zamiast localhost). Skrypt cgi
       może wykorzystać konstrukcję

              man2html -H $SERVER_NAME

       jeśli ustawiona jest zmienna SERVER_NAME. Dzięki temu maszyna może działać jako  serwer  i
       eksportować strony man.

BŁĘDY

       Wiele  rzeczy  jest  zrobionych  heurystycznie. Wynik nie zawsze będzie doskonały.  Metoda
       lynxcgi nie zadziała, jeżeli lynx został skompilowany bez jej obsługi.  Mogą być  problemy
       z bezpieczeństwem.

ZOBACZ TAKŻE

       lynx(1), man(1)

INFORMACJE O TŁUMACZENIU

       Powyższe  tłumaczenie  pochodzi  z nieistniejącego już Projektu Tłumaczenia Manuali i może
       nie być aktualne. W  razie  zauważenia  różnic  między  powyższym  opisem  a  rzeczywistym
       zachowaniem  opisywanego  programu  lub  funkcji,  prosimy  o  zapoznanie się z oryginalną
       (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 1 man2html

       Prosimy o pomoc w aktualizacji stron man - więcej informacji  można  znaleźć  pod  adresem
       http://sourceforge.net/projects/manpages-pl/.

                                         1 stycznia 1998                              man2html(1)