Standardize font sizes, improve display of words with <wbr> and soft …

…hyphens
fabricate-site · Oct 23, 2024 · 4111d2d · 4111d2d
1 parent aa49947
commit 4111d2d
Show file tree

Hide file tree

Showing 3 changed files with 16 additions and 12 deletions.
diff --git a/dev/site/fabricate/dev/build/utils.clj b/dev/site/fabricate/dev/build/utils.clj
@@ -6,5 +6,6 @@
 (defn expr->hiccup
   [form]
   (clj->hiccup (zp/zprint-str form
-                              {:style [:community :justified]
+                              {:width 60
+                               :style [:community :justified]
                                :map   {:comma? false :sort? false}})))
diff --git a/docs/css/fabricate.css b/docs/css/fabricate.css
@@ -42,9 +42,9 @@ this stylesheet.
     --display-sans: 'Lapidar 03', sans-serif;
     --sans: -apple-system, BlinkMacSystemFont, 'avenir next', avenir, 'segoe ui', 'helvetica neue', helvetica, Cantarell, Ubuntu, roboto, noto, arial, sans-serif;
     --grid-gap-x: min(10px, 1vw);
-    --font-main: clamp(16px, 4vmin, 22px);
-    --font-big: 3.5rem;
-    --font-medium: 1.5rem;
+    --font-main: clamp(13px, 3vmin, 20px);
+    --font-big: clamp(22px, 3rem, 56px);
+    --font-medium: clamp(15px, 1.5rem, 22px);
 
 }
 
@@ -101,7 +101,7 @@ pre {
   margin-top: 0;
   margin-bottom: 0;
   grid-column: 2 / 8;
-  font-size: 0.9em;
+  font-size: 0.85em;
 }
 
 .xl {
@@ -224,7 +224,7 @@ footer {
     grid-column: 1 / 3;
     font-family: var(--display-sans);
     font-weight: 900;
-    font-size: 1.5rem;
+    font-size: var(--font-medium);
     margin-left: 0.15rem;
 }
 
@@ -280,7 +280,7 @@ footer {
     grid-column: 1 / 4;
     font-family: var(--display-sans);
     font-weight: 900;
-    font-size: 1.5em;
+    font-size: var(--font-medium);
     padding-left: 0.15em;
     padding-right: 0.15em;
 }
@@ -320,7 +320,7 @@ footer.main-footer {
     align-items: center;
     justify-content: start;
     font-family: var(--display-sans);
-    font-size: 1.75rem;
+    font-size: var(--font-medium);
     font-weight: 900;
 }
 

diff --git a/pages/reference/namespaces/site.fabricate.api.html.fab b/pages/reference/namespaces/site.fabricate.api.html.fab
@@ -1,6 +1,7 @@
 ✳ (ns site.fabricate.docs.reference.namespaces.api
   (:require [site.fabricate.api :as api]
   [cybermonday.core :as md]
+  [dev.onionpancakes.chassis.core :as c]
   [site.fabricate.adorn :refer [clj->hiccup]]
   [site.fabricate.dev.build.utils :as utils]
   [rewrite-clj.zip :as z]
@@ -19,7 +20,9 @@
         :style {:outline-color "var(--color-blue)"}}
   [:h1 {:style {:grid-column-start "1" :margin-top "0em"
                 :background "var(--color-blue)"
-                :color "var(--color-sand)"}} [:span {:class "main-ns"} "site.fabricate.api"] [:br] [:span {:class "ns-annotation"
+                :color "var(--color-sand)"}} [:span {:class "main-ns"} 
+"site." [:wbr] "fabricate." [:wbr] "api"
+#_"site.fabricate.api"] [:br] [:span {:class "ns-annotation"
                                                                                                            } "Namespace"]]
   [:div {:style {:grid-column "1 / 7"}} (:doc (meta doc-ns))]] 🔚
 
@@ -67,7 +70,7 @@ Each source can produce one or more entries. For example, Fabricate, in building
   [:code {:class "primary-fn-fqn"} "site.fabricate.api/" [:strong "collect"]]]
 
  [:dl {:class "fn-description"}
-  [:dt "Multimethod"] 
+  [:dt (c/raw "Multi&shy;method") ] 
   [:dd  (md/parse-body 
          (:doc (meta #'site.fabricate.api/collect)))]
   [:dt "Inputs"] 
@@ -118,7 +121,7 @@ After this, each function in the sequence of tasks passed as an argument gets ca
    [:h2 {:class "primary-fn"} "build"]
 [:code {:class "primary-fn-fqn"} "site.fabricate.api/" [:strong "build"]]]
 [:dl {:class "fn-description"}
- [:dt "Multimethod"] [:dd  (md/parse-body (:doc  (meta #'api/build)))]
+ [:dt (c/raw "Multi&shy;method")] [:dd  (md/parse-body (:doc  (meta #'api/build)))]
  [:dt "Inputs"] [:dd #_[:code {:class "language-clojure"} 
         (->> (meta #'site.fabricate.api/build)
              :arglists
@@ -177,7 +180,7 @@ By default, they are HTML. Any other output format could be generated from the e
    [:h2 {:class "primary-fn"} "produce!"]
 [:code {:class "primary-fn-fqn"} "site.fabricate.api/" [:strong "produce!"]]]
 [:dl {:class "fn-description"}
- [:dt "Multimethod"] [:dd  (md/parse-body (:doc  (meta #'api/produce!)))]
+ [:dt (c/raw "Multi&shy;method") ] [:dd  (md/parse-body (:doc  (meta #'api/produce!)))]
  [:dt "Inputs"] [:dd #_[:code {:class "language-clojure"} 
         (->> (meta #'site.fabricate.api/build)
              :arglists