t2html - Dalam talian dalam Awan

JADUAL:

NAMA

t2html - Penukar teks ringkas ke HTML. Bergantung pada peraturan lekukan teks.

SINOPSIS

t2html [pilihan] file.txt > file.html

DESCRIPTION

Tukar fail teks tulen kepada halaman HTML yang kelihatan cantik, mungkin berbingkai. Contoh daripada
penukaran:

1. Kod sumber teks biasa
http://pm-doc.git.sourceforge.net/git/gitweb.cgi?p=pm-doc/pm-doc;a=blob_plain;f=doc/index.txt;hb=HEAD

2. usul semula penukaran dengan pilihan --css-file tersuai:
http://pm-doc.sourceforge.net/pm-tips.html
http://pm-doc.sourceforge.net/pm-tips.css

3. Mod Emacs tinytf.el untuk menulis fail teks (pilihan)
https://savannah.nongnu.org/projects/emacs-tiny-tools

Keperluan Jawatan khususnya yang input ASCII fail

Fail mesti ditulis dalam Format Teknikal, yang susun aturnya diterangkan dalam ini
manual. Pada asasnya idea itu mudah dan hanya terdapat dua peringkat tajuk: satu di lajur 0
dan satu lagi di lajur 4 (pertengahan antara lebar tab). Teks standard bermula pada lajur
8 (kedudukan selepas kekunci tab ditekan).

Idea format teknikal ialah setiap lajur mewakili reka letak pemaparan yang berbeza dalam
HTML yang dihasilkan. Tiada penanda khas diperlukan dalam fail teks, jadi anda boleh menggunakan
versi teks sebagai salinan induk Soalan Lazim dsb. Bulet, senarai bernombor, penekanan perkataan dan
petikan dan lain-lain boleh dinyatakan secara semula jadi.

HTML Penerangan

HTML yang dijana termasuk Lembaran Gaya Cascading 2 (CSS2) dan sekeping kecil
kod Java. CSS2 digunakan untuk mewarnakan loyout halaman dan untuk menentukan percetakan yang sesuai
saiz fon. HTML yang dihasilkan juga mengambil pendekatan untuk menyokong XHTML. Lihat halaman
http://www.w3.org/TR/xhtml1/#garis panduan di mana pengesyoran keserasian ke belakang
digariskan:

HTML sah XHTML memerlukan
..



XHTML tidak menyokong pengecam serpihan #foo, dengan elemen "nama", tetapi menggunakan "id"
sebaliknya. Untuk keserasian ke belakang kedua-dua elemen ditakrifkan:

< ..name="tag"> Kini <.. name="tag" id="tag">

NOTA: Program ini tidak pernah direka untuk digunakan untuk XHTML dan kesahihan XHTML yang ketat
tidak boleh diharapkan.

Motivasi

Format paling mudah untuk menulis dokumen besar, seperti Soalan Lazim, ialah teks. Fail teks menawarkan
Penyuntingan WysiWyg dan ia boleh ditukar dengan mudah ke dalam format HTML. Fail teks adalah mudah
dikekalkan dan tiada keperluan untuk penyunting teks khas. Mana-mana editor teks seperti
notepad, vi, Emacs boleh digunakan untuk menyelenggara dokumen.

Fail teks juga merupakan satu-satunya format yang wajar jika dokumen disimpan di bawah kawalan versi
seperti RCS, CVS, SVN, Arch, Perforce, ClearCase. Mereka boleh dibandingkan dengan diff dan
patch boleh diterima dengan mudah dan dihantar kepada mereka.

Untuk membantu mengekalkan dokumen yang besar, terdapat juga disediakan Emacs mod kecil, pakej
dipanggil tinytf.el, yang menawarkan fonifikasi teks dengan warna, kawalan Indentasi, peluru
pengisian, penomboran semula tajuk, penanda perkataan, penonjolan sintaks dsb. Lihat projek
http://freshmeat.net/projects/emacs-tiny-tools

PILIHAN

HTML: Header and Footer pilihan
--seadanya
Sebarang pemformatan HTML tambahan atau manipulasi teks ditindas. Teks dipelihara seperti itu
muncul dalam fail. Gunakan pilihan ini jika anda merancang untuk menghantar atau dan mencetak teks seperti yang dilihat.

o Jika fail mengandungi "Jadual Kandungan" ia tidak dialih keluar
o Blok Jadual Kandungan tidak dibuat (biasanya)

--pengarang -a STR
Pengarang dokumen cth --pengarang "John Doe"

--fail-penafian FAIL
Teks yang muncul pada pengaki dibaca daripada fail ini. Jika tidak diberi lalai
teks hak cipta ditambah. Pilihan "--quiet" dan "--simple" menyekat penafian.

--dokumen FAIL
Nama dokumen atau nama fail. Anda boleh menyenaraikan semua URL alternatif kepada dokumen
dengan pilihan ini.

--e-mel -e EMAIL
Alamat hubungan pengarang dokumen. Mestilah alamat e-mel tulen dengan no
"<" dan ">" aksara disertakan. Cth. --e-mel [e-mel dilindungi]

--e-mel"[e-mel dilindungi]> "SALAH
--e-mel"[e-mel dilindungi]"betul

--mudah -s
Cetak pengaki minimum sahaja: kenalan, e-mel dan tarikh. Gunakan "--quiet" sepenuhnya
buang pengaki.

--t2html-tags
Benarkan pemprosesan terbenam #T2HTML- arahan di dalam fail. Lihat penjelasan penuh
dengan membaca topik "Arahan TERBEAM DALAM TEKS". Secara lalai, anda tidak perlu melakukannya
bekalkan pilihan ini - ia "dihidupkan" secara lalai.

Untuk mengabaikan arahan terbenam dalam fail teks, berikan pilihan "tidak": --not2html-tags.

--tajuk STR -t STR
Teks tajuk yang muncul dalam bingkai atas penyemak imbas.

--url URL

Lokasi fail HTML. Bila --dokumen memberikan nama, ini memberikan lokasi. ini
maklumat dicetak di Footer.

HTML: navigation url
--dasar URL
Lokasi URL fail HTML dalam destinasi tapak di mana ia akan diletakkan tersedia.
Pilihan ini diperlukan hanya jika dokumen dihoskan pada pelayan FTP (jarang, tetapi
mungkin). Dokumen berasaskan pelayan FTP tidak boleh menggunakan pautan Jadual Kandungan (serpihan
#tag pengecam) melainkan tag HTML BASE juga ditakrifkan.

Hujah boleh menjadi URL penuh kepada dokumen:

--dasar ftp://ftp.example.com/file.html
--dasar ftp://ftp.example.com/

--butang-tajuk-atas
Tambah tambahan [Toc] butang navigasi ke hujung setiap tajuk. Ini mungkin berguna
dalam fail HTML tidak berbingkai panjang.

--butang-atas URL
Butang diletakkan di bahagian atas dokumen mengikut urutan: [sebelumnya][atas][seterusnya] dan
--butang-* pilihan menentukan URL.

Jika URL ialah rentetan tiada maka tiada butang dimasukkan. Ini mungkin berguna jika butangnya
ditakrifkan oleh program berasingan. Dan contoh menggunakan Perl:

#!/usr/bin/perl

my $top = "index.html"; # tetapkan lalai
my $prev = "tiada";
my $next = "tiada";

# ... di suatu tempat $prev atau $next mungkin ditetapkan, atau kemudian tidak

qx(t2html --button-top "$top" --button-prev "$prev" --button-next "$next" ...);

# Tamat program sampel

--butang-sebelumnya URL
URL untuk pergi ke dokumen atau rentetan sebelumnya tiada.

--butang-seterusnya URL
URL untuk pergi ke dokumen atau rentetan seterusnya tiada.

--rujukan tag=nilai
Anda boleh menambah sebarang rujukan tersuai (teg) di dalam teks dan menjadikannya berkembang kepada sebarang nilai.
Pilihan ini boleh diberikan beberapa kali dan setiap kejadian TAG digantikan dengan
NILAI. Cth apabila diberi pilihan berikut:

--rujukan "#HOME-URL=http://www.example.com/dir"
--rujukan "#ARCHIVE-URL=http://www.example.com/dir/dir2"

Apabila dirujuk dalam teks, HTML yang dijana termasuk diperluaskan kepada nilai. An
contoh teks:

Halaman utama ialah #HOME-URL/page.html dan halaman cerminnya
#ARCHIVE-URL/page.html di mana anda boleh mencari versi terkini.

-R, --rujukan-pemisah TALI
Lihat di atas. Rentetan yang digunakan untuk memisahkan TAG dan VALUE. Lalai ialah tanda sama "=".

-T, --toc-url-print
URL paparan (dibina daripada tajuk) yang membina Jadual Kandungan (NAME
tag AHREF) dalam dokumen. Senarai itu dikeluarkan kepada stderr, supaya ia boleh
dipisahkan:

% t2html --toc-url-print tmp.txt > file.html 2> toc-list.txt

Di manakah anda memerlukan ini? Jika anda ingin mengetahui serpihan yang dikenal pasti untuk fail anda,
anda memerlukan senarai nama.

http://www.example.com/myfile.html#pengecam serpihan

HTML: Mengawal CSS generasi (HTML meja)
--css-code-bg
Pilihan ini mempengaruhi cara bahagian kod (lajur 12) dipaparkan. Biasanya bahagian
dikelilingi dengan a .. kod, tetapi dengan pilihan ini, sesuatu yang lebih
fancier digunakan. Kod itu dibalut di dalam a ... dan latar belakang
warna ditetapkan kepada warna kelabu.

--css-code-note "REGEXP"
Lebih Baik --css-code-bg diperlukan untuk mengaktifkan pilihan ini. Perkataan khas yang ditakrifkan menggunakan
regexp (lalai ialah 'Nota:') akan menandakan bahagian kod secara khusus. "Perkataan pertama" ialah
dipadankan dengan Perl regexp yang dibekalkan.

Regexp yang dibekalkan tidak boleh, berulang, tidak boleh, termasuk mana-mana pengendali kumpulan yang sepadan.
Ini bermakna, kurungan kumpulan seperti "(satu|dua|tiga)" tidak dibenarkan.
Anda mesti menggunakan Perl bukan kumpulan seperti "(?:satu|dua|tiga)". Sila rujuk perl
halaman manual [perlre] jika pengenalan ringkas ini tidak memberikan tali yang mencukupi.

Dengan pilihan ini, bukannya memaparkan lajur 12 teks dengan .. , teks
muncul seperti teks biasa, tetapi dengan kelainan. Warna latar belakang teks mempunyai
telah ditukar kepada kelabu yang lebih gelap untuk menonjol secara visual daripada teks.

Satu contoh akan menjelaskan. Katakan anda lulus pilihan --css-code-bg and
--css-code-note='(?:Notis|Nota):', yang mengarahkan untuk merawat perenggan pertama di
lajur 12 secara berbeza. seperti ini:

Ini ialah teks biasa yang muncul di suatu tempat di lajur 8.
Ia mungkin mengandungi beberapa baris teks dalam perenggan ini.

Notis: Berikut ialah bahagian khas, di lajur 12,
dan perkataan pertama dalam perenggan ini ialah 'Notis:'.
Hanya itu yang menjadikan perenggan ini di lajur 12 istimewa.

Sekarang, kami mempunyai beberapa kod untuk ditunjukkan kepada pengguna:

untuk ( i = 0; i++; i < 10 )
{
// Melakukan sesuatu dalam gelung ini
}

Satu nota, teks yang ditulis dengan perkataan khas awal, seperti "Notis:", semuanya mesti dimuatkan dalam satu
pragraf penuh. Mana-mana perenggan lain yang mengikuti, diberikan sebagai bahagian kod. Suka
di sini:

Ini ialah teks biasa yang muncul di suatu tempat
Ia mungkin mengandungi beberapa baris teks dalam perenggan ini

Notis: Berikut ialah bahagian khas, di lajur 12,
dan perkataan pertama dalam perenggan ini ialah 'Notis:'
yang menjadikannya istimewa

Bagaimanapun, perenggan ini TIDAK diberikan secara khusus
apa-apa lagi. Hanya perenggan pertama di atas.

untuk ( i = 0; i++; i < 10 )
{
// Melakukan sesuatu dalam gelung ini
}

Seolah-olah ini tidak mencukupi, terdapat beberapa arahan kawalan jadual khas yang membenarkan
anda mengawal .. yang diletakkan di sekeliling bahagian kod di lajur 12.
Berikut adalah beberapa contoh:

Berikut adalah contoh 1

#t2html::td:bgcolor=#F7F7DE

untuk ( i = 0; i++; i < 10 )
{
// Melakukan sesuatu dalam gelung ini
}

Berikut adalah contoh 2

#t2html::td:bgcolor=#F7F7DE:tableborder:1

untuk ( i = 0; i++; i < 10 )
{
// Melakukan sesuatu dalam gelung ini
}

Berikut adalah contoh 3

#t2html::td:bgcolor="#FFFFFF":tableclass:dashed

untuk ( i = 0; i++; i < 10 )
{
// Melakukan sesuatu dalam gelung ini
}

Berikut adalah contoh 4

#t2html::td:bgcolor="#FFFFFF":table:border=1_width=94%_border=0_cellpadding="10"_cellspacing="0"

untuk ( i = 0; i++; i < 10 )
{
// Melakukan sesuatu dalam gelung ini
}

Nampak samar? Tidak boleh membantu itu dan agar anda memahami sepenuhnya apa
arahan ini lakukan, anda perlu memahami elemen yang boleh ditambah pada
dan token. Rujuk spesifikasi HTML untuk atribut yang tersedia. Di sini
taklimat apa yang boleh anda lakukan:

Perintah mula ialah:

#t2html::
|
Selepas ini muncul pasangan atribut dalam form key:value
dan berbilang sebagai key1:value1:key2:value2 ...

Pasangan "key:value" boleh menjadi:

td:ATRIBUT
|
Ini ditukar menjadi

jadual:ATRIBUTES
|
Ini ditukar menjadi

Tidak boleh ada ruang dalam ATRIBUTES, kerana "Perkataan pertama" mestilah satu
perkataan bersebelahan. Garis bawah boleh digunakan sebagai ganti ruang:

table:border=1_width=94%
|
Ditafsirkan sebagai

Ia juga mungkin untuk menukar gaya CLASS lalai dengan perkataan "tableclass". mengikut tertib
CLASS untuk berguna, takrifan CSSnya mestilah sama ada dalam lalai
konfigurasi atau dibekalkan daripada fail luaran. Lihat pilihan --skrip-fail.

tableclass:nama
|
Ditafsirkan sebagai

Sebagai contoh, terdapat beberapa gaya lalai yang boleh digunakan:

1) Berikut ialah contoh "putus-putus" CLASS

#t2html::tableclass:dashed

untuk ( i = 0; i++; i < 10 )
{
// Melakukan sesuatu dalam gelung ini
}

2) Berikut ialah contoh "pepejal" CLASS:

#t2html::tableclass:solid

untuk ( i = 0; i++; i < 10 )
{
// Melakukan sesuatu dalam gelung ini
}

Anda boleh menukar sebarang nilai individu bagi definisi jadual lalai iaitu:



Untuk menukar contohnya hanya padding sel nilai, anda akan berkata:

#t2html::table:tablecellpadding:2

Jika anda tidak pasti tentang semua ini, hanya jalankan program dengannya --halaman ujian
dan lihat sumber dan fail HTML yang dihasilkan. Itu sepatutnya menawarkan lebih banyak tali kepada
bereksperimen dengan.

--css-file FAIL
Sertakan yang merujuk kepada sumber definisi gaya CSS luaran. Pilihan ini
diabaikan jika --skrip-fail pilihan telah diberikan, kerana pilihan itu mengimport keseluruhan
kandungan di dalam teg HEAD. Pilihan ini boleh muncul beberapa kali dan CSS luaran
fail ditambah dalam susunan yang disenaraikan.

--css-font-type DEFINISI CSS
Tetapkan definisi fon elemen BODY kepada CSS-DEFINITION. Nilai lalai yang digunakan ialah
set taip biasa yang digunakan dalam surat khabar dan buku:

--css-font-type='font-family: "Times New Roman", serif;'

--css-font-size DEFINISI CSS
Tetapkan saiz fon elemen badan kepada CSS-DEFINITION. Saiz fon lalai dinyatakan
dalam mata:

--css-font-size="font-size: 12pt;"

HTML: Mengawal yang badan of dokumen
--padam REGEXP
Padamkan baris yang sepadan dengan perl REGEXP. Ini berguna jika anda menggunakan beberapa alat dokumen yang
menggunakan tag navigasi dalam fail teks yang anda tidak mahu muncul dalam dihasilkan
HTML

--delete-email-headers
Padamkan pengepala e-mel pada permulaan fail, sehingga baris kosong pertama yang memulakan
badan. Jika anda menyimpan dokumen anda sedia untuk siaran berita Usenet, ia mungkin mengandungi
tajuk dan badan:

Daripada:...
Kumpulan berita: ...
Maklumat-Penghantar X:
Ringkasan:

BADAN-DARI-TEKS

--nodelete-default
Gunakan pilihan ini untuk menyekat pemadaman teks lalai (yang dihidupkan).

Pakej Emacs "folding.el" dan vi boleh digunakan dengan mana-mana teks atau bahasa pengaturcaraan untuk
letak bahagian teks antara tag {{{ and }}}. Anda boleh membuka atau menutup lipatan tersebut.
Ini membolehkan memastikan dokumen besar teratur dan mudah diurus. Untuk Emacs
sokongan, lihat. ftp://ftp.csd.uu.se/pub/users/andersl/beta/

Nilai lalai memadamkan penanda ini dan ulasan khas "#_comment" yang menjadikannya
mungkin untuk memasukkan nota anda sendiri yang tidak termasuk dalam output yang dihasilkan.

{{{ Bahagian keselamatan

#_comment Pastikan anda menyemak bahagian ini untuk
#_komen keluaran seterusnya

Keselamatan adalah isu penting dalam pentadbiran harian...
Lagi teks...

}}}

--html-body STR
Atribut tambahan untuk ditambahkan pada teg HTML . Anda boleh contohnya mentakrifkan bahasa
teks dengan --html-body LANG=ms yang akan menghasilkan tag HTML Lihat
bahagian "LIHAT JUGA" untuk ISO 639.

--html-column-beg="SPEC HTML-SPEC"
Tafsiran lalai lajur 1,2,3 5,6,7,8,9,10,11,12 boleh ditukar dengan
mohon and akhir swithes. Lajur 0,4 tidak boleh ditukar kerana ia dikhaskan untuk
tajuk. Berikut adalah beberapa sampel:

--html-column-beg="7quote "
--html-column-end="7quote"

--html-column-beg="10 class='column10'"
--html-column-end="10 "

--html-column-beg="quote "
--html-column-end="quote"

Catatan: Anda hanya boleh memberikan spesifikasi sehingga lajur 12. Jika teks berada di sebalik lajur
12, ia ditafsirkan seperti di lajur 12.

Selain nombor lajur, SPEC juga boleh menjadi salah satu daripada rentetan berikut

Penanda perkataan setara spec
------------------------------
petikan `'
berani _
emp *
kecil +
besar =
rujuk [] seperti: [Michael] merujuk kepada [rfc822]

Spesifikasi lain yang tersedia
------------------------------
7petikan Apabila lajur 7 bermula dengan petikan berganda.

Untuk nilai helaian gaya bagi setiap warna, rujuk kelas atribut dan kegunaan --skrip-fail
pilihan untuk mengimport definisi. Biasanya /usr/lib/X11/rgb.txt menyenaraikan kemungkinan nilai warna
dan standard HTML di http://www.w3.org/ mentakrifkan warna yang dinamakan standard berikut:

Hitam #000000 Maroon #800000
Hijau #008000 Tentera Laut #000080
Perak #C0C0C0 Merah #FF0000
Limau nipis #00FF00 Biru #0000FF
Kelabu #808080 Ungu #800080
Zaitun #808000 Teal #008080
Putih #FFFFFF Fuchsia #FF00FF
Kuning #FFFF00 Aqua #00FFFF

--html-column-end="COL HTML-SPEC"
Lihat --html-column-beg

--html-font SAIZ
Tentukan SAIZ FONT. Ia mungkin berguna untuk menetapkan saiz fon yang lebih besar untuk pembentangan.

-F, --html-frame [FRAME-PARAMS]
Jika diberikan, maka tiga fail HTML berasingan akan dihasilkan. Bingkai kiri akan mengandungi
TOC dan bingkai kanan mengandungi baki teks. The FRAME-PARAMS boleh sah mana-mana
parameter untuk FRAMESET tag HTML. Lalai ialah "cols="25%,75%"".

Menggunakan ini bermakna --keluar pilihan secara automatik, kerana tiga fail tidak boleh dicetak
untuk stdout.

file.html

--> file.html Fail Frame, arahkan pelayar di sini
file-toc.html Bingkai kiri (navigasi)
file-body.html Bingkai kanan (kandungan)

--bahasa ID
Gunakan ID bahasa, pengecam ISO dua aksara seperti "en" untuk bahasa Inggeris semasa
penjanaan HTML. Ini hanya mempengaruhi teks yang ditunjukkan kepada pengguna akhir, seperti teks
"Isi kandungan". Tetapan lalai ialah "en". Lihat bahagian "LIHAT JUGA" untuk piawaian
ISO 639 dan ISO 3166 untuk kod yang betul.

Bahasa yang dipilih menukar tatasusunan dalaman propgram dalam dua cara: 1) Sebaliknya
lalai "Jadual ocntents" tajuk setara bahasa kebangsaan akan digunakan 2)
Teks "Pic" di bawah dibenamkan gambar bernombor berurutan akan menggunakan natinal
bersamaan.

Jika bahasa anda tidak disokong, sila hantar frasa untuk "Jadual kandungan" dan
perkataan "Pic" dalam bahasa anda kepada penyelenggara.

--skrip-fail FAIL
Sertakan kod java yang mesti lengkap daripada FILE. Kodnya ialah
letakkan di dalam setiap HTML.

. --skrip-fail ialah cara umum untuk mengimport apa sahaja ke dalam elemen HEAD. Cth. Jika
anda ingin menyimpan definisi gaya yang berasingan untuk semua, anda hanya boleh mengimport penuding
kepada helaian gaya. Lihat 14.3.2 Menentukan luar gaya lembaran dalam standard HTML 4.0.

--meta-kata kunci STR
Kata kunci meta. Digunakan oleh enjin carian. Pisahkan kwywords seperti "AA, BB, CC" dengan
koma. Rujuk spesifikasi HTML 4.01 dan topik "7.4.4 Meta data" dan lihat
http://www.htmlhelp.com/reference/wilbur/ and

--meta-kata kunci "AA,BB,CC"

--meta-penerangan STR
Perihalan meta. Sertakan rentetan penerangan, maks 1000 aksara. Ini digunakan oleh
enjin carian. Rujuk spesifikasi HTML 4.01 dan topik "7.4.4 Meta data"

--nama-uniq
1-4 perkataan pertama daripada tajuk digunakan untuk HTML nama tag. Walau bagaimanapun, ia adalah
mungkin dua tajuk yang sama bermula dengan 1-4 perkataan yang sama. Dalam kes tersebut
anda perlu menghidupkan pilihan ini. Ia akan menggunakan kaunter 00 - 999 dan bukannya perkataan daripada
tajuk untuk membina HTML nama rujukan.

Sila gunakan pilihan ini hanya dalam kecemasan, kerana merujuk kepada blok lompat nama melalui

httpI://example.com/doc.html#header_name

adalah lebih mudah daripada menggunakan rujukan yang tidak jelas

httpI://example.com/doc.html#11

Di samping itu, setiap kali anda menambah tajuk baharu nombor berubah, manakala simbolik
nama yang dipilih daripada tajuk kekal selagi anda tidak menukar tajuk. Fikirkan tentang
kebajikan netizen anda yang menanda halaman halaman anda. Cuba buat tajuk untuk tidak mempunyai
subjek yang sama dan anda tidak memerlukan pilihan ini.

Dokumen penyelenggaraan and kumpulan kerja arahan
-A, --auto-kesan
Tukar fail hanya jika teg "#T2HTML-" ditemui daripada fail. Pilihan ini berguna jika anda
jalankan arahan kelompok untuk menukar semua fail kepada HTML, tetapi hanya jika ia kelihatan seperti asas HTML
fail:

cari . -nama "*.txt" -taip f \
-exec t2html --auto-detect --verbose --out {} \;

Perintah itu mencari semua fail *.txt di bawah direktori semasa dan menyuapkannya
program penukaran. The --auto-kesan hanya menukar fail yang termasuk "#T2HTML-"
arahan. Fail teks lain tidak ditukar.

--pautan-semak -l
Semak semua pautan http dan ftp. ini pilihan is sepatutnya kepada be menjalankan mandiri Lebih Baik
--senyap mempunyai makna istimewa apabila digunakan dengan pemeriksaan pautan.

Dengan pilihan ini anda boleh kerap mengesahkan dokumen anda dan mengalih keluar pautan mati atau
kemas kini pautan yang dialihkan. Pautan bermasalah dikeluarkan kepada stderr. Semakan pautan ini
ciri tersedia hanya jika anda telah memasang perpustakaan web LWP. Program akan
semak jika anda mempunyainya semasa runtime.

Pautan yang besar, cth yang sepadan Tar.gz . Zip ... atau yang menjalankan program (pautan dengan
? aksara) diabaikan kerana permintaan GET yang digunakan dalam semakan akan mengembalikan keseluruhan
kandungan pautan dan ia akan. menjadi terlalu mahal.

Cadangan: Apabila anda meletakkan pautan binari pada dokumen anda, tambahkannya dengan ruang:

http://example.com/dir/dir/ nama fail.tar.gz

Kemudian program tidak semak alamat http. Pengguna mungkin tidak boleh mendapatkan fail
pada satu klik, penyemak boleh mengesahkan sekurang-kurangnya direktori. Jika anda bukan pemilik
pautan, ia juga mungkin bahawa fail telah dipindahkan daripada nama versi baharu
muncul.

-L, --pautan-semak-tunggal
Cetak keluaran pekat masuk grep -n seperti cara FAIL:LINE:MESSAGE

Pilihan ini menggabungkan teks respons url kepada satu baris, supaya anda boleh melihat
mesej dalam satu baris. Anda boleh menggunakan alat pengaturcaraan (seperti Emacs Mx compile) itu
boleh menghuraikan sintaks grep standard untuk melompat ke lokasi dalam dokumen anda untuk membetulkan
pautan kemudian.

-o, --keluar
tulis HTML yang dijana ke fail yang diperoleh daripada nama fail input.

--out --print /dir/file --> /dir/file.html
--out --print /dir/file.txt --> /dir/file.html
--out --print /dir/file.this.txt --> /dir/file.this.html

--pautan-cache CACHE_FILE
Apabila pautan disemak secara berkala, ia akan menjadi agak ketat untuk menyemak setiap pautan
setiap kali itu sudah berjaya. Untuk menjimatkan masa menyemak pautan, "ok"
pautan boleh dicache ke dalam fail berasingan. Lain kali anda menyemak pautan, cache adalah
dibuka dan hanya pautan yang didapati tiada dalam cache disemak. Ini sepatutnya
menambah baik carian panjang secara mendadak. Pertimbangkan contoh ini, di mana setiap fail teks berada
diperiksa secara rekursif.

$ t2html --link-check-single \
--quiet --link-cache ~tmp/link.cache \
`cari . -nama "*.txt" -taip f`

-O, --out-dir DIR
suka --keluar, tetapi potong bahagian direktori dan tulis fail output ke DIR. Yang berikut
akan menjana fail HTML ke direktori semasa:

--out-dir .

Jika anda mempunyai alat automatik yang mengisi direktori, anda boleh menggunakan word tiada kepada
abaikan pilihan ini. Berikut adalah no-op, ia tidak akan menghasilkan output ke direktori
"tiada":

--out-dir none

-p, --cetak
Cetak nama fail ke stdout selepas pemprosesan HTML. Biasanya program tidak mencetak nama fail,
hanya HTML yang dihasilkan.

% t2html --out --print page.txt

--> page.html

-P, --print-url
Cetak nama fail dalam format URL. Ini berguna jika anda ingin menyemak susun atur
serta-merta dengan penyemak imbas anda.

% t2html --out --print-url page.txt | xargs lynx

--> fail: /users/foo/txt/page.html

--berpecah REGEXP
Pisahkan dokumen kepada kepingan yang lebih kecil apabila REGEXP sepadan. Split arahan adalah mandiri,
bermakna, ia bermula dan berhenti. Tiada penukaran HTML untuk fail terlibat.

Jika REGEXP ditemui dari baris, ia adalah titik permulaan perpecahan. Cth untuk berpecah
mengikut tajuk peringkat atas, yang tidak mempunyai penomboran, anda akan menggunakan:

--belah '^[AZ]'

Nombor berjujukan, 3 digit, ditambahkan pada separa yang dijana:

nama fail.txt-NNN

Ciri split berguna jika anda ingin menjana slaid dari setiap tajuk: Pertama
belah dokumen, kemudian tukar setiap bahagian kepada HTML dan akhirnya cetak setiap bahagian (halaman)
secara berasingan kepada pencetak.

-S1, --pecah1
Ini adalah singkatan daripada --berpecah perintah. Tentukan regexp untuk berpecah pada tajuk peringkat atas.

-S2, --pecah2
Ini adalah singkatan daripada --berpecah perintah. Tentukan regexp untuk berpecah pada tajuk tahap kedua.

-SN, --split-named-files
Arahan tambahan untuk arahan split. Jika anda membahagi cth dengan tajuk menggunakan --pecah1,
adalah lebih bermaklumat untuk menjana nama fail mengikut beberapa perkataan pertama daripada
nama tajuk. Katakan nama tajuk tempat perpecahan berlaku ialah:

Garis panduan program
Kesimpulan

Kemudian nama fail separa yang dihasilkan adalah seperti berikut.

FILENAME-program_guidelines
FILENAME-kesimpulan

-X, --xhtml
Render menggunakan XHTML yang ketat. Ini bermakna menggunakan , dan penggunaan perenggan .. .

"Nota: pilihan ini adalah percubaan. Lihat BUGS"

Lain-lain pilihan
--nyahpepijat LEVEL
Hidupkan nyahpepijat dengan nombor LEVEL positif. Sifar bermakna tiada nyahpepijat.

- membantu -h
Cetak skrin bantuan. Menamatkan program.

--help-css
Cetak CSS lalai digunakan. Menamatkan program. Anda boleh menyalin dan mengubah suai output ini dan
arahkan untuk menggunakan sendiri dengan --css-file=FAIL. Anda juga boleh membenamkan pilihan pada fail
dengan arahan "#T2HTML-OPTION".

--help-html
Cetak bantuan dalam format HTML. Menamatkan program.

--menolong-lelaki
Cetak halaman bantuan dalam format halaman manual Unix. Anda mahu menyuap output ini kepada nroff -lelaki
untuk membacanya. Menamatkan program.

--halaman ujian
Cetak halaman ujian: HTML dan contoh fail teks yang menunjukkan keupayaan.

--masa
Cetak ke stderr masa yang digunakan untuk mengendalikan fail.

-v, --verbose [PERINGKAT]
Cetak mesej bertele-tele.

-q, --senyap
Cetak tiada pengaki sama sekali. Pilihan ini mempunyai makna yang berbeza jika --pautan-semak pilihan adalah
dihidupkan: cetak hanya pautan yang salah.

V, --versi
Cetak maklumat versi program.

FORMAT DESCRIPTION

Program menukar fail teks kepada HTML. Idea asas adalah bergantung pada tahap lekukan, dan
susun atur yang digunakan dipanggil 'Technical format' (TF) di mana hanya konvensyen minimum digunakan
untuk menandakan teks condong, tebal dsb. Prinsip asas boleh ditunjukkan di bawah. Notis
pembaris poisiton lajur di bahagian atas:

--//-- mula penerangan

123456789 123456789 123456789 123456789 123456789 nombor lajur

Tajuk 1 bermula dengan huruf besar di lajur 1 paling kiri

Kedudukan lajur 1,2,3 pada masa ini tidak ditentukan dan mungkin tidak
format dengan betul. Jangan letak teks pada lajur 1,2 atau 3.

Tajuk tahap 2 bermula pada lajur separuh tab 4 dengan huruf besar

Teks biasa tetapi berwarna pada lajur 5

Teks biasa tetapi berwarna pada lajur 6

Tajuk 3 boleh dipertimbangkan pada kedudukan TAB tolak 1, lajur 7.

" Teks khas pada lajur 7 bermula dengan petikan berganda"

Teks standard bermula pada lajur 8, anda boleh *menegaskan* teks atau
jadikan ia _strong_ dan tulis =SmallText= atau +BigText+ show
nama pembolehubah `ThisIsAlsoVariable'. Anda boleh `_*sarang*_' `the'
markup. lebih banyak txt dalam perenggan ini txt txt txt txt txt txt txt
txt txt txt txt txt txt txt .
txt txt txt txt txt txt txt .
txt txt

Teks kukuh pada lajur 9

Ruangan 10 dikhaskan untuk sebut harga
Ruangan 10 dikhaskan untuk sebut harga
Ruangan 10 dikhaskan untuk sebut harga
Ruangan 10 dikhaskan untuk sebut harga

Teks kukuh pada lajur 11

Lajur 12 dan seterusnya dikhaskan untuk contoh kod
Lajur 12 dan seterusnya dikhaskan untuk contoh kod
Semua teks di sini dikelilingi oleh kod HTML
Lajur KOD ini dipengaruhi oleh pilihan --css-code*.

Tajuk 2 pada lajur 4 sekali lagi

Jika anda mahukan sesuatu seperti Tajuk tahap 3, gunakan lajur 7 (tebal)

Lajur 8. Kedudukan tab standard. txt txt txt txt txt txt
txt txt txt txt txt txt txt .
txt txt txt txt txt txt txt .
[1998-09-10 Encik Foo berkata]:

petikan teks petikan teks petikan petikan teks petikan
teks petikan teks petikan teks petikan teks petikan teks
petikan teks petikan teks petikan petikan teks petikan
teks petikan teks

* Bullet pada lajur 8. Perhatikan 3 ruang selepas (*), jadi
teks bermula pada separuh tab ke hadapan pada lajur 12.
* Peluru. txt txt txt txt txt txt
* Peluru. txt txt txt txt txt txt
,txt txt txt txt

Perhatikan bahawa perenggan sebelumnya berakhir dengan koma P
kod, ia memberitahu perenggan ini untuk meneruskan
mod bullet, jika tidak, teks ini di lajur 12
akan ditafsirkan sebagai bahagian kod dikelilingi
oleh kod HTML.

. Ini adalah senarai tersusun.
. Ini adalah senarai tersusun.
. Ini adalah senarai tersusun.

.Barisan ini memulakan wirg dot dan dipaparkan dalam baris dengan sendirinya.
.Barisan ini memulakan wirg dot dan dipaparkan dalam baris dengan sendirinya.

!! Ini menambah satu Kod HTML, teks dalam baris ditanda dengan
!!

Jadikan alamat e-mel ini boleh diklik[e-mel dilindungi]> Jangan
jadikan alamat e-mel ini boleh diklik [e-mel dilindungi], kerana ia
hanyalah contoh dan bukan alamat sebenar. Perhatikan bahawa
yang terakhir tidak dikelilingi oleh <>. Nama log masuk biasa seperti
foo, bar, quux, atau 'contoh' tapak internet diabaikan
secara automatik.

Juga jangan buat [e-mel dilindungi]> sebab ada tambahan
ruang putih. Ini mungkin cara yang lebih mudah untuk melumpuhkan e-mel
alamat sementara.

Tajuk1 sekali lagi di lajur 0

Subtajuk di lajur 4

Dan teks biasa, lajur 8 txt txt txt txt txt txt
txt txt txt txt txt txt txt .
txt txt txt txt txt txt

--//-- penghujung penerangan

Itu sahaja, terdapat keseluruhan susun atur yang diterangkan. Secara lebih formal peraturan teks
pemformatan disenaraikan di bawah.

DIGUNAKAN HEADINGS
· Hanya ada 2 tahap tajuk dalam gaya ini. Lajur tajuk ialah 0 dan 4 dan
tajuk mesti dimulakan dengan huruf atau nombor besar

· pada lajur 4, jika teks bermula dengan huruf kecil, baris itu ditafsirkan sebagai


· HTML tanda ditambah sejurus sebelum mencetak tajuk pada tahap 1.

· Tajuk dikumpulkan, TOC dibina dan dimasukkan ke permulaan HTML
muka surat. HTML rujukan yang digunakan dalam TOC ialah 4 perkataan urutan pertama daripada
tajuk. Pastikan tajuk anda diberi nama unik, jika tidak akan ada yang sama
Rujukan NAME dalam HTML yang dijana. Ruang ditukar kepada garis bawah apabila
bergabung dengan perkataan. Jika anda tidak boleh menulis tajuk unik dengan empat perkataan, maka anda mesti
penggunaan --nama-uniq bertukar

TEXT PENEMPATAN PERATURAN

Umum
Peraturan asas untuk meletakkan teks dalam lajur tertentu:

· Teks pada lajur 0 tidak ditentukan jika ia tidak bermula dengan huruf besar atau nombor kepada
menunjukkan Tajuk tahap 1.

· Teks antara lajur 1-3 ditanda dengan

· Lajur 4 dikhaskan untuk tajuk tahap 2

· Teks antara lajur 5-7 ditanda dengan

· Teks pada lajur 7 ialah jika aksara pertama ialah petikan berganda.

· Lajur 10 dikhaskan untuk teks. Jika anda ingin memetik seseorang atau menambah rujukan
teks, letakkan teks dalam lajur ini.

· Teks di lajur 9,11 ditanda dengan

Lajur 8 untuk teks dan kod khas

· Lajur 8 dikhaskan untuk teks biasa

· Pada permulaan teks, di lajur 8, boleh terdapat kod DOT atau kod KOMA.

Lajur 12 adalah istimewa

· Lajur 12 dilayan secara khusus: blok dimulakan dengan dan garisan ditandakan sebagai
. Apabila teks terakhir di ruang 12 ditemui, blok ditutup dengan
Perhatikan contoh berikut

txt txt txt ;blok diletakkan sama rata, baik, lakukan seperti ini
txt txt

txt txt txt txt ;Tidak boleh menamatkan /pra, kerana terakhir
txt txt txt txt ;lajur bukan pada 12
txt txt txt txt

txt txt txt txt
txt txt txt txt
txt txt txt txt
;; Menyelesaikan ulasan, kini teks diletakkan sama rata

Tambahan token khususnya penggunaan at ruang 8
· Jika terdapat "."(titik) pada permulaan baris dan serta-merta bukan ruang putih, maka
kod ditambah pada penghujung baris.

.Barisan ini akan mempunyai a Tag HTML pada penghujungnya.
Manakala dua baris ini dicantumkan
oleh penyemak imbas, bergantung pada lebar bingkai.

· Jika terdapat ","(koma) maka kod tidak dimasukkan jika baris sebelumnya adalah
kosong. Jika anda menggunakan kedua-dua "."(titik) dan ","(koma), ia mestilah dalam susunan titik-koma. The
","(koma) berfungsi secara berbeza jika ia digunakan dalam bullet

A sentiasa ditambah jika terdapat pemisahan perenggan, tetapi apabila anda menulis a
peluru, ada masalah, kerana peluru wujud hanya selagi teks disimpan
bersama-sama

* Ini adalah peluru dan ia mempunyai semua ketp teks bersama-sama
walaupun terdapat garisan lain dalam peluru.

Tetapi untuk menulis peluru tat menyebarkan beberapa perenggan, anda mesti mengarahkan bahawa mereka adalah
untuk disimpan bersama dan teks dalam perenggan seterusnya tidak semasa ia diletakkan di
lajur 12

* Ini adalah peluru dan ia mempunyai semua ketp teks bersama-sama
,walaupun ada baris lain dalam peluru.

Ini adalah paragrah baru kepada peluru sebelumnya dan ini
bukan contoh teks. Lihat kod KOMA yang berterusan di atas.

* Ini peluru baharu

// dan ini adalah sampel kod selepas peluru
jika ( $flag ) { ..buat sesuatu.. }

khas teks tanda
condong, tebal, kod, kecil, token besar
_ini_ ditafsirkan sebagai ini
*ini* ditafsirkan sebagai ini
`ini' ditafsirkan sebagai ini `

Pengubah suai Exra yang boleh dicampur dengan di atas. Biasanya jika anda mahukan fon yang lebih besar,
HASILKAN PERKATAAN.

=ini= ditafsirkan sebagai ini
+ini+ ditafsirkan sebagai ini
[ini] ditafsirkan seperti ini

superskrip
perkataan [ini] ditafsirkan sebagai superskrip. Anda boleh menggunakan suka
ini[1], berbilang[(2)] dan hampir mana-mana[(ab)] dan
boleh dibayangkan[IV superskrip] selagi kiri
kurungan dilampirkan pada perkataan.

melanggan
12[[10]] ialah perwakilan nilai 12 un asas 10.
Ini ditafsirkan sebagai subskrip. Anda boleh menggunakan suka
ini[[1]], berbilang[[(2)]] dan hampir mana-mana[[(ab)]] dan
boleh dibayangkan[[subskrip IV]] selagi *dua* tinggal
kurungan dilampirkan pada perkataan.

membenamkan token HTML standard
Entiti HTML khas Stanadard boleh ditambah di dalam teks dengan cara biasa, sama ada menggunakan
nama simbolik atau kod cincang. Berikut adalah contoh:

× < > ≤ ≥ ≠ √ −
α β γ ÷
« » ‹ › - – —
≈ ≡ ∑ ƒ ∞
° ±
™ © ®
€ £ ¥

membenamkan HTML TULEN ke dalam teks
ini ciri is sangat eksperimen. Anda boleh membenamkan HTML tulen di dalam teks
masa, di mana contohnya beberapa pemformatan khas diperlukan. Isea adalah mudah: anda menulis
HTML seperti biasa tetapi menggandakan setiap aksara '<' dan '>', seperti:

< >

Peraturan lain ialah semua HTML TULEN mesti disimpan bersama. Mesti tiada barisan
pecah antara baris HTML tulen. Ini tidak betul:

<

< >satu
< > dua

< >

HTML tulen mesti ditulis tanpa baris baharu tambahan:

<
< >satu
< > dua
< >

"Penggandaan" ini turut mempengaruhi peraturan penulisan teks biasa. Jika anda menulis dokumen,
di mana anda menerangkan Unix menggayakan dokumen DI SINI, anda TIDAK MESTI meletakkan token di sebelah
satu sama lain:

bash$ kucing<
1
EOF

Anda mesti menulis contoh kod di atas menggunakan ruang untuk menghalang "<<" daripada mentafsir
sebagai HTML TULEN:

bash$ cat << EOF # BETUL, tambah ruang
1
EOF

melukis pemisah pendek
A!! (dua tanda seru) pada lajur teks (kedudukan 8) menyebabkan penambahan serta-merta
kod. sebarang teks selepas !! dalam baris yang sama ditulis dengan dan disisipkan
selepas sahaja kod, oleh itu perintah pemformatan perkataan tidak mempunyai kesan dalam hal ini
line.

Http and e-mel menandakan kawalan
· Semua rujukan http dan ftp serta[e-mel dilindungi]> alamat e-mel ditanda
boleh diklik. E-mel mesti mempunyai <> aksara sekeliling untuk dikenali.

· Jika url didahului dengan tanda sempang, ia tidak akan dapat diklik. Jika rentetan foo, bar, quux,
ujian, tapak ditemui dari url, maka ia tidak dikira sebagai boleh diklik.

<[e-mel dilindungi]> boleh diklik
http://example.com boleh diklik

< [e-mel dilindungi]> tidak boleh diklik; mengandungi ruang
<5dko56$[e-mel dilindungi]> Mesej-Id, tidak boleh diklik

-http://example.com tanda sempang, tidak boleh diklik
http://$EXAMPLE variable. not clickable

senarai and peluru
· Jadual buletin dibina jika terdapat "o" atau "*" pada ruang 8 dan 3 selepas
ia, supaya teks bermula pada lajur 12. Baris bertitik tumpu dinasihatkan supaya disimpan bersama;
tiada ruang antara blok peluru.

· Senarai tertib dimulakan dengan ".", titik, dan ditulis seperti titik di mana teks bermula
di lajur 12.

Talian rehat
· Semua pemisah baris kelihatan dalam dokumen anda, jangan gunakan lebih daripada satu pemisah baris
perenggan berasingan.

· Sangat penting ialah ada sahaja 1 pemisah baris selepas tajuk.

DIPERBAIKI ARAHAN DALAM TEXT

Pilihan baris arahan
Anda boleh membatalkan pematuhan semua arahan terbenam dengan membekalkan pilihan --not2html-tags.

Anda boleh memasukkan baris ini di mana-mana sahaja dalam dokumen dan kandungannya disertakan
Keluaran HTML. Setiap baris arahan mesti dimuatkan dalam satu baris dan ia tidak boleh dipecahkan
garisan berasingan.

#T2HTML-TITLE
#T2HTML-EMAIL
#T2HTML-AUTHOR
#T2HTML-DOC
#T2HTML-METAKEYWORDS
#T2HTML-METADESCRIPTION

Anda boleh lulus pilihan baris arahan yang dibenamkan dalam fail. Suka jika anda mahu KOD
bahagian (lajur 12) untuk diwarnakan dengan warna kelabu, anda boleh menambah:

#T2HTML-OPTION --css-code-bg

Atau anda boleh meminta untuk menghidupkan pilihan tertentu. Perhatikan bahawa setiap baris adalah tepat
kerana anda telah meluluskan hujah dalam baris arahan. Bayangkan sekitar dua kali dipetik
sekitar baris yang merupakan hujah kepada pilihan yang berkaitan.

#T2HTML-OPTION --seadanya
#T2HTML-OPTION --senyap
#T2HTML-OPTION --bahasa
#T2HTML-OPTION en
#T2HTML-OPTION --css-font-type
#T2HTML-OPTION Trebuchet MS
#T2HTML-OPTION --css-code-bg
#T2HTML-OPTION --css-code-note
#T2HTML-OPTION (?:Nota|Notis|Amaran):

Anda juga boleh membenamkan ulasan anda sendiri pada teks. Ini dilucutkan:

#T2HTML-COMMENT Anda mengulas di sini
#T2HTML-COMMENT Anda komen lain di sini

Membenamkan fail
#INCLUDE- arahan

Ini digunakan untuk memasukkan kandungan ke dalam kedudukan semasa semasa. URL boleh menjadi a
rujukan nama fail, di mana setiap $VAR digantikan daripada pembolehubah persekitaran. The
pengembangan tilde(~) tidak disokong. Nama fail yang disertakan ialah sistem pengendalian
lokasi laluan yang disokong.

Awalan "mentah:" melumpuhkan sebarang pemformatan biasa. Kandungan fail disertakan sebagaimana adanya.

URL juga boleh menjadi rujukan HTTP ke lokasi terpencil, yang kandungannya disertakan
pada titik. Dalam kes kandungan jauh atau apabila nama fail berakhir dengan sambungan ".html" atau
".html", kandungan dilucutkan untuk membuat kemasukan kandungan
mungkin. Dalam gambar di bawah, hanya garisan dalam BADAN, ditanda dengan !!, adalah
termasuk:



...


teks ini!!
dan banyak lagi ini!!



Contoh:

#INCLUDE-$HOME/lib/html/picture1.html
#SERTAKAN-http://www.example.com/code.html
#INCLUDE-raw:example/code.html

Membenamkan gambar
Perintah #PIC digunakan untuk memasukkan gambar ke dalam teks

#PIC picture.png#Teks Kapsyen#Atribut HTML Gambar#align#
(1) (2) (3) (4)

1. NAMA atau alamat URL gambar. Suka imej/ini.png

2. Teks yang muncul di bawah gambar

3. Atribut tambahan yang dilampirkan di dalam tag.
Untuk , talian itu akan
baca:

#PIC some.png#Caption Text#width=200 length=200##

4. Kedudukan imej: "kiri" (lalai), "tengah", "kanan"

Nota: "Teks Kapsyen" juga akan menjadi teks ALT bagi imej yang digunakan dalam
kes penyemak imbas tidak mampu menunjukkan gambar. Anda boleh menyekat teks ALT
dengan pilihan --tiada-gambar-alt.

Pengecam serpihan untuk teg bernama
Perintah #REF digunakan untuk merujuk kepada HTML tag di dalam dokumen semasa. The
keseluruhan arahan mesti diletakkan pada satu baris dan tidak boleh dipecahkan kepada berbilang
garisan. Satu contoh:

#REF #how_to_profile;(Nota: pemprofilan);
(sebelas)

1. Rujukan teg HTML NAMA dalam dokumen semasa, satu perkataan.
Ini juga boleh menjadi pautan URL penuh.
Anda boleh mendapatkan senarai NAMA dengan mendayakan pilihan --toc-url-print.

2. Teks boleh klik dihadkan oleh ; watak.

Merujuk kepada dokumen luar.
Teg "#URL" boleh digunakan untuk membenamkan URL sebaris, supaya pautan penuh tidak kelihatan.
Hanya teks yang ditunjukkan digunakan untuk melompat ke URL. Arahan ini tidak boleh dilanggar
garisan berasingan,

#URL
| |
| ruang putih dibenarkan di sini
Mesti disimpan bersama

Suka jika ditulis:

Lihat enjin carian #URLhttp://www.google.com>

JADUAL OF KANDUNGAN KETUA

Jika terdapat tajuk 1, yang dinamakan betul-betul "Jadual Kandungan", maka semua teks sehingga
tajuk seterusnya dibuang daripada fail HTML yang dijana. Ini dilakukan kerana program
menjana TOC sendiri. Anda sepatutnya menggunakan beberapa program pemformatan teks untuk
hasilkan toc untuk anda dalam fail .txt dan anda tidak menyelenggaranya secara manual. Sebagai contoh
Pakej Emacs tinytf.el boleh digunakan.

PENYELESAIAN MASALAH

Generated HTML dokumen lakukan tidak melihat apa I Bertujuan
Kesilapan yang paling biasa ialah terdapat baris baharu tambahan dalam dokumen. Keep 1 kosong
baris antara tajuk dan teks, simpan 1 baris kosong antara perenggan, simpan 1 kosong
garisan antara teks badan dan peluru. Jadikan ia mantra anda: 1 1 1 ...

Seterusnya, anda mungkin telah meletakkan teks pada kedudukan lajur yang salah. Ingat bahawa teks biasa adalah di
lajur 8.

Jika HTML yang dijana secara tiba-tiba mula menggunakan hanya satu fon, cth , maka anda terlupa
tutup blok. Jadikan ia dibaca sekata, seperti ini:

Sekatan kod
Sekatan kod
Sekatan kod
;; Tambahkan ulasan kosong di sini untuk "menutup" contoh kod di lajur 12

Tajuk bermula dengan huruf atau nombor besar, seperti "Tajuk", bukan "tajuk". Periksa dua kali
ejaan.

CONTOH

Untuk mencetak halaman ujian dan menunjukkan semua kemungkinan:

t2html --halaman-ujian

Untuk membuat halaman HTML mudah tanpa sebarang maklumat meta:

t2html --title "Tajuk Halaman Html" --pengarang "Mr. Foo" \
--simple --out --print file.txt

Jika anda mempunyai siaran berkala dalam format e-mel, gunakan --delete-email-headers untuk mengabaikan tajuk
teks:

t2html --out --print --delete-email-headers page.txt

Untuk membuat halaman dengan cepat

t2html --html-frame --out --print page.txt

Untuk menukar halaman daripada dokumen teks, termasuk tag meta, butang, warna dan bingkai. bayar
perhatian untuk beralih --html-body yang mentakrifkan bahasa dokumen.

t2html \
--cetak \
--keluar \
--pengarang "Encik foo" \
--e-mel"[e-mel dilindungi]" \
--title "Ini adalah halaman manual BAR halaman" \
--html-body LANG=ms \
--button-prev previous.html \
--button-top index.html \
--buttion-next next.html \
--dokumen http://example.com/dir/this-page.html \
--url manual.html \
--css-code-bg \
--css-code-note '(?:Note|Notis|Amaran):' \
--html-frame \
--disclaimer-file $HOME/txt/my-html-footer.txt \
--meta-keywords "bahasa-en,manual,program" \
--meta-description "Program bar untuk melakukan ini dan banyak lagi" \
manual.txt

Untuk menyemak pautan dan mencetak status semua pautan setanding dengan mesej ralat http (kebanyakan
verbose):

t2html --link-check file.txt | tee link-error.log

Untuk mencetak pautan bermasalah sahaja:

t2html --link-check --quiet file.txt | tee link-error.log

Untuk mencetak output terse dalam ege -n seperti cara: nombor baris, pautan dan kod ralat:

t2html --link-check-single --quiet file.txt | tee link-error.log

Untuk menyemak pautan daripada berbilang halaman dan cache pautan yang baik untuk memisahkan fail, gunakan --pautan-cache
pilihan. Semakan pautan seterusnya akan berjalan lebih pantas kerana pautan sah yang dicache tidak akan berfungsi
diambil semula. Pada selang masa yang tetap padam fail cache pautan untuk memaksa pemeriksaan lengkap.

t2html --link-check-single \
--link-cache $HOME/tmp/link.cache \
--fail senyap.txt

Untuk membahagikan dokumen besar kepada kepingan, dan menukar setiap bahagian kepada HTML:

t2html --split1 --split-name file.txt | t2html --simple --out

PERSEKITARAN

EMAIL
Jika pembolehubah persekitaran EMAIL ditakrifkan, ia digunakan dalam pengaki untuk alamat kenalan.
Lebih Baik --e-mel mengatasi tetapan persekitaran.

BAHASA
Tetapan bahasa lalai untuk suis "--language" Pastikan dua yang pertama
aksara mengandungi definisi bahasa, seperti dalam: LANG=en.iso88591

Gunakan t2html dalam talian menggunakan perkhidmatan onworks.net