Moduuli, joka kääntää SASSin lennossa ja/tai tallentaa sen CSS-tiedostoihin käyttämällä node-sassia

Tämän projektin tavoitteena on kaksi asiaa:

  1. Tarjota kirjasto, joka voi kääntää SASS-tiedostot sivun latauksen yhteydessä, kun käytetään NODE_ENV=development, jotta kehitysaikaa voidaan vähentää (on-the-fly)
  2. Mahdollistaa SASS-tiedostojen kääntäminen ja tallentaminen CSS-tiedostoihin kaikissa muissa ympäristöissä, kun esim, sovellus käynnistyy tai npm-skriptillä

Sisällysluettelo

  • Tarpeet
  • Asennus
  • Esimerkki Käyttö
  • Käyttö
  • API
  • Julkaisuhuomautukset
  • Maintainer

Vaatimukset

Tämä moduuli on testattu Node.js >= 10. Se saattaa toimia Node.js <= 9:n kanssa, mutta sitä ei ole testattu.

Asenna

npm install --save compile-sass

Esimerkkikäyttö

Seuraavissa on pari esimerkkiä siitä, miten voit käyttää sitä todellisessa sovelluksessa:

  • Setup: Node.js / TypeScript
  • Konfigurointi: Node.js / TypeScript
  • Integrointi sovellukseen: Node.js / TypeScript

Käyttö

For on-the-fly compiling

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

Kannattaa huomioida compileSass.setup, joka eroaa TypeScript-muunnoksesta!

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

Vaihtoehdoilla

TypeScript
CommonJS

Kannattaa kiinnittää huomiota compileSass.setup, joka eroaa TypeScript-muunnoksesta!

Vaihtoehdot

Kääntämiseen ja tallentamiseen staattisina CSS-tiedostoina

API

compileSass()

Palauttaa käännetyn SASSin merkkijonona.

compileSassAndSave()

Kompiloi annetun SASS-tiedoston ja tallentaa sen annettuun hakemistoon.

compileSassAndSaveMultiple()

Kompiloi useita ”files”-vaihtoehdossa määriteltyjä SASS-tiedostoja. Niiden kaikkien on sijaittava ”sassPath”-vaihtoehdossa määritetyssä hakemistossa. CSS-tiedostot tallennetaan hakemistoon, joka on määritelty ”cssPath”-vaihtoehdossa.

setupCleanupOnExit()

Poistaa annetun hakemiston, kun sovellus lopetetaan. Ideana on välittää hakemisto, jossa käännetyt CSS-tiedostot ovat, jotta ne voidaan poistaa sovelluksesta poistuttaessa ja kääntää uudelleen sovelluksen käynnistyessä.

Julkaisutiedot

1.1.1

  • Turvapäivitykset

1.1.1.0

  • Lisätään ominaisuus, joka ratkaisee @import välitetyt polut, jotka alkavat ~
  • Turvallisuuspäivitykset
  • Korjataan vika, jossa asennuksen aikana välitettyjä node-sass-asetuksia ei aina käytetty

1.0.5

  • Kriittisen tietoturva-aukon korjaus

1.0.4

  • Turvapäivitykset
  • Päivittää node-sass
  • Päivittää hoek 5:n @hapi/hoek 9:ään

1.0.3

  • Korjaa rikkinäinen 1.0.2-julkaisu

1.0.2

  • Turvapäivitykset
  • Päivitä node-sass

1.0.1

  • Optimoi, mitä paketin julkaisun yhteydessä sisällytetään (ei enää testitiedostoja!)
  • Korjaa pari rikkinäistä linkkiä Readme-tiedostossa
  • Lisää LICENSE

1.0.0

  • Täydellinen uudelleenkirjoitus TypeScriptin kanssa
  • Sisällytä TypeScriptin tyypittelyt
  • Sisällytä automaattinen testaus vakauden parantamiseksi