[support req] Tips for development/debugging process of a compass extension? about compass-extension-template HOT 2 OPEN

Let's take a quick look at my codebase for Toolkit as an example of how I develop Compass extensions.

You'll see that the project as a whole is a Compass project, with the standard Sass and Stylesheets folders, as well as a non-standard one called Compass. The Compass folder is this project (more or less); it contains all of the information for my compass extension. Inside my Sass folder, I've got screen.scss that has @import "../compass/stylesheets/toolkit"; at the top, importing my Compass extensions' primary partial so I can use it and debug it. Alternatively, I could have added include 'compass/stylesheets' to my config.rb file and instead done @import "toolkit" in my screen.scss folder. I run compass watch on root and work/debug from there.

A couple things to note with this workflow. First, if you've got any Compass Extension requirements, they need to be required in your config.rb file. Second, likewise, if you're building any Ruby code, the same needs to be in your config.rb. Third, because Compass is outside of the Sass folder, changes made to files inside will not automatically recompile unless a file inside the Sass folder is saved. The last one can probably be remedied simply by moving the Compass folder inside of the Sass folder, or potentially symlinking the Sass folder and the Extension's Stylesheets folder, but for now I make due as is.

Hope this helps!

from compass-extension-template.

Thank you for such a detailed reply!

Do i understand it correctly that what compass documentation means by the extension folder is the same what you you mean by a compass subfolder?

And one can import the extension with a simple @import directive as if it were one of his project's partials? (The second import method that you mention looks neater to me though!)

Thank you for all the useful hints!

But what does this hint from Compass docs mean?

Never specify an extension in your imports as this can cause issue when the syntax of a file changes.

Another question. Only the content of the compass subfolder is bundled when the extension is finished, right?

from compass-extension-template.