وصغر هو أداة بيثون أن يوفر distutils الأوامر لتصغير CSS والموارد JS باستخدام ضاغط YUI معروفة من ياهو! شركة على & nbsp؛ عند تثبيت صغر، هما أوامر distutils الجديدة المتاحة:
- minify_js التي minifies ملفات جافا سكريبت
- minify_css التي minifies ملفات CSS
راجع قسم الاستخدام لمزيد من المعلومات حول هذه الأوامر.
تركيب
وتهدف الأوامر صغر لاستخدامها في مشروع الثعبان القائمة. لذلك، من أجل جعل الأوامر المتوفرة في المشروع الخاص بك، فقط إضافة صغر لمتطلبات المشروع الخاص بك، على سبيل المثال:
نصب (
على & nbsp؛ ...
على & nbsp؛ install_requires = ['صغر']،
على & nbsp؛ ...
)
ثم، عند تثبيت حزمة الخاص بك (على سبيل المثال مع بيثون setup.py تطوير)، الأوامر صغر سوف تكون متاحة.
منذ هو مكتوب الأداة ضاغط YUI في جاوة، يجب أن يكون لديك آلة جافا الافتراضية المثبتة على النظام الخاص بك والمتاحة في PATH النظام الخاص بك.
استعمال
يوفر صغر اثنين من الأوامر لتصغير CSS و JS الموارد:
- minify_js التي minifies ملفات جافا سكريبت
- minify_css التي minifies ملفات CSS
ملفات التصغير جافا سكريبت
لإظهار الخيارات من الأمر minify_js، اكتب فقط:
على & nbsp؛ بيثون setup.py minify_js --help
يجب عليك الحصول على شيء من هذا القبيل:
الأوامر الشائعة: (انظر "-الأوامر --help" للمزيد)
على & nbsp؛ setup.py بناء ستبني حزمة تحت "بناء / '
على & nbsp؛ setup.py تثبيت سيقوم بتثبيت حزمة
خيارات العالمية:
على & nbsp؛ - مطول (-v) تشغيل verbosely (الافتراضي)
على & nbsp؛ - الهدوء (-q) تشغيل بهدوء (يتحول الإسهاب إيقاف)
على & nbsp؛ - التي تديرها الجاف (-n) لا تفعل اي شيء في الواقع
على & nbsp؛ - مساعدة (-h) تظهر رسالة مفصلة مساعدة
على & nbsp؛ - أي مستخدم-س ف ج تجاهل pydistutils.cfg في دليل منزلك
خيارات الأمر 'minify_js':
على & nbsp؛ - مصادر مصادر الملفات
على & nbsp؛ - انتاج مصغر اسم الملف الناتج. إذا كنت تقديم قالب
على & nbsp؛ اسم الملف الناتج (على سبيل المثال "ثابتة /٪ S-min.ext")، و
على & nbsp؛ سيتم مصغر الملفات المصدر بشكل فردي
على & nbsp؛ - محارف قراءة ملف الإدخال (ق) باستخدام
على & nbsp؛ - خط كسر إدراج فاصل السطر بعد العمود المحدد
على & nbsp؛ عدد
على & nbsp؛ - nomunge صغر فقط، لا تعتم
على & nbsp؛ - الحفاظ على شبه تحافظ على جميع الفواصل المنقوطة
على & nbsp؛ - تعطيل-تحسينات تعطيل كافة التحسينات الصغيرة
الاستعمال: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
على & nbsp؛ أو: --help setup.py [cmd1 cmd2 ...]
على & nbsp؛ أو: setup.py --help-الأوامر
على & nbsp؛ أو: setup.py كمد --help
الأداة minify_js يمكن استخدامها على سطر الأوامر. هنا مثال:
على & nbsp؛ minify_js الثعبان setup.py --sources ثابت / * شبيبة --output ثابت / combined.js.
ولكن، والطريقة الأكثر فائدة لاستخدام minify_js هو عن طريق ملف setup.cfg الموجود في الدليل الجذر المشروع الخاص بك (أي، إلى جانب ملف setup.py):
[minify_js]
مصادر = ثابت / one.js ثابت / two.js
الناتج = ثابت / combined.js
nomunge = نعم
ثم، ونحن تشغيل الأمر minify_js، سيتم قراءة خيارات الأمر من ملف setup.cfg بالإضافة إلى وسائط سطر الأوامر.
لاحظ أنه، منذ هناك ملف الإخراج واحد لمصادر عديدة، يتم دمج الملفات مصادر في ملف واحد والتي يتم ضغطها مع ضاغط YUI من أجل إنتاج ملف مصغر واحد.
ومع ذلك، قد ترغب في ضغط الملفات مصادر فردية والحصول على ملفات مصغر متميزة. في هذه الحالة، يجب أن توفر اسم ملف الإخراج قالب بدلا من اسم الملف الناتج منتظم. واسم الملف الناتج القالب هو اسم الملف مع الصورة٪ في ذلك، والتي سيتم substitued من قبل باسم مصدر في الوقت الراهن يتم معالجتها. على سبيل المثال:
[minify_js]
مصادر = ثابت / one.js ثابت / two.js
الناتج = ثابت /٪ S-min.js
سوف تعمل minify_js الثعبان setup.py ثم تنتج ملفين مصغر: ثابت /-min.js واحد وثابت /-min.js اثنين.
تصغير ملفات CSS
يمكنك أيضا رؤية الخيارات من الأمر minify_css، من خلال الكتابة:
على & nbsp؛ بيثون setup.py minify_css --help
وهنا هو نتيجة:
الأوامر الشائعة: (انظر "-الأوامر --help" للمزيد)
على & nbsp؛ setup.py بناء ستبني حزمة تحت "بناء / '
على & nbsp؛ setup.py تثبيت سيقوم بتثبيت حزمة
خيارات العالمية:
على & nbsp؛ - مطول (-v) تشغيل verbosely (الافتراضي)
على & nbsp؛ - الهدوء (-q) تشغيل بهدوء (يتحول الإسهاب إيقاف)
على & nbsp؛ - التي تديرها الجاف (-n) لا تفعل اي شيء في الواقع
على & nbsp؛ - مساعدة (-h) تظهر رسالة مفصلة مساعدة
على & nbsp؛ - أي مستخدم-س ف ج تجاهل pydistutils.cfg في دليل منزلك
خيارات الأمر 'minify_css':
على & nbsp؛ - مصادر مصادر الملفات
على & nbsp؛ - انتاج مصغر اسم الملف الناتج. إذا كنت تقديم الناتج القالب
على & nbsp؛ اسم الملف (على سبيل المثال "ثابتة /٪ S-min.ext")، الملفات المصدر سيكون
على & nbsp؛ مصغر بشكل فردي
على & nbsp؛ - محارف قراءة ملف الإدخال (ق) باستخدام
على & nbsp؛ - خط كسر إدراج فاصل السطر بعد عدد العمود المحدد
الاستعمال: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
على & nbsp؛ أو: --help setup.py [cmd1 cmd2 ...]
على & nbsp؛ أو: setup.py --help-الأوامر
على & nbsp؛ أو: setup.py كمد --help
هذا الأمر يمكن استخدام حوالي بنفس طريقة الأمر minify_js، لكنه لا يملك خيارات أقل.
الجمع بين عمليات تصغير الحجم
يمكنك أيضا الجمع بين عمليات تصغير الحجم بفضل القيادة الاسم المستعار مدمج (لا يزال المحدد في ملف setup.cfg):
[اسم مستعار]
minify_each_css = minify_css --sources ثابت / *. المغلق --output ثابتة /٪ S-min.css --charset UTF-8
minify_each_js = minify_js --sources ثابت / *. شبيبة --output ثابتة /٪ S-min.js --charset UTF-8
minify_each = minify_each_css minify_each_js
ثم استدعاء minify_each بكتابة:
على & nbsp؛ minify_each الثعبان setup.py
دعم
مستضافة هذا المشروع على bitbucket.org. الرجاء الإبلاغ عن القضايا عن طريق تعقب علة
ما هو الجديد في هذا الإصدار:.
التوافق distutils الصرفة
ما هو الجديد في الإصدار 0.1.2:
قضية ثابتة # 2: مصادر حيث معالجتها خارج الترتيب، وهو ما تسبب مشاكل عند تقييم قواعد CSS، ...
ما هو الجديد في الإصدار 0.1.1:
قضية ثابتة # 1: تحسين وثائق، وأوضح أن صغر يتطلب setuptools لتثبيت.
المتطلبات:
بيثون
لم يتم العثور على التعليقات