feat: add beforeSidebar option

Author: egoist

docs/README.md

@@ -138,22 +138,14 @@ docup.init({
 })
 ```
 
+Available languages:
+
 ```js preact
 import { useState, html } from 'docup'
 export default ({ langs }) => {
-  const [show, setShow] = useState(false)
-  return html`<div>
-    ${show &&
-    html`<ul>
-      ${langs.map((lang) => html`<li key="{lang}">${lang}</li>`)}
-    </ul>`}
-    <button
-      style="margin-top:20px;border:1px solid; font-size: 14px; padding:5px;"
-      onClick=${() => setShow(!show)}
-    >
-      Show ${show ? 'hide languages' : 'all supported languages'}..
-    </button>
-  </div>`
+  return html`<select>
+    ${langs.map((lang) => html`<option key="{lang}">${lang}</option>`)}
+  </select>`
 }
 ```
 
@@ -482,6 +474,12 @@ export default ({ count }) => {
 
 Follow system theme, i.e. use dark theme when system theme is dark.
 
+#### beforeSidebar
+
+- Type: `string`
+
+HTML string to display before sidebar.
+
 ## Browser support
 
 Last 2 versions of modern browsers.

docs/main.ts

@@ -8,6 +8,15 @@ init({
   props: {
     langs: PRISM_LANGUAGES,
   },
+  beforeSidebar: `<div style="background:#f9f9f9;padding: 20px;">
+    <div>
+      <strong style="font-size: 0.8rem;color:#ccc;">SPONSOR</strong>
+    </div>
+    <a href="https://browserku.com" rel="nofollow noopener" target="_blank"
+      title="API for web scraping, screenshots, PDF generation and more"
+      ><img src="https://cdn.jsdelivr.net/gh/egoist-bot/images@main/upic/b38Wz1.png"
+    /></a>
+  </div>`,
   navLinks: [
     {
       text: 'Guide',

package.json

@@ -37,7 +37,7 @@
   },
   "devDependencies": {
     "@egoist/rollup-plugin-ts-resolve": "^0.1.0",
-    "@prefresh/vite": "^2.2.4",
+    "@prefresh/vite": "^2.2.8",
     "@rollup/plugin-alias": "^3.1.2",
     "@rollup/plugin-commonjs": "^17.1.0",
     "@rollup/plugin-node-resolve": "^11.2.0",
@@ -46,16 +46,16 @@
     "@types/prismjs": "^1.16.3",
     "cross-env": "7.0.3",
     "debug": "^4.3.1",
-    "esbuild": "^0.14.2",
+    "esbuild": "^0.14.51",
     "esbuild-register": "^3.2.0",
     "fre": "^2.0.4",
     "postcss-nested": "^5.0.6",
     "prettier": "^2.2.1",
     "rollup": "^2.61.0",
     "rollup-plugin-dts": "^4.0.1",
-    "tailwindcss": "^2.2.19",
+    "tailwindcss": "^3.1.7",
     "type-fest": "^0.21.2",
     "typescript": "^4.2.3",
-    "vite": "^2.7.1"
+    "vite": "^3.0.4"
   }
 }