more web docs, mobile friendly

cadebrown · cadebrown · commit a08b75739923 · 2025-10-14T22:23:01.000-04:00
diff --git a/configure b/configure
@@ -1180,6 +1180,7 @@ echo "\$(ks_BIN): \$(ks_O) \$(libks_SHARED)" >> $T
 echo "	@mkdir -p \$(dir \$@)" >> $T
 
 echo "	\$(CC) \\" >> $T
+echo "		\$(ks_O) \\" >> $T
 echo "		\$(LDFLAGS) \\" >> $T
 
 if [ "$PLATFORM" = "linux" ]; then
@@ -1190,7 +1191,6 @@ elif [ "$PLATFORM" = "darwin" ]; then
     echo "		-Wl,-rpath,'@loader_path/../lib' -L./lib -lks \\" >> $T
 fi
 
-echo "		\$(ks_O) \\" >> $T
 echo "		-o \$@" >> $T
 
 echo "" >> $T
diff --git a/docs/DOCS.md b/docs/DOCS.md
@@ -32,7 +32,7 @@ A few things I decided to reinvent the wheel for:
   * [bytecode compiler](https://github.com/cadebrown/kscript/blob/main/src/compiler.c), converting high level parse 
   * [bytecode virtual machine](https://github.com/cadebrown/kscript/blob/main/src/vm.c), which is the core of the interpreter using a stack-based execution model, with exceptions and scoping
 
-## FAQs: What/Why/Who/When/How is kscript?
+## FAQs
 
 What is kscript?
 : [kscript](https://ks.cade.io) is a dynamic programming language with expressive syntax, cross platform support, and a rich standard library. Its primary aim is to allow developers to write platform agnostic programs that can run anywhere, and require little or no platform-specific or os-specific code.
diff --git a/docs/index.html b/docs/index.html
@@ -32,17 +32,15 @@
 
 </head>
 <body>
-    <nav class="sidenav">
+    <nav>
         <ul>
         <li><a href="#kscript-a-programming-language"
         id="toc-kscript-a-programming-language"><span
         class="toc-section-number">1</span> kscript: a programming
         language</a>
         <ul>
-        <li><a href="#faqs-whatwhywhowhenhow-is-kscript"
-        id="toc-faqs-whatwhywhowhenhow-is-kscript"><span
-        class="toc-section-number">1.1</span> FAQs:
-        What/Why/Who/When/How is kscript?</a></li>
+        <li><a href="#faqs" id="toc-faqs"><span
+        class="toc-section-number">1.1</span> FAQs</a></li>
         </ul></li>
         <li><a href="#kscript-a-practical-guide"
         id="toc-kscript-a-practical-guide"><span
@@ -281,11 +279,8 @@ <h1 data-number="1" id="kscript-a-programming-language"><span
         a stack-based execution model, with exceptions and scoping</li>
         </ul></li>
         </ul>
-        <h2 data-number="1.1"
-        id="faqs-whatwhywhowhenhow-is-kscript"><span
-        class="header-section-number">1.1</span> FAQs:
-        What/Why/Who/When/How is kscript?<a
-        href="#faqs-whatwhywhowhenhow-is-kscript"
+        <h2 data-number="1.1" id="faqs"><span
+        class="header-section-number">1.1</span> FAQs<a href="#faqs"
         class="anchor-link"></a></h2>
         <dl>
         <dt><span id="What-is-kscript">What is kscript?<a
diff --git a/docs/kscript.pdf b/docs/kscript.pdf
diff --git a/docs/site.css b/docs/site.css
@@ -1,31 +1,18 @@
-
 /** General CSS **/
 
 html {
-    font-size: 15px;
 }
 
+
 body {
-    
-    font-family: monospace, monospace;
-    
-    line-height: 1.15;
-    
+    height: 100%;
+    width: 100%;
     margin: 0;
     padding: 0;
-    width: 100%;
-
 
-    /* display: flex; */
-    /* Default text font */
-
-    /*display: flex;
-    flex-direction: row;
-    min-height: 100vh;
-    width: 100vw;
-    display: flex; */
-
-    /* margin-left: 350px; */
+    font-family: monospace, monospace;
+    font-size: 15px;
+    line-height: 1.15;
 }
 
 nav {
@@ -41,11 +28,14 @@ nav {
     background: #ddd;
 }
 
-
 main {
     width: auto;
     margin-left: 350px;
     padding: 1em 2em;
+
+    /* never allow text to overflow */
+    overflow-wrap: normal;
+    overflow-x: hidden;
 }
 
 
@@ -148,6 +138,32 @@ dt:hover > .anchor-link {
 }
 
 
+/* on mobile and small screens */
+@media screen and (max-width: 768px) {
+    main {
+        margin-left: 0;
+        padding: 1em;
+    }
+    nav {
+        display: none;
+    }
+}
+
+
+/*
+@media screen and (max-width: 768px) {
+    main {
+        margin-left: 40vw;
+    }
+    nav {
+        width: 40vw;
+    }
+}
+
+*/
+
+
+
 
 /* for printing to a physical page, we style it differently */
 @media print {
diff --git a/docs/site.js b/docs/site.js
@@ -9,4 +9,3 @@ function doq_togglesidenav() {
         x.style.display = "block";
     }
 }
-
diff --git a/docs/template.html b/docs/template.html
@@ -32,7 +32,7 @@
 
 </head>
 <body>
-    <nav class="sidenav">
+    <nav>
         $toc$
     </nav>
     <main>

Original file line number	Diff line number	Diff line change
`@@ -9,4 +9,3 @@ function doq_togglesidenav() {`
`9`	`9`	`x.style.display = "block";`
`10`	`10`	`}`
`11`	`11`	`}`
`12`		`-`
-Original file line number
+Diff line change
 </head>
 <body>
 -    <nav class="sidenav">
 +    <nav>
         $toc$
     </nav>
     <main>