CLI

واجهة سطر الأوامر لـ UnoCSS: @unocss/cli.

• 🍱 مناسب للخلفيات التقليدية مثل Laravel أو Kirby
• 👀 وضع المراقبة مضمّن
• 🔌 يدعم التكوينات المخصصة عبر uno.config.ts

التثبيت

يتم شحن هذه الحزمة مع حزمة unocss:

pnpm

pnpm add -D unocss

yarn

yarn add -D unocss

npm

npm install -D unocss

bun

bun add -D unocss

يمكنك أيضاً تثبيت الحزمة المستقلة:

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

إذا لم تتمكن من العثور على الثنائي (على سبيل المثال مع pnpm وتم تثبيت unocss فقط)، ستحتاج إلى تثبيت حزمة @unocss/cli المستقلة بشكل صريح.

الاستخدام

يمكنك أيضاً تمرير أنماط glob متعددة إلى @unocss/cli:

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

مثال على تكوين الحزمة:

INFO

تأكد من إضافة علامات اقتباس محررة لأنماط glob في سكريبت npm.

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

التطوير

أضف علامة --watch (أو -w) لتمكين مراقبة تغييرات الملفات:

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

الإنتاج

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

سيتم إنشاء uno.css النهائي في الدليل الحالي افتراضياً.

الميزات المدمجة

التكوينات

قم بإنشاء ملف تكوين uno.config.js أو uno.config.ts على مستوى الجذر لمشروعك لتخصيص UnoCSS.

import { defineConfig } from 'unocss'

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

interface CliEntryItem {
  /**
   * أنماط Glob لمطابقة الملفات
   */
  patterns: string[]
  /**
   * اسم ملف الإخراج لملف UnoCSS المُنشأ
   */
  outFile: string
}

للحصول على قائمة الخيارات، انتقل إلى وثائق تكوينات UnoCSS.

الخيارات

الخيارات
-v, --version	عرض الإصدار الحالي لـ UnoCSS
-c, --config-file <file>	ملف التكوين
-o, --out-file <file>	اسم ملف الإخراج لملف UnoCSS المُنشأ. افتراضياً uno.css في دليل العمل الحالي
--stdout	كتابة ملف UnoCSS المُنشأ إلى STDOUT. سيؤدي إلى تجاهل --watch و --out-file
-w, --watch	يشير إلى ما إذا كان يجب مراقبة الملفات التي تم العثور عليها بواسطة نمط glob
--preflights	تمكين أنماط preflight
--write-transformed	تحديث ملفات المصدر بالأدوات المحولة
-m, --minify	تصغير CSS المُنشأ
-h, --help	عرض خيارات CLI المتاحة