mirror of https://github.com/deuill/fawkss.git
67 lines
3.0 KiB
Markdown
67 lines
3.0 KiB
Markdown
# Fawkss — The [ig]noble CSS preprocessor [![MIT License][license-svg]][license-url]
|
||
|
||
Fawkss [fɔːks] is a simple CSS preprocessor built as a single AWK (nawk/gawk/mawk) script. Syntactically, it borrows as much as possible from the SASS language, for convenience and familiarity.
|
||
|
||
This is more of a fun project than a production-ready piece of software, though it may find some use for people needing simple additions to CSS without pulling in the massive ecosystem that comes with Less.js/SASS etc.
|
||
|
||
## Status
|
||
|
||
Currently, the following SASS features are implemented, in varying degrees:
|
||
|
||
### C99/C++-style comments
|
||
|
||
Lines that contain comments using the `//` syntax are removed from the final output, and are useful for including commentary that should otherwise not be available to end-users.
|
||
|
||
Comments using the `/* */` syntax are not handled, and remain intact in the final output.
|
||
|
||
### Variables
|
||
|
||
Variables can be defined and used with the following syntax:
|
||
|
||
```scss
|
||
$variable-name: 10px;
|
||
width: $variable-name;
|
||
```
|
||
|
||
All variables are defined in the global scope, and cannot be used before definition. Using an undefined variable is a fatal error, and halts execution. Variable names can contain alphanumeric characters, as well as underscore and hyphen characters, and are always prefixed with a dollar sign.
|
||
|
||
Variables must be appear on their own line, and cannot be mixed with other declarations. Redefining a variable overrides its previous value, with no warning message emitted.
|
||
|
||
### Imports
|
||
|
||
CSS import declarations are extended for concatenating SCSS files together transparently. For a file `common/_colors.scss`, the following declarations are equivalent:
|
||
|
||
```scss
|
||
@import "common/colors";
|
||
@import "common/colors.scss";
|
||
@import "common/_colors";
|
||
@import "common_colors.scss";
|
||
```
|
||
|
||
Unlike SASS, files with leading underscores are not handled especially as partials.
|
||
|
||
### Mixins
|
||
|
||
Mixin support is currently minimal, with parameters (including default values) and nested mixins handled.
|
||
|
||
Features such as variadic parameters and mixins with parent selectors are forthcoming.
|
||
|
||
## Roadmap
|
||
|
||
It is intended that the script never balloons to more than ~1000 lines of code. I'm trying to tackle the most important features yet and see how well they fit within the AWK mindset.
|
||
|
||
That being said, I do not plan to implement any context-sensitive functionality (such as nesting etc.), which may be nigh-impossible in AWK anyways. Consider it a feature.
|
||
|
||
## Testing & Documentation
|
||
|
||
A `Makefile` is provided for running tests and producing documentation for Fawkss. Run `make help` in the project root for more information.
|
||
|
||
A full test-suite is provided (depending only on `make` and `awk`), which should serve as a good example of the existing feature-set.
|
||
|
||
## License
|
||
|
||
All code in this repository is covered by the terms of the MIT License, the full text of which can be found in the LICENSE file.
|
||
|
||
[license-url]: https://github.com/deuill/go-php/blob/master/LICENSE
|
||
[license-svg]: https://img.shields.io/badge/license-MIT-blue.svg
|