Compare commits

...

570 Commits

Author SHA1 Message Date
Chris Eppstein
1dd2563484 Use the default compass images directory in the spriting tutorial 2011-09-16 15:20:42 -07:00
Chris Eppstein
37c58300c0 Merge pull request #540 from boriskaiser/stable
update PIE.htc to Version 1.0beta4
2011-09-16 15:19:22 -07:00
Eric Meyer
7fced9373e added detail to rhythm-border documentation. 2011-09-12 14:38:36 -06:00
Eric Meyer
92981fb5d3 Merge pull request #509 from ericam/stable
user-select mixin with docs and tests
2011-09-12 13:23:30 -07:00
Eric Meyer
f4d1a8255c changelog for user-select 2011-09-12 14:18:15 -06:00
Eric Meyer
aef3c5a07e Merge branch 'stable' of github.com:chriseppstein/compass into stable 2011-09-12 14:04:24 -06:00
Chris Eppstein
93811a66c4 Merge pull request #548 from brikou/patch-1
removed useless unit
2011-09-11 23:45:00 -07:00
Brikou CARRE
a8ff39a8e4 removed useless unit 2011-09-12 09:34:45 +03:00
Boris Kaiser
6dbce65e32 update PIE.htc to Version 1.0beta5 2011-09-11 09:23:39 +02:00
Boris Kaiser
2691312067 update PIE.htc to Version 1.0beta4 2011-08-19 13:27:00 +02:00
Eric Meyer
d0067d7122 user-select mixin with docs and tests 2011-08-08 23:04:24 -04:00
Scott Davis
cdf11d7002 Merge pull request #485 from adamnbowen/patch-1
trivial documentation change
2011-07-25 23:24:42 -07:00
Scott Davis
0de35e6d2b Merge pull request #479 from dbussink/stable
Use more lenient timing, fixes feature on Rubinius
2011-07-25 23:07:08 -07:00
Adam Bowen
84e3746325 "to the right" doesn't make sense with how the page is laid out
"listed below the display value" is a bit more relevant to the current documentation layout
2011-07-20 16:05:47 -07:00
Dirkjan Bussink
45db63c35e Use more lenient timing, fixes feature on Rubinius 2011-07-18 23:01:25 +02:00
Chris Eppstein
04800afc63 Version Bump. 2011-07-10 17:32:41 -07:00
Chris Eppstein
5b540f070d Update changelog for 0.11.5 2011-07-10 17:32:20 -07:00
Irina Dumitrascu
07819ccfbd Reset only the block HTML elements #339
- used elements-of-type(html5-block) in all the reset stylesheets
  (instead of duplicate tag enumerations)
- removed dialog
- canvas is inline, not block

Closes GH-339, GH-462.
2011-07-10 17:26:23 -07:00
Scott Davis
ff94ab79c9 Merge pull request #468 from ericam/stable
fix warning logic in vertical-rhythms module
2011-07-09 22:41:54 -07:00
Eric Meyer
a4b35e7515 fix warning logic in vertical-rhythms module 2011-07-09 14:17:30 -06:00
Dirkjan Bussink
42bb556329 Fix failing test when updating to latest SASS
This makes rake test green on Rubinius, 1.8.7 and 1.9.2.
Removed the Gemfile.lock in the previous version so everything
can be updated.

Closes GH-456.
2011-07-03 14:13:08 -07:00
Dirkjan Bussink
10168fe147 Gemfile.lock should not be part of a library / gem
http://yehudakatz.com/2010/12/16/clarifying-the-roles-of-the-gemspec-and-gemfile/
2011-07-03 14:12:10 -07:00
Chris Eppstein
0257a58eea Merge pull request #455 from twalpole/transition_typo
fix typo
2011-07-03 11:00:29 -07:00
Thomas Walpole
7a814581e7 fix typo 2011-07-03 10:48:43 -07:00
Chris Eppstein
539f206e51 Fix issue with parent directory references within the sass_path in the compass compiler.
Closes GH-409.
2011-07-03 10:45:33 -07:00
Chris Eppstein
432309d1a7 Version bump. 2011-07-03 00:32:59 -07:00
Chris Eppstein
27c8dfbee8 Update changelog 2011-07-03 00:32:12 -07:00
Chris Eppstein
b8b6af9d49 Return a non-zero exit code if there are any stylesheet compilation errors. Closes GH-432. 2011-07-03 00:18:58 -07:00
Chris Eppstein
23d3d341de Fix test failures. 2011-07-02 22:51:26 -07:00
Chris Eppstein
36f2e56f1c Better docs for the shadow mixins. Closes GH-433. 2011-07-02 22:08:00 -07:00
Matt Fawcett
b2b9d57505 Include the Compass logger to prevent "uninitialized constant Compass::Logger"
Closes GH-438.
2011-07-02 21:59:09 -07:00
Stafford Brooke
842e877bc0 Broken link fixed to what I think is the correct section of the SASS docs.
Closes GH-435.
2011-07-02 21:25:38 -07:00
Lorin Tackett
8d8d3eecbc grid-background vertical rhythm should be based off of $blueprint-font-size, rather than a static value.
Closes GH-429.
2011-07-02 21:21:35 -07:00
ltackett
d7115caad6 :focus should not use shorthand border property, since it only need to change the border-color
Closes GH-367.
2011-07-02 21:17:22 -07:00
Chris Eppstein
efb484778d update changelog 2011-07-02 21:09:04 -07:00
Costin Bereveanu
3b18b72d64 Fix absolute path detection on Windows.
Closes GH-451.
2011-07-02 21:07:49 -07:00
Chris Eppstein
b7e66a7658 Fix the mime type returned for svg images. Closes GH-442. 2011-07-02 20:57:24 -07:00
Chris Eppstein
ab270c1adb Fix edge case issue when there's no cache location. 2011-07-02 18:05:02 -07:00
Chris Eppstein
349e29f7ca Fix broken test. 2011-07-02 17:54:38 -07:00
German M. Bravo
8837b0a347 Transitions accepting multiple transitions separated by commas 2011-07-02 17:50:46 -07:00
Glenn McLelland
239e43b4e0 Added force-wrap mixin to prevent URLs and long lines of text from breaking layouts.
Closes GH-321
2011-07-02 17:42:37 -07:00
Chris Eppstein
87c79bcfb6 update the font-face example 2011-07-02 10:34:20 -07:00
Chris Eppstein
7ffe2c3a64 Update CHANGELOG 2011-07-01 22:20:42 -07:00
Chris Eppstein
89ad638a1d When the unit is in pixels, round down in the leader and up in the trailer. 2011-07-01 22:16:29 -07:00
Chris Eppstein
157c2e0518 Ensure there is a minimum of padding in each line when calculating how many lines are needed. 2011-07-01 22:16:29 -07:00
Chris Eppstein
6d2040b86a Support absolute font sizing in the vertical rhythm module 2011-07-01 22:16:29 -07:00
Chris Eppstein
94af47d1ca Update homepage 2011-06-30 18:04:40 -07:00
Chris Eppstein
b6fef2fae9 Merge pull request #447 from nimbupani/msfilter
Removing -ms-filter as it drives IE9+ crazy. plus existing filter works a
2011-06-28 23:06:26 -07:00
Divya Manian
ff61678572 Adding the generated css files from the msfilter change 2011-06-28 23:00:56 -07:00
Divya Manian
461a589a61 Removing -ms-filter as it drives IE9+ crazy. plus existing filter works anyway for IE9- 2011-06-28 22:19:39 -07:00
Chris Eppstein
6d2f7f41e5 In case you want to buy stuff. 2011-06-25 12:01:43 -07:00
Scott Davis
ec29ec4b33 Merge pull request #439 from travis-ci/pull-gemfile
Update Gemfile to use rake 0.8.7
2011-06-21 09:03:38 -07:00
Sven Fuchs
6170ab119f Update Gemfile to use rake 0.8.7
rake 0.9.x won't be compatible with Cucumber::Rake::Task::ForkedCucumberRunner which uses the RUBY constant, resulting in 'uninitialized constant Cucumber::Rake::Task::ForkedCucumberRunner::RUBY'
2011-06-21 16:51:49 +02:00
Chris Eppstein
852f033160 Handle pathnames being assigned to the working path of a command.
Closes GH-434.
2011-06-19 12:56:01 -07:00
Chris Eppstein
82d739f4dd Fix docs 2011-06-19 12:56:01 -07:00
Chris Eppstein
1d32683b5d Fix compass version in the docs. 2011-06-19 12:56:00 -07:00
Scott Davis
c8cb9f2e39 Merge pull request #430 from backspace/patch-1
Fixed typo
2011-06-13 19:31:28 -07:00
backspace
569abeedb2 Fixed typo 2011-06-13 19:20:08 -07:00
Scott Davis
84f7b7a5ef added docs for chunky_png_options config 2011-06-12 15:16:20 -04:00
Scott Davis
dc504ecd8e pass new config options to chunky_png canvas on image save 2011-06-12 13:37:20 -04:00
Scott Davis
db74d8bdb3 new config option to pass options along to chunky_png 2011-06-12 13:36:49 -04:00
Scott Davis
6712c65ce7 Merge branch 'stable' of github.com:chriseppstein/compass into stable 2011-06-12 02:56:27 -04:00
Scott Davis
6bb9904834 forgot to add features to the ci file 2011-06-12 02:55:36 -04:00
Chris Eppstein
2d81e0a506 Fix bug 2011-06-11 23:45:00 -07:00
Chris Eppstein
a6a80221ee update test for pie-clearfix 2011-06-11 23:35:29 -07:00
Chris Eppstein
6ca90dccc3 Update changelog for clearfix 2011-06-11 23:27:38 -07:00
Chris Eppstein
809394a1e9 make the micro-clearfix a replacement for pie-clearfix. Add a new legacy-pie-clearfix for users who still need the old clearfix. 2011-06-11 23:27:38 -07:00
Scott Davis
890236a8ad gemfile 2011-06-12 02:26:09 -04:00
Scott Davis
b352e8b140 test file for sprite command 2011-06-12 02:25:10 -04:00
Scott Davis
b9234e50d0 added test for sprite command and removed specs 2011-06-12 02:22:05 -04:00
Scott Davis
0f8cd61436 updated change log 2011-06-12 01:56:03 -04:00
Scott Davis
f0f231a041 Merge branch 'stable' of github.com:chriseppstein/compass into stable 2011-06-12 01:49:43 -04:00
Chris Eppstein
7d68162499 changelog updates. 2011-06-11 22:49:12 -07:00
Scott Davis
c4e3a83cda updated docs to reflect sprite hash change 2011-06-12 01:48:09 -04:00
Scott Davis
adac73a951 updated docs to reflect engine change 2011-06-12 01:47:38 -04:00
Scott Davis
41bd992a8d fixed :sprite_generated callback its now passing along the canvas 2011-06-12 01:42:38 -04:00
Scott Davis
1f17603aea Merge branch 'stable' of github.com:chriseppstein/compass into stable 2011-06-12 01:38:42 -04:00
Chris Eppstein
894e5d51a0 Merge commit 'cb6068c9a351cd43111e7a89f2c69c095a3eeec6' into stable
* commit 'cb6068c9a351cd43111e7a89f2c69c095a3eeec6':
  Adding Micro Clearfix which is new and uses less CSS than PIE Clearfix
2011-06-11 22:38:13 -07:00
Scott Davis
6b7f2c2419 updated tests 2011-06-12 01:37:44 -04:00
Scott Davis
cebe25a460 implimented engine in sprite_map 2011-06-12 01:37:21 -04:00
Scott Davis
80412b5c1d added engine to sprite_map 2011-06-12 01:35:50 -04:00
Scott Davis
b6cf4f5213 refactored engine to be a class and turned on best compression for chunky_png 2011-06-12 01:35:19 -04:00
Scott Davis
6f95c9d17a added canvas to engine 2011-06-12 01:34:33 -04:00
Chris Eppstein
fa165a3d84 bump chunky_png version dependency. 2011-06-11 22:28:56 -07:00
Chris Eppstein
39df74c55a Add a new command to clean up generated files 2011-06-11 22:28:38 -07:00
Chris Eppstein
2be7567bb2 Better error message when a sub command is missing. 2011-06-11 21:54:56 -07:00
Chris Eppstein
ab25ba0b40 Code cleanup 2011-06-11 21:54:32 -07:00
Chris Eppstein
c069babe76 log removal actions in the compiler output. 2011-06-11 21:54:12 -07:00
Scott Davis
7454e522a5 engine abstract 2011-06-12 00:52:36 -04:00
Scott Davis
3d4a57c3c1 engine test 2011-06-12 00:52:05 -04:00
Scott Davis
a6ea065eaa split sprite map class into modules for easy reading it was way to long 2011-06-12 00:16:11 -04:00
Scott Davis
21a5a2ae3d sprite module files 2011-06-12 00:15:23 -04:00
Chris Eppstein
437842caa1 Revert "Adding changelog entry"
This reverts commit d4422d108e.
2011-06-11 19:39:33 -07:00
Chris Eppstein
40e2f330e6 Merge remote-tracking branch 'pfeiffer/cache_busting' into stable
* pfeiffer/cache_busting:
  Removing unneeded 'unquote' from tests
  Adding note about path based asset cache busting in to documentation
  Adding changelog entry
  Fix comments for asset_cache_buster
  Make asset_cache_buster return a hash with path and query, while still maintaining support for cache busting via query string if a string is returned.
  Extend cache busting to allow for path manipulation
2011-06-11 17:37:55 -07:00
Chris Eppstein
5999c7ba6c Sass and compass both have :quiet options with different meanings. So we have to separate the options out. 2011-06-11 16:49:28 -07:00
Chris Eppstein
59a6d5706d Fix a bug in the importer string representation. 2011-06-11 13:47:59 -07:00
Chris Eppstein
b3ed3705c9 fix bug in test runner 2011-06-11 12:11:00 -07:00
Chris Eppstein
ecd1efdea4 Fix for a compass validator bug due to some internal compass changes. 2011-06-11 11:33:01 -07:00
Chris Eppstein
e4a22c4cbf Fix stable version 2011-06-11 11:06:43 -07:00
Chris Eppstein
47572acc50 Spelling. 2011-06-11 10:24:17 -07:00
Chris Eppstein
69cf947cab Prepare the next release version 2011-06-10 15:59:38 -07:00
Chris Eppstein
3473e7d63a Merge branch 'stable'
* stable:
  Version Bump & Prepare for v0.11.2
  Strong tags in the docs should be bold.
  typo: appliction
  Update test case for flexible box.
  Enable IE 10 support for flexible box with the -ms prefix.
2011-06-10 15:56:46 -07:00
Chris Eppstein
00195296b8 Merge pull request #405 from dpogue/patch-1
Enable IE 10 support for flexible box with the -ms prefix.
2011-06-10 15:43:41 -07:00
Chris Eppstein
b6bec9ad62 Merge pull request #424 from tashian/master
Just a one-line doc fix of the CSS3 background attribute
2011-06-10 15:42:48 -07:00
tashian
60680769ca Fix CSS3 background attribute 2011-06-10 11:31:30 -07:00
Chris Eppstein
e2966fa78d Version Bump & Prepare for v0.11.2 2011-06-10 09:39:39 -07:00
Chris Eppstein
15412a756c Strong tags in the docs should be bold. 2011-06-10 09:35:07 -07:00
Scott Davis
9dcbbee3af Merge pull request #423 from kuroir/master
Fixes Sprites
2011-06-10 05:34:54 -07:00
Mario Kuroir Ricalde
333240de35 Fixes sprites file names with sprockets, modifies tests accordingly to new structure. 2011-06-10 05:11:28 -05:00
Scott Davis
4461f1be5f removed all cacheing from importer class it causes more problems then it was worth 2011-06-09 16:37:50 -04:00
Scott Davis
5138c94ec4 gemfile 2011-06-09 16:29:03 -04:00
Scott Davis
f248c22ab1 removed another instance cache in the importer that could be problematic 2011-06-09 16:28:10 -04:00
Scott Davis
ab5d6e51d9 updated importer to validate that sprites are png files 2011-06-09 16:27:23 -04:00
Scott Davis
7ff9ff15d0 run bundle exec when running tests 2011-06-09 16:03:58 -04:00
Scott Davis
89869db09c cleaned up some over zelious cacheing that was causing inconsistancy problems 2011-06-09 16:02:16 -04:00
Scott Davis
eb4870b685 Merge branch 'master' of github.com:chriseppstein/compass 2011-06-09 15:44:46 -04:00
Scott Davis
fc7fd8b6b4 added test for sprite importer 2011-06-09 15:44:35 -04:00
Scott Davis
b8811780ef removed unneeded cache 2011-06-09 15:44:10 -04:00
Scott Davis
7e583e5f58 readded mtime to importer class 2011-06-09 15:43:38 -04:00
Chris Eppstein
f49120c1c8 Revert "Disable 1.8.7 and rbx for now."
This reverts commit 7d90dfe4a0.
2011-06-07 11:23:06 -07:00
Chris Eppstein
bfba73c1e3 Ignore charset in blueprint files 2011-06-07 11:22:33 -07:00
Chris Eppstein
d80dde727a This file has utf-8 chars in the comments. 2011-06-07 11:10:39 -07:00
Chris Eppstein
0518f0d293 Fix encoding issue. 2011-06-07 11:10:27 -07:00
Chris Eppstein
008cffa3ef Rename the sprite Base class to SpriteMap 2011-06-07 07:51:47 -07:00
Chris Eppstein
c73d281e58 Move the sprite importer to the compass module and rename it to be more clear about what it does. 2011-06-06 18:53:35 -07:00
Chris Eppstein
dc8d8cd765 The compass watcher is in quiet mode except for important actions. 2011-06-05 15:50:43 -07:00
Chris Eppstein
3bb88271e7 Clear up a Logger class lookup issue that was reported. 2011-06-05 15:48:11 -07:00
Scott Davis
028f96131d Merge pull request #411 from bmaltzan/stable
typo: appliction
2011-06-01 09:03:12 -07:00
Brian Maltzan
10fb3814ca typo: appliction 2011-06-01 08:56:40 -07:00
Scott Davis
47ad8f17aa Merge pull request #407 from hcatlin/master
Actions should obey options[:quiet]
2011-05-30 12:25:29 -07:00
Darryl Pogue
23fc8290c0 Update test case for flexible box. 2011-05-30 11:33:55 -07:00
Hampton Catlin
3bf3ddac72 Following a similar API to how the Complier works, don't log
anything (don't even load up the logger!) if we pass in the :quiet option.

I need this because of some conflicts with Compass::Logger, being referred
to as "Logger", which seemed to be pulling out the main Logger. This is a
seperate issue, but making this options[:quiet] API functional is a nice
work-around that keeps things from getting too messy.

Tests included, obviously.
2011-05-30 16:17:28 +01:00
Hampton Catlin
9add993129 Previously, calling directory("/hi") would error, because
options would remain nil if self doesn't respond_to?(:options)

So, just double check we have something in options
2011-05-30 16:15:35 +01:00
Darryl Pogue
759692a618 Enable IE 10 support for flexible box with the -ms prefix. 2011-05-29 19:42:28 -07:00
Scott Davis
bcc3000860 moved config check to perform 2011-05-26 15:00:54 -04:00
Scott Davis
d080fdddb7 added @chriseppsteins suggestion for issue #300 2011-05-26 14:42:24 -04:00
Scott Davis
b6ca6e4efb Merge branch 'master' of github.com:chriseppstein/compass into stable 2011-05-25 11:45:27 -04:00
Scott Davis
d95149ccff forgot test files 2011-05-25 11:44:53 -04:00
Scott Davis
faba01f34c added failing test for issue #400 and fixed the callback typo closes #400 2011-05-25 11:44:13 -04:00
Scott Davis
6ba72b9533 move hashing and comparison methods into SpriteMap class 2011-05-12 23:44:21 -04:00
Scott Davis
2d797ba956 removed unneeded file 2011-05-12 23:38:57 -04:00
Scott Davis
eec6759649 refactored the sass importer for sprites 2011-05-12 23:36:59 -04:00
David Oliver
cb6068c9a3 Adding Micro Clearfix which is new and uses less CSS than PIE Clearfix 2011-05-12 23:07:54 +02:00
Scott Davis
9992a18a72 Merge branch 'master' of github.com:chriseppstein/compass into stable 2011-05-12 14:27:51 -04:00
Scott Davis
ef18040a0b typo 2011-05-11 23:22:17 -04:00
Scott Davis
d254f41696 updated sprite docs 2011-05-11 23:21:51 -04:00
Scott Davis
fc106cb379 adding creadit back I removed by mistake doing a git reset 2011-05-11 03:12:45 -04:00
Scott Davis
c83432d1c0 updated change log 2011-05-11 03:10:11 -04:00
Scott Davis
2f105f3696 made things less ambiguous 2011-05-11 02:45:26 -04:00
Scott Davis
fdd639efaf updated the regex to support nested files and refactored some unclear functions 2011-05-11 02:41:51 -04:00
Scott Davis
753ad37df7 Fixed problem with globs only going one directoy deep from now on imports like foo/*.png will get mapped to foo/**/*.png
Please enter the commit message for your changes. Lines starting
2011-05-10 22:44:10 -04:00
Scott Davis
369c8d636e forgot test files 2011-05-10 21:57:43 -04:00
Scott Davis
84d207f827 Sass Colors will no longer cause an error if you use them as sprite names. closes #381 2011-05-10 21:51:35 -04:00
Scott Davis
325306dcec Fixed and issue with the options keyword in the Sprite::Base class. it was casing the passed options to be reset to an empty hash. I renamed it to kwargs for consistancy. I also refactored my previous changes to be unobtrusive to people currently using the sprite-map function without an @import. 2011-05-10 21:04:57 -04:00
Scott Davis
80a6c90805 Revert "credit due on blog post"
This reverts commit 27d3aca067.
2011-05-10 19:22:45 -04:00
Scott Davis
4321fc0cf5 refactored to allow a per sprite cleanup 2011-05-10 19:20:38 -04:00
Scott Davis
6cb9bc2662 old sprites will now be removed by default 2011-05-10 18:02:32 -04:00
Scott Davis
8f675f936b moved test files to a more sain structure 2011-05-10 18:01:12 -04:00
Eric Meyer
27d3aca067 credit due on blog post 2011-05-09 18:34:33 -06:00
Eric Meyer
f12e92601c Merge branch 'stable' of github.com:chriseppstein/compass into stable 2011-05-09 13:14:26 -06:00
Eric Meyer
40d231948b updated author info for eric 2011-05-09 13:13:42 -06:00
Eric Meyer
93b89a20bc blog post: using compass with django 2011-05-09 11:43:17 -06:00
Chris Eppstein
26cb90e2fc Fix broken link 2011-05-05 20:59:06 -07:00
Mattias Pfeiffer
223258c203 Removing unneeded 'unquote' from tests 2011-05-05 10:19:19 +02:00
Mattias Pfeiffer
6b3ca3901c Adding note about path based asset cache busting in to documentation 2011-05-05 10:14:21 +02:00
Mattias Pfeiffer
d4422d108e Adding changelog entry 2011-05-05 10:06:48 +02:00
Mattias Pfeiffer
8661c481cf Fix comments for asset_cache_buster 2011-05-04 11:43:22 +02:00
Mattias Pfeiffer
2f3b757b46 Make asset_cache_buster return a hash with path and query, while still maintaining support for cache busting via query string if a string is returned. 2011-05-04 11:37:58 +02:00
Nathaniel Bibler
21928907e4 Extend cache busting to allow for path manipulation 2011-05-04 11:02:15 +02:00
Chris Eppstein
9b5d5b72a1 Update changelog. 2011-05-01 09:42:34 -07:00
Chris Eppstein
5ededce909 Add support for -ms gradients in background-image and background properties.
Closes GH-361.
2011-05-01 09:33:21 -07:00
Chris Eppstein
04a288ae8f Give a better error if Sass::Script::Functions.declare does not exist.
Closes GH-365.
2011-05-01 08:28:58 -07:00
Chris Eppstein
8527f5b91f A more robust approach to getting the git version. 2011-05-01 08:10:27 -07:00
Chris Eppstein
7d90dfe4a0 Disable 1.8.7 and rbx for now. 2011-04-29 07:07:44 -07:00
Chris Eppstein
ea6e15b8a4 Handle homeless users. Closes GH-364. 2011-04-29 06:50:11 -07:00
Chris Eppstein
2cafc616b6 see if this makes rubinius happy. 2011-04-28 22:02:51 -07:00
Chris Eppstein
d9e4054c7d disable some tests in jruby. 2011-04-28 21:36:33 -07:00
Chris Eppstein
8728d676db less output during cucumber tests. 2011-04-28 21:34:36 -07:00
Chris Eppstein
f115d38788 disable test in jruby. 2011-04-28 21:18:32 -07:00
Chris Eppstein
92ce8c6dbf Add a sitemap.xml for the docs. 2011-04-28 20:45:01 -07:00
Scott Davis
b107017960 merge 2011-04-28 23:11:25 -04:00
Scott Davis
275263c84c gem lock 2011-04-28 23:10:41 -04:00
Scott Davis
dc362c3fb4 moved sprite map test over 2011-04-28 23:09:43 -04:00
Scott Davis
6965005c15 bad files 2011-04-28 10:14:49 -04:00
Scott Davis
e74255635a fixed features 2011-04-28 10:13:38 -04:00
Chris Eppstein
9f3ca16962 Take specs out of default tests 2011-04-28 07:03:40 -07:00
Scott Davis
c87b0fcd2d Merge branch 'stable' of github.com:chriseppstein/compass 2011-04-28 09:06:34 -04:00
Scott Davis
3376a38f9d fixed ruby 1.9.2 bug 2011-04-28 09:05:25 -04:00
Chris Eppstein
92a4a6522b Travis CI support 2011-04-28 05:09:13 -07:00
Chris Eppstein
cd9fe91059 Merge branch 'master' into stable
* master:
  sprite test_unit
  more sprite tests to test_unit
  sprite base test
  sprite tests moved over
  fixed merge in gemfile
  diff helper
  refactored tests
  updated the sencha site graphic
  updated gemfile
  updated gemfile
  updated gemfile
  fixed merge
  added application integration to turtorials
  merge
  added redirect for reference and updated general layouts redirect

Conflicts:
	Gemfile
	Gemfile.lock
2011-04-28 05:02:18 -07:00
Chris Eppstein
880360c0c1 Bump sass dependency for development. 2011-04-28 04:58:27 -07:00
Scott Davis
5a2967fe51 sprite test_unit 2011-04-28 02:50:14 -04:00
Scott Davis
1c8804386a more sprite tests to test_unit 2011-04-28 02:49:03 -04:00
Scott Davis
8e2292b2a5 sprite base test 2011-04-28 00:35:10 -04:00
Scott Davis
3356303eb3 sprite tests moved over 2011-04-28 00:00:54 -04:00
Scott Davis
f4f9d7bfdc fixed merge in gemfile 2011-04-27 23:23:14 -04:00
Scott Davis
27809a19de Gemfile.locl 2011-04-27 23:20:29 -04:00
Scott Davis
c3845f9954 diff helper 2011-04-27 23:19:41 -04:00
Scott Davis
c317ef6870 refactored tests 2011-04-27 23:18:52 -04:00
Brandon Mathis
f3ea546150 fixed merge 2011-04-26 23:02:59 -05:00
Brandon Mathis
f86bbfc013 updated the sencha site graphic 2011-04-26 22:58:26 -05:00
Scott Davis
f1061c474b updated gemfile 2011-04-26 22:00:46 -04:00
Scott Davis
e78ddf5d72 updated gemfile 2011-04-26 21:59:20 -04:00
Scott Davis
5cdd9c6d09 updated gemfile 2011-04-26 21:52:47 -04:00
Brandon Mathis
26f44fd8a2 fixed merge 2011-04-26 18:34:51 -05:00
Brandon Mathis
7106b7d719 Merge branch 'master' of github.com:chriseppstein/compass 2011-04-26 18:30:57 -05:00
Chris Eppstein
963eb3065b Merge branch 'stable'
* stable:
  Release strategy post.
  doc gemfile changes
  Fix broken example
  charityware

Conflicts:
	doc-src/Gemfile.lock
2011-04-26 07:42:01 -07:00
Chris Eppstein
ef013a231b Release strategy post. 2011-04-26 07:40:48 -07:00
Chris Eppstein
a881b0388c doc gemfile changes 2011-04-26 07:40:34 -07:00
Chris Eppstein
63cae60ca8 Fix broken example 2011-04-25 14:46:16 -07:00
Chris Eppstein
9dc37dd93a charityware 2011-04-25 11:26:49 -07:00
Chris Eppstein
a8498835c2 Merge branch 'stable'
* stable:
  Bump version for release.
  Update gemspec to pick up the stable version of sass.
  Add comments to blog posts
  Credits.
  Bump version and assign a name.

Conflicts:
	Gemfile.lock
2011-04-25 11:09:56 -07:00
Chris Eppstein
a3a1f26ea1 Bump version for release. 2011-04-25 11:08:18 -07:00
Chris Eppstein
5528a7a51e Update gemspec to pick up the stable version of sass. 2011-04-25 11:07:27 -07:00
Chris Eppstein
4d3ca90e82 Add comments to blog posts 2011-04-24 23:29:29 -07:00
Chris Eppstein
47b8fd4b55 Credits. 2011-04-24 22:51:22 -07:00
Scott Davis
58c7447436 gemfile fix 2011-04-25 01:49:33 -04:00
Scott Davis
a58a66c4c2 added application integration to turtorials 2011-04-25 01:44:08 -04:00
Chris Eppstein
144a3b27a1 Bump version and assign a name. 2011-04-24 22:21:10 -07:00
Chris Eppstein
bb53c8c34b v0.11 release posting and docs cleanup. 2011-04-24 22:11:06 -07:00
Scott Davis
e3aa9aa424 Merge branch 'master' of github.com:chriseppstein/compass 2011-04-24 23:23:12 -04:00
Scott Davis
0d029e6a02 merge 2011-04-24 23:23:07 -04:00
Chris Eppstein
28ccff0fba Make the generated configuration file a little more readable. 2011-04-24 20:04:03 -07:00
Chris Eppstein
4957774e49 Default production mode to compressed output 2011-04-24 19:57:45 -07:00
Chris Eppstein
f775fa0ca0 Correct the CLI help on the default value of environment. 2011-04-24 19:56:29 -07:00
Chris Eppstein
5962a85a99 Fix broken linear gradients with svg enabled. 2011-04-24 18:59:07 -07:00
Chris Eppstein
85268281bc Fix failing tests due to load path changes. 2011-04-24 16:41:56 -07:00
Chris Eppstein
a997fa2332 Use expand_path to match the behavior is Sass. Fixes a bug that causes compass to always compile all files. 2011-04-24 16:04:50 -07:00
Chris Eppstein
75901f9287 Fix watcher output on the first run. 2011-04-24 16:04:50 -07:00
Chris Eppstein
a3e1fa7f78 release blog post. WIP 2011-04-24 16:04:49 -07:00
Chris Eppstein
4127ea7c9e Kick off a GC at the end of a watcher run. 2011-04-24 16:04:49 -07:00
Chris Eppstein
30e01c7cbd Clean up the creation and management of importers and compilers 2011-04-24 16:04:49 -07:00
Scott Davis
830a44868a updated docs for extension change closes#351 2011-04-23 11:14:35 -04:00
Scott Davis
59fdec521d creating an extension now responds to the -x parameter for setting syntax 2011-04-23 11:12:16 -04:00
Scott Davis
382222b6db bumped chunky_png version 2011-04-23 10:22:56 -04:00
Scott Davis
613753e06a merge 2011-04-23 10:19:40 -04:00
Scott Davis
9c8522be72 changed quotes to use syntactic sugar 2011-04-23 10:17:26 -04:00
Chris Eppstein
c7a1c2a911 Correctly report the changed file. 2011-04-22 09:37:19 -07:00
Chris Eppstein
ece275a054 Reset the memory cache before each watcher run. 2011-04-22 09:37:19 -07:00
Chris Eppstein
9e54d7bcb7 Unnecessary normalization -- sass will do it later. 2011-04-22 09:37:18 -07:00
Chris Eppstein
a8a74995bf A module to help debug memory leaks in the watcher. 2011-04-22 09:37:11 -07:00
Chris Eppstein
78dc4a5bfb Pick up bug fix in FSSM. 2011-04-21 12:32:55 -07:00
Chris Eppstein
f4ac295894 Refactor the gradient literals. 2011-04-20 22:28:46 -07:00
Chris Eppstein
9cafbc642c Consistent hashing of the Sprite importer object 2011-04-20 21:09:40 -07:00
Chris Eppstein
134160885c Store the compiler importer in the Sass options so sass doesn't make one. 2011-04-20 21:09:39 -07:00
Chris Eppstein
4c814f97dd Use Sass's Chain and Memory caching for faster caching, store this once in the configuration when watching so Sass doesn't do this with each iteration. 2011-04-20 21:09:39 -07:00
Chris Eppstein
5f1c35d171 Only compute the sass engine options once in the update_project command -- this is called repeatedly by the watcher command. 2011-04-20 21:09:39 -07:00
Scott Davis
fec367d60c fixed gemfile and removed coercion to float 2011-04-20 19:57:19 -04:00
Scott Davis
ac623c620b svg gradients now support angles 2011-04-20 19:34:20 -04:00
Scott Davis
4e502dda73 svg gradients now support angles 2011-04-20 19:33:29 -04:00
Scott Davis
8642187173 updated linier svg gradients to have userSpaceOnUse to be consistant with the radial implimentation 2011-04-20 17:17:03 -04:00
Chris Eppstein
7b0bb7ad2b Change FSSM to a gem dependency instead of vendoring it. Closes GH-343. 2011-04-19 20:00:54 -07:00
Chris Eppstein
be8e5f5313 Keep a list of blog authors in a yaml file. 2011-04-19 20:00:15 -07:00
Scott Davis
6b884d34c3 added the ability to disable magic sprites 2011-04-19 20:31:29 -04:00
Scott Davis
3e013b8bd5 removed require for bigdecimal and updated the deprecated functions in the gem file 2011-04-17 23:11:25 -04:00
Chris Eppstein
5b9a90f83b Bug fixes reported by ryan bigg. 2011-04-17 18:16:45 -07:00
Chris Eppstein
d416ee9ba1 Comment out the blog link for now. 2011-04-17 17:32:07 -07:00
Chris Eppstein
314cce80ce Merged the v0.11 beta changelog into a single cumulative changelog. 2011-04-17 17:32:07 -07:00
Eric Meyer
bc8b71b133 simple settings to toggle grids on and off while you work 2011-04-17 17:44:33 -06:00
Chris Eppstein
3921e6f856 Fix floating point comparision issue. Closes GH-341. 2011-04-17 11:38:27 -07:00
Chris Eppstein
810b95e7f3 Added a mechanism for plugins to extend compass's configuration options. 2011-04-17 11:36:16 -07:00
Chris Eppstein
b1b718e78a A basic blog for the compass website. 2011-04-17 01:49:19 -07:00
Eric Meyer
3c86dfa0b3 fixed tests related to grid-background 2011-04-16 23:48:28 -06:00
Scott Davis
d845c4d486 gradient rounding issue tentative fix 2011-04-16 22:09:42 -04:00
Chris Eppstein
86788e5ee2 Version bump 2011-04-16 01:24:13 -07:00
Chris Eppstein
791943e089 Note the new vertical rhythm function in the changelog 2011-04-16 01:23:39 -07:00
Chris Eppstein
9ce8522261 Changelog note for the pixel-based gradients in old webkits. 2011-04-16 01:10:41 -07:00
Chris Eppstein
df924ae56c Merge commit '9940ee8cbbe52e217a88b9a46ae5074790eea129'
* commit '9940ee8cbbe52e217a88b9a46ae5074790eea129':
  Adding support for pixel-stops for webkit if the gradient goes from left-to-right or top-to-bottom.

Conflicts:
	lib/compass/sass_extensions/functions/gradient_support.rb
2011-04-16 01:07:33 -07:00
Chris Eppstein
6dc7e06857 Add import for the has-layout dependency in filter-gradient. Closes GH-339. 2011-04-16 00:58:24 -07:00
Chris Eppstein
fc380ca203 It turns out that we didn't need to change the compile method's signature. Closes GH-335. 2011-04-16 00:49:17 -07:00
Chris Eppstein
c252d4b6d7 Note the new grid background module in the changelog. 2011-04-16 00:35:18 -07:00
Chris Eppstein
09868f4359 Comment the showgrid mixin. 2011-04-16 00:25:35 -07:00
Chris Eppstein
196abb2a28 Default the blueprint grid image to the pure CSS version in compass. 2011-04-16 00:21:35 -07:00
Chris Eppstein
26fe7f1074 Tell people who generate a grid background image that there's a better way. 2011-04-16 00:17:19 -07:00
Chris Eppstein
7db7e019ab Add a yellow block method for logging warnings in yellow. 2011-04-16 00:16:37 -07:00
Chris Eppstein
8a8d625a7d Add a percent-based test case for grid-backgrounds, remove unnecessary 0.001 increment. 2011-04-15 23:49:49 -07:00
Chris Eppstein
0a33bc14b2 The background-size property accepts multiple sizes corresponding to each background. 2011-04-15 23:39:46 -07:00
Chris Eppstein
72434be137 Webkit now supports the css3 official gradient syntax. 2011-04-15 23:16:43 -07:00
Scott Davis
10dd6c1c63 updated docs to be correct for magic selectors 2011-04-13 16:46:01 -04:00
Eric Meyer
d192c64889 use parens instead of quotes to pass complex argument 2011-04-12 15:16:08 -06:00
Eric Meyer
bc4e3eeb44 vertical rhythm function for calculating rhythms without returning a property 2011-04-12 15:13:42 -06:00
Eric Meyer
e66c822503 add grid-background mixins to layout module, with docs and tests 2011-04-11 19:26:55 -06:00
Chris Eppstein
7c5f831352 Bump version 2011-04-10 14:55:10 -07:00
Chris Eppstein
db9b7ada14 Update changelog for v0.11.beta.6 2011-04-10 14:54:15 -07:00
Chris Eppstein
ad0e172ec3 Allow degrees for linear and radial gradients. Currently no support for SVG gradients using degrees. Partial fix for #303 2011-04-10 14:14:44 -07:00
Scott Davis
73a01b3677 fixed issue with gem spec in rubygems 1.7 closes #331 2011-04-07 15:51:22 -04:00
Chris Eppstein
727c025881 Fix some edge case uses of color stops with list arguments. 2011-04-02 11:59:54 -07:00
Chris Eppstein
af10edd7a9 [Rails Integration] Print a warning if compass is booted more than once. Closes GH-282. 2011-04-02 10:40:32 -07:00
Andrei Bocan
c4a315af3c Check if Rails module responds to env and root before using them 2011-04-02 10:04:08 -07:00
Chris Eppstein
1bd156e88f Fix a bug in the sprites base file and added a basic sprites test case to the compass test. 2011-04-02 09:54:06 -07:00
Chris Eppstein
3892919585 Raise an error when compiling selective files from a directory other than the project directory. 2011-04-02 09:34:22 -07:00
Chris Eppstein
0eef08e6ce Remove the css3 background simple bg support and move it to a new mixin called background-with-css2-fallback. 2011-04-02 09:33:09 -07:00
Scott Davis
d2b4ec423f updated install page to have better installation instructions 2011-04-02 10:58:45 -04:00
Scott Davis
04ab1e30f2 added semi colon 2011-04-02 10:08:10 -04:00
Scott Davis
5d2db94bc0 working on lemonade upgrade guide 2011-04-02 10:07:55 -04:00
Scott Davis
428e5b513c updated spriting turtorial 2011-04-02 08:30:44 -04:00
Scott Davis
8a1f14d72d removed dynamic constant becasuse i was being a bad programer 2011-04-01 22:19:24 -04:00
Scott Davis
7ffde70c8d added test files for repeat-x bug tests 2011-04-01 16:13:29 -04:00
Scott Davis
a08003cdd9 changed sprite math back to ceil 2011-04-01 14:57:29 -04:00
Scott Davis
2c62cdf2f9 closes #296 rescue OutOfBounds exception gracfuly 2011-04-01 14:47:24 -04:00
Scott Davis
23f0f03a09 fixed sprite rsspec cli test to change back to the correct directory 2011-04-01 12:14:45 -04:00
Scott Davis
f83f85406c refactored to fix relative path bug with the compile command 2011-04-01 11:14:30 -04:00
Scott Davis
da2af62f47 closes #271 - fixed bug that was causing file name to truncate 2011-04-01 10:33:17 -04:00
Chris Eppstein
0cf4fcd8a7 We don't have a charset in fonts anymore 2011-03-30 14:24:50 -07:00
Chris Eppstein
f2ceec4680 Created a function called css2-fallback($value, $css2-value) that will use the $css2-value in a css2 context and the $value in other contexts. 2011-03-30 14:24:50 -07:00
Chris Eppstein
da57adc49d add opera support for the css3 gradient syntax 2011-03-30 14:24:50 -07:00
Scott Davis
96f1e4dc96 closes #320 and refactored the rspec tests 2011-03-29 19:26:11 -04:00
Scott Davis
4a5c968739 added rspec test for sprite command 2011-03-29 19:20:22 -04:00
Jeremy Weiskotten
36b7c25f1b fix some typos 2011-03-28 23:37:30 -04:00
Scott Davis
2e8fd055ed closes 268 - filenames can not start with numbers the must be legal css identifiers 2011-03-28 22:39:12 -04:00
Scott Davis
7571d4af93 refactored sprite selectors 2011-03-28 17:08:53 -04:00
Scott Davis
638e7e2c51 Merge branch 'master' of github.com:chriseppstein/compass 2011-03-28 17:08:36 -04:00
Chris Eppstein
ccb391d9d1 Revert "Don't output transparent in css2 ouput."
Transparent is a legal value in css2.

This reverts commit 119ce9d018.
2011-03-28 09:29:38 -07:00
Chris Eppstein
2521d4dd7b Fix broken links in the search results page. 2011-03-27 21:16:29 -07:00
Chris Eppstein
119ce9d018 Don't output transparent in css2 ouput.
Closes GH-309
2011-03-27 21:03:32 -07:00
Chris Eppstein
a7b8689fb8 Fix bug in the compact function. 2011-03-27 19:16:59 -07:00
Chris Eppstein
b91e669050 Some links on the sprites reference page to related spriting resources. 2011-03-27 19:16:28 -07:00
Scott Davis
29656eaf17 5 not 50 2011-03-26 15:36:21 -04:00
Chris Eppstein
411cdb7c2c Version Bump. 2011-03-26 12:36:03 -07:00
Scott Davis
d579c8bdcb 5 not 50 2011-03-26 15:25:47 -04:00
Scott Davis
b395552db3 chanded spritemap instance to use quick cache 2011-03-26 15:24:59 -04:00
Scott Davis
b0bfb63bb7 removed class variable 2011-03-26 13:53:50 -04:00
Scott Davis
a2200b1d83 fixed test 2011-03-26 13:46:36 -04:00
Scott Davis
27735a9537 fixed a bug that was causeing stack level too deep 2011-03-26 13:31:48 -04:00
Scott Davis
c2015635dc added some anchor tags for easy linking 2011-03-25 21:25:27 -04:00
Scott Davis
365fc5d68f im bad at typing 2011-03-25 19:05:21 -04:00
Scott Davis
3d9365ec48 screwed up a date 2011-03-25 19:02:55 -04:00
Scott Davis
ab04d6fc04 updated docs for magic selectors 2011-03-25 18:51:41 -04:00
Scott Davis
337d4da1ae updated docs for magic selectors 2011-03-25 18:49:49 -04:00
Scott Davis
bd11d0b381 updated regular expression for finding the parent image 2011-03-25 17:32:58 -04:00
Scott Davis
c3f00537c8 updated code comments 2011-03-25 17:30:27 -04:00
Scott Davis
c72eebdf42 added support for sprite-selector formats 2011-03-25 17:28:38 -04:00
Scott Davis
4d7dc7ad30 refactored sprite selectors 2011-03-25 17:17:27 -04:00
Scott Davis
9962a37b2e added tests and css selector support for sprites ending in _hover _target _active closes#248 2011-03-25 15:00:50 -04:00
Scott Davis
e47fccd2ed rdoc updates for sprite classes 2011-03-25 12:48:18 -04:00
Chris Eppstein
6d91ecc0ea Fix broken link 2011-03-25 08:24:07 -07:00
Chris Eppstein
2b5d91fa9d fix some broken links 2011-03-25 07:58:57 -07:00
Scott Davis
39947f04d0 gemfile.lock 2011-03-25 02:53:52 -04:00
Scott Davis
713ebe1600 added extending section to turtorials 2011-03-25 02:53:25 -04:00
Scott Davis
dda7c94cbd Merge branch 'master' of github.com:chriseppstein/compass 2011-03-25 02:18:47 -04:00
Scott Davis
ca1f13744f added sprite config options to config reference 2011-03-25 02:18:37 -04:00
Chris Eppstein
f5c902068a Version bump. 2011-03-24 23:14:55 -07:00
Scott Davis
6822db1705 added link to change log 2011-03-25 02:12:49 -04:00
Scott Davis
9540450e25 updated change log 2011-03-25 02:11:03 -04:00
Chris Eppstein
3272dc7e5a Load extensions found in ~/.compass/extensions, if the directory exists. 2011-03-24 22:57:17 -07:00
Chris Eppstein
cca6474ba2 Don't extend core classes. 2011-03-24 22:57:17 -07:00
Scott Davis
e475637682 merged sprite abstracton branch 2011-03-25 01:23:13 -04:00
Scott Davis
fccd5d91e9 merge 2011-03-25 01:05:13 -04:00
Scott Davis
2041ed0845 gemfile.lock 2011-03-25 01:04:11 -04:00
Scott Davis
2bf3d8f453 reverted chunky_png version pushed that by mistake and patched a bug that was causing callbacks to register twice 2011-03-25 00:54:47 -04:00
Steve Hull
9940ee8cbb Adding support for pixel-stops for webkit if the gradient goes from left-to-right or top-to-bottom. 2011-03-24 18:54:24 -07:00
Scott Davis
de86610c14 moved files around 2011-03-23 01:29:56 -04:00
Scott Davis
463ee01a12 moved files around 2011-03-23 01:29:51 -04:00
Scott Davis
f8197c530c gemfile.locl 2011-03-23 01:23:38 -04:00
Scott Davis
eba86119c5 cleanup 2011-03-23 01:22:32 -04:00
Scott Davis
965c37f6d7 modified gem 2011-03-23 01:15:18 -04:00
Scott Davis
f78744171d sprite base spec selector methods 2011-03-23 01:09:41 -04:00
Scott Davis
03b0ee2660 sprite base spec 2011-03-23 00:56:49 -04:00
Scott Davis
a5e27952f8 merge 2011-03-22 22:54:16 -04:00
John Bintz
f031d868d1 start refactoring work on sprite map 2011-03-22 21:19:19 -04:00
Scott Davis
6e1daf69f5 added boolean functions for finding selectors 2011-03-21 22:10:44 -04:00
Scott Davis
46eec5362d fixes #253 2011-03-21 21:16:55 -04:00
Scott Davis
a9b6d8cfde file cleanup 2011-03-21 18:37:24 -04:00
Scott Davis
f7d0079f27 file cleanup 2011-03-21 18:36:55 -04:00
Scott Davis
01b9cd3a46 gemfile 2011-03-21 18:07:53 -04:00
Scott Davis
691c6718b5 updated for chunky png 1.1.0 2011-03-21 17:38:15 -04:00
Scott Davis
acf9c662f6 merge 2011-03-21 17:33:37 -04:00
Scott Davis
a4d43192c9 merge 2011-03-21 17:29:15 -04:00
Scott Davis
4d09a69d6b Merge branch 'master' of https://github.com/chriseppstein/compass 2011-03-21 17:26:40 -04:00
Scott Davis
d361d5f826 chunky_png gemfile change 2011-03-21 17:18:28 -04:00
Scott Davis
6ff877cbd3 chunky_png gemfile change 2011-03-21 17:14:41 -04:00
Chris Eppstein
0fdf606ad3 Rename Download to Install and spruce up the madlib a bit. 2011-03-21 00:57:22 -07:00
Scott Davis
3f3eba57a2 merge 2011-03-18 06:44:54 -04:00
Eric Meyer
51e21b08b9 additional transform-style typo and tests fixed 2011-03-16 16:32:00 -06:00
Eric Meyer
f71497b0eb merge with master 2011-03-16 16:17:26 -06:00
Eric Meyer
ddea94bb96 fixed transform-style typo caught by @doctyper 2011-03-16 16:11:55 -06:00
Chris Eppstein
5a2ea40024 Version bump 2011-03-15 17:10:15 -07:00
Chris Eppstein
7057f0f5bd Release documentation. 2011-03-15 17:09:46 -07:00
Chris Eppstein
0d29379b44 Font face file no longer needs a UTF-8 Charset. 2011-03-15 16:03:04 -07:00
Chris Eppstein
ca97c44b60 Update sass dependency for new staleness checker api 2011-03-15 14:46:54 -07:00
Chris Eppstein
40d0e623d0 Use a single staleness checker during a compile run to speed up dependency checking. 2011-03-15 14:38:52 -07:00
Eric Meyer
5a5c30caf4 updated font-face a la fontspring, no change in usage 2011-03-14 22:50:39 -06:00
Scott Davis
d23e5546d8 updated ignore 2011-03-03 01:19:49 -05:00
Scott Davis
267a5df605 opps bitecode 2011-03-03 01:16:11 -05:00
Scott Davis
1d6e316685 removed unnedded class tests are green runs in 1.8.7 adm 1.9.2 2011-03-03 01:15:22 -05:00
Scott Davis
c0a0b638b1 tests are green and config option added 2011-03-02 13:55:25 -05:00
Scott Davis
a4861298a7 fixed rmagic 2011-02-24 05:21:37 -05:00
Scott Davis
bc13d6aed5 rmagick changes 2011-02-24 03:08:28 -05:00
Scott Davis
03f4c23c04 abstracted out engine for chunkypng 2011-02-24 01:02:31 -05:00
Scott Davis
1c71df3b41 merge 2011-02-24 00:20:13 -05:00
Scott Davis
7277568303 added test for left and top 2011-02-24 00:08:35 -05:00
Eric Meyer
132621c230 fixed tests related to reset 2011-02-22 23:11:26 -07:00
Scott Davis
153582fe68 refactoring sprite class 2011-02-22 21:47:08 -05:00
Scott Davis
995a20cd36 fixed relative path call 2011-02-22 21:32:48 -05:00
John Bintz
994cf534af merge 2011-02-22 21:29:47 -05:00
John Bintz
da43418af0 merge 2011-02-22 21:27:52 -05:00
John Bintz
f3957daef7 start factoring out sprite images 2011-02-22 21:24:29 -05:00
Scott Davis
3feca48f51 duplicate function 2011-02-22 20:45:41 -05:00
Scott Davis
fb61e54389 abractated core sprite functions to a base class 2011-02-22 20:42:01 -05:00
Eric Meyer
c521908947 Merge branch 'master' of github.com:chriseppstein/compass 2011-02-21 23:23:14 -07:00
Eric Meyer
c5949beca3 bring back (deprecated) legacy reset and legacy docs 2011-02-21 23:22:55 -07:00
Chris Eppstein
3269cbf743 Added docs for the new appearance mixin. 2011-02-21 18:02:18 -08:00
Zee Agency
d9fdb0d0c7 Add css3 appearance mixin 2011-02-21 16:50:05 -08:00
Chris Eppstein
65cf2f9812 Remove deprecated use of comma-delimited-list 2011-02-21 16:47:20 -08:00
Chris Eppstein
2147240c1d Changelog entry for delimited-list 2011-02-21 16:46:07 -08:00
Chris Eppstein
15e9eef9c0 deprecate the comma-delimted-list mixin in favor of the more general
delimited-list mixin.
2011-02-21 16:45:32 -08:00
Chad Ostrowski
0944d85ade 'delimited-list' now generalizes 'comma-delimited-list' 2011-02-21 16:37:27 -08:00
Chris Eppstein
3ee95174eb Fix copy/paste error. Closes GH-279. 2011-02-21 13:03:19 -08:00
Chris Eppstein
5524745b93 changelog entry for the color contrast module. 2011-02-21 13:00:57 -08:00
Chris Eppstein
2b29dd0bbc Docs for the new contrast module. 2011-02-21 12:49:54 -08:00
Chris Eppstein
902450a244 Use a sass-based function instead of a ruby-based function for contrast calculations 2011-02-21 12:49:54 -08:00
Aaron Russell
620c9fe1ab Added utilities/color/contrast module. Added contrasted mixin and
get_contrast_yiq function.
2011-02-21 12:49:53 -08:00
Eric Meyer
802bc71c05 Eric Meyers css reset v2.0 2011-02-21 12:31:34 -07:00
Chris Eppstein
f1587b6bf1 pass compilation sass events through to compass when using the sass plugin to compile. 2011-02-21 09:35:26 -08:00
Chris Eppstein
beda56a2c8 note the reset-float mixin in the changelog 2011-02-21 09:11:10 -08:00
Adam Stacoviak
9b0967eb47 Add reset-float mixin to reset the cross browser float mixins. 2011-02-21 09:05:52 -08:00
Chris Eppstein
8a8ef87e48 Fix a ruby 1.9.2 bug 2011-02-20 10:38:00 -08:00
Chris Eppstein
a83b62fbc3 Update changelog 2011-02-20 10:25:13 -08:00
Chris Eppstein
2fe1c17ac4 Don't rely on global callbacks 2011-02-20 10:16:11 -08:00
Scott Davis
2142430735 Callbacks for the following events:
* sprite_saved
* sprite_generated
* stylesheet_saved
* stylesheet_error

From the compass configuration file you can attach code to run when the
event occurs like so:

on_stylesheet_error do |filename, message|
  # do something
end
2011-02-20 10:14:34 -08:00
Chris Eppstein
9fd7ac6e52 Update the docs readme to be accurate for recent changes. 2011-02-18 09:48:18 -08:00
Eric Meyer
9a22e05949 old imports still work, but deprecated 2011-02-17 18:33:51 -07:00
Eric Meyer
53e975100b added vertical-rhythm and docs, moved lists, links and text, all into new typography module 2011-02-17 18:14:40 -07:00
Chris Eppstein
0dc38bc2bb update gemfile 2011-02-17 16:04:43 -08:00
Chris Eppstein
303453d9a6 Version bump 2011-02-01 23:03:54 -08:00
Chris Eppstein
5ccdbd6490 update gem dependencies 2011-02-01 23:03:38 -08:00
Chris Eppstein
6f1ea8a651 Update font-face docs 2011-02-01 23:03:12 -08:00
Chris Eppstein
a597a10e7e update failing test due to slightly different css output 2011-02-01 23:02:34 -08:00
Paul Irish
0fd9c08664 Android 2.2 compat for @font-face declarations via a MQ redeclaration of the @ff 2011-02-01 22:24:22 -08:00
Chris Eppstein
58740fc039 Correctly convert scss files to css names in the installatio instructions. 2011-01-26 09:49:12 -08:00
Chris Eppstein
13ecaa2da6 bump sass dependency 2011-01-20 14:17:32 -08:00
Chris Eppstein
636f805423 Merge commit 'jetviper21/master'
* commit 'jetviper21/master':
  bumped chunky_png to 0.12.0 and updated specs accordingly
2011-01-20 14:16:07 -08:00
Scott Davis
7343e80b7d bumped chunky_png to 0.12.0 and updated specs accordingly 2011-01-20 17:10:35 -05:00
Chris Eppstein
e935d512e7 Update changelog with date. 2011-01-17 13:59:21 -08:00
Chris Eppstein
c161b8ba3a Bump version for release 2011-01-17 11:57:06 -08:00
Chris Eppstein
bf52c76470 Rename the sprite-position mixin in compass/utilities/sprites/base to
sprite-background-position in order to avoid a naming conflict with the
older sprite-image module.
2011-01-17 11:54:58 -08:00
Chris Eppstein
e384dee5da Update gemspec to work around sass regression. 2011-01-17 11:47:59 -08:00
Chris Eppstein
042972003f handle some slightly older versions of sass 2011-01-17 06:40:10 -08:00
Chris Eppstein
0ecdfc4631 make a note about --skip-overrides in the changelog 2011-01-16 15:04:36 -08:00
Chris Eppstein
d3a346e1ac Merge commit 'psampaio/sprite_skip_overrides'
* commit 'psampaio/sprite_skip_overrides':
  adding --skip-overrides argument to the compass sprite command
2011-01-16 12:58:36 -08:00
Chris Eppstein
665241f8cd don't call the syntax highlighter twice 2011-01-14 18:06:18 -08:00
Chris Eppstein
72435363cd Link to John's article on the terminal 2011-01-14 18:05:59 -08:00
Pedro Sampaio
a095eb6abf adding --skip-overrides argument to the compass sprite command 2011-01-11 14:14:40 +00:00
Chris Eppstein
8519a66a02 Update sass dependency 2011-01-10 10:16:05 -08:00
Chris Eppstein
b9be4702fd made the stretching example be less lame. 2011-01-10 09:26:34 -08:00
Chris Eppstein
ceeb11ec9a Guide the new users to some follow up docs. 2011-01-10 08:15:18 -08:00
Chris Eppstein
de99dddebf Version bump for release 2011-01-09 22:59:23 -08:00
Chris Eppstein
cb7ac80330 New Download page for compass docs 2011-01-09 22:26:47 -08:00
Chris Eppstein
5bc36855bc fix typo 2011-01-09 22:26:46 -08:00
Brandon Mathis
0ed6525827 Merge branch 'master' of github.com:chriseppstein/compass 2011-01-07 17:45:36 -06:00
Brandon Mathis
f3bcbaee19 added redirect for reference and updated general layouts redirect 2011-01-07 17:45:30 -06:00
Travis Tilley
3f8e83208d ruby-prof doesn't work on jruby 2011-01-07 01:41:13 +08:00
Chris Eppstein
2e2b384327 Link to index pages from the search page, link ruby functions to their appropriate compass docs, where they exist. 2011-01-05 09:34:45 -08:00
Chris Eppstein
df756b194c Deprecate the span mixin in favor of the span-fluid() function in the blueprint fluid grid. 2011-01-04 19:20:00 -08:00
Chris Eppstein
0fee93ff5b rename docs to reference 2011-01-04 10:42:19 -08:00
Chris Eppstein
faf769cd39 Better index structure for vars, mixins, and functions. 2011-01-04 10:42:05 -08:00
Chris Eppstein
8a995fe903 homepage copy tweaks 2011-01-04 10:01:46 -08:00
Chris Eppstein
7b5aabd21a Upgrade some examples that were generating deprecation warnings. 2011-01-03 10:30:01 -08:00
Chris Eppstein
136954561f Deprecate the blueprint span mixin in favor of the blueprint span function. 2011-01-03 09:35:07 -08:00
Chris Eppstein
2ad47f5c16 Better changelog entry for the new css3 cross browser function support. 2011-01-03 09:29:25 -08:00
Chris Eppstein
48e3825053 Document Sass Functions 2011-01-02 12:34:16 -08:00
Chris Eppstein
d67a43ad4b Make a span() function for blueprint that returns the width in pixels of $n columns. 2011-01-02 10:44:17 -08:00
Chris Eppstein
068ee421f1 Add docs on the compass cross browser helper functions. 2010-12-31 15:06:41 -08:00
Chris Eppstein
e11f1035bf Refactor the cross browser support and list functions from gradient module. 2010-12-31 12:55:14 -08:00
Chris Eppstein
15f760e002 Infrastructure for cross browser support of simple, experimental functions 2010-12-30 12:19:00 -08:00
Jordan Byron
4c289c9db0 Fix typo in css3 image documentation 2010-12-23 13:43:34 -05:00
Chris Eppstein
3c99f5eaa8 Better docs for the images module and deprecated gradients module. Silence deprecation warnings. 2010-12-23 09:40:50 -08:00
Eric Meyer
42a6dadbc0 properly document transform variables 2010-12-21 14:31:50 -07:00
Chris Eppstein
1f1d93a072 Touch up these docs based on a review from Brandon. 2010-12-19 20:20:58 -08:00
Chris Eppstein
6c7b20764a Another sprite example, this one uses the generated mixins. 2010-12-19 20:20:18 -08:00
Chris Eppstein
1818957131 fix some bugs when building examples 2010-12-19 18:02:49 -08:00
Chris Eppstein
16ca41bec6 Add a simple sprite example. 2010-12-19 18:00:01 -08:00
Chris Eppstein
a254caecdd Allow a prefix to be specified (or omitted) for sprite class names 2010-12-19 17:57:33 -08:00
Chris Eppstein
df8eefa3c2 Got my reversed motion backwards. 2010-12-19 17:51:40 -08:00
Chris Eppstein
cb6f130217 Comment out links to missing docs. 2010-12-19 11:20:49 -08:00
Brandon Mathis
2aa2baf16d Fixed links on contributing to point to other tutorial pages, updated some basic page styles 2010-12-18 22:23:21 -06:00
Brandon Mathis
d8c3c4178a fixed too many redirects errors 2010-12-18 22:22:36 -06:00
Brandon Mathis
02d6292af6 fixed placeholder js to add classname when placeholder is active. this should allow me to style placeholders with css (allowing for multiple color scheme support) rather than the default assignment of colors via javascript options 2010-12-18 21:53:03 -06:00
Chris Eppstein
638fd8f543 fix a bug in sprites when the offset position is absolute. 2010-12-18 18:39:35 -08:00
Chris Eppstein
50963d7dd2 Fix the url helper in rails2 mode. 2010-12-18 17:17:58 -08:00
Chris Eppstein
cc8bccfb15 fix broken tests and code. 2010-12-18 17:13:47 -08:00
Chris Eppstein
2040be4b6c Smarter sidebar logic 2010-12-18 16:25:49 -08:00
Chris Eppstein
ff6c3a078a Remove the old redirect system. 2010-12-18 14:29:21 -08:00
Chris Eppstein
7c323feb31 Add an htaccess file so that we can manage redirects. 2010-12-18 14:08:21 -08:00
Chris Eppstein
992eb8dcf5 Make the placeholder attribute work in older browsers. 2010-12-18 13:34:36 -08:00
Chris Eppstein
411adba777 [Docs] Add a link from the example to the reference documentation. 2010-12-18 13:12:11 -08:00
Chris Eppstein
668a856c14 Document that you can read CLI config settings in the configuration reference. 2010-12-18 12:49:21 -08:00
Chris Eppstein
f318e93764 Expose CLI config parameters at configuration parse time. 2010-12-18 11:26:48 -08:00
Chris Eppstein
b47ff5106a Pending specs for rails integration. 2010-12-18 00:42:26 -08:00
Chris Eppstein
ec699c42c8 Watch arbitrary files within the compass configuration file. 2010-12-18 00:03:07 -08:00
Chris Eppstein
8d3b2d92df Make compass configuration accessible within a rails app's configuration. 2010-12-18 00:03:07 -08:00
Brandon Mathis
4abe386847 removed deprecated text shadows from example files and improved text shadow example and box shadow example markup 2010-12-17 22:49:19 -06:00
Brandon Mathis
30f446daa0 fixed font-face issues on headings for docs site 2010-12-15 21:58:18 -06:00
Brandon Mathis
2da5502040 improved syntax highlighting 2010-12-15 18:15:19 -06:00
Brandon Mathis
34f8763b22 added haml/html toggle on examples, improved code styling, added get involved page 2010-12-14 16:44:44 -06:00
Brandon Mathis
e616fa1ea8 updated code styles to support scrolling on pre elementts, improved ipad display with meta view port on all layouts 2010-12-11 14:37:09 -06:00
Brandon Mathis
bc93883499 fixed code styling on examples in docs site 2010-12-10 21:52:18 -06:00
Brandon Mathis
354beb965d improved the styling for the docs example pages 2010-12-10 18:16:27 -06:00
Brandon Mathis
de3fab45c3 Merge branch 'master' of github.com:chriseppstein/compass
Conflicts:
	doc-src/content/CHANGELOG.markdown
2010-12-10 18:13:56 -06:00
Brandon Mathis
389ab1b62b updated changelog with articles for the previous commit 2010-12-10 18:11:51 -06:00
Brandon Mathis
8d18a1b704 added legacy support option for ie8, updated opacty and filter-gradient mixins to use legacy support settings 2010-12-10 18:10:05 -06:00
Chris Eppstein
2e8706d024 Bump version for release. 2010-12-10 11:32:26 -08:00
Chris Eppstein
9e3fd546d9 Add donation details to the CLI. 2010-12-10 11:32:26 -08:00
Chris Eppstein
38e13e55e6 Removed deprecated command line options. 2010-12-10 11:32:26 -08:00
Chris Eppstein
e22acfde1e Rails apps have a tmp directory 2010-12-10 11:32:26 -08:00
Chris Eppstein
d014b4105a Different ruby versions have slightly different behavior with respect to @charset. Ignore these differences during testing. 2010-12-10 11:32:25 -08:00
Chris Eppstein
25d9cc3468 Fix a bug in the spriting code in ruby 1.9.2 2010-12-10 11:32:25 -08:00
Chris Eppstein
0fb52388cc Upgrade FSSM to whatever version Sass is running. 2010-12-10 11:32:25 -08:00
Chris Eppstein
ab71230b94 Add a --time option to the compile and watch commands. 2010-12-10 11:32:25 -08:00
Chris Eppstein
249544ce68 add css_parser and ruby-prof 2010-12-10 11:32:25 -08:00
Brandon Mathis
2635f91049 added syntax toggling for example pages including: haml, html and scss, sass, css 2010-12-09 23:27:41 -06:00
Brandon Mathis
7f7b3c5ff8 general typography improvements 2010-12-08 23:02:20 -06:00
Brandon Mathis
4ab7a6ca9d updated docs design and added a layout for site pages 2010-12-07 17:28:52 -06:00
Chris Eppstein
caafd963a3 sort out some bundle issues 2010-12-06 13:54:16 -08:00
Chris Eppstein
e3ad16e5fe Don't try to watch importer objects. 2010-12-06 13:52:17 -08:00
Chris Eppstein
6ab9780dfe update gemfiles 2010-12-06 09:36:03 -08:00
Chris Eppstein
04fb6dfd9c bump version, update changelog 2010-12-05 22:12:38 -08:00
Chris Eppstein
48b9e0851b Ruby 1.9 compliant require for the md5 library. 2010-12-05 22:01:46 -08:00
Chris Eppstein
a048d62138 bump versions for release 2010-12-05 21:35:18 -08:00
Chris Eppstein
45da3837b6 Upgrade PIE to beta3. 2010-12-05 21:32:38 -08:00
Chris Eppstein
5acbfc4879 Clean up the extension documentation regarding creating rubygems. Closes GH-231 2010-12-05 21:17:47 -08:00
Chris Eppstein
a86a94e4c2 Add support for the -ms prefix in 2D transforms.
Closes GH-224.
2010-12-05 21:02:16 -08:00
Chris Eppstein
93040322b3 Allow the cache buster in image-url() to be disabled on a per-call basis. 2010-12-05 20:16:40 -08:00
Chris Eppstein
a89d61ce21 Generated sprite filename is now unique based on inputs. 2010-12-05 20:12:50 -08:00
Chris Eppstein
b131fe23da Add a note about requiring sass 3.1 in the changelog 2010-12-05 16:18:18 -08:00
Chris Eppstein
c9beaafb0b Spriting tutorial. 2010-12-05 16:14:55 -08:00
Chris Eppstein
bcf1f4b1f6 Fix a bug in sprite-location resolution 2010-12-05 16:14:55 -08:00
Chris Eppstein
00b41b5506 Only require (chunky|oily)_png if it is needed. 2010-12-05 16:14:55 -08:00
Brandon Mathis
43fa6cf93b updated sass brush 2010-12-05 16:14:55 -08:00
Chris Eppstein
a23dd3d77a Fix some compilation issues 2010-12-05 16:14:55 -08:00
Chris Eppstein
e874c005e9 Reference documentation on spriting 2010-12-05 16:14:37 -08:00
Chris Eppstein
b244105ea3 Only unquote strings 2010-12-05 16:14:36 -08:00
Chris Eppstein
20bb8c0d28 Update gemfiles to depend on sass3.1 2010-12-05 16:14:36 -08:00
Chris Eppstein
43bd9eb8e5 The Sprite container is now called a Sprite Map, and each individual image is called a sprite. 2010-12-05 16:13:13 -08:00
Chris Eppstein
b2a8c8a634 Some code comments, cleanup, and register sprite functions with sass. 2010-12-05 16:13:13 -08:00
Chris Eppstein
472456f344 Less joins. More responding. 2010-12-05 16:13:13 -08:00
Chris Eppstein
027ebdd8c4 Change the sprite utilities to create a sprite literal object that can retain information about the sprite for use in other function calls. This avoids the need for global storage and allows multiple sprites constructed from the same sprite folder with different values. 2010-12-05 16:13:13 -08:00
Chris Eppstein
adcfcf4556 Fix broken test. 2010-12-05 16:13:13 -08:00
Chris Eppstein
b2b913d69f Generator for creating sprite imports for users who don't like magic. 2010-12-05 16:13:13 -08:00
Chris Eppstein
b63bf2669d Don't rely on reading the environment within the sprite code. Instead accept variable keyword args. 2010-12-05 16:13:13 -08:00
Chris Eppstein
2ac705695f Rename these sprite files -- the filenames must be legal css identifiers 2010-12-05 16:13:13 -08:00
Chris Eppstein
d62cdf0127 Fix a bug in ruby 1.9 2010-12-05 16:13:13 -08:00
Chris Eppstein
5aac677e77 Put the Sprite importer on the default load paths coming from compass. 2010-12-05 16:13:13 -08:00
Chris Eppstein
28a77171e3 Quick cache for burst reads. 2010-12-05 16:13:13 -08:00
Chris Eppstein
e1130066f2 Update links to compass online. 2010-12-05 16:13:13 -08:00
Nico Hagenburger
6e93589e6a added error messages to help lemonade users 2010-12-05 16:13:12 -08:00
Nico Hagenburger
9dcab9e14b lemonade compatibility specs and functions 2010-12-05 16:13:12 -08:00
Nico Hagenburger
79d6e28cf5 allow images to be repeated 2010-12-05 16:13:12 -08:00
Nico Hagenburger
2522a3c981 updated gem versions 2010-12-05 16:13:12 -08:00
Nico Hagenburger
8b566765b3 added positioning of images 2010-12-05 16:13:12 -08:00
Nico Hagenburger
573d1a1b03 generation of png file 2010-12-05 16:13:12 -08:00
Nico Hagenburger
c62b8e718d added default spacing 2010-12-05 16:13:12 -08:00
Nico Hagenburger
bf47c74dc2 added sprite position calculating 2010-12-05 16:13:12 -08:00
Nico Hagenburger
4026c51273 optimized options 2010-12-05 16:13:12 -08:00
Nico Hagenburger
004a1f3887 added spec for base class 2010-12-05 16:13:12 -08:00
Nico Hagenburger
9f80cb9e80 added spec for sprite mixin 2010-12-05 16:13:11 -08:00
Nico Hagenburger
05b2695806 implemented most basic sprite usage without image generation 2010-12-05 16:13:11 -08:00
Nico Hagenburger
f577da1d5e updated to rspec 2.0.0 2010-12-05 16:13:11 -08:00
Chris Eppstein
aaffea49af factor out the saving from the generating, we'll need to monkey patch this in a rails environment. 2010-12-05 16:13:11 -08:00
Chris Eppstein
0a447625e0 The image_url function has to be accessed from within the engine for it to work right in all cases. 2010-12-05 16:13:11 -08:00
Chris Eppstein
57a63c455a Use the Sass cache to store information about sprites across compiles -- this removes one aspect of lemonade's filesystem dependency. 2010-12-05 16:13:11 -08:00
Chris Eppstein
53033e473b This is a little more readable. 2010-12-05 16:13:11 -08:00
Chris Eppstein
8bf992defa Move the lemonade files around to adhere to compass conventions. 2010-12-05 16:13:11 -08:00
Chris Eppstein
757fed8888 Rename Lemonade to Compass::Sprites 2010-12-05 16:13:11 -08:00
Chris Eppstein
a2f1026659 This is a whole lot faster 2010-12-05 16:13:11 -08:00
Chris Eppstein
a1f1943367 Only do this once, otherwise the output changes every time. 2010-12-05 16:13:11 -08:00
Chris Eppstein
dd2c9eb72d Add a --profile option to the compass CLI 2010-12-05 16:13:11 -08:00
Chris Eppstein
b313ac794e update the gemspec with lemonade dependencies. add nico as an author. 2010-12-05 16:13:11 -08:00
Chris Eppstein
ffe967e8c8 Bolt on lemonade to get started. 2010-12-05 16:13:10 -08:00
Chris Eppstein
9f1b8f515b Use the new Sass gem now. 2010-12-05 16:13:10 -08:00
926 changed files with 11142 additions and 3594 deletions

4
.gitignore vendored
View File

@ -25,3 +25,7 @@ doc-src/.bundle
attic attic
devbin devbin
.rvmrc .rvmrc
*.rbc
vendor/ruby
vendor
Gemfile.lock

2
.rspec Normal file
View File

@ -0,0 +1,2 @@
--colour
--format s

7
.travis.yml Normal file
View File

@ -0,0 +1,7 @@
rvm:
- 1.8.7
- 1.9.2
- jruby
- rbx
- ree
script: "bundle exec rake test features"

31
Gemfile
View File

@ -1,12 +1,29 @@
source :rubygems source :rubygems
gem "compass", :path => "." gemspec
gem "cucumber"
gem "rspec" gem "cucumber", "~> 0.9.2"
gem "rspec", "~>2.0.0"
gem "rails", "~>3.0.0.rc" gem "rails", "~>3.0.0.rc"
gem "compass-validator", "3.0.0" gem "compass-validator", "3.0.1"
gem "css_parser" gem "css_parser", "~> 1.0.1"
gem "sass", "~> 3.1" gem "sass", "~>3.1"
gem "rcov" gem "haml", "~> 3.1"
gem "rcov", :platform => :mri
gem "rubyzip" gem "rubyzip"
gem "livereload" gem "livereload"
gem "ruby-prof", :platform => :mri
gem 'autotest'
gem 'autotest-fsevent' if RUBY_PLATFORM =~ /darwin/
gem 'fakefs', :git => 'git://github.com/johnbintz/fakefs.git'
gem 'mocha'
gem 'timecop'
gem 'diff-lcs', '~> 1.1.2'
gem 'rake', '0.8.7'
group :mac do
gem "rb-fsevent"
end

View File

@ -13,7 +13,7 @@ require 'cucumber'
require 'cucumber/rake/task' require 'cucumber/rake/task'
Cucumber::Rake::Task.new(:features) do |t| Cucumber::Rake::Task.new(:features) do |t|
t.cucumber_opts = "features --format pretty" t.cucumber_opts = "features --format progress"
end end
Rake::TestTask.new :test do |t| Rake::TestTask.new :test do |t|
@ -47,7 +47,7 @@ task :examples do
puts "=" * "Compiling #{example}".length puts "=" * "Compiling #{example}".length
Dir.chdir example do Dir.chdir example do
load "bootstrap.rb" if File.exists?("bootstrap.rb") load "bootstrap.rb" if File.exists?("bootstrap.rb")
Compass::Exec::SwitchUI.new(["--force"]).run! Compass::Exec::SubCommandUI.new(%w(compile --force)).run!
end end
# compile any haml templates to html # compile any haml templates to html
FileList["#{example}/**/*.haml"].each do |haml_file| FileList["#{example}/**/*.haml"].each do |haml_file|

View File

@ -1,5 +1,5 @@
--- ---
:major: 0 :major: 0
:minor: 11 :minor: 11
:state: alpha :patch: 5
:build: 1 :name: Antares

5
autotest/discover.rb Normal file
View File

@ -0,0 +1,5 @@
Autotest.add_discovery { 'rspec2' }

View File

@ -21,6 +21,20 @@ fallback_load_path(File.join(File.dirname(__FILE__), '..', 'lib')) do
require 'compass/exec' require 'compass/exec'
end end
runner = Proc.new do
Compass::Exec::SubCommandUI.new(ARGV).run!
end
command_line_class = Compass::Exec::Helpers.select_appropriate_command_line_ui(ARGV) if ARGV.delete("--profile")
exit command_line_class.new(ARGV).run! require 'ruby-prof'
RubyProf.start
exit_code = runner.call
result = RubyProf.stop
# Print a flat profile to text
printer = RubyProf::FlatPrinter.new(result)
printer.print(STDERR, 0)
exit exit_code
else
exit runner.call
end

View File

@ -4,18 +4,21 @@ require File.join(path, 'compass/version')
Gem::Specification.new do |gemspec| Gem::Specification.new do |gemspec|
gemspec.name = "compass" gemspec.name = "compass"
gemspec.version = Compass::VERSION # Update the VERSION.yml file to set this. gemspec.version = Compass::VERSION # Update the VERSION.yml file to set this.
gemspec.date = "#{Time.now.year}-#{Time.now.month}-#{Time.now.day}" # Automatically update for each build
gemspec.description = "Compass is a Sass-based Stylesheet Framework that streamlines the creation and maintainance of CSS." gemspec.description = "Compass is a Sass-based Stylesheet Framework that streamlines the creation and maintainance of CSS."
gemspec.homepage = "http://compass-style.org" gemspec.homepage = "http://compass-style.org"
gemspec.authors = ["Chris Eppstein", "Eric A. Meyer", "Brandon Mathis"] gemspec.authors = ["Chris Eppstein", "Eric A. Meyer", "Brandon Mathis", "Nico Hagenburger", "Scott Davis"]
gemspec.email = "chris@eppsteins.net" gemspec.email = "chris@eppsteins.net"
gemspec.default_executable = "compass" #gemspec.default_executable = "compass" #deprecated
gemspec.executables = %w(compass) gemspec.executables = %w(compass)
gemspec.has_rdoc = false #gemspec.has_rdoc = false #deprecated
gemspec.require_paths = %w(lib) gemspec.require_paths = %w(lib)
gemspec.rubygems_version = "1.3.5" gemspec.rubygems_version = "1.3.5"
gemspec.summary = %q{A Real Stylesheet Framework} gemspec.summary = %q{A Real Stylesheet Framework}
gemspec.add_dependency('sass', '~> 3.1')
gemspec.add_dependency 'sass', '~> 3.1'
gemspec.add_dependency 'chunky_png', '~> 1.2'
gemspec.add_dependency 'fssm', '>= 0.2.7'
gemspec.files = %w(README.markdown LICENSE.markdown VERSION.yml Rakefile) gemspec.files = %w(README.markdown LICENSE.markdown VERSION.yml Rakefile)
gemspec.files += Dir.glob("bin/*") gemspec.files += Dir.glob("bin/*")
gemspec.files += Dir.glob("examples/**/*.*") gemspec.files += Dir.glob("examples/**/*.*")

1
doc-src/.gitignore vendored
View File

@ -1,3 +1,4 @@
bin bin
vendor vendor
output output
vendor/ruby

View File

@ -5,14 +5,19 @@ gem 'rdiscount'
gem 'thor' gem 'thor'
gem 'rack' gem 'rack'
gem 'mime-types' gem 'mime-types'
gem 'fssm'
gem 'serve', "1.0.0" gem 'serve', "1.0.0"
gem 'nokogiri' gem 'nokogiri'
gem 'coderay' gem 'coderay'
gem 'haml', ">=3.0.23", :require => 'sass' gem 'sass', ">= 3.1"
gem 'haml', ">= 3.1"
gem 'rake' gem 'rake'
gem 'compass', :path => ".." gem 'compass', :path => ".."
gem 'compass-susy-plugin', ">=0.7.0.pre8" gem 'compass-susy-plugin', ">=0.7.0.pre8"
gem 'css-slideshow', "0.2.0" gem 'css-slideshow', "0.2.0"
gem 'json' gem 'json'
gem 'css_parser', "1.0.1"
gem 'ruby-prof'
gem 'rb-fsevent'
gem 'builder'

View File

@ -1,60 +1,71 @@
GIT GIT
remote: git://github.com/chriseppstein/nanoc.git remote: git://github.com/chriseppstein/nanoc.git
revision: 4ecb400489c83fd2068659de0c651733b8dad28f revision: 4eee0e60c5121b90498caa88605d416521553378
specs: specs:
nanoc3 (3.2.0a3) nanoc3 (3.2.0a3)
cri (>= 1.0.0) cri (>= 1.0.0)
PATH PATH
remote: /Users/bmathis/Documents/Workspace/compass-projects/compass remote: ..
specs: specs:
compass (0.11.alpha.1.488fddf) compass (0.11.1.93b89a2)
chunky_png (~> 1.1)
fssm (>= 0.2.7)
sass (~> 3.1) sass (~> 3.1)
GEM GEM
remote: http://rubygems.org/ remote: http://rubygems.org/
specs: specs:
activesupport (3.0.1) activesupport (3.0.7)
coderay (0.9.5) builder (2.1.2)
compass-susy-plugin (0.8.1) chunky_png (1.2.0)
compass (>= 0.10.0) coderay (0.9.7)
compass-susy-plugin (0.9.beta.3)
compass (>= 0.11.beta.3)
cri (1.0.1) cri (1.0.1)
css-slideshow (0.2.0) css-slideshow (0.2.0)
compass (>= 0.10.0.rc3) compass (>= 0.10.0.rc3)
fssm (0.2.0) css_parser (1.0.1)
haml (3.0.23) fssm (0.2.7)
haml (3.1.0)
i18n (0.4.2) i18n (0.4.2)
json (1.4.6) json (1.5.1)
mime-types (1.16) mime-types (1.16)
nokogiri (1.4.3.1) nokogiri (1.4.4)
rack (1.2.1) rack (1.2.2)
rake (0.8.7) rake (0.8.7)
rdiscount (1.6.5) rb-fsevent (0.4.0)
sass (3.1.0.alpha.28) rdiscount (1.6.8)
ruby-prof (0.9.2)
sass (3.1.0)
serve (1.0.0) serve (1.0.0)
activesupport (~> 3.0.1) activesupport (~> 3.0.1)
i18n (~> 0.4.1) i18n (~> 0.4.1)
rack (~> 1.2.1) rack (~> 1.2.1)
tzinfo (~> 0.3.23) tzinfo (~> 0.3.23)
thor (0.14.4) thor (0.14.6)
tzinfo (0.3.23) tzinfo (0.3.26)
PLATFORMS PLATFORMS
ruby ruby
DEPENDENCIES DEPENDENCIES
builder
coderay coderay
compass! compass!
compass-susy-plugin (>= 0.7.0.pre8) compass-susy-plugin (>= 0.7.0.pre8)
css-slideshow (= 0.2.0) css-slideshow (= 0.2.0)
fssm css_parser (= 1.0.1)
haml (>= 3.0.23) haml (>= 3.1)
json json
mime-types mime-types
nanoc3! nanoc3!
nokogiri nokogiri
rack rack
rake rake
rb-fsevent
rdiscount rdiscount
ruby-prof
sass (>= 3.1)
serve (= 1.0.0) serve (= 1.0.0)
thor thor

View File

@ -49,7 +49,7 @@ If you are adding an asset (E.g. image, css, javascript) place the file(s) in th
Running the following command will generate a new example: Running the following command will generate a new example:
bundle exec thor generate:example blueprint/grid/simple/ ./bin/thor generate:example blueprint/grid/simple/
An example consists of three files: An example consists of three files:
@ -74,7 +74,7 @@ After adding the example and adjusting the metadata, go to the reference page an
Generate a reference file for a stylesheet: Generate a reference file for a stylesheet:
bundle exec thor generate:reference ../frameworks/compass/stylesheets/_compass.sass ./bin/thor generate:reference ../frameworks/compass/stylesheets/_compass.sass
The item metadata (at the top of the file) provides some details about what stylesheet is being documented. For instance, here is the metadata for the blueprint color module item: The item metadata (at the top of the file) provides some details about what stylesheet is being documented. For instance, here is the metadata for the blueprint color module item:
@ -143,15 +143,7 @@ Go to your fork of Compass on github. Your compass fork will be available on htt
$ git clone git@github.com:**yourusername**/compass.git $ git clone git@github.com:**yourusername**/compass.git
### 3. Switch to the docs branch ### 3. Don't forget: bundler!
To work on the docs, you need to do a checkout of the docs branch
$ git checkout docs
(A list branches can be accessed through `git branch` with no arguments)
### 4. Don't forget: bundler!
If you haven't yet done so, install bundler: If you haven't yet done so, install bundler:
@ -160,30 +152,28 @@ If you haven't yet done so, install bundler:
Bundle the gems for this application: Bundle the gems for this application:
$ cd doc-src $ cd doc-src
$ bundle install $ bundle install --binstubs
### 6. Compile the docs ### 4. Compile the docs
To compile (and auto recompile) and preview the site in your browser: (make sure you run nanoc3/aco from the doc-src directory) To compile (and auto recompile) and preview the site in your browser: (make sure you run nanoc3 aco from the doc-src directory)
$ cd doc-src $ cd doc-src
$ export RUBYLIB="../lib" $ ./bin/nanoc3 aco
$ bundle exec nanoc3 aco
Then open `http://localhost:3000/docs/` in your web browser. Then open `http://localhost:3000/index.html` in your web browser.
aco stands for autocompiler; the site will recompile every time you request a new page. aco stands for autocompiler; the site will recompile every time you request a new page.
If you find `bundle exec nanoc3 aco` to be sluggish, try this alternative workflow: If you find `./bin/nanoc3 aco` to be sluggish, try this alternative workflow:
$ cd doc-src $ cd doc-src
$ export RUBYLIB="../lib" $ ./bin/serve 3000 output &
$ bundle exec serve 3000 .. & $ ./bin/rake watch
$ bundle exec rake watch
It is recommended that you read the 5 minute [tutorial](http://nanoc.stoneship.org/tutorial/) on Nanoc. It is recommended that you read the 5 minute [tutorial](http://nanoc.stoneship.org/tutorial/) on Nanoc.
### 7. Commit your changes to your Fork ### 5. Commit your changes to your Fork
git commit -a git commit -a
git push git push
@ -202,4 +192,4 @@ Then get the new changes with fetch:
And merge them with your local docs branch: And merge them with your local docs branch:
git merge chris/docs git merge chris

View File

@ -25,7 +25,7 @@ task :watch do
rebuild_site = lambda do |base, relative| rebuild_site = lambda do |base, relative|
if relative && relative =~ /\.s[ac]ss/ if relative && relative =~ /\.s[ac]ss/
puts ">>> Change Detected to #{relative} : updating stylsheets <<<" puts ">>> Change Detected to #{relative} : updating stylesheets <<<"
system "bundle exec compass compile" system "bundle exec compass compile"
else else
if !relative if !relative

View File

@ -18,7 +18,7 @@ end
compile '/' do compile '/' do
filter :haml, :ugly => true filter :haml, :ugly => true
layout item[:redirect] ? "redirect" : (item[:layout] ? item[:layout] : "main") layout item[:layout] ? item[:layout] : "main"
end end
compile '/search-data/' do compile '/search-data/' do
@ -28,7 +28,7 @@ end
compile '/examples/*/' do compile '/examples/*/' do
filter :haml, :ugly => true filter :haml, :ugly => true
filter :highlight filter :highlight
layout item[:redirect] ? "redirect" : (item[:layout] ? item[:layout] : "example") layout item[:layout] ? item[:layout] : "example"
end end
sass_options = Compass.sass_engine_options sass_options = Compass.sass_engine_options
@ -44,7 +44,21 @@ end
compile '/reference/*/' do compile '/reference/*/' do
filter :haml, :ugly => true filter :haml, :ugly => true
filter :highlight filter :highlight
layout item[:redirect] ? "redirect" : (item[:layout] ? item[:layout] : "main") layout item[:layout] ? item[:layout] : "main"
end
compile '/posts/*/' do
filter :erb
filter :rdiscount if item[:extension] == "markdown"
layout 'post'
end
compile "/blog/atom/" do
filter :haml, :attr_wrapper => '"'
end
compile 'sitemap' do
filter :erb
end end
compile '*' do compile '*' do
@ -53,7 +67,15 @@ compile '*' do
elsif item[:extension] == "haml" elsif item[:extension] == "haml"
filter :haml, :ugly => true filter :haml, :ugly => true
end end
layout item[:redirect] ? "redirect" : (item[:layout] ? item[:layout] : "main") layout item[:layout] ? item[:layout] : "main"
end
route 'sitemap' do
item.identifier.chop + '.xml'
end
route "/blog/atom/" do
"/blog/atom.xml"
end end
route '/search-data/' do route '/search-data/' do
@ -64,6 +86,10 @@ end
route("/stylesheets/#{'*/' * i}_*/") {nil} route("/stylesheets/#{'*/' * i}_*/") {nil}
end end
route '/assets/htaccess/' do
"#{SITE_ROOT}/.htaccess"
end
route '/assets/css/*/' do route '/assets/css/*/' do
"#{SITE_ROOT}/stylesheets"+item.identifier.chop[11..-1]+"."+item[:extension] "#{SITE_ROOT}/stylesheets"+item.identifier.chop[11..-1]+"."+item[:extension]
end end
@ -85,6 +111,15 @@ route '/stylesheets/*/' do
SITE_ROOT+item.identifier.chop + '.css' SITE_ROOT+item.identifier.chop + '.css'
end end
route '/posts/*/' do
if item.identifier =~ %r{^/posts/(\d{4})-(\d{2})-(\d{2})-(.*)/$}
"/blog/#{$1}/#{$2}/#{$3}/#{$4}/index.html"
else
puts "WARNING: malformed post name: #{item.identifier}"
nil
end
end
%w(markup stylesheet background).each do |ex_file| %w(markup stylesheet background).each do |ex_file|
route "/examples/*/#{ex_file}/" do route "/examples/*/#{ex_file}/" do
nil nil

4
doc-src/assets/htaccess Normal file
View File

@ -0,0 +1,4 @@
RedirectMatch 301 /docs/$ /reference/compass/
RedirectMatch 301 /docs/tutorials/(.*) /help/tutorials/$1
RedirectMatch 301 /docs/(.*) /$1
RedirectMatch 301 /reference/$ /reference/compass/

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

After

Width:  |  Height:  |  Size: 13 KiB

View File

@ -9,14 +9,14 @@ $(function(){
}); });
}); });
;(function() /*;(function()
{ {
typeof(require) != 'undefined' ? SyntaxHighlighter = require('shCore').SyntaxHighlighter : null; typeof(require) != 'undefined' ? SyntaxHighlighter = require('shCore').SyntaxHighlighter : null;
function Brush(){}; function Brush(){};
Brush.prototype = new SyntaxHighlighter.Highlighter(); Brush.prototype = new SyntaxHighlighter.Highlighter();
Brush.aliases = ['sass', 'scss']; Brush.aliases = ['sass', 'scss', 'css', 'html'];
SyntaxHighlighter.brushes.Sass = Brush; SyntaxHighlighter.brushes.Sass = Brush;
typeof(exports) != 'undefined' ? exports.Brush = Brush : null; typeof(exports) != 'undefined' ? exports.Brush = Brush : null;
})(); })();*/

View File

@ -0,0 +1,87 @@
function showInstallCommand() {
var cmd = $("#existence").val();
var commands = [];
var notes = [];
var project_name = "&lt;myproject>";
var can_be_bare = true;
commands.push("$ gem install compass");
if (cmd == "init") {
commands.push("$ cd " + project_name);
project_name = ".";
}
if ($("#app-type").val() == "rails") {
if (cmd == "create") {
commands.push("$ rails new " + project_name);
}
cmd = "init rails";
can_be_bare = false;
} else if ($("#app-type").val() == "other") {
if (cmd == "init") {
cmd = "create";
}
} else if ($("#app-type").val() == "stand-alone") {
if (cmd == "init") {
cmd = "install";
can_be_bare = false;
}
}
var framework = $("#framework").val();
var create_command;
if (cmd == "install") {
create_command = "$ compass install " + framework + " " + project_name;
} else {
create_command = "$ compass " + cmd + " " + project_name;
}
if (framework != "compass" && framework != "bare" && cmd != "install") {
create_command = create_command + " --using " + framework;
} else if (framework == "bare") {
if (can_be_bare) {
create_command = create_command + " --bare";
} else {
notes.push("<p class='note warning'>You cannot create a bare project in this configuration. Feel free to remove any stylesheets that you don't want.</p>");
}
}
if ($("#syntax").val() == "sass") {
create_command = create_command + " --syntax sass";
}
if ($("#options").val() == "customized") {
$("#directories").show();
create_command = create_command +
" --sass-dir \"" + $("#sassdir").val() + "\"" +
" --css-dir \"" + $("#cssdir").val() + "\"" +
" --javascripts-dir \"" + $("#jsdir").val() + "\"" +
" --images-dir \"" + $("#imagesdir").val() + "\"";
} else {
$("#directories").hide();
}
commands.push(create_command);
var instructions = "<pre><code>" + commands.join("\n") + "</code></pre>";
if (instructions.match(/&lt;/)) {
notes.push("<p class='note'>Note: Values indicated by &lt;&gt; are placeholders. Change them to suit your needs.</em>");
}
$("#steps").html(instructions + notes.join(""));
}
function attachMadlibBehaviors() {
$("#app-type").change(function(event) {
var val = $(event.target).val();
if (val == "other") {
$("#options").val("customized");
$(".madlib").addClass("customizable");
} else if (val == "rails") {
$("#options").val("default");
$(".madlib").removeClass("customizable");
} else {
$(".madlib").addClass("customizable");
}
});
$("#existence, #app-type, #framework, #syntax, #options").change(showInstallCommand);
$(".madlib input").keyup(function(){setTimeout(showInstallCommand, 0.1)});
}
function setupMadlib() {
attachMadlibBehaviors();
showInstallCommand();
}
$(setupMadlib);

View File

@ -0,0 +1,47 @@
(function($) {
$.fn.replaceholder = function(options) {
var $placeholder;
(this.length > 0) ? $this = $(this) : $this = $('input[placeholder]');
return $this.each(function() {
settings = jQuery.extend(options);
var $placeholder = $(this);
if ($placeholder.length > 0) {
var attrPh = $placeholder.attr('placeholder');
$placeholder.attr('value', attrPh);
$placeholder.bind('focus', function() {
var $this = $(this);
if($this.val() === attrPh)
$this.val('').removeClass('placeholder');
}).bind('blur', function() {
var $this = $(this);
if($this.val() === '')
$this.val(attrPh).addClass('placeholder');
});
}
});
};
})(jQuery);
jQuery(function($){
$(document).ready(function(){
if (!Modernizr.input.placeholder) { $("input[placeholder], textarea[placeholder]").replaceholder() }
})
})

View File

@ -0,0 +1,33 @@
/**
* SyntaxHighlighter
* http://alexgorbatchev.com/SyntaxHighlighter
*
* SyntaxHighlighter is donationware. If you are using it, please donate.
* http://alexgorbatchev.com/SyntaxHighlighter/donate.html
*
* @version
* 3.0.83 (July 02 2010)
*
* @copyright
* Copyright (C) 2004-2010 Alex Gorbatchev.
*
* @license
* Dual licensed under the MIT and GPL licenses.
*/
;(function()
{
// CommonJS
typeof(require) != 'undefined' ? SyntaxHighlighter = require('shCore').SyntaxHighlighter : null;
function Brush()
{
};
Brush.prototype = new SyntaxHighlighter.Highlighter();
Brush.aliases = ['text', 'plain', 'haml'];
SyntaxHighlighter.brushes.Plain = Brush;
// CommonJS
typeof(exports) != 'undefined' ? exports.Brush = Brush : null;
})();

View File

@ -110,3 +110,4 @@
// CommonJS // CommonJS
typeof(exports) != 'undefined' ? exports.Brush = Brush : null; typeof(exports) != 'undefined' ? exports.Brush = Brush : null;
})(); })();

View File

@ -0,0 +1,69 @@
/**
* SyntaxHighlighter
* http://alexgorbatchev.com/SyntaxHighlighter
*
* SyntaxHighlighter is donationware. If you are using it, please donate.
* http://alexgorbatchev.com/SyntaxHighlighter/donate.html
*
* @version
* 3.0.83 (July 02 2010)
*
* @copyright
* Copyright (C) 2004-2010 Alex Gorbatchev.
*
* @license
* Dual licensed under the MIT and GPL licenses.
*/
;(function()
{
// CommonJS
typeof(require) != 'undefined' ? SyntaxHighlighter = require('shCore').SyntaxHighlighter : null;
function Brush()
{
function process(match, regexInfo)
{
var constructor = SyntaxHighlighter.Match,
code = match[0],
tag = new XRegExp('(&lt;|<)[\\s\\/\\?]*(?<name>[:\\w-\\.]+)', 'xg').exec(code),
result = []
;
if (match.attributes != null)
{
var attributes,
regex = new XRegExp('(?<name> [\\w:\\-\\.]+)' +
'\\s*=\\s*' +
'(?<value> ".*?"|\'.*?\'|\\w+)',
'xg');
while ((attributes = regex.exec(code)) != null)
{
result.push(new constructor(attributes.name, match.index + attributes.index, 'color1'));
result.push(new constructor(attributes.value, match.index + attributes.index + attributes[0].indexOf(attributes.value), 'string'));
}
}
if (tag != null)
result.push(
new constructor(tag.name, match.index + tag[0].indexOf(tag.name), 'keyword')
);
return result;
}
this.regexList = [
{ regex: new XRegExp('(\\&lt;|<)\\!\\[[\\w\\s]*?\\[(.|\\s)*?\\]\\](\\&gt;|>)', 'gm'), css: 'color2' }, // <![ ... [ ... ]]>
{ regex: SyntaxHighlighter.regexLib.xmlComments, css: 'comments' }, // <!-- ... -->
{ regex: new XRegExp('(&lt;|<)[\\s\\/\\?]*(\\w+)(?<attributes>.*?)[\\s\\/\\?]*(&gt;|>)', 'sg'), func: process }
];
};
Brush.prototype = new SyntaxHighlighter.Highlighter();
Brush.aliases = ['xml', 'xhtml', 'xslt', 'html'];
SyntaxHighlighter.brushes.Xml = Brush;
// CommonJS
typeof(exports) != 'undefined' ? exports.Brush = Brush : null;
})();

File diff suppressed because one or more lines are too long

View File

@ -1,4 +1,4 @@
function changeTheme(theme) { function changeTheme(theme, setCookie) {
el = $('html'); el = $('html');
if (!theme) theme = el.hasClass('dark') ? 'light': 'dark'; if (!theme) theme = el.hasClass('dark') ? 'light': 'dark';
@ -10,18 +10,25 @@ function changeTheme(theme) {
setThemePreference(theme); setThemePreference(theme);
} }
function changeSyntax(syntax) { function changeSyntax(style, setCookie){
el = $('html'); el = $('html');
el.removeClass('scss'); el.removeClass('sass');
el.addClass(style);
setStyleSyntaxPreference(style);
}
if (!syntax) { function changeExampleStyleSyntax(style, setCookie){
syntax = el.hasClass('scss') ? 'sass': 'scss'; el = $('html');
} else if (el.hasClass(syntax)) { el.removeClass('scss'); el.removeClass('sass'); el.removeClass('css');
return; el.addClass(style);
} setExampleStyleSyntaxPreference(style);
el.removeClass('scss'); }
el.removeClass('sass');
el.addClass(syntax); function changeExampleMarkupSyntax(markup){
setSyntaxPreference(syntax); el = $('html');
el.removeClass('haml'); el.removeClass('html');
el.addClass(markup);
setExampleMarkupSyntaxPreference(markup);
} }
function setThemePreference(theme) { function setThemePreference(theme) {
@ -31,43 +38,78 @@ function setThemePreference(theme) {
path: '/' path: '/'
}); });
} }
function getThemePreference(defaultTheme) { function getThemePreference(defaultTheme) {
theme = $.cookie("compass-theme"); theme = $.cookie("compass-theme");
if (theme) { if (theme) {
changeTheme(theme); changeTheme(theme, false);
} else { } else {
changeTheme(defaultTheme); changeTheme(defaultTheme, true);
} }
} }
function setSyntaxPreference(syntax) {
function setStyleSyntaxPreference (mainSyntax) {
$.cookie("compass-syntax", null); $.cookie("compass-syntax", null);
$.cookie("compass-syntax", syntax, { $.cookie("compass-syntax", mainSyntax, { expires: 60 * 60 * 24 * 365 * 10, path: '/' });
expires: 60 * 60 * 24 * 365 * 10,
path: '/'
});
} }
function getSyntaxPreference(defaultSyntax) {
syntax = $.cookie("compass-syntax"); function setExampleStyleSyntaxPreference (exampleStyle) {
if (syntax){ $.cookie("compass-example-style", null);
changeSyntax(syntax); $.cookie("compass-example-style", exampleStyle, { expires: 60 * 60 * 24 * 365 * 10, path: '/' });
} else { }
changeSyntax(defaultSyntax);
function setExampleMarkupSyntaxPreference (exampleMarkup) {
$.cookie("compass-example-markup", null);
$.cookie("compass-example-markup", exampleMarkup, { expires: 60 * 60 * 24 * 365 * 10, path: '/' });
}
function getSyntaxPreference(defaultSyntax, defaultMarkup) {
mainSyntaxCookie = $.cookie("compass-syntax");
mainSyntax = (mainSyntaxCookie) ? mainSyntaxCookie : defaultSyntax;
changeSyntax(mainSyntax);
// add example styling preferences
if ($('body').hasClass('demo')){
markupCookie = $.cookie("compass-example-markup");
styleCookie = $.cookie("compass-example-style");
markup = (markupCookie) ? markupCookie : defaultMarkup;
style = (styleCookie) ? styleCookie : defaultSyntax;
changeExampleStyleSyntax(style)
changeExampleMarkupSyntax(markup);
} }
} }
getThemePreference('dark'); getThemePreference('dark');
getSyntaxPreference('scss');
$('document').ready(function(){ $('document').ready(function(){
getSyntaxPreference('scss', 'html');
$('#page').click(function(event){ $('#page').click(function(event){
var target = $(event.target); var target = $(event.target);
// Set Main Syntax Preference
if (target.parent().is('#syntax_pref')) { if (target.parent().is('#syntax_pref')) {
changeSyntax(target.attr("rel")); changeSyntax(target.attr("rel"), true);
event.preventDefault(); event.preventDefault();
// Set Demo page syntax preferences
} else if (target.parent().is('.syntax_pref')) {
event.preventDefault();
if (target.parent().parent().is('#markup')) {
changeExampleMarkupSyntax(target.attr("rel"), true);
} else {
changeExampleStyleSyntax(target.attr("rel"), true);
}
// Set Theme preference
} else if (target.is('#theme_pref') || target.parent().is('#theme_pref')) { } else if (target.is('#theme_pref') || target.parent().is('#theme_pref')) {
changeTheme(); changeTheme();
event.preventDefault(); event.preventDefault();
// View source for mixins & functions
} else if (target.attr("rel") == "view source") { } else if (target.attr("rel") == "view source") {
$(target.attr("href")).toggle(); $(target.attr("href")).toggle();
event.preventDefault(); event.preventDefault();

12
doc-src/authors.yml Normal file
View File

@ -0,0 +1,12 @@
chris:
fullname: Chris Eppstein
byline_link: http://chriseppstein.github.com/
brandon:
fullname: Brandon Mathis
eric:
fullname: Eric Meyer
byline_link: http://eric.oddbird.net/
nico:
fullname: Nico Hagenburger
scott:
fullname: Scott Davis

View File

@ -6,5 +6,6 @@ data_sources:
- items_root: /assets - items_root: /assets
layouts_root: /assets layouts_root: /assets
type: filesystem_assets type: filesystem_assets
text_extensions: [ 'css', 'erb', 'haml', 'htm', 'html', 'js', 'less', 'markdown', 'md', 'php', 'rb', 'sass', 'scss', 'txt' ] text_extensions: [ 'css', 'erb', 'haml', 'htm', 'html', 'js', 'less', 'markdown', 'md', 'php', 'rb', 'sass', 'scss', 'txt', 'xml' ]
output_dir: output output_dir: output
base_url: http://compass-style.org

View File

@ -0,0 +1,282 @@
---
title: Compass v0.11.0 Beta History
crumb: CHANGELOG
body_id: changelog
layout: article
---
0.11.beta.8 (UNRELEASED)
------------------------
* Created an official API to add configuration options to compass.
[More information](/help/tutorials/extending/).
0.11.beta.7 (04/16/2011)
------------------------
* Added support for the new webkit gradient syntax that matches the css3 specification.
Support for older webkit browsers remains enabled at this time.
To disable it, set `$support-for-original-webkit-gradients` to false.
* There is a new mixin for creating
[pure-css grid backgrounds](/reference/compass/layout/grid_background/)
for verifying grid alignment for both fixed and fluid grids.
* Add support for pixel-based gradients in the original webkit gradient syntax.
* Added a vertical rhythm function for calculating rhythms without returning a property.
0.11.beta.6 (04/10/2011)
------------------------
* Added support for degree-based linear and radial gradients (not yet supported for SVG gradients)
* Added opera prefix support for linear and radial gradients.
* The CSS3 `background` mixin's "simple" background that came
before the prefixed versions has been removed. If you
need to target css2 background it is recommended that you set a
the background property before calling the `background` mixin
or you can call the `background-with-css2-fallback` if you want
keep using compass's automatic simplification of the arguments.
* Bug fixes
* Fixed and issue with the compass gemspec in rubygems 1.7
* Fixed a bug with sprite imports
0.11.beta.5 (03/27/2011)
------------------------
### Compass Sprites
[Magic Selectors](/help/tutorials/spriting/#magic-selectors) have been added
Fixed a bug causing a stack level too deep in ruby 1.8.7
0.11.beta.4 (03/25/2011)
------------------------
* Extensions that are installed into ~/.compass/extensions will be automatically available to all your compass projects.
### Compass Internals
* Fixed a small bug in callbacks that was causing them to register twice
* The Sprite classes have been abstracted allowing for different engines
* Bumped chunky_png version to 1.1.0
* Total rewrite of the sprite generation classes - thanks to [@johnbintz](https://github.com/johnbintz) for the help
* More Rspec tests
0.11.beta.3 (03/15/2011)
------------------------
### Compass CSS3
* A new CSS3 mixin for [appearance](/reference/compass/css3/appearance/) was added.
* The font-face mixin has been updated again with the [syntax recommendations
from font-spring](http://www.fontspring.com/blog/the-new-bulletproof-font-face-syntax).
The API has not changed.
### Compass Typography
* Some text-based mixins have been moved from utilities to the new
typography module. The old imports are deprecated now.
Affected modules: utilities/links, utilities/lists, and utilities/text and
their sub-modules.
* There is a new typography module: [Vertical Rhythm](/reference/compass/typography/vertical_rhythm/).
This makes it easier to align the typography of your page to a common rhythm.
### Compass Utilities
* A new mixin `reset-float` is available in the [float module](/reference/compass/utilities/general/float/#mixin-reset-float) that makes it easier to reset the floats introduced from that module.
* A new mixin `reset-float` is available in the [float module](/reference/compass/utilities/general/float/#mixin-reset-float) that makes it easier to reset the floats introduced from that module.
* A new module has been added to create readable text against an arbitrary background color based on the lightness of the background: [compass/utilities/color/contrast](/reference/compass/utilities/color/contrast/).
* The comma-delimited-list has been renamed to delimited-list and
generalized to accept a delimiter which defaults to a comma.
The old function continues to exist, but is deprecated.
### Compass Internals
* You can now register callbacks for compilation events so that you can take
custom actions when they occur. For instance, you might want to notify
Growl when a stylesheet compilation error occurs.
* Bug fixes & performance improvements.
0.11.beta.2 (02/01/2011)
------------------------
* Updated the font-face mixin so it works in Android 2.2.
Credit: [Paul Irish](http://paulirish.com/).
* The deprecated & unused arguments to the font-face mixin have been removed.
0.11.beta.1 (01/17/2011)
------------------------
* Add an option `--skip-overrides` to the sprite
subcommand. When provided, the default variables for overriding the sprite
behavior are not created. Instead, you would change the call to
`sprite-map()` to customize your sprite map.
* Rename the `sprite-position` mixin in the new `sprite/base` module to
`sprite-background-position` in order avoid a naming conflict with the old
sprite module.
0.11.beta.0 (01/09/2011)
------------------------
Compass v0.11 is now feature complete. Future changes to this release will be doc improvements, bug fixes, performance tuning, and addressing user feedback.
* Added optional support for IE8 with $legacy-support-for-ie8 which defaults to true.
* Updated the opacity and filter-gradient mixins to make IE's hacky DirectX filters
optional based on Compass's legacy support settings.
* Added the ability to piggy back on compass's watcher within your configuration file.
See the [configuration reference](/help/tutorials/configuration-reference/) for details.
* The options passed to the CLI can now be inspected within the compass configuration file.
The CLI options will still override the values set within the config file, but they might
inform other values. For instance `compass compile -e production` will have the environment
parameter preset to `:production` so that you can set other values in the project accordingly.
* New infrastructure for supporting experimental css3 functions that are prefixed but have the same
syntax across all browsers. It is now possible to configure which browsers support which
experimental functions outside of the compass release cycle. For details, see the
[cross browser helpers](/reference/compass/helpers/cross-browser/).
* [Blueprint] Added a new sass function called span($n) to the grid module which replaces
the now **deprecated span mixin**. If you are using this mixin, please replace it with:
`width: span($n)`.
* [Blueprint] Blueprint no longer adds `!important` to the widths of `input`, `textarea`,
and `select` form fields, so compass no longer defaults to using `!important` in those cases.
If you were relying on this behavior, you may need to adjust your stylesheets accordingly.
0.11.alpha.4 (12/08/2010)
-------------------------
* Add a `--time` option to the compile and watch commands. This will print out
the time spent compiling each sass file and a total at the end.
* Upgrade FSSM, the internal library that monitors the filesystem events for compass.
* Removed the command line options that were deprecated in v0.10.
0.11.alpha.3 (12/05/2010)
-------------------------
* Fix a bug in compass running under ruby 1.9.2 that was introduced in v0.11.alpha.2.
0.11.alpha.2 (12/05/2010)
-------------------------
* Merge with Lemonade. Compass now provides a full featured spriting solution.
See the [spriting tutorial](/help/tutorials/spriting/) for more information.
* Compass now depends on Sass 3.1. You can install the preview release:
`gem install sass --pre`. Note: you must also upgrade your haml gem if you
use both in the same application.
* A third argument is now available on the `image-url()` helper. When `true` or
`false`, it will enable/disable the cache buster for a single image url. Or when
a string, it will be the cache buster used.
* Upgrade CSS3 PIE to 1.0-beta3.
* Bug fixes.
0.11.alpha.1 (11/22/2010)
-------------------------
* Support for Sass 3.1 alpha version
* CSS3 PIE module. [Docs](/reference/compass/css3/pie/).
* The versioned modules in the last release have been removed. There is now
just a single module for each and the overloaded mixins will discern
deprecated usage and warn accordingly.
* Allow erb processing of non all non-binary filetypes during extension installs.
* Added a `background` mixin for css3 gradient support in the shorthand style.
* Fix for gradients in opera with bordered elements.
* The `multiple-text-shadows` and `multiple-box-shadows` mixins that were present in
v0.11.alpha.0 were removed because they were unnecessary. Just use the `text-shadow`
and `box-shadow` mixins.
* The docs are [getting a make-over](http://beta.compass-style.org/) by Brandon :)
0.11.alpha.0 (11/15/2010)
-------------------------
Note: Compass does not currently support Sass 3.1 alphas.
### Deprecations
* Deprecated imports and APIs from v0.10 have been removed.
* Changed defaults for the box-shadow and text-shadow mixins.
Previously the horizontal and vertical offset were both 1, which
expected a top left light source. They are now set to 0 which assumes
a direct light source, a more generic default.
* The linear-gradient and radial-gradient mixins have been deprecated.
Instead use the background-image mixin and pass it a gradient function.
The deprecation warning will print out the correct call for you to use.
* Passing an argument to the `blueprint-scaffolding` mixin is not necessary
and has been deprecated.
* Some blueprint color defaults now use color functions instead of color arithmetic.
This may result in different output for those who have color customizations.
### Blueprint
* Updated from blueprint 0.9 to blueprint 1.0
* Added .info and .alert classes to forms.css [CMM]
* Fixed numerous bugs in forms, including the fieldset padding bug in IE6-8 [CMM]
* Fixed specificity problems in typography.css and grid.css [CMM]
* See Lighthouse for more bug fixes
* Full [blueprint changelog][blueprint_10_change]
* If for some reason you'd like to stay on the older version of blueprint you can run
the following command in your project before you upgrade (or after temporarily downgrading):
`compass unpack blueprint`
### CSS3 v2.0
Our CSS3 module makes writing CSS3 today almost as easy as it will be when all
the browsers officially support the new features. The second version of the
compass CSS module brings the API up to date with developments over the past
6 to 9 months of browser changes and more closely matching the most recent CSS
specifications. [Upgrade guide](/help/tutorials/upgrading/antares/). Summary of changes.
* Support for multiple box shadows and text shadows
* Support for 2d and 3d transforms
* Opt-in SVG support for gradients in opera and IE9.
Set `$experimental-support-for-svg : true` in your
stylesheet to enable it.
* Fixed a radial gradient position bug.
* To generate a simple linear gradient in IE6 & 7, you can now use
the `filter-gradient` mixin.
* New `background-image` mixin with gradient support and allowing
up to 10 images.
* Gradient support for the border-image property.
* Gradient support for list-style-image property.
* Gradient support for the content property.
### Helpers
* `linear-gradient()` & `radial-gradient()` helpers now intercept standard css
functions and parse them into Sass Literals. These work with new vendor helpers
(`-moz()`, `-webkit`, `-o`, `-ie`, and `-svg` (yes I know svg is not a vendor))
to return specific representations of the linear & radial gradients. The
`prefixed()` function will check a value to see if it has a certain
vendor-specific representation.
* New color helpers: `adjust-lightness`, `adjust-saturation`, `scale-lightness`, and `scale-saturation`
make it easier to construct apis that manipulate these color attributes.
* The `elements-of-type()` helper now returns html5 elements when the display is `block`
and also will return only html5 elements for `elements-of-type(html5)`
* Compass now provides several helper functions related to trigonometry.
There's no practical use, but it's hoped that users will find fun things to
do with these for technology demonstrations:
* `sin($number)` - Takes the sine of the number.
* `cos($number)` - Takes the cosine of the number.
* `tan($number)` - Takes the tangent of the number.
* `pi()` - Returns the value of π.
If you provide a number with units of `deg` then it will return a unitless number
after converting to radians. Otherwise, it assumes the number is a radian length measure
and passes the units along to the result.
* `ie-hex-str($color)` returns a #AARRGGBB formatted color suitable for
passing to IE filters.
* A new function `if()` that allows you to switch on a value without using `@if`.
Usage: `if($truth-value, $value-if-true, $value-if-false)`.
* Compass has added a number of new helper functions for lists that begin with
`-compass`, helpers that begin with `-compass` should be considered "private" and
are not to be used by compass users. Sass 3.1 will have proper list support,
these are a work around until that time.
### Configuration
* Added a new configuration property to disable sass warnings: `disable_warnings`
### Core Framework
* New layout mixins for absolute positioning: stretch, stretch-x, stretch-y
### Rails
* In rails 3, there's no need for an initializer. Instead we use a
Railstie.
* We now default to app/stylesheets for sass files and public/stylesheets for
css files -- though they can still be changed after installation or on the
command line during project initialization.
* Compass is now a gem plugin in a rails environment.
* In a rails3 environment the compass configuration can now be
changed without restarting the rails server process.

View File

@ -2,42 +2,98 @@
title: Compass History title: Compass History
crumb: CHANGELOG crumb: CHANGELOG
body_id: changelog body_id: changelog
layout: article layout: default
--- ---
COMPASS CHANGELOG COMPASS CHANGELOG
================= =================
Upgrading compass is really easy. Upgrading compass is pretty easy.
Don't let all these details [scare you...](/help/tutorials/upgrading/im-scared/) Don't let all these details [scare you...](/help/tutorials/upgrading/im-scared/)
The Documentation for the [latest stable release](http://compass-style.org/docs/): The Documentation for the [latest stable release](http://compass-style.org/docs/):
The Documentation for the [latest preview release](http://beta.compass-style.org/) The Documentation for the [latest preview release](http://beta.compass-style.org/)
0.11.alpha.1 (11/22/2010) 0.11.6 (UNRELEASED)
--------------------------- -------------------
* Support for Sass 3.1 alpha version * Added `user-select` mixin to control the selection model and granularity of an element. It accepts one argument (`$select`) from the following options: `none` | `text` | `toggle` | `element` | `elements` | `all` | `inherit`.
* CSS3 PIE module. [Docs](/reference/compass/css3/pie/).
* The versioned modules in the last release have been removed. There is now
just a single module for each and the overloaded mixins will discern
deprecated usage and warn accordingly.
* Allow erb processing of non all non-binary filetypes during extension installs.
* Added a `background` mixin for css3 gradient support in the shorthand style.
* Fix for gradients in opera with bordered elements.
* The `multiple-text-shadows` and `multiple-box-shadows` mixins that were present in
v0.11.alpha.0 were removed because they were unnecessary. Just use the `text-shadow`
and `box-shadow` mixins.
* The docs are [getting a make-over](http://beta.compass-style.org/) by Brandon :)
0.11.alpha.0 (11/15/2010) 0.11.5 (07/10/2011)
--------------------------- -------------------
Note: Compass does not currently support Sass 3.1 alphas. * Updated the list of elements returned by the `elements-of-type()` helper.
It now understands `html5-block` and `html5-inline` and other types now
return html5 elements in them by default.
* Fix warning logic in vertical-rhythms module.
* Fix typo in the css3/transition module.
### Deprecations 0.11.4 (07/03/2011)
-------------------
* Deprecated imports and APIs from v0.10 have been removed. * Vertical rhythm now supports absolute units like pixels.
Set `$relative-font-sizing` to `false` to enable.
* Vertical rhythm now has a minimum padding that defaults to 2px.
This makes some edge cases look better.
* New mixin `force-wrap` prevents URLs and long lines of text from breaking layouts.
* Fix absolute path detection on windows.
* Fix the mime type returned for inline svg images.
* Allow multiple transitions in the CSS3 `transition` mixin.
* The Blueprint `:focus` styles no longer clobbers cascade-based overrides unnecessarily.
* The Blueprint grid-background vertical rhythm is now based off of $blueprint-font-size,
rather than a static value of 20px
0.11.3 (06/11/2011)
-------------------
**Note:** Due to some internal changes to compass you may have issue with your sass cache. Run `compass clean` to clear your cache.
* The `pie-clearfix` mixin has been updated. If you have to
support Firefox < 3.5, please update your stylesheets
to use `legacy-pie-clearfix` instead.
* Added a new command: `compass clean` which removes any generated
css files and clears the sass cache.
* Enable IE 10 support for flexible box with the -ms prefix.
* A small change to how generated sprites are named for better
rails 3.1 compatibility.
* Fixes for the compass --quiet mode.
* It is now possible to generate cache buster urls that manipulate
the path of the image instead of the query string. This makes
images work better with proxies, but will require some web server
configuration. [Docs](/help/tutorials/configuration-reference/#asset-cache-buster)
* Numerous small bug fixes to sprites.
* Sprite Engines are now classes see [Docs](/help/tutorials/extending) for more information
* Sprite classes have bee re-factored into modules for readability
* Sprites will no longer cause `undefined method 'find' for #<Compass::SpriteMap>` when adding or removing sprite files
0.11.2 (06/10/2011)
-------------------
* Sprites will now by default remove any old versions of the sprite. A new configuration
variable has been created to override this.
* Nested sprites are now supported using globs `@import 'nested/**/*.png';`.
* Fixed a bug that was causing sprite variable options to not get passed to the image classes.
* Sass Colors will no longer cause an error if you use them as sprite names.
* Added support for -ms gradients in background-image and background properties
* Give a better error if Sass::Script::Functions.declare does not exist.
0.11.1 (04/25/2011)
-------------------
* This release fixed some Gem dependency issues with Sass.
0.11.0 (04/24/2011)
-------------------
This changelog entry is aggregated across all the v0.11 beta releases.
If you're upgrading from a previous beta v0.11 beta release, you can read
[the 0.11 beta release notes here](/CHANGELOG-v0-11-beta/).
### !important
#### Breaking Changes & Deprecations:
* Deprecated imports and APIs from v0.10 have been removed. If you are upgrading
from v0.8, please upgrade to v0.10 before installing v0.11.
* Changed defaults for the box-shadow and text-shadow mixins. * Changed defaults for the box-shadow and text-shadow mixins.
Previously the horizontal and vertical offset were both 1, which Previously the horizontal and vertical offset were both 1, which
expected a top left light source. They are now set to 0 which assumes expected a top left light source. They are now set to 0 which assumes
@ -49,6 +105,31 @@ Note: Compass does not currently support Sass 3.1 alphas.
and has been deprecated. and has been deprecated.
* Some blueprint color defaults now use color functions instead of color arithmetic. * Some blueprint color defaults now use color functions instead of color arithmetic.
This may result in different output for those who have color customizations. This may result in different output for those who have color customizations.
* The deprecated & unused arguments to the `font-face` mixin have been removed.
* Lemonade has been merged into compass. If you've been using Lemonade, you need to
upgrade your sprites to use the new [Compass Sprites](/help/tutorials/spriting/).
#### Dependencies
* Compass now depends on Sass 3.1 which is a new stand-alone gem that has been separated
from Haml. **If you have Haml installed, you must upgrade it to 3.1 as well.**
* Compass now depends on ChunkyPNG, a pure-ruby library for generating PNG files.
* The FSSM library that used to be vendored is now upgraded and a normal gem dependency.
If you don't know what this means, then you don't need to care :)
### New Sass Features
Sass 3.1 brings a ton of great new features that Compass now uses and you can too!
* Proper List Support. Space and Comma separated lists used to cause values to become strings when passing them to mixins. Now the values in lists are preserved as their original types.
* Sass-based Functions. Define your own value functions and use them anywhere.
* Keyword Style Argument passing to Functions and Mixins. It can be hard to understand what
the values being passed to a mixin or function are for, use keyword style arguments to
make it easier to understand what's going on.
* `@media` bubbling. Use a media declaration anywhere and it will be bubbled to the top level
for you.
For more information about the new Sass features, see the [Sass CHANGELOG](http://sass-lang.com/docs/yardoc/file.SASS_CHANGELOG.html).
### Blueprint ### Blueprint
@ -61,8 +142,26 @@ Note: Compass does not currently support Sass 3.1 alphas.
* If for some reason you'd like to stay on the older version of blueprint you can run * If for some reason you'd like to stay on the older version of blueprint you can run
the following command in your project before you upgrade (or after temporarily downgrading): the following command in your project before you upgrade (or after temporarily downgrading):
`compass unpack blueprint` `compass unpack blueprint`
* [Blueprint] Blueprint no longer adds `!important` to the widths of `input`, `textarea`,
and `select` form fields, so compass no longer defaults to using `!important` in those cases.
If you were relying on this behavior, you may need to adjust your stylesheets accordingly.
* [Blueprint] Added a new sass function called span($n) to the grid module which replaces
the now **deprecated span mixin**. If you are using this mixin, please replace it with:
`width: span($n)`.
### CSS3 v2.0 ### Spriting Support
* Compass now has a world-class spriting system after merging with [Lemonade][lemonade].
See the [spriting tutorial](/help/tutorials/spriting/) for more information.
* The [old sprite module](/reference/compass/utilities/sprites/sprite_img/) is still available
for working with hand-generated sprite maps.
* The Sprite internals are abstracted allowing for different engines. By default
compass uses ChunkyPNG which only supports PNG files, so some users might prefer
ImageMagic which is available via a [plugin](#XXXLINKME).
* [Magic Selectors](/help/tutorials/spriting/#magic-selectors) make it simple to define
sprites that work with user interaction pseudo classes like `:hover`, `:active`, etc.
### CSS3 Module v2.0
Our CSS3 module makes writing CSS3 today almost as easy as it will be when all Our CSS3 module makes writing CSS3 today almost as easy as it will be when all
the browsers officially support the new features. The second version of the the browsers officially support the new features. The second version of the
@ -70,30 +169,39 @@ compass CSS module brings the API up to date with developments over the past
6 to 9 months of browser changes and more closely matching the most recent CSS 6 to 9 months of browser changes and more closely matching the most recent CSS
specifications. [Upgrade guide](/help/tutorials/upgrading/antares/). Summary of changes. specifications. [Upgrade guide](/help/tutorials/upgrading/antares/). Summary of changes.
* Support for multiple box shadows and text shadows * Support for multiple [box shadows](/reference/compass/css3/box_shadow/)
* Support for 2d and 3d transforms and multiple [text shadows](/reference/compass/css3/text-shadow/)
* Opt-in SVG support for gradients in opera and IE9. * Support for [2d and 3d transforms](/reference/compass/css3/transform/)
Set `$experimental-support-for-svg : true` in your * Opt-in [SVG support](/reference/compass/support/#const-experimental-support-for-svg)
for gradients in opera and IE9. Set `$experimental-support-for-svg : true` in your
stylesheet to enable it. stylesheet to enable it.
* Fixed a radial gradient position bug.
* To generate a simple linear gradient in IE6 & 7, you can now use * To generate a simple linear gradient in IE6 & 7, you can now use
the `filter-gradient` mixin. the [filter-gradient mixin](/reference/compass/css3/images/#mixin-filter-gradient).
* New `background-image` mixin with gradient support and allowing * New [images module](/reference/compass/css3/images/) makes gradients simple for
up to 10 images. all properties that support them using the CSS3 standard syntax.
* Gradient support for the border-image property. * Compass now has opt-in support for the CSS3 PIE library. [Docs](/reference/compass/css3/pie/).
* Gradient support for list-style-image property. * Added optional support for IE8 with `$legacy-support-for-ie8` which defaults to true.
* Gradient support for the content property. * Updated the `opacity` and `filter-gradient` mixins to make IE's hacky DirectX filters
optional based on Compass's legacy support settings.
* A new CSS3 mixin for [appearance](/reference/compass/css3/appearance/) was added.
* The font-face mixin has been updated again with the [syntax recommendations
from font-spring](http://www.fontspring.com/blog/the-new-bulletproof-font-face-syntax).
The API has not changed.
* Added support for the new webkit gradient syntax that matches the css3 specification.
Support for older webkit browsers remains enabled at this time.
To disable it, set `$support-for-original-webkit-gradients` to false.
### Helpers ### Helper Functions
* `linear-gradient()` & `radial-gradient()` helpers now intercept standard css * `linear-gradient()` & `radial-gradient()` helpers now intercept standard css
functions and parse them into Sass Literals. These work with new vendor helpers functions and parse them into Sass Literals. These work with new vendor helpers
(`-moz()`, `-webkit`, `-o`, `-ie`, and `-svg` (yes I know svg is not a vendor)) (`-moz()`, `-webkit`, `-o`, `-ie`, and `-svg` (yes, we know svg is not a vendor))
to return specific representations of the linear & radial gradients. The to return specific representations of the linear & radial gradients. The
`prefixed()` function will check a value to see if it has a certain `prefixed()` function will check a value to see if it has a certain
vendor-specific representation. vendor-specific representation.
* New color helpers: `adjust-lightness`, `adjust-saturation`, `scale-lightness`, and `scale-saturation` * New color helpers: `adjust-lightness`, `adjust-saturation`, `scale-lightness`,
make it easier to construct apis that manipulate these color attributes. and `scale-saturation` make it easier to construct apis that manipulate these
color attributes.
* The `elements-of-type()` helper now returns html5 elements when the display is `block` * The `elements-of-type()` helper now returns html5 elements when the display is `block`
and also will return only html5 elements for `elements-of-type(html5)` and also will return only html5 elements for `elements-of-type(html5)`
* Compass now provides several helper functions related to trigonometry. * Compass now provides several helper functions related to trigonometry.
@ -104,29 +212,68 @@ specifications. [Upgrade guide](/help/tutorials/upgrading/antares/). Summary of
* `tan($number)` - Takes the tangent of the number. * `tan($number)` - Takes the tangent of the number.
* `pi()` - Returns the value of π. * `pi()` - Returns the value of π.
If you provide a number with units of `deg` then it will return a unitless number If you provide a number with units of `deg` then it will return a unitless number
after converting to radians. Otherwise, it assumes the number is a radian length measure after converting to radians. Otherwise, it assumes the number is a radian length
and passes the units along to the result. measure and passes the units along to the result.
* `ie-hex-str($color)` returns a #AARRGGBB formatted color suitable for * `ie-hex-str($color)` returns a #AARRGGBB formatted color suitable for
passing to IE filters. passing to IE filters.
* A new function `if()` that allows you to switch on a value without using `@if`. * Compass has added a number of new helper functions that begin with
Usage: `if($truth-value, $value-if-true, $value-if-false)`. `-compass`, helpers that begin with `-compass` should be considered "private"
* Compass has added a number of new helper functions for lists that begin with and are not to be used.
`-compass`, helpers that begin with `-compass` should be considered "private" and * A third argument is now available on the `image-url()` helper. When `true` or
are not to be used by compass users. Sass 3.1 will have proper list support, `false`, it will enable/disable the cache buster for a single image url. Or when
these are a work around until that time. a string, will be the cache buster value that is used.
### Configuration ### Configuration Files
* Added a new configuration property to disable sass warnings: `disable_warnings` * Added a new configuration property to disable sass warnings: `disable_warnings`
* New infrastructure for supporting experimental css3 functions that are prefixed but have
the same syntax across all browsers. It is now possible to configure which browsers
support which experimental functions outside of the compass release cycle.
For details, see the [cross browser helpers](/reference/compass/helpers/cross-browser/).
* The options passed to the CLI can now be inspected within the compass configuration file.
The CLI options will still override the values set within the config file, but they might
inform other values. For instance `compass compile -e production` will have the environment
parameter preset to `:production` so that you can set other values in the project accordingly.
* Added the ability to piggy back on compass's watcher within your configuration file.
See the [configuration reference](/help/tutorials/configuration-reference/) for details.
* You can now register callbacks for compilation events so that you can take
custom actions when they occur. For instance, you might want to notify
Growl when a stylesheet compilation error occurs.
### Core Framework ### New Compass Typography Module
* Some text-based mixins have been moved from utilities to the new
typography module. The old imports are deprecated now.
Affected modules: `utilities/links`, `utilities/lists`, and `utilities/text` and
their sub-modules.
* There is a new typography module:
[Vertical Rhythm](/reference/compass/typography/vertical_rhythm/).
This makes it easier to align the typography of your page to a common rhythm.
### Compass Layout Module
* New layout mixins for absolute positioning: stretch, stretch-x, stretch-y * New layout mixins for absolute positioning: stretch, stretch-x, stretch-y
* There is a new mixin for creating
[pure-css grid backgrounds](/reference/compass/layout/grid_background/)
for verifying grid alignment for both fixed and fluid grids.
### Compass Utilities
* A new mixin `reset-float` is available in the [float module](/reference/compass/utilities/general/float/#mixin-reset-float) that makes it easier to reset the floats introduced from that module.
* A new module has been added to create readable text against an arbitrary background color based on the lightness of the background: [compass/utilities/color/contrast](/reference/compass/utilities/color/contrast/).
* The comma-delimited-list has been renamed to delimited-list and
generalized to accept a delimiter which defaults to a comma.
The old function continues to exist, but is deprecated.
### Command Line
* Add a `--time` option to the compile and watch commands. This will print out
the time spent compiling each sass file and a total at the end.
### Rails ### Rails
* In rails 3, there's no need for an initializer. Instead we use a * In rails 3, there's no need for an initializer. Instead we use a
Railstie. Railtie. If you have one, please remove it.
* We now default to app/stylesheets for sass files and public/stylesheets for * We now default to app/stylesheets for sass files and public/stylesheets for
css files -- though they can still be changed after installation or on the css files -- though they can still be changed after installation or on the
command line during project initialization. command line during project initialization.
@ -134,6 +281,20 @@ specifications. [Upgrade guide](/help/tutorials/upgrading/antares/). Summary of
* In a rails3 environment the compass configuration can now be * In a rails3 environment the compass configuration can now be
changed without restarting the rails server process. changed without restarting the rails server process.
### Extensions
* Compass now allows ERB processing of non all non-binary filetypes during
extension installs.
* Extensions that are installed into `~/.compass/extensions` will be automatically
available to all your compass projects.
* Created an official API to add configuration options to compass.
[More information](/help/tutorials/extending/).
### Miscellaneous
* We have a new website design from [Brandon Mathis][brandon]
* Compass now officially supports the following ruby interpreters:
jruby, ruby 1.8.7, ruby 1.9.2, ree, and rubinius.
0.10.7 (UNRELEASED) 0.10.7 (UNRELEASED)
------------------- -------------------
@ -995,6 +1156,8 @@ Almost definitely. Please let me know if you encounter any problems and I'll get
[der-rich]: http://github.com/der-rich [der-rich]: http://github.com/der-rich
[adamstac]: http://github.com/adamstac [adamstac]: http://github.com/adamstac
[ttilley]: http://github.com/ttilley [ttilley]: http://github.com/ttilley
[inline-block-list]: http://compass-style.org/reference/compass/utilities/lists/inline-block-list/ [inline-block-list]: http://compass-style.org/reference/compass/typography/lists/inline-block-list/
[html5-reset]: http://compass-style.org/reference/compass/reset/utilities/#mixin-reset-html5 [html5-reset]: http://compass-style.org/reference/compass/reset/utilities/#mixin-reset-html5
[blueprint_10_change]: https://github.com/chriseppstein/compass/compare/a05e1ee7c0a1e4c0f0595a8bb812daa47872e476...864780969d872a93b1fd3b4f39f29dd9f0c3fe75 [blueprint_10_change]: https://github.com/chriseppstein/compass/compare/a05e1ee7c0a1e4c0f0595a8bb812daa47872e476...864780969d872a93b1fd3b4f39f29dd9f0c3fe75
[brandon]: http://brandonmathis.com/
[lemonade]: http://www.hagenburger.net/BLOG/Lemonade-CSS-Sprites-for-Sass-Compass.html

14
doc-src/content/blog.haml Normal file
View File

@ -0,0 +1,14 @@
---
layout: blog
---
%h1 Compass Blog
- for post in blog_posts_in_order.reverse
.post-snippet
%h2
- time = blog_date(post)
%span.timestamp= time.strftime("%Y/%m/%d")
%a{:href => post.rep_named(:default).path}= post[:title]
%p= post[:intro] || post[:description]

View File

@ -0,0 +1,14 @@
---
layout: blog
---
%h1 Compass Blog Archive
- for post in blog_posts_in_order.reverse
.post-snippet
%h2
- time = blog_date(post)
%span.timestamp= time.strftime("%Y/%m/%d")
%a{:href => post.rep_named(:default).path}= post[:title]
%p= post[:intro] || post[:description]

View File

@ -0,0 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
%feed(xmlns="http://www.w3.org/2005/Atom")
%title Compass Blog
%link(href="http://compass-style.org/blog/atom.xml" rel="self")
%link(href="http://compass-style.org/blog/")
%updated= Time.now.xmlschema
%id http://compass-style.org/blog/
%author
%name Compass Core Team
- for post in blog_posts_in_order.reverse
- full_url = "http://compass-style.org#{post.rep_named(:default).path}"
%entry
%title&= post[:title]
%link{:href=> full_url}
%updated= blog_date(post).localtime.xmlschema
%id= full_url[0..-2]
%content(type="html")
= post[:intro] || post[:description]

View File

@ -5,7 +5,7 @@
background-color: blue background-color: blue
border: 10px solid rgba(255, 0, 0, 0.5) border: 10px solid rgba(255, 0, 0, 0.5)
color: white color: white
+text-shadow(darken(#00f, 50%), 2px, 2px) +text-shadow(darken(#00f, 50%) 2px 2px)
padding: 3px padding: 3px
text-align: center text-align: center
margin-bottom: 2em margin-bottom: 2em

View File

@ -9,7 +9,7 @@
position: top left position: top left
border: 10px solid rgba(255, 0, 0, 0.5) border: 10px solid rgba(255, 0, 0, 0.5)
color: white color: white
+text-shadow(darken(#00f, 50%), 2px, 2px) +text-shadow(darken(#00f, 50%) 2px 2px)
padding: 1em padding: 1em
text-align: center text-align: center
margin-bottom: 2em margin-bottom: 2em

View File

@ -9,7 +9,7 @@
position: top left position: top left
border: 10px solid rgba(255, 0, 0, 0.5) border: 10px solid rgba(255, 0, 0, 0.5)
color: black color: black
+text-shadow(#fff, 1px, 1px, 4px) +text-shadow(#fff 1px 1px 4px)
padding: 1em padding: 1em
text-align: center text-align: center
margin-bottom: 2em margin-bottom: 2em

View File

@ -1,3 +1,4 @@
#box-shadow-default.box-shadow-example .box-shadow-example
#box-shadow-default
#box-shadow-custom.box-shadow-example #box-shadow-custom
#box-shadow-custom-multiple

View File

@ -1,15 +1,19 @@
@import compass/css3 @import compass/css3
.box-shadow-example .box-shadow-example div
width: 40px width: 40px
height: 40px height: 40px
background: #EEE background: #EEE
margin: 20px margin: 20px
float: left
// Default box shadow // Default single box shadow
#box-shadow-default #box-shadow-default
+box-shadow +single-box-shadow
// Box shadow with custom settings // Box shadow with custom settings
#box-shadow-custom #box-shadow-custom
+box-shadow(red, 2px, 2px, 10px) +box-shadow(red 2px 2px 10px)
#box-shadow-custom-multiple
+box-shadow(rgba(blue, .4) 0 0 25px, rgba(green, .2) 0 0 3px 1px inset)

View File

@ -1,3 +1,2 @@
.example .example
%h1 The Quick Brown Fox %p The Quick Brown Fox jumped over the lazy dog.
%p Jumped over the log.

View File

@ -4,4 +4,4 @@
.example .example
font-family: "Blooming Grove" font-family: "Blooming Grove"
padding: 1em font-size: 1.5em

View File

@ -1,8 +1,8 @@
--- ---
title: Gradient title: Background Gradients
description: css3 mixin for css gradients description: css3 mixin for css gradients
framework: compass framework: compass
stylesheet: compass/css3/_gradient.scss stylesheet: compass/css3/_images.scss
example: true example: true
--- ---
= render "partials/example" = render "partials/example"

View File

@ -14,30 +14,30 @@
// This will yield a radial gradient with an apparent specular highlight // This will yield a radial gradient with an apparent specular highlight
#radial-gradient #radial-gradient
+radial-gradient(color-stops(#00FFFF 10px, #1E90FF 30px), 45 45) +background-image(radial-gradient(45px 45px, #0ff 10px, #1e90ff 30px))
// This yields a linear gradient spanning from the upper left corner to the lower right corner // This yields a linear gradient spanning from the upper left corner to the lower right corner
#linear-gradient #linear-gradient
+linear-gradient(color-stops(#fff, #ddd), left top) +background-image(linear-gradient(left top, #fff, #ddd))
// This yields a gradient starting at the top with #fff, ending in #aaa // This yields a gradient starting at the top with #fff, ending in #aaa
#v-gradient #v-gradient
+linear-gradient(color-stops(#fff, #aaa)) +background-image(linear-gradient(#fff, #aaa))
// Same as above but with a #ccc at the halfway point // Same as above but with a #ccc at the halfway point
#v-gradient-2 #v-gradient-2
+linear-gradient(color-stops(#fff, #ccc, #aaa)) +background-image(linear-gradient(#fff, #ccc, #aaa))
// Same as the first example but with #ccc at the 30% from the top, and #bbb at 70% from the top // Same as the first example but with #ccc at the 30% from the top, and #bbb at 70% from the top
#v-gradient-3 #v-gradient-3
+linear-gradient(color-stops(#fff, #ccc 30%, #bbb 70%, #aaa)) +background-image(linear-gradient(#fff, #ccc 30%, #bbb 70%, #aaa))
// This yields a horizontal linear gradient spanning from left to right. // This yields a horizontal linear gradient spanning from left to right.
#h-gradient #h-gradient
+linear-gradient(color-stops(#fff, #ddd), left) +background-image(linear-gradient(left, #fff, #ddd))
#svg-gradient #svg-gradient
$experimental-support-for-svg: true $experimental-support-for-svg: true
+linear-gradient(color-stops(#2AC363, #CD8C14, #9C4CC2), left) +background-image(linear-gradient(left, #2ac363, #cd8c14, #9c4cc2))
width: 80px width: 80px
height: 80px height: 80px

View File

@ -1,9 +1,5 @@
#opacity-10.opacity-example #opacity-10.opacity-example
#opacity-20.opacity-example #opacity-20.opacity-example
#opacity-50.opacity-example #opacity-50.opacity-example
#opaque.opacity-example #opaque.opacity-example
#transparent.opacity-example #transparent.opacity-example

View File

@ -1,8 +1,3 @@
#p %div this text has no shadow
this text has no shadow .has-single-shadow this text has a shadow
.has-custom-shadow this text has a custom shadow
#p
%span(class="has-shadow") this text has a shadow
#p
%span(class="has-custom-shadow") this text has a custom shadow

View File

@ -1,7 +1,13 @@
$default-text-shadow-color: rgba(red, .6)
$default-text-shadow-blur: 3px
$default-text-shadow-v-offset: 1px
@import compass/css3 @import compass/css3
.has-shadow // Uses defaults set before the import above
+text-shadow .has-single-shadow
+single-text-shadow
// Can output up to ten text shadows
.has-custom-shadow .has-custom-shadow
+text-shadow(red, 3px, 3px, 0) +text-shadow(rgba(blue, .2) 1px 1px 0, rgba(blue, .2) 2px 2px 0, rgba(blue, .2) 3px 3px 0)

View File

@ -1,17 +1,30 @@
.example .example
Click on the the following links to make them stretch.
Click <a href="#">here</a> to dismiss it.
#stretch-container
%ul %ul
%li %li.stretch-container
%a#stretch-full(href="#stretch-full") #stretch-full
This element is fully stretched. This element is fully stretched.
%li %li.stretch-container
%a#stretch-offset(href="#stretch-offset") #stretch-offset
This element is stretched with a 1em offset on each side. This element is stretched with a 1em offset on each side.
%li %li.stretch-container
%a#stretch-x(href="#stretch-x") #stretch-x
This element is stretched horizontally. This
%li %br
%a#stretch-y(href="#stretch-y") element
This element is stretched vertically. %br
is
%br
stretched
%br
horizontally.
%li.stretch-container
#stretch-y
This
%br
element
%br
is
%br
stretched
%br
vertically.

View File

@ -1,29 +1,32 @@
@import "compass/layout/stretching" @import "compass/layout/stretching"
@import "compass/utilities"
@import "compass/css3" @import "compass/css3"
#stretch-container .stretch-container
border: 1px solid #999 border: 1px solid #999
min-width: 200px width: 200px
min-height: 200px height: 200px
position: relative position: relative
+inline-block
.stretched .stretched
$stretch-color: #4C6B99 $stretch-color: #4C6B99
border: 3px solid $stretch-color border: 3px solid $stretch-color
+border-radius(8px) +border-radius(8px)
display: block display: block
background-color: darken($stretch-color, 30%) background-color: darken($stretch-color, 30%)
color: white
text-align: center text-align: center
vertical-align: middle vertical-align: middle
padding: 2em 0 padding: 0.5em
#stretch-full:target #stretch-full
@extend .stretched @extend .stretched
+stretch +stretch
#stretch-offset:target #stretch-offset
@extend .stretched @extend .stretched
+stretch(1em, 1em, 1em, 1em) +stretch(1em, 1em, 1em, 1em)
#stretch-x:target #stretch-x
@extend .stretched @extend .stretched
+stretch-x +stretch-x
#stretch-y:target #stretch-y
@extend .stretched @extend .stretched
+stretch-y +stretch-y

View File

@ -0,0 +1,8 @@
---
title: Compass Contrast Color Example
description: Make text readable
framework: compass
stylesheet: compass/utilities/color/_contrast.scss
example: true
---
= render "partials/example"

View File

@ -0,0 +1,3 @@
.example
%p.dark This is a paragraph with a <em>dark</em> background and <em>light</em> text.
%p.light This is a paragraph with a <em>light</em> background and <em>dark</em> text.

View File

@ -0,0 +1,11 @@
$contrasted-dark-default: #333
$contrasted-light-default: #e7e7e7
@import "compass/utilities/color/contrast"
.example
p.dark
+contrasted(#5F1210)
p.light
+contrasted(#C82523)

View File

@ -152,7 +152,7 @@ crumb: Plugins and frameworks
Sass Libraries Sass Libraries
%p %p
Libraries are simply Sass stylesheets or Libraries are simply Sass stylesheets or
%a{ :href => "http://sass-lang.com/yardoc/file.SASS_REFERENCE.html#partials" } %a{ :href => "http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#partials" }
partials partials
\. \.
%ul %ul

View File

@ -0,0 +1,33 @@
---
title: Get involved with the Compass community
crumb: Get Involved
classnames:
- get-involved
layout: default
---
%h1 Get Involved With Compass
:markdown
Many [wonderful people](https://github.com/chriseppstein/compass/contributors) have helped to make Compass awesome.
Here are some ways you can get involved with the Compass community.
## Share Sweet Stylesheets
So you've written some smashing Sass and you want to share them with others. Here are some ways you can.
1. [**Contribute to Compass**](/help/tutorials/contributing).
2. [**Develop a Compass Extension**](/help/tutorials/extensions).
3. [**Contribute to Sass Recipies**](http://chriseppstein.github.com/sass-recipes/).
4. Publish your code somewhere and email a link to the [mailing list](http://groups.google.com/group/compass-users).
## Help Others
Join the [mailing list](http://groups.google.com/group/compass-users) and help answer questions and share from your experience. If you're
writing a blog post about Sass or Compass send a link to the mailing list and we'll help you spread the word.
## Give Financially
Compass is charityware. You can use it as much as you like, but we encourage you to make a donation to help the [UMDF](http://umdf.org/)
find a cure for mitochondrial disease. If you can, please [donate here](http://umdf.org/compass/). Thanks!

View File

@ -3,65 +3,59 @@ title: Compass Help
crumb: Help crumb: Help
classnames: classnames:
- help - help
layout: main - getting-started
layout: site
--- ---
%article %article
%h1#logo Compass %h1 Getting started with Compass
:markdown :markdown
Compass is a stylesheet authoring tool that uses the Sass stylesheet Compass is an open-source CSS authoring framework which uses the [Sass stylesheet
language to make your stylesheets smaller and your web site easier to language](http://sass-lang.com) to make writing stylesheets powerful and easy. If you're
maintain. Compass provides ports of the best of breed css frameworks not familiar with Sass, you can take a look at [these simple tutorials](http://sass-lang.com/tutorial.html)
that you can use without forcing you to use their presentational class to get caught up.
names. Its a new way of thinking about stylesheets that must be seen
in action!
<object width="700" height="438"><param name="allowfullscreen" value="true" /><param name="allowscriptaccess" value="always" /><param name="movie" value="http://vimeo.com/moogaloop.swf?clip_id=11671458&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1" /><embed src="http://vimeo.com/moogaloop.swf?clip_id=11671458&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1" type="application/x-shockwave-flash" allowfullscreen="true" allowscriptaccess="always" width="700" height="438"></embed></object><p><a href="http://vimeo.com/11671458">An introduction to Compass</a> from <a href="http://vimeo.com/ltackett">Lorin Tackett</a> on <a href="http://vimeo.com">Vimeo</a>.</p> <object width="700" height="438"><param name="allowfullscreen" value="true" /><param name="allowscriptaccess" value="always" /><param name="movie" value="http://vimeo.com/moogaloop.swf?clip_id=11671458&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1" /><embed src="http://vimeo.com/moogaloop.swf?clip_id=11671458&amp;server=vimeo.com&amp;show_title=1&amp;show_byline=0&amp;show_portrait=0&amp;color=00ADEF&amp;fullscreen=1" type="application/x-shockwave-flash" allowfullscreen="true" allowscriptaccess="always" width="700" height="438"></embed></object><p><a href="http://vimeo.com/11671458">An introduction to Compass</a> from <a href="http://vimeo.com/ltackett">Lorin Tackett</a> on <a href="http://vimeo.com">Vimeo</a>.</p>
## Installing :markdown
## Installing Compass
Compass is a tool that runs on the command line. Compass is a tool that runs on the command line. On any system with ruby installed, open your terminal and type:
On any system with ruby installed, open your terminal and type:
gem install compass gem install compass
This will install Compass and Sass too. Verify that compass is installed: This will install Compass and Sass too. If you want to verify that compass is installed:
compass version compass version
## Creating a stand-alone project ## Manual Setup
compass create myproject compass create /path/to/project
mate myproject cd /path/to/project
compass watch myproject compass watch
If you don't have TextMate, substitute the `mate myproject` part with the text Now you can edit the `*.scss` files in the `sass` directory with the text editor of your choice.
editor of your choice. Edit the `*.scss` files in the `sass` directory. the `compass watch` process will automatically compile your them into css in the stylesheets directory whenever they change.
These files are yours and you can change them as you see fit, delete them, The files in the `sass` directory are yours and you can change them, delete them, add new ones, etc.
make new ones, etc. Compass will automatically compile them into css in the
`stylesheets` directory whenever they change.
## Rails Support ## Manual setup using the Blueprint Framework
compass init rails /path/to/myrailsproject When starting a project from scratch:
## Installing a framework compass create /path/to/project --using blueprint
When creating a new project:
compass create myproject --using blueprint/basic
When installing into an existing project: When installing into an existing project:
cd myproject cd /path/to/project
compass install blueprint/semantic compass install blueprint
With Rails: To read more about using the Blueprint framework with Compass, [see the docs](/reference/blueprint/)
compass init rails /path/to/myrailsproject --using blueprint/semantic ## Rails Setup
## Bugs Reports, Discussions, Support compass init rails /path/to/myrailsproject
Using Blueprint with Rails:
compass init rails /path/to/myrailsproject --using blueprint
Send a note to the [mailing list](http://groups.google.com/group/compass-users)
and/or [File a bug](http://github.com/chriseppstein/compass/issues).

View File

@ -7,6 +7,15 @@ layout: tutorial
--- ---
%h1 Compass Tutorials %h1 Compass Tutorials
%p :markdown
The compass tutorials are still a Work-in-progress, but These tutorials are still a work-in-progress, if you have questions that aren't covered here let us know on the [Compass users mailing list](http://groups.google.com/group/compass-users) where there are lots of
what we have is available for you to peruse. friendly Compass users standing by to help you out.
## New to Compass?
If you're new to Compass, you might be interested in [best practices](/help/tutorials/best_practices/), the [configuration reference](/help/tutorials/configuration-reference/), [configurable variables](/help/tutorials/configurable-variables/),
or the [command line documentation](/help/tutorials/command-line/).
## Want to contribute?
If you've been using Compass for a while and you'd like to give back, check out the tutorials on [contributing](/help/tutorials/contributing/) and [creating extensions](/help/tutorials/extensions/).

View File

@ -5,12 +5,18 @@ layout: tutorial
classnames: classnames:
- tutorial - tutorial
--- ---
### Use a Base stylesheet file
# Best Practices
Here are some best practices for making your projects easier to build and
simpler to maintain.
## Use a Base stylesheet file
Create a `_base.scss` [partial][1] to initialize your stylesheets with common Create a `_base.scss` [partial][1] to initialize your stylesheets with common
variables and ([often][2]) the framework utilities you plan to use: variables and ([often][2]) the framework utilities you plan to use:
#### _base.scss ### _base.scss
$blueprint-grid-columns : 24; $blueprint-grid-columns : 24;
$blueprint-grid-width : 30px; $blueprint-grid-width : 30px;
@ -28,7 +34,7 @@ theyre available to any stylesheet that includes it.
Then you can include this file in all other stylesheets: Then you can include this file in all other stylesheets:
#### application.scss ### application.scss
@import "base"; @import "base";
@ -44,7 +50,7 @@ Constants][3] , for an example of where the number of grid columns for blueprint
is overridden/set to 32. Note that you can refer to `_base.scss` without the is overridden/set to 32. Note that you can refer to `_base.scss` without the
leading underscore and without the extension, since it is a [partial][1]. leading underscore and without the extension, since it is a [partial][1].
### Write your own Custom Mixins ## Write your own Custom Mixins
Mixins let you insert any number of style rules into a selector (and its Mixins let you insert any number of style rules into a selector (and its
descendants!) with a single line. This is a great way to [DRY][4] up your descendants!) with a single line. This is a great way to [DRY][4] up your
@ -53,7 +59,7 @@ also make your stylesheet look like self-documented source code -- Its much
more obvious to read something like `@include round-corners(6px, #f00)` than the whole more obvious to read something like `@include round-corners(6px, #f00)` than the whole
list of rules which define that appearance. list of rules which define that appearance.
#### Presentation-free Markup ## Presentation-free Markup
CSS was created to extract the presentational concerns of a website from the CSS was created to extract the presentational concerns of a website from the
webpage content. Following this best practice theoretically results in a website webpage content. Following this best practice theoretically results in a website
@ -87,7 +93,7 @@ Instead, ask yourself "what non-presentational quality do these pages share in
common?" In this case, they are all pages of content, so it's better to apply a common?" In this case, they are all pages of content, so it's better to apply a
body class of "content" to these pages and then style against that class. body class of "content" to these pages and then style against that class.
#### Nest selectors, but not too much. ## Nest selectors, but not too much.
It's easier to style a webpage from scratch or starting from some common base It's easier to style a webpage from scratch or starting from some common base
point for your application than it is to contend with unwanted styles bleeding point for your application than it is to contend with unwanted styles bleeding

View File

@ -22,8 +22,8 @@ classnames:
Once you get Compass installed, you are ready to create a new Once you get Compass installed, you are ready to create a new
blueprint project. In your terminal enter the following commands: blueprint project. In your terminal enter the following commands:
%code.shell %pre.shell
%pre %code
%span.prompt<> $&nbsp; %span.prompt<> $&nbsp;
compass create my_project --using blueprint/semantic compass create my_project --using blueprint/semantic
%br> %br>
@ -54,8 +54,8 @@ classnames:
Once you get Compass installed, you are ready to create a new Once you get Compass installed, you are ready to create a new
blueprint project. In your terminal enter the following commands: blueprint project. In your terminal enter the following commands:
%code.shell %pre.shell
%pre %code
%span.prompt<> $&nbsp; %span.prompt<> $&nbsp;
compass create my_project --using blueprint/basic compass create my_project --using blueprint/basic

View File

@ -9,7 +9,7 @@ classnames:
The compass configuration file is a ruby file, which means that we can do some The compass configuration file is a ruby file, which means that we can do some
clever things if we want to. But dont let it frighten you; its really quite clever things if we want to. But dont let it frighten you; its really quite
easy to set up your project. easy to set up your project.
<a name="basic-format"></a>
## Basic format ## Basic format
Most configuration properties are a simple assignment to a configuration property. Most configuration properties are a simple assignment to a configuration property.
@ -35,11 +35,12 @@ There are two kinds of composite values:
It is a comma delimited list of associations surrounded by curly brackets. It is a comma delimited list of associations surrounded by curly brackets.
An association is two values separated by `=>`. E.g. `{:foo => "aaa", :bar => "zzz"}` An association is two values separated by `=>`. E.g. `{:foo => "aaa", :bar => "zzz"}`
<a name="comments"></a>
## Comments ## Comments
Use the hash sign `#` to comment out everything from the hash sign to the end Use the hash sign `#` to comment out everything from the hash sign to the end
of the line. of the line.
<a name="import-note-windows-users"></a>
## Import Note for Windows Users ## Import Note for Windows Users
The backslash character (`\`) is a special character in a string delimited by The backslash character (`\`) is a special character in a string delimited by
@ -47,6 +48,7 @@ double quotes (`"`). If you are working with folders in your paths, you should
either use **single quotes** to delimit your strings or escape your backslash either use **single quotes** to delimit your strings or escape your backslash
by doubling it like `"some\\path"`. by doubling it like `"some\\path"`.
<a name="loading-compass-plugins"></a>
## Loading Compass Plugins ## Loading Compass Plugins
Compass relies on the ruby `require` mechanism to load other libraries of code. Compass relies on the ruby `require` mechanism to load other libraries of code.
@ -59,11 +61,28 @@ Example:
require 'ninesixty' require 'ninesixty'
require 'susy' require 'susy'
<a name="overriding-configuration-settings"></a>
## Overriding Configuration Settings ## Overriding Configuration Settings
When using the compass command line, configuration options that you set on the When using the compass command line, configuration options that you set on the
command line will override the corresponding settings in your configuration file. command line will override the corresponding settings in your configuration file.
<a name="inspecting-configuration-settings-passed-via-the-command-line"></a>
## Inspecting Configuration Settings passed via the Command Line
When using the compass command line, configuration options that you set on the
command line can be inspected within the configuration file. For instance,
if you set the environment:
$ compass compile -e production --force
Then you can inspect the value like so:
output_style = (environment == :production) ? :compressed : :expanded
Values that are not set on the CLI will be `nil` even though they will have a default value
later on.
<a name="configuration-properties"></a>
## Configuration Properties ## Configuration Properties
<table> <table>
@ -256,8 +275,21 @@ command line will override the corresponding settings in your configuration file
<td style="vertical-align:top;">String </td> <td style="vertical-align:top;">String </td>
<td style="vertical-align:top;">The relative http path to font files on the web server.</td> <td style="vertical-align:top;">The relative http path to font files on the web server.</td>
</tr> </tr>
<tr>
<td style="vertical-align:top;"><code>sprite_engine</code> </td>
<td style="vertical-align:top;">Symbol </td>
<td style="vertical-align:top;">Defaults to <code>:chunky_png</code></td>
</tr>
<tr>
<td style="vertical-align:top;"><code>chunky_png_options</code></td>
<td style="vertical-align:top;">Hash </td>
<td style="vertical-align:top;">
Defaults to <code>{:compression => Zlib::BEST_COMPRESSION}</code>. See the chunky_png <a href='https://github.com/wvanbergen/chunky_png/wiki/Constraints' _target='blank'>wiki</a> for more information
</td>
</tr>
</table> </table>
<a name="configuration-functions"></a>
## Configuration Functions ## Configuration Functions
**`add_import_path`** Call this function to add a path to the list of sass import **`add_import_path`** Call this function to add a path to the list of sass import
@ -282,10 +314,14 @@ the asset host configuration is ignored.
--- ---
<a name="asset-cache-buster"></a>
**`asset_cache_buster`** Pass this function a block of code that defines the **`asset_cache_buster`** Pass this function a block of code that defines the
cache buster strategy to be used. The block must return nil or a string that can cache buster strategy to be used. The block must return nil, a string or a hash.
be appended to a url as a query parameter. The returned string must not include If the returned value is a hash the values of :path and/or :query is used to generate
the starting `?`. The block will be passed the root-relative url of the asset. a cache busted path to the asset. If a string value is returned, it is added as a query string.
The returned values for query strings must not include the starting `?`.
The block will be passed the root-relative url of the asset.
If the block accepts two arguments, it will also be passed a path If the block accepts two arguments, it will also be passed a path
that points to the asset on disk — which may or may not exist. that points to the asset on disk — which may or may not exist.
@ -299,6 +335,65 @@ that points to the asset on disk — which may or may not exist.
end end
end end
Busting the cache via path:
asset_cache_buster do |path, real_path|
if File.exists?(real_path)
pathname = Pathname.new(path)
modified_time = File.mtime(real_path).strftime("%s")
new_path = "%s/%s-%s%s" % [pathname.dirname, pathname.basename(pathname.extname), modified_time, pathname.extname]
{:path => new_path, :query => nil}
end
end
To disable the asset cache buster: To disable the asset cache buster:
asset_cache_buster :none asset_cache_buster :none
---
**`watch`** -- React to changes to arbitrary files within your project. Can be invoked
more than once. Example:
watch "images/**/*" do |project_dir, relative_path|
if File.exists?(File.join(project_dir, relative_path))
puts "File size of #{relative_path} is: #{File.size(File.join(project_dir, relative_path))}"
end
end
This code will be called if the file is added, updated, or removed. Be sure to check for existence
to avoid crashing the watcher in the case where the file has been removed.
<a name="callbacks"></a>
## Callbacks
**`on_sprite_saved`** -- Pass this function a block of code that gets executed after a sprite is saved to disk. The block will be passed the filename. Can be invoked more then once. Example:
on_sprite_saved do |filename|
post_process(filename) if File.exists?(filename)
end
**`on_sprite_generated`** -- Pass this function a block of code that gets executed after a sprite is generated but before its saved to disk. The block will be passed an instance of `ChunkyPNG::Image`. Can be invoked more then once. Example:
on_sprite_generated do |sprite_data|
sprite_data.metadata['Caption'] = "This Image is &copy; My Company 2011"
end
**`on_stylesheet_saved`** -- Pass this function a block of code that gets executed after a stylesheet is processed. The block will be passed the filename. Can be invoked more then once. Example:
on_stylesheet_saved do |filename|
Growl.notify {
self.message "#{File.basename(filename)} updated!"
self.icon = '/path/to/success.jpg'
}
end
**`on_stylesheet_error`** -- Pass this function a block of code that gets executed if a stylesheet has an error while processing. The block will be passed the filename and the error message. Can be invoked more then once. Example:
on_stylesheet_error do |filename, message|
Growl.notify {
self.message = "#{File.basename(filename)}: #{message}"
self.icon = '/path/to/fail.jpg'
sticky!
}
end

View File

@ -34,10 +34,10 @@ Here's some general information about the project you might find useful along th
* [Submitting Patches](#patches) * [Submitting Patches](#patches)
* [Project Structure](#project-structure) * [Project Structure](#project-structure)
* [Project Architecture](#project-architecture) <!-- * Project Architecture
* [Command Line](#cli-architecture) * [Command Line](/help/tutorials/command-line)
* [Extensions](#extensions-architecture) * [Extensions](/help/tutorials/extensions)
* [Configuration](#configuration-architecture) * [Configuration](help/tutorials/configuration-reference) -->
* [General Philosophy](#project-philosophy) * [General Philosophy](#project-philosophy)
* [Stylesheet Conventions](#stylesheet-conventions) * [Stylesheet Conventions](#stylesheet-conventions)
* [Miscellaneous Stuff](#faq) * [Miscellaneous Stuff](#faq)

View File

@ -0,0 +1,74 @@
---
title: Extending Compass
layout: tutorial
crumb: Extending Compass
classnames:
- tutorial
---
# Extending Compass
## Sprite engine
The sprite engine is the work horse of sprite generation it's the interface for assembling and writing the image file to disk.
### Requirements
A sprite engine requires two methods `construct_sprite`, and `save(filename)`
Once inside the class you have access to `images` which is a collection of [Compass::SassExtensions::Sprites::Image](http://rdoc.info/github/chriseppstein/compass/dda7c9/Compass/SassExtensions/Sprites/Image)
### Configuration
To enable your sprite engine from the config file set
sprite_engine = :<engine name>
The example below will load `Compass::SassExtension::Sprites::ChunkyPngEngine.new(width, height, images)`
sprite_engine = :chunky_png
### Class Definition
module Compass
module SassExtensions
module Sprites
class ChunkyPngEngine < Compass::SassExtensions::Sprites::Engine
def construct_sprite
#do something
end
def save(filename)
#save file
end
end
end
end
end
<a name="adding-configuration-properties"></a>
## Adding Configuration Properties to Compass
To add a new configuration property to Compass:
Compass::Configuration.add_configuration_property(:foobar, "this is a foobar") do
if environment == :production
"foo"
else
"bar"
end
end
This will do several things:
1. make it possible for users to set the `foobar` configuration property in their
configuration file.
2. Ruby code can read and write the `foobar` attribute from any configuration object.
3. It will add the comment `# this is a foobar` above the property in the configuration file.
A comment is not required, you can simply omit this argument if you like.
4. The block of code provided allows you to assign a sensible default value according to other
settings in the configuration or by using arbitrary code to determine what the value should
be. For instance it could read from another configuration file or it could change based on
the user's operating system.

View File

@ -71,6 +71,10 @@ you can use compass to generate an extension with the following command:
This will create a few basic files and folders to get you started. This will create a few basic files and folders to get you started.
If you prefer to use the scss syntax for your extension run the following command instead:
compass create my_extension --using compass/extension -x scss
Advanced Layout Options Advanced Layout Options
----------------------- -----------------------
@ -88,6 +92,7 @@ The compass_init.rb file takes priority, so that extensions that want to work
differently as compass extensions than they do as normal ruby libraries, differently as compass extensions than they do as normal ruby libraries,
have a way of targeting compass. have a way of targeting compass.
<a name="registration"></a>
### Stylesheet and Template Locations ### Stylesheet and Template Locations
If you'd like to store your stylesheets and/or templates in a non-standard location within your extension, If you'd like to store your stylesheets and/or templates in a non-standard location within your extension,
@ -105,6 +110,10 @@ template directories are not at the top level, you can just do this instead:
base_directory = File.join(File.dirname(__FILE__), '..', 'compass') base_directory = File.join(File.dirname(__FILE__), '..', 'compass')
Compass::Frameworks.register('my_extension', :path => base_directory) Compass::Frameworks.register('my_extension', :path => base_directory)
### Adding Configuration Options to Compass
For details on how to add new configuration options to compass [read this](/help/tutorials/extending/#adding-configuration-properties).
Conventions to Follow Conventions to Follow
--------------------- ---------------------
@ -241,9 +250,13 @@ design and to get the user started off with working product.
Distributing Extensions as Ruby Gems Distributing Extensions as Ruby Gems
------------------------------------ ------------------------------------
How to build and distribute ruby gems is outside the scope of this document. Rubygems is a flexible, easy-to-use system for distributing ruby software.
But delivering an extension as a ruby gem makes it easier to manage software If you have any questions about rubygems, I suggest that you start looking
dependencies, install, and uninstall. for help [here](http://help.rubygems.org/).
The big advantages of using rubygems to distribute your extension is that
it allows your extension to be a dependency for other projects and that each
install is versioned, which makes supporting your extension easier.
Tips for Developing Extensions Tips for Developing Extensions
------------------------------ ------------------------------
@ -271,9 +284,17 @@ Before you begin, please ensure you have gem version `1.3.6` or greater. `gem -v
1. Define your gemspec file at the top of your extension. Here's [an example of 1. Define your gemspec file at the top of your extension. Here's [an example of
one](http://github.com/ericam/compass-css-lightbox/blob/master/css-lightbox.gemspec). one](http://github.com/ericam/compass-css-lightbox/blob/master/css-lightbox.gemspec).
The gemspec should have the same name as your gem. The gemspec should have the same name as your gem.
2. Build a gem: `gem build my_extension.gemspec`. This will build your gem file and 2. Register your framework by adding `lib/my_extension.rb` and registering it:
require 'compass'
extension_path = File.expand_path(File.join(File.dirname(__FILE__), ".."))
Compass::Frameworks.register('my_extension', :path => extension_path)
This is how compass knows where to find your extension's files when a user requires it.
For more options, go back up and read about [Stylesheet and Template Locations](#registration).
3. Build a gem: `gem build my_extension.gemspec`. This will build your gem file and
add the current version to the name. E.g. `my_extension-0.0.1.gem` add the current version to the name. E.g. `my_extension-0.0.1.gem`
3. Test your gem by installing it locally: `gem install my_extension-0.0.1.gem` 4. Test your gem by installing it locally: `gem install my_extension-0.0.1.gem`
### Releasing a Gem ### Releasing a Gem

View File

@ -0,0 +1,83 @@
---
title: Application Integration
layout: tutorial
crumb: Application Integration
classnames:
- tutorial
---
# Application Integration
## Ruby on Rails
### Rails 3
compass init rails /path/to/myrailsproject
### Rails 2.3
rake rails:template LOCATION=http://compass-style.org/rails/installer
## Sinatra
require 'sinatra'
require 'haml'
require 'sass'
require 'compass'
configure do
Compass.configuration do |config|
config.project_path = File.dirname(__FILE__)
config.sass_dir = 'views'
end
set :haml, { :format => :html5 }
set :sass, Compass.sass_engine_options
end
get '/screen.css' do
content_type 'text/css', :charset => 'utf-8'
sass :screen
end
If you keep your stylesheets in “views/stylesheets/” directory instead of just “views/”, remember to update sass_dir configuration accordingly.
Check out this [sample compass-sinatra project](http://github.com/chriseppstein/compass-sinatra) to get up and running in no time!
[Sinatra Bootstrap](http://github.com/adamstac/sinatra-bootstrap) - a base Sinatra project with support for Haml, Sass, Compass, jQuery and more.
## Nanoc3
### Minimal integration: just drop it in
One simple route for lightweight integration is to simply install compass inside nanoc. Then edit config.rb to point to the stylesheets you want to use. This means you have to have the Compass watch command running in a separate window from the Nanoc compilation process.
Example project that works this way: http://github.com/unthinkingly/unthinkingly-blog
### More formal integration
At the top of the Nanoc Rules file, load the Compass configuration, like this:
require 'compass'
Compass.add_project_configuration 'compass/config.rb' # when using Compass 0.10
Compass.configuration.parse 'compass/config.rb' # when using Compass < 0.10
Your Compass configuration file (in compass/config.rb) could look like this (you may need to change the path to some directories depending on your directory structure):
http_path = "/"
project_path = "."
css_dir = "output/assets/style"
sass_dir = "content/assets/style"
images_dir = "output/assets/images"
# when using SCSS:
sass_options = {
:syntax => :scss
}
To filter the stylesheets using Sass and Compass, call the sass filter with Sass engine options taken from Compass, like this:
filter :sass, Compass.sass_engine_options
### Nanoc Projects using the formal approach
* [nanoc Bootstrap](http://github.com/adamstac/nanoc-bootstrap) - a base nanoc project with support for Haml, Sass, Compass, jQuery and more.
* [nanoc & Compass Example Project](http://github.com/ddfreyne/nanoc-bootstrap-compass)

View File

@ -0,0 +1,228 @@
---
title: Spriting with Compass
layout: tutorial
crumb: Spriting
classnames:
- tutorial
---
# Spriting with Compass
Spriting has never been easier with Compass. You place the sprite images in a folder,
import them into your stylesheet, and then you can use the sprite in your selectors in one
of several convenient ways.
## Setup
For this tutorial, let's imagine that in your project's image folder there are four icons:
* `images/icon/new.png`
* `images/icon/edit.png`
* `images/icon/save.png`
* `images/icon/delete.png`
Each is an icon that is 32px square.
## Basic Usage
The simplest way to use these icon sprites is to let compass give you a class for each sprite:
@import "icon/*.png";
@include all-icon-sprites;
And you'll get the following CSS output:
.icon-sprite,
.icon-delete,
.icon-edit,
.icon-new,
.icon-save { background: url('/images/icon-s34fe0604ab.png') no-repeat; }
.icon-delete { background-position: 0 0; }
.icon-edit { background-position: 0 -32px; }
.icon-new { background-position: 0 -64px; }
.icon-save { background-position: 0 -96px; }
You can now apply the `icon-XXX` classes to your markup as needed.
Let's go over what happened there. The import statement told compass to [generate a
stylesheet that is customized for your sprites](https://gist.github.com/729507). This
stylesheet is [magic](#magic-imports), it is not written to disk, and it can be customized
by setting configuration variables before you import it. See the section below on
[Customization Options](#customization-options). The goal of this stylesheet is to provide a
simple naming convention for your sprites so that you they are easy to remember and use. You
should never have to care what the is name of the generated sprite map, nor where a sprite
is located within it.
<a name="selector-control"></a>
## Selector Control
If you want control over what selectors are generated, it is easy to do. In this example,
this is done by using the magic `icon-sprite` mixin. Note that the mixin's name is dependent
on the name of the folder in which you've placed your icons.
@import "icon/*.png";
.actions {
.new { @include icon-sprite(new); }
.edit { @include icon-sprite(edit); }
.save { @include icon-sprite(save); }
.delete { @include icon-sprite(delete); }
}
And your stylesheet will compile to:
.icon-sprite,
.actions .new,
.actions .edit,
.actions .save,
.actions .delete { background: url('/images/icon-s34fe0604ab.png') no-repeat; }
.actions .new { background-position: 0 -64px; }
.actions .edit { background-position: 0 -32px; }
.actions .save { background-position: 0 -96px; }
.actions .delete { background-position: 0 0; }
<a name="magic-imports"></a>
## Magic Imports
As noted above, compass will magically create sprite stylesheets for you. Some people like
magic, some people are scared by it, and others are curious about how the magic works. If
you would like to avoid the magic, you can use compass to generate an import for you. On the
command line:
compass sprite "images/icon/*.png"
This will create file using your project's preferred syntax, or you can specify the
output filename using the `-f` option and the syntax will be inferred from the extension.
If you do this, you'll need to remember to regenerate the import whenever you rename, add,
or remove sprites.
Using the magic imports is recommended for most situations. But there are times when you
might want to avoid it. For instance, if your sprite map has more than about 20 to 30
sprites, you may find that hand crafting the import will speed up compilation times. See
the section on [performance considerations](#performance) for more details.
<a name="magic-selectors"></a>
## Magic Selectors
If you want to add selectors for your sprites, it's easy todo by adding `_active` `_target` or `_hover` to the file name, In the example below we have a sprite directory that looks like:
* `selectors/ten-by-ten.png`
* `selectors/ten-by-ten_hover.png`
* `selectors/ten-by-ten_active.png`
* `selectors/ten-by-ten_target.png`
Now in our sass file we add:
@import "selectors/*.png";
a {
@include selectors-sprite(ten-by-ten)
}
And your stylesheet will compile to:
.selectors-sprite, a {
background: url('/selectors-sedfef809e2.png') no-repeat;
}
a {
background-position: 0 0;
}
a:hover, a.ten-by-ten_hover, a.ten-by-ten-hover {
background-position: 0 -20px;
}
a:target, a.ten-by-ten_target, a.ten-by-ten-target {
background-position: 0 -30px;
}
a:active, a.ten-by-ten_active, a.ten-by-ten-active {
background-position: 0 -10px;
}
Alternatively you can use the `@include all-selectors-sprites;` after the import and get the following output:
.selectors-sprite, .selectors-ten-by-ten {
background: url('/selectors-sedfef809e2.png') no-repeat;
}
.selectors-ten-by-ten {
background-position: 0 0;
}
.selectors-ten-by-ten:hover, .selectors-ten-by-ten.ten-by-ten_hover, .selectors-ten-by-ten.ten-by-ten-hover {
background-position: 0 -20px;
}
.selectors-ten-by-ten:target, .selectors-ten-by-ten.ten-by-ten_target, .selectors-ten-by-ten.ten-by-ten-target {
background-position: 0 -30px;
}
.selectors-ten-by-ten:active, .selectors-ten-by-ten.ten-by-ten_active, .selectors-ten-by-ten.ten-by-ten-active {
background-position: 0 -10px;
}
<a name="customization-options"></a>
## Customization Options
### Options per Sprite Map
When constructing the sprite map, the entire sprite map and it's associated stylesheet
can be configured in the following ways. Each option is specified by setting a [configuration
variable](/help/tutorials/configurable-variables/) before importing the sprite. The variables
are named according to the name of the folder containing the sprites. In the examples below
the sprites were contained within a folder called `icon`.
* `$<map>-spacing` -- The amount of transparent space, in pixels, around each sprite.
Defaults to `0px`. E.g. `$icon-spacing: 20px`.
* `$<map>-repeat` -- Wether or not each sprite should repeat along the x axis. Defaults
to `no-repeat`. E.g. `$icon-repeat: repeat-x`.
* `$<map>-position` -- The position of the sprite in the sprite map along the x-axis. Can
be specified in pixels or percentage of the sprite map's width. `100%` would cause the
sprite to be on the right-hand side of the sprite map. Defaults to `0px`.
E.g. `$icon-position: 100%`.
* `$<map>-sprite-dimensions` -- Whether or not the dimensions of the sprite should be
included in each sprite's CSS output. Can be `true` or `false`. Defaults to `false`.
* `$<map>-sprite-base-class` -- The base class for these sprites. Defaults to `.<map>-sprite`.
E.g. `$icon-sprite-base-class: ".action-icon"`
* `$<map>-clean-up` -- Whether or not to removed the old sprite file when a new one is created. Defaults to true
### Options per Sprite
When constructing the sprite map, each sprite can be configured in the following ways:
* `$<map>-<sprite>-spacing` -- The amount of transparent space, in pixels, around the sprite. Defaults
to the sprite map's spacing which defaults to `0px`. E.g. `$icon-new-spacing: 20px`.
* `$<map>-<sprite>-repeat` -- Wether or not the sprite should repeat along the x axis. Defaults
to the sprite map's repeat which defaults to `no-repeat`. E.g. `$icon-new-repeat: repeat-x`.
* `$<map>-<sprite>-position` -- The position of the sprite in the sprite map along the x-axis. Can
be specified in pixels or percentage of the sprite map's width. `100%` would cause the
sprite to be on the right-hand side of the sprite map. Defaults to the sprite map's
position value which defaults to `0px`. E.g. `$icon-new-position: 100%`.
<a name="performance"></a>
## Performance Considerations
Reading PNG files and assembling new images and saving them to disk might have a non-trivial
impact to your stylesheet compilation times. Especially for the first compile. Please keep
this in mind.
## Large numbers of sprites
The magic stylesheet can get very large when there are large numbers of sprites. 50 sprites
will cause there to be over 150 variables created and then passed into the
`sprite-map` [function](/reference/compass/helpers/sprites/#sprite-map).
You may find that customizing the sprite function call to only pass those values that you
are overriding will provide a small performance boost.
See a [concrete example](https://gist.github.com/747970).
## Oily PNG
Compass generates PNG files using a pure-ruby library called
[`chunky_png`](https://github.com/wvanbergen/chunky_png). This library can be made faster by
installing a simple C extension called [`oily_png`](https://github.com/wvanbergen/oily_png).
Add it to your `Gemfile` if you have one in your project:
gem 'oily_png'
Or install the Rubygem:
gem install oily_png
Compass will automatically detect its presence.

View File

@ -76,6 +76,22 @@ Or for sass files:
=linear-gradient($color-stops, $start: top, $image: false) =linear-gradient($color-stops, $start: top, $image: false)
+background-image($image, linear-gradient($start, $color-stops)) +background-image($image, linear-gradient($start, $color-stops))
<a name="typography"></a>
## Typography Module
With the addition of vertical-rhythms to the compass core, we have created a new
[typography module][typography_module], and moved several items that were formerly
listed as "utilities" into it. The moved modules are "links", "lists" and "text".
These will all remain part of the basic compass include, but if you were including
them individually in your stylesheets, you will need to adjust the include paths
as follows:
* "compass/utilities/links" becomes "compass/typography/links"
* "compass/utilities/lists" becomes "compass/typography/lists"
* "compass/utilities/text" becomes "compass/typography/text"
[new_transform]: /reference/compass/css3/transform/ [new_transform]: /reference/compass/css3/transform/
[old_transform]: /reference/compass/css3/transform-legacy/ [old_transform]: /reference/compass/css3/transform-legacy/
[image_stylesheet]: /reference/compass/css3/images/ [image_stylesheet]: /reference/compass/css3/images/
[typography_module]: /reference/compass/typography/

View File

@ -22,7 +22,7 @@ what changed to your stylesheets:
1. $ cd my_compass_project 1. $ cd my_compass_project
2. $ compass compile --force 2. $ compass compile --force
3. $ cp -r stylesheets stylesheets.backup 3. $ cp -r stylesheets stylesheets.backup
4. $ gem install compass --pre # you might need to type sudo first if you're on mac or linux. 4. $ gem install compass # you might need to type sudo first if you're on mac or linux.
5. $ compass compile --force 5. $ compass compile --force
6. Take note of any deprecation warnings printed in red during the compile. 6. Take note of any deprecation warnings printed in red during the compile.
7. If you have textmate and installed the `mate` command line tool:<br> 7. If you have textmate and installed the `mate` command line tool:<br>

View File

@ -0,0 +1,50 @@
---
title: Lemonade Upgrade Guide
layout: tutorial
crumb: Lemonade Upgrade
classnames:
- tutorial
---
# Lemonade Upgrade Guide
## Example 1
### Lemonade
.logo {
background: sprite-image("lemonade/lemonade-logo.png");
}
.lime {
background: sprite-image("lemonade/lime.png");
}
.coffee {
background: sprite-image("other-drinks/coffee.png") no-repeat;
}
### Compass
@import "lemonade/*.png";
@import "other-drinks/*.png"
@include all-lemonade-sprites;
@include all-other-drinks-sprites;
Compass will return class names `.lemonade-logo`, `.lemonade-lime`, `.other-drinks-coffee`
# Example 2
### Lemonade
.lemonade-example-1 {
background: sprite-image("lemonade/example-1/blue-10x10.png", 10px, 2px);
}
### Compass
With compass you need to flatten the image directory to be `images/lemonade` instead of `images/lemonade/example-1`
@import "lemonade/*.png"
.lemonade-example-1 {
@include lemonade-sprite(blue-10x10, true, 10px, 2px);
background-color: yellow;
}

View File

@ -10,13 +10,18 @@ layout: homepage
.compass .compass
%h4 Why designers love Compass. %h4 Why designers love Compass.
%ol %ol
%li Get cleaner markup with no presentational classes. %li Experience cleaner markup without presentational classes.
%li Its chock full of the webs best reusable patterns. %li Its chock full of the webs best reusable patterns.
%li Developing a personal framework is simple. %li Developing a personal framework is simple.
%li Compass mixins make CSS3 easy. %li Compass mixins make CSS3 easy.
%li Download and create extensions with ease.
.sass .sass
%h4 Compass uses Sass. %h4 Compass uses Sass.
%p <a href="http://sass-lang.com/">Sass</a> is an extension of CSS3 which adds nested rules, variables, mixins, selector inheritance, and more. Sass generates well formatted CSS. %p
<a href="http://sass-lang.com/">Sass</a> is an extension of CSS3 which
adds nested rules, variables, mixins, selector inheritance, and more.
Sass generates well formatted CSS and makes your stylesheets
easier to organize and maintain.
%h3 Brilliant people use Compass, including these <em>wildly talented</em> folks: %h3 Brilliant people use Compass, including these <em>wildly talented</em> folks:
%ul#featured_sites %ul#featured_sites
%li %li
@ -57,10 +62,34 @@ layout: homepage
%li %li
%a(href="http://green.cals.cornell.edu/") %a(href="http://green.cals.cornell.edu/")
%img(src="/images/sites/cornell.jpg") %img(src="/images/sites/cornell.jpg")
%span.title Corenell University - CALS %span.title Cornell University - CALS
%span.url http://green.cals.cornell.edu %span.url http://green.cals.cornell.edu
%li %li
%a(href="http://busyconf.com/") %a(href="http://busyconf.com/")
%img(src="/images/sites/busyconf.jpg") %img(src="/images/sites/busyconf.jpg")
%span.title BusyConf %span.title BusyConf
%span.url http://busyconf.com %span.url http://busyconf.com
%section.book
%h3 Save <em>37%</em> on the Book: (Currently In Beta)
%p
%a(href="http://www.manning.com/netherland/")
%img(src="http://www.manning.com/netherland/netherland_cover150.jpg" alt="Sass & Compass in Action")
Compliments of Manning.com is a standing 37% discount on
<a href="http://www.manning.com/netherland/">Sass and Compass in Action</a>.
Use promo code <code>sasscomp37</code> at manning.com on the MEAP, eBook and pBook of Sass and
Compass in Action. All pBook purchases include free eFormats (PDF, ePub, and Kindle)
as soon as available.
%section.gui
%h3 <em>Hate</em> the Command Line?
%a(href="http://compass.handlino.com/")
%img(src="/images/compass.app.png")
%p
Buy <a href="http://compass.handlino.com/">Compass.app</a>
for Windows and Mac for just $7.
%p.note
Note: Compass.app is a product of Handlino, Inc but
30% of all proceeds go to Compass's charity of choice: <a href="http://umdf.org/compass">UMDF.org</a>.

View File

@ -0,0 +1,24 @@
---
title: Compass Documentation | All Functions
crumb: Docs
body_id: home
---
%article
%h1#logo Sass Based Functions
- all_functions.sorted_and_grouped_by_name{|f| f.last.name }.each do |(group, functions)|
%h3= group
%ul
- functions.each do |(i, f)|
%li
%a{:href=>"#{i.path}#function-#{f.name}"}= f.sass_signature(:html)
%h1#logo All Ruby Based Functions
%ul
- Sass::Script::Functions.public_instance_methods.sort_by{|m| m.to_s}.each do |m|
%li
- name = m.to_s.gsub("_","-")
- if i = item_for_function_name(name)
%a{:href=>"#{i.path}##{name}"}= name
- else
= name

View File

@ -6,9 +6,9 @@ body_id: home
%article %article
%h1#logo Compass Mixins %h1#logo Compass Mixins
- all_mixins.sort_by{|i| i.first.identifier}.each do |item, mixins| - all_mixins.sorted_and_grouped_by_name{|m| m.last.name }.each do |(group, mixins)|
%h3= link_to item[:title], item %h3= group
%ul %ul
- mixins.sort_by{|m| m.name}.each do |m| - mixins.each do |(i, m)|
%li= mixin_signature(m) %li
%a{:href=>"#{i.path}#mixin-#{m.name}"}= m.sass_signature(:none, :html)

View File

@ -6,10 +6,10 @@ body_id: home
%article %article
%h1#logo Compass Variables %h1#logo Compass Variables
- all_constants.sort_by{|i| i.first.identifier}.each do |item, constants| - all_constants.sorted_and_grouped_by_name{|v| v.last.name }.each do |(group, variables)|
%h3= link_to item[:title], item %h3= group
%ul %ul
- constants.sort_by{|c| c.name}.each do |c| - variables.each do |(i, v)|
%li $#{c.name} %li
%a{:href=>"#{i.path}#const-#{v.name}"}= "$" + v.name

View File

@ -0,0 +1,81 @@
---
title: Install the Compass Stylesheet Authoring Framework
crumb: Install
body_id: install
---
- content_for :javascripts do
%script(src="/javascripts/install.js")
%h2 Installing Ruby
%p
Compass runs on any computer that has
<a href="http://www.ruby-lang.org/en/downloads/">ruby installed</a>.
%p
For more advanced users you may want to install
<a href="http://rvm.beginrescueend.com/rvm/install/">rvm</a>.
%h2 Setting up the ruby environment
%ol
%li <code>$ gem update --system</code>
%li <code>$ gem install compass</code>
%h2 Tell us about your project and we'll help you get it set up:
%blockquote.madlib.customizable<
I would like to set up my
%select#existence
%option{:value => "create"} new
%option{:value => "init"} existing
%select#app-type
%option{:value => "stand-alone"} compass
%option{:value => "rails"} rails
%option{:value => "other"} other
project
with
%select#framework
%option{:value => "compass"} compass's
%option{:value => "blueprint"} blueprint's
%option{:value => "bare"} no
starter stylesheets.
%br
I prefer the
%select#syntax
%option{:value => "scss"} CSS based (SCSS)
%option{:value => "sass"} Indent based (Sass)
syntax<span class="customization">
and would like to
%select#options
%option{:value => "default"} use compass's recommended
%option{:value => "customized"} customize my project's
directory structure<span id="directories" style="display:none;">
using
%input#sassdir(value="sass")
for the sass source directory,
%input#cssdir(value="css")
for the css output directory,
%input#jsdir(value="javascripts")
for the javascripts directory,
and
%input#imagesdir(value="images")
for the images directory</span></span>.
%h4 Thanks. Now run the following steps in your terminal:
%p.note
Terminal newbies, read <a href="http://wiseheartdesign.com/articles/2010/11/12/the-designers-guide-to-the-osx-command-prompt/">the Designers Guide to the OSX Command Prompt</a> first!
#steps
Loading...
%p.note Note: <code>$</code> is a placeholder for your terminal's prompt. You don't type it.
%h4 Then follow the instructions that compass provides in the output.
%h4 Or you can buy a <a href="http://compass.handlino.com/">GUI for Compass</a> from Handlino.
%h2 Next Steps
%ul
%li
%a(href="http://sass-lang.com" target="_blank") Learn about Sass
%li
%a(href="/help/tutorials/") Read our tutorials
%li
%a(href="/reference/compass/") Study the reference documentation

View File

@ -0,0 +1,141 @@
---
title: "Compass v0.11 is Released!"
description: "Months in the making, Compass v0.11 continues to revolutionize CSS Frameworks."
author: chris
---
The Compass team is proud to announce that v0.11 is released. With this release, Compass & Sass continue to revolutionize the world of CSS Frameworks bringing never-before-seen features and unmatched simplicity, quality, and flexibility to your stylesheets.
In this post, we summarize the new features. For all the nitty gritty details, see the [CHANGELOG](/CHANGELOG/).
Compass is Charityware. If you love this release, [please donate to the UMDF](http://umdf.org/compass) on our behalf and help find a cure for thousands of children suffering from mitochondrial disease.
## Sass 3.1
This release required you to upgrade to Sass 3.1. This release brings a ton of great new features that Compass now uses and you can too!
* Proper List Support: Space and Comma separated lists used to cause values to become strings
when passing them to mixins. Now the values in lists are preserved as their original types.
* Sass-based Functions. Define your own value functions and use them anywhere.
* Keyword Style Argument passing to Functions and Mixins. It can be hard to understand what
the values being passed to a mixin or function are for, use keyword style arguments to
make it easier to understand remember and read mixin includes.
* `@media` bubbling. Responsive design meets nested selectors! Use a media declaration anywhere and it
will be bubbled to the top level for you.
For more information about the new Sass features, see the [Sass CHANGELOG](http://sass-lang.com/docs/yardoc/file.SASS_CHANGELOG.html).
## Embracing CSS3
The power and flexibility of CSS3 is well known and web developers and designers are finding many new and interesting ways to take advantage of it. In Compass v0.11 we have revisited each CSS3 feature to ensure the greatest ease of use and similarity to CSS3 syntax. The compass internals for managing cross-browser compatibility have been rewritten to provide a powerful platform for moving as fast as the browser implementors are. Going forward, <span style="text-decoration: underline;">expect small point releases to adapt to new browser support and changes much more rapidly</span>. By default, Compass provides out-of-the-box support for **all** modern and legacy browsers as far back as IE6 and Firefox 2. But if you want slimmer stylesheets, it is [simple to configure](/reference/compass/support/) which browser support we provide.
In this release, we embraced the CSS3 syntax as much as possible. It might seem obvious, but the Compass convention is now that all CSS3 mixin arguments should match the CSS3 syntax for their corresponding properties so that you never have to *learn* a compass CSS3 mixin. If you ever find a case where this is not true, it is a bug and we would appreciate it if you would [provide the details in a bug report](http://github.com/chriseppstein/compass/issues). After upgrading, you will encounter a number of deprecation warnings guiding you through the syntax changes.
### Gradients Evolved
The best example of the changes in the CSS3 module are related to gradients. In Compass v0.10 we provided two simple mixins: `linear-gradient` and `radial-gradient` for setting the `background-image` property:
.linear {
@include linear-gradient(#FFF, #000, color-stops(#C00 25%, #0C0 75%))
}
This syntax was inspired by the original webkit gradient syntax but tried to simplify it to some extent. But the gradient specification has evolved and because gradients can be used anywhere an image can, so we now provide a mixin for each property that can accept gradients and the arguments
can be any legal CSS3 value for the that property:
.linear {
@include background-image(linear-gradient(#FFF, #C00 25%, #0C0 75%, #000))
}
Which produces:
.linear {
background-image: -webkit-gradient(linear, 50% 0%, 50% 100%, color-stop(0%, #ffffff), color-stop(25%, #cc0000), color-stop(75%, #00cc00), color-stop(100%, #000000));
background-image: -webkit-linear-gradient(#ffffff, #cc0000 25%, #00cc00 75%, #000000);
background-image: -moz-linear-gradient(#ffffff, #cc0000 25%, #00cc00 75%, #000000);
background-image: -o-linear-gradient(#ffffff, #cc0000 25%, #00cc00 75%, #000000);
background-image: linear-gradient(#ffffff, #cc0000 25%, #00cc00 75%, #000000);
}
## Dead Simple Sprites
Spriting has never been easier with Compass. Nico Hagenburger joined the Compass team and we have built on his popular Lemonade plugin to make Compass sprites. Existing Lemonade users will need to upgrade.
The way they work is you place the sprite images in a folder,
import them into your stylesheet, and then you can use the sprite in your selectors in one
of several convenient ways.
For example, let's imagine that in your project's image folder there are four icons:
* `<images_dir>/icon/new.png`
* `<images_dir>/icon/edit.png`
* `<images_dir>/icon/save.png`
* `<images_dir>/icon/delete.png`
The simplest way to use these icon sprites is to let compass give you a class for each sprite:
@import "icon/*.png";
@include all-icon-sprites;
And you'll get the following CSS output:
.icon-sprite,
.icon-delete,
.icon-edit,
.icon-new,
.icon-save { background: url('/images/icon-34fe0604ab.png') no-repeat; }
.icon-delete { background-position: 0 0; }
.icon-edit { background-position: 0 -32px; }
.icon-new { background-position: 0 -64px; }
.icon-save { background-position: 0 -96px; }
You can now apply the `icon-XXX` classes to your markup as needed.
Of course, this is Compass which means that underneath this simple veneer is a powerful system that you can use to customize your selectors and all kinds of other scenarios involving unicorns and rainbows. Get all the details in our [Spriting Tutorial](/help/tutorials/spriting/).
## New Typography Module
New in this release is a typography module. Many of our utility mixins related to typography have been moved here, but the really exciting development is the addition of the [vertical rhythm module](/reference/compass/typography/vertical_rhythm/). Based on [this excellent tutorial](http://24ways.org/2006/compose-to-a-vertical-rhythm) from 24ways, it is now simpler than ever to compose to a vertical rhythm.
## Blueprint 1.0
Blueprint is 1.0 now and the Compass port is updated to match the changes there. Some of the changes that blueprint made might affect your design, so if you don't want to take this upgrade, you should unpack blueprint before you upgrade:
compass unpack blueprint
## New Website
As you can see, we have a spiffy new website design from Compass Core team member [Brandon](http://brandonmathis.com/). A testament to the separation of content and presentation, most of this redesign was done by throwing out our old stylesheets and building new ones. If you don't like the light text on dark background theme, you can turn on the lights by clicking the power button in the upper right hand corner of every page.
## Much, Much More
There's more features in this release than would fit into this post. Here's some other things you'll find in this release:
* Custom directory and file watching (E.g. for pngcrush support)
* Compilation Callback support
* Trigonometric functions
Read the [CHANGELOG](/CHANGELOG/) for all the details.
Additionally, expect a point release to follow shortly with support for:
* Rails 3.1
Lastly, Compass v0.11 will have point releases as needed to adapt to changes in browser support for the CSS3 module.
## Many Thanks
Compass wouldn't be possible without Nathan Weizenbaum and his hard work on Sass. The latest Sass release
provides a ton of great features that have made this Compass release possible.
Compass is far to big for one person to manage it now. I'd like to thank the hard work of the Compass core team members:
* [Eric Meyer](http://eric.oddbird.net/)
* [Brandon Mathis](http://brandonmathis.com/)
* [Scott Davis](https://github.com/jetviper21)
* [Nico Hagenburger](http://www.hagenburger.net/)
Additionally, there were commits from 10 other great folks in this release and there's been [contributions from 68 people](https://github.com/chriseppstein/compass/contributors) in total so far.
Lastly thanks to the hundreds, if not thousands, of users who have helped test this release and provided valuable feedback, bug reports, and documentation suggestions. Together, we are making a real stylesheet framework and simplifying the lives of web developers across the world.

View File

@ -0,0 +1,93 @@
---
title: "Compass Release Strategy"
description: "An overview of how Compass will be managing ongoing releases."
author: chris
---
Most of this is probably obvious, but it doesn't hurt to be explicit about such things.
If you're interested in contributing to Compass, please read the
[Contribution Guide](http://compass-style.org/help/tutorials/contributing/).
Versioning
----------
Most stable releases will be released as release candidates first
(e.g `0.11.1.rc.0`) and then made into official releases after a day
or so if they don't cause any problems.
Sass Dependency
---------------
We will decouple major Compass releases from the Sass release schedule
going forward. When Sass releases happen, we will issue patches to both
stable and master branches to adjust to any deprecations and new
features after they are fully released (which means we might have the
changes waiting in a topic branch). Because Sass is very careful to not
break existing stylesheets without deprecating first, this shouldn't be
hard to pull off.
Stylesheet Progress
-------------------
I do not want to see the compass stylesheets get frozen again
like they did in v0.10 while waiting for the next major release.
Compass users expect us to keep up with browser developments and we will.
If this means that we need to make v0.12 become v0.13 because
the stylesheets need to make some major change, then we will do that.
Communicating Change
--------------------
All new features should have tests, docs, and CHANGELOG entries
as appropriate as part of the commit.
Additionally, we now have a compass team blog that we can use to communicate
about new features, best practices, or other Compass related stuff.
It's easy to add a post, you just drop a markdown file into
[this directory](https://github.com/chriseppstein/compass/tree/stable/doc-src/content/posts).
Guest posts are totally welcome via pull requests.
Stable
------
The stable release is were code lives for the next v0.11 point release.
Commits should only go here if they are ready for release, until that
point the code should live in your compass fork or in a topic branch.
Core team members, please use pull requests to manage the code review
process for any change of significance and get sign-off from one other
team member before committing to stable.
Changes that can go on stable:
* Browser support updates
* Non-breaking stylesheet changes and minor features
like new mixins or modules.
* Bug fixes
Changes that can't go on stable:
* New deprecations
* Major features
* Big refactors
If you're not sure where to put something, just ask.
Rails 3.1 support is the exception to this rule, given the timeline
assocated with that release, I will make a topic branch and we'll
merge that to stable when it's ready.
Core team members will, after committing/merging code to stable, then merge those changes to master so it is up to date.
Master
------
Master is where code goes to be ready for v0.12. This focus of this
next release is making extensions easy to make, share, discover, install,
remove, and use. Any and all ideas that you have related to this are
welcome. At a minimum, I would like to have an extension directory
app hosted on compass-style.org and make sure that compass knows about
it and can install extensions by name from there.

View File

@ -0,0 +1,34 @@
---
title: "How to use Compass/Sass with Django."
description: "All the documentation is for Ruby/Rails development, so how does it work for the rest of us?"
author: eric
---
It's easy! Follow these two simple steps:
1. Use Compass/Sass.
2. Use Django.
That's it. Compass works great as a stand-alone tool. Run "compass --watch" on the command line or use [compass.app](http://compass.handlino.com/) to compile your stylesheets, and then commit the CSS to your Django project, just like you always have. Done.
## What about integration?
Compass and Sass are built in Ruby. When the rest of your project is also built in Ruby, it makes sense to squeeze every last ounce of convenient automatic integration, like having your project automatically compile Sass to CSS for you at runtime. But that integration is not actually necessary, and when the rest of your project is not Ruby, you pay a lot more for that little bit of convenience.
A Rails/Ruby project already has a full Ruby stack and deployment infrastructure to make sure all the right Ruby gems are available on the server. Adding a few Compass gems makes very little difference in the complexity of your production deployment.
For a Django project, integrating run-time Compass compilation (via something like [django-css](https://github.com/dziegler/django-css)) means requiring a full Ruby stack on your production servers, plus new deployment infrastructure for getting all the right gem versions in place. This is a significant chunk of additional moving parts on your production servers.
Keeping your production servers simpler is A Very Good Thing. (And, as a bonus, it allows you to deploy your project to pure-Python managed hosting environments).
## In development.
The disadvantage to our approach is that you are committing generated code to the repo. That's generally frowned upon. But we haven't seen any actual problems as a result of this. Nobody on the team is tempted to edit the generated CSS directly; we all know that we use Compass for that. There are no mysterious display inconsistencies between one developer and another, or between development and production, because of minor differences in something like a Compass plugin gem version. Everyone sees the same CSS. Differences between developers' Compass environments are caught quickly, because they show up right away as unexpected changes in the pre-commit diff of the generated CSS.
And I, as the designer/front-end developer, keep full control of the css-generation process without needing to touch the server. If I want to update the gems and make some changes, I can do that. I make the change, I commit the change, and it just works. For everyone. That's important to me. It removes all the pretense of dark magic that can come with Sass/Compass. I'm writing CSS. I'm committing CSS. Compass, Sass and all their plugins are just tools towards that end.
Of course, you'll want to commit the Sass as well, especially if you have multiple front-end developers on the team. That way the source is available for anyone who needs to update it, even though it's not needed by the server. You might also want a way of documenting the latest gems that should be used to compile it. That's easy enough to add in a comment or doc of it's own.
## Just Tools.
I want to say that again because I think it is the most important and most often forgotten rule of using a css pre-processor. **Compass and Sass are simply tools for writing CSS. They are not a new styling language. They are not magic. They make writing css easier - and that is all. The css output is the only thing that matters.**

View File

@ -3,6 +3,7 @@ title: Blueprint Reset
crumb: Reset crumb: Reset
framework: blueprint framework: blueprint
stylesheet: blueprint/_reset.scss stylesheet: blueprint/_reset.scss
sidebar: true
layout: blueprint layout: blueprint
classnames: classnames:
- reference - reference

View File

@ -16,10 +16,8 @@ layout: core
other frameworks and extensions. other frameworks and extensions.
%h2 Non Imported Modules %h2 Non Imported Modules
%em You can import these yourself if you want to use them.
%p %ol
You can import these yourself if you want to use them. %li= render "partials/reference/import", :import => "compass/_layout.scss"
%ul %li= render "partials/reference/import", :import => "compass/_reset.scss"
= render "partials/reference/import", :import => "compass/_layout.scss"
= render "partials/reference/import", :import => "compass/_reset.scss"

View File

@ -3,6 +3,7 @@ title: Compass CSS3
crumb: CSS3 crumb: CSS3
framework: compass framework: compass
stylesheet: compass/_css3.scss stylesheet: compass/_css3.scss
sidebar: true
layout: core layout: core
classnames: classnames:
- reference - reference

View File

@ -0,0 +1,16 @@
---
title: Compass Appearance
crumb: Appearance
framework: compass
stylesheet: compass/css3/_appearance.scss
meta_description: Specify the CSS3 appearance property.
layout: core
classnames:
- reference
- core
- css3
---
- render 'reference' do
:markdown
Provides a mixin for `appearance`.
See the CSS3 specification: [appearance](http://www.w3.org/TR/css3-ui/#appearance).

View File

@ -12,13 +12,8 @@ classnames:
- css3 - css3
--- ---
- render 'reference' do - render 'reference' do
%p :markdown
**<span class="warning">IMPORTANT:</span>** This module has been deprecated. See the new
[images module](../images/) for the new, more flexible approach to gradients.
Provides mixins to create cross-browser CSS3 gradients. Provides mixins to create cross-browser CSS3 gradients.
%p
To enable SVG gradient support in Opera and IE9, set
<code>$experimental-support-for-svg: true</code> in your stylesheet.
%p
NOTE: At this time, Opera renders incorrectly an SVG background on a element
with a border, repeating the gradient towards the end. You can set
<code>background-repeat: no-repeat</code> to avoid this, but the gradient
will not fill the area completely.

View File

@ -12,6 +12,33 @@ classnames:
- css3 - css3
--- ---
- render 'reference' do - render 'reference' do
%p :markdown
Provides mixins that work across many modern browsers with the latest Provides mixins that work across many modern browsers with the latest
CSS3 image rendering primitives. CSS3 image rendering primitives.
These mixins provide intelligent cross-browser access to properties that accept
images or image-like values (e.g. gradients). The syntax is very straightforward,
it is exactly like the css syntax that you would use for the corresponding CSS3
properties: Values are comma and space delimited, just as they would be for a property.
Vendor prefixes are used only when necessary.
Example (more examples are available by following the links below):
<pre><code class="source-code scss">.in-css3 {
background: url(foo.png),
linear-gradient(top left, #333, #0c0),
radial-gradient(#c00, #fff 100px);
}
.with-compass {
@include background(image-url("foo.png"),
linear-gradient(top left, #333, #0c0),
radial-gradient(#c00, #fff 100px));
}</code></pre>
To enable SVG gradient support in Opera and IE9, set
<code>$experimental-support-for-svg: true</code> in your stylesheet.
NOTE: At this time, Opera renders incorrectly an SVG background on a element
with a border, repeating the gradient towards the end. You can set
<code>background-repeat: no-repeat</code> to avoid this, but the gradient
will not fill the area completely.

View File

@ -74,6 +74,6 @@ classnames:
* For more information see the [css3pie website](http://css3pie.com/). * For more information see the [css3pie website](http://css3pie.com/).
* CSS PIE is written by and copyright to: [Jason Johnston](http://twitter.com/lojjic) * CSS PIE is written by and copyright to: [Jason Johnston](http://twitter.com/lojjic)
* Compass is using css3pie version 1.0-beta2. It can be upgraded by downloading * Compass is using css3pie version 1.0-beta3. It can be upgraded by downloading
a new behavior file and replacing the one that comes with compass. a new behavior file and replacing the one that comes with compass.

View File

@ -2,6 +2,7 @@
title: Compass Helpers title: Compass Helpers
crumb: Helpers crumb: Helpers
framework: compass framework: compass
sidebar: true
layout: core layout: core
classnames: classnames:
- reference - reference
@ -14,7 +15,7 @@ layout: core
:markdown :markdown
The compass helpers are functions that augment the [functions provided The compass helpers are functions that augment the [functions provided
by Sass](http://sass-lang.com/yardoc/Sass/Script/Functions.html). by Sass](http://sass-lang.com/docs/yardoc/Sass/Script/Functions.html).
All Helpers: All Helpers:
@ -23,6 +24,7 @@ layout: core
* [append-selector()](/reference/compass/helpers/selectors/#append-selector) * [append-selector()](/reference/compass/helpers/selectors/#append-selector)
* [color-stops()](/reference/compass/helpers/color-stops/) * [color-stops()](/reference/compass/helpers/color-stops/)
* [cos()](/reference/compass/helpers/trig/#cos) * [cos()](/reference/compass/helpers/trig/#cos)
* [css2-fallback()](/reference/compass/helpers/cross-browser/#css2-fallback)
* [elements-of-type()](/reference/compass/helpers/display/) * [elements-of-type()](/reference/compass/helpers/display/)
* [enumerate()](/reference/compass/helpers/selectors/#enumerate) * [enumerate()](/reference/compass/helpers/selectors/#enumerate)
* [font-files()](/reference/compass/helpers/font-files/) * [font-files()](/reference/compass/helpers/font-files/)
@ -34,9 +36,18 @@ layout: core
* [inline-font-files()](/reference/compass/helpers/inline-data/#inline-font-files) * [inline-font-files()](/reference/compass/helpers/inline-data/#inline-font-files)
* [inline-image()](/reference/compass/helpers/inline-data/#inline-image) * [inline-image()](/reference/compass/helpers/inline-data/#inline-image)
* [nest()](/reference/compass/helpers/selectors/#nest) * [nest()](/reference/compass/helpers/selectors/#nest)
* [prefix()](/reference/compass/helpers/cross-browser/#prefix)
* [prefixed()](/reference/compass/helpers/cross-browser/#prefixed)
* [pi()](/reference/compass/helpers/trig/#pi) * [pi()](/reference/compass/helpers/trig/#pi)
* [sin()](/reference/compass/helpers/trig/#sin) * [sin()](/reference/compass/helpers/trig/#sin)
* [stylesheet-url()](/reference/compass/helpers/urls/#stylesheet-url) * [stylesheet-url()](/reference/compass/helpers/urls/#stylesheet-url)
* [scale-lightness()](/reference/compass/helpers/colors/#scale-lightness) * [scale-lightness()](/reference/compass/helpers/colors/#scale-lightness)
* [tan()](/reference/compass/helpers/trig/#tan) * [tan()](/reference/compass/helpers/trig/#tan)
* [-css2()](/reference/compass/helpers/cross-browser/#-css2)
* [-moz()](/reference/compass/helpers/cross-browser/#-moz)
* [-ms()](/reference/compass/helpers/cross-browser/#-ms)
* [-o()](/reference/compass/helpers/cross-browser/#-o)
* [-pie()](/reference/compass/helpers/cross-browser/#-pie)
* [-svg()](/reference/compass/helpers/cross-browser/#-svg)
* [-webkit()](/reference/compass/helpers/cross-browser/#-webkit)

View File

@ -8,6 +8,8 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "color-stops"
--- ---
%h1 Compass Color Stops Helper %h1 Compass Color Stops Helper

View File

@ -8,6 +8,11 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "adjust-lightness"
- "adjust-saturation"
- "scale-lightness"
- "scale-saturation"
--- ---
%h1 Compass Color Helpers %h1 Compass Color Helpers
%p %p

View File

@ -8,6 +8,8 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "opposite-position"
--- ---
%h1 Compass Constant Helpers %h1 Compass Constant Helpers

View File

@ -0,0 +1,125 @@
---
title: Compass Cross Browser Helpers
crumb: Cross Browser
framework: compass
meta_description: Helper functions for working with vendor prefixed functions.
layout: core
classnames:
- reference
- core
- helpers
documented_functions:
- "prefixed"
- "prefix"
- "-webkit"
- "-moz"
- "-o"
- "-ms"
- "-svg"
- "-pie"
- "-css2"
---
%h1 Compass Cross Browser Helpers
:markdown
These helpers are used by compass to create mixins that can insulate
the user from cross browser syntax and vendor prefix complexities.
If you need to support a new experimental (prefixed) function in your
project using these helpers, you can add support for it adding the following
to your compass configuration file:
Compass::BrowserSupport.add_support("function-name", "webkit", "moz")
For an example of how to use these functions see the
[compass images module](https://github.com/chriseppstein/compass/blob/master/frameworks/compass/stylesheets/compass/css3/_images.scss).
#prefixed.helper
%h3
%a(href="#prefixed")
prefixed(<span class="arg">$prefix<span>, <span class="arg">$arg</span>, ...)
.details
%p
Returns true if any of the arguments require the given prefix.
#prefix.helper
%h3
%a(href="#prefix")
prefix(<span class="arg">$prefix<span>, <span class="arg">$arg</span>, ...)
.details
%p
Transforms the argument(s) into a representation for the rendering engine
indicated by <code>$prefix</code>. Usually this means just adding a prefix,
but in some cases, this may result in entirely different representations for
the given rendering engine (E.g. linear-gradient).
%p
Values that do not have a specific representation are passed through without
being transformed.
#-webkit.helper
%h3
%a(href="#-webkit")
\-webkit(<span class="arg">$arg</span>, ...)
.details
%p
This is a shortcut for calling <code>prefix(-webkit, $arg, ...)</code>.
#-moz.helper
%h3
%a(href="#-moz")
\-moz(<span class="arg">$arg</span>, ...)
.details
%p
This is a shortcut for calling <code>prefix(-moz, $arg, ...)</code>.
#-o.helper
%h3
%a(href="#-o")
\-o(<span class="arg">$arg</span>, ...)
.details
%p
This is a shortcut for calling <code>prefix(-o, $arg, ...)</code>.
#-ms.helper
%h3
%a(href="#-ms")
\-ms(<span class="arg">$arg</span>, ...)
.details
%p
This is a shortcut for calling <code>prefix(-ms, $arg, ...)</code>.
#-svg.helper
%h3
%a(href="#-svg")
\-svg(<span class="arg">$arg</span>, ...)
.details
%p
This is a shortcut for calling <code>prefix(-svg, $arg, ...)</code>.
Instead of adding a prefix, it returns a representation of the
arguments using SVG to render them where it can.
#-pie.helper
%h3
%a(href="#-pie")
\-pie(<span class="arg">$arg</span>, ...)
.details
%p
This is a shortcut for calling <code>prefix(-pie, $arg, ...)</code>.
It it used to get <a href="/reference/compass/css3/pie/">CSS3 PIE</a>
support where necessary.
#-css2.helper
%h3
%a(href="#-css2")
\-css2(<span class="arg">$arg</span>, ...)
.details
%p
This is a shortcut for calling <code>prefix(-css2, $arg, ...)</code>.
It is a kind of hack to sanitize the output of experimental code
into a form that can be parsed by a css2.1 compliant parser.
Usually this results in causing some functions to be omitted.
#css2-fallback.helper
%h3
%a(href="#css2-fallback")
css2-fallback(<span class="arg">$value</span>, <span class="arg">$css2-value</span>)
.details
%p
This function returns a value that is normally <code>$value<code>,
but is <code>$css2-value</code> when passed through the <code>-css2()</code>
helper function. Many of the compass css3 mixins will create a css2 fallback
value if the arguments have a css2 representation (gradients have a null css2
representation).

View File

@ -8,6 +8,8 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "elements-of-type"
--- ---
%h1 Compass Display Helpers %h1 Compass Display Helpers
@ -19,7 +21,7 @@ classnames:
.details .details
%p %p
The following display values exist and will return The following display values exist and will return
the elements listed to the right. the elements listed below the display value.
%dl %dl
%dg.head %dg.head
%dt Display Value %dt Display Value

View File

@ -8,6 +8,8 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "font-files"
--- ---
%h1 Compass Font Files Helper %h1 Compass Font Files Helper

View File

@ -8,6 +8,9 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "image-width"
- "image-height"
--- ---
%h1 Compass Image Dimension Helpers %h1 Compass Image Dimension Helpers

View File

@ -8,6 +8,9 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "inline-image"
- "inline-font-files"
--- ---
%h1 Compass Inline Data Helpers %h1 Compass Inline Data Helpers

View File

@ -8,6 +8,12 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "nest"
- "append-selector"
- "enumerate"
- "headings"
- "headers"
--- ---
%h1 Compass Selector Helpers %h1 Compass Selector Helpers
@ -67,6 +73,7 @@ classnames:
%li %li
%a(href="/examples/compass/helpers/using-extend-in-place-of-enumerate/") Example of using <code>@extend</code> in place of enumerate %a(href="/examples/compass/helpers/using-extend-in-place-of-enumerate/") Example of using <code>@extend</code> in place of enumerate
%a(name="headers")
#headings.helper #headings.helper
%h3 %h3
%a(href="#append-selector") %a(href="#append-selector")

View File

@ -0,0 +1,139 @@
---
title: Compass Sprite Helpers
crumb: Sprites
framework: compass
meta_description: Helper functions for working with Sprite images.
layout: core
classnames:
- reference
- core
- helpers
documented_functions:
- "sprite-map"
- "sprite"
- "sprite-map-name"
- "sprite-file"
- "sprite-url"
- "sprite-position"
---
%h1 Compass Sprite Helpers
:markdown
These helpers make it easier to build and to work with sprites.
While it is allowed to use these directly, to do so is considered "advanced usage".
It is recommended that you instead use the sprite mixins that are designed to work
with these functions.
See the [Spriting Tutorial](/help/tutorials/spriting/) for more information.
#sprite-map.helper
%h3
%a(href="#sprite-map")
sprite-map(<span class="arg">$glob</span>, <span class="arg">...</span>)
.details
:markdown
Generates a sprite map from the files matching the glob pattern. Uses the
keyword-style arguments passed in to control the placement.
Only PNG files can be made into sprites at this time.
The `$glob` should be glob pattern relative to the images directory that specifies
what files will be in the sprite. For example:
$icons: sprite-map("icons/*.png");
background: $icons;
This will generate a sprite map and return a reference to it. It's important to
capture this to a variable, because you will need to use it later when creating
sprites. In the above example you might end up with a new file named
`images/sprites/icons-a2ef041.png` and your css stylesheet will have:
background: url('/images/sprites/icons-a2ef041.png?1234678') no-repeat;
The exact image name is not something you should depend on as it may change based on the
arguments you pass in. Instead, you can use the `sprite-url()` function to create a
reference to the sprite map without generating the image again. Alternatively, simply
using the sprite map variable in an property will have the same effect as calling
`sprite-url()`.
For each sprite in the sprite map you can control the position, spacing, and whether or
not it repeats. You do this by passing arguments to this function that tell each sprite
how to behave. For instance if there is a icons/new.png then you can control it like so:
$icon-sprite: sprite-map("icons/*.png",
$new-position: 100%, $new-spacing: 15px, $new-repeat: no-repeat);
If you don't specify these options they will default to `0%` for `position`,
`0px` for spacing, and `no-repeat` for `repeat`.
Default values for all sprites can be specified by passing values for `$position`,
`$spacing`, and `$repeat`.
#sprite.helper
%h3
%a(href="#sprite")
sprite(<span class="arg">$map</span>, <span class="arg">$sprite</span>, <span class="arg" data-default-value="0">$offset-x</span>, <span class="arg" data-default-value="0">$offset-y</span>)
.details
:markdown
Returns the image and background position for use in a single shorthand property:
$icons: sprite-map("icons/*.png"); // contains icons/new.png among others.
background: sprite($icons, new) no-repeat;
Becomes:
background: url('/images/icons.png?12345678') 0 -24px no-repeat;
#sprite-map-name.helper
%h3
%a(href="#sprite-map-name")
sprite-map-name(<span class="arg">$map</span>)
.details
:markdown
Returns the name of a sprite map
The name is derived from the folder than contains the sprites.
#sprite-file.helper
%h3
%a(href="#sprite-file")
sprite-file(<span class="arg">$map</span>, <span class="arg">$sprite</span>)
.details
:markdown
Returns the relative path (from the images directory) to the original file
used when construction the sprite. This is suitable for passing to the
`image-width` and `image-height` helpers.
#sprite-url.helper
%h3
%a(href="#sprite-url")
sprite-url(<span class="arg">$map</span>)
.details
:markdown
Returns a url to the sprite image.
#sprite-position.helper
%h3
%a(href="#sprite-position")
sprite-position(<span class="arg">$map</span>, <span class="arg">$sprite</span>, <span class="arg" data-default-value="0">$offset-x</span>, <span class="arg" data-default-value="0">$offset-y</span>)
.details
:markdown
Returns the position for the original image in the sprite.
This is suitable for use as a value to background-position:
$icons: sprite-map("icons/*.png");
background-position: sprite-position($icons, new);
Might generate something like:
background-position: 0 -34px;
You can adjust the background relative to this position by passing values for
`$offset-x` and `$offset-y`:
$icons: sprite-map("icons/*.png");
background-position: sprite-position($icons, new, 3px, -2px);
Would change the above output to:
background-position: 3px -36px;

View File

@ -8,6 +8,11 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "pi"
- "sin"
- "cos"
- "tan"
--- ---
%h1 Compass Trig Helpers %h1 Compass Trig Helpers

View File

@ -8,6 +8,10 @@ classnames:
- reference - reference
- core - core
- helpers - helpers
documented_functions:
- "stylesheet-url"
- "font-url"
- "image-url"
--- ---
%h1 Compass URL Helpers %h1 Compass URL Helpers
@ -43,11 +47,15 @@ classnames:
#image-url.helper #image-url.helper
%h3 %h3
%a(href="#image-url") %a(href="#image-url")
image-url($path, $only-path: false) image-url($path, $only-path: false, $cache-buster: true)
.details .details
%p %p
Generates a path to an asset found relative to the project's images directory. Generates a path to an asset found relative to the project's images directory.
%br %p
Passing a true value as the second argument will cause the only the path to be returned Passing a true value as the second argument will cause the only the path to be returned
instead of a `url()` function instead of a `url()` function
%p
The third argument is used to control the cache buster on a per-use basis.
When set to `false` no cache buster will be used. When a string, that
value will be used as the cache buster.

View File

@ -2,8 +2,9 @@
title: Compass Layout title: Compass Layout
crumb: Layout crumb: Layout
framework: compass framework: compass
sidebar: true
stylesheet: compass/_layout.scss stylesheet: compass/_layout.scss
meta_description: Page layout module. So far, this is just the sticky-footer mixin. meta_description: Page layout module.
layout: core layout: core
classnames: classnames:
- reference - reference
@ -13,4 +14,3 @@ classnames:
- render 'reference' do - render 'reference' do
%p %p
This module provides tools to help you with page layout. This module provides tools to help you with page layout.
So far, it's just the <code><a href="/reference/compass/layout/sticky_footer/#mixin-sticky-footer">sticky-footer</a></code> mixin.

View File

@ -0,0 +1,16 @@
---
title: Compass Grid Backgrounds
crumb: Grid Background
framework: compass
stylesheet: compass/layout/_grid-background.scss
layout: core
classnames:
- reference
- core
- layout
---
- render 'reference' do
%p
The grid-background mixins allow you to generate fixed, fluid and elastic
grid-images on-the-fly using css3 gradients. These can be used for testing
both horizontal and vertical grids.

View File

@ -0,0 +1,27 @@
---
title: Compass Reset (legacy)
crumb: Reset (legacy)
framework: compass
stylesheet: compass/_reset-legacy.scss
layout: core
sidebar: true
deprecated: true
classnames:
- reference
- core
- reset
meta_description: Adds a CSS Reset into your stylesheet.
---
- render 'reference' do
%p.warning
This import is deprecated. Please import
<a href="/reference/compass/reset/" class="better">reset</a> instead.
:markdown
This module applies the [global reset](/reference/compass/reset/utilities-legacy/#mixin-global-reset)
to your stylesheet by simply importing it.
**Note:** This module will place styles into your stylesheet by importing it. This
is not the standard behavior of a compass module but it optimizes the common use case.
If you want to control the reset, please use the mixins defined in the [reset
utilities module](/reference/compass/reset/utilities-legacy/)

View File

@ -0,0 +1,22 @@
---
title: Compass Reset Utilities (legacy)
crumb: Reset Utilities (legacy)
framework: compass
stylesheet: compass/reset/_utilities-legacy.scss
layout: core
deprecated: true
meta_description: Mixins for resetting elements.
classnames:
- reference
- core
- utilities
---
- render 'reference' do
%p.warning
This import is deprecated. Please import
<a href="/reference/compass/reset/utilities/" class="better">reset utilities</a> instead.
:markdown
These utilities are used to reset your document. The easiest way to use them
is to simply `@import "compass/reset"` which will import this module and apply
the appropriate mixins for you.

View File

@ -4,6 +4,7 @@ crumb: Reset
framework: compass framework: compass
stylesheet: compass/_reset.scss stylesheet: compass/_reset.scss
layout: core layout: core
sidebar: true
classnames: classnames:
- reference - reference
- core - core

View File

@ -0,0 +1,18 @@
---
title: Compass Typography
crumb: Typography
framework: compass
sidebar: true
stylesheet: compass/_typography.scss
classnames:
- reference
- core
- typography
meta_description: Provides basic mixins for common typography patterns.
layout: core
nav_stylesheet: compass/_typography.scss
---
- render 'reference' do
%p
The Compass Typography module provides some basic mixins
for common text styling patterns.

View File

@ -2,14 +2,14 @@
title: Compass Links title: Compass Links
crumb: Links crumb: Links
framework: compass framework: compass
stylesheet: compass/utilities/_links.scss stylesheet: compass/typography/_links.scss
sidebar: true
layout: core layout: core
nav_stylesheet: compass/_utilities.scss
meta_description: Tools for styling anchor links. meta_description: Tools for styling anchor links.
classnames: classnames:
- reference - reference
- core - core
- utilities - typography
--- ---
- render 'reference' do - render 'reference' do
%p %p

Some files were not shown because too many files have changed in this diff Show More