fontpm

FontPM: el administrador de paquetes de fuentes

FontPM es una utilidad de línea de comandos de paquetes administradores que le permite instalar fuentes rápidamente, similar a cuántos administradores de paquetes le permiten instalar paquetes.

Notas

• FontPM es bastante rudimentario en su conjunto de características. Si desea ver las características agregadas, abra un problema.

• En este momento, solo admite descargar fuentes no variables de Google Fonts. Si encuentra otras fuentes que cree que FontPM debería tener, ¡abra un problema en el repositorio!

Instalación

Paso 1: Instale FontPM

Cargo (la forma recomendada)

FontPM se puede instalar a través de la carga simplemente ejecutando cargo install fontpm . Esta es la forma recomendada de hacer las cosas.

Construyendo e instalando desde la fuente (la forma ligeramente más compleja)

FontPM también se puede instalar construyéndolo desde la fuente. Por el momento, no hay una rama estable, por lo que solo tendrá que averiguar de qué compromiso desea construir. No se hacen garantías sobre la estabilidad de la rama de desarrollo.

El primer paso es clonar el repositorio usando Git: git clone https://github.com/tecc/fontpm.git . Una vez hecho esto, puede instalar FONTPM ejecutando cargo install --path <path-to-fontpm>/cli (donde <path-to-fontpm> es el directorio de FontPM en el que se cerró).

Un guión completo para construir e instalar desde la fuente se parece a esto:

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

Paso 2: Actualice el índice de fuente

Lo primero que debe hacer antes de usar FontPM es actualizar el índice de fuentes local. Puede hacer esto usando fontpm refresh .

Uso

Actualizar el índice de fuente local

FontPM descarga índices de fuentes disponibles para cada fuente, pero no lo hace automáticamente por usted. Para refrescar

fontpm refresh

Instalación de fuentes

A tu máquina

ADVERTENCIA

La instalación de fuentes a nivel mundial puede no funcionar en todas las plataformas. Debería funcionar con cualquier sistema Linux que compleja el directorio base XDG, pero más allá de eso no se ha probado.

Para instalar una fuente en su máquina, simplemente ejecute el siguiente comando:

fontpm install < font-id... >

Sustituya <font-id> con cualquier fuente que desee instalar. Esto suele estar en kebab-case , por lo que si desea instalar Noto Sans, escribiría noto-sans .

Para instalar múltiples fuentes, simplemente enumere los ID de fuente separados por espacios.

A un directorio (por ejemplo, para un proyecto)

La instalación de fuentes en un directorio específico se realiza de manera similar a instalarlas a nivel mundial. Simplemente ejecute el siguiente comando, sustituyendo <font-id> por las fuentes que desee usar y <directory> por cualquier directorio que desee instalar la fuente

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

Además, puede especificar cómo le gustaría que FontPM organice los archivos utilizando el indicador -f (o --format ). Solo admite 2 modos a partir de ahora: flat-directory flat y plano.

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

Si usa flat , los archivos se verán un poco así:

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

flat-directory los separa en directorios basados en el ID de fuente, lo que significa que se parece un poco a este:

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

Purring de datos de FontPM

ADVERTENCIA

Este comando tiene la capacidad de eliminar todos los archivos FontPM irrevocablemente. Asegúrese de lo que está haciendo.

En algunos casos, puede decidir que desea purgar archivos creados por FontPM (tal vez para guardar espacio de almacenamiento en su dispositivo). Esto se puede hacer usando el comando purge :

fontpm purge < target >

El argumento target especifica lo que desea eliminar. Actualmente permite tres valores: cache (que se dirige a los archivos almacenados en caché que usa FontPM), fonts (o installed-fonts , que se dirige a todas las fuentes instaladas) y all (que se dirige a ambos objetivos anteriores).

Configuración

Ubicación

La configuración de FontPM ( config.toml ) reside en un directorio específico de la plataforma:

• En Linux estará en $XDG_CONFIG_HOME/fontpm que normalmente es (y predeterminado a si $XDG_CONFIG_HOME no está configurado) $HOME/.config/fontpm (ejemplo: /home/alice/.config/fontpm )
• En Windows estará en el directorio Roaming AppData (ejemplo: C:UsersAliceAppDataRoaming ).
• En Mac será $HOME/Library/Application Support (ejemplo: /Users/Alice/Library/Application Support ).

Explicación

[ 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 " 

Licencia

FontPM tiene licencia bajo la licencia Apache 2.0. Puede encontrar el texto en la licencia.

 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.