kotak - Dalam talian di Awan

JADUAL:

NAMA

kotak - kotak mod teks dan penapis lukisan ulasan

SINOPSIS

kotak [-hlmrv] [-a format] [-d reka bentuk] [-f fail] [-i indent] [-k bool] [-p pad] [-s saiz]
[-t tabobts] [infile [outfile]]

DESCRIPTION

Selamat ialah penapis teks yang boleh melukis sebarang jenis kotak di sekeliling teks inputnya. Reka bentuk kotak
pilihan terdiri daripada kotak ringkas kepada seni ASCII yang kompleks. Kotak juga boleh dikeluarkan dan
dibaiki, walaupun ia telah rosak teruk oleh penyuntingan teks di dalamnya. Oleh kerana kotak boleh
terbuka di mana-mana pihak, kotak juga boleh digunakan untuk membuat ulasan serantau dalam sebarang pengaturcaraan
bahasa. Reka bentuk kotak baharu dalam semua jenis boleh ditambah dan dikongsi dengan mudah dengan melampirkan a
fail konfigurasi format percuma.
kotak pada asalnya bertujuan untuk digunakan dengan VIM(1) editor teks, tetapi ia boleh diikat
kepada mana-mana editor teks yang menyokong penapis, serta dipanggil daripada baris arahan sebagai a
alat kendiri.

PILIHAN

Pilihan yang ditawarkan oleh kotak adalah yang berikut:

-a rentetan
Penjajaran/kedudukan teks di dalam kotak. Pilihan ini mengambil hujah rentetan format
yang dibaca dari kiri ke kanan. Rentetan format mungkin tidak mengandungi ruang putih dan
mesti terdiri daripada satu atau lebih daripada komponen berikut:

hx - penjajaran mendatar blok teks input di dalam kotak yang berpotensi lebih besar.
Nilai yang mungkin untuk x adalah l (ell, untuk penjajaran kiri), c (tengah), atau r (kanan).
Ini tidak menjejaskan justifikasi baris teks dalam blok teks input
(menggunakan j hujah sebaliknya).
vx - penjajaran menegak blok teks input di dalam kotak yang berpotensi lebih besar.
Nilai yang mungkin untuk x adalah t (untuk penjajaran atas), c (tengah), atau b (bawah).
jx - justifikasi baris dalam blok teks input. Nilai yang mungkin untuk x adalah l
(ell, untuk justifikasi kiri), c (tengah), atau r (kanan). Ini tidak menjejaskan
penjajaran blok teks input itu sendiri dalam kotak. Menggunakan h and v hujah
untuk kedudukan blok teks input.

Notasi tangan pendek (boleh digabungkan dengan hujah di atas):
l (ell) - singkatan dari hlvcjl
c - ringkasan untuk hcvcjc
r - ringkasan untuk hrvcjr

Tetapan lalai kilang untuk -a is hlvt.

-c rentetan
Definisi reka bentuk baris arahan untuk kes mudah. Hujah pilihan ini ialah
takrifan untuk bentuk "barat" (W). Bentuk yang ditentukan mesti mengandungi tepat satu
garisan, iaitu tiada bentuk berbilang garisan dibenarkan. The -c pilihan bertujuan sebagai jalan pintas
bagi kes-kes di mana ulasan serantau mudah dibuat, yang hanya memerlukan a
watak atau urutan watak tertentu untuk diletakkan di hadapan setiap baris. Dalam
kes sedemikian, adalah lebih mudah untuk dinyatakan dengan mudah -c daripada melakukan yang lengkap
definisi reka bentuk dalam fail konfigurasi seseorang, di mana satu-satunya bentuk yang ditakrifkan ialah barat
bentuk.
Pilihan ini membayangkan a -d dan tidak mengakses fail konfigurasi. -c mungkin sudah tentu
digunakan bersama dengan mana-mana pilihan lain. Secara lalai, -c tidak dinyatakan.

-d rentetan
Pemilihan reka bentuk. Satu hujah pilihan ini ialah nama reka bentuk untuk digunakan.

-f rentetan
Gunakan fail konfigurasi alternatif. Satu hujah pilihan ini ialah nama yang sah
kotak fail konfigurasi, mengandungi reka bentuk baharu dan menarik!

-h Cetak maklumat penggunaan.

-i rentetan
Mod lekukan. Argumen yang mungkin ialah "teks" (teks inden di dalam kotak), "kotak"
(kotak inden, bukan teks di dalam kotak), atau "tiada" (buang lekukan). Hujah
boleh disingkatkan. Lalai adalah untuk mengendenkan kotak, tetapi bukan teks.

-k bool
Matikan garisan kosong di hadapan/mengekor apabila dialih keluar. Nilai bool boleh dinyatakan sebagai
on, yes, true, 1, or t, all meaning yes, or off, no, false, 0, or f, which means no.
Ini tidak peka huruf besar-besaran. Pilihan ini hanya berkuat kuasa berkaitan dengan -r. Jika
ditetapkan kepada ya, garisan kosong di hadapan dan di belakang akan dialih keluar daripada output. Jika ditetapkan
kepada tidak, keseluruhan kandungan bekas kotak dikembalikan. Lalainya ialah tidak, jika kedua-duanya
bahagian atas dan bahagian bawah kotak terbuka, seperti yang berlaku pada kebanyakan wilayah
komen. Jika reka bentuk kotak mentakrifkan bahagian atas atau bahagian bawah, lalainya ialah
ya.

-l (ell) Senaraikan reka bentuk. Menghasilkan senarai semua reka bentuk kotak yang tersedia dalam konfigurasi
fail, bersama-sama dengan kotak sampel dan maklumat tentang penciptanya. Juga memeriksa
sintaks keseluruhan fail konfigurasi. Jika digunakan berkaitan dengan -d, memaparkan terperinci
maklumat mengenai reka bentuk yang ditetapkan.

-m Membaiki kotak. Ini mengalih keluar kotak (berkemungkinan pecah) seperti dengan -r, dan melukisnya semula
selepas itu. Kotak yang telah diperbaiki dilukis mengikut pilihan yang diberikan. Ini mungkin
penting untuk diketahui apabila ia datang untuk memulihkan pelapik, pengenalan, dll. untuk
kotak yang telah diperbaiki. menyiratkan -k salah.

-p rentetan
Padding. Tentukan padding dalam ruang di sekeliling blok teks input untuk semua sisi
kotak. Rentetan hujah mungkin tidak mengandungi ruang putih dan mesti mengandungi a
gabungan aksara berikut, setiap satu diikuti dengan nombor yang menunjukkan
padding dalam ruang:
a - (semua) berikan padding untuk semua sisi sekaligus
h - (horiz) memberi padding untuk kedua-dua belah mendatar
v - (menegak) memberi padding untuk kedua-dua belah menegak
b - (bawah) beri padding untuk bahagian bawah (selatan).
l - (kiri) beri padding untuk sebelah kiri (barat).
t - (atas) beri padding untuk bahagian atas (utara).
r - (kanan) beri padding untuk sebelah kanan (timur).
Contoh: -p a4t2 akan mentakrifkan padding menjadi 4 aksara pada semua sisi, kecuali
untuk bahagian atas kotak, di mana blok teks input akan berada hanya 2 baris darinya
kotak itu.
Secara lalai, melainkan dinyatakan sebaliknya dalam fail konfigurasi, tiada padding digunakan.

-r Keluarkan kotak. Mengalih keluar kotak sedia ada dan bukannya melukisnya. Reka bentuk mana yang hendak digunakan ialah
dikesan secara automatik. Untuk menjimatkan masa atau sekiranya pengesanan tidak
buat keputusan dengan betul, gabungkan dengan -d untuk menentukan reka bentuk. Lalai adalah untuk melukis a
kotak baru.

-s lebarxketinggian
Saiz kotak. Pilihan ini menentukan saiz kotak yang dikehendaki dalam unit lajur (untuk lebar)
dan garisan (untuk ketinggian). Jika hanya satu nombor diberikan sebagai hujah, nombor ini
menentukan lebar kotak yang dikehendaki. Nombor tunggal yang diawali dengan 'x' menyatakan hanya
ketinggian kotak. Saiz kotak sebenar yang terhasil mungkin berbeza bergantung pada individu
saiz bentuk reka bentuk yang dipilih. Juga, pilihan baris arahan lain mungkin mempengaruhi
saiz kotak (seperti -p).
Secara lalai, kotak terkecil mungkin dibuat di sekeliling teks.

-t rentetan
Pengendalian tab. Pilihan ini mengawal cara aksara tab dalam teks input dikendalikan.
Rentetan pilihan mesti sentiasa bermula dengan a uint nombor yang menunjukkan jarak
antara hentian tab. Adalah penting bahawa nilai ini ditetapkan dengan betul, atau penjadual
aksara akan mengganggu teks input anda. Nilai jarak tab yang betul bergantung pada
tetapan yang digunakan untuk teks yang anda sedang memproses. Nilai biasa ialah 8.
Sejurus selepas jarak tab, aksara pilihan boleh ditambah,
memberitahu kotak bagaimana untuk merawat tab terkemuka. Pilihan berikut tersedia:
e - kembangkan tab ke dalam ruang
k - jaga tab sedekat mungkin dengan keadaan mereka
u - nyahkembangkan tab. Ini menjadikan kotak tukar sebanyak mungkin ruang menjadi tab.

Untuk mengekalkan keserasian ke belakang, the -t rentetan boleh jadi nombor sahaja. Dalam
kes itu, e diandaikan untuk pengendalian tab, yang mengalih keluar semua tab dan menggantikannya
dengan ruang. Lalai kilang untuk -t pilihan adalah hanya 8, yang hanya seperti itu
kes.
Sebagai contoh, anda boleh menentukan -t 4u agar tab terkemuka anda tidak dikembangkan.
Dalam kandungan kotak, tab sentiasa ditukar kepada ruang. Jarak tab dalam ini
contohnya ialah 4.

-v Cetak nombor versi semasa.

CONFIGURATION FILES

Selamat akan menggunakan fail konfigurasi yang ditentukan pada baris arahan (menggunakan -f). Jika tidak
fail konfigurasi ditentukan pada baris arahan, kotak akan menyemak persekitaran BOXES
pembolehubah, yang mungkin mengandungi nama fail untuk digunakan. Jika BOXES tidak ditetapkan, kotak akan cuba membaca
$HOME/.boxes dan gunakannya sebagai fail konfigurasi. Gagal itu, kotak akan cuba membaca
fail konfigurasi seluruh sistem (lihat FILES).

Sintaks bagi kotak fail konfigurasi diterangkan di tapak web (lihat di bawah). Mereka agak
jelas sendiri, walaupun.

KETERSEDIAAN

Selamat boleh didapati daripada laman webnya dihttp://boxes.thomasjensen.com/>. Laman web
turut menampilkan beberapa contoh yang menggambarkan halaman manual ini serta lebih mendalam
dokumentasi.

Daftar keluar VIM(1) dihttp://www.vim.org/>!

Gunakan kotak dalam talian menggunakan perkhidmatan onworks.net