langchain-ai · hwchase17 · Apr 12, 2024 · Apr 12, 2024 · Apr 13, 2024 · Apr 13, 2024
diff --git a/docs/.local_build.sh b/docs/.local_build.sh
@@ -19,6 +19,15 @@ poetry run python scripts/copy_templates.py
 wget -q https://raw.githubusercontent.com/langchain-ai/langserve/main/README.md -O docs/langserve.md
 wget -q https://raw.githubusercontent.com/langchain-ai/langgraph/main/README.md -O docs/langgraph.md
 
+# Duplicate changes to 0.2.x version
+cp docs/integrations/llms/index.mdx versioned_docs/version-0.2.x/integrations/llms/
+cp docs/integrations/chat/index.mdx versioned_docs/version-0.2.x/integrations/chat/
+mkdir -p versioned_docs/version-0.2.x/templates
+cp -r docs/templates/* versioned_docs/version-0.2.x/templates/
+cp docs/langserve.md versioned_docs/version-0.2.x/
+cp docs/langgraph.md versioned_docs/version-0.2.x/
+
+poetry run python scripts/resolve_versioned_links_in_markdown.py versioned_docs/version-0.2.x/ /docs/0.2.x/
 
 poetry run quarto render docs
 poetry run python scripts/generate_api_reference_links.py  --docs_dir docs

diff --git a/docs/docs/expression_language/get_started.ipynb b/docs/docs/expression_language/get_started.ipynb
@@ -529,7 +529,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.0"
+   "version": "3.10.1"
   }
  },
  "nbformat": 4,

diff --git a/docs/docs/expression_language/primitives/parallel.ipynb b/docs/docs/expression_language/primitives/parallel.ipynb
@@ -302,7 +302,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.6"
+   "version": "3.10.1"
   }
  },
  "nbformat": 4,

diff --git a/docs/docs/expression_language/primitives/passthrough.ipynb b/docs/docs/expression_language/primitives/passthrough.ipynb
@@ -153,7 +153,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.6"
+   "version": "3.10.1"
   }
  },
  "nbformat": 4,

diff --git a/docs/docs/expression_language/primitives/sequence.ipynb b/docs/docs/expression_language/primitives/sequence.ipynb
@@ -221,7 +221,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -235,7 +235,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.5"
+   "version": "3.10.1"
   }
  },
  "nbformat": 4,

diff --git a/docs/docs/get_started/quickstart.mdx b/docs/docs/get_started/quickstart.mdx
@@ -20,7 +20,7 @@ That's a fair amount to cover! Let's dive in.
 
 This guide (and most of the other guides in the documentation) uses [Jupyter notebooks](https://jupyter.org/) and assumes the reader is as well. Jupyter notebooks are perfect for learning how to work with LLM systems because oftentimes things can go wrong (unexpected output, API down, etc) and going through guides in an interactive environment is a great way to better understand them.
 
-You do not NEED to go through the guide in a Jupyter Notebook, but it is recommended. See [here](https://jupyter.org/install) for instructions on how to install.
+This and other tutorials are perhaps most conveniently run in a Jupyter notebook. See [here](https://jupyter.org/install) for instructions on how to install.
 
 ### Installation
 

diff --git a/docs/docs/modules/model_io/chat/function_calling.ipynb b/docs/docs/modules/model_io/chat/function_calling.ipynb
@@ -685,9 +685,9 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "poetry-venv-2",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
-   "name": "poetry-venv-2"
+   "name": "python3"
   },
   "language_info": {
    "codemirror_mode": {
@@ -699,7 +699,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.1"
+   "version": "3.10.1"
   }
  },
  "nbformat": 4,

diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js
@@ -20,8 +20,8 @@ const config = {
   // For GitHub pages deployment, it is often '/<projectName>/'
   baseUrl: "/",
   trailingSlash: true,
-  onBrokenLinks: "throw",
-  onBrokenMarkdownLinks: "throw",
+  onBrokenLinks: "warn",
+  onBrokenMarkdownLinks: "warn",
 
   themes: ["@docusaurus/theme-mermaid"],
   markdown: {
@@ -81,6 +81,17 @@ const config = {
       /** @type {import('@docusaurus/preset-classic').Options} */
       ({
         docs: {
+          lastVersion: "current",
+          versions: {
+            current: {
+              label: '0.1.x',
+              badge: false,
+            },
+            "0.2.x": {
+              label: "0.2.x",
+              banner: "unreleased",
+            }
+          },
           sidebarPath: require.resolve("./sidebars.js"),
           remarkPlugins: [
             [require("@docusaurus/remark-plugin-npm2yarn"), { sync: true }],
@@ -149,21 +160,18 @@ const config = {
         logo: {src: "img/brand/wordmark.png", srcDark: "img/brand/wordmark-dark.png"},
         items: [
           {
-            to: "/docs/modules",
+            type: "doc",
+            docId: "modules/index",
             label: "Components",
             position: "left",
+            className: "hidden-0\.2\.x",
           },
           {
             type: "docSidebar",
             position: "left",
             sidebarId: "integrations",
             label: "Integrations",
           },
-          {
-            to: "/docs/guides",
-            label: "Guides",
-            position: "left",
-          },
           {
             href: "https://api.python.langchain.com",
             label: "API Reference",
@@ -175,15 +183,18 @@ const config = {
             position: "left",
             items: [
               {
-                to: "/docs/people/",
+                type: "doc",
+                docId: "people",
                 label: "People",
               },
               {
-                to: "/docs/packages",
+                type: "doc",
+                docId: "packages",
                 label: "Versioning",
               },
               {
-                to: "/docs/contributing",
+                type: "doc",
+                docId: "contributing/index",
                 label: "Contributing",
               },
               {
@@ -196,11 +207,13 @@ const config = {
                 href: "https://github.com/langchain-ai/langchain/blob/master/cookbook/README.md"
               },
               {
-                to: "/docs/additional_resources/tutorials",
+                type: "doc",
+                docId: "additional_resources/tutorials",
                 label: "Tutorials"
               },
               {
-                to: "/docs/additional_resources/youtube",
+                type: "doc",
+                docId: "additional_resources/youtube",
                 label: "YouTube"
               },
             ]

diff --git a/docs/package.json b/docs/package.json
@@ -30,6 +30,7 @@
     "@supabase/supabase-js": "^2.39.7",
     "clsx": "^1.2.1",
     "cookie": "^0.6.0",
+    "isomorphic-dompurify": "^2.7.0",
     "json-loader": "^0.5.7",
     "process": "^0.11.10",
     "react": "^17.0.2",
@@ -50,6 +51,7 @@
     "eslint-plugin-jsx-a11y": "^6.6.0",
     "eslint-plugin-react": "^7.30.1",
     "eslint-plugin-react-hooks": "^4.6.0",
+    "marked": "^12.0.1",
     "prettier": "^2.7.1",
     "supabase": "^1.148.6",
     "typedoc": "^0.24.4",

diff --git a/docs/scripts/resolve_versioned_links_in_markdown.py b/docs/scripts/resolve_versioned_links_in_markdown.py
@@ -0,0 +1,23 @@
+import os
+import re
+import sys
+from pathlib import Path
+
+DOCS_DIR = Path(os.path.abspath(__file__)).parents[1]
+
+
+def update_links(doc_path, docs_link):
+    for path in (DOCS_DIR / doc_path).glob("**/*"):
+        if path.is_file() and path.suffix in [".md", ".mdx", ".ipynb"]:
+            with open(path, "r") as f:
+                content = f.read()
+
+            # replace relative links
+            content = re.sub("\]\(\/docs\/(?!0\.2\.x)", f"]({docs_link}", content)
+
+            with open(path, "w") as f:
+                f.write(content)
+
+
+if __name__ == "__main__":
+    update_links(sys.argv[1], sys.argv[2])
diff --git a/docs/src/css/custom.css b/docs/src/css/custom.css
@@ -36,7 +36,7 @@
   --ifm-code-font-size: 95%;
   --ifm-font-family-base: 'Public Sans';
   --ifm-menu-link-padding-horizontal: 0.5rem;
-  --ifm-menu-link-padding-vertical: 0.375rem;
+  --ifm-menu-link-padding-vertical: 0.5rem;
   --doc-sidebar-width: 275px !important;
 }
 
@@ -55,6 +55,10 @@ nav, h1, h2, h3, h4 {
   font-family: 'Manrope';
 }
 
+.docs-version-0\.2\.x .hidden-0\.2\.x {
+  display: none;
+}
+
 .footer__links {
   margin-top: 1rem;
   margin-bottom: 3rem;
@@ -197,6 +201,10 @@ nav, h1, h2, h3, h4 {
   opacity: 0.5;
 }
 
+.markdown {
+  line-height: 2em;
+}
+
 .markdown > h2 {
   margin-top: 2rem;
   border-bottom-color: var(--ifm-color-primary);

diff --git a/docs/src/theme/ChatModelTabs.js b/docs/src/theme/ChatModelTabs.js
@@ -4,21 +4,6 @@ import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 import CodeBlock from "@theme-original/CodeBlock";
 
-function Setup({ apiKeyName, packageName }) {
-  const apiKeyText = `import getpass
-import os
-
-os.environ["${apiKeyName}"] = getpass.getpass()`;
-  return (
-    <>
-      <h5>Install dependencies</h5>
-      <CodeBlock language="bash">{`pip install -qU ${packageName}`}</CodeBlock>
-      <h5>Set environment variables</h5>
-      <CodeBlock language="python">{apiKeyText}</CodeBlock>
-    </>
-  );
-}
-
 /**
  * @typedef {Object} ChatModelTabsProps - Component props.
  * @property {string} [openaiParams] - Parameters for OpenAI chat model. Defaults to `model="gpt-3.5-turbo-0125"`
@@ -146,19 +131,23 @@ export default function ChatModelTabs(props) {
     <Tabs groupId="modelTabs">
       {tabItems
         .filter((tabItem) => !tabItem.shouldHide)
-        .map((tabItem) => (
-          <TabItem
-            value={tabItem.value}
-            label={tabItem.label}
-            default={tabItem.default}
-          >
-            <Setup
-              apiKeyName={tabItem.apiKeyName}
-              packageName={tabItem.packageName}
-            />
-            <CodeBlock language="python">{tabItem.text}</CodeBlock>
-          </TabItem>
-        ))}
+        .map((tabItem) => {
+          const apiKeyText = `import getpass
+import os
+
+os.environ["${tabItem.apiKeyName}"] = getpass.getpass()`;
+          return (
+            <TabItem
+              value={tabItem.value}
+              label={tabItem.label}
+              default={tabItem.default}
+            >
+              <CodeBlock language="bash">{`pip install -qU ${tabItem.packageName}`}</CodeBlock>              
+              <CodeBlock language="python">{apiKeyText + "\n\n" + tabItem.text}</CodeBlock>
+            </TabItem>
+          );
+        })
+      }
     </Tabs>
   );
 }