Modul pro kompilaci SASS za chodu a/nebo jeho ukládání do souborů CSS pomocí node-sass

Cíl tohoto projektu je dvojí:

  1. poskytnout knihovnu, která dokáže kompilovat soubory SASS při načítání stránky při použití NODE_ENV=development, aby se zkrátila doba vývoje (on-the-fly)
  2. umožnit kompilaci a ukládání souborů SASS do souborů CSS ve všech ostatních prostředích, když např, spuštění aplikace nebo pomocí skriptu npm

Obsah

  • Požadavky
  • Instalace
  • Příklad Použití
  • Použití
  • API
  • Poznámky k vydání
  • Maintainer

Požadavky

Tento modul je testován s Node.js >= 10. Může fungovat i s Node.js <= 9, ale není testován.

Instalovat

npm install --save compile-sass

Příklad použití

Následujících několik příkladů použití v reálné aplikaci:

  • Nastavení: Node.js / TypeScript
  • Konfigurace: Node.js / TypeScript
  • Integrace do aplikace: Node.js / TypeScript

Použití

Pro kompilaci za běhu

TypeScript
import compileSass from 'compile-sass';
app.use('/css/:cssName', compileSass());
CommonJS

Věnujte pozornost compileSass.setup, která se liší od varianty TypeScript!

const compileSass = require('compile-sass');
app.use('/css/:cssName', compileSass.setup());

S možnostmi

TypeScript
CommonJS

Věnujte pozornost compileSass.setup, která se liší od varianty TypeScript!

Možnosti

Pro kompilaci a ukládání jako statické soubory CSS

API

compileSass()

Vrací zkompilovaný SASS jako řetězec.

compileSassAndSave()

Zkompiluje zadaný soubor SASS a uloží jej do zadaného adresáře.

compileSassAndSaveMultiple()

Zkompiluje více souborů SASS definovaných ve volbě „files“. Všechny musí být umístěny v adresáři definovaném v parametru „sassPath“. Soubory CSS budou uloženy v adresáři definovaném v možnosti „cssPath“.

setupCleanupOnExit()

Smaže předaný adresář při ukončení aplikace. Smyslem je předat adresář, kde jsou zkompilované soubory CSS, aby mohly být při ukončení aplikace smazány a při spuštění aplikace znovu zkompilovány.

Poznámky k verzi

1.1.1

  • Aktualizace zabezpečení

1.1.0

  • Přidána funkce pro řešení cest předaných do @import, které začínají na ~
  • Aktualizace zabezpečení
  • Oprava chyby, kdy nebyly vždy použity volby node-sass předané při nastavení

1.0.5

  • Oprava kritické bezpečnostní chyby

1.0.4

  • Aktualizace zabezpečení
  • Aktualizace node-sass
  • Aktualizace hoek 5 na @hapi/hoek 9

1.0.3

  • Oprava nefunkční verze 1.0.2

1.0.2

  • Aktualizace zabezpečení
  • Aktualizace node-sass

1.0.1

  • Optimalizovat to, co je obsaženo při publikování balíčku (už žádné testovací soubory!)
  • Opravit několik nefunkčních odkazů v Readme
  • Vložit LICENCI

1. díl.0.0

  • Úplné přepsání pomocí TypeScriptu
  • Vložit typování pro TypeScript
  • Vložit automatizované testování pro lepší stabilitu

.