fontpm

FONTPM: менеджер пакетов шрифтов

FONTPM-это утилита командной строки, похожая на диспетчер пакетов, которая позволяет быстро устанавливать шрифты, аналогично тому, сколько менеджеров пакетов позволяет устанавливать пакеты.

ПРИМЕЧАНИЯ

• FONTPM довольно рудиментарный в своем наборе функций. Если вы хотите увидеть добавленные функции, откройте проблему.

• Прямо сейчас он поддерживает только загрузку невыгодных шрифтов с шрифтов Google. Если вы найдете какие -либо другие источники, которые, по вашему мнению, должны иметь FONTPM, откройте проблему в репозитории!

Установка

Шаг 1: Установите FONTPM

Груз (рекомендуемый способ)

FONTPM может быть установлен через груз, просто запустив cargo install fontpm . Это рекомендуемый способ ведения дел.

Строительство и установка из источника (немного более сложный путь)

FONTPM также может быть установлен путем создания его из Source. На данный момент нет стабильной ветви, поэтому вам просто нужно выяснить, из какого коммита вы хотите построить. Никаких гарантий не делается о стабильности филиала Dev.

Первым шагом является клонирование репозитория, используя GIT: git clone https://github.com/tecc/fontpm.git . После того, как это сделано, вы можете установить FONTPM, выполнив cargo install --path <path-to-fontpm>/cli (где <path-to-fontpm> -это то, что FONTPM был закрыт).

Полный сценарий для строительства и установки из источника выглядит примерно так:

git clone https://github.com/tecc/fontpm.git
cd fontpm
cargo install --path ./cli 

Шаг 2: Обновить индекс шрифта

Первое, что вам нужно сделать, прежде чем использовать FONTPM, это освежает локальный индекс шрифта. Вы можете сделать это, используя fontpm refresh .

Использование

Освежающий локальный индекс шрифта

FONTPM Загружает индексы доступных шрифтов для каждого источника, но он не делает это автоматически для вас. Чтобы освежить

fontpm refresh

Установка шрифтов

На вашу машину

ПРЕДУПРЕЖДЕНИЕ

Установка шрифтов в мире может не работать на всех платформах. Он должен работать с любой системой Linux, совместимой с базовым каталогом XDG, но помимо этого не проверена.

Чтобы установить шрифт на вашу машину, просто запустите следующую команду:

fontpm install < font-id... >

Замените <font-id> любым шрифтом, который вы хотите установить. Обычно это находится в kebab-case , поэтому, если вы хотите установить Noto Sans, вы бы написали noto-sans .

Чтобы установить несколько шрифтов, просто перечислите идентификаторы шрифтов, разделенные пространствами.

В каталог (например, для проекта)

Установка шрифтов в конкретный каталог выполняется аналогично установке их по всему миру. Просто запустите следующую команду, заменив <font-id> на любые шрифты, которые вы хотите использовать, и <directory> для любого каталога, который вы хотите установить шрифт

fontpm install -d < directory > < font-id... >

Кроме того, вы можете указать , как вы хотели бы, чтобы FONTPM организовал файлы, используя флаг -f (или --format ). На данный момент он поддерживает только 2 режима - flat и flat-directory .

fontpm install -d < directory > -f < format > < font-id... >

Если вы используете flat , файлы будут выглядеть немного похоже на это:

 <directory>
|_ font1-italic.ttf
|_ font1-regular.ttf
|_ font2-italic.ttf
|_ font2-regular.ttf

flat-directory разделяет их на каталоги на основе идентификатора шрифта, что означает, что он выглядит немного похоже на это:

 <directory>
|_ font1
|  |_ italic.ttf
|  |_ regular.ttf
|_ font2
|  |_ italic.ttf
|  |_ regular.ttf 

Очистка данных FONTPM

ПРЕДУПРЕЖДЕНИЕ

Эта команда имеет возможность безвозвратно удалять все файлы FONTPM. Будьте уверены в том, что вы делаете.

В некоторых случаях вы можете решить, что хотите очистить файлы, созданные FONTPM (возможно, чтобы сохранить место для хранения на вашем устройстве). Это можно сделать с помощью команды purge :

fontpm purge < target >

target аргумент указывает, что вы хотите удалить. В настоящее время он допускает три значения: cache (который нацелен на кэшированные файлы, которые использует FONTPM), fonts (или installed-fonts , которые нацелены на все установленные шрифты) и all (которые нацелены на обе прежние цели).

Конфигурация

Расположение

Конфигурация FONTPM ( config.toml ) находится в каталоге с конкретной платформой:

• В Linux он будет в $XDG_CONFIG_HOME/fontpm , который обычно (и по уходу за уходом, если $XDG_CONFIG_HOME не установлен) $HOME/.config/fontpm (пример: /home/alice/.config/fontpm )
• В Windows он будет в каталоге Roaming AppData (пример: C:UsersAliceAppDataRoaming ).
• На Mac он будет $HOME/Library/Application Support (пример: /Users/Alice/Library/Application Support ).

Объяснение

[ fontpm ] # The main section of the configuration
# enabled_sources: array<string>
#   A list of source IDs.
#   All the sources included in this array, FontPM will use at runtime.
enabled_sources = [ " google-fonts " ]

# cache_dir: path
#   Path to the directory where FontPM should cache files.
#   This directory will contain the local index files and all downloaded font files.
#   If this is not provided, it will create a default at runtime.
cache_dir = " ~/.cache/fontpm "

# font_install_dir: path
#   Path to the directory where installed fonts should reside.
#   If this is not provided, it will create a default at runtime.
font_install_dir = " ~/.local/share/fonts/fontpm " 

Лицензия

FONTPM лицензирован по лицензии Apache 2.0. Вы можете найти текст в лицензии.

 Copyright (c) 2023 tecc

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.