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

diff --git a/resources/Makefile b/resources/Makefile
index 36b75ae..4de5c2f 100644 (file)
--- 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 (file)
index 0000000..d91bf2a
--- /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 c34ff4f..a1722b5 100644 (file)
--- 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"
        }
+
 }