Kullanım
pod2html --help --htmldir=<name> --htmlroot=<URL>
--infile=<name> --outfile=<name>
--podpath=<name>:...:<name> --podroot=<name>
--cachedir=<name> --flush --recurse --norecurse
--quiet --noquiet --verbose --noverbose
--index --noindex --backlink --nobacklink
--header --noheader --poderrors --nopoderrors
--css=<URL> --title=<name>
Açıklama
Dosyaları pod biçiminden (bkz. perlpod) HTML biçimine dönüştürür.
Argümanlar
pod2html aşağıdaki argümanları alır:
help --help
Kullanım mesajını görüntüler.
htmldir --htmldir=name
Elde edilen HTML dosyasındaki tüm çapraz referansların (cross references) göreli (relative) olacağı dizini ayarlar. Bunun geçirilmemesi, tüm bağlantıların mutlak (absolute) olmasına neden olur çünkü bu değer, Pod::Html modülüne belgelendirme ağacının kök dizinini bildiren değerdir.
Aynı pod2html çağrısında bunu ve --htmlroot seçeneğini birlikte kullanmayın; bunlar birbirini dışlar (mutually exclusive).
htmlroot --htmlroot=URL
HTML dosyaları için temel URL'yi ayarlar. Çapraz referanslar yapıldığında, HTML kök dizini (HTML root) URL'nin başına eklenir.
Göreli bağlantılar isteniyorsa bunu kullanmayın: bunun yerine --htmldir kullanın.
pod2html'e hem bunu hem de --htmldir seçeneğini birlikte geçirmeyin; bunlar birbirini dışlar.
infile --infile=name
Dönüştürülecek pod dosyasını belirtir. Herhangi bir infile belirtilmezse girdi STDIN'den alınır.
outfile --outfile=name
Oluşturulacak HTML dosyasını belirtir. Herhangi bir outfile belirtilmezse çıktı STDOUT'a gider.
podroot --podroot=name
Kütüphane pod'larını bulmak için temel dizini belirtir.
podpath --podpath=name:...:name
podroot'un hangi alt dizinlerinin, HTML'e dönüştürülmüş biçimlerine çapraz referanslarda bağlantı verilebilecek pod dosyalarını içerdiğini belirtir.
cachedir --cachedir=name
Önbelleği depolamak için hangi dizinin kullanılacağını belirtir. Varsayılan dizin geçerli çalışma dizinidir.
flush --flush
Önbelleği temizler (flush).
backlink --backlink
=head1 yönergelerini, HTML dosyasının en üstünü işaret eden bağlantılara (links) dönüştürür.
nobacklink --nobacklink
=head1 yönergelerini HTML dosyasının en üstünü işaret eden bağlantılara dönüştürmez (varsayılan davranış).
header --header
"NAME" bölümünün metnini içeren üstbilgi (header) ve altbilgi (footer) blokları oluşturur.
noheader --noheader
"NAME" bölümünün metnini içeren üstbilgi ve altbilgi blokları oluşturmaz (varsayılan davranış).
poderrors --poderrors
infile dosyasında herhangi bir POD hatası varsa, outfile dosyasında bir "POD ERRORS" bölümü içerir (varsayılan davranış).
nopoderrors --nopoderrors
infile dosyasında POD hataları olsa bile outfile dosyasında bir "POD ERRORS" bölümü içermez.
index --index
HTML dosyasının en üstünde bir dizin (index) oluşturur (varsayılan davranış).
noindex --noindex
HTML dosyasının en üstünde bir dizin oluşturmaz.
recurse --recurse
podpath içinde belirtilen alt dizinlerin içine özyinelemeli (recurse) olarak girer (varsayılan davranış).
norecurse --norecurse
podpath içinde belirtilen alt dizinlerin içine özyinelemeli olarak girmez.
css --css=URL
Elde edilen HTML dosyasından bağlantı verilecek basamaklı stil şablonunun (CSS) URL'sini belirtir. Varsayılan olarak stil şablonu yoktur.
title --title=title
Elde edilen HTML dosyasının başlığını belirtir.
quiet --quiet
Çoğunlukla zararsız olan uyarı mesajlarını görüntülemez.
noquiet --noquiet
Çoğunlukla zararsız olan uyarı mesajlarını görüntüler (varsayılan davranış). Ancak bu "verbose" (ayrıntılı) moduyla aynı değildir.
verbose --verbose
İlerleme mesajlarını görüntüler.
noverbose --noverbose
İlerleme mesajlarını görüntülemez (varsayılan davranış).
Yazar
Tom Christiansen, tchrist@perl.com.
Hatalar
Dönüştürücüdeki bilinen hataların bir listesi için bkz. Pod::Html.
Ayrıca Bakınız
perlpod, Pod::Html
Telif Hakkı
Bu program Artistic License kapsamında dağıtılmaktadır.
perl v5.34.1 2026-02-21 POD2HTML(1)