linkorb/stylex

Toolkit for managing style-guides, policies and rule-books

v1.0.0 2018-10-28 14:54 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:

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

687474703a2f2f7777772e6c696e6b6f72622e636f6d2f642f6d6574612f74696572312f696d616765732f6c696e6b6f7262656e67696e656572696e672d6c6f676f2e706e67
Check out our other projects at linkorb.com/engineering.

Btw, we're hiring!