Add :html target

Author: a-zw

docs.bzl

@@ -137,20 +137,23 @@ def docs(source_dir = "docs", data = [], deps = []):
         data = data,
     )
 
-    sphinx_docs(
-        name = "needs_json",
-        srcs = [":docs_sources"],
-        config = ":" + source_dir + "/conf.py",
-        extra_opts = [
-            "-W",
-            "--keep-going",
-            "-T",  # show more details in case of errors
-            "--jobs",
-            "auto",
-            "--define=external_needs_source=" + str(data),
-        ],
-        formats = ["needs"],
-        sphinx = ":sphinx_build",
-        tools = data,
-        visibility = ["//visibility:public"],
-    )
+    # Create sphinx_docs targets for different output formats
+    formats = {"needs_json": "needs", "html": "html"}
+    for target_name, format_type in formats.items():
+        sphinx_docs(
+            name = target_name,
+            srcs = [":docs_sources"],
+            config = ":" + source_dir + "/conf.py",
+            extra_opts = [
+                "-W",
+                "--keep-going",
+                "-T",  # show more details in case of errors
+                "--jobs",
+                "auto",
+                "--define=external_needs_source=" + str(data),
+            ],
+            formats = [format_type],
+            sphinx = ":sphinx_build",
+            tools = data,
+            visibility = ["//visibility:public"],
+        )

docs/how-to/commands.md

@@ -4,12 +4,14 @@
 
 | Target                      | What it does                                                           |
 | --------------------------- | ---------------------------------------------------------------------- |
-| `bazel run //:docs`         | Builds documentation                                                   |
+| `bazel build //:html`       | Builds documentation in Bazel sandbox                                  |
+| `bazel run //:docs`         | Builds documentation outside of Bazel                                  |
 | `bazel run //:live_preview` | Creates a live_preview of the documentation viewable in a local server |
 | `bazel run //:ide_support`  | Sets up a Python venv for esbonio (Remember to restart VS Code!)       |
 
 ## Internal targets (do not use directly)
 
-| Target                      | What it does                |
-| --------------------------- | --------------------------- |
-| `bazel build //:needs_json` | Creates a 'needs.json' file |
+| Target                        | What it does                |
+| ----------------------------- | --------------------------- |
+| `bazel build //:needs_json`   | Creates a 'needs.json' file |
+| `bazel build //:docs_sources` | Sources like rst files      |