in English

సాధనాలను నిర్మించండి

మా డాక్యుమెంటేషన్‌ను రూపొందించడానికి, సోర్స్ కోడ్‌ను కంపైల్ చేయడానికి, పరీక్షలను అమలు చేయడానికి మరియు మరిన్నింటికి బూట్‌స్ట్రాప్‌లో చేర్చబడిన npm స్క్రిప్ట్‌లను ఎలా ఉపయోగించాలో తెలుసుకోండి.

టూలింగ్ సెటప్

బూట్‌స్ట్రాప్ దాని బిల్డ్ సిస్టమ్ కోసం npm స్క్రిప్ట్‌లను ఉపయోగిస్తుంది. కోడ్‌ను కంపైల్ చేయడం, రన్నింగ్ పరీక్షలు మరియు మరిన్నింటితో సహా ఫ్రేమ్‌వర్క్‌తో పని చేయడానికి మా ప్యాకేజీ .json అనుకూలమైన పద్ధతులను కలిగి ఉంది.

మా బిల్డ్ సిస్టమ్‌ను ఉపయోగించడానికి మరియు మా డాక్యుమెంటేషన్‌ను స్థానికంగా అమలు చేయడానికి, మీకు బూట్‌స్ట్రాప్ యొక్క సోర్స్ ఫైల్‌లు మరియు నోడ్ కాపీ అవసరం. ఈ దశలను అనుసరించండి మరియు మీరు రాక్ చేయడానికి సిద్ధంగా ఉండాలి:

  1. మేము మా డిపెండెన్సీలను నిర్వహించడానికి ఉపయోగించే Node.jsని డౌన్‌లోడ్ చేసి, ఇన్‌స్టాల్ చేయండి .
  2. బూట్‌స్ట్రాప్ మూలాలను డౌన్‌లోడ్ చేయండి లేదా బూట్‌స్ట్రాప్ రిపోజిటరీని ఫోర్క్ చేయండి .
  3. /bootstrapరూట్ డైరెక్టరీకి నావిగేట్ చేయండి మరియు ప్యాకేజీnpm install .json లో జాబితా చేయబడిన మా స్థానిక డిపెండెన్సీలను ఇన్‌స్టాల్ చేయడానికి అమలు చేయండి .

పూర్తయినప్పుడు, మీరు కమాండ్ లైన్ నుండి అందించిన వివిధ ఆదేశాలను అమలు చేయగలరు.

npm స్క్రిప్ట్‌లను ఉపయోగించడం

మా package.json కింది ఆదేశాలు మరియు టాస్క్‌లను కలిగి ఉంటుంది:

టాస్క్ వివరణ
npm run dist npm run dist/dist/కంపైల్ చేసిన ఫైళ్ళతో డైరెక్టరీని సృష్టిస్తుంది . Sass , Autoprefixer మరియు terserలను ఉపయోగిస్తుంది .
npm test పరిగెత్తిన తర్వాత స్థానికంగా పరీక్షలను అమలు చేస్తుందిnpm run dist
npm run docs-serve స్థానికంగా డాక్యుమెంటేషన్‌ను రూపొందించి, అమలు చేస్తుంది.

npm runఅన్ని npm స్క్రిప్ట్‌లను చూడటానికి రన్ చేయండి.

మా స్టార్టర్ ప్రాజెక్ట్‌తో npm ద్వారా బూట్‌స్ట్రాప్‌తో ప్రారంభించండి! మీ స్వంత npm ప్రాజెక్ట్‌లో బూట్‌స్ట్రాప్‌ను ఎలా నిర్మించాలో మరియు అనుకూలీకరించాలో చూడటానికి twbs/bootstrap-npm-starter టెంప్లేట్ రిపోజిటరీకి వెళ్లండి . Sass కంపైలర్, ఆటోప్రెఫిక్సర్, స్టైలింట్, PurgeCSS మరియు బూట్‌స్ట్రాప్ చిహ్నాలను కలిగి ఉంటుంది.

సాస్

బూట్‌స్ట్రాప్ v4 మా సాస్ సోర్స్ ఫైల్‌లను CSS ఫైల్‌లుగా కంపైల్ చేయడానికి నోడ్ సాస్‌ని ఉపయోగిస్తుంది (మా బిల్డ్ ప్రాసెస్‌లో చేర్చబడింది). మీ స్వంత ఆస్తి పైప్‌లైన్‌ని ఉపయోగించి Sassని కంపైల్ చేసేటప్పుడు అదే ఉత్పత్తి చేయబడిన CSSతో ముగించడానికి, మీరు కనీసం Node Sass చేసే ఫీచర్‌లకు మద్దతిచ్చే Sass కంపైలర్‌ను ఉపయోగించాలి. అక్టోబరు 26, 2020 నాటికి, LibSass మరియు నోడ్ సాస్‌తో సహా దాని పైన నిర్మించబడిన ప్యాకేజీలు నిలిపివేయబడినందున ఇది గమనించడం ముఖ్యం .

మీకు కొత్త Sass లక్షణాలు లేదా కొత్త CSS ప్రమాణాలతో అనుకూలత అవసరమైతే, Dart Sass ఇప్పుడు Sass యొక్క ప్రాథమిక అమలు మరియు Node Sass (డార్ట్ సాస్ యొక్క GitHub పేజీలో జాబితా చేయబడిన కొన్ని మినహాయింపులతో ) పూర్తిగా అనుకూలంగా ఉండే JavaScript APIకి మద్దతు ఇస్తుంది.

బ్రౌజర్ రౌండింగ్‌తో సమస్యలను నివారించడానికి మేము Sass రౌండింగ్ ఖచ్చితత్వాన్ని 6కి పెంచుతాము (డిఫాల్ట్‌గా, ఇది నోడ్ సాస్‌లో 5). మీరు డార్ట్ సాస్‌ని ఉపయోగిస్తే, ఇది మీరు సర్దుబాటు చేయవలసిన అవసరం లేదు, ఎందుకంటే ఆ కంపైలర్ 10 యొక్క రౌండింగ్ ఖచ్చితత్వాన్ని ఉపయోగిస్తుంది మరియు సమర్థతా కారణాల వల్ల దీన్ని సర్దుబాటు చేయడానికి అనుమతించదు.

ఆటోప్రిఫిక్సర్

బిల్డ్ సమయంలో కొన్ని CSS లక్షణాలకు స్వయంచాలకంగా విక్రేత ప్రిఫిక్స్‌లను జోడించడానికి బూట్‌స్ట్రాప్ Autoprefixer (మా బిల్డ్ ప్రాసెస్‌లో చేర్చబడింది) ఉపయోగిస్తుంది. అలా చేయడం వల్ల v3లో కనిపించే వాటి వంటి వెండర్ మిక్సిన్‌ల అవసరాన్ని తొలగిస్తూ మన CSS యొక్క కీలక భాగాలను ఒకే సారి వ్రాయడానికి అనుమతించడం ద్వారా మాకు సమయం మరియు కోడ్ ఆదా అవుతుంది.

మేము మా GitHub రిపోజిటరీలోని ప్రత్యేక ఫైల్‌లో Autoprefixer ద్వారా మద్దతు ఇచ్చే బ్రౌజర్‌ల జాబితాను నిర్వహిస్తాము. వివరాల కోసం .browserslistrc చూడండి .

స్థానిక డాక్యుమెంటేషన్

మా డాక్యుమెంటేషన్‌ను స్థానికంగా అమలు చేయడానికి హ్యూగోను ఉపయోగించడం అవసరం, ఇది hugo-bin npm ప్యాకేజీ ద్వారా ఇన్‌స్టాల్ చేయబడుతుంది. హ్యూగో అనేది చాలా వేగంగా మరియు విస్తరించదగిన స్టాటిక్ సైట్ జనరేటర్, ఇది మాకు అందిస్తుంది: ప్రాథమికంగా, మార్క్‌డౌన్ ఆధారిత ఫైల్‌లు, టెంప్లేట్‌లు మరియు మరిన్ని. దీన్ని ఎలా ప్రారంభించాలో ఇక్కడ ఉంది:

  1. అన్ని డిపెండెన్సీలను ఇన్‌స్టాల్ చేయడానికి పైన ఉన్న టూలింగ్ సెటప్ ద్వారా అమలు చేయండి .
  2. రూట్ /bootstrapడైరెక్టరీ నుండి, npm run docs-serveకమాండ్ లైన్‌లో అమలు చేయండి.
  3. మీ బ్రౌజర్‌లో తెరవండి http://localhost:9001/మరియు voilà.

దాని డాక్యుమెంటేషన్ చదవడం ద్వారా హ్యూగోని ఉపయోగించడం గురించి మరింత తెలుసుకోండి .

సమస్య పరిష్కరించు

డిపెండెన్సీలను ఇన్‌స్టాల్ చేయడంలో మీకు సమస్యలు ఎదురైతే, మునుపటి డిపెండెన్సీ వెర్షన్‌లన్నింటినీ (గ్లోబల్ మరియు లోకల్) అన్‌ఇన్‌స్టాల్ చేయండి. అప్పుడు, మళ్లీ అమలు చేయండి npm install.