boxes - Online sa Cloud

PROGRAMA:

NAME

mga kahon - kahon ng text mode at filter ng pagguhit ng komento

SINOPSIS

kahon [-hlmrv] [-a format] [-d design] [-f file] [-i indent] [-k bool] [-p pad] [-s size]
[-t tabopts] [infile [outfile]]

DESCRIPTION

Mga kahon ay isang text filter na maaaring gumuhit ng anumang uri ng kahon sa paligid ng input text nito. Disenyo ng kahon
ang mga pagpipilian ay mula sa mga simpleng kahon hanggang sa kumplikadong sining ng ASCII. Maaari ding tanggalin ang isang kahon at
naayos, kahit na ito ay nasira nang husto sa pamamagitan ng pag-edit ng teksto sa loob. Dahil ang mga kahon ay maaaring
maging bukas sa anumang panig, kahon ay maaari ding gamitin upang lumikha ng mga panrehiyong komento sa anumang programming
wika. Ang mga bagong disenyo ng kahon ng lahat ng uri ay madaling maidagdag at maibahagi sa pamamagitan ng pagdaragdag sa a
libreng format na configuration file.
kahon ay orihinal na inilaan upang gamitin sa kalakasan(1) text editor, ngunit maaari itong itali
sa anumang text editor na sumusuporta sa mga filter, pati na rin ang tawag mula sa command line bilang a
nakapag-iisang tool.

Opsyon

Mga opsyon na inaalok ng kahon ang mga sumusunod:

-a pisi
Pag-align/pagposisyon ng teksto sa loob ng kahon. Ang pagpipiliang ito ay tumatagal ng isang format na argumento ng string
na binabasa mula kaliwa hanggang kanan. Ang format na string ay maaaring hindi naglalaman ng whitespace at
dapat binubuo ng isa o higit pa sa mga sumusunod na sangkap:

hx - pahalang na pagkakahanay ng input text block sa loob ng isang potensyal na mas malaking kahon.
Mga posibleng halaga para sa x ay l (ell, para sa left alignment), c (gitna), o r (tama).
Hindi ito nakakaapekto sa pagbibigay-katwiran ng mga linya ng teksto sa loob ng bloke ng teksto ng input
(gamitin ang j argument sa halip).
vx - vertical alignment ng input text block sa loob ng isang potensyal na mas malaking kahon.
Mga posibleng halaga para sa x ay t (para sa itaas na pagkakahanay), c (gitna), o b (ibaba).
jx - pagbibigay-katwiran ng mga linya sa loob ng bloke ng teksto ng input. Mga posibleng halaga para sa x ay l
(ell, para sa kaliwang katwiran), c (gitna), o r (kanan). Hindi ito nakakaapekto sa
alignment ng input text block mismo sa loob ng kahon. Gamitin ang h at v argumento
para sa pagpoposisyon ng bloke ng teksto ng input.

Mga notasyon ng maikling kamay (maaaring isama sa mga argumento sa itaas):
l (ell) - maikli para sa hlvcjl
c - maikli para sa hcvcjc
r - maikli para sa hrvcjr

Ang factory default na setting para sa -a is hlvt.

-c pisi
Depinisyon ng disenyo ng command line para sa mga simpleng kaso. Ang argumento ng pagpipiliang ito ay ang
kahulugan para sa "kanluran" (W) na hugis. Ang tinukoy na hugis ay dapat na binubuo ng eksaktong isa
linya, ibig sabihin, walang mga multi-line na hugis ang pinapayagan. Ang -c ang pagpipilian ay inilaan bilang isang shortcut
para sa mga kaso kung saan gagawin ang mga simpleng komento sa rehiyon, na nangangailangan lamang ng a
tiyak na karakter o pagkakasunod-sunod ng mga karakter na ilalagay sa harap ng bawat linya. Sa
tulad ng mga kaso, ito ay mas maginhawa upang tukuyin lamang -c kaysa gumawa ng isang kumpletong
kahulugan ng disenyo sa config file ng isang tao, kung saan ang tanging hugis na tinukoy ay ang kanluran
Hugis.
Ang pagpipiliang ito ay nagpapahiwatig ng a -d at hindi ina-access ang config file. -c maaaring siyempre
ginagamit kasabay ng alinman sa iba pang mga opsyon. Bilang default, -c ay hindi tinukoy.

-d pisi
Pagpili ng disenyo. Ang isang argumento ng opsyong ito ay ang pangalan ng disenyo na gagamitin.

-f pisi
Gumamit ng kahaliling config file. Ang isang argumento ng opsyong ito ay ang pangalan ng valid
kahon config file, na naglalaman ng mga bago at kapana-panabik na disenyo!

-h I-print ang impormasyon sa paggamit.

-i pisi
Indentation mode. Ang mga posibleng argumento ay "text" (indent text sa loob ng box), "box"
(indent box, hindi text sa loob ng box), o "wala" (itapon ang indentation). Mga argumento
maaaring paikliin. Ang default ay i-indent ang kahon, ngunit hindi ang teksto.

-k bool
Patayin ang mga nangunguna/hugot na mga blangkong linya sa pag-alis. Ang halaga ng bool maaaring tukuyin bilang
on, yes, true, 1, o t, lahat ay nangangahulugang oo, o off, hindi, mali, 0, o f, na nangangahulugang hindi.
Ito ay case-insensitive. Ang pagpipiliang ito ay magkakabisa lamang kaugnay ng -r. Kung
nakatakda sa oo, ang mga nangunguna at sumusunod na mga blangkong linya ay aalisin sa output. Kung itinakda
sa hindi, ang buong nilalaman ng dating kahon ay ibinalik. Ang default ay hindi, kung pareho
ang itaas at ibabang bahagi ng kahon ay bukas, gaya ng kaso ng karamihan sa rehiyon
mga komento. Kung ang disenyo ng kahon ay tumutukoy sa isang itaas na bahagi o isang ilalim na bahagi, ang default ay
Oo.

-l (ell) Listahan ng mga disenyo. Gumagawa ng isang listahan ng lahat ng magagamit na mga disenyo ng kahon sa config
file, kasama ang isang sample na kahon at impormasyon tungkol sa lumikha nito. Nagsusuri din
syntax ng buong config file. Kung ginamit kaugnay ng -d, nagpapakita ng detalyado
impormasyon tungkol sa tinukoy na disenyo.

-m Pag-aayos ng kahon. Inaalis nito ang isang (potensyal na sira) na kahon tulad ng sa -r, at muling iginuhit ito
pagkatapos. Ang naayos na kahon ay iginuhit ayon sa mga opsyon na ibinigay. Ito ay maaaring
mahalagang malaman pagdating sa pagpapanumbalik ng padding, pagkakakilanlan, atbp. para sa
inayos na kahon. Nagpapahiwatig -k mali.

-p pisi
Padding. Tukuyin ang padding sa mga puwang sa paligid ng input text block para sa lahat ng panig ng
kahon. Ang argument string ay maaaring hindi naglalaman ng whitespace at dapat na binubuo ng a
kumbinasyon ng mga sumusunod na character, ang bawat isa ay sinusundan ng isang numero na nagpapahiwatig ng
padding sa mga espasyo:
a - (lahat) bigyan ng padding para sa lahat ng panig nang sabay-sabay
h - (horiz) magbigay ng padding para sa magkabilang pahalang na gilid
v - (vertical) magbigay ng padding para sa magkabilang vertical na gilid
b - (ibaba) bigyan ng padding para sa ilalim (timog) na bahagi
l - (kaliwa) bigyan ng padding para sa kaliwa (kanluran) gilid
t - (itaas) bigyan ng padding para sa itaas (hilaga) na bahagi
r - (kanan) bigyan ng padding para sa kanan (silangan) gilid
Halimbawa: -p a4t2 ay tutukuyin ang padding na 4 na character sa lahat ng panig, maliban
para sa itaas ng kahon, kung saan 2 linya lang ang layo ng input text block
ang kahon.
Bilang default, maliban kung tinukoy sa config file, walang padding na ginagamit.

-r Alisin ang kahon. Inaalis ang isang umiiral na kahon sa halip na iguhit ito. Aling disenyo ang gagamitin
awtomatikong natukoy. Upang makatipid ng oras o kung sakaling ang pagtuklas ay hindi
magpasya nang tama, pagsamahin sa -d upang tukuyin ang disenyo. Ang default ay gumuhit ng a
bagong kahon.

-s lapadxtaas
Laki ng kahon. Tinutukoy ng pagpipiliang ito ang nais na laki ng kahon sa mga yunit ng mga haligi (para sa lapad)
at mga linya (para sa taas). Kung iisang numero lamang ang ibibigay bilang argumento, ang numerong ito
tumutukoy sa nais na lapad ng kahon. Ang isang numerong may prefix na 'x' ay tumutukoy lamang sa
taas ng kahon. Ang aktwal na resultang laki ng kahon ay maaaring mag-iba depende sa indibidwal
mga sukat ng hugis ng napiling disenyo. Gayundin, ang ibang mga opsyon sa command line ay maaaring maka-impluwensya sa
laki ng kahon (tulad ng -p).
Bilang default, ang pinakamaliit na posibleng kahon ay nilikha sa paligid ng teksto.

-t pisi
Paghawak ng tab. Kinokontrol ng opsyong ito kung paano pinangangasiwaan ang mga character ng tab sa input text.
Ang pagpipiliang string ay dapat palaging magsimula sa a matindi numero na nagpapahiwatig ng distansya
sa pagitan ng mga tab stop. Mahalagang maitakda nang tama ang value na ito, o tabulator
maaasar ng mga character ang iyong input text. Ang tamang halaga ng distansya ng tab ay nakasalalay sa
ang mga setting na ginamit para sa text na iyong pinoproseso. Ang karaniwang halaga ay 8.
Kaagad na sinusundan ang distansya ng tab, maaaring magdagdag ng opsyonal na character,
mabigat kahon kung paano ituring ang mga nangungunang tab. Available ang mga sumusunod na opsyon:
e - palawakin ang mga tab sa mga puwang
k - panatilihing malapit ang mga tab sa kung ano sila hangga't maaari
u - i-unexpand ang mga tab. Ginagawa nitong kahon gawing mga tab ang pinakamaraming espasyo hangga't maaari.

Upang mapanatili ang pabalik na pagkakatugma, ang -t pisi maaaring numero lamang. Sa
kaso, e ay ipinapalagay para sa paghawak ng tab, na nag-aalis ng lahat ng mga tab at pinapalitan ang mga ito
may mga espasyo. Ang factory default para sa -t ang opsyon ay 8 lang, na ganoon lang
kaso.
Halimbawa, maaari mong tukuyin -t 4u upang hindi mapalawak ang iyong mga nangungunang tab.
Sa nilalaman ng kahon, ang mga tab ay palaging kino-convert sa mga puwang. Ang layo ng tab dito
halimbawa ay 4.

-v I-print ang kasalukuyang numero ng bersyon.

Configuration MGA FILE

Mga kahon gagamit ng configuration file na tinukoy sa command line (gamit ang -f). Kung hindi
config file ay tinukoy sa command line, kahon ay titingnan ang kapaligiran ng BOXES
variable, na maaaring maglaman ng filename na gagamitin. Kung hindi nakatakda ang BOXES, kahon susubukan na basahin
$HOME/.boxes at gamitin ito bilang config file. Kapag nabigo iyon, kahon susubukan na basahin ang
system-wide config file (tingnan ang FILES).

Ang syntax ng kahon config file ay inilarawan sa website (tingnan sa ibaba). Sila ay medyo
self-explanatory, bagaman.

KAPANGYARIHAN

Mga kahon ay makukuha mula sa website nito sahttp://boxes.thomasjensen.com/>. Ang website
nagtatampok din ng ilang mga halimbawa na naglalarawan sa manwal na pahinang ito pati na rin ng mas malalim
dokumentasyon.

Magpatala nang umalis kalakasan(1) sahttp://www.vim.org/>!

Gumamit ng mga kahon online gamit ang mga serbisyo ng onworks.net