web fonts repository

Repositorio de fuentes web

Un simple alojamiento de información web inspirada en Google Fonts. Se ejecuta en su servidor, almacena y distribuye archivos web y genera CSS sobre la marcha para integrar las fuentes en las páginas web.

Comienzo rápido

Requisitos

1. Servidor HTTP que admite PHP ≥ 7.0
2. Compositor (requerido para la instalación)

Instalación

1. Descargue el código fuente

Ejecute el siguiente código en la consola:

composer create-project finesse/web-fonts-repository webfonts

Donde webfonts es una ruta a un directorio donde se debe instalar el repositorio.

O puedes hacer algunas cosas manualmente:

1. Descargue el código fuente de GitHub y extraiga.
2. Abra un terminal y vaya a la raíz del código fuente.
3. Instale las bibliotecas ejecutándose en la terminal:

   composer install

4. Prepare el repositorio ejecutándose en la terminal:

   composer run-script post-create-project-cmd

2. Permisos de archivo

Proporcione el nombre del usuario que el servidor web ejecuta permisos para escribir dentro del directorio logs .

Puedes ejecutar esto en la consola:

 # Don't do it in production!
chmod 777 logs

3. Servidor web

Haga que el Directorio public sea la raíz del documento del servidor web. O simplemente abra http: // localhost/public si instaló el repositorio en la raíz del servidor web.

Haga que todas las solicitudes a los archivos no existentes sean manejados por public/index.php . Si su servidor es Apache, ya está hecho.

Haga que el servidor agregue el Access-Control-Allow-Origin: * http-header a los archivos de fuentes. De lo contrario, algunos navegadores rechazarán el uso de fuentes del repositorio.

• Apache: Todo lo que necesita hacer es asegurarse de que el módulo mod_header.c esté activado (ejecute el comando a2enmod headers y reinicie el servidor para encenderlo).
• Nginx: usa esta instrucción.

Configuración

Coloque sus archivos de fuentes (Woff, Woff2, TTF, OTF, EOT, SVG) en el directorio public/fonts . Puede separarlos por subdirectorios. Puede convertir los archivos WebFont usando Transfonter.

Todas las configuraciones van al archivo config/settings-local.php . Si no lo tiene, cópielo desde el archivo config/settings-local.php.example .

Parámetros:

displayErrorDetails

Si los detalles de errores deben enviarse al navegador. De todos modos, los errores se escriben en los logs/app.log . Debe apagarlo en el servidor de producción.

logger / level

Cuántos mensajes deben registrarse al archivo. El valor es una de las constantes PsrLogLogLevel . Puede leer más sobre los niveles de registro aquí.

fonts

La lista de fuentes disponibles en el repositorio. Ejemplo simple:

 return [
    // ...
    ' fonts ' => [
        ' Open Sans ' => [
            ' styles ' => [
                ' 300 ' => ' OpenSans/opensans-light.* ' ,
                ' 300i ' => ' OpenSans/opensans-light-italic.* ' ,
                ' 400 ' => ' OpenSans/opensans-regular.* ' ,
                ' 400i ' => ' OpenSans/opensans-regular-italic.* ' ,
            ]
        ],
        ' Roboto ' => [
            ' styles ' => [
                ' 300 ' => ' Roboto/roboto-light.* ' ,
                ' 400 ' => ' Roboto/roboto-regular.* ' ,
                ' 500 ' => ' Roboto/roboto-medium.* ' ,
                ' 700 ' => ' Roboto/roboto-bold.* ' ,
            ]
        ]
    ]
];

Las teclas de matriz fonts son los nombres de las familias de fuentes. Las teclas de matrices styles son los nombres de los estilos. Los números en los nombres de estilo son los pesos de fuentes, i la cursiva.

Las rutas de archivo de fuentes se dan en relación con el directorio public/fonts . Las rutas de archivo son los patrones de búsqueda del globo. Significa que el repositorio debe considerar todos los archivos que coincidan con el patrón como archivos de fuentes.

Puede encontrar más ejemplos y posibilidades aquí.

Uso

Agregue una etiqueta <link> al código HTML de la página en la que desea incrustar una fuente:

 < link rel =" stylesheet " href =" http://web-fonts-repository.local/css?family=Open+Sans:400,400i,700,700i|Roboto:300,400 " />

Donde http://web-fonts-repository.local Repository.local es la URL raíz de un repositorio de fuentes web instaladas.

Las fuentes requeridas se especifican de la misma manera que en Google Fonts. Las familias de fuentes están divididas por | , los estilos de familias se dividen por , el apellido está separado de la lista de estilos usando : .

Puede omitir la lista de estilos. En este caso se usa el estilo regular ( 400 ).

 < link rel =" stylesheet " href =" http://web-fonts-repository.local/css?family=Open+Sans " />

Puede especificar un valor para la propiedad de estilo de pantalla de fuente utilizando el parámetro display . Ejemplo:

 < link rel =" stylesheet " href =" http://web-fonts-repository.local/css?family=Open+Sans&display=swap " />

Luego incruste una fuente en un código CSS:

 body {
    font-family : 'Open Sans' , sans-serif;
}

Compatibilidad de versiones

El proyecto sigue el versión semántica.

Significa que las versiones de parche son completamente compatibles (es decir, 1.2.1 y 1.2.2), las versiones menores son compatibles con versiones anteriores (es decir, 1.2.1 y 1.3.2) y las versiones principales no son compatibles (es decir, 1.2.1 y 3.0). Las versiones previas a la liberación (0.*) son un poco diferentes: las versiones de parche son compatibles hacia atrás y las versiones menores no son compatibles.

Licencia

Mit. Consulte el archivo de licencia para obtener más detalles.