-
Notifications
You must be signed in to change notification settings - Fork 0
Accessibility tl
🌎 Wika: Tagalog (tl) — tingnan ang lahat ng 33 wika
LockedIn CLI ay isang biro, ngunit ang pagiging naa-access nito ay hindi. Ang terminal na UI na ganito kayaman — gradient wordmark, box-drawing card, braille spinners, emoji — ay talagang mahirap gamitin sa pantulong na teknolohiya maliban kung magdidisenyo ka para dito. Ipinapaliwanag ng page na ito kung ano ang ginagawa ng CLI, paano ito i-on, at ang pangkalahatang pinakamahusay na kagawian sa likod nito (kapaki-pakinabang na higit pa sa proyektong ito).
| Mode | Bandila | Env | Ano ang ginagawa nito |
|---|---|---|---|
| Screen reader |
--accessible (--a11y, --screen-reader) |
LOCKEDIN_ACCESSIBLE=1, o TERM=dumb
|
Malinis na linear na plain text: walang border, walang ASCII art, walang spinner motion, walang decorative glyph; walang kulay; maikling prompt; semantic landmark ("Post:" … "(end of post)"). |
| Mataas na contrast |
--high-contrast (--hc) |
LOCKEDIN_HIGH_CONTRAST=1 |
Isang high-contrast na palette para sa low vision: purong puting pangalawang text, mas maliwanag na mga accent, walang dim, solid na accent sa halip na ang low-contrast na gradient. |
| Mababang distraction |
--low-distraction (--calm, --reduce-motion) |
LOCKEDIN_LOW_DISTRACTION=1, LOCKEDIN_REDUCE_MOTION=1
|
Pinababang galaw (walang spinner animation), walang pandekorasyon na emoji, kalmadong solid na kulay — pinapanatili ang visual na layout. Para sa pinababang cognitive/sensory load. |
| Plain / monochrome |
--plain (--mono, --monochrome) |
LOCKEDIN_PLAIN=1, o NO_COLOR=1
|
Hindi pinapagana ang lahat ng kulay habang pinapanatili ang buong layout, mga hangganan, at emoji. Para sa mga terminal na may mahinang suporta sa kulay, pag-log, o kagustuhan. Mga override FORCE_COLOR. |
Sila nag-compose: --high-contrast --low-distraction nagbibigay sa iyo ng maliwanag, mahinahon, walang emoji na UI; isang gumagamit ng screen-reader sa a TERM=dumb awtomatikong nakakakuha ng accessible mode ang terminal. Kapag magkasalungat ang mga mode, mas mahigpit ang mananalo — ang monochrome ay natalo sa isang color palette, at ang screen-reader mode ay pumapalit sa plain.
lockedin --accessible post
lockedin --high-contrast
lockedin --plain post
LOCKEDIN_LOW_DISTRACTION=1 lockedin auraHindi mo kailangang magdesisyon nang harapan. Sa loob ng interactive na session, ang /a11y Ang slash command ay isang tunay, gumaganang control panel (ang accessibility ay hindi ang satire):
| Uri | Resulta |
|---|---|
/a11y |
Ipakita ang kasalukuyang estado (on/off) ng lahat ng apat na mode |
/a11y <mode> |
I-toggle ang isa: screen-reader, high-contrast, low-distraction, plain (mga alias tulad ng sr / hc / calm / mono trabaho din) |
/a11y reset |
I-off ang bawat mode |
Ang estado ay palaging ipinapakita bilang isang tahasang naka-on/naka-off na salita, hindi kailanman nag-iisa ng kulay — ang mismong mga user na pinaglilingkuran nito ay maaaring hindi mapansin ang kulay. Ang panel ay ganap na naisalokal.
Ito ang mga prinsipyong inilapat namin — ang parehong mga prinsipyo ay nalalapat sa anumang terminal tool.
- Semantics over decoration. Isang screen reader ang nagbabasa ng mga character. Ang mga hangganan ng box-drawing ay nagiging "horizontal line, horizontal line..."; isang ASCII-art wordmark ay ingay. Pinapalitan ng accessible mode ang visual na istraktura ng mga salita: ang splash ay nag-aanunsyo ng "LockedIn CLI" bilang text, at nakakakuha ang mga card ng landmarks ("Post:", "(end of post)") para malaman ng mga user kung saan magsisimula at magtatapos ang isang block.
- Huwag umasa sa kulay o mga icon na nag-iisa. Ibig sabihin na dala lang ng kulay o isang emoji ay hindi nakikita ng ilang user. Panatilihing makabuluhan ang teksto nang walang kulay — hal. Ang "Connected with Ava" ay magiging maayos kapag nawala ang ✔.
- Magbigay ng mga alternatibong text / tanggalin ang ingay. Basahin nang malakas ang pandekorasyon na emoji ("📥" → "tray ng inbox"). Ang naa-access na mode ay nagtatanggal ng mga pandekorasyon na glyph at pinapanatili ang mga salita; Ang low-distraction ay tinanggal ang malakas na emoji ngunit pinapanatili ang layout para sa mga nakikitang user na gusto lang ng kalmado.
-
Respect reduced motion. Animation (ang braille spinner) ay isang distraction at maaaring maging vestibular trigger. Mga naa-access at low-distraction mode hindi nag-a-animate — ipi-print nila ang status nang isang beses, statically. Sinasalamin nito ang web
prefers-reduced-motion. - Nag-aalok ng mataas na contrast. Ang pangalawang text na "muted grey" na low-contrast ay nabigo WCAG contrast para sa maraming user. Pinapalitan ito ng high-contrast mode para sa purong puti at nagpapatingkad ng mga accent.
- Bawasan ang cognitive load. Higit pa sa paningin, ang ilang mga user ay nangangailangan ng mas kaunti: mas kaunting pag-unlad, walang galaw, walang emoji. Iyan ay isang first-class mode dito, hindi isang nahuling pag-iisip.
-
Igalang ang mga kombensiyon sa platform. Iginagalang na ng CLI ang
NO_COLOR; ginagamot din nitoTERM=dumb(kung ano ang ini-export ng maraming screen-reader at Emacs shell) bilang "maa-access", at nababasaLOCKEDIN_REDUCE_MOTION. Ang pag-detect sa mga kasalukuyang signal ng user ay mabilis na ginagawang mag-configure sila ng isa pang bagay. - Gawin itong masusubok, at panatilihin itong nasubok. Nabubulok ang accessibility na wala sa test gate. Iginiit ng suite na ang naa-access na output ay may walang mga decorative glyph, na mayroong mga landmark, na pinapalitan ng mataas na contrast ang palette, at ang mababang-distraction ay nananatiling nakahanay sa hangganan — sa bawat wika.
Nabigo rin ang pag-format ng direksyon. Ang Arabic, Persian, Hebrew, at Urdu ay hindi naglalabas ng mga kontrol ng bidi maliban kung ang user ay tahasang nagtakda LOCKEDIN_BIDI=on para sa isang terminal na kilala na sumusuporta sa mga nakahiwalay; tinatanggal sila ng screen-reader mode kahit noon pa man. Walang TTY probe o terminal allowlist ang maaaring mag-override sa ligtas na default na iyon.
-
a11yFilter(s)strips decorative Unicode (box-drawing, block, geometric, technical, dingbats, braille, emoji) at nag-flush ng text sa kaliwa — inilapat sa lahat na output sa accessible mode. -
emojiFilter(s)ay ang mas magaan na filter na low-distraction: inaalis lang nito ang malakas na emoji/mga simbolo at pinapanatili ang box-drawing, mga bala, arrow, at kulay ng ANSI, kaya nananatili ang visual na layout. - Ang bagay na may kulay
Cay pinalitan sa isang high-contrast palette sa lugar; bumabalik ang mga gradient sa solidong accent kapag naka-on ang high-contrast o low-distraction. Ang Plain mode ay pinipilit ang bawatCwalang laman ang entry (walang laman ang kulay, kahit sa ilalimFORCE_COLOR) habang iniiwan ang layout na hindi nagalaw. -
renderSplash, ang spinner,renderPrompt, atcardmay semantic branches para sa accessible mode (plain text, no motion, landmarks). - Nabubuhay ang detection
detectAccessible/detectHighContrast/detectLowDistraction/detectPlain; inilalapat ng entry point ang mga ito bago i-render. Ang nasa session/a11yutos (handleA11y+renderA11yStatus) i-toggle nang live ang parehong estado sa antas ng module.
Ang tutorial review checklist ay may kasamang hakbang sa pagiging naa-access, at isa itong magandang ugali kahit saan:
Tumakbo
lockedin --accessible <your command>at kumpirmahin na ito ay nagbabasa bilang malinis na plain text — walang mga bagong dekorasyong glyph na dumaan sa filter — at ang anumang bagong structured na bloke ay may palatandaan. Pagkatapos ay subukan--high-contrast,--low-distraction, at--plain(na dapat maglabas ng hindi mga code ng kulay ngunit panatilihin ang layout). Ang bagong text na nakikita ng user ay nangangailangan ng susi sa bawat bundle ng wika, kaya ang/a11ypanel at tumulong na manatiling isinalin.
Satire. Hindi kaakibat sa LinkedIn. GPL-3.0-or-later.
Tutorial
- 1 · Orientation
- 2 · How the Code Works
- 3 · Your First Agent Task
- 4 · Prompting & Reviewing
- 5 · Localization
Reference
Satire · Sátira · 風刺. Not affiliated with LinkedIn. GPL-3.0-or-later.