Beranda>Sumber daya pembuatan situs web>Pengunduhan font
Unduh

Fontist

Perpustakaan sederhana untuk menemukan dan mengunduh font untuk Windows, Linux dan Mac.

Instalasi

Instal langsung sebagai: 

gem install fontist

Atau menggunakannya sebagai bagian dari bundel Anda dengan menambahkan baris ini ke Gemfile aplikasi Anda: 

 gem "fontist"

Dan kemudian mengeksekusi: 

bundle install

Ambil formula

Setelah instalasi, silakan ambil formula melalui perintah fontist : 

fontist update

Dependensi

Tergantung pada FFI-Libarchive-Binary yang memiliki persyaratan berikut:

  • Zlib

  • Ekspat

  • OpenSSL (hanya untuk Linux)

Ketergantungan ini umumnya ada di semua sistem.

Menggunakan Antarmuka Baris Perintah (CLI)

Perintah fontist

Perintah ini memungkinkan untuk beroperasi dengan font melalui baris perintah.

CLI dengan benar mendukung status keluar, jadi dalam kasus kesalahan itu mengembalikan kode status lebih tinggi atau sama dari 1 .

Pencarian tidak sensitif untuk kemudahan penggunaan.

Semua perintah mendukung opsi global berikut:

--preferred-family

Cari menggunakan nama "keluarga pilihan" dari sebuah font. (Alih -alih nama "Keluarga Default", default sebelum fontist v1.10.)

Catatan
 Lihat ke v1.10+ untuk perbedaan antara "keluarga pilihan" dan "keluarga default".
-q, --quiet

Cetak informasi sesedikit mungkin, sebagian besar kesalahan kritis.

-v, --verbose

Atur level log ke debug. Ini mencetak formula yang dikecualikan selama instalasi dan informasi untuk pengembang fontis.

-c, --no-cache

Lebih suka unduhan langsung bahkan ketika sebuah file sudah di -cache dalam suatu sistem.

Instal Font: fontist install

Fontist memeriksa apakah font ini sudah diinstal, dan jika tidak, kemudian menginstal font dan mengembalikan jalur yang diinstal.

Nama font adalah satu -satunya argumen yang disediakan. 

$ fontist install " segoe ui "
These fonts are found or installed:
- /Users/user/.fontist/fonts/SEGOEUI.TTF
- /Users/user/.fontist/fonts/SEGOEUIB.TTF
- /Users/user/.fontist/fonts/SEGOEUII.TTF
- /Users/user/.fontist/fonts/SEGOEUIZ.TTF

Secara default, semua gaya yang cocok (sesuai dengan nama "keluarga default" font) diinstal.

Catatan
 Sebelum v1.10, nama "keluarga pilihan" font digunakan untuk mencocokkan gaya untuk pencarian. Lihat ke v1.10+ untuk detail perubahan itu.

Untuk menginstal semua font yang ditentukan dalam rumus fontis, gunakan opsi -F, --formula . 

$ fontist install --formula ' courier_prime '
Downloading font ...
Installing font " courier_prime " .
Fonts installed at:
- /Users/user/.fontist/fonts/Courier Prime Bold Italic.ttf
- /Users/user/.fontist/fonts/Courier Prime Bold.ttf
- /Users/user/.fontist/fonts/Courier Prime Italic.ttf
- /Users/user/.fontist/fonts/Courier Prime.ttf

Di sini, courier_prime adalah nama file dari formula yang terletak di Repositori Formula Fontis Publik ( courier_prime.yml ).

Anda juga dapat menentukan nama formula yang dapat dibaca manusia. Nama ini berasal dari nama file, dengan garis bawah digantikan oleh spasi. Ini tidak peka huruf besar-kecil, artinya Anda dapat menggunakan huruf kapital jika Anda mau. 

$ fontist install --formula " Courier Prime "
$ fontist install --formula " Google/Noto Sans "

Instalasi dengan nama rumus mendukung saran di CLI saat input parsial: 

$ fontist install --formula ' noto s '
Formula ' noto s ' not found. Did you mean ?
[0] Google/Noto Sans
[1] Google/Noto Serif
Please type number or press ENTER to skip installation:
Catatan
 Menentukan nama file font belum didukung.

Jika ada beberapa formula dengan font yang diminta, maka pencarian fontist untuk versi terbaru dari font di antara rumus dengan ukuran di bawah batas (300 MB). Perilaku ini dapat diubah dengan opsi.

Catatan
 Jika gaya font tersebar di antara beberapa formula, maka semua gaya yang tersedia dari semua formula akan dipasang.
Catatan
 Beberapa rumus mungkin memiliki atribut min_fontist , yang mendefinisikan versi minimum fontist yang dengannya mereka dapat diinstal. Jika fontist adalah versi yang lebih lama, maka formula dihindari untuk digunakan. Untuk melihat formula mana yang dikeluarkan dari opsi pencarian, -v, --verbose dapat ditentukan.

Opsi yang Didukung:

-f, [--force]

Instal bahkan jika sudah diinstal di sistem

-F, [--formula]

Pasang seluruh formula, bukan font

-a, [--accept-all-licenses]

Terima semua perjanjian lisensi

-h, [--hide-licenses]

Sembunyikan teks lisensi

-p, [--no-progress]

Sembunyikan Kemajuan Unduh

-V, [--version=VERSION]

Instal versi tertentu dari font

-s, [--smallest]

Instal font terkecil berdasarkan ukuran file jika beberapa

-n, [--newest]

Instal versi terbaru dari font jika beberapa

-S, [--size-limit=N]

Tentukan batas atas untuk ukuran file formula yang akan diinstal (default adalah 300 MB)

-u, [--update-fontconfig]

Perbarui fontConfig

Catatan
 Perintah install mirip dengan panggilan perpustakaan Font.install .

Uninstall Fonts: fontist uninstall

Hapus instalasi font yang didukung oleh fontist.

Mengembalikan jalur font yang tidak diinstal, atau mencetak kesalahan yang mengatakan bahwa font tidak diinstal atau tidak dapat ditemukan dalam rumus fontis. Alias seperti remove . 

$ fontist uninstall " segoe ui "
These fonts are removed:
/Users/user/.fontist/fonts/SEGOEUII.TTF
/Users/user/.fontist/fonts/SEGOEUIZ.TTF
/Users/user/.fontist/fonts/SEGOEUIB.TTF
/Users/user/.fontist/fonts/SEGOEUI.TTF

Status: fontist status

Cetakan terpasang jalur font dengan rumus yang sesuai. 

$ fontist status " segoe ui "
Fonts found at:
- /Users/user/.fontist/fonts/SEGOEUII.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUIZ.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUIB.TTF (from segoe_ui formula)
- /Users/user/.fontist/fonts/SEGOEUI.TTF (from segoe_ui formula)

DAFTAR: fontist list

Daftar status instalasi font yang didukung oleh fontist. 

$ fontist list " segoe ui "
segoe_ui
 Segoe UI
  Regular (installed)
  Bold (installed)
  Italic (installed)
  Bold Italic (installed)
$ fontist list " roboto mono "
google/roboto_mono
 Roboto Mono
  Regular (not installed)
  Italic (not installed)

Daftar Jalur Font Terpasang: fontist manifest-locations

Mengembalikan lokasi font yang ditentukan dalam file YAML sebagai input. 

$ fontist manifest-locations MANIFEST_FILE

MANIFEST_FILE adalah lokasi file manifes yang berisi spesifikasi satu atau beberapa gaya font dan font.

File manifes manifest.yml bisa terlihat seperti: 

 Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular

Perintah berikut akan mengembalikan output YAML berikut: 

$ fontist manifest-locations manifest.yml
---
Segoe UI :
  Regular :
    full_name : Segoe UI
    paths :
    - " /Users/user/.fontist/fonts/SEGOEUI.TTF "
  Bold :
    full_name : Segoe UI Bold
    paths :
    - " /Users/user/.fontist/fonts/SEGOEUIB.TTF "
Roboto Mono :
  Regular :
    full_name : Roboto Mono Regular
    paths :
    - " /Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf "

Jika satu atau lebih font yang diminta hilang, kode kesalahan "3" akan dikembalikan, dan pesan yang dicetak: 

$ fontist manifest-locations manifest.yml
' Roboto Mono ' ' Regular ' font is missing, please run ` fontist install ' Roboto Mono ' ` to download the font.
$ echo $?
3

Instal Fonts From Manifest: fontist manifest-install

Instal Font dari YAML Fontist Manifest: 

$ fontist manifest-install --confirm-license manifest.yml

Where manifest.yaml adalah: 

---
Segoe UI :
  Regular :
    full_name : Segoe UI
    paths :
    - " /Users/user/.fontist/fonts/SEGOEUI.TTF "
  Bold :
    full_name : Segoe UI Bold
    paths :
    - " /Users/user/.fontist/fonts/SEGOEUIB.TTF "
Roboto Mono :
  Regular :
    full_name : Roboto Mono Regular
    paths :
    - " /Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf "

Bekerja dengan Fontist Config: fontist config

Fontist mendukung pengaturan seluruh sistem untuk parameter berikut:

fonts_path

Set Path Di mana Menginstal Font (default: ~/.fontist/fonts )

open_timeout

Set Timeout Untuk Membuka Koneksi Selama Unduh (Default: 10 )

read_timeout

Set Timeout Untuk Membaca Koneksi Terbuka Selama Unduh (Default: 10 )

Tampilkan atribut saat ini di konfigurasi: 

$ fontist config show
Current config:
read_timeout: 5

Tetapkan nilai ke atribut: 

$ fontist config set read_timeout 60

Kembalikan nilai default dari suatu atribut: 

$ fontist config delete read_timeout

Bekerja dengan FontConfig: fontist fontconfig

FontConfig adalah perangkat lunak yang dirancang untuk menyediakan font ke program lain. Ini biasanya digunakan di Linux, tetapi juga tersedia di macOS dan Windows. FontConfig digunakan oleh LibreOffice, GIMP, dan banyak program lainnya.

Ini untuk menemukan font fontis, fontConfig harus diperbarui untuk memasukkan jalur fontis. Ini dapat dilakukan dengan opsi --update-fontconfig dari perintah install , atau dengan memanggil yang khusus: 

$ fontist fontconfig update

Ini akan membuat konfigurasi di ~/.config/fontconfig/conf.d/10-fontist.conf .

Untuk menghapusnya, silakan gunakan: 

$ fontist fontconfig remove

Bekerja dengan cache 

$ fontist cache clear

Perintah di atas akan menghapus cache unduhan fontist

Bantuan: fontist help

Daftar semua perintah dapat dilihat oleh: 

fontist help

Konfigurasi dengan variabel lingkungan

Secara default fontist menggunakan direktori ~/.fontist untuk menyimpan font dan file -nya. Ini dapat diubah dengan variabel lingkungan FONTIST_PATH . 

FONTIST_PATH= ~ /.fontist_new fontist update

Menggunakan Perpustakaan Ruby

Fontist::Font

Fontist::Font adalah tempat tujuan Anda untuk berurusan dengan font menggunakan fontist.

Antarmuka ini memungkinkan Anda untuk menemukan font atau menginstal font.

Menemukan font

Antarmuka Fontist::Font.find dapat digunakan temukan font di sistem Anda.

Ini akan melihat ke dalam direktori font spesifik sistem operasi, dan juga direktori fontis ~/.fontist spesifik. 

 Fontist :: Font . find ( name )

  • Jika fontist menemukan font, maka itu akan mengembalikan jalur.

  • Kalau tidak, itu akan meningkatkan kesalahan font yang tidak didukung, atau memicu tampilan instruksi instalasi untuk font spesifik itu.

Instal font

Antarmuka Fontist::Font.install dapat digunakan untuk menginstal font yang didukung.

Antarmuka ini pertama -tama memeriksa jika Anda sudah menginstal atau tidak dan jika Anda melakukannya maka itu akan mengembalikan jalur.

Jika Anda tidak memiliki font tetapi font itu didukung oleh fontist, maka itu akan mengunduh font dan menyalinnya ke direktori ~/.fontist dan juga mengembalikan jalurnya. 

 Fontist :: Font . install ( name , confirmation : "no" )

Jika ada masalah yang terdeteksi dengan font yang disediakan, seperti font tidak didukung, kesalahan tersebut akan dinaikkan.

Sebutkan semua font

Antarmuka Fontist::Font memperlihatkan antarmuka untuk mendaftar semua font yang didukung.

Ini mungkin berguna jika ingin mengetahui nama font atau gaya yang tersedia. Anda dapat melakukannya dengan menggunakan: 

 Fontist :: Font . all

Nilai pengembalian adalah objek OpenStruct , sehingga Anda dapat dengan mudah melakukan operasi lain yang akan Anda lakukan di objek Ruby apa pun.

Fontist::Formula

Permata fontist secara internal menggunakan antarmuka Fontist::Formula untuk menemukan formula atau font terdaftar yang didukung oleh formula apa pun. Kecuali, Anda perlu melakukan apa pun dengan bahwa Anda tidak perlu bekerja dengan antarmuka ini secara langsung. Tetapi jika Anda melakukannya maka ini adalah antarmuka publik yang ditawarkannya.

Temukan formula

Antarmuka Fontist::Formula.find Antarmuka ini mengambil nama font sebagai argumen dan terlihat melalui masing -masing formula terdaftar yang menawarkan instalasi font ini. Penggunaan: 

 Fontist :: Formula . find ( "Calibri" )

Metode ini akan mencari dan mengembalikan formula fontis untuk kata kunci yang disediakan yang memungkinkan pemrosesan lebih lanjut, seperti pemeriksaan lisensi atau melanjutkan dengan pemasangan font di sistem Anda.

Daftar gaya font yang didukung oleh formula

Biasanya, setiap nama font dapat dikaitkan dengan banyak gaya atau koleksi, misalnya font Calibri mungkin berisi font gaya regular , bold atau italic dan jika Anda menginginkan antarmuka yang dapat mengembalikan daftar lengkap maka ini adalah teman Anda.

Anda dapat menggunakannya sebagai berikut: 

 Fontist :: Formula . find_fonts ( "Calibri" )

Sebutkan semua rumus

Antarmuka Fontist::Formula memperlihatkan antarmuka untuk mendaftar semua formula font terdaftar. Ini mungkin berguna jika ingin mengetahui nama formula atau jenis font apa yang dapat diinstal menggunakan rumus itu. Penggunaan: 

 Fontist :: Formula . all

Nilai pengembalian adalah objek OpenStruct , sehingga Anda dapat dengan mudah melakukan operasi lain yang akan Anda lakukan di objek Ruby apa pun.

Fontist::Manifest

Opsi Global

Fontist dapat dialihkan untuk menggunakan nama keluarga yang disukai. Format ini digunakan sebelum v1.10. 

 Fontist . preferred_family = true

Fontist::Manifest::Locations

Fontist memungkinkan Anda menemukan lokasi font dari hash manifes yang ditentukan dalam format berikut: 

 {
  "Segoe UI" => [ "Regular" , "Bold" ] ,
  "Roboto Mono" => [ "Regular" ]
}

Memanggil kode berikut mengembalikan hash bersarang dengan jalur dan nama font. Nama font berguna untuk memilih font tertentu dalam file koleksi font (TTC). 

 Fontist :: Manifest :: Locations . from_hash ( manifest ) 
 {
  "Segoe UI" => {
    "Regular" => {
      "full_name" => "Segoe UI" ,
      "paths" => [ "/Users/user/.fontist/fonts/SEGOEUI.TTF" ]
    } ,
    "Bold" => {
      "full_name" => "Segoe UI Bold" ,
      "paths" => [ "/Users/user/.fontist/fonts/SEGOEUIB.TTF" ]
    }
  } ,
  "Roboto Mono" => {
    "Regular" => {
      "full_name" => nil ,
      "paths" => [ ]
    }
  }
}

Fontist::Manifest::Install

Fontist memungkinkan Anda tidak hanya untuk mendapatkan lokasi font tetapi juga untuk menginstal font dari manifes: 

 Fontist :: Manifest :: Install . from_hash ( manifest , confirmation : "yes" )

Itu akan menginstal font dan mengembalikan lokasi mereka: 

 {
  "Segoe UI" => {
    "Regular" => {
      "full_name" => "Segoe UI" ,
      "paths" => [ "/Users/user/.fontist/fonts/SEGOEUI.TTF" ] } ,
    "Bold" => {
      "full_name" => "Segoe UI Bold" ,
      "paths" => [ "/Users/user/.fontist/fonts/SEGOEUIB.TTF" ]
    }
  } ,
  "Roboto Mono" => {
    "Regular" => {
      "full_name" => "Roboto Mono Regular" ,
      "paths" => [ "/Users/user/.fontist/fonts/RobotoMono-VariableFont_wght.ttf" ]
    }
  }
}

Dukungan format YAML

Kedua perintah mendukung file YAML sebagai input dengan metode from_file . Misalnya, jika ada file manifest.yml yang berisi: 

---
Segoe UI :
- Regular
- Bold
Roboto Mono :
- Regular

Kemudian panggilan berikut akan mengembalikan nama dan jalur font, seperti dari metode from_hash (lihat Fontist::Manifest::Install dan Fontist::Manifest::Locations ). 

 Fontist :: Manifest :: Locations . from_file ( "manifest.yml" )
Fontist :: Manifest :: Install . from_file ( "manifest.yml" , confirmation : "yes" )

Fontist::Fontconfig

Fontist mendukung pekerjaan dengan fontconfig melalui antarmuka ruby: 

 Fontist :: Fontconfig . update              # let detect fontist fonts
Fontist :: Fontconfig . remove              # disable detection
Fontist :: Fontconfig . remove ( force : true ) # do not fail if no config exists

Fitur khusus platform

Font tambahan khusus macOS

Versi macOS yang lebih baru menyediakan instalasi sesuai permintaan dari berbagai font berlisensi. Font add-on spesifik macOS ini dapat diinstal melalui fontist.

Penggunaan khas untuk menginstal font add-on macOS adalah untuk memungkinkan pekerjaan CI di lingkungan macOS untuk menggunakan font berlisensi khusus yang tidak tersedia di platform lain.

Posting blog ini menjelaskan cara kerjanya:

  • Fontist Blog: Menginstal font add-on spesifik macOS

Misalnya, font "Canela" adalah font komersial yang datang gratis dengan macOS.

Jalankan perintah ini untuk menginstal Canela di macOS. 

$ fontist install Canela

Daftar lengkap font yang tersedia di berbagai versi macOS dapat ditemukan di situs dukungan Apple:

  • Font di MacOS 13 Ventura

  • Font di MacOS 12 Monteray

  • Font di MacOS 11 Big Sur

Peringatan
 Fontist tidak mengizinkan menginstal font spesifik macOS pada platform non-macos karena pembatasan lisensi font dari font tersebut.

Font bermasalah yang diketahui

  • NISC18030.TTF (GB18030 BITMAP) - MacOS, info lebih lanjut dalam edisi NISC18030

Daftar lengkap font bermasalah yang diketahui:

  • Daftar font dikecualikan dari penggunaan

Penggunaan lanjutan

Menggunakan server proxy

Fontist menggunakan Git secara internal untuk mengambil formula dan font.

Untuk menggunakan fungsionalitas GIT di belakang proxy, Anda perlu memperbarui konfigurasi git Anda sendiri melalui perintah git config atau file preferensi ~/.gitconfig .

Ada banyak cara untuk mengonfigurasi instalasi git lokal Anda untuk menggunakan proxy.

Cara global yang paling sederhana dan global untuk menetapkan proxy untuk GIT adalah sebagai berikut.

  • Untuk http 

    git config --global http.proxy http://{user}:{pass}@{proxyhost}:{port}

  • Untuk HTTPS, Anda mungkin perlu menangani kesalahan verifikasi SSL/TLS setelah mengatur proxy karena ujung enkripsi terletak di titik akhir proxy https Anda: 

    git config --global http.proxy https://{user}:{pass}@{proxyhost}:{port}
git config --global https.proxy https://{user}:{pass}@{proxyhost}:{port}

  • Untuk kaus kaki, Anda perlu memutuskan protokol kaus kaki 

    git config --global http.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '
git config --global https.proxy ' {protocol}://{user}:{pass}@{proxyhost}:{port} '

    Misalnya, 

    git config --global http.proxy ' socks5h://user:[email protected] '
git config --global https.proxy ' socks5h://user:[email protected] '

Daftar protokol kaus kaki yang didukung untuk bidang {protocol} :

  • socks:// : untuk kaus kaki di bawah v5

  • socks5:// : untuk Socks V5

  • socks5h:// : untuk kaus kaki di bawah v5 + resolusi host melalui kaus kaki

Anda sebenarnya dapat mengatur perilaku proxy yang berbeda untuk repositori git individu - silakan lihat panduan hebat ini tentang cara menggunakan proxy git (terima kasih kepada pengguna github evantoli).

Repositori fontis khusus

Umum

Repositori fontist adalah repo git yang berisi file rumus YAML. Rumus fontis dapat dibuat secara manual dalam repositori fontis (lihat contoh), atau dihasilkan secara otomatis dari arsip font.

Repositori fontist dapat diakses baik melalui HTTPS atau SSH. Dalam hal SSH, kunci SSH yang sesuai harus diatur dengan ssh-agent untuk mengakses repositori khusus ini.

Mendaftarkan repositori fontist

Perintah fontist repo setup mengambil formula repositori khusus, dan menyimpan nama dan URL repositori untuk digunakan nanti.

Perintah fontist repo setup menggunakan sintaks berikut. 

fontist repo setup NAME URL

Secara internal, semua informasi repositori fontist khusus disimpan di ~/.fontist/formulas/Formulas/private .

Misalnya, diberi repositori fontis yang disebut "ACME" yang dapat diakses melalui URL atau alamat SSH: 

fontist repo setup acme https://example.com/acme/formulas.git
# or
fontist repo setup acme [email protected]:acme/formulas.git

Daftar repositori fontis khusus 

fontist repo list

Menginstal font dari repositori fontist

Setelah repositori fontist khusus diatur, orang dapat menginstal font dari repo melalui rumusnya: 

fontist install " custom font "

Memperbarui repositori fontist terdaftar

Jika repositori rumus fontist khusus diperbarui, perintah repo update digunakan untuk menarik perubahan terbaru: 

fontist repo update NAME

Misalnya, diberi repositori fontis yang disebut "AcMe", perintah berikut digunakan. 

fontist repo update acme

Menghapus repositori fontist terdaftar

Jika ada kebutuhan untuk menghapus repositori fontist terdaftar, repo dapat dihapus dengan: 

fontist repo remove acme

Akses pribadi

Rumus fontis khusus dan repositori fontis dapat dibuat pribadi untuk memerlukan otentikasi.

Untuk repositori fontis https dan ssh git

Otentikasi untuk formula pribadi atau repositori formula pribadi

Otorisasi arsip pribadi dalam formula pribadi dapat diimplementasikan dengan header.

Berikut adalah contoh yang berfungsi dengan rilis GitHub: 

 resources :
  fonts.zip :
    urls :
    - url : https://example.com/repos/acme/formulas/releases/assets/38777461
      headers :
        Accept : application/octet-stream
        Authorization : token ghp_1234567890abcdefghi

Jika repositori rumus fontis adalah repo GitHub, token dapat diperoleh pada halaman Pengaturan GitHub> Token. Token ini harus memiliki setidaknya ruang lingkup repo untuk akses ke aset -aset ini.

Buat formula fontis

Umum

Rumus fontis dapat dengan mudah dibuat dengan tangan di YAML. Namun, metode generasi otomatis direkomendasikan untuk akurasi dan kenyamanan data.

Menghasilkan secara otomatis formula fontis dari arsip font

Formula dapat dihasilkan dari arsip font.

Perintah fontist create-formula memungkinkan mendeteksi semua file font dari arsip font dalam banyak format (yang didukung oleh Excavate, termasuk ZIP, 7Z, GZIP, TAR, CAB, EXE).

Perintah fontist create-formula mendukung arsip yang berlokasi di URL jarak jauh atau jalur file lokal.

Untuk jalur file, tentukan jalur file sebagai argumen: 

wget https://www.latofonts.com/files/Lato2OFL.zip
fontist create-formula lato.zip

Untuk URL, cukup tentukan URL sebagai argumen: 

fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
# > file created at lato.yml because the file downloaded is lato.zip

Untuk menguji formula yang dibuat, seseorang dapat menyalin formula ke lokasi repositori formula pribadi pengguna. 

fontist create-formula https://www.latofonts.com/files/Lato2OFL.zip
cp lato.yml ~ /.fontist/formulas/Formulas/

Metadata font utama dalam formula fontis

Perintah fontist create-formula membuat formula font menggunakan informasi yang tertanam di bagian metadata OTF.

Namun, beberapa font (seperti font yang lebih lama) sering kali berisi informasi metadata yang tidak konsisten atau tidak sempurna. Beberapa font misalnya menerapkan nilai Family OTF yang berbeda untuk gaya font yang berbeda. Ini akan menghasilkan semua gaya font yang tidak terdaftar di keluarga yang sama.

Penulis rumus fontis dapat memperbaiki situasi ini dengan menggunakan kunci override: yang memungkinkan rumus untuk mengganti informasi metadata yang diperoleh dari metadata font.

Catatan
 Kunci override tidak menyebabkan perubahan dalam file font, itu hanya untuk memperbarui informasi yang digunakan oleh fontist internal.

Kunci override ada di bawah definisi gaya font individu: 

 resources :
  ...
fonts :
- name : Original font name
  styles :
    - family_name : Original family name
      type : Original style
      override :
        family_name : Overridden family name
        type : Overridden style
        preferred_family_name : Overridden preferred family name

Misalnya, font "Frutiger" yang diterbitkan oleh Adobe pada tahun 1994 menggunakan angka untuk mewakili gaya font individu, dan memiliki nama -nama yang tertanam di bidang Family OTF, seperti "Frutiger 45 Light". Font ini juga tidak menggunakan bidang Preferred Family OTF, yang merupakan tambahan yang lebih baru untuk OTF, karena usia mereka.

Berikut adalah bagaimana properti override dapat menegakkan semua gaya yang relevan untuk didaftarkan dengan nama keluarga yang sama (dengan menimpa nilai preferred_family_name ): 

...
resources :
  ...
fonts :
- name : Frutiger 45 Light
  styles :
  - family_name : Frutiger 45 Light
    type : Regular
    full_name : Frutiger-Light
    post_script_name : Frutiger-Light
    override :
      preferred_family_name : Frutiger
  - ...

Fragmen di atas ini akan memungkinkan fontist untuk menghasilkan indeks yang benar dan memungkinkan pemasangan semua font Frutiger dengan satu perintah: 

$ fontist install " Frutiger " --preferred-family

Upgrade Fontist

Ke v1.10+

Versi fontis di luar v1.10 menggunakan format formula baru. Setelah upgrade, silakan jalankan fontist update untuk mengambil formula terbaru.

Mulai dari v1.10, Fontist menggunakan "keluarga default" alih -alih "keluarga pilihan" saat mengelompokkan gaya.

Misalnya, permintaan untuk font "Lato" sebelum v1.10 akan mengembalikan semua gaya: "hitam", "miring hitam", "tebal", dan 15 gaya lainnya.

Dari v1.10 dan seterusnya, fontist hanya akan mengembalikan 4 gaya default: "reguler", "miring", "tebal" dan "tebal miring".

Untuk mengambil gaya lain, Anda harus menentukan font yang tepat "subfamily", seperti "Lato Black", atau "Lato Heavy", atau menggunakan opsi --preferred-family dengan CLI dan Fontist.preferred_family = true dengan Perpustakaan Ruby.

Catatan
 Sebelum v1.10 ada bug dengan formula font "kurir", yang memungkinkan font diinstal saat meminta nama font "kurir", tetapi lokasi font -nya hanya dapat diperoleh menggunakan nama font "Courier New" lengkap. Dari v1.10 dan seterusnya perilaku telah dibuat konsisten - hanya nama "kurir baru" yang tepat yang harus digunakan.

Ke v1.16+

Versi fontist di luar v1.16 memperlakukan argumen font dari perintah install secara berbeda. Setelah upgrade, harap pastikan semua font yang diperlukan ditentukan saat menggunakan fontist install , fontist -F, --formula fontist manifest-install (dan antarmuka ruby Font.install Manifest::Install

Mulai dari v1.16, pemasangan fontist hanya meminta font bukannya seluruh formula, kecuali ditentukan secara eksplisit. berubah sekarang.

Misalnya, permintaan instalasi untuk font "Arial" sebelum v1.16 akan mengatur semua font yang ditemukan dalam formula "MS_TRUETYPE": "Arial", "Trebuchet MS", "Verdana" dan "Times New Roman".

Dari v1.16 dan seterusnya, fontist hanya akan menginstal font "Arial" yang diminta.

Untuk menginstal semua font dari formula, opsi -F, --formula dapat digunakan: 

$ fontist install --formula ms_truetype

Pemeliharaan (hanya untuk pemelihara fontis!)

Peringatan
 Bagian ini hanya untuk pengelola fontis.

Versi Rumus

Untuk menambahkan atribut baru, ubah bagaimana rumus diperlakukan atau sepenuhnya menggantikan struktur, ada 2 cara untuk mengubah format rumus:

  1. Gunakan atribut min_fontist dalam rumus. Ini menetapkan persyaratan untuk Fontist untuk menginstal rumus hanya jika versinya sama atau lebih dari versi yang ditentukan.

  2. Gunakan cabang baru dalam repo rumus, misalnya "v2", "v3", "v4", dll. Setelah membuat cabang baru, itu harus didefinisikan dalam Fontist.formulas_version

Catatan
 Menggunakan cabang baru akan mengharuskan semua pengguna untuk mengunduh ulang seluruh rumus repo. Karena metode ini memiliki overhead yang signifikan, yang pertama ( min_fontist ) harus digunakan jika memungkinkan.

Mengimpor formula secara dinamis dari Google Fonts

Google Fonts mungkin menyediakan koleksi terbesar font berlisensi yang banyak digunakan, secara bebas dan secara terbuka.

Perpustakaan Formula Fontist mencakup dukungan untuk semua font berlisensi terbuka yang disediakan melalui Google Fonts, dan memelihara formula fontis untuk semua font tersebut.

Alur kerja GHA memeriksa font yang diperbarui di google font setiap hari. Jika pembaruan ditemukan, itu ditambahkan ke repo oleh alur kerja.

Secara dinamis mengimpor formula dari SIL

SIL International adalah organisasi nirlaba berbasis agama yang diakui secara internasional yang melayani komunitas bahasa di seluruh dunia.

SIL menyediakan sejumlah font unik yang mendukung komunitas bahasa yang lebih kecil yang dengan kode unicode sering belum (belum) didukung oleh font utama.

Fontist bertujuan untuk mendukung semua font SIL dan menyediakan formula mereka di repositori rumus fontis default.

Mereka dapat diperbarui dengan: 

fontist import sil
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/sil
git commit -m " SIL fonts update "
git push

Mengimpor formula secara dinamis dari macOS

MacOS menyediakan font yang dapat diunduh secara manual dengan Font Book.app .

Untuk memperbarui rumus macOS: 

fontist import macos
cd ~ /.fontist/versions/{last_version}/formulas
git add Formulas/macos
git commit -m " Update macOS formulas "
git push

Perkembangan

Pengaturan

Klon Repositori. 

git clone https://github.com/fontist/fontist

Siapkan lingkungan Anda. 

bin/setup

Jalankan Test Suite 

bin/rspec

Penyimpanan formula

Semua formula fontis resmi disimpan dalam repositori rumus.

Jika Anda ingin menambahkan repositori rumus baru atau mengubah pengaturan untuk yang sudah ada, silakan merujuk ke dokumentasinya.

Melepaskan

Pelepasan dilakukan secara otomatis dengan tindakan GitHub. Cukup menabrak dan memberi tag dengan gem-release .

Untuk rilis patch (0.0.x) Gunakan: 

gem bump --version patch --tag --push

Untuk rilis minor (0.x.0) Gunakan: 

gem bump --version minor --tag --push

Berkontribusi

Pertama, terima kasih telah berkontribusi! Kami menyukai permintaan tarik dari semua orang. Dengan berpartisipasi dalam proyek ini, Anda dengan ini memberikan Ribose hak untuk memberikan atau mentransfer sejumlah lisensi atau sub-lisensi non eksklusif untuk pihak ketiga, di bawah hak cipta yang mencakup kontribusi untuk menggunakan kontribusi dengan segala cara.

Kami mengikuti aturan Sandi Metz untuk permata ini, Anda dapat membaca deskripsi aturan di sini. Semua kode baru harus mengikuti aturan ini. Jika Anda membuat perubahan dalam file yang sudah ada sebelumnya yang melanggar aturan ini, Anda harus memperbaiki pelanggaran sebagai bagian dari kontribusi Anda.

Berikut adalah beberapa pedoman teknis untuk diikuti:

  1. Buka masalah untuk membahas fitur baru.

  2. Tulis tes untuk mendukung fitur baru Anda.

  3. Pastikan seluruh suite tes lewat secara lokal dan pada CI.

  4. Buka permintaan tarik.

  5. Squash komitmen Anda setelah menerima umpan balik.

  6. Berpesta!

Kredit

Permata ini dikembangkan, dipelihara dan didanai oleh ribosa.

Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua