doc.clj

(ns doc
  (:require
   [babashka.fs :as fs]
   [clojure.string :as str]
   [dinodoc.api :as dinodoc]))

(dinodoc/generate
 {:inputs ["."
           {:path "components/structurizr"}
           {:path "components/statecharts"}
           {:path "examples/openapi"}
           {:path "examples/dbschema"}
           {:path "components/dokka"}
           {:path "components/antora"}
           {:path "components/contextmapper"}]
  :api-mode :global
  :output-path "docs"})

;; Fixup to change absolute URLs to relative links in readme.
;; Having absolute URLs in README.md to make them work when opened on Github.
;; For Docusaurus relative links are better for local preview and for better
;; experience because external links would get opened in a new browser tab.
(fs/update-file "docs/index.md" str/replace #"https://dinodoc.pages.dev" "")
(fs/update-file "docs/structurizr/index.md" str/replace #"https://dinodoc.pages.dev" "../..")
(fs/update-file "docs/statecharts/index.md" str/replace #"https://dinodoc.pages.dev" "../..")
(fs/update-file "docs/openapi/index.md" str/replace #"https://dinodoc.pages.dev" "../..")
(fs/update-file "docs/dbschema/index.md" str/replace #"https://dinodoc.pages.dev" "../..")

;; Remove explicit position to make sure component docs are after regulare doc pages like Guide
;; Should figure out a better way how to specify order for nested inputs.
(fs/update-file "docs/structurizr/index.md" str/replace "sidebar_position: 0," "sidebar_position: 2,")
(fs/update-file "docs/openapi/index.md" str/replace "sidebar_position: 0," "sidebar_position: 3,")
(fs/update-file "docs/dbschema/index.md" str/replace "sidebar_position: 0," "sidebar_position: 4,")
(fs/update-file "docs/statecharts/index.md" str/replace "sidebar_position: 0," "sidebar_position: 5,")
(fs/update-file "docs/dokka/index.md" str/replace "sidebar_position: 0," "sidebar_position: 6,")
(fs/update-file "docs//antora/index.md" str/replace "sidebar_position: 0," "sidebar_position: 7,")

(shutdown-agents)