web fonts repository

Web -Schriftarten Repository

Ein einfaches Webfont -Hosting, das von Google Fonts inspiriert ist. Es wird auf Ihrem Server ausgeführt, speichert und verteilt WebFont-Dateien und generiert CSS für die Einbettung von Schriftarten auf Webseiten.

Schneller Start

Anforderungen

1. HTTP -Server, der PHP ≥ 7,0 unterstützt
2. Komponist (für die Installation erforderlich)

Installation

1. Laden Sie den Quellcode herunter

Führen Sie den folgenden Code in der Konsole aus:

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

Wobei webfonts ein Pfad zu einem Verzeichnis ist, in dem das Repository installiert werden soll.

Oder Sie können einige Dinge manuell machen:

1. Laden Sie den Quellcode von GitHub herunter und extrahieren Sie ihn.
2. Öffnen Sie ein Terminal und gehen Sie zum Quellcode -Root.
3. Installieren Sie die Bibliotheken, indem Sie im Terminal ausgeführt werden:

   composer install

4. Bereiten Sie das Repository vor, indem Sie im Terminal ausgeführt werden:

   composer run-script post-create-project-cmd

2. Dateiberechtigungen

Geben Sie dem Benutzer ein Namen an, mit dem der Webserver Berechtigungen ausführt, um in das logs zu schreiben.

Sie können dies einfach in der Konsole ausführen:

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

3.. Webserver

Machen Sie das Verzeichnis public zum Dokumentenrouch des Webservers. Oder öffnen Sie einfach http: // localhost/public, wenn Sie das Repository auf dem Webserver -Root installiert haben.

Machen Sie alle Anfragen nach nicht bestehenden Dateien von public/index.php . Wenn Ihr Server Apache ist, ist dies bereits erledigt.

Lassen Sie den Server die Access-Control-Allow-Origin: * HTTP-Header zu den Schriftartdateien hinzufügen. Andernfalls lehnen einige Browser mit Schriftarten aus dem Repository ab.

• Apache: Alles, was Sie tun müssen, ist sicherzustellen, dass das Modul mod_header.c eingeschaltet ist (Ausführen des Befehls a2enmod headers und starten Sie den Server neu, um ihn einzuschalten).
• Nginx: Verwenden Sie diese Anweisung.

Aufstellen

Legen Sie Ihre Schriftdateien (WOFF, WOFF2, TTF, OTF, EOT, SVG) an das Verzeichnis der public/fonts . Sie können sie durch Unterverzeichnisse trennen. Sie können WebFont -Dateien mit dem Transfonter konvertieren.

Alle Einstellungen gehen zur Dateikonfiguration config/settings-local.php . Wenn Sie es nicht haben, kopieren Sie es aus der Dateikonfiguration config/settings-local.php.example .

Parameter:

displayErrorDetails

Ob Fehler Details an den Browser gesendet werden sollten. Wie auch immer, Fehler werden in die logs/app.log geschrieben. Sie sollten es auf dem Produktionsserver ausschalten.

logger / level

Wie viele Nachrichten sollten an der Datei angemeldet werden. Der Wert ist einer der PsrLogLogLevel -Konstanten. Hier können Sie mehr über Protokollebenen lesen.

fonts

Die Liste der im Repository verfügbaren Schriftarten. Einfaches Beispiel:

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

Die fonts Arrayschlüssel sind die Namen der Schriftfamilien. Die styles -Arrays -Schlüssel sind die Stylesnamen. Die Zahlen in den Stilnamen sind die Schriftgewichte, i steht für Italic.

Die Schriftart -Dateipfade sind relativ zum Verzeichnis der public/fonts verabreicht. Die Dateipfade sind die Glob -Suchmuster. Dies bedeutet, dass das Repository alle Dateien berücksichtigen sollte, die dem Muster als Schriftart Dateien entsprechen.

Hier finden Sie weitere Beispiele und Möglichkeiten.

Verwendung

Fügen Sie dem HTML -Code der Seite, auf dem Sie eine Schriftart einbetten möchten, ein <link> -Tag hinzu:

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

Wobei http://web-fonts-repository.local die root-URL eines installierten Web-Schriftarten-Repositorys ist.

Die erforderlichen Schriftarten sind genauso angegeben wie bei Google -Schriftarten. Schriftfamilien sind geteilt durch | , Familienstile sind geteilt durch , der Familienname wird von der Stylesliste getrennt mit : .

Sie können die Stylesliste weglassen. In diesem Fall wird der reguläre Stil ( 400 ) verwendet.

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

Mit display können Sie einen Wert für die Eigenschaft für Schriftartenstil angeben. Beispiel:

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

Dann eine Schriftart in einen CSS -Code einbetten:

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

Versionen Kompatibilität

Das Projekt folgt der semantischen Versionierung.

Dies bedeutet, dass Patch -Versionen vollständig kompatibel sind (dh 1.2.1 und 1.2.2), kleinere Versionen sind rückwärts kompatibel (dh 1.2.1 und 1.3.2) und Hauptversionen sind nicht kompatibel (dh 1.2.1 und 3.0). Die Pre-Veröffentlichungsversionen (0.*) sind etwas unterschiedlich: Patch-Versionen sind rückwärtskompatibel und kleinere Versionen nicht kompatibel.

Lizenz

MIT. Weitere Informationen finden Sie in der Lizenzdatei.