doc: generate self-documentation

.github/workflows/release.yml

@@ -13,15 +13,25 @@ jobs:
           version: 6.0.0
       - name: Checkout
         uses: actions/checkout@v2
-      - name: "Build book"
+      - name: "Build ebook-example"
         run: "cd ebook-example && bazel build //:html_chunked"
+      - name: "Build bazel-ebook manual"
+        run: "bazel build //:bazel_ebook_html"
       - name: "Examine the environment"
         run: "ls -lR && ls -lR ./ebook-example/bazel-bin && ls -lR ./ebook-example/bazel-bin/html_chunked.d"
-      - name: "Deploy"
+      - name: "Deploy ebook-example"
         uses: peaceiris/actions-gh-pages@v3
         with:
           external_repository: filmil/hdlfactory.com.template
           publish_dir: ./ebook-example/bazel-bin/html_chunked.d/html_chunked
           destination_dir: static/html_chunked
           publish_branch: main
           deploy_key: "${{ secrets.DEPLOY_KEY }}"
+      - name: "Deploy bazel_ebook_html"
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          external_repository: filmil/hdlfactory.com.template
+          publish_dir: ./bazel-bin/bazel_ebook_html.d/bazel_ebook_html
+          destination_dir: static/html_chunked
+          publish_branch: main
+          deploy_key: "${{ secrets.DEPLOY_KEY }}"

BUILD.bazel

@@ -3,5 +3,35 @@
 # This file has been licensed under Apache 2.0 license.  Please see the LICENSE
 # file at the root of the repository.
 
-# Top level directory must have a BUILD.bazel file, even if empty.
+load("//build:rules.bzl",
+    "markdown_lib",
+    "pandoc_chunked_html",
+     "ebook_pdf",
+)
 
+markdown_lib(
+    name = "manual_src",
+    srcs = [
+        "README.md",
+    ],
+)
+
+pandoc_chunked_html(
+    name = "bazel_ebook_html",
+    deps = [
+        ":manual_src",
+    ],
+    toc = True,
+    title = "Bazel Ebook Tools",
+    filters = [
+        "@pandoc_crossref//:pandoc_crossref",
+    ],
+)
+
+# Missing rsvg-convert (for now).
+#ebook_pdf(
+  #name = "bazel_ebook_pdf",
+  #deps = [":manual_src"],
+  #metadata_xml = "empty.xml",
+  #title_yaml = "empty.yaml",
+#)