Sass instructions missing in README

[0x-r4bbit]

Hi there!

I just wanted to dry-run your pixyll theme and cloned the repo etc. Unfortunately, it doesn't work out of the box, if one doesn't run a sass compiler to get a proper pixyll.css file.

Would you mind updating the readme accordingly? Otherwise it could be very annoying for other users.

Also, running trying to compile css/pixyll.scss doesn't work due to error:

Syntax error: Invalid CSS after "-": expected number or function, was "--"
        on line 1 of css/pixyll.scss
  Use --trace for backtrace.

[johno]

Hey @PascalPrecht , sorry you're running into trouble with this.

Firstly, Jekyll should be running the Sass compilation automatically. You're encountering a Sass compilation error because Jekyll requires front matter on .sass, .scss, and .coffee files. As a result of the front matter, the pixyll.scss file isn't actually a valid Sass file (unfortunate, I know).

How are you running the project? When you run $ jekyll serve or $ jekyll build the Sass will be compiled and placed in _site/css/pixyll.css. If you run the server with the $ jekyll serve command the built website should be served up at localhost:4000.

Also, I'm happy to add anything to the documentation to make it easier for getting people up and running quickly. So, once we figure out what this issue is I'll include any relevant info to the README. Thanks!

[0x-r4bbit]

Hey @johnotander thanks for answering so quickly.

I simply run jekyll serve --watch and it doesn't compile sass files automatically. And it's just that. The serving works.

Jekyll version is 1.4.2

[anandrajaram]

@PascalPrecht : I had the same issue and it went away once I updated to the latest jekyll version

% jekyll -version
jekyll 2.4.0

[0x-r4bbit]

@anandrajaram interesting! Will update now and let you guys know if it helped.

[0x-r4bbit]

Aaaaand it worked! Thank you! Maybe updating the docs accordingly would be great! Closing this one.

[johno]

I will update the docs to note the required version. Thanks @PascalPrecht and @anandrajaram !

[anandrajaram]

Native Sass Support was introduced 2.0+ http://jekyllrb.com/news/2014/05/06/jekyll-turns-2-0-0/

[johno]

Thanks @anandrajaram, I'm adding that link to the README right now.