code2html - Online w chmurze

PROGRAM:

IMIĘ

code2html - Konwertuje kod źródłowy programu do formatu HTML

STRESZCZENIE

(1) kod2html [Opcje] [plik-wejściowy [plik wyjściowy]]

(2) kod2html -p [filet [alternatywny plik wyjściowy]]

(3) kod2html (jako skrypt CGI; zobacz sekcję nt CGI)

OPIS

kod2html to skrypt Perla, który konwertuje kod źródłowy programu do podświetlonej składni
HTML lub dowolny inny format, w którym zdefiniowano reguły.

(1) OPCJE
plik-wejściowy
Jest to plik zawierający kod źródłowy programu, który ma zostać sformatowany. Jeśli nie
lub podany zostanie minus (-), kod zostanie odczytany ze STDIN.

plik wyjściowy
Jest plikiem, w którym ma zostać zapisany sformatowany kod. Jeśli nie określono lub minus (-) jest
podany, kod zostanie zapisany na STDOUT.

-l, --tryb-językowy
Określ zestaw wyrażeń regularnych, który ma zostać użyty. Należy je zdefiniować w a
plik językowy (patrz AKTA poniżej). Aby dowiedzieć się, jakie tryby językowe są zdefiniowane,
wydanie a kod2html --tryby.

W danych wejściowych nie jest uwzględniana wielkość liter.

Jeśli nie zostanie podany, do określenia języka pliku zostanie zastosowana heurystyka.

-v, --gadatliwy
Drukuje informacje o postępie do STDERR.

-n, --Numery linii
Wydrukuj kod źródłowy z numerami linii.

-N, --numery linków
Wydrukuj kod źródłowy z numerami linii. Numery bielizny będą prowadzić do
siebie, co ułatwia wysyłanie linków do linii.

-P, prefix
Opcjonalny przedrostek do użycia w przypadku kotwic numerów linii.

-t, --zastąp-tabulacje[=SZEROKOŚĆ WYŁĄCZNIKA]
Zastąp każde wystąpienie a znak z odpowiednią ilością spacji do zdobycia
do następnego tabulatora. Domyślnie szerokość tabulatora wynosi 8 znaków.

-L, --plik-językowy=PLIK JĘZYKOWY
Określ alternatywny plik, z którego mają zostać pobrane definicje języka i formatu wyjściowego
(patrz rozdział o AKTA poniżej).

-m, --tryby
Wydrukuj wszystkie tryby językowe i formaty wyjściowe aktualnie zdefiniowane na STDOUT i wyjdź
pomyślnie. Drukuje również tryby z pliku a PLIK JĘZYKOWY podany przez --plik-językowy if
odpowiedni.

--powrót=JĘZYK
Jeśli tryb językowy podany w --tryb-językowy nie można znaleźć, użyj tego
tryb.

--powrót zwykły na przykład jest przydatny, gdy kod2html jest wywoływany ze skryptu do
upewnij się, że dane wyjściowe zostały utworzone.

-h, --help
Wydrukuj krótką pomoc i pomyślnie wyjdź.

-V, --wersja
Wydrukuj wersję programu i pomyślnie wyjdź.

-c, --Typ zawartości
Drukuje „Typ zawartości: tekst/html\n\n” (lub cokolwiek innego, co format wyjściowy definiuje jako
typ zawartości) przed resztą danych wyjściowych. Przydatne, jeśli skrypt zostanie wywołany jako
skrypt CGI.

-o, --format wyjściowy
Wybiera format wyjściowy. HTML jest domyślny. Aby dowiedzieć się, które formaty wyjściowe
są zdefiniowane, wyślij a kod2html --tryby.

-H, --brak nagłówka
nie używaj szablonu zdefiniowanego przez format wyjściowy. W przypadku HTML oznacza to
że nie będzie , , i nie
tagi.

--szablon=FILE
zastępuje domyślny szablon dla danego formatu wyjściowego. Jeśli --brak nagłówka is
biorąc pod uwagę, nie ma to znaczenia, ponieważ szablon i tak jest ignorowany.

-T, --tytuł
Ustaw tytuł utworzonego pliku wyjściowego. Działa tylko wtedy, gdy szablon to robi
wsparcie w ustawianiu tytułu.

-w, --szerokość linii=SZEROKOŚĆ LINII
Zawiń linie po SZEROKOŚĆ LINII postacie. Domyślnie w ogóle nie zawija się linii.

-b, --prefiks podziału linii=PREFIKS LINII
Zastosowanie FILINEPREFIX na początku zawijanych linii. Wartość domyślna to „»”.

(2) HTML łatanie
kod2html -p [filet [alternatywny plik wyjściowy]]

kod2html pozwala także na posiadanie wbudowanego kodu źródłowego w pliku HTML. Może wtedy zająć
ten plik HTML i wstaw wyróżniony kod składni.

Jeśli nie zostanie podany żaden plik, kod2html czyta ze STDIN i zapisuje do STDOUT. Jeśli jest tylko jeden plik
biorąc pod uwagę, że zastępuje ten plik danymi wyjściowymi. Jeśli dostarczone są dwa pliki, pierwszy jest
czytać z, a drugi zapisywać do.

Aby skorzystać z tej funkcji, po prostu wstaw podobny plik do swojego pliku HTML:

-->

plik z zaznaczoną składnią zostanie wstawiony w tej pozycji zawartej w tagi.

Wszystkie opcje, które można podać w wierszu poleceń, np --Numery linii itp. praca. --help,
--wersjaitp. też działają, jednak używanie ich nie jest zbyt inteligentne :). Za pomocą
--format wyjściowy nie zaleca się wybierania formatu wyjściowego innego niż HTML. --Typ zawartości is
ignorowane.

Możesz także zapisać kod źródłowy programu bezpośrednio w pliku HTML, korzystając z poniższych instrukcji
składnia:

<!-- code2html dodaj [opcje]



->

Zazwyczaj dobrym pomysłem jest przynajmniej dać --tryb-językowy możliwość określenia
język.

(3) CGI
Jeśli skrypt jest używany jako skrypt CGI (BRAMA_INTERFACE zestaw środowiska i nie
podane argumenty wiersza poleceń) kod2html odczytuje argumenty z ciągu zapytania
lub z SDTIN. (metody POST i GET).

--Typ zawartości jest włączane automatycznie, a wyjście zawsze przechodzi w stan STDOUT.

Akceptowane są następujące parametry/opcje:

tryb językowy - opcjonalny
„c”, „cc”, „pas” itp.

jeśli nie jest podany, do ustalenia języka stosuje się pewne heurystyki.

awaryjna - opcjonalny
`plain', `c' itp., jeśli nie można znaleźć trybu językowego, użyj tego

selektor wejść - opcjonalny
albo `plik', `cgi-input1', `cgi-input2', albo `REDIRECT_URL'

domyślnie: plik

filename
plik do odczytania, jeśli selektor wejść to „plik”

wejście cgi1
Kod źródłowy do podświetlania składni. Na przykład z A lub z
wgrywać. Widzieć selektor wejść.

wejście cgi2
Kod źródłowy do podświetlania składni. Na przykład z A lub z
wgrywać. Widzieć selektor wejść.

Numery linii - opcjonalny
„tak”, „nie” lub „link”

domyślnie: nie

zamień karty - opcjonalny
Jeśli 0, tabulatory nie są zastępowane, w przeciwnym razie zastąp każde wystąpienie a postać
z odpowiednią ilością spacji, aby przejść do następnego tabulatora.

domyślnie: 0

tytuł - opcjonalny
Ustaw tytuł pliku.

bez kodowania - opcjonalny
Domyślnie kod2html próbuje zakodować dane wyjściowe jako albo bz2/gz/Z jeśli klient
popiera to (HTTP_ACCEPT_ENKODOWANIE), a potrzebny program jest dostępny na stronie
serwer. Być może konieczna będzie modyfikacja @CGI_ENKODOWANIE w skrypcie, aby pasował do Twojego programu
lokalizacje.

If bez kodowania jest zdefiniowany jako „prawdziwy” kod2html nie próbuje kodować danych wyjściowych.

Dlaczego możesz zapytać o dwa wejścia CGI: Ma to na celu umożliwienie użytkownikom wyboru poprzez a
interfejs, czy chcą wstawić swój plik do pliku lub użyj <przeglądaj>
przycisk, aby wybrać plik. Zobacz przykład na mojej stronie głównej.

Zauważ, że jeśli $FILES_DISALLOWED_IN_CGI wynosi 0, Twoi użytkownicy mogą przeczytać wszystkie
pliki, które httpd może odczytać (jeśli nie uruchomisz opakowania cgi lub czegoś podobnego. By
domyślnie ta wartość jest ustawiona na 1, więc odczyt plików poprzez cgi nie powinien być dozwolony. Możesz
zezwól na to z ustawieniem $FILES_DISALLOWED_IN_CGI na 0 na górze skryptu.

Selektor wejść REDIRECT_URL wymaga specjalnego wyjaśnienia. Nazwa pliku jest utworzona z
dwie zmienne środowiskowe DOCUMENT_ROOT i REDIRECT_URL.

Jeśli chcesz, aby Apache automatycznie wywoływał kod2html dla wszystkich plików kodu źródłowego programu
możesz to zrobić, dodając te dwie linie do pliku srm.conf:

AddHandler tekst/kod-źródłowy x .c .cc .cpp .pas .h .p

Akcja tekst/x-sourcecode /cgi-bin/code2html?input-selector=REDIRECT_URL&foo=

lub coś podobnego do tego. W linii AddHandle możesz wybrać, do których rozszerzeń chcesz
Przejść przez kod2html.

OSTRZEŻENIE: Nie dodawaj .pl do tej linii i nadaj temu skryptowi nazwę „code2html.pl”. To spowoduje
w pętli.

Upewnij się także, że załadowałeś moduł Action (srm.conf).

Zamień /cgi-bin/code2html na wirtualną lokalizację, pod którą można uzyskać dostęp do pliku.
Zwróć uwagę na część „foo=”. Apache dołącza adres URL pliku, który będzie wyświetlany na końcu
część akcji. Nie potrzebujemy tego, ponieważ używamy zmiennej środowiskowej REDIRECT_URL
jednakże nie chcemy, aby adres URL został dodany do ciągu selektora wejściowego. Dlatego my
dołącz część „&foo=”.

Pozdrowienia dla Kevina Burtona[email chroniony]> za pomysł. On również to stwierdza

> Jest potężniejszy, jeśli użyjesz go w Apache
> etykietka
>
>
>
> #tutaj ze swoim tagiem akcji... w ten sposób możesz
> #nadal masz na swoim serwerze zwykłe pliki .java.
>
>
>

PRZYKŁAD

zarozumiały kod2html znajduje się w bieżącym katalogu, możesz wpisać

kod2html -l perl kod2html.pl kod2html.html

aby przekonwertować skrypt na plik HTML.

Użyj code2html online, korzystając z usług onworks.net