jaandrle/deka-dom-el
1
0
Fork 0
mirror of https://github.com/jaandrle/deka-dom-el synced 2025-07-01 12:22:15 +02:00
Code Packages Releases Activity

docs + ssr fixes

Browse Source
This commit is contained in:
Jan Andrle
2023-11-07 15:10:55 +01:00
parent 7d21b7799f
commit 2c844a0ca9
16 changed files with 708 additions and 300 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
bs/docs.js
View File

@ -1,23 +1,49 @@
#!/usr/bin/env nodejsscript
/* jshint esversion: 11,-W097, -W040, module: true, node: true, expr: true, undef: true *//* global echo, $, pipe, s, fetch, cyclicLoop */
echo("Building static documentation files…");
echo("Preparing…");
const path_target= {
root: "docs/",
html: "docs/index.html",
css: "docs/"
};
import { createHTMl } from "./docs/jsdom.js";
const ssr= createHTMl("");
import { register } from "../jsdom.js";
const { el }= await register(ssr.dom);
echo("Loading components…");
const pkg= s.cat("package.json").xargs(JSON.parse);
const { page, css }= await import("../docs_src/index.html.js"); //→ TODO: important to mention in docs!!!
document.body.append(
el(page, { pkg, path_target }),
el("script", { src: "https://cdn.jsdelivr.net/npm/shiki" }),
el("script", { src: "index.js", type: "module" })
);
const pages= [
{ id: "index", title: "Introduction", description: "Introducing a library and motivations." },
{ id: "elements", title: "Elements", description: "Basic concepts of elements modifications and creations." }
];
s.echo(ssr.serialize()).to(path_target.html);
s.echo(css.content).to(path_target.css+"index.css");
for(const info of pages){
const { id }= info;
echo(`Generating ${id}.html…`);
const ssr= createHTMl("");
const { el }= await register(ssr.dom);
const { page, css }= await import(`../docs_src/${id}.html.js`); //→ TODO: important to mention in docs!!!
document.body.append(
el(page, { pkg, info, path_target, pages, registerClientFile }),
);
echo.use("-R", `Writing ${id}.html…`);
s.echo(ssr.serialize()).to(path_target.root+id+".html");
s.echo(css.content).to(path_target.css+id+".css");
}
echo("Done");
/**
* @typedef registerClientFile
* @type {function}
* @param {URL} url
* @param {HTMLScriptElement|HTMLLinkElement} [element_head]
* */
function registerClientFile(url, element_head){
const file_name= url.pathname.split("/").pop();
s.cat(url).to(path_target.root+file_name);
if(!element_head) return;
element_head[element_head instanceof HTMLScriptElement ? "src" : "href"]= file_name;
document.head.append(
element_head
);
}