43 lines
1.4 KiB
Markdown
43 lines
1.4 KiB
Markdown
|
### stylus-lookup [![npm](http://img.shields.io/npm/v/stylus-lookup.svg)](https://npmjs.org/package/stylus-lookup) [![npm](http://img.shields.io/npm/dm/stylus-lookup.svg)](https://npmjs.org/package/stylus-lookup)
|
||
|
|
||
|
> Get the file associated with a Stylus import
|
||
|
|
||
|
This module replaces the Stylus compiler's lookup algorithm for resolving a partial's path.
|
||
|
|
||
|
* Handles same directory lookups,
|
||
|
partials with or without extensions, partials within subdirectories,
|
||
|
partials with the `.styl` or `.css` in the name,
|
||
|
partials using the `index.styl` resolution.
|
||
|
|
||
|
* **Does not** currently support glob imports or the use of additional paths. PRs welcome.
|
||
|
|
||
|
*Originally built for [Dependents](https://github.com/mrjoelkemp/Dependents#dependents)*
|
||
|
|
||
|
### Usage
|
||
|
|
||
|
`stylusLookup({
|
||
|
dependency: 'foo',
|
||
|
filename: 'path/to/file',
|
||
|
directory: 'path/to/all/files'
|
||
|
})`
|
||
|
|
||
|
* `dependency`: The partial's name
|
||
|
* If your stylus file had `@import foo`, then `foo` would be the dependency name
|
||
|
* `filename`: The file importing the dependency
|
||
|
* `directory`: The location of all stylus files
|
||
|
|
||
|
Example:
|
||
|
|
||
|
```js
|
||
|
var stylusLookup = require('stylus-lookup');
|
||
|
|
||
|
stylusLookup({
|
||
|
dependency: 'variables',
|
||
|
filename: 'app/styles/styles.styl',
|
||
|
directory: 'app/styles'
|
||
|
}); // yields app/styles/variables.styl
|
||
|
```
|
||
|
|
||
|
* This assumes that the file `app/styles/styles.styl` has `@import variables` or `@require variables`
|
||
|
and that all of the other stylus files are located within `app/styles`.
|