Multiple fixes

Author: Marcel Gerber

src/extensions/default/WebPlatformDocs/InlineDocsViewer.html

@@ -10,7 +10,7 @@ <h1>{{propName}}</h1>
         <div class="scroller" tabIndex="0"> <!-- tabIndex needed: otherwise can't be focused on open or via click -->
             <dl>
                 {{#propValues}}
-                <dt>{{value}}</dt>
+                <dt>{{{value}}}</dt>
                 <dd>{{{description}}}</dd>
                 {{/propValues}}
             </dl>

src/extensions/default/WebPlatformDocs/css.json

@@ -11,8 +11,7 @@
         }
     ],
     "devDependencies": {
-        "instaview": "0.6.3",
-        "lodash.unescape": "2.4.1"
+        "instaview": "0.6.3"
     },
     "repository": {
         "type": "git",

src/extensions/default/WebPlatformDocs/update-docs/package.json

@@ -21,16 +21,17 @@
  *
  */
 /*global require*/
+/*jslint regexp:true */
 
 (function () {
     "use strict";
 
     var fs          = require("fs"),
         https       = require("https"),
-        instaview   = require("instaview"),
-        unescape    = require("lodash.unescape");
+        instaview   = require("instaview"); // Wikitext > HTML
 
-    instaview.conf.paths.articles = "https://docs.webplatform.org/wiki/";
+    instaview.conf.paths.articles = "https://docs.webplatform.org/wiki/"; // base URL for every link
+    instaview.conf.locale.image = "__Image__"; // disable <img> tags
 
     var propertiesURL = "https://docs.webplatform.org/w/api.php?action=ask&format=json&query=%20%5B%5BPath%3A%3A~css%2Fproperties%2F*%5D%5D%7C%3FSummary%7Cprettyprint%3Dno%7Climit%3D100000", // #ask:  [[Path::~css/properties/*]]|?Summary|prettyprint=no|limit=100000
         valuesURL = "https://docs.webplatform.org/w/api.php?action=ask&format=json&query=%5B%5BValue%20for%20property%3A%3A~css%2Fproperties%2F*%5D%5D%7C%3FProperty%20value%7C%3FProperty%20value%20description%7C%3FValue%20for%20property%7Cprettyprint%3Dno%7Climit%3D100000"; // #ask: [[Value for property::~css/properties/*]]|?Property value|?Property value description|?Value for property|prettyprint=no|limit=100000
@@ -39,6 +40,15 @@
         outputFile = "../css.json",
         propertiesResponse = "",
         valuesResponse = "";
+    
+    function htmlEscape(str) {
+        return str.replace(/<(\/?)([^>]*)>/g, function (match, slash, inner) {
+            if (["code", "div", "tt"].indexOf(inner) === -1) { // escape all tags except <code>, <div>, <tt>
+                return "&lt;" + slash + inner + "&gt;";
+            }
+            return match;
+        });
+    }
 
     console.log("Getting properties");
     https.get(propertiesURL, function (res) {
@@ -53,7 +63,7 @@
                 var data = propertiesResponse[propertyName];
                 var propertyData = {};
                 if (data.printouts.Summary.length) {
-                    propertyData.SUMMARY = instaview.convert(data.printouts.Summary[0]);
+                    propertyData.SUMMARY = instaview.convert(htmlEscape(data.printouts.Summary[0]));
                     propertyData.URL = data.fullurl;
                     propertyData.VALUES = [];
 
@@ -67,27 +77,24 @@
                 });
 
                 res.on("end", function () {
-                    function parseHTMLEntities(str) {
-                        return str.replace(/&#([0-9]{1,4});/g, function (match, numStr) {
-                            var num = parseInt(numStr, 10);
-                            return String.fromCharCode(num);
-                        });
-                    }
-
                     console.log("Parsing values");
                     valuesResponse = JSON.parse(valuesResponse).query.results;
 
                     Object.keys(valuesResponse).forEach(function (valueIdentifier) {
                         var data = valuesResponse[valueIdentifier].printouts;
                         var forProperty = data["Value for property"].length && data["Value for property"][0].fulltext;
                         var valueData = {};
+                        var description;
                         if (data["Property value"].length && forProperty && result.hasOwnProperty(forProperty)) {
                             valueData.DESCRIPTION = "";
                             if (data["Property value description"].length) {
-                                valueData.DESCRIPTION = instaview.convert(data["Property value description"][0]);
+                                // Remove possible "alt=...;" (image Wikitext)
+                                description = htmlEscape(data["Property value description"][0].replace(/\|alt=([^;]*);/, "|$1"));
+                                valueData.DESCRIPTION = instaview.convert(description);
                             }
-                            valueData.TITLE = parseHTMLEntities(unescape(data["Property value"][0]));
+                            valueData.TITLE = instaview.convert(htmlEscape(data["Property value"][0])).substr(3); // trim <p> tag
 
+                            // FUTURE: Currently, there's no deterministic order for the value listing
                             result[forProperty].VALUES.push(valueData);
                         }
                     });