# { } scss-to-css
### পুনরাবৃত্তভাবে সমস্ত SCSS ফাইল মিনিফাইড CSS-এ কম্পাইল করুন।
## ⚡ স্থাপন
একটি **গ্লোবাল ইউটিলিটি** হিসেবে:
```
$ npm install -g @adamlui/scss-to-css
```
**বিকাশকারী নির্ভরতা** হিসেবে (যেমন বিল্ড স্ক্রিপ্টের জন্য), আপনার প্রোজেক্ট রুট থেকে:
```
$ npm install -D @adamlui/scss-to-css
```
**রানটাইম নির্ভরতা** হিসেবে (যেমন, অন-দ্য-ফ্লাই সংকলনের জন্য), আপনার প্রোজেক্ট রুট থেকে:
```
$ npm install @adamlui/scss-to-css
```
## 💻 কমান্ড লাইন ব্যবহার
মৌলিক **গ্লোবাল কমান্ড** হল:
```
$ scss-to-css
```
নমুনা আউটপুট:
**📝 দ্রষ্টব্য:** উৎস মানচিত্রগুলিও ডিফল্টরূপে তৈরি করা হয় যদি না `-S` বা `--no-source-maps` পাস না হয়।
#
**ইনপুট/আউটপুট** পাথ নির্দিষ্ট করতে:
```
$ scss-to-css [input_path] [output_path]
```
- `[input_path]`: SCSS ফাইল বা ডিরেক্টরির পাথ যেখানে SCSS ফাইল কম্পাইল করা হবে, বর্তমান কার্যকারী ডিরেক্টরির সাথে সম্পর্কিত।
- `[output_path]`: ফাইল বা ডিরেক্টরির পাথ, যেখানে CSS + সোর্স ম্যাপ ফাইলগুলো সংরক্ষণ করা হবে, যা ইনপুট রুটের সাপেক্ষে নির্ধারিত হবে (যদি এটি প্রদান না করা হয়, তবে `css/` ব্যবহৃত হবে)।
**📝 দ্রষ্টব্য:** ফোল্ডারগুলি পাস করা হলে, ফাইলগুলি পুনরাবৃত্তিমূলকভাবে প্রক্রিয়া করা হবে যদি না `-R` বা `--no-recursion` পাস না হয়।
#
আপনার প্রোজেক্টের `package.json`-এ **প্যাকেজ স্ক্রিপ্ট** হিসেবে ব্যবহার করতে:
```json
"scripts": {
"build:css": ""
},
```
`` কে `scss-to-css` + ঐচ্ছিক প্যারামিটার দিয়ে প্রতিস্থাপন করুন। তারপর, কমান্ড চালানোর জন্য `npm run build:css` ব্যবহার করা যেতে পারে।
#
### উদাহরণ কমান্ড
**বর্তমান ডিরেক্টরি**-এ সমস্ত SCSS ফাইল কম্পাইল করুন (`css/`-এ আউটপুট):
```
$ scss-to-css
```
একটি **নির্দিষ্ট ডিরেক্টরি**-এ সমস্ত SCSS ফাইল কম্পাইল করুন (`css/path/to/your/directory/`-এ আউটপুট):
```
$ scss-to-css path/to/your/directory
```
একটি **নির্দিষ্ট ফাইল** কম্পাইল করুন (`css/path/to/your/file.min.css`-এ আউটপুট):
```
$ scss-to-css path/to/your/file.scss
```
উভয় **ইনপুট এবং আউটপুট** ডিরেক্টরি নির্দিষ্ট করুন (`output_folder/`-এ আউটপুট):
```
$ scss-to-css input_folder output_folder
```
**📝 দ্রষ্টব্য:** আউটপুট CSS ছোট করা হয় যদি না `-M` বা `--no-minify` পাস না হয়।
#
### কমান্ড লাইন বিকল্প
```
বুলিয়ান বিকল্প:
-n, --dry-run আসলে ফাইল(গুলি) ছোট করবেন না, সেগুলি প্রক্রিয়া করা হবে কিনা তা দেখান৷
-d, --include-dotfolders ফাইল অনুসন্ধানে ডটফোল্ডার অন্তর্ভুক্ত করুন।
-S, --no-source-maps উৎস মানচিত্র তৈরি হওয়া থেকে আটকান।
-M, --no-minify আউটপুট CSS-এর মিনফিকেশন অক্ষম করুন।
-R, --no-recursion পুনরাবৃত্ত ফাইল অনুসন্ধান অক্ষম করুন।
-r, --relative-output ইনপুট রুটের পরিবর্তে প্রতিটি উৎস ফাইলের সাপেক্ষে আউটপুট ফাইল তৈরি করুন।
-c, --copy একক উৎস ফাইল প্রক্রিয়া করা হলে ফাইলে লেখার পরিবর্তে ক্লিপবোর্ডে কম্পাইল করা CSS কপি করুন।
-q, --quiet ত্রুটি ছাড়া সব লগিং দমন করুন।
প্যারামিটার অপশনসমূহ:
--ignores="dir/,file1.scss,file2.sass" কম্পাইলেশন থেকে বাদ দেওয়ার জন্য ফাইল/ডিরেক্টরি।
--comment="comment" কম্পাইল করা CSS-এ হেডার কমেন্ট প্রিপেন্ড করুন। '\n' ব্যবহার করে লাইন দ্বারা আলাদা করুন।
--ui-lang="code" UI প্রদর্শনের জন্য ISO 639-1 ভাষার কোড।
--config="path/to/file" কাস্টম কনফিগারেশন ফাইল লোড করুন।
কমান্ডসমূহ:
-i, --init কনফিগারেশন ফাইল তৈরি করুন (প্রজেক্টের রুটে)।
-h, --help সাহায্য স্ক্রীন প্রদর্শন করুন।
-v, --version সংস্করণ নম্বর দেখান।
--stats npm পরিসংখ্যান দেখান।
--debug [targetKey] ডিবাগ লগ দেখান।
```
#
### কনফিগারেশন ফাইল
আপনার প্রজেক্ট রুটে রাখা একটি `scss-to-css.config.mjs` বা `scss-to-css.config.js` ফাইল ব্যবহার করে **scss-to-css** কাস্টমাইজ করা যেতে পারে।
ডিফল্ট উদাহরণ:
```js
export default {
dryRun: false, // ফাইলগুলো আসলে মিনিফাই করবে না, শুধু দেখাবে যে সেগুলো প্রসেস করা হবে কিনা
includeDotFolders: false, // ফাইল খোঁজার সময় ডটফোল্ডারগুলো অন্তর্ভুক্ত করুন
noSourceMaps: false, // সোর্স ম্যাপ তৈরি হওয়া থেকে বিরত রাখুন
noMinify: false, // আউটপুট CSS-এর মিনিফিকেশন নিষ্ক্রিয় করুন
noRecursion: false, // রিকার্সিভ ফাইল সার্চিং নিষ্ক্রিয় করুন
relativeOutput: false, // ইনপুট রুটের পরিবর্তে প্রতিটি src ফাইলের সাপেক্ষে ফাইল আউটপুট করুন
copy: false, // যদি একটিমাত্র ফাইল প্রসেস করা হয়, তবে কম্পাইল করা CSS ফাইলে লেখার পরিবর্তে ক্লিপবোর্ডে কপি করুন
quietMode: false, // ত্রুটি ছাড়া সমস্ত লগিং বন্ধ রাখুন
ignores: '', // মিনিফিকেশন থেকে বাদ দেওয়ার জন্য ফাইল/ডিরেক্টরি
comment: '' // মিনিফাই করা কোডের শুরুতে যোগ করার জন্য হেডার কমেন্ট
}
```
💡 আপনার প্রজেক্ট রুটে একটি টেমপ্লেট `scss-to-css.config.mjs` তৈরি করতে `scss-to-css init` কমান্ডটি চালান।
## 🔌 API ব্যবহার
আপনি ECMAScript মডিউল বা CommonJS মডিউল উভয় হিসাবে, এর API পদ্ধতিগুলি ব্যবহার করতে আপনার অ্যাপে **scss-to-css** আমদানি করতে পারেন।
#### ECMAScript*:
```js
import scssToCSS from '@adamlui/scss-to-css'
```
#### CJS:
```js
const scssToCSS = require('@adamlui/scss-to-css')
```
###### _*Node.js সংস্করণ 14 বা উচ্চতর প্রয়োজন_
#
### `compile(input[, options])`
💡 সরবরাহকৃত স্ট্রিং ইনপুটের উপর ভিত্তি করে SCSS কম্পাইল করে।
যদি **সোর্স কোড** পাস করা হয়, এটি সরাসরি কম্পাইল করা হয়, তারপর `srcPath` + `code` + `srcMap` + `error` সম্বলিত একটি বস্তু ফেরত দেওয়া হয়:
```js
const srcCode = 'h1 { font-size: 40px ; code { font-face: Roboto Mono }}',
compileResult = scssToCSS.compile(srcCode)
console.log(compileResult.error) // আউটপুট রানটাইম ত্রুটি, বা `undefined` যদি কোনো ত্রুটি না থাকে
console.log(compileResult.code) // আউটপুট মিনিফাইড CSS: 'h1{font-size:40px}h1 code{font-face:Roboto Mono}'
```
যদি একটি **ফাইল পাথ** পাস করা হয়, তাহলে ফাইলের কোডটি লোড হয় তারপর CSS-এ কম্পাইল করা হয়, উপরের মত একটি বস্তু ফিরিয়ে দেয়।
যদি একটি **ডিরেক্টরি পাথ** পাস করা হয়, SCSS ফাইলগুলি অনুসন্ধান করা হয় (পুনরাবৃত্তভাবে ডিফল্টভাবে), প্রতিটির কোড লোড করা হয় তারপর কম্পাইল করা হয়, তারপর `srcPath` + `code` + `srcMap` + `error` ধারণকারী বস্তুর একটি অ্যারে ফেরত দেওয়া হয়:
```js
// কর্মরত ডিরেক্টরি + সমস্ত নেস্টেড ডিরেক্টরিতে SCSS ফাইলের পাথ আউটপুট করে
const compileResults = scssToCSS.compile('.')
compileResults.forEach(result => console.log(result.srcPath))
// পাওয়া গেলে দ্বিতীয় SCSS ফাইল থেকে CSS কম্পাইল করা আউটপুট, বা না পাওয়া গেলে `undefined`
console.log(compileResults[1].code)
```
বিকল্পগুলি হল বুলিয়ান, অবজেক্টের বৈশিষ্ট্য হিসাবে পাস করা হয়েছে৷ উদাহরণ স্বরূপ:
```js
// ডেটা অবজেক্টের অ্যারে প্রদান করে যেখানে `.কোড` অমিনিফাইড CSS কোড
scssToCSS.compile(inputDir, { minify: false })
```
উপলব্ধ প্যারামিটার (এবং তাদের ডিফল্ট সেটিংস) হল:
নাম | টাইপ | বর্ণনা | ডিফল্ট মান
-----------------|---------|---------------------------------------------------------------------------------|------------
`recursive` | বুলিয়ান | ডিরেক্টরি পাথ পাস হলে নেস্টেড ফাইলগুলির জন্য পুনরাবৃত্তিমূলকভাবে অনুসন্ধান করুন। | `true`
`verbose` | বুলিয়ান | কনসোল/টার্মিনালে কনসোল লগিং দেখান। | `true`
`dotFolders` | বুলিয়ান | ফাইল অনুসন্ধানে ডটফোল্ডার অন্তর্ভুক্ত করুন। | `false`
`minify` | বুলিয়ান | আউটপুট CSS ছোট করুন। | `true`
`sourceMaps` | বুলিয়ান | CSS সোর্স ম্যাপ তৈরি করুন। | `true`
`relativeOutput` | বুলিয়ান | ইনপুট রুটের পরিবর্তে প্রতিটি উৎস ফাইলের সাপেক্ষে আউটপুট ফাইল তৈরি করুন। | `false`
`ignores` | অ্যারে | কম্পাইলেশন থেকে বাদ দেওয়ার জন্য ফাইল/ডিরেক্টরি। | `[]`
`comment` | স্ট্রিং | কম্পাইল করা CSS-এ প্রিপেন্ড করতে হেডার মন্তব্য। '\n' ব্যবহার করে লাইন দ্বারা আলাদা করুন। | `''`
#
### `findSCSS(searchDir[, options])`
💡 পাস করা `searchDir` স্ট্রিং-এর মধ্যে সমস্ত SCSS ফাইলের জন্য অনুসন্ধান করে (কি ফাইলগুলি [`compile()`](#compileinput-options) প্রক্রিয়া করবে তা আবিষ্কার করার জন্য দরকারী) এবং তাদের ফাইলপাথ সমন্বিত একটি অ্যারে প্রদান করে।
বিকল্পগুলি হল বুলিয়ান, অবজেক্টের বৈশিষ্ট্য হিসাবে পাস করা হয়েছে। উদাহরণ স্বরূপ:
```js
// ঠিক assets/scss-এ SCSS ফাইল অনুসন্ধান করুন
const searchResults = scssToCSS.findSCSS('assets/scss', { recursive: false })
console.log(searchResults)
/* নমুনা আউটপুট:
findSCSS() » Searching for SCSS files...
findSCSS() » Search complete! 2 files found.
findSCSS() » Check returned array.
[
'E:\\js\\utils\\scss-to-css\assets\\scss\\foo.scss',
'E:\\js\\utils\\scss-to-css\assets\\scss\\bar.sass'
]
*/
```
উপলব্ধ প্যারামিটার (এবং তাদের ডিফল্ট সেটিংস) হল:
নাম | টাইপ | বর্ণনা | ডিফল্ট মান
--------------|---------|--------------------------------------------------------------|------------
`recursive` | বুলিয়ান | searchDir পাস করা নেস্টেড ফাইলগুলির জন্য বারবার অনুসন্ধান করুন। | `true`
`verbose` | বুলিয়ান | কনসোল/টার্মিনালে কনসোল লগিং দেখান। | `true`
`dotFolders` | বুলিয়ান | ফাইল অনুসন্ধানে ডটফোল্ডার অন্তর্ভুক্ত করুন। | `false`
`ignores` | অ্যারে | অনুসন্ধানের ফলাফল থেকে বাদ দেওয়ার জন্য ফাইল/ডিরেক্টরি। | `[]`
## 🏛️ MIT লাইসেন্স
**কপিরাইট © 2024 [Adam Lui](https://github.com/adamlui) এবং অবদানকারী**
এই সফ্টওয়্যারটির একটি অনুলিপি এবং সংশ্লিষ্ট ডকুমেন্টেশন ফাইল ("সফ্টওয়্যার") প্রাপ্ত যেকোন ব্যক্তিকে এতদ্বারা অনুমতি দেওয়া হচ্ছে, বিনা মূল্যে সফ্টওয়্যার ব্যবহার, অনুলিপি, পরিবর্তন, একত্রীকরণের অধিকার সহ সীমাবদ্ধতা ছাড়াই সফ্টওয়্যারে ডিল করার জন্য। , প্রকাশ, বিতরণ, সাবলাইসেন্স, এবং/অথবা সফ্টওয়্যারের অনুলিপি বিক্রি করে এবং যাদের কাছে সফ্টওয়্যারটি সজ্জিত করা হয়েছে তাদের অনুমতি দিতে, নিম্নলিখিত শর্তাবলী সাপেক্ষে:
উপরের কপিরাইট বিজ্ঞপ্তি এবং এই অনুমতি বিজ্ঞপ্তিটি সফ্টওয়্যারের সমস্ত কপি বা উল্লেখযোগ্য অংশে অন্তর্ভুক্ত করা হবে।
সফ্টওয়্যারটি "যেমন আছে" প্রদান করা হয়, কোনো প্রকারের ওয়্যারেন্টি ছাড়াই, প্রকাশ বা উহ্য, যার মধ্যে রয়েছে কিন্তু কোনো বিশেষ উদ্দেশ্যমূলক কাজের জন্য ব্যবসায়িকতা, উপযুক্ততার ওয়্যারেন্টিগুলির মধ্যে সীমাবদ্ধ নয়৷ কোনও ক্ষেত্রেই লেখক বা কপিরাইট ধারক কোনও দাবি, ক্ষতি বা অন্যান্য দায়দায়িত্বের জন্য দায়বদ্ধ হবেন না, চুক্তির কোনও ক্রিয়াকলাপে, টর্ট বা অন্যথায়, পরবর্তী সময়ে, আমাদের থেকে উদ্ভূত অন্যান্য লেনদেন সফটওয়্যার।
## 🛠️ সম্পর্কিত ইউটিলিটি
### [ minify.js](https://github.com/adamlui/minify.js/#readme) 
> সব জাভাস্ক্রিপ্ট ফাইল পুনরাবৃত্তিমূলকভাবে ছোট করুন।
[ইনস্টল করুন](https://github.com/adamlui/js-utils/tree/main/minify.js/node.js/docs/bn/#-%E0%A6%B8%E0%A7%8D%E0%A6%A5%E0%A6%BE%E0%A6%AA%E0%A6%A8) /
[রিডমি](https://github.com/adamlui/js-utils/tree/main/minify.js/node.js/docs/bn/#readme) /
[CLI ব্যবহার](https://github.com/adamlui/js-utils/tree/main/minify.js/node.js/docs/bn/#-%E0%A6%95%E0%A6%AE%E0%A6%BE%E0%A6%A8%E0%A7%8D%E0%A6%A1-%E0%A6%B2%E0%A6%BE%E0%A6%87%E0%A6%A8-%E0%A6%AC%E0%A7%8D%E0%A6%AF%E0%A6%AC%E0%A6%B9%E0%A6%BE%E0%A6%B0) /
[API ব্যবহার](https://github.com/adamlui/js-utils/tree/main/minify.js/node.js/docs/bn/#-api-%E0%A6%AC%E0%A7%8D%E0%A6%AF%E0%A6%AC%E0%A6%B9%E0%A6%BE%E0%A6%B0) /
[আলোচনা করা](https://github.com/adamlui/minify.js/discussions)
**আরো জাভাস্ক্রিপ্ট ইউটিলিটি** /
আলোচনা করা /
ত্রুটি জানান /
দুর্বলতা জানান /
উপরে ফিরে যাও ↑
