Yet Another Stylus Renderer
A Stylus renderer for Hexo that uses Nib, Axis, Rupture, Jeet, and Typographic. It used to have Autoprefixer but it got deprecated, so I had to let it go. For now.
Please use Hexo version 3.0.0 or above. This doesn't support 2.x.x and never will.
Features
Integrated libraries
Some libraries ask you to place @import [library]
in your .styl
file. YASR takes care of this for you. To use a library you just have to enable it in the _config.yml
and start using it.
Source Maps
YASR can output sourcemaps to your CSS files. This is provided by Stylus, so if you encounter any bugs, let the Stylus developers know.
Warning: Some libraries can cause problems with sourcemaps.
Load properties from the theme configuration
The render is now able to fetch properties that are defined inside the theme configuration file and place them in your CSS.
I got the code from the original hexo-renderer-stylus
.
Theme's _config.yml
:
img: 'http://loremflickr.com/800/600/'
Stylus:
.classbackground-image 'img')
Resulting CSS:
Compression
We use Stylus built in compression flag to minify the outputted CSS files.
Installation
Check to see if you have installed hexo-renderer-stylus
(check inside the node-modules
directory, but don't delete it.). If you have it installed run:
npm un hexo-renderer-stylus --save
After you've removed the default renderer, or if you never installed it in the first place, run:
npm i hexo-renderer-yasr --save
Configuration
Place the following code inside your _config.yml
.
# YASR Configuration## Docs: https://github.com/celsomiranda/hexo-renderer-yasryasr:axis: true # Enables Axis (Recommends Nib)compress: false # Disables Compressionjeet: true # Enables Jeetnib: true # Enables Nibrupture: true # Enables Rupturetypographic: true # Enables Typographicsourcemaps: # Sourcemaps configurationcomment: trueinline: truesourceRoot: ''basePath: 'css/'
- Sourcemaps
- comment - Adds a comment with the
sourceMappingURL
to the generated CSS (default:true
) - inline - Inlines the sourcemap with full source text in base64 format (default:
false
) - sourceRoot -
sourceRoot
property of the generated sourcemap - basePath - Base path from which sourcemap and all sources are relative (default:
.
)
- comment - Adds a comment with the