Μετάβαση στο περιεχόμενο
fontstay.dev
Πηγαίος κώδικας στο GitHub
Θέμα
Προσομοίωση όρασης

Για ελέγχους σχεδίασης· δεν διορθώνει την αντίληψη των χρωμάτων.

Βοηθήματα ανάγνωσης

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;
}

Έξοδος και αναφορές

Το κείμενο του αρχείου πηγαίνει στο 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Σφάλμα χρήσης: άγνωστη εντολή, απουσία αρχείου γραμματοσειράς, μη έγκυρη τιμή επιλογής.

Ρύθμιση του διακομιστή MCP