WIP: Separate documents

Signed-off-by: Mike McKiernan <[email protected]>

Author: mikemckiernan

Makefile

@@ -21,8 +21,16 @@ test_coverage:
 test_profile:
 	poetry run pytest -vv tests/ --profile-svg
 
-docs:
-	poetry run sphinx-build -b html docs _build/docs
+docs: docs-guardrails docs-community docs-colang
+
+docs-guardrails:
+	poetry run sphinx-build -b html docs _build/docs/guardrails
+
+docs-community:
+	poetry run sphinx-build -b html docs/community _build/docs/community
+
+docs-colang:
+	poetry run sphinx-build -b html docs/colang _build/docs/colang
 
 pre_commit:
 	pre-commit install

docs/getting-started/1-hello-world/README.md renamed to docs/colang/1-hello-world/README.md

@@ -0,0 +1,85 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copyright (c) 2024, NVIDIA CORPORATION.
+
+from datetime import date
+from pathlib import Path
+
+from toml import load
+
+project = "NeMo Guardrails and Colang"
+this_year = date.today().year
+copyright = f"2023-{this_year}, NVIDIA Corporation"
+author = "NVIDIA Corporation"
+release = "0.0.0"
+
+with open(
+    Path(__file__).parent.parent.parent / "pyproject.toml", encoding="utf-8"
+) as f:
+    t = load(f)
+    release = t.get("tool").get("poetry").get("version")
+
+extensions = [
+    "myst_parser",
+    "sphinx.ext.intersphinx",
+    "sphinx_copybutton",
+    "sphinx_reredirects",
+]
+
+copybutton_exclude = ".linenos, .gp, .go"
+
+myst_linkify_fuzzy_links = False
+myst_heading_anchors = 3
+myst_enable_extensions = [
+    "deflist",
+    "dollarmath",
+    "fieldlist",
+    "substitution",
+]
+
+myst_substitutions = {
+    "version": release,
+}
+
+exclude_patterns = [
+    "_build/**",
+]
+
+# intersphinx_mapping = {
+#     'gpu-op': ('https://docs.nvidia.com/datacenter/cloud-native/gpu-operator/latest', None),
+# }
+
+# suppress_warnings = ["etoc.toctree", "myst.header", "misc.highlighting_failure"]
+
+html_theme = "nvidia_sphinx_theme"
+html_copy_source = False
+html_show_sourcelink = False
+html_show_sphinx = False
+
+html_domain_indices = False
+html_use_index = False
+html_extra_path = ["project.json", "versions1.json"]
+highlight_language = "console"
+
+html_theme_options = {
+    "icon_links": [],
+    "switcher": {
+        "json_url": "../versions1.json",
+        "version_match": release,
+    },
+}
+
+html_baseurl = "https://docs.nvidia.com/nemo/guardrails/community/latest/"

docs/getting-started/1-hello-world/hello-world.ipynb renamed to docs/colang/1-hello-world/hello-world.ipynb

@@ -0,0 +1,85 @@
+# SPDX-FileCopyrightText: Copyright (c) 2023 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copyright (c) 2024, NVIDIA CORPORATION.
+
+from datetime import date
+from pathlib import Path
+
+from toml import load
+
+project = "Community Integrations with NeMo Guardrails"
+this_year = date.today().year
+copyright = f"2023-{this_year}, NVIDIA Corporation"
+author = "NVIDIA Corporation"
+release = "0.0.0"
+
+with open(
+    Path(__file__).parent.parent.parent / "pyproject.toml", encoding="utf-8"
+) as f:
+    t = load(f)
+    release = t.get("tool").get("poetry").get("version")
+
+extensions = [
+    "myst_parser",
+    "sphinx.ext.intersphinx",
+    "sphinx_copybutton",
+    "sphinx_reredirects",
+]
+
+copybutton_exclude = ".linenos, .gp, .go"
+
+myst_linkify_fuzzy_links = False
+myst_heading_anchors = 3
+myst_enable_extensions = [
+    "deflist",
+    "dollarmath",
+    "fieldlist",
+    "substitution",
+]
+
+myst_substitutions = {
+    "version": release,
+}
+
+exclude_patterns = [
+    "_build/**",
+]
+
+# intersphinx_mapping = {
+#     'gpu-op': ('https://docs.nvidia.com/datacenter/cloud-native/gpu-operator/latest', None),
+# }
+
+# suppress_warnings = ["etoc.toctree", "myst.header", "misc.highlighting_failure"]
+
+html_theme = "nvidia_sphinx_theme"
+html_copy_source = False
+html_show_sourcelink = False
+html_show_sphinx = False
+
+html_domain_indices = False
+html_use_index = False
+html_extra_path = ["project.json", "versions1.json"]
+highlight_language = "console"
+
+html_theme_options = {
+    "icon_links": [],
+    "switcher": {
+        "json_url": "../versions1.json",
+        "version_match": release,
+    },
+}
+
+html_baseurl = "https://docs.nvidia.com/nemo/guardrails/community/latest/"

docs/getting-started/1-hello-world/index.rst renamed to docs/colang/1-hello-world/index.rst

@@ -0,0 +1 @@
+{ "name": "nemo-guardrails-community-integrations", "version": "0.13.0" }

docs/getting-started/2-core-colang-concepts/README.md renamed to docs/colang/2-core-colang-concepts/README.md

@@ -44,6 +44,8 @@
 
 exclude_patterns = [
     "README.md",
+    "community",
+    "colang",
 ]
 
 myst_linkify_fuzzy_links = False
@@ -59,10 +61,6 @@
     "version": release,
 }
 
-exclude_patterns = [
-    "_build/**",
-]
-
 # intersphinx_mapping = {
 #     'gpu-op': ('https://docs.nvidia.com/datacenter/cloud-native/gpu-operator/latest', None),
 # }