{"id":13612479,"url":"https://github.com/jekyll/jekyll-sass-converter","last_synced_at":"2025-04-10T23:27:27.880Z","repository":{"id":13551533,"uuid":"16243570","full_name":"jekyll/jekyll-sass-converter","owner":"jekyll","description":"A Sass converter for Jekyll.","archived":false,"fork":false,"pushed_at":"2025-02-02T13:28:59.000Z","size":230,"stargazers_count":189,"open_issues_count":5,"forks_count":135,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-03T14:45:05.578Z","etag":null,"topics":["jekyll-plugin","sass"],"latest_commit_sha":null,"homepage":"http://rubygems.org/gems/jekyll-sass-converter","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jekyll.png","metadata":{"files":{"readme":"README.md","changelog":"History.markdown","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-01-26T00:42:50.000Z","updated_at":"2025-03-31T02:10:32.000Z","dependencies_parsed_at":"2023-02-18T09:46:02.665Z","dependency_job_id":"e20817e5-7d24-479d-ad47-a6153fdea468","html_url":"https://github.com/jekyll/jekyll-sass-converter","commit_stats":{"total_commits":232,"total_committers":20,"mean_commits":11.6,"dds":0.6336206896551724,"last_synced_commit":"bf48f64b40fa5f9368ec243c680c6f13da695e88"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-sass-converter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-sass-converter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-sass-converter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-sass-converter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jekyll","download_url":"https://codeload.github.com/jekyll/jekyll-sass-converter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248314111,"owners_count":21082990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["jekyll-plugin","sass"],"created_at":"2024-08-01T20:00:30.547Z","updated_at":"2025-04-10T23:27:27.862Z","avatar_url":"https://github.com/jekyll.png","language":"Ruby","funding_links":[],"categories":["Assets \u0026 Converters \u0026 Minifiers","Ruby"],"sub_categories":[],"readme":"# Jekyll Sass Converter\n\nLet Jekyll build your Sass and SCSS!\n\n[![Continuous Integration](https://github.com/jekyll/jekyll-sass-converter/actions/workflows/ci.yml/badge.svg)](https://github.com/jekyll/jekyll-sass-converter/actions/workflows/ci.yml)\n\n\n## Installation\n\n**Jekyll Sass Converter requires Jekyll 2.0.0 or greater and is bundled\nwith Jekyll so you don't need to install it if you're already using Jekyll.**\n\nAdd this line to your application's Gemfile:\n\n    gem 'jekyll-sass-converter'\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install jekyll-sass-converter\n\n## Usage\n\nJekyll Sass Converter comes bundled with Jekyll 2.0.0 and greater. For more\ninformation about usage, visit the [Jekyll Assets Documentation\npage](https://jekyllrb.com/docs/assets/).\n\n### Sass Implementations\n\nStarting with `v3.0`, Jekyll Sass Converter uses `sass-embedded` for Sass implementation.\n\nPlease see [migrate from 2.x to 3.x](#migrate-from-2x-to-3x) for more information.\n\n#### Sass Embedded\n\n[sass-embedded](https://rubygems.org/gems/sass-embedded) is a host for the\n[Sass embedded protocol](https://github.com/sass/sass/blob/HEAD/spec/embedded-protocol.md).\n\nThe host runs [Dart Sass compiler](https://github.com/sass/dart-sass#embedded-dart-sass) as a subprocess\nand communicates with the dart-sass compiler by sending / receiving\n[protobuf](https://github.com/protocolbuffers/protobuf) messages via the standard\ninput-output channel.\n\n### Source Maps\n\nStarting with `v2.0`, the Converter will by default generate a _source map_ file along with\nthe `.css` output file. The _source map_ is useful when we use the web developers tools of\n[Chrome](https://developers.google.com/web/tools/chrome-devtools/) or\n[Firefox](https://developer.mozilla.org/en-US/docs/Tools) to debug our `.sass` or `.scss`\nstylesheets.\n\nThe _source map_ is a file that maps from the output `.css` file to the original source\n`.sass` or `.scss` style sheets. Thus enabling the browser to reconstruct the original source\nand present the reconstructed original in the debugger.\n\n### Configuration Options\n\nConfiguration options are specified in the `_config.yml` file in the following way:\n\n  ```yml\n  sass:\n    \u003coption_name1\u003e: \u003coption_value1\u003e\n    \u003coption_name2\u003e: \u003coption_value2\u003e\n  ```\n\nAvailable options are:\n\n  * **`style`**\n\n    Sets the style of the CSS-output.\n    Can be `compressed` or `expanded`.\n    See the [Sass documentation](https://sass-lang.com/documentation/js-api/types/outputstyle/)\n    for details.\n\n    Defaults to `expanded`.\n\n  * **`sass_dir`**\n\n    A filesystem-path which should be searched for Sass partials.\n\n    Defaults to `_sass`\n\n  * **`load_paths`**\n\n    An array of additional filesystem-paths which should be searched for Sass partials.\n\n    Defaults to `[]`\n\n  * **`sourcemap`**\n\n    Controls when source maps shall be generated.\n\n    - `never` \u0026mdash; causes no source maps to be generated at all.\n    - `always` \u0026mdash; source maps will always be generated.\n    - `development` \u0026mdash; source maps will only be generated if the site is in development\n      [environment](https://jekyllrb.com/docs/configuration/environments/).\n      That is, when the environment variable `JEKYLL_ENV` is set to `development`.\n\n    Defaults to `always`.\n\n  * **`quiet_deps`**\n\n    If this option is set to `true`, Sass won’t print warnings that are caused by dependencies.\n    A “dependency” is defined as any file that’s loaded through `sass_dir` or `load_paths`.\n    Stylesheets that are imported relative to the entrypoint are not considered dependencies.\n\n    Defaults to `false`.\n\n  * **`verbose`**\n\n    By default, Dart Sass will print only five instances of the same deprecation warning per\n    compilation to avoid deluging users in console noise. If you set `verbose` to `true`, it will\n    instead print every deprecation warning it encounters.\n\n    Defaults to `false`.\n\n  * **`fatal_deprecations`**\n\n    An array of deprecations or versions to treat as fatal.\n    If a deprecation warning of any provided type is encountered during compilation, the compiler will error instead.\n    If a version is provided, then all deprecations that were active in that compiler version will be treated as fatal.\n    See the [Sass documentation][sass-deprecation-docs] for all of the deprecations currently used by Sass.\n\n    Defaults to `[]`\n\n  * **`future_deprecations`**\n\n    An array of future deprecations to opt into early.\n    Future deprecations passed here will be treated as active by the compiler, emitting warnings as necessary.\n    See the [Sass documentation][sass-deprecation-docs] for all of the deprecations currently used by Sass.\n\n    Defaults to `[]`\n\n  * **`silence_deprecations`**\n\n    An array of active deprecations to ignore.\n    If a deprecation warning of any provided type is encountered during compilation, the compiler will ignore it instead.\n    See the [Sass documentation][sass-deprecation-docs] for all of the deprecations currently used by Sass.\n\n    Defaults to `[]`\n\n    [sass-deprecation-docs]: https://sass-lang.com/documentation/js-api/interfaces/deprecations/\n\n## Migrate from 2.x to 3.x\n\nClassic GitHub Pages experience still uses [1.x version of jekyll-sass-converter](https://pages.github.com/versions/).\n\nTo use latest Jekyll and Jekyll Sass Converter on GitHub Pages,\n[you can now deploy to a GitHub Pages site using GitHub Actions](https://jekyllrb.com/docs/continuous-integration/github-actions/).\n\n### Requirements\n\n- Minimum Ruby Version: `Ruby 3.1.0` (all platforms).\n\n### Dropped `implementation` Option\n\nIn `v3.0.0`, `sass-embedded` gem becomes the default Sass implementation, and `sassc` gem\nis no longer supported. As part of this change, support for Ruby 2.5 is dropped.\n\n### Dropped `add_charset` Option\n\nThe Converter will no longer emit `@charset \"UTF-8\";` or a U+FEFF (byte-order marker) for\n`sassify` and `scssify` Jekyll filters so that this option is no longer needed.\n\n### Dropped `line_comments` Option\n\n`sass-embedded` does not support `line_comments` option.\n\n### Dropped support of importing files with non-standard extension names\n\n`sass-embedded` only allows importing files that have extension names of `.sass`, `.scss`\nor `.css`. Scss syntax in files with `.css` extension name will result in a syntax error.\n\n### Dropped support of importing files relative to site source\n\nIn `v2.x`, the Converter allowed imports using paths relative to site source directory,\neven if the site source directory is not in Sass `load_paths`. This is a side effect of a\nbug in the Converter, which will remain as is in `v2.x` due to its usage in the wild.\n\nIn `v3.x`, imports using paths relative to site source directory will not work out of box.\nTo allow these imports, `.` (meaning current directory, or site source directory) need to\nbe explicitly added to `load_paths` option.\n\n### Dropped support of importing files with the same filename as their parent file\n\nIn `v2.x`, the Converter allowed imports of files with the same filename as their parent\nfile from `sass_dir` or `load_paths`. This is a side effect of a bug in the Converter,\nwhich will remain as is in `v2.x` due to its usage in the wild.\n\nIn `v3.x`, imports using the same filename of parent file will create a circular import.\nTo fix these imports, rename either of the files, or use complete relative path from the\nparent file.\n\n### Behavioral Differences in Sass Implementation\n\nPlease see https://github.com/sass/dart-sass#behavioral-differences-from-ruby-sass.\n\n## Contributing\n\n1. Fork it ( https://github.com/jekyll/jekyll-sass-converter/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjekyll%2Fjekyll-sass-converter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjekyll%2Fjekyll-sass-converter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjekyll%2Fjekyll-sass-converter/lists"}