Metadata-Version: 1.0
Name: fontaine
Version: 1.2.1
Summary: Fontaine font tool
Home-page: https://github.com/davelab6/pyfontaine
Author: Dave Crossland, Виталий Волков
Author-email: dave@lab6.com
License: GNU GPLv3
Description: `pyfontaine <http://documentup.com/davelab6/pyfontaine>`__
        ==========================================================
        
        pyfontaine analyses fonts for their language and character set support.
        
        It has a straightforward pythonic character set definition format
        (`simple
        example <https://github.com/davelab6/pyfontaine/blob/master/fontaine/charmaps/africaan.py>`__,
        `medium
        example <https://github.com/davelab6/pyfontaine/blob/master/fontaine/charmaps/armenian.py>`__,
        `complex
        example <https://github.com/davelab6/pyfontaine/blob/master/fontaine/charmaps/polish.py>`__)
        
        To add new definitions, just add files to the
        `internals <https://github.com/davelab6/pyfontaine/tree/master/fontaine/charmaps/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 <http://www.pip-installer.org>`__::
        
            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 <http://en.wikipedia.org/wiki/Hilbert_curve>`__ (thanks for the
        idea, `Øyvind 'pippin' Kolås <http://github.com/hodefoting>`__!):
        ``sh pyfontaine --coverage font.ttf; ls -l coverage_pngs/;`` (The PNG
        files are stored in a new directory, ``coverage_pngs``, under the
        current directory.)
        
        Python Module
        ~~~~~~~~~~~~~
        
        It has a python module. Here is an `example
        script <https://github.com/xen/fontbakery/blob/master/scripts/famchar.py>`__
        from the Font Bakery project.
        
        Contributing
        ------------
        
        Your contributions under `the GPLv3 <LICENSE.txt>`__ are welcome!
        
        pyfontaine is a python reimplementation of
        `Fontaine <http://fontaine.sf.net>`__ by Ed Trager, and has been made by
        by `Vitaly Volkov <http://github.com/hash3g>`__, `Dave
        Crossland <http://github.com/davelab6>`__ and `Mikhail
        Kashkin <http://github.com/xen>`__.
        
        Thanks
        ------
        
        We would like to thank some upstream projects that make pyfontaine even
        more useful: \* `Thomas Phinney <http://www.thomasphinney.com/>`__ for
        the `WebINK Character
        Sets <http://blog.webink.com/custom-font-subsetting-for-faster-websites/>`__
        \* `Behdad Esfabod <http://behdad.org>`__ for the `font-config languages
        definitions <http://cgit.freedesktop.org/fontconfig/tree/fc-lang>`__ \*
        Unicode Consortium for the `Unicode
        Blocks <http://www.unicode.org/Public/UNIDATA/Blocks.txt>`__
        
        Dependencies
        ------------
        
        -  Mac OS X requires the XCode Command Line Tools to be installed
        -  `fonttools <https://github.com/behdad/fonttools>`__ (common) *or*
           `freetype-py <http://code.google.com/p/freetype-py>`__ (fast)
        -  `lxml <http://pypi.python.org/pypi/lxml>`__
        -  `PyICU <http://pyicu.osafoundation.org/>`--
        -  `simpleHilbertCurve <https://github.com/dentearl/simpleHilbertCurve>`__
        -  `matplotlib <https://pypi.python.org/pypi/matplotlib>`__
        
        
        Related Projects
        ----------------
        
        -  `fontaine <http://fontaine.sf.net>`__
        -  `fontbakery <https://github.com/xen/fontbakery>`__
        -  `libunicodenames <https://bitbucket.org/sortsmill/libunicodenames>`__
        
        
Platform: UNKNOWN
