Merge pull request #3759 from nymtech/theme

Theme

.github/workflows/ci-dev.yml

@@ -22,10 +22,13 @@ jobs:
         with:
           toolchain: stable
       - name: Install mdbook
-        run: (test -x $HOME/.cargo/bin/mdbook || cargo install --vers "^0.4" mdbook)
+        # to make sure we don't run into toml dependency issue, make sure to pull fixed mdbook that depends on old 0.5
+        # and OLD mdbook-variables that uses the same dependency
+        # (mdbook-variables 0.2.3 updated to 0.7 which was used by mdbook incorrectly and extremely briefly)
+        run: (test -x $HOME/.cargo/bin/mdbook || cargo install --vers "^0.4.33" mdbook)
       - name: Install mdbook plugins
         run: |
-          cargo install --vers "^0.2.0" mdbook-variables && cargo install \
+          cargo install --vers "=0.2.2" mdbook-variables && cargo install \
             --vers "^1.8.0" mdbook-admonish && cargo install --vers \
             "^0.1.2" mdbook-last-changed && cargo install --vers "^0.1.2" mdbook-theme \
             && cargo install --vers "^0.7.7" mdbook-linkcheck 

documentation/dev-portal/book.toml

@@ -17,7 +17,7 @@ src = "src"
 # - run `mdbook build`: this will rebuild the `./theme` directory
 # - change value of `turn-off` back to `true`
 [preprocessor.theme]
-pagetoc        = true
+pagetoc = true
 # some variables related (defined in theme/css/variables.css)
 # `content-max-width` + `pagetoc-width` = 95% seems the best
 pagetoc-width            = "13%"
@@ -37,7 +37,7 @@ nav-chapters-min-width    = "auto"
 chapter-line-height       = "2em"
 section-line-height       = "1.5em"
 
-# # if true, never read and touch the files in theme dir
+# if true, never read and touch the files in theme dir
 turn-off = false
 
 [preprocessor.admonish]
@@ -77,7 +77,7 @@ curly-quotes = true
 # mathjax-support = false # useful if we want to pull equations in ?
 copy-fonts = true
 no-section-label = false
-additional-css = ["theme/pagetoc.css", "././mdbook-admonish.css", "last-changed.css"]
+additional-css = ["theme/pagetoc.css", "././mdbook-admonish.css", "custom.css"]
 additional-js  = ["theme/pagetoc.js"]
 git-repository-url = "https://github.com/nymtech/nym"
 git-repository-icon = "fa-github"

documentation/dev-portal/custom.css

@@ -0,0 +1,38 @@
+:root {
+  --mono-font: "Open Sans", Consolas, "Ubuntu Mono", Menlo, "DejaVu Sans Mono",
+    monospace, monospace;
+}
+.coal {
+  --bg: #121726;
+  --fg: #f2f2f2;
+
+  --sidebar-bg: #121726;
+  --sidebar-fg: #f2f2f2;
+  --sidebar-active: #fb6e4e;
+
+  --icons: #f2f2f2;
+  --icons-hover: #fb6e4e;
+
+  --links: #fb6e4e;
+}
+
+.light {
+  --bg: #f4f6f8;
+  --fg: #121726;
+
+  --sidebar-bg: #f4f6f8;
+  --sidebar-fg: #121726;
+  --sidebar-active: #fb6e4e;
+
+  --icons: #121726;
+  --icons-hover: #fb6e4e;
+
+  --links: #fb6e4e;
+}
+
+footer {
+  font-size: 0.8em;
+  text-align: center;
+  border-top: 1px solid black;
+  padding: 5px 0;
+}

documentation/dev-portal/last-changed.css

@@ -1,6 +0,0 @@
-footer {
-    font-size: 0.8em;
-    text-align: center;
-    border-top: 1px solid black;
-    padding: 5px 0;
-  }