{"id":18081980,"url":"https://github.com/mickleroy/aem-sass-compiler","last_synced_at":"2025-04-28T16:10:02.788Z","repository":{"id":57727862,"uuid":"87073902","full_name":"mickleroy/aem-sass-compiler","owner":"mickleroy","description":"Enable Sass support for AEM","archived":false,"fork":false,"pushed_at":"2024-07-07T12:40:49.000Z","size":69,"stargazers_count":50,"open_issues_count":5,"forks_count":16,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-28T16:09:55.248Z","etag":null,"topics":["aem","sass"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mickleroy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"2017-04-03T12:54:43.000Z","updated_at":"2024-12-20T15:08:08.000Z","dependencies_parsed_at":"2024-10-31T13:17:59.854Z","dependency_job_id":"bfb98889-8845-4517-b9b7-0847f02f830a","html_url":"https://github.com/mickleroy/aem-sass-compiler","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mickleroy%2Faem-sass-compiler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mickleroy%2Faem-sass-compiler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mickleroy%2Faem-sass-compiler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mickleroy%2Faem-sass-compiler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mickleroy","download_url":"https://codeload.github.com/mickleroy/aem-sass-compiler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251342724,"owners_count":21574245,"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":["aem","sass"],"created_at":"2024-10-31T13:17:41.432Z","updated_at":"2025-04-28T16:10:02.764Z","avatar_url":"https://github.com/mickleroy.png","language":"Java","funding_links":[],"categories":["Web开发"],"sub_categories":["文件同步"],"readme":"# Sass Compiler for AEM 6.1+\n\n[![Build Status](https://travis-ci.org/mickleroy/aem-sass-compiler.svg?branch=master)](https://travis-ci.org/mickleroy/aem-sass-compiler)\n\nThis bundle provides support for the [Sass](http://sass-lang.com/) CSS pre-processor in Adobe Experience Manager 6.1 or above.\n\n## Features\n\nSupports all the latest features of Sass:\n* Variables\n* Nesting\n* Partials\n* Imports\n* Mixins\n* Inheritance\n* Operators\n\nExamples of supported `@import` directives:\n```\n@import 'file';\n@import 'file.scss';\n@import 'partials/file';\n@import 'partials/file.scss';\n@import 'file1', 'file2';\n@import '/etc/designs/aem-sass-compiler/clientlib/file';\n@import '/etc/designs/aem-sass-compiler/clientlib/file.scss';\n```\n\nIf any one of the conditions below are met, the `@import` will be skipped and compiled to a CSS `@import`:\n\n* The file’s extension is .css\n* The filename begins with http://\n* The filename is a url()\n* The @import has any media queries\n\n## Supported AEM versions\n\n| AEM | Sass Compiler |\n|--|--|\n| 6.3 | 1.0.x |\n| 6.2 | 1.0.x |\n| 6.1 (SP2 only) | 0.9.x |\n\n## Installation\n\n### Via Maven (preferred)\n\n* Add the following dependency to your POM:\n```\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.mickleroy\u003c/groupId\u003e\n    \u003cartifactId\u003eaem-sass-compiler\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\u003e Note: replace \"1.0.1\" with the latest version of the compiler.\n\n* In your `content-package-maven-plugin` configuration, add an `embedded` entry for the compiler:\n```\n\u003cplugin\u003e\n    \u003cgroupId\u003ecom.day.jcr.vault\u003c/groupId\u003e\n    \u003cartifactId\u003econtent-package-maven-plugin\u003c/artifactId\u003e\n    \u003cextensions\u003etrue\u003c/extensions\u003e\n    \u003cconfiguration\u003e\n        \u003cembeddeds\u003e\n            \u003cembedded\u003e\n                \u003cgroupId\u003ecom.github.mickleroy\u003c/groupId\u003e\n                \u003cartifactId\u003eaem-sass-compiler\u003c/artifactId\u003e\n                \u003ctarget\u003e/apps/my-aem-project/install\u003c/target\u003e\n            \u003c/embedded\u003e\n        \u003c/embeddeds\u003e\n        \u003c!-- other entries... --\u003e\n    \u003c/configuration\u003e\n\u003c/plugin\u003e\n```\n\u003e Note: replace \"/apps/my-aem-project/install\" with your own project path.\n\n### Via Web Console\n\nInstall the provided OSGi bundle (.jar) in the latest [release](https://github.com/mickleroy/aem-sass-compiler/releases)\nvia the Web Console.\n\n\n## Usage\n\n* Start writing `.scss` files just like you would write `.less` files within AEM.\n```\n/etc/designs/clientlibs\n├── css.txt\n├── main.scss\n└── partials\n    └── _base.scss\n\n```\nThe `css.txt` file should only reference your main Sass file:\n```\n#base=.\nmain.scss\n```\n\n## Bundle Install Log\n\nThe following log entries should be visible when installing the bundle:\n\n```\n*INFO* [...] com.adobe.granite.ui.clientlibs.impl.CompilerProviderImpl Registering client library compiler scss\n*INFO* [...] com.github.mickleroy.aem.sass.impl.SassCompilerImpl Activating Sass Compiler\n```\n\n## Sass Compilation Log\n\nSimilar log entries should be visible when compiling a `.scss` file:\n\n```\n*INFO* [...] com.adobe.granite.ui.clientlibs.impl.HtmlLibraryManagerImpl Start building CSS library: /etc/designs/aem-sass-compiler/clientlib\n*INFO* [...] com.github.mickleroy.aem.sass.impl.SassCompilerImpl Compiled Sass in 97ms\n*INFO* [...] com.adobe.granite.ui.clientlibs.impl.HtmlLibraryManagerImpl finished building library /etc/designs/aem-sass-compiler/clientlib.css\n```\n\n## Implementation Details\n\nCurrently support LibSass version **3.4.3**.\n\n**LibSass** is a C/C++ port of the original engine written in Ruby.\nMore info at [https://github.com/sass/libsass](https://github.com/sass/libsass)\n\n**jsass** is a feature complete Java wrapper of LibSass (requires Java 8).\nMore info at [https://github.com/bit3/jsass](https://github.com/bit3/jsass)\n\n## Release\n\nCreate a release branch off the `master` branch\n```\ngit branch release/X.X.X\n```\n\nPrepare the release (use vX.X.X for the tag)\n```\nmvn release:prepare -DpushChanges=false\n```\n\nPush the changes to the repository\n```\ngit push origin\n```\n\nCheckout the newly created tag and build the project\n```\ngit checkout tags/vX.X.X\n```\n\n```\nmvn clean package\n```\n\nAttach the jar to the release on Github and merge back to `master`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmickleroy%2Faem-sass-compiler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmickleroy%2Faem-sass-compiler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmickleroy%2Faem-sass-compiler/lists"}