web fonts repository

Репозиторий веб -шрифтов

Простой хостинг WebFont, вдохновленный Google Fonts. Он работает на вашем сервере, хранит и распространяет файлы WebFont и генерирует CSS на ходу для встраивания шрифтов на веб-страницах.

Быстрый старт

Требования

1. HTTP -сервер, поддерживающий PHP ≥ 7,0
2. Композитор (требуется для установки)

Установка

1. Загрузите исходный код

Запустите следующий код в консоли:

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

Где webfonts - это путь к каталогу, где должен быть установлен репозиторий.

Или вы можете сделать некоторые вещи вручную:

1. Загрузите исходный код из GitHub и извлеките его.
2. Откройте терминал и перейдите в корень исходного кода.
3. Установите библиотеки, работая в терминале:

   composer install

4. Подготовьте хранилище, работая в терминале:

   composer run-script post-create-project-cmd

2. Разрешения на файл

Дайте пользователю имени, что веб -сервер запускает разрешения на запись в каталоге logs .

Вы можете просто запустить это в консоли:

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

3. Веб -сервер

Сделайте public каталог быть корнем документа из веб -сервера. Или просто откройте http: // localhost/public, если вы установили репозиторий в корень веб -сервера.

Сделайте все запросы на не существующие файлы, обрабатываемые public/index.php . Если ваш сервер Apache, это уже сделано.

Сделайте сервер Access-Control-Allow-Origin: * в файлы шрифтов в файлах шрифтов. В противном случае некоторые браузеры отклонят, используя шрифты из репозитория.

• Apache: Все, что вам нужно сделать, это убедиться, что модуль mod_header.c включен (запустите команду a2enmod headers и перезапустите сервер, чтобы включить его).
• Nginx: используйте эту инструкцию.

Настраивать

Поместите свои файлы шрифтов (WOFF, WOFF2, TTF, OTF, EOT, SVG) в каталог public/fonts . Вы можете отделить их от подкаталогов. Вы можете конвертировать файлы WebFont с помощью TransFonter.

Все настройки перейдут в файл config/settings-local.php . Если у вас его нет, скопируйте его из файла config/settings-local.php.example .

Параметры:

displayErrorDetails

Должны ли детали ошибок быть отправлены в браузер. В любом случае ошибки записываются в файлы logs/app.log . Вы должны выключить его на производственном сервере.

logger / level

Сколько сообщений должно быть зарегистрировано в файл. Значение является одной из констант PsrLogLogLevel . Вы можете прочитать больше о уровнях журнала здесь.

fonts

Список шрифтов, доступных в репозитории. Простой пример:

 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.* ' ,
            ]
        ]
    ]
];

Ключи массива fonts - это названия семей. Ключи массивов styles - это названия стилей. Цифры в названиях стилей - это шрифт, i выступаю за курсив.

Пути файла шрифта приведены относительно каталога public/fonts . Путь файла - шаблоны поиска в глобусе. Это означает, что репозиторий должен рассматривать все файлы, соответствующие шаблону как файлы шрифтов.

Вы можете найти больше примеров и возможностей здесь.

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

Добавьте тег <link> в код HTML на странице, на которой вы хотите встроить шрифт:

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

Где http://web-fonts-repository.local является корневым URL установленного репозитория веб-шрифтов.

Требуемые шрифты указаны так же, как и на шрифтах Google. Семьи шрифтов разделены на | Стили семей разделены на , фамилию отделена от списка стилей с использованием : .

Вы можете опустить список стилей. В этом случае используется обычный стиль ( 400 ).

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

Вы можете указать значение для свойства стиля Font-Display, используя параметр display . Пример:

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

Затем введите шрифт в код CSS:

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

Совместимость версий

Проект следует за семантической версией.

Это означает, что патч -версии полностью совместимы (т.е. 1.2.1 и 1.2.2), второстепенные версии обратно совместимы (т.е. 1.2.1 и 1.3.2), а основные версии не совместимы (т.е. 1.2.1 и 3.0). Предварительные версии (0.*) немного разные: патч-версии обратно совместимы, а второстепенные версии не совместимы.

Лицензия

Грань Смотрите файл лицензии для получения подробной информации.