Json script

README.md

@@ -1,4 +1,4 @@
-# coga.personalisation
+## coga.personalisation
 This is a project to help personlisation for any use - including people with learning and memory issues. It is described more at
 https://www.w3.org/WAI/PF/cognitive-a11y-tf/wiki/Easy_Personalization
 It is made of 3 parts.
@@ -7,3 +7,107 @@ It is made of 3 parts.
 note we are still working on it. more items will come/change
 3. An HTML page that uses some of the new aria syntax
 4. Scripts that a web auther can use or include that read the user settings in the JSON files and adapt the page for  the user needs 
+
+##JSON-Skin Documentation
+
+* Proposed default settings for @aria-importance in JSON script. 
+* compose(default importance = "critical")
+
+All the key-value in the JSON file is followed the https://rawgit.com/w3c/coga/master/issue-papers/links-buttons.html
+
+###Guideline for creating the JSON profile:
+
+```json
+{
+        "@aria-function"('@role','@tag'): [{
+                "offName": "function",
+                "type": ["proposed for the functions target widge type."],   
+                "name": "function name",
+                "inherits": "boolean",
+		"descendents":[
+			{ 
+			"descendentTag":"string, tag",
+			"settings":
+				{
+				  "css": [
+					  {
+						  "propertyName":"propertyName",
+						  "value":"value"
+
+					  }
+					  ]
+				 }
+				 }
+			 ], 
+                "settings": { 
+                    "shortcut": "Shortcut setting for this function",
+                    "longdesc": "description for settings",
+                    "tooltip": "tooltip for display",
+                    "text": "text for display",
+                    "Symbol": {
+                    "url": "url symbol",
+                    "creator": {
+                        "name": "creator name",
+                        "url": "creator url"
+
+                    },
+                    "license": {
+                        "name": "licenses",
+                        "url": "licenses url"
+                    },
+
+			"settings":{
+					"width":"num of px",
+					"height":"num of px",
+					"margin":"value",
+					"padding":"value"
+					}
+                    }
+
+                    "@aria-hidden": "boolean",
+                    "css": "css override setting"
+                }
+            }],
+
+
+
+
+        "@aria-importance": 
+        {
+            "critical ('critical','high','med','low')": { 
+                    "settings": {
+                        "@aria-hidden": "boolean",
+                        "css": "css override setting"
+                    }
+                }
+        }
+
+}
+
+```
+
+##Demo Website ([Personalised Clothes - Contact Us](https://rawgit.com/ayelet-seeman/coga.personalisation/ExampleWebPage/contactUs.html))
+
+###button functions:
+- send email
+- reset contact us form
+- send contact us form
+
+###links functions:
+- home
+- contact us
+- site map
+- product
+- services
+
+###form control
+- name
+- phone
+- email
+- subject
+- message
+
+###Example Profile
+- Example 1 [JSON-profile](https://github.com/ayelet-seeman/coga.personalisation/blob/JSON-Script/profile_exmaple_1.json)
+- Example 2 [JSON-profile](https://github.com/ayelet-seeman/coga.personalisation/blob/JSON-Script/profile_exmaple_2.json)
+

json_profile_1.json

@@ -0,0 +1,215 @@
+{
+    "description": {
+        "use case": "write and send an email message.",
+        "disability": "Mild Intellectual Disability",
+        "age group": "older than millennials",
+        "locationzation": "UK&US",
+        "language": "English"
+
+    },
+
+    "coga.profile": {
+        "coga:name": "USMCI",
+        "coga:desc": "proof of concept for Mild Interllectual Disability to write and send an email message",
+        "coga:local": ["US", "UK"],
+        "@aria-function": [{
+            "function": "compose",
+            "type": ["button"],
+            "name": "compose button",
+            "inherits": "false",
+            "settings": {
+                "shortcut": "SHIFT + C",
+                "longdesc": "this button creates a new email message.",
+                "tooltip": "create text",
+                "text": "create text now",
+                "Symbol": [{
+                    "url": "https://d30y9cdsu7xlg0.cloudfront.net/png/139286-200.png",
+                    "creator": {
+                        "name": "Daniel Boros",
+                        "url": "https://thenounproject.com/tonetype/"
+                    },
+                    "license": [{
+                        "name": "Creative Commons",
+                        "url": "http://creativecommons.org/licenses/by/3.0/us/"
+                    }]
+                }],
+                "@aria-hidden": "false",
+                "css": "visibility:visible;size:2em;border: 5px solid"
+            }
+        }, {
+            "function": "delete",
+            "type": ["button"],
+            "name": "delete button",
+            "inherits": "false",
+            "settings": {
+                "shortcut": "SHIFT + D",
+                "longdesc": "this button delete the emial message.",
+                "tooltip": "delete text",
+                "text": "delete",
+                "Symbol": [{
+                    "url": "https://d30y9cdsu7xlg0.cloudfront.net/png/101601-200.png",
+                    "creator": {
+                        "name": "Muneer A.Safiah",
+                        "url": "https://thenounproject.com/mabusafiah/"
+                    },
+                    "license": [{
+                        "name": "Creative Commons",
+                        "url": "http://creativecommons.org/licenses/by/3.0/us/"
+                    }]
+                }],
+                "@aria-hidden": "false",
+                "css": "visibility:visible;size:2em;border: 5px solid"
+            }
+        }, {
+            "function": "next",
+            "type": ["button"],
+            "name": "next button",
+            "inherits": "false",
+            "settings": {
+                "shortcut": "SHIFT + N",
+                "longdesc": "this button lets you to go forward",
+                "tooltip": "go forward",
+                "text": "next",
+                "Symbol": [{
+                    "url": "https://d30y9cdsu7xlg0.cloudfront.net/png/101601-200.png",
+                    "creator": {
+                        "name": "Creative Stall",
+                        "url": "https://thenounproject.com/creativestall/"
+                    },
+                    "license": [{
+                        "name": "Creative Commons",
+                        "url": "http://creativecommons.org/licenses/by/3.0/us/"
+                    }]
+                }],
+                "@aria-hidden": "false",
+                "css": "visibility:visible;size:2em;border: 5px solid"
+            }
+        }, {
+            "function": "previous",
+            "type": ["button"],
+            "name": "previous button",
+            "inherits": "false",
+            "settings": {
+                "shortcut": "SHIFT + P",
+                "longdesc": "this button lead you to go back.",
+                "tooltip": "back back",
+                "text": "previous",
+                "Symbol": [{
+                    "url": "https://d30y9cdsu7xlg0.cloudfront.net/png/174879-200.png",
+                    "creator": {
+                        "name": "Creative Stall",
+                        "url": "https://thenounproject.com/creativestall/"
+                    },
+                    "license": [{
+                        "name": "Creative Commons",
+                        "url": "http://creativecommons.org/licenses/by/3.0/us/"
+                    }]
+                }],
+                "@aria-hidden": "false",
+                "css": "visibility:visible;size:2em;border: 5px solid"
+            }
+        }, {
+            "function": "submit",
+            "type": ["button"],
+            "name": "submit button",
+            "inherits": "false",
+            "settings": {
+                "shortcut": "SHIFT + S",
+                "longdesc": "this button send text.",
+                "tooltip": "send text",
+                "text": "submit",
+                "Symbol": [{
+                    "url": "https://d30y9cdsu7xlg0.cloudfront.net/png/102500-200.png",
+                    "creator": {
+                        "name": "Rodolfo Alvarez",
+                        "url": "https://thenounproject.com/dg.rodolfoalvarez/"
+                    },
+                    "license": [{
+                        "name": "Creative Commons",
+                        "url": "http://creativecommons.org/licenses/by/3.0/us/"
+                    }]
+                }],
+                "@aria-hidden": "false",
+                "css": "visibility:visible;size:2em;border: 5px solid"
+            }
+        }, {
+            "function": "undo",
+            "type": ["button"],
+            "name": "undo button",
+            "inherits": "false",
+            "settings": {
+                "shortcut": "SHIFT + U",
+                "longdesc": "this button undo your email writing.",
+                "tooltip": "Back up",
+                "text": "undo",
+                "Symbol": [{
+                    "url": "https://d30y9cdsu7xlg0.cloudfront.net/png/14157-200.png",
+                    "creator": {
+                        "name": "Sergey Furtaev",
+                        "url": "https://thenounproject.com/furtaev/"
+                    },
+                    "license": [{
+                        "name": "Creative Commons",
+                        "url": "http://creativecommons.org/licenses/by/3.0/us/"
+                    }]
+                }],
+                "@aria-hidden": "false",
+                "css": "visibility:visible;size:2em;border: 5px solid"
+            }
+        }, {
+            "function": "cancel",
+            "type": ["button"],
+            "name": "cancel button",
+            "inherits": "false",
+            "settings": {
+                "shortcut": "SHIFT + C",
+                "longdesc": "this button allows you to cancel the email.",
+                "tooltip": "Stop",
+                "text": "cancel now",
+                "Symbol": [{
+                    "url": "https://d30y9cdsu7xlg0.cloudfront.net/png/15471-200.png",
+                    "creator": {
+                        "name": "Herbert Spencer",
+                        "url": "https://thenounproject.com/hspencer"
+                    },
+                    "license": [{
+                        "name": "Creative Commons",
+                        "url": "http://creativecommons.org/licenses/by/3.0/us/"
+                    }]
+                }],
+                "@aria-hidden": "false",
+                "css": "visibility:visible;size:2em;border: 5px solid"
+            }
+        }]
+    },
+
+    "@aria-importance": [{
+        "critical": {
+            "settings": [{
+                "@aria-hidden": "false",
+                "css": "visibility:visible;"
+            }]
+        }
+    }, {
+        "high": {
+            "settings": [{
+                "@aria-hidden": "false",
+                "css": "visibility:visible;"
+            }]
+        }
+    }, {
+        "med": {
+            "settings": [{
+                "@aria-hidden": "true",
+                "css": "visibility:none;"
+            }]
+        }
+    }, {
+        "low": {
+            "settings": [{
+                "@aria-hidden": "true",
+                "css": "visibility:hide;"
+            }]
+        }
+    }]
+}