lgrind - Dalam talian di Awan

JADUAL:

NAMA

lgrind - kisar penyenaraian program yang bagus menggunakan LaTeX

NOTA

Halaman manual ini masih belum lapuk, tetapi mungkin tidak lama lagi kecuali seseorang meminta saya bekerja
di atasnya. Pertimbangkan dokumen LaTeX sebagai dokumen sebenar.

SINOPSIS

lgrind [ -e ] [ -i ] [ - ] [ -n ] [ -c ] [ -t ] [ -h ] [ -d <penerangan
fail> ] [ -l ] [ -s ] ...

DESCRIPTION

LGrind memformat sumber program dalam gaya yang bagus menggunakan LaTeX(1). Komen diletakkan dalam
roman, kata kunci dalam muka tebal, pembolehubah dalam huruf condong dan rentetan dalam fon mesin taip. Sumber
nombor baris fail muncul di jidar kanan (setiap 10 baris).

LGrind memproses fail inputnya dan menulis hasilnya kepada output standard. Keluaran ini
boleh disimpan untuk pengeditan kemudian, dimasukkan ke dalam dokumen yang lebih besar, dsb.

Pilihannya adalah:

-e memproses fail LaTeX untuk kod terbenam.

-i proses fail kod sumber untuk dimasukkan ke dalam dokumen LaTeX.

- mengambil input daripada input standard.

-n jangan kata kunci muka tebal.

-c jangan layan @, dsb. khas dalam komen.

-t tukar lebar tab (lalai 8).

-h menentukan teks untuk masuk ke pengepala.

-d menentukan fail definisi bahasa (lalai ialah
/usr/lib/texmf/tex/latex/lgrind/lgrindef).

-d! sama seperti di atas, tetapi tulis boleh laku yang ditampal.

-l menentukan bahasa yang hendak digunakan.

-s menunjukkan senarai bahasa yang diketahui pada masa ini.

Jika LGrind dipanggil tanpa parameter, skrin bantuan akan ditunjukkan. Jika tiada -e tidak -i
ditentukan, fail LaTeX lengkap dihasilkan. Apabila tiada bahasa ditentukan, LGrind
cuba untuk mengetahui bahasa yang digunakan itu sendiri; C digunakan apabila ini gagal.

PENGGUNAAN

Sebagai contoh, untuk memasukkan fail C bernama foo.c ke dalam dokumen LaTeX anda, mula-mula berikan
arahan:

lgrind -i -lc foo.c > foo.tex

Ini akan menjana foo.tex, yang akan mempunyai versi foo.c yang dicetak cantik dengan banyak
daripada arahan LaTeX.

Kemudian masukkan lgrind.sty semasa anda memasukkan gaya lain, iaitu dengan
baris \usepackage{lgrind} pada permulaan dokumen LaTeX anda. Setelah melakukan ini, dalam
dokumen yang anda boleh sertakan foo.tex menggunakan salah satu daripada arahan berikut:

\lgrindfile{foo.tex}
yang hanya akan memasukkan fail pada titik teks itu, dan akan menarik mendatar
baris sebelum dan selepas penyenaraian.

\lagrind[htbp]{foo.tex}{caption}{label}
yang akan meletakkan penyenaraian juga dalam persekitaran angka, menggunakan apungan
pilihan, kapsyen dan label yang anda berikan.

Untuk menghasilkan fail LaTeX kendiri daripada, katakan, fail Yacc:

lgrind -ly bary.y > bary.tex
Ini menggunakan fancyhdr.sty Piet van Oostrum untuk membuat pengepala dan pengaki.

Untuk penjelasan yang lebih terperinci tentang arahan ini, rujuk
/usr/TeX/texmf/doc/latex/lgrind.dvi.

DIPERBAIKI PROGRAM DALAM A LaTeX FAIL

(Daripada nota Jerry Leichter.)

Dalam teks fail LaTeX anda, anda menandakan kumpulan baris sebagai sama ada teks atau paparan-
kod program gaya:

Gaya teks:

Ekspresi
%(
a + 3
%)
menghasilkan 10.
mencetak sesuatu seperti: "Ungkapan a + 3 menghasilkan 10." (dengan set "a + 3" sebagai a
program.)

Kesan yang sama boleh dicapai dengan inline @'s.

Ungkapan @a + 3@ menghasilkan 10.

Gaya paparan:

Penyataan
%[
a += 3;
%]
ialah contoh pengendali kenaikan.
mencetak sesuatu seperti:

Penyataan
a += 3;
ialah contoh pengendali kenaikan.

Peraturan penting:

% dan aksara berikut mestilah dua aksara pertama pada baris itu
dikenali.

Meletakkan apa-apa pada baris selepas % dan aksara utama. Jika anda berbuat demikian, LGrind
akan menyediakan persekitaran lalai yang akan menghasilkan \hbox untuk %( )%, dan a
\vbox untuk %[ - %]. Jika anda meletakkan barangan pada baris, LGrind menganggap anda mahu
mengawal format sepenuhnya. Melakukan ini memerlukan pemahaman sebenarnya apa yang
kod yang dihasilkan LGrind sedang dilakukan. (Kadang-kadang saya tidak pasti saya lakukan!)

%) dan %] adalah, jika saya ingat betul, hanya diabaikan di luar kumpulan kod, tetapi mana-mana
tambahan %( atau %[ menghasilkan amaran, jadi %) atau %] yang hilang biasanya ditangkap.

Anda boleh memasukkan kod anda sendiri dengan menggunakan baris bermula dengan %= dalam teks program.
Apa sahaja yang anda masukkan selepas itu ditinggalkan dalam output, sama seperti anda menaipnya. Ia akan menjadi
dilaksanakan dalam persekitaran yang pelik, jadi melakukan apa-apa yang mewah adalah sangat rumit. Makro,
\Line, disediakan untuk membantu anda melakukan perkara mudah. Sebagai contoh,

%[
%=\Barisan{________\vdots}

a = 1;
%]
menghasilkan:

.
.
.
a = 1;

(Dalam teks program, _ aktif dan berkembang ke ruang lebar tetap. Sekumpulan besar
makro juga ditakrifkan. Jika anda memahami cara LGrind menetapkan barisan, anda boleh menggantikannya
8 _ dengan panggilan ke \Tab — tetapi saya akan membenarkan anda menggantung diri anda pada panggilan itu.)

Output LGrind sentiasa mengandungi tepat satu baris keluaran untuk setiap baris input. Oleh itu,
anda boleh mencari nombor baris dalam mesej ralat TeX dalam fail asal anda, bukannya dalam
fail lgrind'ed (lground?). (Sudah tentu, jika masalahnya adalah dalam output LGrind....)

Banyak perkara boleh dikawal dengan mentakrifkan semula pelbagai makro. Anda boleh menukar fon apa
LGrind akan menggunakan untuk pelbagai jenis perkara, berapa banyak ia mengesot output, sama ada ia
menambah nombor baris, dan jika ya pada selang berapa ia mencetaknya dan sama ada ia melekat padanya
kiri atau kanan, dan seterusnya. Perkara ini semuanya diterangkan dalam lgrind.dvi, walaupun mungkin
kurang sihat. Tetapan lalai menghasilkan output yang kelihatan munasabah kepada saya, walaupun saya
tidak boleh mengatakan saya sangat gembira mengenainya. Melakukan a benar-benar pekerjaan yang baik memerlukan penentuan beberapa
fon khas.

Gunakan lgrind dalam talian menggunakan perkhidmatan onworks.net