Metadata-Version: 2.0
Name: googlefonts-installer
Version: 0.2.0
Summary: Google fonts installer utility.
Home-page: https://github.com/fabianbuechler/googlefonts_installer
Author: Fabian Büchler
Author-email: fabian@buechler.io
License: All rights reserved
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Text Processing :: Fonts

======================
Google Fonts Installer
======================

Installs selected fonts from the `Google fonts directory`_ by selectively
cloning the Git repository at `github.com/google/fonts`_ and creating symlinks
in your ``~/.fonts`` directory.

**Quickstart:**

..  code:: bash

    $ pipsi install googlefonts_installer
    $ mkdir -p ~/googlefonts
    $ cd ~/googlefonts
    $ vim googlefonts.conf
    $ googlefonts-installer

.. _Google fonts directory: https://www.google.com/fonts
.. _github.com/google/fonts: https://github.com/google/fonts

Requirements
============

To use this, you'll need

*   Python 3.4+ to run this script,
*   a recent version of Git supporting sparse checkouts,
*   a Linux-based system that uses the ``~/.fonts`` directory.

Usage
=====

#.  Create a directory for the Git clone:

    ..  code:: bash

        $ mkdir -p ~/Fonts/googlefonts/
        $ cd ~/Fonts/googlefonts/

#.  Install the ``googlefonts-installer`` package from PyPi. A good way to do
    this is via `pipsi`_:

    ..  code:: bash

        $ pipsi install googlefonts_installer

    You now have the ``googlefonts-installer`` command available.

#.  List the fonts to install, or more precicely the sub-paths of the Google
    fonts Git repository to clone, in a ``googlefonts.conf`` configuration file::

        ufl/ubuntu
        ofl/firamono
        ofl/firasans

#.  Run ``googlefonts-installer``. This …

    *   Sparse-clones (only the defined paths) the Google fonts Git repository
        (if not yet done).

    *   Pulls the latest changes.

    *   Creates symlinks for each font directory to ``~/.fonts``.

.. _pipsi: https://github.com/mitsuhiko/pipsi/

Defaults
--------

The ``googlefonts-installer`` command defaults to cloning into the current
working directory and symlinking to ``~/.fonts``, the ``googlefonts.conf``
configuration file is assumed to be in the current working directory as well.

Use the ``--work-dir``, ``--fonts-dir`` and ``--config`` arguments to overwrite
this.

Hint
----

To find the sub-paths of the fonts you'd like to install, go to
https://github.com/google/fonts, hit ``t`` and start typing a font's name.

Github will list all matching file names.
For example, to install *Ubuntu Regular*, use the directory part of the file
``ufl/ubuntu/Ubuntu-Regular.ttf`` listed by Github.


Changelog
=========

0.2.0 - 2016-03-09
------------------

*   Packaging fix.

0.1.0 - 2016-03-09
------------------

*   Initial implementation.


