Famous · ocombe · Aug 5, 2014
diff --git a/dist/famous-angular.js b/dist/famous-angular.js
@@ -286,8 +286,8 @@ require(requirements, function(/*args*/) {
  *
  * The core Angular animation API is fundamentally CSS class-based. Because only Famo.us Surfaces
  * support CSS classes, core directives such as `ngClass`, `ngShow`, `ngIf`, and others should be applied
- * only with directives representing Surfaces (such as {@link api/directive/faSurface faSurface} and
- * {@link api/directive/faImageSurface faImageSurface}).
+ * only with directives representing Surfaces (such as {@link faSurface faSurface} and
+ * {@link faImageSurface faImageSurface}).
  *
  * The {@link https://docs.angularjs.org/api/ngAnimate ngAnimate} module's documentation lists the set of
  * core directives supporting $animate events. Please note that the `ngAnimate` module is *not* required
@@ -846,7 +846,7 @@ angular.module('famous.angular')
  * @module famous.angular
  * @restrict EA
  * @description
- * This directive is deprecated. Prefer using the $timeline service. This directive is used to animate an element in conjunction with an {@link api/directive/animate animate} directive
+ * This directive is deprecated. Prefer using the $timeline service. This directive is used to animate an element in conjunction with an {@link animate animate} directive
  * @deprecated true
  * @usage
  * ```html
@@ -1167,7 +1167,7 @@ angular.module('famous.angular')
  * @restrict E
  * @deprecated true
  * @description
- * This directive is deprecated. Prefer using the $timeline service. This element is used to specify the animation of an element in a {@link api/directive/faAnimation faAnimation} directive
+ * This directive is deprecated. Prefer using the $timeline service. This element is used to specify the animation of an element in a {@link faAnimation faAnimation} directive
  *
  * @usage
  * ```html
@@ -1423,7 +1423,7 @@ angular.module('famous.angular')
  * it creates a Famous context and then adds child elements
  * to that context as they get compiled. Inside of this directive,
  * normal HTML content will not get rendered to the screen unless
- * it is inside of a {@link api/directive/faSurface fa-surface} directive.
+ * it is inside of a {@link faSurface fa-surface} directive.
  *
  * @usage
  * ```html
@@ -2342,8 +2342,8 @@ angular.module('famous.angular')
  * @restrict A
  * @description
  * This directive is used to specify the rendering order of elements
- * inside of a ViewSequence-based component, such as @link api/directive/faScrollView faScrollView}
- * or @link api/directive/faGridLayout faGridLayout}. As a special case, when elements are added to
+ * inside of a ViewSequence-based component, such as {@link faScrollView faScrollView}
+ * or {@link faGridLayout faGridLayout}. As a special case, when elements are added to
  * these controls using ng-repeat, they are automatically assigned the
  * $index property exposed by ng-repeat. When adding elements manually
  * (e.g. to a faScrollView but not using ng-repeat) or in a case where custom

diff --git a/docs-generation/inline-tag-defs/link.js b/docs-generation/inline-tag-defs/link.js
@@ -2,25 +2,31 @@ var INLINE_LINK = /(\S+)(?:\s+(.+))?/;
 var log = require('winston');
 
 module.exports = {
- name: 'link',
- description: 'Process inline link tags (of the form {@link some/uri Some Title}), replacing them with HTML anchors',
- handlerFactory: function(partialNames, config) {
+ name: 'link',
+ description: 'Process inline link tags (of the form {@link some/uri Some Title}), replacing them with HTML anchors',
+ handlerFactory: function(partialNames, config) {
 
- return function handleLinkTags(doc, tagName, tagDescription) {
- var versionData = config.get('versionData');
+ return function handleLinkTags(doc, tagName, tagDescription) {
+ var versionData = config.get('versionData');
 
- // Parse out the uri and title
- return tagDescription.replace(INLINE_LINK, function(match, uri, title) {
+ // Parse out the uri and title
+ return tagDescription.replace(INLINE_LINK, function(match, uri, title) {
 
- var linkInfo = partialNames.getLink(uri, title, doc);
+ var linkInfo = partialNames.getLink(uri, title, doc);
 
- if(!linkInfo.valid) {
- log.warn(linkInfo.error, 'in', doc.relativePath + '#' + doc.name);
- linkInfo.title = 'TODO:' + linkInfo.title;
- }
+ if(!linkInfo.valid) {
+ log.warn(linkInfo.error, 'in', doc.relativePath + '#' + doc.name);
+ linkInfo.title = 'TODO:' + linkInfo.title;
+ }
+ if(linkInfo.type === 'doc') {
+ var len = doc.path.split('/').length;
+ for(var i = 1; i < len; i++) {
+ linkInfo.url = '../' + linkInfo.url;
+ }
+ }
 
- return '<a href="' + linkInfo.url + '">' + linkInfo.title + '</a>';
- });
- };
- }
+ return '<a href="' + linkInfo.url + '">' + linkInfo.title + '</a>';
+ });
+ };
+ }
 };
diff --git a/docs/index.md b/docs/index.md
@@ -0,0 +1,15 @@
+---
+layout: "docs_api"
+version: ""
+versionHref: "docs/"
+path: "api/"
+title: Javascript
+header_sub_title: Build amazing AngularJS apps with the power of Famo.us
+searchable: false
+---
+
+# Famo.us/Angular
+
+Famo.us/Angular provides a set of directives and services to integrate Famo.us into your AngularJS app, and to build Famo.us apps using Angular tools.
+
+Explore the API docs for detailed information.
diff --git a/docs/unstable/directive/animate/index.md b/docs/unstable/directive/animate/index.md
@@ -34,7 +34,7 @@ docType: "directive"
 
 
 
-This directive is deprecated. Prefer using the $timeline service. This element is used to specify the animation of an element in a <a href="api/directive/faAnimation">faAnimation</a> directive
+This directive is deprecated. Prefer using the $timeline service. This element is used to specify the animation of an element in a <a href="../../../api/directive/faAnimation/">faAnimation</a> directive
 
 
 

diff --git a/docs/unstable/directive/faAnimation/index.md b/docs/unstable/directive/faAnimation/index.md
@@ -34,7 +34,7 @@ docType: "directive"
 
 
 
-This directive is deprecated. Prefer using the $timeline service. This directive is used to animate an element in conjunction with an <a href="api/directive/animate">animate</a> directive
+This directive is deprecated. Prefer using the $timeline service. This directive is used to animate an element in conjunction with an <a href="../../../api/directive/animate/">animate</a> directive
 
 
 

diff --git a/docs/unstable/directive/faApp/index.md b/docs/unstable/directive/faApp/index.md
@@ -35,7 +35,7 @@ This directive is the container and entry point to Famo.us/Angular. Behind the
 it creates a Famous context and then adds child elements
 to that context as they get compiled. Inside of this directive,
 normal HTML content will not get rendered to the screen unless
-it is inside of a <a href="api/directive/faSurface">fa-surface</a> directive.
+it is inside of a <a href="../../../api/directive/faSurface/">fa-surface</a> directive.
 
 
 

diff --git a/docs/unstable/directive/faIndex/index.md b/docs/unstable/directive/faIndex/index.md
@@ -32,8 +32,8 @@ docType: "directive"
 
 
 This directive is used to specify the rendering order of elements
-inside of a ViewSequence-based component, such as @link api/directive/faScrollView faScrollView}
-or @link api/directive/faGridLayout faGridLayout}. As a special case, when elements are added to
+inside of a ViewSequence-based component, such as <a href="../../../api/directive/faScrollView/">faScrollView</a>
+or <a href="../../../api/directive/faGridLayout/">faGridLayout</a>. As a special case, when elements are added to
 these controls using ng-repeat, they are automatically assigned the
 $index property exposed by ng-repeat. When adding elements manually
 (e.g. to a faScrollView but not using ng-repeat) or in a case where custom

diff --git a/docs/unstable/provider/famousProvider/index.md b/docs/unstable/provider/famousProvider/index.md
diff --git a/docs/unstable/service/$animate/index.md b/docs/unstable/service/$animate/index.md
@@ -47,8 +47,8 @@ To inform Famo.us/Angular how to halt any in-progress animation, use the `fa-ani
 
 The core Angular animation API is fundamentally CSS class-based. Because only Famo.us Surfaces
 support CSS classes, core directives such as `ngClass`, `ngShow`, `ngIf`, and others should be applied
-only with directives representing Surfaces (such as <a href="api/directive/faSurface">faSurface</a> and
-<a href="api/directive/faImageSurface">faImageSurface</a>).
+only with directives representing Surfaces (such as <a href="../../../api/directive/faSurface/">faSurface</a> and
+<a href="../../../api/directive/faImageSurface/">faImageSurface</a>).
 
 The <a href="https://docs.angularjs.org/api/ngAnimate">ngAnimate</a> module's documentation lists the set of
 core directives supporting $animate events. Please note that the `ngAnimate` module is *not* required