Source

Sestavte nástroje

Naučte se používat skripty npm zahrnuté v Bootstrapu k sestavení naší dokumentace, kompilaci zdrojového kódu, spouštění testů a dalším.

Nastavení nářadí

Bootstrap používá pro svůj systém sestavení skripty NPM . Náš package.json obsahuje pohodlné metody pro práci s frameworkem, včetně kompilace kódu, spouštění testů a dalších.

Chcete-li použít náš systém sestavení a spustit naši dokumentaci lokálně, budete potřebovat kopii zdrojových souborů Bootstrapu a uzlu. Postupujte podle těchto kroků a měli byste být připraveni na rock:

  1. Stáhněte a nainstalujte Node.js , který používáme ke správě našich závislostí.
  2. Přejděte do kořenového /bootstrapadresáře a spusťte npm installinstalaci našich místních závislostí uvedených v package.json .
  3. Nainstalujte Ruby , nainstalujte Bundler s gem install bundlera nakonec spusťte bundle install. Tím se nainstalují všechny závislosti Ruby, jako je Jekyll a pluginy.
    • Uživatelé Windows: Přečtěte si tuto příručku , abyste Jekyll uvedli do provozu bez problémů.

Po dokončení budete moci spouštět různé příkazy poskytované z příkazového řádku.

Použití NPM skriptů

Náš package.json obsahuje následující příkazy a úkoly:

Úkol Popis
npm run dist npm run distvytvoří /distadresář se zkompilovanými soubory. Používá Sass , Autoprefixer a UglifyJS .
npm test Stejně jako npm run distplus spouští testy lokálně
npm run docs Vytváří a propojuje CSS a JavaScript pro dokumenty. Dokumentaci pak můžete spustit lokálně pomocí npm run docs-serve.

Spuštěním npm runzobrazíte všechny skripty npm.

Autoprefixer

Bootstrap používá Autoprefixer (zahrnutý v našem procesu sestavování) k automatickému přidávání předpon dodavatele k některým vlastnostem CSS v době sestavování. To nám šetří čas a kód, protože nám umožňuje psát klíčové části našeho CSS jednou a zároveň eliminuje potřebu mixů výrobců, jako jsou ty, které se nacházejí ve verzi 3.

Seznam prohlížečů podporovaných prostřednictvím Autoprefixer udržujeme v samostatném souboru v našem úložišti GitHub. Podrobnosti najdete v /package.json .

Místní dokumentace

Spuštění naší dokumentace lokálně vyžaduje použití Jekyll, slušně flexibilního generátoru statických stránek, který nám poskytuje: základní zahrnutí, soubory založené na Markdown, šablony a další. Zde je návod, jak to začít:

  1. Projděte nastavením nástrojů výše a nainstalujte Jekyll (tvůrce webu) a další závislosti Ruby s bundle install.
  2. Z kořenového /bootstrapadresáře spusťte npm run docs-servev příkazovém řádku.
  3. Otevřete http://localhost:9001v prohlížeči a voilà.

Další informace o používání Jekyll naleznete v jeho dokumentaci .

Odstraňování problémů

Pokud narazíte na problémy s instalací závislostí, odinstalujte všechny předchozí verze závislostí (globální i místní). Poté spusťte znovu npm install.