సహకరించండి
మా డాక్యుమెంటేషన్ బిల్డ్ స్క్రిప్ట్‌లు మరియు పరీక్షలతో బూట్‌స్ట్రాప్‌ను అభివృద్ధి చేయడంలో సహాయపడండి.
టూలింగ్ సెటప్
బూట్‌స్ట్రాప్ డాక్యుమెంటేషన్‌ను రూపొందించడానికి మరియు సోర్స్ ఫైల్‌లను కంపైల్ చేయడానికి npm స్క్రిప్ట్‌లను ఉపయోగిస్తుంది. కోడ్ కంపైల్ చేయడం, రన్నింగ్ టెస్ట్‌లు మరియు మరిన్నింటి కోసం మా ప్యాకేజీ .json ఈ స్క్రిప్ట్‌లను కలిగి ఉంది. ఇవి మా రిపోజిటరీ మరియు డాక్యుమెంటేషన్ వెలుపల ఉపయోగించడానికి ఉద్దేశించినవి కావు.
మా బిల్డ్ సిస్టమ్‌ను ఉపయోగించడానికి మరియు మా డాక్యుమెంటేషన్‌ను స్థానికంగా అమలు చేయడానికి, మీకు బూట్‌స్ట్రాప్ యొక్క సోర్స్ ఫైల్‌లు మరియు నోడ్ కాపీ అవసరం. ఈ దశలను అనుసరించండి మరియు మీరు రాక్ చేయడానికి సిద్ధంగా ఉండాలి:
- మేము మా డిపెండెన్సీలను నిర్వహించడానికి ఉపయోగించే Node.jsని డౌన్‌లోడ్ చేసి, ఇన్‌స్టాల్ చేయండి .
- బూట్‌స్ట్రాప్ మూలాలను డౌన్‌లోడ్ చేయండి లేదా బూట్‌స్ట్రాప్ రిపోజిటరీని ఫోర్క్ చేయండి .
/bootstrapరూట్ డైరెక్టరీకి నావిగేట్ చేయండి మరియు ప్యాకేజీnpm install.json లో జాబితా చేయబడిన మా స్థానిక డిపెండెన్సీలను ఇన్‌స్టాల్ చేయడానికి అమలు చేయండి .
పూర్తయినప్పుడు, మీరు కమాండ్ లైన్ నుండి అందించిన వివిధ ఆదేశాలను అమలు చేయగలరు.
npm స్క్రిప్ట్‌లను ఉపయోగించడం
మా package.json ప్రాజెక్ట్‌ను అభివృద్ధి చేయడానికి అనేక పనులను కలిగి ఉంది. npm runమీ టెర్మినల్‌లోని అన్ని npm స్క్రిప్ట్‌లను చూడటానికి రన్ చేయండి. ప్రాథమిక విధులు:
| టాస్క్ | వివరణ |
|---|---|
npm start |
CSS మరియు జావాస్క్రిప్ట్‌ను కంపైల్ చేస్తుంది, డాక్యుమెంటేషన్‌ను రూపొందిస్తుంది మరియు స్థానిక సర్వర్‌ను ప్రారంభిస్తుంది. |
npm run dist |
dist/కంపైల్ చేసిన ఫైల్‌లతో డైరెక్టరీని సృష్టిస్తుంది . Sass , Autoprefixer మరియు terser అవసరం . |
npm test |
పరిగెత్తిన తర్వాత స్థానికంగా పరీక్షలను అమలు చేస్తుందిnpm run dist |
npm run docs-serve |
స్థానికంగా డాక్యుమెంటేషన్‌ను రూపొందించి, అమలు చేస్తుంది. |
సాస్
బూట్‌స్ట్రాప్ మా సాస్ సోర్స్ ఫైల్‌లను CSS ఫైల్‌లలోకి కంపైల్ చేయడానికి డార్ట్ సాస్‌ని ఉపయోగిస్తుంది (మా బిల్డ్ ప్రాసెస్‌లో చేర్చబడింది), మరియు మీరు మీ స్వంత అసెట్ పైప్‌లైన్‌ని ఉపయోగించి సాస్‌ను కంపైల్ చేస్తుంటే మీరు కూడా అలాగే చేయాలని మేము సిఫార్సు చేస్తున్నాము. మేము బూట్‌స్ట్రాప్ v4 కోసం మునుపు Node Sassని ఉపయోగించాము, కానీ LibSass మరియు నోడ్ సాస్‌తో సహా దాని పైన నిర్మించిన ప్యాకేజీలు ఇప్పుడు నిలిపివేయబడ్డాయి .
డార్ట్ సాస్ 10 యొక్క రౌండింగ్ ఖచ్చితత్వాన్ని ఉపయోగిస్తుంది మరియు సమర్థతా కారణాల వల్ల ఈ విలువ సర్దుబాటును అనుమతించదు. మేము ఉత్పత్తి చేయబడిన CSS యొక్క తదుపరి ప్రాసెసింగ్ సమయంలో ఈ ఖచ్చితత్వాన్ని తగ్గించము, ఉదాహరణకు కనిష్టీకరణ సమయంలో, కానీ మీరు దీన్ని ఎంచుకుంటే, బ్రౌజర్ రౌండింగ్‌తో సమస్యలను నివారించడానికి కనీసం 6 ఖచ్చితత్వాన్ని నిర్వహించాలని మేము సిఫార్సు చేస్తున్నాము.
ఆటోప్రిఫిక్సర్
బిల్డ్ సమయంలో కొన్ని CSS లక్షణాలకు స్వయంచాలకంగా విక్రేత ప్రిఫిక్స్‌లను జోడించడానికి బూట్‌స్ట్రాప్ Autoprefixer (మా బిల్డ్ ప్రాసెస్‌లో చేర్చబడింది) ఉపయోగిస్తుంది. అలా చేయడం వల్ల v3లో కనిపించే వాటి వంటి వెండర్ మిక్సిన్‌ల అవసరాన్ని తొలగిస్తూ మన CSS యొక్క కీలక భాగాలను ఒకే సారి వ్రాయడానికి అనుమతించడం ద్వారా మాకు సమయం మరియు కోడ్ ఆదా అవుతుంది.
మేము మా GitHub రిపోజిటరీలోని ప్రత్యేక ఫైల్‌లో Autoprefixer ద్వారా మద్దతు ఇచ్చే బ్రౌజర్‌ల జాబితాను నిర్వహిస్తాము. వివరాల కోసం .browserslistrc చూడండి .
RTLCSS
బూట్‌స్ట్రాప్ కంపైల్ చేయబడిన CSSని ప్రాసెస్ చేయడానికి మరియు వాటిని RTLకి మార్చడానికి RTLCSSpadding-left ని ఉపయోగిస్తుంది - ప్రాథమికంగా క్షితిజ సమాంతర దిశ అవేర్ లక్షణాలను (ఉదా. ) వాటి వ్యతిరేకతతో భర్తీ చేస్తుంది. ఇది మా CSSని ఒకే సారి వ్రాయడానికి మరియు RTLCSS నియంత్రణ మరియు విలువ ఆదేశాలను ఉపయోగించి చిన్నపాటి ట్వీక్‌లను చేయడానికి మాత్రమే అనుమతిస్తుంది.
స్థానిక డాక్యుమెంటేషన్
మా డాక్యుమెంటేషన్‌ను స్థానికంగా అమలు చేయడానికి హ్యూగోను ఉపయోగించడం అవసరం, ఇది hugo-bin npm ప్యాకేజీ ద్వారా ఇన్‌స్టాల్ చేయబడుతుంది. హ్యూగో అనేది చాలా వేగంగా మరియు విస్తరించదగిన స్టాటిక్ సైట్ జనరేటర్, ఇది మాకు అందిస్తుంది: ప్రాథమికంగా, మార్క్‌డౌన్ ఆధారిత ఫైల్‌లు, టెంప్లేట్‌లు మరియు మరిన్ని. దీన్ని ఎలా ప్రారంభించాలో ఇక్కడ ఉంది:
- అన్ని డిపెండెన్సీలను ఇన్‌స్టాల్ చేయడానికి పైన ఉన్న టూలింగ్ సెటప్ ద్వారా అమలు చేయండి .
- రూట్
/bootstrapడైరెక్టరీ నుండి,npm run docs-serveకమాండ్ లైన్‌లో అమలు చేయండి. - మీ బ్రౌజర్‌లో తెరవండి
http://localhost:9001/మరియు voilà.
దాని డాక్యుమెంటేషన్ చదవడం ద్వారా హ్యూగోని ఉపయోగించడం గురించి మరింత తెలుసుకోండి .
సమస్య పరిష్కరించు
డిపెండెన్సీలను ఇన్‌స్టాల్ చేయడంలో మీకు సమస్యలు ఎదురైతే, మునుపటి డిపెండెన్సీ వెర్షన్‌లన్నింటినీ (గ్లోబల్ మరియు లోకల్) అన్‌ఇన్‌స్టాల్ చేయండి. అప్పుడు, మళ్లీ అమలు చేయండి npm install.