Posted on

compile-scss 1.0.1

, Author

v1.0.1

プロジェクト内で百万の CSS ファイルをリンクしないように、複数の SCSS ファイルを単一の CSS ファイルにコンパイルする CLI ユーティリティです。

Installation

pip install compile_scss

Usage

Run compile_scss

compile_scss がいかなるオプションやフラグなしに実行されると、Compile SCSS はプロジェクトのルートディレクトリで compile_scss_config.json ファイルという名の、ユーザーの定義済みの設定値を含む JSON オブジェクトを検索するようになる。

設定ファイルが見つかった場合、Compile SCSS は JSON ファイルにある設定を使用して実行されます。

Options

--root <PROJECT_ROOT_DIRECTORY>

--root オプションにより、ユーザーはプロジェクトのルート ディレクトリを指定することができます。 Compile SCSS はそのディレクトリを検索して compile_scss_config.json ファイルを探します。 >

ルートディレクトリへのデフォルトパスは ./ で、これは compile_scss が呼び出されるディレクトリに変換されます。

--set-config

もし --set-config フラグが存在すれば、設定 R.E.P.L.はデフォルトでトリガーされます。

設定ファイルが見つかった場合、ユーザーは新しい設定ファイルを作成するか、設定ファイルに見つかった値で継続するかのいずれかを選択することができます。

設定ファイルが見つからなかった場合、ユーザーは新しい設定ファイルを作成することができます。

--watch

--watch flag が存在する場合、Compile SCSS は設定ファイル内で指定した SCSS ディレクトリに何らかの変更がないか監視し、それに応じて CSS ファイルを更新します。

Configuration

デフォルトでは、Compile SCSS はプロジェクトのルートディレクトリにある compile_scss_config.json という名前のファイルを探します。

設定ファイルには 5 つのキーとそれに対応する値が含まれていなければなりません。 このデフォルト値は ./

  • scss_dir – プロジェクトのトップレベルの SCSS ディレクトリです。 このディレクトリはサブディレクトリと必要なだけの SCSS ファイルを含むことができます。 scss_dir パスは、有効な SCSS パスであるために、少なくとも 1 つの SCSS ファイルを含むディレクトリに通じていなければなりません。

  • css_dir – メイン CSS ファイルがある CSS ディレクトリです。

  • css_filename – ターゲット CSS ファイルの名前。 ファイル拡張子は小文字でなければなりませんが、ファイル名には大文字を含めることができます。

    有効なファイル名と無効なファイル名については、以下の例を参照してください。

  • output_style – Libsass の sass.compile() では、CSS 出力を 4 つのスタイルのうち 1 つにコンパイルすることができます。

    • compact

    • compressed

    • expanded

    • nested

    • companded

    • 有効な CSS ファイル名と無効な CSS ファイル名

    有効

    無効

    設定ファイルの例

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

    Compile SCSS はまだ開発中である。

    • Variables
    • @import statements
    • Functions (basic)
    • Mixin (basic)

    でテストされていますが、広範なものではありません。

    コメントを残す

    メールアドレスが公開されることはありません。