Keni të drejtë, nuk ka vërtet ndonjë dokumentacion gjithëpërfshirës se si të përdorni Compass nga Ruby. Kjo është për të ardhur keq, por le të mos na ndalojnë detajet e vogla si dokumentacioni!

Një Përpjekje e Parë

Kur po kërkoja të bëja të njëjtën gjë, sapo hodha rreth Compass burim dhe ishte në gjendje të bashkonte këtë skenar të vogël Ruby. Në pamje të parë duket se e bën trukun:

require 'compass'
require 'sass/plugin'

compiler = Compass::Compiler.new(
    # Compass working directory
    '.',
    # Input directory
    'styles/scss',
    # Output directory
    'styles/css',
    # Compass options
    { :style => :compressed }
)

compiler.compile('test.scss', 'test.css')

Por me sa duket Compass ka një sërë opsionesh të konfigurimit të paracaktuar që nuk përfshihen automatikisht kur thirret drejtpërdrejt konstruktori i përpiluesit (një prej të cilëve është SASS load_path). Kjo mund të çojë në gabime kur përpiqeni të importoni funksionet dhe miksat e Compass, të tilla si:

gabim: Skedari për import nuk u gjet ose i palexueshëm: compass/css3

Busulla ‹1.0.0 (a.k.a. "mënyra e vjetër")

Ja se si të telefononi përpiluesin pa i anuluar ato parazgjedhje:

require 'compass'

Compass.add_configuration(
    {
        :project_path => '.',
        :sass_path => 'styles/scss',
        :css_path => 'styles/css'
    },
    'custom' # A name for the configuration, can be anything you want
)
Compass.compiler.compile('test.scss', 'test.css')

Sidoqoftë, që nga versioni 1.0.0 i Compass, Compass.compiler është zhvlerësuar në favor të Compass.sass_compiler, duke çuar në ...

Compass >=1.0.0 (a.k.a. "mënyra e re")

Falënderojmë @philipp për gjetjen e si të përdorim API-në e re, mund ta përditësojmë sërish këtë fragment për të punuar me Compass.sass_compiler:

require 'compass'
require 'compass/sass_compiler'

Compass.add_configuration(
    {
        :project_path => '.',
        :sass_path => 'styles/scss',
        :css_path => 'styles/css'
    },
    'custom' # A name for the configuration, can be anything you want
)

compiler = Compass.sass_compiler({
  :only_sass_files => [
    'styles/scss/test.scss'
  ]
})

compiler.compile!

Thjesht thirrni metodën e përpilimit nga linja e komandës. Ju mund të specifikoni çdo opsion atje. Për të parë të gjitha opsionet, ekzekutoni compass help compile.

Më poshtë është një shembull. Do të nxjerrë skedarin css të përpiluar në të njëjtën direktori si skedari test.scss.

file_name = "absolute/path/to/test.scss"
system "compass compile #{file_name} --sass-dir . --css-dir ."

Ju mund të specifikoni dhe ndërfusni sa më shumë opsione që dëshironi. Kontrolloni gjithashtu këtë për ekzekutimin e komandave në rubin:

Drejtimi i komandave të linjës së komandës brenda skriptit Ruby