Add API documentation and underground station importer

- Introduced a new HTML documentation page for the oradio API, including a JavaScript file to handle dynamic content and API requests.
- Added a CSS file for styling the documentation page.
- Implemented an underground station importer script that fetches data from Radio-Browser and writes it to a JSON file.
- Created a stats module to compute and manage vote and play statistics for radio stations.
- Added a polyfill for modulepreload to ensure compatibility with older browsers.
This commit is contained in:
Marco Mooren
2026-05-11 02:06:48 +02:00
parent e0a60f7b64
commit 00246389bc
52 changed files with 6280 additions and 2475 deletions

171
web/docs/style.css Normal file
View File

@@ -0,0 +1,171 @@
:root {
--bg-0: #07080b;
--bg-1: #0e1116;
--bg-2: #161a22;
--bg-3: #1f242e;
--line: #262b36;
--fg: #e9ecf2;
--muted: #8a90a0;
--muted-2: #5d6373;
--accent: #ff7a3d;
--accent-2: #ffb37a;
--good: #4ec9a6;
--bad: #ec6a6a;
--info: #6ab7ff;
font-family: "Inter", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
color-scheme: dark;
}
* { box-sizing: border-box; }
html, body { margin: 0; padding: 0; background: var(--bg-0); color: var(--fg); }
a { color: var(--accent-2); text-decoration: none; }
a:hover { text-decoration: underline; }
.docs-header {
position: sticky; top: 0; z-index: 10;
background: rgba(7, 8, 11, 0.92);
border-bottom: 1px solid var(--line);
backdrop-filter: blur(8px);
}
.docs-header-inner {
max-width: 980px; margin: 0 auto;
padding: 14px 20px;
display: flex; align-items: center; gap: 16px;
}
.docs-header h1 {
margin: 0; font-size: 18px; letter-spacing: -0.01em;
}
.docs-header .back {
color: var(--muted); font-size: 13px;
padding: 6px 10px; border: 1px solid var(--line); border-radius: 8px;
}
.docs-header .back:hover { color: var(--fg); background: var(--bg-2); text-decoration: none; }
.docs-header .base {
margin-left: auto;
font-family: ui-monospace, "SF Mono", Menlo, monospace;
font-size: 12px; color: var(--muted);
padding: 4px 10px; background: var(--bg-2);
border: 1px solid var(--line); border-radius: 8px;
}
#app {
max-width: 980px; margin: 0 auto;
padding: 24px 20px 80px;
}
h2.group {
margin: 32px 0 12px;
font-size: 13px; text-transform: uppercase; letter-spacing: 0.1em;
color: var(--muted);
}
h2.group:first-child { margin-top: 0; }
.ep {
background: var(--bg-1);
border: 1px solid var(--line);
border-radius: 12px;
padding: 16px;
margin-bottom: 14px;
}
.ep-head {
display: flex; align-items: center; gap: 10px;
flex-wrap: wrap;
}
.ep-path {
font-family: ui-monospace, "SF Mono", Menlo, monospace;
font-size: 13px; color: var(--fg);
background: var(--bg-2);
padding: 4px 10px; border-radius: 6px;
border: 1px solid var(--line);
overflow-wrap: anywhere;
}
.ep-sum {
margin: 10px 0 0; color: var(--muted);
font-size: 14px; line-height: 1.5;
}
.m {
display: inline-block;
font-size: 11px; font-weight: 800; letter-spacing: 0.06em;
padding: 4px 8px; border-radius: 6px;
color: #07080b;
}
.m-get { background: var(--good); }
.m-post { background: var(--accent); }
.m-put { background: #d9b14a; }
.m-delete { background: var(--bad); color: #fff; }
.m-info { background: var(--info); }
.params {
width: 100%; border-collapse: collapse;
margin-top: 14px;
font-size: 13px;
}
.params th {
text-align: left; font-weight: 600; color: var(--muted);
text-transform: uppercase; font-size: 11px; letter-spacing: 0.06em;
padding: 8px 10px; border-bottom: 1px solid var(--line);
}
.params td {
padding: 8px 10px; border-bottom: 1px solid var(--line);
color: var(--fg);
}
.params td:first-child { width: 160px; }
.params code {
font-family: ui-monospace, "SF Mono", Menlo, monospace;
font-size: 12px; color: var(--accent-2);
background: var(--bg-2);
padding: 2px 6px; border-radius: 4px;
}
.examples { margin-top: 14px; }
.examples-h {
font-size: 11px; color: var(--muted);
text-transform: uppercase; letter-spacing: 0.06em;
margin-bottom: 6px;
}
.examples pre {
margin: 0 0 8px; padding: 10px 12px;
background: var(--bg-0); border: 1px solid var(--line);
border-radius: 8px;
font-family: ui-monospace, "SF Mono", Menlo, monospace;
font-size: 12.5px; color: var(--accent-2);
overflow-x: auto;
}
.try { margin-top: 14px; }
.try-row {
display: flex; gap: 8px; align-items: center;
margin-bottom: 8px;
}
.try-q {
flex: 1;
background: var(--bg-2); color: var(--fg);
border: 1px solid var(--line); border-radius: 8px;
padding: 8px 12px; font-size: 13px;
font-family: ui-monospace, "SF Mono", Menlo, monospace;
outline: none;
}
.try-q:focus { border-color: var(--accent); }
.try-btn {
background: var(--accent); color: #1a0a00;
border: 0; border-radius: 8px;
padding: 8px 16px; font-size: 13px; font-weight: 700;
cursor: pointer;
font-family: inherit;
}
.try-btn:hover { background: #ff8a55; }
.try-btn:disabled { opacity: 0.6; cursor: default; }
.try-open {
color: var(--muted); font-size: 12px;
padding: 6px 10px; border: 1px solid var(--line); border-radius: 8px;
}
.try-open:hover { color: var(--fg); background: var(--bg-2); text-decoration: none; }
.try-out {
margin: 0; padding: 12px;
background: var(--bg-0); border: 1px solid var(--line);
border-radius: 8px;
font-family: ui-monospace, "SF Mono", Menlo, monospace;
font-size: 12px; color: var(--fg);
max-height: 320px; overflow: auto;
white-space: pre-wrap; word-break: break-word;
}