CLI

Die Kommandozeilen-Schnittstelle für UnoCSS: @unocss/cli.

• 🍱 Geeignet für traditionelle Backends wie Laravel oder Kirby
• 👀 Watch-Modus enthalten
• 🔌 Unterstützt benutzerdefinierte Konfigurationen über uno.config.ts

Installation

Dieses Paket wird mit dem unocss Paket mitgeliefert:

pnpm

pnpm add -D unocss

yarn

yarn add -D unocss

npm

npm install -D unocss

bun

bun add -D unocss

Sie können auch das eigenständige Paket installieren:

pnpm

pnpm add -D @unocss/cli

yarn

yarn add -D @unocss/cli

npm

npm install -D @unocss/cli

bun

bun add -D @unocss/cli

INFO

Wenn Sie die Binärdatei nicht finden können (z. B. mit pnpm und nur unocss installiert ist), müssen Sie das eigenständige Paket @unocss/cli explizit installieren.

Verwendung

Sie können auch mehrere Glob-Muster an @unocss/cli übergeben:

unocss "site/snippets/**/*.php" "site/templates/**/*.php"

Beispiel-Paketkonfiguration:

INFO

Stellen Sie sicher, dass Sie Escaped-Anführungszeichen zu Ihren npm-Skript-Glob-Mustern hinzufügen.

{
  "scripts": {
    "dev": "unocss \"site/{snippets,templates}/**/*.php\" --watch",
    "build": "unocss \"site/{snippets,templates}/**/*.php\""
  },
  "devDependencies": {
    "@unocss/cli": "latest"
  }
}

Entwicklung

Fügen Sie das Flag --watch (oder -w) hinzu, um die Überwachung von Dateiänderungen zu aktivieren:

unocss "site/{snippets,templates}/**/*.php" --watch

Produktion

unocss "site/{snippets,templates}/**/*.php"

Die finale uno.css wird standardmäßig im aktuellen Verzeichnis generiert.

Eingebaute Funktionen

Konfigurationen

Erstellen Sie eine uno.config.js oder uno.config.ts Konfigurationsdatei auf Root-Ebene Ihres Projekts, um UnoCSS anzupassen.

import { defineConfig } from 'unocss'

export default defineConfig({
  cli: {
    entry: {}, // CliEntryItem | CliEntryItem[]
  },
  // ...
})

interface CliEntryItem {
  /**
   * Glob-Muster zum Abgleichen von Dateien
   */
  patterns: string[]
  /**
   * Der Ausgabedateiname für die generierte UnoCSS-Datei
   */
  outFile: string
}

Für eine Liste von Optionen gehen Sie zur UnoCSS Konfigurationen Dokumentation.

Optionen

Optionen
-v, --version	Zeigt die aktuelle Version von UnoCSS an
-c, --config-file <file>	Konfigurationsdatei
-o, --out-file <file>	Der Ausgabedateiname für die generierte UnoCSS-Datei. Standardmäßig uno.css im aktuellen Arbeitsverzeichnis
--stdout	Schreibt die generierte UnoCSS-Datei nach STDOUT. Verursacht, dass --watch und --out-file ignoriert werden
-w, --watch	Gibt an, ob die von dem Glob-Muster gefundenen Dateien überwacht werden sollen
--preflights	Aktiviert Preflight-Styles
--write-transformed	Aktualisiert Quelldateien mit transformierten Utilities
-m, --minify	Minifiziert generiertes CSS
-h, --help	Zeigt verfügbare CLI-Optionen an