fontship

Tentang fontship

Fontship adalah toolkit untuk menghasilkan font dan perkakas untuk alur kerja kolaboratif.

Dikembangkan di League of Movable Type dengan kebutuhan proyek font open-source dalam pikiran, fontship mengotomatiskan proses mengubah sumber desain Anda menjadi file font siap produksi dan menggabungkannya untuk penerbitan. Ya, Anda bisa mengambil semua langkah yang sama secara manual. Ya, Anda bisa menulis skrip Anda sendiri untuk menyelesaikan pekerjaan yang sama. Apa yang dibawa Fontship ke meja adalah bundel lengkap dari semua alat yang Anda butuhkan untuk berkumpul dengan sebagian besar bit yang sudah terhubung.

Satu font bangunan dari sumber sepenuhnya otomatis, build otomatis dari CI dan rilis penerbitan hanya merupakan langkah kecil. Sebagai bonus tambahan, semuanya diatur dengan cermat untuk membuat kolaborasi jarak jauh asinkron melalui sistem kontrol versi (seperti GIT) semudah mungkin. Desainer bahkan tidak perlu menggunakan alat desain yang sama!

Hampir setiap aspek dari langkah-langkah pembuatan dan alur kerja dapat diubah secara per proyek, tetapi pengaturan di luar kotak harus bekerja untuk membangun sebagian besar proyek font.

Pengaturan

Fontship dapat digunakan dalam salah satu dari tiga cara berbeda:

1. Jarak jauh melalui pelari CI yang menanggapi acara di repositori git jarak jauh.
2. Secara lokal melalui gambar Docker semua-inklusif untuk pengaturan kerumitan rendah.
3. Secara lokal melalui pemasangan utilitas sistem reguler (asalkan semua dependensi yang diperlukan juga diinstal).

CATATAN: Metode keempat yang didukung melalui V0.5.0, dimasukkannya langsung file aturan fontship ke dalam Makefile yang ada di proyek Anda, telah ditinggalkan. Bergantung pada proyek Anda, penggunaan seperti itu mungkin atau mungkin tidak terus berfungsi dengan keterbatasan untuk saat ini, tetapi fitur -fitur baru yang ditambahkan ke CLI akan diasumsikan dalam aturan ke depan.

Pengaturan CI

Bangun font Anda tanpa memasang atau menjalankan apa pun secara lokal! Cukup dorong sumber Anda ke repositori git jarak jauh dan biarkan fontship melakukan sisanya.

Untuk digunakan dengan tindakan github, tambahkan file konfigurasi ke repositori Anda seperti .github/workflows/fontship.yml :

 name : Fontship
on : [push, pull_request]
jobs :
  fontship :
    runs-on : ubuntu-latest
    name : Fontship
    steps :
      - name : Checkout
        uses : actions/checkout@v2
        with :
          fetch-depth : 0
      - name : Fetch tags
        run : git fetch --prune --tags
      - name : Fontship
        uses : theleagueof/fontship@latest

Pada saat ini Fontship hanya membangun font ke dalam direktori proyek saat ini, itu tidak menerbitkannya di mana pun. Anda harus memposting artefak yang dihasilkan dengan (misalnya dengan menempelkannya pada setiap CI menjalankan atau menerbitkannya pada rilis) sebagai langkah lain alur kerja proyek Anda. Untuk contoh kerja penuh, lihat alur kerja Liga Spartan atau Libertinus.

Pelari CI lainnya dapat dengan mudah didukung, lihat masalah #32 untuk detail atau untuk meminta konfigurasi sampel untuk favorit Anda.

Pengaturan Docker

Gambar Docker Prebuilt tersedia dari Docker Hub, Paket GitHub, atau Anda dapat membangunnya sendiri.

Cara termudah untuk membuat wadah Docker dengan semua argumen yang tepat adalah dengan mengatur alias (yang dapat ditambahkan ke file RC shell Anda untuk bertahan):

Menggunakan Docker Hub sebagai contoh, alias bisa:

$ alias fontship= ' docker run -it --volume "$(pwd):/data" --user "$(id -u):$(id -g)" theleagueof/fontship:latest '

Docker akan secara otomatis menarik wadah yang dibutuhkan untuk menjalankan ini saat pertama kali Anda menggunakannya, setelah itu hanya akan menggunakan cache wadah lokal. Untuk melompat mulai unduhan tanpa menjalankan fontship atau untuk memperbarui cache Anda secara manual nanti (misalnya ketika terbaru diperbarui ke rilis baru) Gunakan docker pull theleagueof/fontship:latest .

Anda dapat mengganti terbaru (yang akan selalu menjadi tag versi yang paling baru dirilis) dengan Master untuk menggunakan build yang belum dirilis segar, dengan nama tag seperti V0.3.2 untuk secara eksplisit menggunakan versi tertentu, atau dengan kepala untuk menggunakan gambar yang dibangun secara lokal.

Untuk membangun gambar Docker secara lokal, Anda ingin mengkloning repositori ini dan menjalankan ./bootstrap.sh atau mengunduh dan mengekstrak sumber dari rilis, lalu jalankan:

$ ./configure
$ make docker

Pengaturan Sistem

Jika Anda menggunakan Arch Linux, Anda dapat menginstal paket AUR ini (prebuilt di repositori ini).

Jika tidak, untuk menginstal dan menggunakan secara lokal dari sumber, Anda memerlukan beberapa dependensi:

• Git,
• GNU Core Utilities Plus diffutils , bsdtar , entr , zsh ,
• GNU make (4.2+) dengan alat autoconf yang sesuai,
• Modul Python 3 Plus Plus, lihat file persyaratan.txt ,
• Alat karat termasuk cargo dan rustc untuk membangun CLI,
• Dan beberapa utilitas CLI terkait font lainnya, yaitu: sfnt2woff-zopfli , psautohint , ttfautohint , dan woff2_compress .

Untuk menginstal perangkat lunak ke komputer Anda, klon repositori ini dan jalankan ./bootstrap.sh atau unduh dan ekstrak rilis terbaru, lalu jalankan:

$ ./configure
$ make
$ sudo make install

Penggunaan

Bangunan

Untuk membangun semua format yang mungkin untuk proyek font Anda, jalankan

$ fontship make all

Untuk hanya menghasilkan format tertentu, coba:

# Just static OTF fonts
$ fontship make otf

# All static formats
$ fontship make static

# All variable formats
$ fontship make variable

# Just variable TTF format
$ fontship make variable-ttf

Jika Anda hanya tertarik pada satu file tertentu (katakanlah, instance bobot statis), Anda dapat menentukan nama file yang tepat yang Anda harapkan untuk mendapatkan pembangunan kembali tercepat dari hanya file itu:

$ fontship make FooBar-Black.otf

Penerbitan

Ketika semuanya siap atau Anda ingin benar -benar mengirimkan font (atau mengirim sampel ke teman), Anda ingin membangun paket distribusi:

$ fontship make dist

Versi

Pengaturan versi font di semua font yang dihasilkan ditentukan oleh tag pada repositori git. Tag versi harus sesuai dengan format MAJOR.MINOR yang dijelaskan oleh OpenFV.