From bce8f7b8bb48ad7d90c8863885da3a0683bee64e Mon Sep 17 00:00:00 2001 From: S Page Date: Sat, 21 Dec 2013 02:06:21 -0800 Subject: [PATCH] Improvements to KSS CSS documentation generation Avoid npm warnings. Makefile fixes: it's not a bash script, kss is default target, quieter output. Change-Id: Ia7b862b6bef95c7735a42c1b6f70625283e915ab --- resources/Makefile | 15 ++++++--------- resources/README.txt | 4 ++++ resources/package.json | 5 +++++ 3 files changed, 15 insertions(+), 9 deletions(-) create mode 100644 resources/README.txt diff --git a/resources/Makefile b/resources/Makefile index 36b75aefa5..4de5c2fff2 100644 --- a/resources/Makefile +++ b/resources/Makefile @@ -1,12 +1,9 @@ -#!/bin/bash -MW_INSTALL_PATH ?= ../.. +kss: nodecheck +# FIXME: Use more up-to-date Ruby version + @node_modules/.bin/kss-node mediawiki.ui mediawiki.ui/docs -l mediawiki.ui/vector.less -t styleguide-template + @echo Opening the generated style guide... + @command -v xdg-open >/dev/null 2>&1 || { open ${PWD}/mediawiki.ui/docs/index.html; exit 1; } + @xdg-open ${PWD}/mediawiki.ui/docs/index.html nodecheck: @scripts/nodecheck.sh - -kss: nodecheck - # FIXME: Use more up to date Ruby version - kss-node mediawiki.ui mediawiki.ui/docs -l mediawiki.ui/vector.less -t styleguide-template - # Open the resulting style guide (try using xdg-open or open): - command -v xdg-open >/dev/null 2>&1 || { open ${PWD}/mediawiki.ui/docs/index.html; exit 1; } - xdg-open ${PWD}/mediawiki.ui/docs/index.html diff --git a/resources/README.txt b/resources/README.txt new file mode 100644 index 0000000000..d91bf2aa6c --- /dev/null +++ b/resources/README.txt @@ -0,0 +1,4 @@ +The Makefile, package.json, scripts, styleguide-template, and +mediawiki.ui/styleguide.md files and directories in here support the automatic +generation of CSS documentation from the source LESS files using kss for +node.js, https://github.com/kneath/kss diff --git a/resources/package.json b/resources/package.json index c34ff4f8d5..a1722b5542 100644 --- a/resources/package.json +++ b/resources/package.json @@ -4,5 +4,10 @@ "version": "0.0.1", "dependencies": { "kss": ">=0.3.6" + }, + "repository" : { + "type" : "git", + "url" : "https://gerrit.wikimedia.org/r/p/mediawiki/core.git" } + } -- 2.20.1