Merge pull request #19 from facebookexperimental/sidebar-titles

Add optional sidebar_title docs front matter field for sidebar title distinct from document article titles

examples/example-docs/en/doc1.md

@@ -1,6 +1,7 @@
 ---
 id: doc1
 title: Docusaurus
+sidebar_title: Docusaurus Guide
 layout: docs
 category: Docusaurus
 permalink: docs/en/doc1.html

lib/core/nav/SideNav.js

@@ -69,12 +69,19 @@ class SideNav extends React.Component {
     return categoryString;
   }
   getLocalizedString(metadata) {
-    let localizedString = translation[this.props.language]
-      ? translation[this.props.language]["localized-strings"][
-          metadata.localized_id
-        ] || metadata.title
-      : metadata.title;
-
+    let localizedString;
+    const i18n = translation[this.props.language];
+    const sbTitle = metadata.sidebar_title;
+    
+    if (sbTitle) {
+      localizedString = i18n
+        ? i18n["localized-strings"][sbTitle] || sbTitle
+        : sbTitle;
+    } else {
+      localizedString = i18n
+        ? i18n["localized-strings"][metadata.localized_id] || metadata.title
+        : metadata.title;
+    }
     return localizedString;
   }
   getLink(metadata) {

lib/write-translations.js

@@ -47,6 +47,11 @@ function execute() {
 
       translations["localized-strings"][metadata.id] = metadata.title;
       translations["localized-strings"][metadata.category] = metadata.category;
+
+      if (metadata.sidebar_title) {
+        translations["localized-strings"][metadata.sidebar_title] =
+          metadata.sidebar_title;
+      }
     }
   });
   /* look through header links for text to translate */
@@ -89,7 +94,6 @@ function execute() {
       });
     }
   });
-
   writeFileAndCreateFolder(CWD + "/i18n/en.json", JSON.stringify(translations));
 }