KoliBri'ye Hoşgeldiniz

contributors

"Erişilebilir HTML standardı"

KoliBri geleneksel anlamda bir tasarım sistemi değildir. Bunun yerine, HTML5 standardını kendi kendine yeterli, erişilebilir Web Components ile genişletiriz — herhangi bir tasarım veya markadan bağımsız olarak çalışan yeni HTML öğeleri. Bu atomik bileşenler, herhangi bir tasarım kütüphanesinin, framework'ün veya stil rehberinin gereksinimlerine göre yeniden kullanabileceği ve tema verebileceği bir temel oluşturur.

KoliBri "erişilebilirlik için bileşen kütüphanesi" anlamına gelir ve Informationstechnikzentrum Bund (ITZBund) tarafından açık kaynak olarak yeniden kullanım ve devam eden geliştirme için yayınlanmıştır.

Vizyon

Birlikte HTML'yi yeniden kullanılabilir web bileşenleri kullanarak erişilebilir hale getirerek kullanılabilirlik ve erişilebilirlik sağlıyoruz.

Misyon

HTML web standardı kendisi, mümkün olduğunca uzun ömürlü ve sağlam olabilmesi için çok "açık" bir şekilde belirtilmiştir. Bu nedenle HTML bileşimlerinin kolayca erişilebilir, semantik ve geçerli olmadığı durumlar sıklıkla ortaya çıkar.

KoliBri doğrudan W3C tarafından belirlenen Web standartlarına (framework-agnostik) dayalıdır ve WCAG standardının ve BITV erişilebilirlik standardının genel bir referans uygulamasıdır ve çok temalaşabilir bir sunum katmanı olarak uygulanmıştır. Teknik referans ve veri aktarım işlevselliği yoktur. Bu, KoliBri'nin hem statik web siteleri gerçekleştirmek hem de farklı kurumsal tasarımlar ve stil rehberleri ile dinamik web uygulamaları gerçekleştirmek için eşit şekilde yeniden kullanılabilir olmasını anlamına gelir ve bu nedenle açık kaynak için çok ilginçtir.

Yol Haritası

KoliBri, en son ana sürüm için iyileştirmeler, yeni özellikler ve geleceğe yönelik yenilikler üzerinde her zaman aktif bir şekilde çalışmaktadır. Aynı zamanda, seçilen bir LTS sürümü hata düzeltmeleri açısından korunmaktadır.

Sürüm	Yayın Tipi	Yayın	Dönem	Destek Bitişi
0.x	İlk	Temmuz 2020	-	Aralık 2021
1.x	LTS	Aralık 2021	3y	Aralık 2024
2.x	LTS	Aralık 2023	3y	Aralık 2026
3.x	STS	Aralık 2024	15m	Mart 2026
4.x	LTS	Aralık 2025	3y	Aralık 2028
5.x	STS	Aralık 2026	15m	Mart 2028

gantt
    title LTS & STS
    dateFormat YYYY-MM-DD

    0.x Initial implementation :, 2020-07-01, 17M
    1.x (LTS)                  :, 2021-12-01, 3y
    2.x (LTS)                  :,  2023-12-01, 3y
    3.x (STS)                  :crit , 2024-12-01, 15M
    4.x (LTS)                  :, 2025-12-01, 3y
    5.x (STS)                  :crit , 2026-12-01, 15M
    6.x (LTS)                  :, 2027-12-01, 3y

Kurulum

Paketleri pnpm ile kurun:

pnpm install

Bileşenleri oluşturmak için bir kez build çalıştırın:

pnpm -r build

Hızlı başlangıç

Varsayılan temayı kurun ve bileşenleri kaydedin:

pnpm add @public-ui/components @public-ui/theme-default

import { register } from '@public-ui/components';
import { defineCustomElements } from '@public-ui/components/loader';
import { DEFAULT } from '@public-ui/theme-default';

register(DEFAULT, defineCustomElements);

CSS Özel Özellik Çatışmalarından Kaçının

KoliBri temaları, tüketicilerin görünüş ve hissi uyarlamasına izin vermek için birkaç CSS özel özelliğini ortaya çıkarır. Bu özellikler Shadow DOM içinde bile küresel kaldığı için, çok fazla sayıda kullanmak ana sayfada tanımlanan değişkenlerle çatışabilir.

Ad alanıyla belirtilen özel özellikler yalnızca dışarıdan geçersiz kılınması gereken değerler için kullanın. İç hesaplamalar için ek CSS özelikleri yerine SASS değişkenlerine güvenin. Bu, bileşenleri sağlam tutar ve beklenmedik stil sızıntılarını engeller.

İşbirliği ve koordinasyon

KoliBri'nin odağı, küçük (atomik), çok esnek ve yüksek düzeyde yeniden kullanılabilir HTML bileşimleri (örneğin butonlar) üzerinedir. Bu tür bileşenlerin, herhangi bir üst düzey HTML yapısı veya bileşeni (molekül, organizma veya şablon) yeniden kullanmak için erişilebilir, semantik ve geçerli bir standart uygulaması sunuyoruz. Bu atomik bileşenler, işbirliği yapıp koordinasyon sağladığımız ve beceri ile bilgimizi birleştirdiğimiz yerdir. Temel bileşenlerdeki sinerji etkileri, konu alanına özgü içeriğe daha fazla odaklanmanıza olanak tanır.

Birlikte KoliBri'yi daha iyi ve daha renkli hale getirelim!

Dokumentasyona devam edin…

Katkı Sağlama

Bug raporları ve pull request'leri memnuniyetle karşılarız. Başlamadan önce lütfen katkı rehberimizi okuyun.

SLSA/Provenance

Bu depodan yayınlanan npm paketleri için SLSA Build Level 3 hedefliyoruz. Sürümler GitHub Actions'da OIDC tabanlı kimlikle oluşturulur ve npm provenance (--provenance) ile yayınlanır, yayınlanan yapılar için doğrulanabilir attestasyonlar üretir. Yayın adımları ve npm provenance yapılandırması için yayın workflow'una bakın.

Doğrulama örneği

# Yayınlanan bir paket için provenance meta verilerini inceleyin
pnpm view @public-ui/components dist.provenance

# (İsteğe bağlı) npm istemciniz destekliyorsa imzaları/provenance'ı doğrulayın
pnpm audit signatures --package=@public-ui/components@<version>

public-ui/kolibri

Bu MCP sunucusu hakkında