code2html - Dalam talian di Awan

JADUAL:

NAMA

code2html - Menukar kod sumber program kepada HTML

SINOPSIS

(1) code2html [pilihan] [fail input [fail keluaran]]

(2) code2html -p [fail [alternate-outfile]]

(3) code2html (sebagai skrip CGI; lihat bahagian pada CGI)

DESCRIPTION

code2html ialah skrip perl yang menukarkan kod sumber program kepada sintaks yang diserlahkan
HTML, atau mana-mana format lain untuk peraturan yang ditentukan.

(1) PILIHAN
fail input
Adakah fail yang mengandungi kod sumber program untuk diformatkan. Jika tidak
dinyatakan atau tolak (-) diberikan, kod akan dibaca daripada STDIN.

fail keluaran
Adakah fail untuk menulis kod yang diformatkan. Jika tidak dinyatakan atau tolak (-) adalah
diberikan, kod akan ditulis kepada STDOUT.

-l, --mod bahasa
Tentukan set ungkapan biasa untuk digunakan. Ini perlu ditakrifkan dalam a
fail bahasa (lihat FILES di bawah). Untuk mengetahui mod bahasa yang ditakrifkan,
isu a code2html --mod.

Input ini dianggap tidak peka huruf besar-besaran.

Jika tidak diberikan, beberapa heuristik akan digunakan untuk menentukan bahasa fail.

-v, --verbose
Mencetak maklumat kemajuan kepada STDERR.

-n, --nombor talian
Cetak kod sumber dengan nombor baris.

-N, --linknumbers
Cetak kod sumber dengan nombor baris. Nombor talian akan dipautkan ke
sendiri, yang memudahkan untuk menghantar pautan ke talian.

-P, --awalan
Awalan pilihan untuk digunakan untuk penambat nombor baris.

-t, --ganti-tab[=TABSTOP-LEBAR]
Gantikan setiap kejadian a watak dengan jumlah ruang yang sesuai untuk diperoleh
ke hentian tab seterusnya. Lalai ialah lebar hentian tab sebanyak 8 aksara.

-L, --fail-bahasa=FAIL BAHASA
Tentukan fail ganti untuk mengambil definisi bahasa dan format output
(lihat bahagian pada FILES di bawah).

-m, --mod
Cetak semua mod bahasa dan format output yang kini ditakrifkan kepada STDOUT dan keluar
dengan jayanya. Juga mencetak mod daripada a FAIL BAHASA diberikan oleh --fail-bahasa if
berlaku.

--sandaran=BAHASA
Jika mod bahasa yang diberikan dengan --mod bahasa tidak dapat dijumpai maka gunakan ini
mod.

--sandaran kosong contohnya berguna apabila code2html dipanggil daripada skrip ke
memastikan output dibuat.

-h, - membantu
Cetak bantuan ringkas dan keluar dengan jayanya.

-V, --versi
Cetak versi program dan keluar dengan jayanya.

-c, --jenis kandungan
Mencetak "Jenis Kandungan: text/html\n\n" (atau apa sahaja yang ditakrifkan oleh format output sebagai
jenis kandungan) sebelum keluaran yang lain. Berguna jika skrip dipanggil sebagai
skrip cgi.

-o, --format-output
Memilih format output. html ialah lalai. Untuk mengetahui format output yang mana
ditakrifkan, isu a code2html --mod.

-H, --no-header
jangan gunakan templat yang ditakrifkan oleh format output. Untuk HTML ini bermakna
bahawa tidak akan ada , , dan tidak
tags.

--template=FAIL
mengatasi templat lalai untuk format output yang diberikan. Jika --no-header is
diberikan juga, ini tidak mempunyai makna, kerana templat diabaikan pula.

-T, --tajuk
Tetapkan tajuk fail output yang dihasilkan. Hanya berfungsi jika templat berfungsi
menyokong penetapan tajuk.

-w, --linewidth=LINEWIDTH
Balut baris selepas LINEWIDTH watak. Lalai adalah untuk tidak membalut baris sama sekali.

-b, --linebreakprefix=LINEPREFIX
Penggunaan fILINEPREFIX pada permulaan baris yang dibalut. Lalai ialah "» ".

(2) HTML menampal
code2html -p [fail [alternate-outfile]]

code2html juga membolehkan anda mempunyai kod sumber sebaris dalam fail html. Ia kemudian boleh mengambil
fail html ini dan masukkan kod yang diserlahkan sintaks.

Jika tiada fail diberikan, code2html membaca daripada STDIN dan menulis kepada STDOUT. Jika hanya satu fail
memandangkan ia menggantikan fail ini dengan output. Jika dua fail disediakan, yang pertama adalah
dibaca daripada dan yang kedua ditulis kepada.

Untuk menggunakan ciri ini, hanya masukkan seperti ini ke dalam fail html anda:

-->

fail yang diserlahkan sintaks akan dimasukkan pada kedudukan yang dilampirkan ini tag.

Semua pilihan yang boleh diberikan pada baris arahan seperti --nombor talian kerja dll. - membantu,
--versi, dsb. berfungsi juga namun ia tidak begitu bijak untuk menggunakannya :). menggunakan
--format-output untuk memilih format output bukan HTML adalah tidak digalakkan. --jenis kandungan is
diabaikan.

Anda juga boleh menulis kod sumber program terus dalam fail html dengan yang berikut
sintaks:

<!-- code2html tambah [pilihan]



->

Ia biasanya idea yang baik untuk sekurang-kurangnya memberikan --mod bahasa pilihan untuk menentukan
bahasa.

(3) CGI
Jika skrip digunakan sebagai skrip CGI (GATEWAY_INTERFACE set persekitaran dan tidak
hujah baris arahan diberikan) code2html membaca hujah sama ada daripada rentetan pertanyaan
atau daripada SDTIN. (kaedah POST dan GET).

--jenis kandungan dihidupkan secara automatik dan output sentiasa pergi ke STDOUT.

Parameter/pilihan berikut diterima:

mod bahasa - pilihan
`c', `cc', `pas', dsb.

jika tidak diberikan, beberapa heuristik digunakan untuk mengetahui bahasa tersebut.

belakang - pilihan
`plain', `c', dsb. jika mod bahasa tidak ditemui, gunakan mod ini

pemilih input - pilihan
sama ada `fail', `cgi-input1', `cgi-input2' atau `REDIRECT_URL'

lalai: fail

nama fail
fail untuk dibaca daripada if pemilih input ialah `fail'

cgi-input1
Kod sumber untuk sorotan sintaks. Contohnya daripada a atau daripada a
muat naik. Lihat pemilih input.

cgi-input2
Kod sumber untuk sorotan sintaks. Contohnya daripada a atau daripada a
muat naik. Lihat pemilih input.

nombor baris - pilihan
`ya', `tidak' atau `pautan'

lalai: tidak

ganti-tab - pilihan
Jika 0 maka tab tidak diganti, jika tidak, gantikan setiap kejadian a watak
dengan jumlah ruang yang sesuai untuk sampai ke hentian tab seterusnya.

lalai: 0

tajuk - pilihan
Tetapkan tajuk fail.

tiada pengekodan - pilihan
Secara lalai code2html cuba mengekod output sama ada bz2/gz/Z jika pelanggan
menyokong ini (HTTP_ACCEPT_ENCODING) dan program yang diperlukan tersedia di
pelayan. Anda mungkin perlu mengubah suai @CGI_ENCODING dalam skrip untuk dipadankan dengan program anda
lokasi.

If tiada pengekodan ditakrifkan sebagai "benar" code2html tidak cuba mengekod output.

Mengapa dua input cgi anda mungkin bertanya: Ini adalah untuk membolehkan pengguna anda memilih vie a
antara muka sama ada mereka mahu memasukkan fail mereka ke dalam a atau pengguna <browse>
butang untuk memilih fail mereka. Lihat contoh di halaman utama saya.

Perhatikan bahawa jika $FILES_DISALLOWED_IN_CGI adalah 0 kemungkinan untuk pengguna anda membaca semua
fail httpd boleh baca (jika anda tidak menjalankan cgi- wrapper atau sesuatu seperti ini. By
lalai nilai ini ditetapkan kepada 1, jadi pembacaan fail melalui cgi tidak sepatutnya dibenarkan. Awak boleh
benarkan dengan tetapan $FILES_DISALLOWED_IN_CGI kepada 0 di bahagian atas skrip.

Pemilih input REDIRECT_URL memerlukan penjelasan khusus. Nama fail terbentuk daripada
kedua-dua pembolehubah persekitaran DOCUMENT_ROOT and REDIRECT_URL.

Jika anda mahu apache memanggil secara automatik code2html untuk semua fail kod sumber program anda
boleh melakukan ini dengan menambahkan dua baris ini pada srm.conf anda:

AddHandler text/x-sourcecode .c .cc .cpp .pas .h .p

Teks tindakan/x-sourcecode /cgi-bin/code2html?input-selector=REDIRECT_URL&foo=

atau sesuatu yang serupa dengan ini. Dalam baris AddHandle anda boleh memilih sambungan yang mana
melalui code2html.

BERKHATAN :: Jangan tambah .pl pada baris ini dan namakan skrip ini "code2html.pl". Ini akan terhasil
dalam satu gelung.

Juga pastikan anda memuatkan modul Tindakan (srm.conf).

Gantikan /cgi-bin/code2html dengan lokasi maya di mana fail boleh diakses.
Perhatikan bahagian "foo=". Apache menambahkan URL fail untuk dipaparkan pada penghujung fail
bahagian tindakan. Kami tidak memerlukan ini kerana kami menggunakan pembolehubah persekitaran REDIRECT_URL
namun kami tidak mahu menambah url pada rentetan pemilih input. Oleh itu kita
tambah bahagian "&foo=".

Terima kasih kepada Kevin Burton[e-mel dilindungi]> untuk idea. Beliau juga menyatakan bahawa

> Ia lebih berkuasa jika anda menggunakannya dalam Apache
> tag
>
>
>
> #dengan tag Tindakan anda di sini... dengan cara ini anda boleh
> #masih mempunyai fail .java biasa pada pelayan anda.
>
>
>

CONTOH

dengan anggapan code2html berada dalam direktori semasa, anda boleh menaip

code2html -l perl code2html.pl code2html.html

untuk menukar skrip ke dalam fail html.

Gunakan code2html dalam talian menggunakan perkhidmatan onworks.net