Docs v2

.gitignore

@@ -1,8 +1,10 @@
 .idea
 vendor
 docs/themes/
+docs/node_modules/
 docs/public/
 docs/content/src-link
+docs/content/middleware
 *.out
 *.log
 .mod-cache

docs/.npmignore

@@ -0,0 +1,6 @@
+.env
+.netlify
+.hugo_build.lock
+node_modules
+public
+resources

docs/.npmrc

@@ -0,0 +1,4 @@
+enable-pre-post-scripts=true
+auto-install-peers=true
+node-linker=hoisted
+prefer-symlinked-executables=false

docs/.prettierignore

@@ -0,0 +1,12 @@
+*.html
+*.ico
+*.png
+*.jp*g
+*.toml
+*.*ignore
+*.svg
+*.xml
+LICENSE
+.npmrc
+.gitkeep
+*.woff*

docs/.prettierrc.yaml

@@ -0,0 +1,19 @@
+# Default config
+tabWidth: 4
+endOfLine: crlf
+singleQuote: true
+printWidth: 100000
+trailingComma: none
+bracketSameLine: true
+quoteProps: consistent
+experimentalTernaries: true
+
+# Overrided config
+overrides:
+  - files: ["*.md", "*.json", "*.yaml"]
+    options:
+      tabWidth: 2
+      singleQuote: false
+  - files: ["*.scss"]
+    options:
+      singleQuote: false

docs/assets/js/custom.js

@@ -0,0 +1,36 @@
+// Put your custom JS code here
+
+// a bit hacky way to force dark mode by default
+// it sets local storage item used by docs/node_modules/@thulite/doks-core/assets/js/color-mode.js
+if (!localStorage.getItem('theme')) {
+  localStorage.setItem('theme', 'dark');
+}
+
+import { render } from 'github-buttons';
+
+let renderGitHubButton= () => {
+  let oldButton = document.getElementById("github-button");
+  if (oldButton) {
+    oldButton.remove();
+  }
+
+  let options = {
+    "href": "https://github.com/ThreeDotsLabs/watermill",
+    "data-show-count": true,
+    "data-size": "large",
+    "data-color-scheme": localStorage.getItem('theme'),
+  }
+
+  render(options, function (el) {
+    let menu = document.getElementById("offcanvasNavMain").querySelector(".offcanvas-body");
+    let searchToggle = document.getElementById("searchToggleDesktop");
+
+    el.setAttribute("id", "github-button");
+    el.classList.add("nav-link", "px-2", "mx-auto");
+    el.setAttribute("style", "margin-top: 12px;");
+
+
+    menu.insertBefore(el, searchToggle);
+  })
+}
+renderGitHubButton()

docs/assets/jsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "*": ["*", "..\\node_modules\\@thulite\\doks-core\\assets\\*"]
+    }
+  }
+}

docs/assets/scss/common/_custom.scss

@@ -0,0 +1,17 @@
+// Put your custom SCSS code here
+* {
+  -webkit-font-smoothing: antialiased;
+}
+
+h1, h2, h3, h4, h5, .navbar-brand {
+  font-family: Quicksand, sans-serif;
+  font-weight: 700;
+}
+
+[data-bs-theme="dark"] .only-light {
+    display: none;
+}
+
+[data-bs-theme="light"] .only-dark {
+    display: none;
+}

docs/assets/scss/common/_variables-custom.scss

@@ -0,0 +1,28 @@
+// Put your custom SCSS variables here
+$font-family-sans-serif:
+  "Heebo",
+  "sans-serif",
+  system-ui,
+  -apple-system,
+  "Segoe UI",
+  Roboto,
+  "Helvetica Neue",
+  "Noto Sans",
+  "Liberation Sans",
+  Arial,
+  sans-serif,
+  "Apple Color Emoji",
+  "Segoe UI Emoji",
+  "Segoe UI Symbol",
+  "Noto Color Emoji";
+
+$container-max-widths: (
+    sm: 540px,
+    md: 720px,
+    lg: 960px,
+    xl: 1240px,
+    xxl: 1820px
+);
+
+
+$primary: #4f46e5;

docs/build.sh

@@ -3,15 +3,6 @@ set -e -x
 
 cd "$(dirname "$0")"
 
-if [[ ! -d themes/kube ]]; then
-    mkdir -p themes/kube && pushd themes/kube
-    git init
-    git remote add origin https://github.com/jeblister/kube
-    git fetch --depth 1 origin 1507abea527aecd896fdc306dfd28ee3e34f01ec
-    git checkout FETCH_HEAD
-    popd
-fi
-
 function cloneOrPull() {
     if [[ -d "$2" ]]
     then
@@ -24,12 +15,12 @@ function cloneOrPull() {
 }
 
 if [[ "$1" == "--copy" ]]; then
-    rm content/src-link -r || true
+    rm -rf content/src-link || true
     mkdir content/src-link/
-    cp ../message/ content/src-link/ -r
-    cp ../pubsub/ content/src-link/ -r
-    cp ../_examples/ content/src-link/ -r
-    cp ../components/ content/src-link/ -r
+    cp -r ../message content/src-link/
+    cp -r ../pubsub content/src-link/
+    cp -r ../_examples content/src-link/
+    cp -r ../components content/src-link/
 else
     declare -a files_to_link=(
         "_examples"
@@ -40,6 +31,7 @@ else
         "message/router.go"
         "message/router_context.go"
         "pubsub/gochannel/pubsub.go"
+        "pubsub/gochannel/fanout.go"
 
         "components/cqrs/command_bus.go"
         "components/cqrs/command_processor.go"
@@ -83,6 +75,8 @@ cloneOrPull "https://github.com/ThreeDotsLabs/watermill-firestore.git" content/s
 cloneOrPull "https://github.com/ThreeDotsLabs/watermill-bolt.git" content/src-link/watermill-bolt
 cloneOrPull "https://github.com/ThreeDotsLabs/watermill-redisstream.git" content/src-link/watermill-redisstream
 
+find content/src-link -name '*.md' -delete
+find content/src-link -name '*.html' -delete
 
 python3 ./extract_middleware_godocs.py > content/src-link/middleware-defs.md
 

docs/config/_default/hugo.toml

@@ -0,0 +1,81 @@
+title = "Watermill"
+baseurl = "http://localhost/"
+canonifyURLs = false
+disableAliases = true
+disableHugoGeneratorInject = true
+# disableKinds = ["taxonomy", "term"]
+enableEmoji = true
+enableGitInfo = false
+enableRobotsTXT = true
+languageCode = "en-US"
+paginate = 10
+rssLimit = 10
+summarylength = 20 # 70 (default)
+
+# Multilingual
+defaultContentLanguage = "en"
+disableLanguages = []
+defaultContentLanguageInSubdir = false
+
+copyRight = "Three Dots Labs"
+
+[build.buildStats]
+  enable = true
+
+[outputs]
+  home = ["HTML", "RSS", "searchIndex"]
+  section = ["HTML", "RSS", "SITEMAP"]
+
+[outputFormats.searchIndex]
+  mediaType = "application/json"
+  baseName = "search-index"
+  isPlainText = true
+  notAlternative = true
+
+# Add output format for section sitemap.xml
+[outputFormats.SITEMAP]
+  mediaType = "application/xml"
+  baseName = "sitemap"
+  isHTML = false
+  isPlainText = true
+  noUgly = true
+  rel  = "sitemap"
+
+[sitemap]
+  changefreq = "monthly"
+  filename = "sitemap.xml"
+  priority = 0.5
+
+[caches]
+  [caches.getjson]
+    dir = ":cacheDir/:project"
+    maxAge = -1 # "30m"
+
+[taxonomies]
+  contributor = "contributors"
+  category = "categories"
+  tag = "tags"
+
+[minify.tdewolff.html]
+  keepWhitespace = false
+
+[related]
+  threshold = 80
+  includeNewer = true
+  toLower = false
+    [[related.indices]]
+      name = "categories"
+      weight = 100
+    [[related.indices]]
+      name = "tags"
+      weight = 80
+    [[related.indices]]
+      name = "date"
+      weight = 10
+
+[imaging]
+  anchor = "Center"
+  bgColor = "#ffffff"
+  hint = "photo"
+  quality = 85
+  resampleFilter = "Lanczos"

docs/config/_default/languages.toml

@@ -0,0 +1,9 @@
+[en]
+  languageName = "English"
+  contentDir = "content/en"
+  weight = 10
+  [en.params]
+    languageISO = "EN"
+    languageTag = "en-US"
+    footer = ''
+    alertText = ''