CLI και βιβλιοθήκη Node
Το πακέτο fontstay είναι η μηχανή προσαρμογής αυτού του ιστότοπου χωρίς τον περιηγητή: ένα εργαλείο γραμμής εντολών και μια βιβλιοθήκη Node που διαβάζουν αρχεία γραμματοσειρών και εκτυπώνουν τους ίδιους κανόνες @font-face και τις ίδιες εξαγωγές με την εφαρμογή. Δεν χρειάζεται DOM και δεν κάνει αιτήματα δικτύου, επομένως ταιριάζει σε ροές build και CI.
Εγκατάσταση
Το πακέτο δεν έχει δημοσιευτεί ακόμη στο npm. Απαιτεί Node 24 ή νεότερο· δημιουργήστε το από ένα checkout του αποθετηρίου. Στα παραδείγματα παρακάτω το fontstay αντικαθιστά την εντολή node packages/fontstay/dist/bin.js.
git clone https://github.com/fogrew/fontstay.dev.git
cd fontstay.dev
pnpm install
pnpm cli:build
node packages/fontstay/dist/bin.js --versionΕντολές
Το fit διαβάζει ένα ή περισσότερα αρχεία γραμματοσειρών (WOFF2, WOFF, TTF, OTF) και εκτυπώνει το CSS των εναλλακτικών. Πολλά αρχεία συγχωνεύονται σε ένα φύλλο στυλ, όπως στην εφαρμογή. Το mcp ξεκινά διακομιστή MCP στο stdio για πράκτορες προγραμματισμού και δεν δέχεται επιλογές.
Προσαρμόστε μια γραμματοσειρά για Windows και macOS χωρίς τις κυριλλικές και ελληνικές γραφές. Η έξοδος είναι το ίδιο κείμενο με την εξαγωγή CSS στην εφαρμογή.
$ fontstay fit font.woff2 --systems windows,macos --no-scripts
@font-face {
font-family: "Source Sans Pro Fallback";
src: local("Arial"), local("ArialMT");
size-adjust: 93.697%;
ascent-override: 105.0194%;
descent-override: 29.1365%;
line-gap-override: 0%;
}
body {
font-family: "Source Sans Pro", "Source Sans Pro Fallback", sans-serif;
/* Safari has no vertical overrides: match the x-height and fix the line box */
font-size-adjust: 0.48;
line-height: 1.4;
}
.fonts-loading {
letter-spacing: -0.0003em;
word-spacing: -0.0025em;
}fontstay fit Inter.woff2 -o fallbacks.css
fontstay fit regular.woff2 bold.woff2 --format tailwind
fontstay fit font.woff2 -a 'last 2 chrome versions, os windows' --jsonΕπιλογές
| Επιλογή | Σημασία |
|---|---|
-s, --systems <list> | Συστήματα προς προσαρμογή: windows, macos, ios, android, linux, chromeos. Προεπιλογή: κάθε σύστημα με ποσοστό τουλάχιστον 1% στο κοινό. |
-a, --audience <query> | Ερώτημα Browserslist, προαιρετικά με τμήματα «os <system>» και «not os <system>». Προεπιλογή: baseline ευρέως διαθέσιμα. |
-f, --format <format> | Μορφή εξόδου, δείτε παρακάτω. Προεπιλογή: css. |
-k, --kind <kind> | Γενική οικογένεια των εναλλακτικών: sans-serif, serif, monospace ή cursive. Προεπιλογή: εντοπίζεται από τη γραμματοσειρά. |
--locale <en|ru> | Προφίλ συχνοτήτων της προσαρμογής: en ή ru. Προεπιλογή: en. |
--unicode-range | Προσθήκη unicode-range με τους γλύφους που καλύπτει κάθε γραμματοσειρά. |
--no-scripts | Να μη δημιουργούνται ξεχωριστές γραφές για κυριλλικά και ελληνικά. |
-o, --out <file> | Εγγραφή της εξόδου σε αρχείο αντί για stdout. |
--json | Εκτύπωση αναφοράς JSON αντί για το κείμενο του αρχείου. |
-h, --help / -v, --version | Εμφάνιση της βοήθειας ή της έκδοσης. |
Μορφές εξόδου
Το --format δέχεται μία από αυτές τις τιμές. Αντιστοιχούν στις μορφές εξαγωγής της εφαρμογής και ξεκινούν από την ίδια προσαρμογή.
Εκτελέστε αυτή την εντολή για κάθε μορφή με τη γραμματοσειρά δείγματος Fira Sans. Η έξοδος που εμφανίζεται προέρχεται από το CLI που έχει δημιουργηθεί.
Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format cssΈξοδος CLI
@font-face {
font-family: "Fira Sans Fallback";
src: local("Trebuchet MS"), local("TrebuchetMS");
size-adjust: 100.3942%;
ascent-override: 93.1328%;
descent-override: 26.3959%;
line-gap-override: 0%;
}
body {
font-family: "Fira Sans", "Fira Sans Fallback", sans-serif;
/* Safari has no vertical overrides: match the x-height and fix the line box */
font-size-adjust: 0.527;
line-height: 1.4;
}
.fonts-loading {
letter-spacing: -0.0019em;
}Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format variablesΈξοδος CLI
@font-face {
font-family: "Fira Sans Fallback";
src: local("Trebuchet MS"), local("TrebuchetMS");
size-adjust: 100.3942%;
ascent-override: 93.1328%;
descent-override: 26.3959%;
line-gap-override: 0%;
}
:root {
--font-body: "Fira Sans", "Fira Sans Fallback", sans-serif;
}
body {
font-family: var(--font-body);
/* Safari has no vertical overrides: match the x-height and fix the line box */
font-size-adjust: 0.527;
line-height: 1.4;
}Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format tailwindΈξοδος CLI
@import "tailwindcss";
@font-face {
font-family: "Fira Sans Fallback";
src: local("Trebuchet MS"), local("TrebuchetMS");
size-adjust: 100.3942%;
ascent-override: 93.1328%;
descent-override: 26.3959%;
line-gap-override: 0%;
}
@theme {
--font-sans: "Fira Sans", "Fira Sans Fallback", sans-serif;
}Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format nextΈξοδος CLI
// Put FiraSans-Regular.ttf into ./fonts/ and the @font-face rules from the CSS export into your global CSS.
import localFont from 'next/font/local';
export const font = localFont({
src: './fonts/FiraSans-Regular.ttf',
display: 'swap',
adjustFontFallback: false,
fallback: ['Fira Sans Fallback', 'sans-serif'],
variable: '--font-body',
});Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format nuxtΈξοδος CLI
// Add the @font-face rules from the CSS export to a stylesheet listed in `css`.
export default defineNuxtConfig({
modules: ['@nuxt/fonts'],
fonts: {
families: [
{
name: 'Fira Sans',
src: '/fonts/FiraSans-Regular.ttf',
fallbacks: ['Fira Sans Fallback', 'sans-serif'],
},
],
},
});Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format astroΈξοδος CLI
// Add the @font-face rules from the CSS export to your global styles.
import { defineConfig } from 'astro/config';
export default defineConfig({
fonts: [
{
name: 'Fira Sans',
cssVariable: '--font-body',
provider: 'local',
options: {
variants: [{ weight: 400, style: 'normal', src: ['./src/assets/fonts/FiraSans-Regular.ttf'] }],
},
fallbacks: ['Fira Sans Fallback', 'sans-serif'],
},
],
});Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format wordpressΈξοδος CLI
{
"$schema": "https://schemas.wp.org/trunk/theme.json",
"version": 3,
"settings": {
"typography": {
"fontFamilies": [
{
"name": "Fira Sans",
"slug": "fira-sans",
"fontFamily": "\"Fira Sans\", \"Fira Sans Fallback\", sans-serif",
"fontFace": [
{
"fontFamily": "Fira Sans",
"fontWeight": "400",
"fontStyle": "normal",
"src": [
"file:./assets/fonts/FiraSans-Regular.ttf"
]
}
]
}
]
}
}
}Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format fontaineΈξοδος CLI
// Put FiraSans-Regular.ttf into ./public/fonts/ and declare their @font-face rules in your CSS. In Nuxt, put the plugin under vite.plugins.
import { FontaineTransform } from 'fontaine';
import { defineConfig } from 'vite';
export default defineConfig({
plugins: [
FontaineTransform.vite({
fallbacks: {
'Fira Sans': ['Trebuchet MS'],
},
resolvePath: (id) => new URL(`./public${id}`, import.meta.url),
}),
],
});Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format preloadΈξοδος CLI
<link rel="preload" href="/fonts/FiraSans-Regular.ttf" as="font" type="font/ttf" crossorigin>Εντολή
fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format loadingΈξοδος CLI
const root = document.documentElement;
const done = () => root.classList.remove('fonts-loading');
root.classList.add('fonts-loading');
document.fonts.load('1em "Fira Sans"').then(done, done);Έξοδος και αναφορές
Το κείμενο του αρχείου πηγαίνει στο stdout. Με το --json το CLI εκτυπώνει αντί γι' αυτό μια αναφορά, με τα κλειδιά file (η έξοδος στην επιλεγμένη μορφή), fonts (οικογένεια, εντοπισμένος τύπος, κάλυψη γλύφων και η εναλλακτική που επιλέχθηκε ανά σύστημα για κάθε γραμματοσειρά), shares (ποσοστό κοινού κάθε συστήματος, σε τοις εκατό), systems, uncovered (συστήματα του κοινού χωρίς εναλλακτική γραμματοσειρά) και audience (το επιλυμένο ερώτημα και ο αριθμός των περιηγητών που ταιριάζουν). Τα ποσοστά εξαρτώνται από τα δεδομένα περιηγητών τη στιγμή της εκτέλεσης.
Οι προειδοποιήσεις πηγαίνουν στο stderr, ώστε να μην καταλήγουν ποτέ στην έξοδο: μια γραμματοσειρά της οποίας οι εναλλακτικές καλύπτουν λιγότερο από το 90% των γλύφων της και συστήματα χωρίς καμία εναλλακτική γραμματοσειρά. Με το --out το CLI αναφέρει επίσης στο stderr το αρχείο που γράφτηκε.
Βιβλιοθήκη Node
Το fit δέχεται τα byte μιας γραμματοσειράς και το fitFiles διαβάζει αρχεία. Και τα δύο επιστρέφουν το CSS, την έξοδο στη ζητούμενη μορφή, μια αναφορά ανά γραμματοσειρά και τα ποσοστά του κοινού. Οι αποτυχίες ρίχνουν FitRunError (invalid-audience, no-systems, no-fit) ή FontParseError (για παράδειγμα invalid-font). Οι τύποι βρίσκονται στο index.d.ts.
import { fit, fitFiles } from 'fontstay';
import { readFile } from 'node:fs/promises';
const { css, fonts, shares } = await fit({
fonts: [{ fileName: 'font.woff2', data: await readFile('font.woff2') }],
audience: 'defaults',
systems: ['windows', 'macos'],
});
const tailwind = (await fitFiles(['font.woff2'], { format: 'tailwind' })).file.text;Κωδικοί εξόδου
| Κωδικός | Σημασία |
|---|---|
0 | Επιτυχία. |
1 | Αποτυχία: αρχείο που δεν μπορεί να διαβαστεί, μη έγκυρη γραμματοσειρά, μη έγκυρο κοινό. |
2 | Σφάλμα χρήσης: άγνωστη εντολή, απουσία αρχείου γραμματοσειράς, μη έγκυρη τιμή επιλογής. |