Accessibility tr

Erişilebilirlik

🌎 Dil: Türkçe — 33 dilin tümüne bakın

LockedIn CLI bir şakadır, ama erişilebilirliği şaka değildir. Görsel açıdan bu kadar zengin bir terminal arayüzü — gradyanlı kelime işareti, kutu çizgili kartlar, braille döndürücüler, emoji — yardımcı teknolojiyle kullanmak, onun için tasarlamadıkça gerçekten zordur. Bu sayfa CLI'ın ne yaptığını, onu nasıl açacağınızı ve arkasındaki genel en iyi uygulamaları açıklar (bu projenin çok ötesinde de yararlıdır).

Dört mod

Mod	Bayrak	Ortam değişkeni	Ne yapar
Ekran okuyucu	--accessible (--a11y, --screen-reader)	LOCKEDIN_ACCESSIBLE=1, veya TERM=dumb	Temiz, doğrusal düz metin: kenarlık yok, ASCII art yok, döndürücü hareketi yok, dekoratif glif yok; renk kapalı; kısa istem; anlamsal yer işaretleri ("Post:" … "(end of post)").
Yüksek kontrast	--high-contrast (--hc)	LOCKEDIN_HIGH_CONTRAST=1	Az görenler için yüksek kontrastlı bir palet: saf beyaz ikincil metin, daha parlak vurgular, sönükleştirme yok, düşük kontrastlı gradyan yerine yekpare vurgu.
Düşük dikkat dağıtma	--low-distraction (--calm, --reduce-motion)	LOCKEDIN_LOW_DISTRACTION=1, LOCKEDIN_REDUCE_MOTION=1	Azaltılmış hareket (döndürücü animasyonu yok), dekoratif emoji yok, sakin yekpare renk — görsel düzeni korur. Bilişsel/duyusal yükü azaltmak için.
Sade / tek renk	--plain (--mono, --monochrome)	LOCKEDIN_PLAIN=1, veya NO_COLOR=1	Tam düzeni, kenarlıkları ve emojiyi korurken tüm rengi devre dışı bırakır. Renk desteği zayıf terminaller, günlükleme veya tercih için. FORCE_COLOR'ı geçersiz kılar.

Bunlar birleşir: --high-contrast --low-distraction size parlak, sakin, emojisiz bir arayüz verir; TERM=dumb terminalindeki bir ekran okuyucu kullanıcısı otomatik olarak erişilebilir mod alır. Modlar çakıştığında, daha kısıtlayıcı olan kazanır — tek renk, renk paletini yener ve ekran okuyucu modu sadeyi geçersiz kılar.

lockedin --accessible post
lockedin --high-contrast
lockedin --plain post
LOCKEDIN_LOW_DISTRACTION=1 lockedin aura

Oturum içinde mod değiştirme: /a11y

Önceden karar vermek zorunda değilsiniz. Etkileşimli oturum içinde, /a11y slash komutu gerçek, çalışan bir kontrol panelidir (erişilebilirlik hiciv değildir):

Yazın	Sonuç
/a11y	Dört modun tümünün geçerli durumunu (açık/kapalı) gösterir
/a11y <mode>	Birini değiştir: screen-reader, high-contrast, low-distraction, plain (sr / hc / calm / mono gibi takma adlar da çalışır)
/a11y reset	Her modu kapat

Durum her zaman açık açık/kapalı sözcüğü olarak gösterilir, asla yalnızca renkle değil — bunun hizmet ettiği kullanıcılar rengi algılamayabilir. Panel tamamen yerelleştirilmiştir.

Arkasındaki en iyi uygulamalar

Uyguladığımız ilkeler bunlardır — aynıları herhangi bir terminal aracı için geçerli.

1. Süslemeden önce anlambilim. Bir ekran okuyucu karakterleri okur. Kutu çizgi kenarlıkları "yatay çizgi, yatay çizgi…" olur; ASCII art bir kelime işareti gürültüdür. Erişilebilir mod, görsel yapıyı sözcüklerle değiştirir: açılış ekranı "LockedIn CLI"ı metin olarak duyurur ve kartlar yer işaretleri alır ("Post:", "(end of post)") böylece kullanıcılar bir bloğun nerede başlayıp bittiğini bilir.
2. Asla yalnızca renge veya simgelere güvenmeyin. Yalnızca renk veya bir emoji tarafından taşınan anlam, bazı kullanıcılar için görünmezdir. Renk kapalıyken metni anlamlı tutun — örn. ✔ gittiğinde "Connected with Ava" gayet iyi okunur.
3. Metin alternatifleri sağlayın / gürültüyü kaldırın. Dekoratif emoji sesli olarak uzun uzun okunur ("📥" → "inbox tray"). Erişilebilir mod tamamen dekoratif glifleri kaldırır ve sözcükleri korur; düşük dikkat dağıtma, gürültülü emojiyi kaldırır ama yalnızca sakinlik isteyen gören kullanıcılar için düzeni korur.
4. Azaltılmış harekete saygı gösterin. Animasyon (braille döndürücü) bir dikkat dağıtıcıdır ve vestibüler bir tetikleyici olabilir. Erişilebilir ve düşük dikkat dağıtma modları animasyon yapmaz — durumu bir kez, statik olarak yazdırır. Bu, web'in prefers-reduced-motion'ını yansıtır.
5. Yüksek kontrast sunun. Düşük kontrastlı "soluk gri" ikincil metin, birçok kullanıcı için WCAG kontrastında başarısız olur. Yüksek kontrast modu onu saf beyazla değiştirir ve vurguları parlatır.
6. Bilişsel yükü azaltın. Görmenin ötesinde, bazı kullanıcılar daha az'a ihtiyaç duyar: daha az süsleme, hareket yok, emoji yok. Bu burada birinci sınıf bir moddur, sonradan akla gelen bir şey değil.
7. Platform kurallarına uyun. CLI zaten NO_COLOR'a saygı gösterir; ayrıca TERM=dumb'ı (birçok ekran okuyucu ve Emacs kabuğunun dışa aktardığı şey) "erişilebilir moda geç" olarak değerlendirir ve LOCKEDIN_REDUCE_MOTION'ı okur. Kullanıcının mevcut sinyallerini algılamak, ona bir şeyi daha yapılandırtmaktan iyidir.
8. Test edilebilir kılın ve test edilmiş tutun. Test kapısında olmayan erişilebilirlik çürür. Paket, erişilebilir çıktının dekoratif glif içermediğini, yer işaretlerinin mevcut olduğunu, yüksek kontrastın paleti değiştirdiğini ve düşük dikkat dağıtmanın kenarlık hizalı kaldığını doğrular — her dilde.

Yönlü biçimlendirme de hataya karşı kapalıdır. Arapça, Farsça, İbranice ve Urduca, kullanıcı izolatları desteklediği bilinen bir terminal için açıkça LOCKEDIN_BIDI=on ayarlamadıkça hiçbir bidi kontrolü yaymaz; ekran okuyucu modu onları o zaman bile kaldırır. Hiçbir TTY yoklaması veya terminal izin listesi bu güvenli varsayılanı geçersiz kılamaz.

Nasıl inşa edildi (meraklılar için)

• a11yFilter(s) dekoratif Unicode'u (kutu çizimi, blok, geometrik, teknik, dingbat, braille, emoji) kaldırır ve metni sola yaslar — erişilebilir modda tüm çıktıya uygulanır.
• emojiFilter(s) daha hafif düşük dikkat dağıtma filtresidir: yalnızca gürültülü emoji/sembolleri kaldırır ve kutu çizimi, madde işaretleri, okları ve ANSI rengini korur, böylece görsel düzen hayatta kalır.
• Renk nesnesi C yerinde yüksek kontrastlı bir paletle değiştirilir; yüksek kontrast veya düşük dikkat dağıtma açıkken gradyanlar yekpare bir vurguya geri döner. Sade mod her C girdisini boşa zorlar (renk tamamen kapalı, FORCE_COLOR altında bile) düzeni el değmeden bırakırken.
• renderSplash, döndürücü, renderPrompt ve card, erişilebilir mod için anlamsal dallara sahiptir (düz metin, hareket yok, yer işaretleri).
• Algılama detectAccessible / detectHighContrast / detectLowDistraction / detectPlain'de yaşar; giriş noktası bunları render'dan önce uygular. Oturum içi /a11y komutu (handleA11y + renderA11yStatus) aynı modül düzeyindeki durumu canlı olarak değiştirir.

Bir özellik eklerken çalışır tutma

Eğitimin inceleme kontrol listesi bir erişilebilirlik adımı içerir ve bu her yerde iyi bir alışkanlıktır:

lockedin --accessible <your command> çalıştırın ve temiz düz metin olarak okunduğunu — filtreden sızan yeni dekoratif glif yok — ve her yeni yapılandırılmış bloğun bir yer işareti olduğunu doğrulayın. Ardından --high-contrast, --low-distraction ve --plain'i deneyin (bu, hiçbir renk kodu yaymamalı ama düzeni korumalıdır). Kullanıcıya görünen yeni metin, her dil paketinde bir anahtara ihtiyaç duyar, böylece /a11y paneli ve yardım çevrili kalır.

---

_{Hiciv. LinkedIn ile bağlantılı değildir. GPL-3.0-or-later.}