Temalar

Tema, uygulamanın görünümüdür. Renkleri, yazı tiplerini, denetimlerin şeklini, sayfanın hissini ve terminalin renklerini belirler. Küçük bir JSON dosyasıdır. Collie dört adet tema ile gelir. Bir dosyadan daha fazlasını içe aktarabilir, kopyalayıp düzenlemek için herhangi bir temayı dışa aktarabilirsiniz. Tema tek bir cihazın ayarıdır, o tarayıcıda tutulur ve köprü üzerinde hiçbir şeyi değiştirmez.

Her temanın iki yarısı vardır. Açık yarı, açık modun renk kümesidir. Koyu yarı, koyu modun kümesidir. Bir temadaki rengin background veya primary gibi bir adı vardır ve bu ad bir belirteçtir (token).

Dört tema

Collie dört tema ile birlikte gelir ve bunlardan üçü bir tema dosyasının her parçasını kullanır. Her resim Gösterge Panelini solda açık, sağda koyu olarak gösterir.

• —
  Collie, uygulamanın her zaman sahip olduğu görünümdür. Varsayılandır ve bunu seçmek tüm temaları tekrar devre dışı bırakır. Hiçbir şekil, görünüm veya palet adı belirtmez, bu nedenle her kelimesi listesinin varsayılan kelimesidir.

  !Gösterge Panelinde Collie teması, açık ve koyu.

• —
  Nightwatch, yataktaki nöbetçi telefon içindir. Koyu yarı, loş bir kehribar rengiyle gerçek siyahtır; açık yarı ise sıcak bir alacakaranlık kağıdıdır. Köşeli ve düzdür; kalın çizgilere, kalın metinlere ve başlık ile çubukların arkasında loş bir kehribar şeride sahiptir. Terminal, gerçek siyah üzerine kehribar bir palet çizer.

  !Gösterge Panelinde Nightwatch teması, açık ve koyu.

• —
  Daylight, doğrudan güneş ışığı ve az görenler içindir. Gövde metni 7:1 veya daha iyisidir, kenarlıklar daha belirgindir ve engellenenler turuncu, tamamlananlar mavi renktedir; böylece ikisi kırmızı ve yeşil olmadan ayrı kalır. Yuvarlatılmış köşelere, sayfanın altına doğru ton değiştiren (açık modda daha koyu, koyu modda daha açık) kalkık kartlar şeklinde satırlara ve daha ferah adımlara sahiptir. Terminal canlı, yüksek kontrastlı bir palet çizer.

  !Gösterge Panelinde Daylight teması, açık ve koyu.

• —
  Harbour, terminalde yaşayanlar içindir. Nord ve Solarized havasında, bir camgöbeği vurgulu soğuk bir mavi-gri ve bir editör gibi okunan kod renkleri sunar. Yumuşak köşelere, sayfanın altında ince bir dokuya ve ince simgelere sahiptir. Terminal, Solarized tabanlı bir palet çizer.

  !Gösterge Panelinde Harbour teması, açık ve koyu.

Tablo, her temanın kullandığı tüm kelimeleri listeler. Her listenin ilk kelimesi bugünün görünümüdür: sharp, default, flat, page, rules ve caps. Kelimeler Şekil, Görünüm ve Terminal paleti altında açıklanmıştır.

Bir tema seçin

Ayarlar → Görünüm içinden bir tema seçin, tüm uygulama tek seferde değişsin.

Tema kartı ilk karttır. Bir ada dokunun, uygulama hemen değişir. Her ad kendi temasının köşe ve kalınlık özelliklerini taşır, böylece dokunmadan önce şekli görürsünüz. Kart; Sistem, Açık ve Koyu seçeneklerini barındıran Görünüm kartının üzerinde yer alır. Bunlar iki ayrı ayardır. Tema renkleri, şekli ve genel görünümü belirler; Sistem, Açık veya Koyu ise renklerin hangi yarısını göreceğinizi belirler.

Bir yazı tipi belirten tema, temayı seçtiğinizde bu tipi Yazı tipi kartına bir kez yazar. Bundan sonra Yazı Tipi kartı önceliklidir: Oradan başka bir yazı tipi seçtiğinizde, tekrar bir tema seçene kadar bu seçim geçerli kalır. Bir temanın başlık yazı tipi bu kartın parçası değildir: Başlıklar bu tipi korur. yazı tipleri kendi bölümüne sahiptir.

Bu temaların kullandığı yazı tipleri yalnızca Latin ve Latin Extended-A karakterlerini içerir; bu nedenle bu temalar altında Kiril ve CJK metinleri sistem yazı tipine döner (Collie teması Kiril eşlikçisini korur).

Tema içe aktarın

Tema kartında bir .json dosyasını içe aktarın, önizlemeyi inceleyin ve Uygula öğesine dokunun.

1. 01
   Tema kartında İçe Aktar öğesine dokunun ve bir .json dosyası seçin.
2. 02
   Collie dosyayı okur ve bir önizleme gösterir. Adı, yazarı, renk örneği olarak her iki yarıyı, her yarı için küçük bir sayfayı, örnek üzerindeki şekli, uçbirim renklerini ve bir kontrast raporunu gösterir.
3. 03
   Temayı saklayıp ona geçmek için Uygula öğesine, hiçbir şeyi saklamamak için İptal öğesine dokunun.

uyarı, kontrast raporundaki "dark: status-blocked chip on card measures 3.9. The floor is 4.5" gibi bir satırdır. Temanın bir yerde okunmasının zor olduğu anlamına gelir. Seçim size ait olduğu için Uygula açık kalır.

reddetme, dosyanın bir kuralı ihlal ettiği anlamına gelir. Collie nedenleri listeler, hiçbir şeyi saklamaz ve hiçbir şeyi uygulamaz. Liste en fazla 25 nedeni ve ardından "ve N tane daha" satırını gösterir. Bir dosya aşağıdakilerden herhangi biri nedeniyle reddedilir:

• —
  JSON nesnesi değildir veya 64 KiB'den büyüktür.
• —
  Hiçbir renk tanımlamaz.
• —
  Bilinmeyen bir anahtara, Collie'nin okumadığı bir sürüme, renk olmayan bir değere veya Collie ile birlikte gelmeyen bir yazı tipine sahiptir.
• —
  Bir şekil sözcüğü listesinde yoktur veya bir sözcüğün bulunması gereken yerde bir sayı yer alır.
• —
  Bir surface bloğuna, fonts.display yazı tipine veya ansi bloğuna sahiptir ve sürümün 1 olduğunu belirtir.
• —
  ansi bloğunda bir anahtar eksiktir, alfa kanalı içeren bir renge sahiptir veya Terminal paleti altındaki bir denetimi geçemez.
• —
  Hatalı bir id, name veya author içerir ya da id yerleşik bir temaya aittir.
• —
  İçe aktarılan dokuzuncu tema olacaktır. Collie, dosya seçmeden önce İçe Aktar dokunuşunda ve Uygula sırasında bunu tekrar reddeder.

Collie, Uygula sırasında bir şeyi daha denetler. id değeri cihazda zaten mevcut olan bir dosya "already imported" uyarısıyla reddedilir. Önce eski temayı kaldırın veya id değerini değiştirin.

Tema yalnızca uygulamanın görünümünü değiştirir, başka hiçbir şeyi etkilemez. Kod çalıştıramaz, dosya yükleyemez veya bir sunucuya erişemez.

Bir cihaz en fazla sekiz adet içe aktarılmış tema tutabilir. Kaldır yalnızca içe aktarılmış bir tema etkinken çalışır. Bu temayı siler ve uygulama varsayılan Collie temasına döner. Yazı tipi olduğu gibi kalır.

Kontrast raporu

Rapor, bir temanın renklerini her iki yarıda da ölçer; başarısız bir satır, kabul edebileceğiniz bir uyarıdır.

Uçbirim paleti tek istisnadır, çünkü denetimleri dosyayı doğrudan reddeder. Tablo, diğer bölümlerin alt sınırlarını listeler. Alt sınır bir kontrast oranıdır, dolayısıyla daha yüksek bir sayı daha kolay okunur.

• —
  Yıkıcı metin, renklerini koruduğunuzda Collie'nin ölçtüğü değerde tutulur. Collie'nin kendi sayfasındaki açık kırmızı değeri 4.38 ölçülür. Çiftin her iki rengini de koruyan bir tema bu değerde tutulur ve hiçbir zaman 3'ün altına düşmez. Renklerden herhangi birini değiştiren bir tema 4.5 değerinde tutulur.
• —
  Bir gradyan veya doku en uzak ucunda ölçülür. Rapor; sayfa metnini, çipleri, destructive metnini, status-blocked metnini ve aynı alt sınırlarla gradyanın tabanında veya dokunun çizgi renginde rule öğesini tekrar ölçer.
• —
  Bir şerit de ölçülür. chrome: band altında; foreground, muted-foreground ve status-blocked, şeridin rengi olan secondary üzerinde 4.5 değerinde ölçülür.

Bir temayı dışa aktarın ve paylaşın

Temayı seçin, ardından Dışa aktar öğesine dokunun. Collie <id>.collie-theme.json dosyasını kaydeder. Dosya kaydedemeyen bir tarayıcı, metni kopyalama düğmesi bulunan bir sayfada gösterir. Yerleşik bir temadan kendi temanızı oluşturmak için:

1. 01
   Nightwatch, Daylight, Harbour veya Collie temasını dışa aktarın.
2. 02
   id ve name değerlerini değiştirin. Yerleşik bir temanın kimliği reddedilir.
3. 03
   Renkleri ve sözcükleri düzenleyin; değiştirmek istemediğiniz belirteçleri silin.
4. 04
   Dosyayı telefonunuza gönderin, ardından içe aktarın.

Bir dışa aktarma işlemi, temanın içeriğini barındıran en düşük sürüm değerini yazar.

Bir tema yazın

Bir dosya yalnızca bu anahtarları içerir, başkalarını içermez. Herhangi bir yerdeki bilinmeyen bir anahtar, adıyla birlikte reddedilir. Bu eksiksiz bir sürüm 2 dosyasıdır: daha kısa bir renk listesi ve tam paletiyle Daylight temasıdır.

{
  "version": 2,
  "id": "my-day",
  "name": "My day",
  "author": "Sam",
  "light": { "background": "oklch(0.985 0 0)", "primary": "oklch(0.18 0 0)" },
  "dark": { "background": "oklch(0.12 0 0)", "status-blocked": "oklch(0.81 0.13 60)" },
  "fonts": { "ui": "geist", "display": "atkinson" },
  "surface": {
    "radius": "round", "shadow": "lifted", "density": "roomy",
    "weight": "default", "border": "default", "ground": "gradient",
    "chrome": "page", "rows": "cards", "icons": "default", "labels": "sentence"
  },
  "ansi": {
    "0": "#3a332c", "1": "#ff5f56", "2": "#5fd068", "3": "#ffd84a",
    "4": "#5aa9ff", "5": "#e07ce8", "6": "#3fd6d0", "7": "#f2efe9",
    "8": "#8a827a", "9": "#ff8a80", "10": "#7ad683", "11": "#ffeb8a",
    "12": "#8cc4ff", "13": "#f0a6f5", "14": "#6ad8d2", "15": "#ffffff",
    "ink": "#f5f0e8", "ground": "#1a1612"
  }
}

• —
  version 1 veya 2'dir. Bkz. Sürümler. Başka herhangi bir sayı reddedilir.
• —
  id 1 ila 32 karakterdir: küçük harfler, rakamlar ve kısa çizgiler; bir harf veya rakamla başlar.
• —
  name 1 ila 40 karakterdir ve author en fazla 60 karakterdir. İkisi de bir denetim karakteri içeremez.
• —
  light ve dark belirteç nesneleridir. Bir yarıyı veya her ikisini birden belirtin. Dışarıda bıraktığınız bir yarı ve dışarıda bıraktığınız herhangi bir belirteç, Collie temasının değerini alır. Belirteci yalnızca bir yarı ayarlarsa diğer yarı bu belirteç için Collie temasının değerini alır.
• —
  fonts.ui isteğe bağlıdır: system, grotesk, aldrich, plex, geist veya atkinson.
• —
  fonts.display isteğe bağlıdır ve aynı altı adı alır. Bkz. Görünüm.
• —
  surface isteğe bağlıdır. İçindeki her anahtar da isteğe bağlıdır; dışarıda bıraktığınız bir anahtar, listesinin varsayılan sözcüğünü alır. Bkz. Şekil ve Görünüm.
• —
  ansi isteğe bağlıdır; 18 anahtarın tümünü içerir ya da hiçbirini içermez. Bkz. Terminal paleti.
• —
  $schema kullanılabilir ve yok sayılır. Dosya en fazla 64 KiB olabilir.

Bir değer; yalın sayılarla #rrggbb, #rrggbbaa veya oklch(L C H) ve oklch(L C H / A) biçimindedir. L 0 ile 1, C 0 ile 0.5, H 0 ile 360, A ise 0 ile 1 arasında veya bir yüzdedir. Başka hiçbir şey çalışmaz: adlandırılmış renk yok, rgb() yok, var() yok, url() yok. ansi içindeki bir rengin alfası yoktur.

Sürümler

Bir dosya hangi sürümde olduğunu belirtir ve Collie, dosyanın içeriklerini destekleyen en düşük sürümü yazar.

• —
  Bir surface bloğu, bir fonts.display yazı tipi veya bir ansi bloğu içeren bir dosya 2 belirtmelidir. 1 belirten ve bunlardan birini içeren bir dosya reddedilir.
• —
  Bu blokları içermeyen bir dosya ikisini de belirtebilir. Collie her iki sürümü de okur; yalnızca renkler ve fonts.ui içeren bir temanın dışa aktarımı 1 belirtir.
• —
  Sürüm 2 bir dosya için Collie 1.22.0 veya daha yenisi gerekir.
• —
  Sürüm 1 bir dosya, surface kapsamındaki her belirteç için ilgili listenin varsayılan sözcüğü anlamına gelir.

43 belirteç

Her bir yarı, dört grup halinde bunlardan herhangi birini alır.

Şekil

surface bloğundaki beş sözcük denetimlerin şeklini belirler ve her anahtar kapalı bir listeden bir sözcük alır.

Bir sözcük bir addır, asla bir sayı değildir. Serbest bir yarıçap veya serbest bir boşluk adımı dokunma tabanını bozabilir ya da kare bir denetimi stadyum şekline dönüştürebilir. Her listenin ilk sözcüğü, uygulamanın sürüm 2 öncesindeki görünümüdür.

• —
  Daireler daire olarak kalır. Durum noktası gibi genişliği yüksekliğine eşit bir şekil köşe adımı sayılmaz, bu nedenle radius onu değiştirmez.
• —
  İşaretli bir satır yarıçapı izler. sharp altında, seçilen veya engellenen bir satırın sol kenarında 2 piksellik bir çubuk bulunur. soft ve round altında ise dört kenarında 2 piksellik bir halka ve yumuşak bir gölge bulunur; çünkü sol çubuk yuvarlatılmış köşelerle asla bir arada kullanılmaz.
• —
  roomy asla varsayılanın altına inmez. Dokunma hedefleri 44 piksel veya daha büyük kalır. Başlıktaki simgeler ve köpek boyutlarını korur, bu nedenle yalnızca çevrelerindeki boşluk büyür.

Görünüm

surface bloğunun diğer beş anahtarı ve bir yazı tipi anahtarı sayfanın görünümünü ayarlar. Kapalı sözcükler kuralını izlerler.

fonts.display, sayfa başlıkları ve üst bilgideki ad için altı yazı tipinden birini belirler. Hiçbirini belirtmeyen bir tema, başlıklarını daha önce olduğu gibi yazı tipinde çizer. Collie, bir başlık yazı tipini yalnızca tema bunu belirttiğinde getirir.

• —
  Bir zemin, hiçbir görüntü dosyası çizmez. Gradyan ve gren, temanın kendi renklerinden oluşturulur. Uygulama panelleri opaktır; bu nedenle zemin, aralarındaki boşluklarda görünür.
• —
  Sayfa metni zemin üzerinde ölçülür. kontrast raporu, bir gradyanın uzak ucunu ve grenin çizgi rengini denetler; böylece zemin metni gizleyemez.
• —
  Bir gradyanın altında çubuklar düz sayfa rengini korur. Bir tablette üst bilgi ve çubuklar, sayfanın üstünde aşağıya doğru koyulaşan bir kutu olarak algılanabilir. Bir sözcük bunu değiştiremez.
• —
  Durum çubuğu bir şeridi takip eder. chrome: band altında tarayıcının durum çubuğu şerit rengini, page altında ise sayfa rengini alır.
• —
  rows her liste grubuna ulaşır. Settings dizini içindeki liste buna dahildir.

Terminal paleti

ansi bloğu, terminal aynasına kendi 16 rengini, mürekkebini ve zeminini verir.

Blok 18 anahtarın tümünü içerir ya da hiçbirini içermez: 16 yuva için "0" ila "15", metin için ink ve arka plan için ground. Yarım bir palet, tek bir bölmeye iki palet yerleştirir. Her renk, alfa kanalı olmadan #rrggbb veya oklch() biçimindedir.

Not. Paleti koyu mod için yazın. Ayna her zaman koyu bir zemin üzerinde çizilir ve açık modda Collie, aynayı yeniden renklendirmek yerine tamamen tersine çevirir (neden). Açık mod, renklerinizin ayna görüntüsünü gösterir. Temanızın açık background rengine dönüşen bir ground seçin; böylece ayna her iki modda da sayfayla bütünleşir.

Bir geçidi geçemeyen renk, anahtarı belirtilerek reddedilir. Bu bir uyarı değildir, çünkü en çok okuduğunuz yer terminaldir.

Açık renk kümesi sabit bir listedir: Muse aynası bu dört yuvayı açık renkli ön planlar olarak ele alır. Diğer 12 yuva aynı sınırın altında kalır, böylece bu liste paletiniz altında da geçerliliğini korur.

Bir temanın değiştiremeyeceği şeyler

Bir tema; bir rengin değerini, yazı tiplerini, denetimlerin şeklini, sayfanın hissini ve terminalin paletini değiştirir. Başka hiçbir şeyi değiştiremez.

• —
  Yerleşim ve dokunma boyutları. Telefon yerleşimini bozmak kolaydır. Radius, shadow, density, weight ve border kapalı sözcüklerdir, hiçbir zaman serbest değerler değildir ve roomy hiçbir zaman varsayılanın altına inmez.
• —
  Yazı boyutları ve hareket. Bir tema bir boyut değil, bir yazı tipi ve kalınlık seçer ve hiçbir şeyin nasıl hareket ettiğini değiştiremez.
• —
  Collie köpeği. Başlık, ana ekran simgesi ve karşılama ekranı her temada aynı görünür.
• —
  Bir durumun anlamı. Simgesi ve sözcüğü olduğu gibi kalır; böylece seçtiğiniz bir kırmızı veya turuncu, engellenmiş durumunu asla tamamlanmış gibi göstermez.
• —
  Serbest bir değer, ham CSS, uzak yazı tipleri. Her anahtar bir renk veya bir listeden bir sözcük alır ve yazı tipleri Collie ile birlikte gelen listeden gelir.

İlk çizim ve durum çubuğu

Seçiminiz ilk kareden itibaren ekrandadır. Küçük bir betik uygulama yüklenmeden önce bunu okur, böylece yerleşik gelen bir tema önce varsayılanı anlık olarak göstermez. İçe aktarılan bir tema da bir istisna dışında aynısını yapar. Bir belirteç yalnızca tek bir yarıda ayarlanmışsa, bu belirteç bir kare boyunca varsayılan rengi gösterir. Uygulama yüklendiğinde temayı yeniden denetler. Denetimden geçemeyen kayıtlı bir tema bırakılır, cihaz Collie gösterir ve tarayıcı konsolu nedenini belirtir. Durum çubuğu temanın iki sayfa rengini veya tema chrome: band dediğinde iki şerit rengini izler.

Sorun giderme

Bunlar, her birinin nedeni ve çözümüyle birlikte kullanıcıların en sık karşılaştığı sorunlardır.

• —
  Bir tema tek bir belirteçte varsayılan rengi gösteriyor. Dosya o belirteci veya yarıyı dışarıda bıraktı. Eksik belirteçler Collie temasından gelir. Belirteci istediğiniz yarıya ekleyin.
• —
  Yazı tipi değişmedi. Bir tema yazı tipini seçtiğinizde bir kez yazar. Daha sonra Yazı tipi içinde başka bir yazı tipi seçtiyseniz o seçim geçerli olur. Yazı tipini yeniden seçin veya temayı yeniden seçin.
• —
  Bir şekil sözcüğü hiçbir şey yapmıyor. Sözcük, listesinin varsayılan sözcüğü olabilir veya anahtar eksik olabilir. Dışarıda bıraktığınız bir anahtar varsayılan sözcüğü alır. Yazımı Şekil ve Görünüm altındaki tablolara göre denetleyin.
• —
  Dosya reddedildi ve ansi belirtiyor. Bir palet koyu alanda 18 anahtarın tümünü tutar ve her renk kendi eşiğini geçmelidir. Reddetme mesajı anahtarı ve ölçülen sayıyı belirtir.
• —
  Tarayıcı verileri temizlendikten sonra tema kaybolur. İçe aktarılan temalar yalnızca bu tarayıcıda bulunur. Dosyayı yeniden içe aktarın.