X-Git-Url: http://git.indexdata.com/?p=mkws-moved-to-github.git;a=blobdiff_plain;f=README;h=98645e522786fad4fa0c89f690fda089484502ef;hp=3144b20785c8655a592f3023684a13c9804a2ac6;hb=93467cfec69ee4bfa6335595bc23e218482f3dbc;hpb=ecfec1648acd77e8364bd1fd22d206bed9df0e9c diff --git a/README b/README index 3144b20..98645e5 100644 --- a/README +++ b/README @@ -1,44 +1,21 @@ -OVERVIEW -======== - The MasterKey Widget Set, or MKWS, provides HTML/JS/CSS widgets that can be dropped into ANY website, irrespective of CMS or lack thereof, to enable MasterKey searching. - -WHAT'S WHAT -=========== - README -- this file +LICENSE -- The GNU LGPL (Lesser General Public Licence) Makefile -- delegates to tools/htdocs/Makefile +src -- source-code that is compiled into the tools area tools -- the tools that make up the Widget Set examples -- examples of applications that use MKWS - +doc -- documentation (in Markdown, compiles to HTML) +test -- regression-testing scripts notes -- internal documents, not for customers +See tools/htdocs/NEWS for the change-log. -Required devel tools -==================== - -On debian, you will need: -$ sudo apt-get install curl git-core pandoc yui-compressor node-js libbsd-resource-perl - -On Debian 7 (wheezy), you do not need git-core, plain git will do, but -you probably have that on a development box already. Unfortunately, node-js -is not available for wheezy. Either you can get it from wheezy-backports, -or you can download the source from http://nodejs.org/download/ and build -it yourself. Looks like you need node and npm, make install puts them -into /usr/local/bin. - -To compile the default templates you'll need to install the stable version -of Handlebars. Currently it's at 1.3.0 and available by npm: - - npm install handlebars@1.3.0 -g - -For apache setup, see tools/apache2/README - -NEWS -========= - -see tools/htdocs/NEWS +For more documentation: +doc/index.markdown -- overview +doc/mkws-manual.markdown -- how to use the widget set +doc/mkws-developer.markdown -- how to develop and customise widgets