# { } scss-to-css
### सर्व SCSS फाईल्स minified 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
```
**📝 टीप:** `-M` किंवा `--no-minify` पास केल्याशिवाय आउटपुट CSS कमी केले जाते.
#
### कमांड लाइन पर्याय
```
बुलियन पर्याय:
-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** हे तुमच्या प्रोजेक्टच्या मूळ फोल्डरमध्ये ठेवलेल्या `scss-to-css.config.mjs` किंवा `scss-to-css.config.js` फाइलचा वापर करून सानुकूलित केले जाऊ शकते.
डीफॉल्ट उदाहरणे:
```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) // आउटपुट minified 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
// डेटा ऑब्जेक्ट्सचा ॲरे देते जेथे `.code` मध्ये अनमिनिफाइड CSS आहे
scssToCSS.compile(inputDir, { minify: false })
```
उपलब्ध पॅरामीटर्स (आणि त्यांची डीफॉल्ट सेटिंग्ज) आहेत:
नाव | प्रकार | वर्णन | डीफॉल्ट मूल्य
-----------------|-------|-------------------------------------------------------------------------|------------
`recursive` | बुलियन | डिरेक्टरी मार्ग पास झाल्यास नेस्टेड फाइल्ससाठी वारंवार शोधा. | `true`
`verbose` | बुलियन | कन्सोल/टर्मिनलमध्ये लॉग इन दाखवा. | `true`
`dotFolders` | बुलियन | फाइल शोधात डॉटफोल्डर समाविष्ट करा. | `false`
`minify` | बुलियन | आउटपुट CSS कमी करा. | `true`
`sourceMaps` | बुलियन | CSS स्त्रोत नकाशे व्युत्पन्न करा. | `true`
`relativeOutput` | बुलियन | इनपुट रूटऐवजी प्रत्येक स्रोत फाइलच्या सापेक्ष आउटपुट फाइल्स तयार करा. | `false`
`ignores` | स्ट्रिंग | संकलित CSS वर प्रीपेंड करण्यासाठी शीर्षलेख टिप्पणी. '\n' वापरून ओळीनुसार विभक्त करा. | `''`
#
### `findSCSS(searchDir[, options])`
💡 पास केलेल्या `searchDir` स्ट्रिंगमधील सर्व SCSS फायली शोधते (कोणत्या फायली [`compile()`](#compileinput-options) प्रक्रिया करतील हे शोधण्यासाठी उपयुक्त) आणि त्यांचे फाइलपाथ असलेले ॲरे परत करते.
पर्याय बुलियन आहेत, ऑब्जेक्ट गुणधर्म म्हणून पास केले जातात. उदाहरणार्थ:
```js
// SCSS फाईल्स नक्की assets/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) 
> सर्व JavaScript फायली आवर्तीपणे लहान करा.
[स्थापित करा](https://github.com/adamlui/minify.js/tree/main/node.js/docs/mr/#-%E0%A4%B8%E0%A5%8D%E0%A4%A5%E0%A4%BE%E0%A4%AA%E0%A4%A8%E0%A4%BE) /
[मला वाचा](https://github.com/adamlui/minify.js/tree/main/node.js/docs/mr/#readme) /
[CLI वापर](https://github.com/adamlui/minify.js/tree/main/node.js/docs/mr/#-%E0%A4%95%E0%A4%AE%E0%A4%BE%E0%A4%82%E0%A4%A1-%E0%A4%B2%E0%A4%BE%E0%A4%87%E0%A4%A8-%E0%A4%B5%E0%A4%BE%E0%A4%AA%E0%A4%B0) /
[API वापर](https://github.com/adamlui/minify.js/tree/main/node.js/docs/mr/#-api-%E0%A4%B5%E0%A4%BE%E0%A4%AA%E0%A4%B0) /
[चर्चा करा](https://github.com/adamlui/minify.js/discussions)
**अधिक JavaScript उपयुक्तता** /
चर्चा करा /
बगची तक्रार करा /
कमकुवतपणाची तक्रार करा /
परत वर जा ↑
