linkorb / stylex
Toolkit for managing style-guides, policies and rule-books
v1.0.0
2018-10-28 14:54 UTC
Requires
- symfony/console: ^4.0
- symfony/yaml: ^4.0
- zordius/lightncandy: ^1.0
This package is auto-updated.
Last update: 2024-10-29 04:42:15 UTC
README
Styleguide toolkit for X (everything)
Use-cases:
- Language styleguides (i.e. php, javascript, markdown, etc)
- Organization specific coding conventions
- File formatting styleguides (i.e. whitepace usage in YAML files, etc)
- Technical writing style guide
- Tone-of-Voice style guide
- Branding style guide (usage of logos, brand colors, fonts, etc)
Usage
Globally install stylex through composer:
composer global require linkorb/stylex
Now cd
into a -style-guide
directory and run:
stylex template path-to-my-templates build/
The template
command will load the style guide files (yaml, json, md, etc) from the current directory, and run them through the (handlebars) templates in your template directory.
The generated output files will be saved in build/
Example
Check out the example/
directory.
To build this style-guide, simply run:
cd example/
../bin/stylex template ../templates/basic/ build/
open build/index.md
Awesome style guides:
- StyleGuide.io
- Mailchimp's Content Style Guide
- Atlassian Design
- Atlassian Product Style Guide
- Google Developer Documentation Style Guide
Want to suggest other awesome style guides for this sections? Just send a PR!
License
MIT (see LICENSE.md)
Brought to you by the LinkORB Engineering team
Check out our other projects at linkorb.com/engineering.
Btw, we're hiring!