หน้าแรก>แหล่งข้อมูลการสร้างเว็บไซต์>ดาวน์โหลดแบบอักษร
ดาวน์โหลด

ฟอนต์

ห้องสมุดง่าย ๆ ที่จะค้นหาและดาวน์โหลดแบบอักษรสำหรับ Windows, Linux และ Mac

การติดตั้ง

ติดตั้งโดยตรงเป็น: 

gem install fontist

หรือใช้เป็นส่วนหนึ่งของชุดของคุณโดยเพิ่มบรรทัดนี้ไปยัง Gemfile ของแอปพลิเคชันของคุณ: 

 gem "fontist"

แล้วดำเนินการ: 

bundle install

ดึงสูตร

หลังจากการติดตั้งโปรดดึงสูตรผ่านคำสั่ง fontist : 

fontist update

การพึ่งพาอาศัยกัน

ขึ้นอยู่กับ FFI-libarchive-binary ซึ่งมีข้อกำหนดดังต่อไปนี้:

  • zlib

  • ชาวต่างชาติ

  • OpenSSL (สำหรับ Linux เท่านั้น)

การพึ่งพาเหล่านี้โดยทั่วไปจะมีอยู่ในทุกระบบ

การใช้อินเทอร์เฟซบรรทัดคำสั่ง (CLI)

คำสั่ง fontist

คำสั่งเหล่านี้ทำให้สามารถใช้งานกับแบบอักษรผ่านบรรทัดคำสั่ง

CLI รองรับสถานะการออกอย่างถูกต้องดังนั้นในกรณีของข้อผิดพลาดจะส่งคืนรหัสสถานะสูงกว่าหรือเท่ากับ 1

การค้นหาเป็นตัวพิมพ์เล็กเพื่อใช้งานง่าย

คำสั่งทั้งหมดสนับสนุนตัวเลือกส่วนกลางต่อไปนี้:

--preferred-family

ค้นหาโดยใช้ชื่อ“ ครอบครัวที่ต้องการ” ของแบบอักษร (แทนที่จะเป็นชื่อ "ครอบครัวเริ่มต้น" ค่าเริ่มต้นก่อน Fontist v1.10)

บันทึก
 ดูที่ v1.10+ สำหรับความแตกต่างระหว่าง“ ครอบครัวที่ต้องการ” และ“ ครอบครัวเริ่มต้น”
-q, --quiet

พิมพ์ข้อมูลน้อยที่สุดเท่าที่จะเป็นไปได้ซึ่งส่วนใหญ่เป็นข้อผิดพลาดที่สำคัญ

-v, --verbose

ตั้งค่าระดับบันทึกเป็น debug มันพิมพ์สูตรที่แยกออกระหว่างการติดตั้งและข้อมูลสำหรับนักพัฒนาของฟอนต์

-c, --no-cache

ชอบดาวน์โหลดโดยตรงแม้ว่าไฟล์จะถูกแคชไว้แล้วในระบบ

ติดตั้งฟอนต์: fontist install

Fontist ตรวจสอบว่าตัวอักษรนี้ติดตั้งแล้วหรือไม่และถ้าไม่ก็ตามให้ติดตั้งตัวอักษรและส่งคืนเส้นทางที่ติดตั้ง

ชื่อตัวอักษรเป็นอาร์กิวเมนต์เดียวที่จะจัดหา 

$ 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

โดยค่าเริ่มต้นรูปแบบการจับคู่ทั้งหมด (ตามชื่อ "ครอบครัวเริ่มต้น" ของตัวอักษร) ได้รับการติดตั้ง

บันทึก
 ก่อนหน้า v1.10 ชื่อ "ครอบครัวที่ต้องการ" ของตัวอักษรจะใช้เพื่อจับคู่สไตล์สำหรับการค้นหา ดูที่ v1.10+ สำหรับรายละเอียดของการเปลี่ยนแปลงนั้น

ในการติดตั้งฟอนต์ทั้งหมดที่ระบุในสูตรฟอนต์ให้ใช้ตัวเลือก -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

ที่นี่ courier_prime เป็นชื่อไฟล์ของสูตรที่ตั้งอยู่ที่พื้นที่เก็บข้อมูลสูตรฟอนโตรเจนสาธารณะ ( courier_prime.yml )

นอกจากนี้คุณยังสามารถระบุชื่อที่มนุษย์อ่านได้ของสูตร ชื่อนี้ได้มาจากชื่อไฟล์โดยมีขีดเส้นใต้ที่ถูกแทนที่ด้วยช่องว่าง ไม่ใช่กรณีที่มีความอ่อนไหวซึ่งหมายความว่าคุณสามารถใช้ตัวอักษรตัวใหญ่ได้หากคุณต้องการ 

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

การติดตั้งโดยชื่อสูตรรองรับคำแนะนำใน CLI เมื่ออินพุตเป็นบางส่วน: 

$ 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:
บันทึก
 การระบุชื่อไฟล์ของตัวอักษรยังไม่ได้รับการสนับสนุน

หากมีสูตรหลายสูตรที่มีแบบอักษรที่ร้องขอ fontist จะค้นหาแบบอักษรรุ่นใหม่ล่าสุดของสูตรที่มีขนาดต่ำกว่าขีด จำกัด (300 MB) พฤติกรรมนี้สามารถเปลี่ยนแปลงได้ด้วยตัวเลือก

บันทึก
 หากรูปแบบของตัวอักษรแพร่กระจายไปตามสูตรหลายสูตรดังนั้นรูปแบบที่มีอยู่ทั้งหมดจากสูตรทั้งหมดจะถูกติดตั้ง
บันทึก
 สูตรบางอย่างอาจมีแอตทริบิวต์ min_fontist ซึ่งกำหนดฟอนต์รุ่นต่ำสุดที่สามารถติดตั้งได้ หาก fontist เป็นรุ่นเก่าแล้วสูตรจะหลีกเลี่ยงการใช้ เพื่อที่จะดูว่าสูตรใดที่ถูกแยกออกจากการค้นหาสามารถระบุตัวเลือก -v, --verbose

ตัวเลือกที่รองรับ:

-f, [--force]

ติดตั้งแม้ว่าติดตั้งไว้แล้วในระบบแล้ว

-F, [--formula]

ติดตั้งสูตรทั้งหมดแทนตัวอักษร

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

ยอมรับข้อตกลงใบอนุญาตทั้งหมด

-h, [--hide-licenses]

ซ่อนข้อความใบอนุญาต

-p, [--no-progress]

ซ่อนความคืบหน้าการดาวน์โหลด

-V, [--version=VERSION]

ติดตั้งตัวอักษรรุ่นเฉพาะ

-s, [--smallest]

ติดตั้งตัวอักษรที่เล็กที่สุดตามขนาดไฟล์หากมีหลายตัว

-n, [--newest]

ติดตั้งฟอนต์เวอร์ชันใหม่ล่าสุดหากมีหลายแบบ

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

ระบุขีด จำกัด บนสำหรับขนาดไฟล์ของสูตรที่จะติดตั้ง (ค่าเริ่มต้นคือ 300 MB)

-u, [--update-fontconfig]

อัปเดต fontconfig

บันทึก
 คำสั่ง install นั้นคล้ายกับการเรียกใช้ Font.install การเรียกใช้ไลบรารี

ถอนการติดตั้งแบบอักษร: fontist uninstall

ถอนการติดตั้งตัวอักษรใด ๆ ที่สนับสนุนโดย Fontist

ส่งคืนเส้นทางของตัวอักษรที่ถูกถอนการติดตั้งหรือพิมพ์ข้อผิดพลาดบอกว่าตัวอักษรไม่ได้ติดตั้งหรือไม่สามารถพบได้ในสูตรฟอนต์ นามแฝงเป็น 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

สถานะ: fontist status

พิมพ์เส้นทางฟอนต์ที่ติดตั้งด้วยสูตรที่สอดคล้องกัน 

$ 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)

รายการ: fontist list

แสดงรายการสถานะการติดตั้งของแบบอักษรที่สนับสนุนโดย 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)

รายการเส้นทางฟอนต์ที่ติดตั้ง: fontist manifest-locations

ส่งคืนตำแหน่งของแบบอักษรที่ระบุไว้ในไฟล์ YAML เป็นอินพุต 

$ fontist manifest-locations MANIFEST_FILE

MANIFEST_FILE เป็นที่ตั้งของไฟล์รายการที่มีข้อมูลจำเพาะของรูปแบบตัวอักษรและแบบอักษรหนึ่งหรือหลายรูปแบบ

ไฟล์ Manifest manifest.yml อาจมีลักษณะ: 

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

คำสั่งต่อไปนี้จะส่งคืนเอาต์พุต YAML ต่อไปนี้: 

$ 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 "

หากฟอนต์ที่ร้องขออย่างน้อยหนึ่งแบบหายไปรหัสข้อผิดพลาด "3" จะถูกส่งคืนและพิมพ์ข้อความ: 

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

ติดตั้งตัวอักษรจากรายการ: fontist manifest-install

ติดตั้งแบบอักษรจาก Manifest Fontist Yaml: 

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

ที่ไหน manifest.yaml คือ: 

---
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 "

ทำงานกับ Fontist Config: fontist config

Fontist รองรับการตั้งค่าทั่วทั้งระบบสำหรับพารามิเตอร์ต่อไปนี้:

fonts_path

ตั้งค่าเส้นทางที่จะติดตั้งแบบอักษร (ค่าเริ่มต้น: ~/.fontist/fonts )

open_timeout

ตั้งค่าหมดเวลาสำหรับการเปิดการเชื่อมต่อระหว่างการดาวน์โหลด (ค่าเริ่มต้น: 10 )

read_timeout

ตั้งค่าหมดเวลาสำหรับการอ่านการเชื่อมต่อที่เปิดอยู่ระหว่างการดาวน์โหลด (ค่าเริ่มต้น: 10 )

แสดงแอตทริบิวต์ปัจจุบันใน config: 

$ fontist config show
Current config:
read_timeout: 5

กำหนดค่าให้กับแอตทริบิวต์: 

$ fontist config set read_timeout 60

กู้คืนค่าเริ่มต้นของแอตทริบิวต์: 

$ fontist config delete read_timeout

ทำงานกับ fontconfig: fontist fontconfig

FontConfig เป็นซอฟต์แวร์ที่ออกแบบมาเพื่อจัดหาแบบอักษรให้กับโปรแกรมอื่น ๆ โดยทั่วไปจะใช้กับ Linux แต่ยังมีอยู่ใน MacOS และ Windows FontConfig ถูกใช้โดย LibreOffice, GIMP และโปรแกรมอื่น ๆ อีกมากมาย

เพื่อค้นหาแบบอักษรฟอนต์, fontconfig ควรได้รับการปรับปรุงเพื่อรวมเส้นทางฟอนต์ สามารถทำได้ด้วยตัวเลือก --update-fontconfig ของคำสั่ง install หรือเรียกตัวเลือกพิเศษ: 

$ fontist fontconfig update

มันจะสร้างการกำหนดค่าใน ~/.config/fontconfig/conf.d/10-fontist.conf

เพื่อลบออกโปรดใช้: 

$ fontist fontconfig remove

ทำงานกับแคช 

$ fontist cache clear

คำสั่งด้านบนจะล้างแคชดาวน์โหลดของ Fontist

ความช่วยเหลือ: fontist help

รายการคำสั่งทั้งหมดสามารถมองเห็นได้โดย: 

fontist help

การกำหนดค่าด้วยตัวแปรสภาพแวดล้อม

โดยค่าเริ่มต้น Fontist ใช้ไดเรกทอรี ~/.fontist เพื่อจัดเก็บแบบอักษรและไฟล์ มันสามารถเปลี่ยนแปลงได้ด้วยตัวแปรสภาพแวดล้อม FONTIST_PATH 

FONTIST_PATH= ~ /.fontist_new fontist update

ใช้ห้องสมุดทับทิม

Fontist::Font

Fontist::Font เป็นสถานที่ของคุณในการจัดการกับแบบอักษรใด ๆ ที่ใช้ฟอนต์

อินเทอร์เฟซนี้ช่วยให้คุณค้นหาแบบอักษรหรือติดตั้งตัวอักษร

ค้นหาแบบอักษร

Fontist::Font.find Interface สามารถใช้ค้นหาแบบอักษรในระบบของคุณ

มันจะตรวจสอบไดเรกทอรีตัวอักษรเฉพาะของระบบปฏิบัติการและยังมีไดเรกทอรี ~/.fontist เฉพาะของ Fontist 

 Fontist :: Font . find ( name )

  • หากฟอนต์พบตัวอักษรก็จะส่งคืนเส้นทาง

  • มิฉะนั้นจะเพิ่มข้อผิดพลาดแบบอักษรที่ไม่ได้รับการสนับสนุนหรือทริกเกอร์แสดงคำแนะนำการติดตั้งสำหรับแบบอักษรที่เฉพาะเจาะจงนั้น

ติดตั้งตัวอักษร

Fontist::Font.install Interface สามารถใช้เพื่อติดตั้งตัวอักษรที่รองรับได้

อินเทอร์เฟซนี้ตรวจสอบก่อนว่าคุณติดตั้งแบบอักษรนั้นแล้วหรือไม่และถ้าคุณทำมันจะส่งคืนเส้นทาง

หากคุณไม่มีแบบอักษร แต่ตัวอักษรนั้นได้รับการสนับสนุนโดย Fontist มันจะดาวน์โหลดตัวอักษรและคัดลอกไปยังไดเรกทอรี ~/.fontist และกลับไปที่เส้นทาง 

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

หากมีปัญหาที่ตรวจพบด้วยตัวอักษรที่ให้มาเช่นตัวอักษรไม่ได้รับการสนับสนุนข้อผิดพลาดเหล่านั้นจะถูกยกขึ้น

แสดงรายการแบบอักษรทั้งหมด

Fontist::Font Interface เปิดเผยอินเทอร์เฟซเพื่อแสดงรายการแบบอักษรที่รองรับทั้งหมด

สิ่งนี้อาจมีประโยชน์หากต้องการทราบชื่อของแบบอักษรหรือสไตล์ที่มีอยู่ คุณสามารถทำได้โดยใช้: 

 Fontist :: Font . all

ค่าส่งคืนเป็นวัตถุ OpenStruct ดังนั้นคุณสามารถทำการดำเนินการอื่น ๆ ที่คุณจะทำในวัตถุทับทิมใด ๆ

Fontist::Formula

อัญมณี fontist ภายในใช้งานอินเตอร์เฟส Fontist::Formula เพื่อค้นหาสูตรที่ลงทะเบียนหรือแบบอักษรที่สนับสนุนโดยสูตรใด ๆ เว้นแต่คุณจะต้องทำอะไรกับสิ่งที่คุณไม่จำเป็นต้องทำงานกับอินเทอร์เฟซนี้โดยตรง แต่ถ้าคุณทำสิ่งเหล่านี้คือส่วนต่อประสานสาธารณะที่มีให้

ค้นหาสูตร

Fontist::Formula.find Interface ช่วยให้คุณค้นหาสูตรใด ๆ ที่ลงทะเบียนได้ อินเทอร์เฟซนี้ใช้ชื่อตัวอักษรเป็นอาร์กิวเมนต์และมองผ่านสูตรที่ลงทะเบียนแต่ละสูตรที่มีการติดตั้งแบบอักษรนี้ การใช้งาน: 

 Fontist :: Formula . find ( "Calibri" )

วิธีนี้จะค้นหาและส่งคืนสูตรฟอนต์สำหรับคำหลักที่ให้ไว้ซึ่งอนุญาตให้ทำการประมวลผลเพิ่มเติมเช่นการตรวจสอบใบอนุญาตหรือดำเนินการติดตั้งแบบอักษรในระบบของคุณ

รายการรูปแบบตัวอักษรที่รองรับโดยสูตร

โดยปกติแล้วชื่อตัวอักษรแต่ละตัวสามารถเชื่อมโยงกับหลายสไตล์หรือคอลเลกชันตัวอย่างเช่นตัวอักษร Calibri อาจมีแบบอักษรรูปแบบ regular bold หรือ italic และถ้าคุณต้องการอินเทอร์เฟซที่สามารถส่งคืนรายการที่สมบูรณ์นี่คือเพื่อนของคุณ

คุณสามารถใช้ดังนี้: 

 Fontist :: Formula . find_fonts ( "Calibri" )

แสดงรายการสูตรทั้งหมด

Fontist::Formula Interface เปิดเผยอินเทอร์เฟซเพื่อแสดงรายการสูตรตัวอักษรที่ลงทะเบียนทั้งหมด สิ่งนี้อาจมีประโยชน์หากต้องการทราบชื่อของสูตรหรือแบบอักษรประเภทใดที่สามารถติดตั้งได้โดยใช้สูตรนั้น การใช้งาน: 

 Fontist :: Formula . all

ค่าส่งคืนเป็นวัตถุ OpenStruct ดังนั้นคุณสามารถทำการดำเนินการอื่น ๆ ที่คุณจะทำในวัตถุทับทิมใด ๆ

Fontist::Manifest

ตัวเลือกทั่วโลก

Fontist สามารถเปลี่ยนเพื่อใช้ชื่อครอบครัวที่ต้องการ รูปแบบนี้ใช้ก่อน v1.10 

 Fontist . preferred_family = true

Fontist::Manifest::Locations

Fontist ช่วยให้คุณค้นหาตำแหน่งตัวอักษรจากแฮชรายการที่กำหนดไว้ในรูปแบบต่อไปนี้: 

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

การโทรรหัสต่อไปนี้ส่งคืนแฮชซ้อนกันด้วยเส้นทางและชื่อแบบอักษร ชื่อตัวอักษรมีประโยชน์ในการเลือกแบบอักษรที่เฉพาะเจาะจงในไฟล์คอลเลกชันตัวอักษร (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 ให้คุณไม่เพียง แต่จะได้รับตำแหน่งแบบอักษรเท่านั้น แต่ยังต้องติดตั้งแบบอักษรจากรายการ: 

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

มันจะติดตั้งฟอนต์และส่งคืนสถานที่ของพวกเขา: 

 {
  "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" ]
    }
  }
}

สนับสนุนรูปแบบ yaml

คำสั่งทั้งสองรองรับไฟล์ YAML เป็นอินพุตด้วยวิธี A from_file ตัวอย่างเช่นหากมีไฟล์ manifest.yml ที่มี: 

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

จากนั้นการโทรต่อไปนี้จะส่งคืนชื่อตัวอักษรและเส้นทางจากวิธีจาก from_hash (ดู Fontist::Manifest::Install และ Fontist::Manifest::Locations ) 

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

Fontist::Fontconfig

Fontist รองรับการทำงานกับ FontConfig ผ่าน Ruby Interface: 

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

คุณสมบัติเฉพาะแพลตฟอร์ม

แบบอักษรเสริมเฉพาะ MacOS

MacOS รุ่นใหม่ให้การติดตั้งแบบฟอนต์ที่ได้รับใบอนุญาตหลากหลายแบบตามความต้องการ แบบอักษรเสริมเฉพาะ MacOS เหล่านี้สามารถติดตั้งผ่าน Fontist

การใช้งานทั่วไปสำหรับการติดตั้งแบบอักษรเสริม MacOS คือการอนุญาตให้งาน CI ในสภาพแวดล้อม MacOS ใช้แบบอักษรที่ได้รับใบอนุญาตพิเศษเหล่านี้ไม่สามารถใช้ได้บนแพลตฟอร์มอื่น ๆ

โพสต์บล็อกนี้อธิบายถึงวิธีการทำงาน:

  • Fontist Blog: การติดตั้งแบบอักษรเสริมเฉพาะ MacOS

ตัวอย่างเช่นตัวอักษร "Canela" เป็นแบบอักษรเชิงพาณิชย์ที่มาพร้อมกับ MacOS ฟรี

เรียกใช้คำสั่งนี้เพื่อติดตั้ง canela บน macOS 

$ fontist install Canela

รายการแบบอักษรที่มีอยู่ทั้งหมดในรุ่น MacOS ต่างๆสามารถพบได้ในเว็บไซต์สนับสนุน Apple:

  • แบบอักษรใน MacOS 13 Ventura

  • แบบอักษรใน MacOS 12 Monteray

  • แบบอักษรใน MacOS 11 Big Sur

คำเตือน
 Fontist ไม่อนุญาตให้ติดตั้งแบบอักษรเฉพาะ MACOS บนแพลตฟอร์มที่ไม่ใช่ MACOS เนื่องจากข้อ จำกัด ใบอนุญาตแบบอักษรของแบบอักษรเหล่านั้น

ฟอนต์ที่มีปัญหาที่รู้จัก

  • NISC18030.TTF (GB18030 BITMAP) - MACOS ข้อมูลเพิ่มเติมในฉบับ NISC18030

รายการแบบอักษรที่เป็นปัญหาทั้งหมดที่รู้จัก:

  • รายการแบบอักษรที่แยกออกจากการใช้งาน

การใช้งานขั้นสูง

ใช้พร็อกซีเซิร์ฟเวอร์

Fontist ใช้ GIT ภายในเพื่อดึงสูตรและแบบอักษร

ในการใช้ฟังก์ชั่น GIT ที่อยู่เบื้องหลังพร็อกซีคุณต้องอัปเดต GIT Config ของคุณเองผ่านคำสั่ง git config หรือไฟล์การตั้งค่า ~/.gitconfig

มีหลายวิธีในการกำหนดค่าการติดตั้ง Git ในเครื่องของคุณเพื่อใช้พร็อกซี

วิธีที่ง่ายที่สุดและทั่วโลกในการตั้งค่าพร็อกซีสำหรับ Git นั้นมีดังต่อไปนี้

  • สำหรับ http 

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

  • สำหรับ HTTPS คุณอาจต้องจัดการข้อผิดพลาดการตรวจสอบ SSL/TLS หลังจากตั้งค่าพร็อกซีเนื่องจากปลายการเข้ารหัสอยู่ที่จุดสิ้นสุด HTTPS พร็อกซีของคุณ: 

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

  • สำหรับถุงเท้าคุณจะต้องตัดสินใจเกี่ยวกับโปรโตคอลถุงเท้า 

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

    ตัวอย่างเช่น, 

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

รายการโปรโตคอลถุงเท้าที่รองรับสำหรับฟิลด์ {protocol} :

  • socks:// : สำหรับถุงเท้าด้านล่าง v5

  • socks5:// : สำหรับถุงเท้า v5

  • socks5h:// : สำหรับถุงเท้าด้านล่าง V5 + ความละเอียดโฮสต์ผ่านถุงเท้า

คุณสามารถตั้งค่าพฤติกรรมพร็อกซีที่แตกต่างกันสำหรับที่เก็บ GIT แต่ละอัน - โปรดดูคู่มือที่ยอดเยี่ยมเกี่ยวกับวิธีการใช้พร็อกซี Git (ขอบคุณผู้ใช้ GitHub Evantoli)

ที่เก็บฟอนต์ที่กำหนดเอง

ทั่วไป

ที่เก็บฟอนต์เป็น repo git ซึ่งมีไฟล์สูตร Yaml สูตร Fontist สามารถสร้างได้ด้วยตนเองภายในที่เก็บฟอนต์ (ดูตัวอย่าง) หรือสร้างอัตโนมัติจากการเก็บถาวรแบบอักษร

สามารถเข้าถึงพื้นที่เก็บข้อมูลฟอนต์ผ่าน HTTPS หรือ SSH ได้ ในกรณีของ SSH ควรตั้งค่าคีย์ SSH ที่สอดคล้องกันกับ ssh-agent เพื่อเข้าถึงที่เก็บที่กำหนดเองนี้

การลงทะเบียนที่เก็บฟอนต์

คำสั่ง fontist repo setup ดึงสูตรของที่เก็บที่กำหนดเองและเก็บชื่อและ URL ของที่เก็บสำหรับใช้ในภายหลัง

คำสั่ง fontist repo setup ใช้ไวยากรณ์ต่อไปนี้ 

fontist repo setup NAME URL

ภายในข้อมูลที่เก็บข้อมูลฟอนต์ที่กำหนดเองทั้งหมดจะถูกเก็บไว้ที่ ~/.fontist/formulas/Formulas/private

ตัวอย่างเช่นที่ได้รับที่เก็บฟอนต์ที่เรียกว่า "ACME" สามารถเข้าถึงได้ผ่าน URL หรือที่อยู่ SSH: 

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

รายการที่เก็บฟอนต์ที่กำหนดเอง 

fontist repo list

การติดตั้งฟอนต์จากที่เก็บฟอนต์

เมื่อตั้งค่าที่เก็บฟอนต์แบบกำหนดเองแล้วเราสามารถติดตั้งตัวอักษรจาก repo ผ่านสูตรของมัน: 

fontist install " custom font "

การอัปเดตที่เก็บฟอนต์ที่ลงทะเบียน

หากมีการอัปเดตที่เก็บสูตร Fontist ที่กำหนดเองคำสั่ง repo update จะใช้เพื่อดึงการเปลี่ยนแปลงใหม่ล่าสุด: 

fontist repo update NAME

ตัวอย่างเช่นที่ได้รับที่เก็บฟอนต์ที่เรียกว่า "ACME" จะใช้คำสั่งต่อไปนี้ 

fontist repo update acme

การลบพื้นที่เก็บข้อมูล Fontist ที่ลงทะเบียน

หากมีความจำเป็นที่จะต้องลบที่เก็บฟอนต์ที่ลงทะเบียนแล้ว repo สามารถลบออกได้ด้วย: 

fontist repo remove acme

การเข้าถึงส่วนตัว

สูตร Fontist ที่กำหนดเองและที่เก็บฟอนต์สามารถทำให้เป็นส่วนตัวเพื่อต้องการการตรวจสอบความถูกต้อง

สำหรับที่เก็บฟอนต์ HTTPS และ SSH Git

การรับรองความถูกต้องสำหรับสูตรส่วนตัวหรือที่เก็บสูตรส่วนตัว

การอนุมัติการเก็บถาวรส่วนตัวในสูตรส่วนตัวสามารถนำไปใช้กับส่วนหัวได้

นี่คือตัวอย่างที่ใช้งานได้กับ GitHub เผยแพร่: 

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

หากพื้นที่เก็บข้อมูลสูตรฟอนต์เป็น repo gitHub สามารถรับโทเค็นในหน้าการตั้งค่า GitHub> โทเค็น โทเค็นนี้ควรมีขอบเขต repo อย่างน้อยสำหรับการเข้าถึงสินทรัพย์เหล่านี้

สร้างสูตรฟอนต์

ทั่วไป

สูตร Fontist สามารถสร้างด้วยมือได้อย่างง่ายดายใน Yaml อย่างไรก็ตามวิธีการสร้างรุ่นอัตโนมัตินั้นขอแนะนำให้ใช้ความแม่นยำและความสะดวกสบาย

สร้างสูตรฟอนต์อัตโนมัติจากไฟล์เก็บถาวรแบบอักษร

สูตรสามารถสร้างได้จากการเก็บถาวรแบบอักษร

คำสั่ง fontist create-formula อนุญาตให้ตรวจจับไฟล์ฟอนต์ทั้งหมดจากการเก็บถาวรแบบอักษรในรูปแบบที่หลากหลาย

คำสั่ง fontist create-formula รองรับคลังเก็บที่อยู่ที่ URL ระยะไกลหรือเส้นทางไฟล์ท้องถิ่น

สำหรับพา ธ ไฟล์ให้ระบุเส้นทางไฟล์เป็นอาร์กิวเมนต์: 

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

สำหรับ URL เพียงระบุ URL เป็นอาร์กิวเมนต์: 

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

ในการทดสอบสูตรที่สร้างขึ้นหนึ่งอาจคัดลอกสูตรลงในที่ตั้งที่เก็บสูตรส่วนตัวของผู้ใช้ 

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

เมตาดาต้าแบบอักษรเอาชนะในสูตรฟอนต์

คำสั่ง fontist create-formula สร้างสูตรตัวอักษรโดยใช้ข้อมูลที่ฝังอยู่ในส่วนข้อมูลเมตา OTF

อย่างไรก็ตามฟอนต์บางตัว (เช่นแบบอักษรเก่า) มักจะมีข้อมูลข้อมูลเมตาที่ไม่สอดคล้องหรือไม่สมบูรณ์ ตัวอย่างแบบอักษรบางอย่างใช้ค่า Family OTF ที่แตกต่างกันสำหรับรูปแบบตัวอักษรที่แตกต่างกัน ซึ่งจะส่งผลให้รูปแบบตัวอักษรทั้งหมดที่ไม่ได้ลงทะเบียนในครอบครัวเดียวกัน

ผู้เขียนสูตร Fontist สามารถแก้ไขสถานการณ์นี้ได้โดยใช้ override: คีย์ซึ่งช่วยให้สูตรสามารถแทนที่ข้อมูลข้อมูลเมตาที่ได้รับจากข้อมูลเมตาของตัวอักษร

บันทึก
 คีย์ override ไม่ได้ทำให้เกิดการเปลี่ยนแปลงใด ๆ ในไฟล์ตัวอักษร แต่เป็นเพียงการอัปเดตข้อมูลที่ใช้โดยฟอนต์ภายในเท่านั้น

คีย์ override มีอยู่ภายใต้คำจำกัดความของรูปแบบตัวอักษรแต่ละตัว: 

 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

ตัวอย่างเช่นแบบอักษร "frutiger" ที่ตีพิมพ์โดย Adobe ในปี 1994 ใช้หมายเลขเพื่อเป็นตัวแทนของรูปแบบตัวอักษรแต่ละตัวและมีชื่อเหล่านั้นฝังอยู่ในสนาม Family OTF เช่น "Frutiger 45 Light" ฟอนต์เหล่านี้ยังไม่ใช้สนาม Preferred Family OTF ซึ่งเป็นส่วนเสริมล่าสุดของ OTF เนื่องจากอายุของพวกเขา

นี่คือวิธีที่คุณสมบัติ override สามารถบังคับใช้รูปแบบที่เกี่ยวข้องทั้งหมดที่จะลงทะเบียนภายใต้ชื่อตระกูลเดียวกัน (โดยการแทนที่ค่า 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
  - ...

ชิ้นส่วนด้านบนนี้จะช่วยให้ฟอนต์สร้างดัชนีที่ถูกต้องและอนุญาตให้ติดตั้งฟอนต์ Frutiger ทั้งหมดด้วยคำสั่งเดียว: 

$ fontist install " Frutiger " --preferred-family

การอัพเกรดฟอนต์

ถึง v1.10+

รุ่นฟอนต์เกินกว่า V1.10 ใช้รูปแบบสูตรใหม่ หลังจากการอัพเกรดโปรดเรียกใช้ fontist update เพื่อดึงสูตรล่าสุด

เริ่มจาก v1.10 ฟอนต์ใช้ "ครอบครัวเริ่มต้น" แทน "ครอบครัวที่ต้องการ" เมื่อจัดกลุ่มสไตล์

ตัวอย่างเช่นการร้องขอฟอนต์“ LATO” ก่อน V1.10 จะกลับมาทุกรูปแบบ:“ Black”,“ Black Italic”,“ Bold” และอีก 15 สไตล์

จาก v1.10 เป็นต้นไปฟอนต์จะส่งคืน เพียง 4 รูปแบบเริ่มต้น:“ ปกติ”,“ ตัวเอียง”,“ ตัวหนา” และ“ ตัวหนาตัวหนา”

ในการดึงรูปแบบอื่น ๆ คุณต้องระบุแบบอักษรที่แน่นอน“ อนุวงศ์” เช่น“ Lato Black” หรือ“ Lato Heavy” หรือใช้ตัวเลือก --preferred-family กับ CLI และ Fontist.preferred_family = true

บันทึก
 ก่อนหน้า v1.10 มีข้อผิดพลาดกับสูตร“ Courier” Font ซึ่งอนุญาตให้ติดตั้งตัวอักษรเมื่อขอชื่อตัวอักษร“ Courier” แต่ตำแหน่งตัวอักษรนั้นสามารถใช้งานได้โดยใช้ชื่อตัวอักษร“ Courier ใหม่” เต็มรูปแบบ จาก v1.10 เป็นต้นไปพฤติกรรมที่สอดคล้องกัน - ควรใช้ชื่อ "ผู้จัดส่งใหม่" ที่เหมาะสมเท่านั้น

ถึง v1.16+

เวอร์ชันฟอนต์เกินกว่า V1.16 ถือว่าอาร์กิวเมนต์ font อักษรของคำสั่ง install แตกต่างกัน หลังจากการอัพเกรดโปรดตรวจสอบให้แน่ใจว่ามีการระบุแบบอักษรที่จำเป็นทั้งหมดเมื่อใช้ fontist install , fontist manifest-install (และตัวอักษรอินเตอร์เฟสทับทิมที่สอดคล้องกันของพวกเขา Font.install และ Manifest::Install ) หรือใช้ตัวเลือก -F, --formula

เริ่มต้นจาก v1.16 ฟอนต์ติดตั้งเฉพาะฟอนต์ที่ร้องขอแทนสูตรทั้งหมดเว้นแต่จะระบุอย่างชัดเจน เปลี่ยนตอนนี้

ตัวอย่างเช่นคำขอการติดตั้งสำหรับตัวอักษร“ Arial” ก่อน V1.16 จะตั้งค่าตัวอักษรทั้งหมดที่พบในสูตร“ MS_TRUETYPE”:“ Arial”,“ Trebuchet MS”,“ Verdana” และ“ Times New Roman”

จาก v1.16 เป็นต้นไปฟอนต์จะติดตั้ง เฉพาะ ฟอนต์“ Arial” ที่ร้องขอ

ในการติดตั้งฟอนต์ทั้งหมดจากสูตรตัวเลือก -F, --formula สามารถใช้งานได้: 

$ fontist install --formula ms_truetype

การบำรุงรักษา (สำหรับผู้ดูแลฟอนต์เท่านั้น!)

คำเตือน
 ส่วนนี้มีไว้สำหรับผู้ดูแลฟอนต์เท่านั้น

การกำหนดเวอร์ชันสูตร

ในการเพิ่มแอตทริบิวต์ใหม่ให้เปลี่ยนวิธีการปฏิบัติหรือแทนที่โครงสร้างอย่างสมบูรณ์มี 2 วิธีในการเปลี่ยนรูปแบบสูตร:

  1. ใช้แอตทริบิวต์ min_fontist ในสูตร มันตั้งค่าข้อกำหนดสำหรับฟอนต์ในการติดตั้งสูตรเฉพาะในกรณีที่เวอร์ชันเท่ากันหรือมากกว่าเวอร์ชันที่ระบุ

  2. ใช้สาขาใหม่ในสูตร repo เช่น "v2", "v3", "v4" ฯลฯ หลังจากสร้างสาขาใหม่ควรกำหนดใน Fontist.formulas_version

บันทึก
 การใช้สาขาใหม่จะทำให้ผู้ใช้ทั้งหมดต้องทำการโหลดสูตร repo ทั้งหมดอีกครั้ง เนื่องจากวิธีนี้มีค่าใช้จ่ายที่สำคัญควรใช้หนึ่ง ( min_fontist ) ก่อนหน้านี้ทุกครั้งที่ทำได้

การนำเข้าสูตรจาก Google Fonts แบบไดนามิกแบบไดนามิก

Google Fonts จัดให้มีการรวบรวมแบบอักษรที่ใช้กันอย่างแพร่หลายและได้รับใบอนุญาตอย่างกว้างขวางมากที่สุด

ห้องสมุดสูตรของ Fontist รวมถึงการสนับสนุนสำหรับแบบอักษรที่ได้รับอนุญาตอย่างเปิดเผยทั้งหมดผ่าน Google Fonts และรักษาสูตรฟอนต์สำหรับแบบอักษรทั้งหมด

เวิร์กโฟลว์ GHA ตรวจสอบแบบอักษรที่อัปเดตบน Google Fonts Daily ในกรณีที่พบการอัปเดตมันจะถูกเพิ่มเข้าไปในเวิร์กโฟลว์

นำเข้าสูตรการนำเข้าแบบไดนามิกจาก SIL

SIL International เป็นองค์กรที่ไม่แสวงหาผลกำไรที่ได้รับการยอมรับในระดับสากลซึ่งให้บริการชุมชนภาษาทั่วโลก

SIL จัดหาฟอนต์ที่ไม่ซ้ำกันจำนวนหนึ่งที่รองรับชุมชนภาษาขนาดเล็กที่มีรหัส Unicode มักจะไม่ได้รับการสนับสนุนโดยแบบอักษรกระแสหลัก

Fontist มีจุดมุ่งหมายเพื่อรองรับแบบอักษร SIL ทั้งหมดและจัดเตรียมสูตรของพวกเขาในที่เก็บสูตรฟอนโตรเจนเริ่มต้น

สามารถอัปเดตด้วย: 

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

การนำเข้าสูตรจาก macOS แบบไดนามิกแบบไดนามิก

MacOS ให้แบบอักษรที่สามารถดาวน์โหลดได้ด้วยตนเองด้วย Font Book.app

เพื่ออัปเดตสูตร MacOS: 

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

การพัฒนา

การตั้งค่า

โคลนที่เก็บ 

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

ตั้งค่าสภาพแวดล้อมของคุณ 

bin/setup

เรียกใช้ชุดทดสอบ 

bin/rspec

ที่เก็บสูตร

สูตรฟอนต์อย่างเป็นทางการทั้งหมดจะถูกเก็บไว้ในที่เก็บสูตร

หากคุณต้องการเพิ่มที่เก็บสูตรใหม่หรือเปลี่ยนการตั้งค่าสำหรับชุดที่มีอยู่โปรดดูเอกสารประกอบ

การปล่อย

การปล่อยจะทำโดยอัตโนมัติด้วยการกระทำของ GitHub เพียงแค่ชนและติดแท็กด้วย gem-release

สำหรับการเปิดตัวแพทช์ (0.0.x): 

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

สำหรับการเปิดตัวเล็กน้อย (0.x.0): 

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

การบริจาค

ก่อนอื่นขอขอบคุณสำหรับการบริจาค! เรารักการดึงคำขอจากทุกคน โดยการเข้าร่วมในโครงการนี้คุณจะให้สิทธิ์ในการให้หรือโอนใบอนุญาตที่ไม่ จำกัด เฉพาะหรือใบอนุญาตย่อยไปยังบุคคลที่สามภายใต้ลิขสิทธิ์ที่ครอบคลุมการบริจาคเพื่อใช้การบริจาคโดยวิธีการทั้งหมด

เรากำลังปฏิบัติตามกฎของ Sandi Metz สำหรับอัญมณีนี้คุณสามารถอ่านคำอธิบายของกฎได้ที่นี่ รหัสใหม่ทั้งหมดควรปฏิบัติตามกฎเหล่านี้ หากคุณทำการเปลี่ยนแปลงในไฟล์ที่มีอยู่ก่อนซึ่งละเมิดกฎเหล่านี้คุณควรแก้ไขการละเมิดซึ่งเป็นส่วนหนึ่งของการบริจาคของคุณ

นี่คือแนวทางทางเทคนิคบางประการที่ต้องปฏิบัติตาม:

  1. เปิดปัญหาเพื่อหารือเกี่ยวกับคุณสมบัติใหม่

  2. เขียนการทดสอบเพื่อรองรับคุณสมบัติใหม่ของคุณ

  3. ตรวจสอบให้แน่ใจว่าชุดทดสอบทั้งหมดผ่านในท้องถิ่นและใน CI

  4. เปิดคำขอดึง

  5. สควอชการกระทำของคุณหลังจากได้รับคำติชม

  6. งานสังสรรค์!

เครดิต

อัญมณีนี้ได้รับการพัฒนาดูแลและได้รับการสนับสนุนจาก ribose

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด