v1.0.1

CLI-apuohjelma useiden SCSS-tiedostojen kääntämiseen yhdeksi CSS-tiedostoksi, jotta vältytään miljoonan CSS-tiedoston linkittämiseltä projektissa. Compile SCSS käyttää Clickiä rakentaakseen CLI-käyttöliittymänsä.

Asennus

pip install compile_scss

Käyttö

Käynnistä compile_scss

Jos compile_scss ajetaan ilman asetuksia tai lipukkeita, Compile SCSS etsii projektin juurihakemistosta tiedoston nimeltä compile_scss_config.json, johon tallennetaan JSON-olio, johon on tallennettu käyttäjän ennalta määrittämät konfiguraatioarvot.

Jos konfiguraatiotiedosto löytyy, Compile SCSS ajetaan käyttäen JSON-tiedostosta löytyvää konfiguraatiota. Jos konfiguraatiotiedostoa ei löydy, käynnistyy Read, Evaluate, Print, Loop (R.E.P.L.) ja käyttäjällä on mahdollisuus asettaa uudet konfiguraatioarvot kehotteiden avulla.

Options

--root <PROJECT_ROOT_DIRECTORY>

Vaihtoehdon --root avulla käyttäjä voi määrittää projektinsa juurihakemiston. Compile SCSS etsii kyseisestä hakemistosta compile_scss_config.json-tiedoston. >

Juurihakemiston oletuspolku on ./, mikä tarkoittaa sitä hakemistoa, josta compile_scss kutsutaan.

--set-config

Jos --set-config-lippu on läsnä, konfiguraatio R.E.P.L. käynnistyy oletusarvoisesti.

Jos konfiguraatiotiedosto löytyi, käyttäjällä on mahdollisuus joko luoda uusi konfiguraatiotiedosto tai jatkaa konfiguraatiotiedostosta löytyneillä arvoilla.

Jos konfiguraatiotiedostoa ei löytynyt, käyttäjällä on mahdollisuus luoda uusi konfiguraatiotiedosto.

--watch

Jos --watch-lippu on läsnä, Compile SCSS tarkkailee konfiguraatiotiedostossa määriteltyä SCSS-hakemistoa mahdollisten muutosten varalta ja päivittää CSS-tiedoston vastaavasti.

Konfiguraatio

Oletusarvoisesti Compile SCSS etsii projektin juurihakemistosta tiedostoa nimeltä compile_scss_config.json. Tiedoston on oltava olemassa ja sen on sisällettävä kelvollinen konfiguraatio-objekti, jotta Compile SCSS voidaan suorittaa.

Konfiguraatiotiedoston on sisällettävä viisi avainta ja vastaavat arvot:

• root – Projektin juurihakemisto. Tämän oletusarvo on ./

• scss_dir – Projektin ylimmän tason SCSS-hakemisto. Tämä hakemisto voi sisältää alihakemistoja ja niin monta SCSS-tiedostoa kuin tarvitaan. Polun scss_dir on johdettava hakemistoon, joka sisältää vähintään yhden SCSS-tiedoston, jotta se olisi kelvollinen SCSS-polku.

• css_dir – CSS-hakemisto, joka sisältää pää-CSS-tiedoston. Siellä Compile SCSS luo CSS-tulostiedostonsa.

• css_filename – Kohde-CSS-tiedoston haluttu nimi.

  Tiedostonimi ei saa sisältää muita erikoismerkkejä kuin johtamattomia/johtamattomia väliviivoja tai alaviivoja. Tiedostopäätteen on oltava pieni, mutta tiedostonimi voi sisältää isoja kirjaimia.

  Katso alla olevista esimerkeistä kelvolliset ja virheelliset tiedostonimet.

• output_style – Libsassin sass.compile() avulla CSS-tulostus voidaan kääntää yhdellä neljästä tyylistä:

  • kompakti

  • tiivistetty

  • laajennettu

  • nested

.

Validit ja epävalidit CSS-tiedostonimet

Validit

Epävalidit

Esimerkki konfigurointitiedostosta

{ "root": ".", "scss_dir": "./static/scss", "css_dir": "./static/css", "css_filename": "index.css", "output_style": "expanded"}

Compile SCSS on vielä kehitteillä. Sitä on testattu onnistuneesti mutta ei laajasti:

• Muuttujat
• @import-lausekkeet
• Funktiot (perus)
• Mixins (perus)