chore(website): Fix parsing of summaries in function list

Still not a great solution.  See "locator" in #/api?view=ElementFinder

fixes angular#2486

Author: sjelin

website/js/api-controller.js

@@ -153,8 +153,25 @@
 
       // Add short description.
       if (item.description) {
-        item.shortDescription =
-            item.description.substring(0., item.description.indexOf('.') + 1);
+        // Find the correct portion of the description
+        
+        // The following parsing is OK most of the time
+        var sentenceEnd = item.description.indexOf('.') + 1 || Infinity;
+        var paragraphEnd = item.description.indexOf('</p>') + 4;
+        if (paragraphEnd == 3) {
+          paragraphEnd = Infinity
+        }
+        var shortDescription = item.description.substring(0, Math.min(
+            item.description.length, sentenceEnd, paragraphEnd)).trim();
+
+        // Remove <p> tags
+        if (shortDescription.substr(0,3) == '<p>') {
+          shortDescription = shortDescription.substr(3);
+          if (shortDescription.substr(-4) == '</p>') {
+            shortDescription = shortDescription.substr(0, shortDescription.length - 4);
+          }
+        }
+        item.shortDescription = shortDescription;
       }
     });
 
@@ -201,7 +218,6 @@
 
     var addItemToList = function(item, depth) {
       if (item.inList) {
-        console.log(item.name);
         return;
       }
       item.treeClasses = 'depth-' + depth;
@@ -217,7 +233,6 @@
         });
       }
       if (item.extends) {
-        console.log(item.base.name);
         var parent = self.itemsByName[item.base.name];
         if (parent != null) {
           addItemToList(parent, depth + 1);

website/js/directives.js

@@ -56,6 +56,11 @@
       scope: {
         list: '=ptorFunctionList'
       },
+      controller: function($scope, $sce) {
+        $scope.trust = function(html) {
+          return $sce.trustAsHtml(html);
+        };
+      },
       templateUrl: 'partials/ptor-function-list.html'
     };
   });

website/partials/ptor-function-list.html

@@ -14,7 +14,7 @@
             ng-bind="item.displayName">
         </a>
       </td>
-      <td ng-bind="item.shortDescription"></td>
+      <td ng-bind-html="trust(item.shortDescription)"></td>
     </tr>
     </tbody>
   </table>