You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@senssoft.apache.org by le...@apache.org on 2018/01/26 22:59:22 UTC
[1/3] incubator-senssoft-useralejs git commit: SENSSOFT-250 Create
README for UserALE.js examples directory
Repository: incubator-senssoft-useralejs
Updated Branches:
refs/heads/master 7c5b2be32 -> f2c421900
SENSSOFT-250 Create README for UserALE.js examples directory
Project: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/commit/fb3d2f56
Tree: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/tree/fb3d2f56
Diff: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/diff/fb3d2f56
Branch: refs/heads/master
Commit: fb3d2f568bb4db467febf17f987a84be6a1c6197
Parents: d68bb04
Author: Lewis John McGibbney <le...@gmail.com>
Authored: Fri Sep 1 10:53:14 2017 -0700
Committer: Lewis John McGibbney <le...@gmail.com>
Committed: Fri Sep 1 10:53:14 2017 -0700
----------------------------------------------------------------------
README.md | 24 ++++++++++++++---
example/README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++
example/index.html | 5 ++--
example/server.js | 2 +-
4 files changed, 92 insertions(+), 7 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/fb3d2f56/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 56f109b..59b69e0 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,28 @@
-# UserALE.js
+# Apache SensSoft UserALE.js (Incubating)
[![Build Status](https://builds.apache.org/job/useralejs-ci/badge/icon?style=plastic)](https://builds.apache.org/job/useralejs-ci?)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)
-The official JavaScript client for UserAle.
+The official JavaScript client for [Apache SensSoft UserALE](https://github.com/apache/incubator-senssoft-userale).
Additional documentation can be found at http://senssoft.incubator.apache.org/userale/
+## Prerequsites
+
+```
+npm install gulp
+npm install del
+npm install gulp-eslint
+npm install rollup
+npm install rollup-plugin-json
+npm install gulp-uglify
+npm install gulp-rename
+npm install gulp-mocha
+npm install babel-register
+npm install express
+npm install body-parser
+```
+
## Build
To build UserALE.js:
@@ -54,8 +70,8 @@ Our top priority is to improve the testing system and to complete test coverage.
## Contributing
-Contributions are welcome! Simply submit an issue report for problems you encounter or a pull request for your feature or bug fix. The core team will review it and work with you to incorporate it into UserALE.js.
+Contributions are welcome! Simply [submit an issue report](https://issues.apache.org/jira/browse/senssoft) for problems you encounter or a pull request for your feature or bug fix. The core team will review it and work with you to incorporate it into UserALE.js.
## License
-Copyright © 2017 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Software as a Sensor is a trademark of the Charles Stark Draper Laboratory, Inc.
\ No newline at end of file
+Copyright © 2017 The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Software as a Sensor is a trademark of the Charles Stark Draper Laboratory, Inc.
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/fb3d2f56/example/README.md
----------------------------------------------------------------------
diff --git a/example/README.md b/example/README.md
new file mode 100644
index 0000000..fcc9b81
--- /dev/null
+++ b/example/README.md
@@ -0,0 +1,68 @@
+# UserALE.js Example
+
+This directory provides
+ * example usage for UserALE.js within a simple HTML Webpage,
+ * how users can expect to log UserALE events, and
+ * what log events looks like within a simple UserALE logging server.
+
+## Prerequisites
+
+Please see the [Prerequsites](https://github.com/apache/incubator-senssoft-useralejs#prerequsites)
+
+## Running the Logging Server
+
+Assuming you have [node.js](https://nodejs.org/) installed, simply run
+
+```
+node server.js
+```
+
+## Running the Example
+
+Simply open index.html in your browser... you will see a very simply HTML Webpage with a button.
+
+When you click the button, the events will be logged to the server (in memory), logs looks similar to the following
+
+```
+
+[ { target: 'body',
+ path: [ 'body', 'html' ],
+ clientTime: 1504287557492,
+ location: { x: 0, y: 0 },
+ type: 'keydown',
+ userAction: true,
+ details: null,
+ userId: 'example-user',
+ toolVersion: '1.0.0',
+ toolName: 'Apache UserALE.js Example',
+ useraleVersion: '1.0.0' },
+ { target: '#document',
+ path: [ '#document' ],
+ clientTime: 1504287558304,
+ location: { x: 0, y: 0 },
+ type: 'blur',
+ userAction: true,
+ details: { window: true },
+ userId: 'example-user',
+ toolVersion: '1.0.0',
+ toolName: 'Apache UserALE.js Example',
+ useraleVersion: '1.0.0' },
+ { target: '#document',
+ path: [ '#document' ],
+ clientTime: 1504287558304,
+ location: { x: 0, y: 0 },
+ type: 'blur',
+ userAction: true,
+ details: null,
+ userId: 'example-user',
+ toolVersion: '1.0.0',
+ toolName: 'Apache UserALE.js Example',
+ useraleVersion: '1.0.0' },
+ ...
+]
+
+```
+
+## Contributing
+
+Contributions are welcome! Simply [submit an issue report](https://issues.apache.org/jira/browse/senssoft) for problems you encounter or a pull request for your feature or bug fix. The core team will review it and work with you to incorporate it into UserALE.js.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/fb3d2f56/example/index.html
----------------------------------------------------------------------
diff --git a/example/index.html b/example/index.html
index d7cd66a..d293675 100644
--- a/example/index.html
+++ b/example/index.html
@@ -18,10 +18,11 @@ limitations under the License.
<head>
<title>UserAleJS - Example Page</title>
<script
- src="build/userale-0.2.1.min.js"
+ src="../build/userale-1.0.0.min.js"
data-url="http://localhost:8000/"
data-user="example-user"
data-version="1.0.0"
+ data-tool="Apache UserALE.js Example"
></script>
</head>
<body>
@@ -29,4 +30,4 @@ limitations under the License.
<button id="test_button">Click me!</button>
</div>
</body>
-</html>
\ No newline at end of file
+</html>
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/fb3d2f56/example/server.js
----------------------------------------------------------------------
diff --git a/example/server.js b/example/server.js
index 354219e..8362123 100644
--- a/example/server.js
+++ b/example/server.js
@@ -45,7 +45,7 @@ app.use(function (req, res, next) {
// intercept OPTIONS method
if ('OPTIONS' == req.method) {
- res.send(200);
+ res.sendStatus(200);
}
else {
next();
[2/3] incubator-senssoft-useralejs git commit: SENSSOFT-250 Create
README for UserALE.js examples directory
Posted by le...@apache.org.
SENSSOFT-250 Create README for UserALE.js examples directory
Project: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/commit/937863f8
Tree: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/tree/937863f8
Diff: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/diff/937863f8
Branch: refs/heads/master
Commit: 937863f896279e689cecca29f3f71ef604af5c44
Parents: fb3d2f5 7c5b2be
Author: Lewis John McGibbney <le...@gmail.com>
Authored: Fri Jan 26 11:01:28 2018 -0800
Committer: Lewis John McGibbney <le...@gmail.com>
Committed: Fri Jan 26 11:01:28 2018 -0800
----------------------------------------------------------------------
KEYS | 76 +++++++++
LICENSE | 402 +++++++++++++++++++++++------------------------
NOTICE | 2 +-
README.md | 1 +
doap-userale.js.rdf | 2 +-
example/README.md | 2 +-
example/index.html | 2 +-
example/server.js | 2 +-
8 files changed, 283 insertions(+), 206 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/937863f8/README.md
----------------------------------------------------------------------
diff --cc README.md
index 59b69e0,b94821e..645d791
--- a/README.md
+++ b/README.md
@@@ -7,22 -7,6 +7,23 @@@ The official JavaScript client for [Apa
Additional documentation can be found at http://senssoft.incubator.apache.org/userale/
+## Prerequsites
+
+```
+npm install gulp
+npm install del
+npm install gulp-eslint
+npm install rollup
+npm install rollup-plugin-json
+npm install gulp-uglify
+npm install gulp-rename
+npm install gulp-mocha
+npm install babel-register
+npm install express
+npm install body-parser
++npm install nodemon
+```
+
## Build
To build UserALE.js:
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/937863f8/example/README.md
----------------------------------------------------------------------
diff --cc example/README.md
index fcc9b81,0000000..a0fb452
mode 100644,000000..100644
--- a/example/README.md
+++ b/example/README.md
@@@ -1,68 -1,0 +1,68 @@@
+# UserALE.js Example
+
+This directory provides
+ * example usage for UserALE.js within a simple HTML Webpage,
+ * how users can expect to log UserALE events, and
+ * what log events looks like within a simple UserALE logging server.
+
+## Prerequisites
+
+Please see the [Prerequsites](https://github.com/apache/incubator-senssoft-useralejs#prerequsites)
+
+## Running the Logging Server
+
+Assuming you have [node.js](https://nodejs.org/) installed, simply run
+
+```
- node server.js
++npm run example:watch
+```
+
+## Running the Example
+
+Simply open index.html in your browser... you will see a very simply HTML Webpage with a button.
+
+When you click the button, the events will be logged to the server (in memory), logs looks similar to the following
+
+```
+
+[ { target: 'body',
+ path: [ 'body', 'html' ],
+ clientTime: 1504287557492,
+ location: { x: 0, y: 0 },
+ type: 'keydown',
+ userAction: true,
+ details: null,
+ userId: 'example-user',
+ toolVersion: '1.0.0',
+ toolName: 'Apache UserALE.js Example',
+ useraleVersion: '1.0.0' },
+ { target: '#document',
+ path: [ '#document' ],
+ clientTime: 1504287558304,
+ location: { x: 0, y: 0 },
+ type: 'blur',
+ userAction: true,
+ details: { window: true },
+ userId: 'example-user',
+ toolVersion: '1.0.0',
+ toolName: 'Apache UserALE.js Example',
+ useraleVersion: '1.0.0' },
+ { target: '#document',
+ path: [ '#document' ],
+ clientTime: 1504287558304,
+ location: { x: 0, y: 0 },
+ type: 'blur',
+ userAction: true,
+ details: null,
+ userId: 'example-user',
+ toolVersion: '1.0.0',
+ toolName: 'Apache UserALE.js Example',
+ useraleVersion: '1.0.0' },
+ ...
+]
+
+```
+
+## Contributing
+
+Contributions are welcome! Simply [submit an issue report](https://issues.apache.org/jira/browse/senssoft) for problems you encounter or a pull request for your feature or bug fix. The core team will review it and work with you to incorporate it into UserALE.js.
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/937863f8/example/index.html
----------------------------------------------------------------------
diff --cc example/index.html
index d293675,d7cd66a..4849b9f
--- a/example/index.html
+++ b/example/index.html
@@@ -18,7 -18,7 +18,7 @@@ limitations under the License
<head>
<title>UserAleJS - Example Page</title>
<script
- src="../build/userale-1.0.0.min.js"
- src="build/userale-0.2.1.min.js"
++ src="build/userale-1.0.0.min.js"
data-url="http://localhost:8000/"
data-user="example-user"
data-version="1.0.0"
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/937863f8/example/server.js
----------------------------------------------------------------------
diff --cc example/server.js
index 8362123,354219e..5d5cc63
--- a/example/server.js
+++ b/example/server.js
@@@ -58,7 -58,7 +58,7 @@@ app.set('view engine', 'jade')
app.get('/', function (req, res) {
-- res.sendfile('index.html', { root: __dirname });
++ res.sendFile('index.html', { root: __dirname });
});
app.post('/', function (req, res) {
[3/3] incubator-senssoft-useralejs git commit: SENSSOFT-250 Create
README for UserALE.js examples directory
Posted by le...@apache.org.
SENSSOFT-250 Create README for UserALE.js examples directory
Project: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/commit/f2c42190
Tree: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/tree/f2c42190
Diff: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/diff/f2c42190
Branch: refs/heads/master
Commit: f2c4219009b9e8045a120827690d9ee80ae6d80c
Parents: 937863f
Author: Lewis John McGibbney <le...@gmail.com>
Authored: Fri Jan 26 11:51:51 2018 -0800
Committer: Lewis John McGibbney <le...@gmail.com>
Committed: Fri Jan 26 11:51:51 2018 -0800
----------------------------------------------------------------------
README.md | 14 ++------------
1 file changed, 2 insertions(+), 12 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-senssoft-useralejs/blob/f2c42190/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 645d791..726e727 100644
--- a/README.md
+++ b/README.md
@@ -9,19 +9,9 @@ Additional documentation can be found at http://senssoft.incubator.apache.org/us
## Prerequsites
+Several dependencies are required, simply execute the following and you are good to go.
```
-npm install gulp
-npm install del
-npm install gulp-eslint
-npm install rollup
-npm install rollup-plugin-json
-npm install gulp-uglify
-npm install gulp-rename
-npm install gulp-mocha
-npm install babel-register
-npm install express
-npm install body-parser
-npm install nodemon
+npm install
```
## Build