Add KSS style guide for design components used in Seven theme
Migrated issue
Reported by: johnalbin
Problem/Motivation
This is a sibling issue to #2404111: [Meta] Create a visual style guide for the Seven theme. If we complete that task, we would need some drupal.org infrastructure to host the new files.
If Drupal core has KSS comments that document how each CSS component is to be used and how it looks, module developers and themers would need a simple way to view the style guide that can be generated from the KSS comments.
Having those people generate the style guide using free tools (a KSS parser and generator) is easy for technically proficient users, but burden-some for others.
Proposed resolution
We should have drupal.org parse the KSS comments inside Drupal core's CSS, generate a static HTML style guide from them, and host the style guide somewhere on api.drupal.org.
Remaining tasks
- Agree KSS comments should go into Drupal 8 core CSS files. See #2404111: [Meta] Create a visual style guide for the Seven theme
- Install Node.js on the build server.
- Create a package.json file for the Seven theme's style guide.
{
"name": "seven-style-guide",
"version": "8.0.0",
"description": "The style guide for the Seven theme.",
"devDependencies": {
"kss": "^2.0"
}
} - Install kss-node into the local directory of the build server using the command
npm install - Lock down the specific version of kss-node used on the build server by running
npm shrink-wrap --devand adding the "npm-shrinkwrap.json" to version control. - Generate the style guide with
./node_modules/.bin/kss-node --config style-guide-seven.json(where that json file includes the proper command line options.) - Decide on a URL to access the style guide.
User interface changes
Will add a set of static HTML pages to api.drupal.org that shows off the seven style guide.