afdko
4.0.2
AFDKO adalah seperangkat alat untuk membuat file font OpenType dari data font PostScript dan TrueType.
Repositori ini berisi file data, skrip Python, dan sumber untuk program baris perintah yang terdiri dari AFDKO. Proyek ini menggunakan lisensi Apache 2.0 Open Source. Harap dicatat bahwa AFDKO menggunakan beberapa dependensi, yang tercantum dalam file persyaratan.txt, yang secara otomatis akan diinstal jika Anda menginstal AFDKO dengan pip . Sebagian besar dependensi ini adalah lisensi BSD atau MIT, kecuali tqdm , yaitu MPL 2.0.
Silakan merujuk ke Ikhtisar AFDKO untuk penjelasan lebih rinci tentang apa yang termasuk dalam paket.
Silakan lihat wiki untuk informasi tambahan, seperti tautan ke bahan referensi dan proyek terkait.
Port Python dari psautohint telah (kembali) diintegrasikan ke dalam repositori AFDKO sebagai "otfautohint"
Informasi lebih lanjut dapat ditemukan di docs/otfautohint_Notes.md
AFDKO memerlukan Python 3.9 atau lebih baru. Seharusnya bisa digunakan dengan Python > 3.9 apa pun, namun terkadang komponen dan dependensi rantai alat tidak bisa mengimbangi rilis utama Python, jadi mungkin ada jeda waktu saat mereka mengejar ketinggalan.
Rilis tersedia di Python Package Index (PyPI) dan dapat diinstal dengan pip.
Catatan untuk pengguna macOS: kami menyarankan Anda untuk tidak menggunakan sistem Python. Alasan lainnya adalah beberapa versi macOS dikirimkan dengan Python 2 dan versi terbaru AFDKO hanya tersedia untuk Python 3. Anda dapat menemukan petunjuk penggunaan Brew untuk menginstal Python 3 di macOS di sini: Menginstal Python 3 di Mac OS X. Juga : pyenv adalah alat hebat untuk menginstal dan mengelola beberapa versi Python di macOS.
Catatan untuk semua pengguna: kami SANGAT merekomendasikan penggunaan lingkungan virtual Python ( venv ) dan penggunaan python -m pip install <package> untuk menginstal semua paket (bukan hanya AFDKO). Memanggil pip install secara langsung dapat mengakibatkan pemanggilan pip yang salah, dan paket mendarat di lokasi yang salah. Kombinasi penggunaan venv + python -m pip install membantu memastikan bahwa paket yang dikelola pip berada di tempat yang tepat.
Catatan untuk pengguna Linux (dan pengguna platform lain selain MacOS atau Windows): Jika tidak ada "roda" bawaan untuk platform Anda, pip akan mencoba membangun bagian C dan C++ paket dari sumber. Proses ini hanya akan berhasil jika alat pengembangan C dan C++ serta libuuid diinstal. Lihat build dari sumber di bawah.
Opsi 1 (Disarankan)
Buat lingkungan virtual:
python -m venv afdko_envAktifkan lingkungan virtual:
macOS & Linux
source afdko_env/bin/activatejendela
afdko_env S cripts a ctivate.batInstal afdko:
python -m pip install afdkoMenginstal afdko di dalam lingkungan virtual mencegah konflik antara dependensinya dan modul lain yang diinstal secara global.
Opsi 2 (tidak disarankan kecuali ada konflik global)
Afdko instalasi pengguna lokal (info):
python -m pip install --user afdko
Gunakan opsi -U (atau --upgrade ) untuk memperbarui afdko (dan dependensinya) ke rilis stabil terbaru:
python -m pip install -U afdko
Untuk mendapatkan versi pra-rilis dan dalam pengembangan, gunakan tanda --pre :
python -m pip install -U afdko --pre
Untuk menghapus paket afdko gunakan perintah:
python -m pip uninstall afdko
Pertama, Anda harus menginstal alat pengembangan untuk platform Anda.
Di macOS, instal ini dengan:
xcode-select --install
Di Linux (Ubuntu 17.10 LTS atau lebih baru), instal ini dengan:
apt-get -y install python3.9
apt-get -y install python-pip
apt-get -y install python-dev
apt-get -y install uuid-dev
Pada sistem operasi mirip POSIX lainnya, libuuid dan file headernya mungkin berada dalam paket bernama libuuid-devel atau util-linux-libs . Kode sumber untuk libuuid disimpan di repositori util-linux.
Di Windows, Anda memerlukan Visual Studio 2017 atau lebih baru.
Untuk membangun afdko dari sumber, kloning repositori GitHub afdko, pastikan modul wheel diinstal ( python -m pip install wheel ), lalu cd ke direktori tingkat atas afdko, dan jalankan:
python -m pip install .
Jika Anda ingin mengembangkan & men-debug AFDKO menggunakan Xcode, jalankan:
CMake -G Xcode .
Untuk informasi lebih lanjut tentang membangun dari sumber, lihat docs/FDK_Build_Notes.md.
Catatan
Tidak mungkin menginstal afdko dalam mode edit/pengembangan menggunakan python -m pip install -e . ; ini karena toolkit ini menyertakan executable biner C yang setup.py coba instal di folder bin/ (atau Scripts/), namun proses ini hanya dimaksudkan untuk digunakan dengan skrip berbasis teks (baik ditulis dengan Python atau skrip shell bahasa). Untuk mengatasi masalah ini (yang sebenarnya hanya berdampak pada beberapa pengembang inti afdko yang perlu mendapatkan masukan langsung saat mereka memodifikasi file sumber), Anda dapat menggunakan metode alternatif seperti mengekspor PYTHONPATH, menggunakan file .pth, atau peretasan serupa. Untuk lebih jelasnya baca komentar ini.
AFDKO telah direstrukturisasi sehingga dapat diinstal sebagai paket Python. Sekarang bergantung pada juru bahasa Python pengguna, dan tidak lagi berisi juru bahasa Python sendiri.
Dua program, IS dan checkoutlines dihilangkan karena kode sumbernya tidak dapat dijadikan sumber terbuka. Alat-alat ini tersedia dalam rilis versi 2.5.65322 dan yang lebih lama.
Catatan
Jika Anda menginstal AFDKO lama dan juga paket PyPI afdko baru, alat dari versi yang lebih baru akan diutamakan daripada yang lama. Hal ini terjadi karena pip menambahkan jalur paket afdko di awal variabel lingkungan PATH sistem, sedangkan penginstal lama menambahkannya di akhir; modifikasi pada PATH ini tidak dibatalkan oleh uninstaller. Jika Anda ingin menghapus jalur ke versi yang lebih baru sepenuhnya, Anda harus mengedit PATH. Di Mac, ini berarti mengedit baris di file login Anda yang menyetel variabel PATH. Di Windows, ini berarti mengedit variabel lingkungan PATH di Panel Kontrol sistem.
