afdko
4.0.2
AFDKO คือชุดเครื่องมือสำหรับสร้างไฟล์ฟอนต์ OpenType จากข้อมูลฟอนต์ PostScript และ TrueType
พื้นที่เก็บข้อมูลนี้ประกอบด้วยไฟล์ข้อมูล สคริปต์ Python และแหล่งที่มาสำหรับโปรแกรมบรรทัดคำสั่งที่ประกอบด้วย AFDKO โครงการใช้สิทธิ์การใช้งาน Apache 2.0 Open Source โปรดทราบว่า AFDKO ใช้การขึ้นต่อกันหลายรายการ ซึ่งแสดงอยู่ในไฟล์ Requirements.txt ซึ่งจะถูกติดตั้งโดยอัตโนมัติหากคุณติดตั้ง AFDKO ด้วย pip การพึ่งพาเหล่านี้ส่วนใหญ่เป็นใบอนุญาต BSD หรือ MIT ยกเว้น tqdm ซึ่งก็คือ MPL 2.0
โปรดดูภาพรวม AFDKO สำหรับคำอธิบายโดยละเอียดเพิ่มเติมเกี่ยวกับสิ่งที่รวมอยู่ในแพ็คเกจ
โปรดดูวิกิสำหรับข้อมูลเพิ่มเติม เช่น ลิงก์ไปยังเอกสารอ้างอิงและโครงการที่เกี่ยวข้อง
พอร์ต Python ของ psautohint ถูกรวมเข้ากับที่เก็บ AFDKO ในชื่อ "otfautohint"
ดูข้อมูลเพิ่มเติมได้ใน docs/otfautohint_Notes.md
AFDKO ต้องใช้ Python 3.9 ขึ้นไป ควรใช้งานได้กับ Python > 3.9 แต่ในบางครั้งส่วนประกอบของ tool-chain และการขึ้นต่อกันไม่เป็นไปตามการเปิดตัว Python หลัก ๆ ดังนั้นอาจมีความล่าช้าบ้างในขณะที่พวกมันตามทัน
รุ่นต่างๆ มีอยู่ใน Python Package Index (PyPI) และสามารถติดตั้งได้ด้วย pip
หมายเหตุสำหรับผู้ใช้ macOS: เราขอแนะนำ ไม่ ให้คุณใช้ระบบ Python ด้วยเหตุผลอื่นๆ macOS บางเวอร์ชันมาพร้อมกับ Python 2 และ AFDKO เวอร์ชันล่าสุดใช้งานได้กับ Python 3 เท่านั้น คุณสามารถดูคำแนะนำในการใช้ Brew เพื่อติดตั้ง Python 3 บน macOS ได้ที่นี่: การติดตั้ง Python 3 บน Mac OS X นอกจากนี้ : pyenv เป็นเครื่องมือที่ยอดเยี่ยมสำหรับการติดตั้งและจัดการ Python เวอร์ชันต่างๆ บน macOS
หมายเหตุสำหรับผู้ใช้ทุกคน: เราขอแนะนำ อย่างยิ่ง ให้ใช้สภาพแวดล้อมเสมือน Python ( venv ) และการใช้ python -m pip install <package> เพื่อติดตั้งแพ็คเกจทั้งหมด (ไม่ใช่แค่ AFDKO) การเรียก pip install โดยตรงอาจส่งผลให้มีการเรียก pip ผิด และแพ็กเกจลงจอดในตำแหน่งที่ไม่ถูกต้อง การรวมกันของการใช้ venv + python -m pip install ช่วยให้มั่นใจได้ว่าแพ็คเกจที่จัดการโดย pip จะอยู่ในตำแหน่งที่ถูกต้อง
หมายเหตุสำหรับผู้ใช้ Linux (และผู้ใช้แพลตฟอร์มอื่นที่ไม่ใช่ macOS หรือ Windows): เมื่อไม่มี "วงล้อ" ที่สร้างไว้ล่วงหน้าสำหรับแพลตฟอร์มของคุณ pip จะพยายามสร้างส่วน C และ C++ ของแพ็คเกจจากแหล่งที่มา กระบวนการนี้จะสำเร็จก็ต่อเมื่อมีการติดตั้งทั้งเครื่องมือการพัฒนา C และ C++ และ libuuid ดูการสร้างจากแหล่งที่มาด้านล่าง
ตัวเลือกที่ 1 (แนะนำ)
สร้างสภาพแวดล้อมเสมือนจริง:
python -m venv afdko_envเปิดใช้งานสภาพแวดล้อมเสมือน:
macOS และลินุกซ์
source afdko_env/bin/activateหน้าต่าง
afdko_env S cripts a ctivate.batติดตั้ง afdko:
python -m pip install afdkoการติดตั้ง afdko ภายในสภาพแวดล้อมเสมือนจะป้องกันความขัดแย้งระหว่างการขึ้นต่อกันกับโมดูลอื่นๆ ที่ติดตั้งทั่วโลก
ตัวเลือกที่ 2 (ไม่แนะนำเว้นแต่จะมีความขัดแย้งระดับโลก)
การติดตั้งผู้ใช้ท้องถิ่น afdko (ข้อมูล):
python -m pip install --user afdko
ใช้ตัวเลือก -U (หรือ --upgrade ) เพื่ออัปเดต afdko (และการขึ้นต่อกัน) ให้เป็นเวอร์ชันเสถียรใหม่ล่าสุด:
python -m pip install -U afdko
หากต้องการรับเวอร์ชันก่อนเผยแพร่และอยู่ระหว่างการพัฒนา ให้ใช้แฟล็ก --pre :
python -m pip install -U afdko --pre
หากต้องการลบแพ็คเกจ afdko ให้ใช้คำสั่ง:
python -m pip uninstall afdko
ก่อนอื่นคุณต้องติดตั้งเครื่องมือการพัฒนาสำหรับแพลตฟอร์มของคุณ
บน macOS ให้ติดตั้งสิ่งเหล่านี้ด้วย:
xcode-select --install
บน Linux (Ubuntu 17.10 LTS หรือใหม่กว่า) ให้ติดตั้งสิ่งเหล่านี้ด้วย:
apt-get -y install python3.9
apt-get -y install python-pip
apt-get -y install python-dev
apt-get -y install uuid-dev
บนระบบปฏิบัติการที่คล้ายกับ POSIX อื่นๆ libuuid และไฟล์ส่วนหัวอาจอยู่ในแพ็คเกจชื่อ libuuid-devel หรือ util-linux-libs ซอร์สโค้ดสำหรับ libuuid ถูกเก็บรักษาไว้ในที่เก็บ util-linux
บน Windows คุณต้องมี Visual Studio 2017 หรือใหม่กว่า
หากต้องการสร้าง afdko จากแหล่งที่มา ให้โคลนพื้นที่เก็บข้อมูล afdko GitHub ตรวจสอบให้แน่ใจว่าได้ติดตั้งโมดูล wheel แล้ว ( python -m pip install wheel ) จากนั้น cd ไปที่ไดเร็กทอรีระดับบนสุดของ afdko และรัน:
python -m pip install .
หากคุณต้องการพัฒนาและแก้ไขข้อบกพร่อง AFDKO โดยใช้ Xcode ให้เรียกใช้:
CMake -G Xcode .
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการสร้างจากแหล่งที่มา โปรดดูที่ docs/FDK_Build_Notes.md
บันทึก
เป็นไปไม่ได้ที่จะติดตั้ง afdko ในโหมดแก้ไข/พัฒนาโดยใช้ python -m pip install -e . - เนื่องจากชุดเครื่องมือประกอบด้วยไฟล์ปฏิบัติการไบนารี C ซึ่ง setup.py พยายามติดตั้งในโฟลเดอร์ bin/ (หรือ Scripts/) อย่างไรก็ตาม กระบวนการนี้มีไว้เพื่อใช้กับสคริปต์แบบข้อความเท่านั้น (ไม่ว่าจะเขียนด้วย Python หรือการเขียนสคริปต์เชลล์ ภาษา). หากต้องการแก้ไขปัญหานี้ (ซึ่งจริงๆ แล้วกระทบต่อนักพัฒนา afdko หลักเพียงไม่กี่รายที่ต้องการรับคำติชมทันทีเมื่อพวกเขาแก้ไขไฟล์ต้นฉบับ) คุณสามารถใช้วิธีอื่น เช่น ส่งออก PYTHONPATH โดยใช้ไฟล์ .pth หรือแฮ็กที่คล้ายกัน สำหรับรายละเอียดเพิ่มเติม อ่านความคิดเห็นนี้
AFDKO ได้รับการปรับโครงสร้างใหม่เพื่อให้สามารถติดตั้งเป็นแพ็คเกจ Python ได้ ตอนนี้ขึ้นอยู่กับล่าม Python ของผู้ใช้ และไม่มีล่าม Python ของตัวเองอีกต่อไป
สองโปรแกรม IS และ Checkoutlines ถูกยกเลิกเนื่องจากซอร์สโค้ดไม่สามารถเป็นโอเพ่นซอร์สได้ เครื่องมือเหล่านี้มีให้ใช้งานในเวอร์ชัน 2.5.65322 และเก่ากว่า
บันทึก
หากคุณติดตั้ง AFDKO เก่ารวมถึงแพ็คเกจ PyPI afdko ใหม่ เครื่องมือจากเวอร์ชันที่ใหม่กว่าจะมีความสำคัญมากกว่ารุ่นเก่า สิ่งนี้เกิดขึ้นเนื่องจาก pip เพิ่มพาธแพ็กเกจของ afdko ที่จุดเริ่มต้นของตัวแปรสภาพแวดล้อม PATH ของระบบ ในขณะที่ตัวติดตั้งเก่าจะเพิ่มที่ส่วนท้าย การแก้ไข PATH นี้ไม่ได้ถูกยกเลิกโดยโปรแกรมถอนการติดตั้ง หากคุณต้องการลบเส้นทางไปยังเวอร์ชันที่ใหม่กว่าโดยสิ้นเชิง คุณจะต้องแก้ไข PATH สำหรับ Mac นี่หมายถึงการแก้ไขบรรทัดในไฟล์ล็อกอินของคุณที่ตั้งค่าตัวแปร PATH บน Windows หมายถึงการแก้ไขตัวแปรสภาพแวดล้อม PATH ในแผงควบคุมของระบบ
