Skip to main content

Fontaine font tool

Project description

pyfontaine analyses fonts for their language and character set support.

It has a straightforward pythonic character set definition format (simple example, medium example, complex example)

To add new definitions, just add files to the internals directory - they are autodetected!

It also downloads additional definitions from the Extensis, font-config and Unicode websites.

Installation

Install the latest release easily with the pip installer:

sudo pip install fontaine

To install the latest development version:

git clone https://github.com/davelab6/pyfontaine.git;
cd pyfontaine;
sudo python setup.py install;

Usage

Given a font, it returns a report with some general metadata and th language support analysis:

sh pyfontaine font.ttf;

Given a unicode character value, it returns a list of character sets that include that character.:

pyfontaine 0x0061;

To output font reports in various formats:

pyfontaine --xml font.ttf;
pyfontaine --json font.ttf;
pyfontaine --csv font.ttf;
pyfontaine --wiki font.ttf;

The –wiki format produces a MediaWiki table (example <https://en.wikipedia.org/wiki/DejaVu_fonts#Unicode_coverage>__)

To only show character sets from different collections:

pyfontaine --collections all font.ttf; # default
pyfontaine --collections pyfontaine font.ttf;
pyfontaine --collections uniblocks font.ttf;
pyfontaine --collections extensis font.ttf;
pyfontaine --collections fontconfig font.ttf;
pyfontaine --collections cldr font.ttf;
pyfontaine --collections subsets font.ttf;

To only show specific character sets:

pyfontaine --set African,'Basic Latin','GWF vietnamese' font.ttf;

To print a list of all the missing unicode values from each set:

pyfontaine --missing font.ttf;

To output visualisations of the coverage using Hilbert curves (thanks for the idea, Øyvind ‘pippin’ Kolås!): sh pyfontaine --coverage font.ttf; ls -l coverage_pngs/; (The PNG files are stored in a new directory, coverage_pngs, under the current directory.)

Update collection data

You can update all related text and xml data for collections in realtime with argument –update-data. Note. –update-data requires internet connections.

python –update-data font.ttf

Python Module

It has a python module. Here is an example script from the Font Bakery project.

Contributing

Your contributions under the GPLv3 are welcome!

pyfontaine is a python reimplementation of Fontaine by Ed Trager, and has been made by by Vitaly Volkov, Dave Crossland and Mikhail Kashkin.

Thanks

We would like to thank some upstream projects that make pyfontaine even more useful: * Thomas Phinney for the WebINK Character Sets * Behdad Esfabod for the font-config languages definitions * Unicode Consortium for the Unicode Blocks

Dependencies

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fontaine-1.3.0.tar.gz (3.4 MB view details)

Uploaded Source

File details

Details for the file fontaine-1.3.0.tar.gz.

File metadata

  • Download URL: fontaine-1.3.0.tar.gz
  • Upload date:
  • Size: 3.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for fontaine-1.3.0.tar.gz
Algorithm Hash digest
SHA256 051b02515a2bc6b270f4ef50296be7e044d899e0ea26c030c584978af3b53d6b
MD5 46e6a93af70a49f4d060ec0309ea452c
BLAKE2b-256 c323d28ca58365862dfd9cdd0b555fabe50dad5d9c9a064be9757c54783a5c20

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page