Spaces:
Running
This is a crucial correction. You want the **Nextra Documentation Layout** (the structure) combined with the **Tactical Ops Color Palette & Font** (the skin), but **without** the "roleplay" elements (no "SYSTEM ONLINE" widgets, no dense data grids, no radar charts, no forced uppercase).
Browse filesBasically: **"Clean, Minimalist Dark Mode Docs with Monospace Typography."**
Here is the adjusted prompt for your AI assistant.
---
### **Prompt for AI Coding Assistant**
**Role:** You are a Senior Front-End Developer specializing in minimalist documentation sites.
**Task:** Build a documentation website that combines a specific **Layout** with a specific **Visual Theme**.
#### **1. The Layout Architecture (Reference: Nextra Docs)**
* **Structure:** Standard "Holy Grail" Layout.
* **Header:** Sticky top bar (Logo + Nav Links + Search).
* **Left Sidebar:** Sticky navigation tree (Nested folders/files).
* **Main Content:** Central scrollable area for Markdown/Prose.
* **Right Sidebar:** Sticky "On This Page" Table of Contents (hidden on mobile).
* **Spacing:** maintain generous, comfortable whitespace (like a standard blog or docs site), do **not** use dense dashboard packing.
#### **2. The Visual Theme (Reference: Tactical Ops)**
* **Font Family:** Use a **Monospace** font stack for the entire site (Headings, Body, UI).
* *Suggestion:* `JetBrains Mono`, `Roboto Mono`, or `Geist Mono`.
* **Color Palette:**
* **Background:** `#0a0a0a` (Deep Black).
* **Surface/Panels:** `#111111` (Soft Dark Grey) - used for code blocks or sidebar backgrounds if needed.
* **Borders:** `#333333` (Dark Grey) - Use 1px borders to separate the Sidebars and Header from the Main Content. **No drop shadows.**
* **Primary Text:** `#e5e5e5` (Off-White).
* **Muted Text:** `#888888` (Mid-Grey) - for inactive sidebar items or metadata.
* **Accent Color:** `#ff6600` (Orange) - Strictly for **interactive elements**:
* Active Sidebar Link text.
* Hover states.
* Hyperlinks within the text.
* The "Active Section" indicator in the Table of Contents.
#### **3. Component Implementation Details**
**A. The Header**
* Background: `#0a0a0a` with a bottom border (`border-b border-[#333]`).
* Content: Simple Logo ("Syncopated Notes") on the left, simple text links on the right.
* **No** military badges or "Status" widgets.
**B. The Sidebars (Nav & TOC)**
* **Left Nav:** Clean list of links.
* *Active State:* Text turns Orange (`#ff6600`) and perhaps gets a thin left border line.
* *Inactive State:* Grey (`#888888`) -> White on hover.
* **Right TOC:** Simple list of headings. Active scroll position highlighted in Orange.
**C. Main Content (Typography)**
* **Headings:** Standard sentence case (e.g., "Rocky Linux 9 troubleshooting"), **not** forced uppercase.
* **Body Text:** Monospace, legible size (16px/1rem), loose line-height for readability.
* **Code Blocks:**
* Background: `#111111` (or slightly lighter than page bg).
* Border: `1px solid #333`.
* Text: Standard syntax highlighting.
**D. The "Digital Garden" Feel**
* Retain the "Welcome" and "Recently Updated" lists from the current prototype, just apply the colors above.
* Do not turn lists into "Data Grids." Keep them as clean, bulleted or simple list items.
---
### **CSS/Tailwind Config Summary**
Tell the AI to use these specific values in the config:
```javascript
// tailwind.config.js
module.exports = {
theme: {
extend: {
fontFamily: {
sans: ['JetBrains Mono', 'monospace'], // Force Mono as default
mono: ['JetBrains Mono', 'monospace'],
},
colors: {
bg: '#0a0a0a',
surface: '#111111',
border: '#333333',
primary: '#e5e5e5', // Main text
muted: '#888888', // Secondary text
accent: '#ff6600', // The Orange
}
}
}
}
```
- README.md +8 -5
- components/header.js +126 -0
- components/sidebar.js +97 -0
- components/toc.js +60 -0
- index.html +170 -19
- script.js +44 -0
- style.css +49 -19
|
@@ -1,10 +1,13 @@
|
|
| 1 |
---
|
| 2 |
-
title: Syncopated Ops
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
|
|
|
|
|
|
| 8 |
---
|
| 9 |
|
| 10 |
-
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
title: Syncopated Ops 📝
|
| 3 |
+
colorFrom: purple
|
| 4 |
+
colorTo: purple
|
| 5 |
+
emoji: 🐳
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
| 8 |
+
tags:
|
| 9 |
+
- deepsite-v3
|
| 10 |
---
|
| 11 |
|
| 12 |
+
# Welcome to your new DeepSite project!
|
| 13 |
+
This project was created with [DeepSite](https://huggingface.co/deepsite).
|
|
@@ -0,0 +1,126 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
class CustomHeader extends HTMLElement {
|
| 2 |
+
connectedCallback() {
|
| 3 |
+
this.attachShadow({ mode: 'open' });
|
| 4 |
+
this.shadowRoot.innerHTML = `
|
| 5 |
+
<style>
|
| 6 |
+
:host {
|
| 7 |
+
display: block;
|
| 8 |
+
height: 64px;
|
| 9 |
+
background-color: #0a0a0a;
|
| 10 |
+
border-bottom: 1px solid #333333;
|
| 11 |
+
position: sticky;
|
| 12 |
+
top: 0;
|
| 13 |
+
z-index: 50;
|
| 14 |
+
font-family: 'JetBrains Mono', monospace;
|
| 15 |
+
}
|
| 16 |
+
.container {
|
| 17 |
+
max-width: 100%;
|
| 18 |
+
height: 100%;
|
| 19 |
+
display: flex;
|
| 20 |
+
align-items: center;
|
| 21 |
+
justify-content: space-between;
|
| 22 |
+
padding: 0 1.5rem;
|
| 23 |
+
}
|
| 24 |
+
.logo {
|
| 25 |
+
font-weight: 700;
|
| 26 |
+
font-size: 1.125rem;
|
| 27 |
+
color: #e5e5e5;
|
| 28 |
+
display: flex;
|
| 29 |
+
align-items: center;
|
| 30 |
+
gap: 0.5rem;
|
| 31 |
+
text-decoration: none;
|
| 32 |
+
}
|
| 33 |
+
.logo:hover {
|
| 34 |
+
color: #ff6600;
|
| 35 |
+
}
|
| 36 |
+
.nav-links {
|
| 37 |
+
display: flex;
|
| 38 |
+
align-items: center;
|
| 39 |
+
gap: 2rem;
|
| 40 |
+
}
|
| 41 |
+
.nav-item {
|
| 42 |
+
font-size: 0.875rem;
|
| 43 |
+
color: #888888;
|
| 44 |
+
text-decoration: none;
|
| 45 |
+
transition: color 0.2s;
|
| 46 |
+
}
|
| 47 |
+
.nav-item:hover, .nav-item.active {
|
| 48 |
+
color: #e5e5e5;
|
| 49 |
+
}
|
| 50 |
+
.search-box {
|
| 51 |
+
display: flex;
|
| 52 |
+
align-items: center;
|
| 53 |
+
background-color: #111111;
|
| 54 |
+
border: 1px solid #333333;
|
| 55 |
+
padding: 0.25rem 0.75rem;
|
| 56 |
+
border-radius: 4px;
|
| 57 |
+
font-size: 0.875rem;
|
| 58 |
+
color: #888888;
|
| 59 |
+
width: 200px;
|
| 60 |
+
}
|
| 61 |
+
.search-box input {
|
| 62 |
+
background: transparent;
|
| 63 |
+
border: none;
|
| 64 |
+
outline: none;
|
| 65 |
+
color: #e5e5e5;
|
| 66 |
+
width: 100%;
|
| 67 |
+
margin-left: 0.5rem;
|
| 68 |
+
font-family: 'JetBrains Mono', monospace;
|
| 69 |
+
}
|
| 70 |
+
.search-icon {
|
| 71 |
+
width: 16px;
|
| 72 |
+
height: 16px;
|
| 73 |
+
color: #888888;
|
| 74 |
+
}
|
| 75 |
+
/* Mobile Menu Button */
|
| 76 |
+
.menu-btn {
|
| 77 |
+
display: none;
|
| 78 |
+
background: none;
|
| 79 |
+
border: none;
|
| 80 |
+
color: #e5e5e5;
|
| 81 |
+
cursor: pointer;
|
| 82 |
+
}
|
| 83 |
+
@media (max-width: 768px) {
|
| 84 |
+
.nav-links {
|
| 85 |
+
display: none;
|
| 86 |
+
}
|
| 87 |
+
.search-box {
|
| 88 |
+
display: none;
|
| 89 |
+
}
|
| 90 |
+
.menu-btn {
|
| 91 |
+
display: block;
|
| 92 |
+
}
|
| 93 |
+
}
|
| 94 |
+
</style>
|
| 95 |
+
<div class="container">
|
| 96 |
+
<a href="/" class="logo">
|
| 97 |
+
<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="text-accent"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"></path><polyline points="14 2 14 8 20 8"></polyline><line x1="16" y1="13" x2="8" y2="13"></line><line x1="16" y1="17" x2="8" y2="17"></line><polyline points="10 9 9 9 8 9"></polyline></svg>
|
| 98 |
+
Syncopated Notes
|
| 99 |
+
</a>
|
| 100 |
+
|
| 101 |
+
<div class="search-box">
|
| 102 |
+
<i data-feather="search" class="search-icon"></i>
|
| 103 |
+
<input type="text" placeholder="Search...">
|
| 104 |
+
</div>
|
| 105 |
+
|
| 106 |
+
<nav class="nav-links">
|
| 107 |
+
<a href="#" class="nav-item active">Docs</a>
|
| 108 |
+
<a href="#" class="nav-item">Blog</a>
|
| 109 |
+
<a href="#" class="nav-item">About</a>
|
| 110 |
+
<a href="https://github.com" target="_blank" class="nav-item">
|
| 111 |
+
<i data-feather="github" style="width:18px;height:18px;"></i>
|
| 112 |
+
</a>
|
| 113 |
+
</nav>
|
| 114 |
+
|
| 115 |
+
<button class="menu-btn">
|
| 116 |
+
<i data-feather="menu"></i>
|
| 117 |
+
</button>
|
| 118 |
+
</div>
|
| 119 |
+
`;
|
| 120 |
+
// Initialize icons inside shadow DOM
|
| 121 |
+
if (window.feather) {
|
| 122 |
+
window.feather.replace();
|
| 123 |
+
}
|
| 124 |
+
}
|
| 125 |
+
}
|
| 126 |
+
customElements.define('custom-header', CustomHeader);
|
|
@@ -0,0 +1,97 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
class CustomSidebar extends HTMLElement {
|
| 2 |
+
connectedCallback() {
|
| 3 |
+
this.attachShadow({ mode: 'open' });
|
| 4 |
+
this.shadowRoot.innerHTML = `
|
| 5 |
+
<style>
|
| 6 |
+
:host {
|
| 7 |
+
display: block;
|
| 8 |
+
padding: 2rem 1.5rem;
|
| 9 |
+
font-family: 'JetBrains Mono', monospace;
|
| 10 |
+
}
|
| 11 |
+
.nav-group {
|
| 12 |
+
margin-bottom: 2rem;
|
| 13 |
+
}
|
| 14 |
+
.nav-group-title {
|
| 15 |
+
font-size: 0.75rem;
|
| 16 |
+
text-transform: uppercase;
|
| 17 |
+
letter-spacing: 0.05em;
|
| 18 |
+
color: #888888;
|
| 19 |
+
font-weight: 700;
|
| 20 |
+
margin-bottom: 1rem;
|
| 21 |
+
}
|
| 22 |
+
.nav-list {
|
| 23 |
+
list-style: none;
|
| 24 |
+
padding: 0;
|
| 25 |
+
margin: 0;
|
| 26 |
+
}
|
| 27 |
+
.nav-item {
|
| 28 |
+
margin-bottom: 0.25rem;
|
| 29 |
+
}
|
| 30 |
+
.nav-link {
|
| 31 |
+
display: block;
|
| 32 |
+
padding: 0.375rem 0;
|
| 33 |
+
padding-left: 0.75rem;
|
| 34 |
+
color: #888888;
|
| 35 |
+
text-decoration: none;
|
| 36 |
+
font-size: 0.875rem;
|
| 37 |
+
border-left: 2px solid transparent;
|
| 38 |
+
transition: all 0.2s ease;
|
| 39 |
+
}
|
| 40 |
+
.nav-link:hover {
|
| 41 |
+
color: #e5e5e5;
|
| 42 |
+
background-color: #111111;
|
| 43 |
+
}
|
| 44 |
+
/* Active State Logic handled by class addition in main JS, but we style the class here */
|
| 45 |
+
.nav-link.nav-item-active {
|
| 46 |
+
color: #ff6600;
|
| 47 |
+
border-left-color: #ff6600;
|
| 48 |
+
font-weight: 500;
|
| 49 |
+
}
|
| 50 |
+
</style>
|
| 51 |
+
<div>
|
| 52 |
+
<div class="nav-group">
|
| 53 |
+
<div class="nav-group-title">Getting Started</div>
|
| 54 |
+
<ul class="nav-list">
|
| 55 |
+
<li class="nav-item">
|
| 56 |
+
<a href="#" class="nav-link nav-item-active">Introduction</a>
|
| 57 |
+
</li>
|
| 58 |
+
<li class="nav-item">
|
| 59 |
+
<a href="#" class="nav-link">Installation</a>
|
| 60 |
+
</li>
|
| 61 |
+
<li class="nav-item">
|
| 62 |
+
<a href="#" class="nav-link">Configuration</a>
|
| 63 |
+
</li>
|
| 64 |
+
</ul>
|
| 65 |
+
</div>
|
| 66 |
+
|
| 67 |
+
<div class="nav-group">
|
| 68 |
+
<div class="nav-group-title">Core Concepts</div>
|
| 69 |
+
<ul class="nav-list">
|
| 70 |
+
<li class="nav-item">
|
| 71 |
+
<a href="#architecture" class="nav-link sidebar-link">Architecture</a>
|
| 72 |
+
</li>
|
| 73 |
+
<li class="nav-item">
|
| 74 |
+
<a href="#" class="nav-link sidebar-link">Data Flow</a>
|
| 75 |
+
</li>
|
| 76 |
+
<li class="nav-item">
|
| 77 |
+
<a href="#" class="nav-link sidebar-link">Security</a>
|
| 78 |
+
</li>
|
| 79 |
+
</ul>
|
| 80 |
+
</div>
|
| 81 |
+
|
| 82 |
+
<div class="nav-group">
|
| 83 |
+
<div class="nav-group-title">Community</div>
|
| 84 |
+
<ul class="nav-list">
|
| 85 |
+
<li class="nav-item">
|
| 86 |
+
<a href="#" class="nav-link sidebar-link">Contributing</a>
|
| 87 |
+
</li>
|
| 88 |
+
<li class="nav-item">
|
| 89 |
+
<a href="#" class="nav-link sidebar-link">Changelog</a>
|
| 90 |
+
</li>
|
| 91 |
+
</ul>
|
| 92 |
+
</div>
|
| 93 |
+
</div>
|
| 94 |
+
`;
|
| 95 |
+
}
|
| 96 |
+
}
|
| 97 |
+
customElements.define('custom-sidebar', CustomSidebar);
|
|
@@ -0,0 +1,60 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
class CustomToc extends HTMLElement {
|
| 2 |
+
connectedCallback() {
|
| 3 |
+
this.attachShadow({ mode: 'open' });
|
| 4 |
+
this.shadowRoot.innerHTML = `
|
| 5 |
+
<style>
|
| 6 |
+
:host {
|
| 7 |
+
display: block;
|
| 8 |
+
font-family: 'JetBrains Mono', monospace;
|
| 9 |
+
}
|
| 10 |
+
.toc-title {
|
| 11 |
+
font-size: 0.75rem;
|
| 12 |
+
text-transform: uppercase;
|
| 13 |
+
letter-spacing: 0.05em;
|
| 14 |
+
color: #888888;
|
| 15 |
+
font-weight: 700;
|
| 16 |
+
margin-bottom: 1rem;
|
| 17 |
+
}
|
| 18 |
+
.toc-list {
|
| 19 |
+
list-style: none;
|
| 20 |
+
padding: 0;
|
| 21 |
+
margin: 0;
|
| 22 |
+
}
|
| 23 |
+
.toc-item {
|
| 24 |
+
margin-bottom: 0.5rem;
|
| 25 |
+
}
|
| 26 |
+
.toc-link {
|
| 27 |
+
display: block;
|
| 28 |
+
font-size: 0.8125rem; /* 13px */
|
| 29 |
+
color: #888888;
|
| 30 |
+
text-decoration: none;
|
| 31 |
+
border-left: 2px solid transparent;
|
| 32 |
+
padding-left: 1rem;
|
| 33 |
+
transition: all 0.2s ease;
|
| 34 |
+
line-height: 1.5;
|
| 35 |
+
}
|
| 36 |
+
.toc-link:hover {
|
| 37 |
+
color: #e5e5e5;
|
| 38 |
+
}
|
| 39 |
+
.toc-link.toc-item-active {
|
| 40 |
+
color: #ff6600;
|
| 41 |
+
border-left-color: #ff6600;
|
| 42 |
+
font-weight: 500;
|
| 43 |
+
}
|
| 44 |
+
</style>
|
| 45 |
+
<div class="toc-title">On This Page</div>
|
| 46 |
+
<ul class="toc-list">
|
| 47 |
+
<li class="toc-item">
|
| 48 |
+
<a href="#intro" class="toc-link">Introduction</a>
|
| 49 |
+
</li>
|
| 50 |
+
<li class="toc-item">
|
| 51 |
+
<a href="#architecture" class="toc-link">Architecture</a>
|
| 52 |
+
</li>
|
| 53 |
+
<li class="toc-item">
|
| 54 |
+
<a href="#troubleshooting" class="toc-link">Rocky Linux 9</a>
|
| 55 |
+
</li>
|
| 56 |
+
</ul>
|
| 57 |
+
`;
|
| 58 |
+
}
|
| 59 |
+
}
|
| 60 |
+
customElements.define('custom-toc', CustomToc);
|
|
@@ -1,19 +1,170 @@
|
|
| 1 |
-
<!
|
| 2 |
-
<html>
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
| 16 |
-
|
| 17 |
-
|
| 18 |
-
|
| 19 |
-
<
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
<!DOCTYPE html>
|
| 2 |
+
<html lang="en" class="dark">
|
| 3 |
+
<head>
|
| 4 |
+
<meta charset="UTF-8">
|
| 5 |
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
| 6 |
+
<title>Syncopated Notes - Documentation</title>
|
| 7 |
+
<link rel="stylesheet" href="style.css">
|
| 8 |
+
|
| 9 |
+
<!-- Fonts -->
|
| 10 |
+
<link rel="preconnect" href="https://fonts.googleapis.com">
|
| 11 |
+
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
| 12 |
+
<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;700&display=swap" rel="stylesheet">
|
| 13 |
+
|
| 14 |
+
<!-- Tailwind CSS -->
|
| 15 |
+
<script src="https://cdn.tailwindcss.com"></script>
|
| 16 |
+
<script src="https://unpkg.com/feather-icons"></script>
|
| 17 |
+
<script src="https://cdn.jsdelivr.net/npm/feather-icons/dist/feather.min.js"></script>
|
| 18 |
+
|
| 19 |
+
<!-- Tailwind Config -->
|
| 20 |
+
<script>
|
| 21 |
+
tailwind.config = {
|
| 22 |
+
darkMode: 'class',
|
| 23 |
+
theme: {
|
| 24 |
+
extend: {
|
| 25 |
+
fontFamily: {
|
| 26 |
+
sans: ['"JetBrains Mono"', 'monospace'],
|
| 27 |
+
mono: ['"JetBrains Mono"', 'monospace'],
|
| 28 |
+
},
|
| 29 |
+
colors: {
|
| 30 |
+
bg: '#0a0a0a',
|
| 31 |
+
surface: '#111111',
|
| 32 |
+
border: '#333333',
|
| 33 |
+
primary: '#e5e5e5',
|
| 34 |
+
muted: '#888888',
|
| 35 |
+
accent: '#ff6600',
|
| 36 |
+
}
|
| 37 |
+
}
|
| 38 |
+
}
|
| 39 |
+
}
|
| 40 |
+
</script>
|
| 41 |
+
</head>
|
| 42 |
+
<body class="bg-bg text-primary font-sans antialiased h-screen flex flex-col overflow-hidden selection:bg-accent selection:text-white">
|
| 43 |
+
|
| 44 |
+
<!-- Header Component -->
|
| 45 |
+
<custom-header class="flex-none"></custom-header>
|
| 46 |
+
|
| 47 |
+
<!-- Main Layout -->
|
| 48 |
+
<div class="flex flex-1 overflow-hidden">
|
| 49 |
+
|
| 50 |
+
<!-- Sidebar Component (Left) -->
|
| 51 |
+
<custom-sidebar class="w-64 flex-none hidden md:block border-r border-border overflow-y-auto bg-bg"></custom-sidebar>
|
| 52 |
+
|
| 53 |
+
<!-- Main Content Area -->
|
| 54 |
+
<main class="flex-1 overflow-y-auto relative scroll-smooth" id="main-content">
|
| 55 |
+
<div class="max-w-4xl mx-auto px-8 py-12 lg:px-16">
|
| 56 |
+
|
| 57 |
+
<!-- Hero Section -->
|
| 58 |
+
<header class="mb-12">
|
| 59 |
+
<h1 class="text-3xl font-bold tracking-tight mb-4 text-primary">Welcome to Syncopated Notes</h1>
|
| 60 |
+
<p class="text-lg text-muted leading-relaxed max-w-2xl">
|
| 61 |
+
A minimalist, high-performance documentation layout designed for clarity.
|
| 62 |
+
Explore the core concepts, architecture, and troubleshooting guides below.
|
| 63 |
+
</p>
|
| 64 |
+
</header>
|
| 65 |
+
|
| 66 |
+
<!-- Content Section -->
|
| 67 |
+
<section id="intro" class="mb-16 scroll-mt-20">
|
| 68 |
+
<h2 class="text-xl font-semibold text-primary mb-6 flex items-center">
|
| 69 |
+
<span class="w-1 h-6 bg-accent mr-3 rounded-sm"></span>
|
| 70 |
+
Introduction
|
| 71 |
+
</h2>
|
| 72 |
+
<p class="text-muted mb-4 leading-7">
|
| 73 |
+
This layout prioritizes content density without overwhelming the user. It uses the <strong>"Tactical Ops"</strong> color palette to reduce eye strain during long coding sessions.
|
| 74 |
+
</p>
|
| 75 |
+
<div class="my-6 p-4 border border-border bg-surface rounded-sm">
|
| 76 |
+
<code class="text-accent text-sm">npm install @syncopated/core</code>
|
| 77 |
+
</div>
|
| 78 |
+
<p class="text-muted leading-7">
|
| 79 |
+
The structure is based on the "Holy Grail" pattern, ensuring that navigation is always accessible while keeping the reading experience central.
|
| 80 |
+
</p>
|
| 81 |
+
</section>
|
| 82 |
+
|
| 83 |
+
<section id="architecture" class="mb-16 scroll-mt-20">
|
| 84 |
+
<h2 class="text-xl font-semibold text-primary mb-6 flex items-center">
|
| 85 |
+
<span class="w-1 h-6 bg-accent mr-3 rounded-sm"></span>
|
| 86 |
+
Architecture
|
| 87 |
+
</h2>
|
| 88 |
+
<p class="text-muted mb-4 leading-7">
|
| 89 |
+
The system is built using native Web Components to ensure modularity. The layout relies on Flexbox for responsiveness, collapsing sidebars gracefully on smaller viewports.
|
| 90 |
+
</p>
|
| 91 |
+
<ul class="list-disc list-outside ml-4 space-y-2 text-muted">
|
| 92 |
+
<li class="pl-2">Component-based structure</li>
|
| 93 |
+
<li class="pl-2">Reactive data binding</li>
|
| 94 |
+
<li class="pl-2">Optimized for static generation</li>
|
| 95 |
+
</ul>
|
| 96 |
+
</section>
|
| 97 |
+
|
| 98 |
+
<section id="troubleshooting" class="mb-16 scroll-mt-20">
|
| 99 |
+
<h2 class="text-xl font-semibold text-primary mb-6 flex items-center">
|
| 100 |
+
<span class="w-1 h-6 bg-accent mr-3 rounded-sm"></span>
|
| 101 |
+
Rocky Linux 9 Troubleshooting
|
| 102 |
+
</h2>
|
| 103 |
+
<p class="text-muted mb-4 leading-7">
|
| 104 |
+
Common issues encountered when deploying on Rocky Linux 9 environments usually stem from SELinux policies or firewall configurations.
|
| 105 |
+
</p>
|
| 106 |
+
|
| 107 |
+
<h3 class="text-lg font-medium text-primary mt-8 mb-4">Service failing to start</h3>
|
| 108 |
+
<p class="text-muted mb-4 leading-7">
|
| 109 |
+
Check the logs using journalctl. If permissions are denied, verify the context of your files.
|
| 110 |
+
</p>
|
| 111 |
+
<pre class="bg-surface border border-border p-4 overflow-x-auto rounded-sm text-sm text-primary mb-6"><code>$ sudo journalctl -xe -u syncopated.service
|
| 112 |
+
$ ls -Z /var/lib/syncopated</code></pre>
|
| 113 |
+
|
| 114 |
+
<h3 class="text-lg font-medium text-primary mt-8 mb-4">Network connectivity</h3>
|
| 115 |
+
<p class="text-muted leading-7">
|
| 116 |
+
Ensure port 8080 is open in firewalld.
|
| 117 |
+
</p>
|
| 118 |
+
<pre class="bg-surface border border-border p-4 overflow-x-auto rounded-sm text-sm text-primary"><code>$ sudo firewall-cmd --add-port=8080/tcp --permanent
|
| 119 |
+
$ sudo firewall-cmd --reload</code></pre>
|
| 120 |
+
</section>
|
| 121 |
+
|
| 122 |
+
<!-- Digital Garden: Recently Updated -->
|
| 123 |
+
<section class="border-t border-border pt-12 mt-12">
|
| 124 |
+
<h3 class="text-sm uppercase tracking-wider text-muted font-semibold mb-6">Recently Updated</h3>
|
| 125 |
+
<div class="space-y-4">
|
| 126 |
+
<a href="#" class="block group">
|
| 127 |
+
<div class="flex items-start justify-between">
|
| 128 |
+
<span class="text-primary group-hover:text-accent transition-colors duration-200">API Rate Limiting v2</span>
|
| 129 |
+
<span class="text-xs text-muted font-mono whitespace-nowrap ml-4">2h ago</span>
|
| 130 |
+
</div>
|
| 131 |
+
</a>
|
| 132 |
+
<a href="#" class="block group">
|
| 133 |
+
<div class="flex items-start justify-between">
|
| 134 |
+
<span class="text-primary group-hover:text-accent transition-colors duration-200">Deployment Checklist</span>
|
| 135 |
+
<span class="text-xs text-muted font-mono whitespace-nowrap ml-4">1d ago</span>
|
| 136 |
+
</div>
|
| 137 |
+
</a>
|
| 138 |
+
<a href="#" class="block group">
|
| 139 |
+
<div class="flex items-start justify-between">
|
| 140 |
+
<span class="text-primary group-hover:text-accent transition-colors duration-200">Environment Variables</span>
|
| 141 |
+
<span class="text-xs text-muted font-mono whitespace-nowrap ml-4">3d ago</span>
|
| 142 |
+
</div>
|
| 143 |
+
</a>
|
| 144 |
+
</div>
|
| 145 |
+
</section>
|
| 146 |
+
|
| 147 |
+
<!-- Footer -->
|
| 148 |
+
<footer class="mt-24 border-t border-border pt-8 pb-12 text-center md:text-left">
|
| 149 |
+
<p class="text-muted text-sm">
|
| 150 |
+
© 2023 Syncopated Notes. Built with pure HTML/CSS/JS.
|
| 151 |
+
</p>
|
| 152 |
+
</footer>
|
| 153 |
+
|
| 154 |
+
</div>
|
| 155 |
+
</main>
|
| 156 |
+
|
| 157 |
+
<!-- TOC Component (Right) -->
|
| 158 |
+
<custom-toc class="w-48 flex-none hidden lg:block border-l border-border bg-bg overflow-y-auto p-6 sticky top-16 h-[calc(100vh-4rem)]"></custom-toc>
|
| 159 |
+
|
| 160 |
+
</div>
|
| 161 |
+
|
| 162 |
+
<!-- Scripts -->
|
| 163 |
+
<script src="components/header.js"></script>
|
| 164 |
+
<script src="components/sidebar.js"></script>
|
| 165 |
+
<script src="components/toc.js"></script>
|
| 166 |
+
<script src="script.js"></script>
|
| 167 |
+
<script>feather.replace();</script>
|
| 168 |
+
<script src="https://huggingface.co/deepsite/deepsite-badge.js"></script>
|
| 169 |
+
</body>
|
| 170 |
+
</html>
|
|
@@ -0,0 +1,44 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
document.addEventListener('DOMContentLoaded', () => {
|
| 2 |
+
// Highlight TOC and Sidebar based on scroll position
|
| 3 |
+
const mainContent = document.getElementById('main-content');
|
| 4 |
+
const sections = document.querySelectorAll('section[id]');
|
| 5 |
+
|
| 6 |
+
// Sidebar Link Logic
|
| 7 |
+
const sidebarLinks = document.querySelectorAll('.sidebar-link');
|
| 8 |
+
const currentUrl = window.location.pathname;
|
| 9 |
+
|
| 10 |
+
sidebarLinks.forEach(link => {
|
| 11 |
+
// Simple check for demo purposes
|
| 12 |
+
if(link.getAttribute('href') === currentUrl || (currentUrl === '/' && link.getAttribute('href') === '/index.html')) {
|
| 13 |
+
link.classList.add('nav-item-active', 'font-medium');
|
| 14 |
+
link.classList.remove('text-muted', 'hover:text-primary');
|
| 15 |
+
}
|
| 16 |
+
});
|
| 17 |
+
|
| 18 |
+
// Intersection Observer for TOC
|
| 19 |
+
const observerOptions = {
|
| 20 |
+
root: mainContent,
|
| 21 |
+
rootMargin: '-20% 0px -70% 0px', // Trigger when section is near top
|
| 22 |
+
threshold: 0
|
| 23 |
+
};
|
| 24 |
+
|
| 25 |
+
const observer = new IntersectionObserver((entries) => {
|
| 26 |
+
entries.forEach(entry => {
|
| 27 |
+
if (entry.isIntersecting) {
|
| 28 |
+
const id = entry.target.getAttribute('id');
|
| 29 |
+
|
| 30 |
+
// Update TOC
|
| 31 |
+
document.querySelectorAll('.toc-link').forEach(link => {
|
| 32 |
+
link.classList.remove('toc-item-active', 'font-medium');
|
| 33 |
+
link.classList.add('text-muted');
|
| 34 |
+
if (link.getAttribute('href') === `#${id}`) {
|
| 35 |
+
link.classList.add('toc-item-active', 'font-medium');
|
| 36 |
+
link.classList.remove('text-muted');
|
| 37 |
+
}
|
| 38 |
+
});
|
| 39 |
+
}
|
| 40 |
+
});
|
| 41 |
+
}, observerOptions);
|
| 42 |
+
|
| 43 |
+
sections.forEach(section => observer.observe(section));
|
| 44 |
+
});
|
|
@@ -1,28 +1,58 @@
|
|
| 1 |
-
|
| 2 |
-
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
}
|
| 5 |
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
|
|
|
|
|
|
| 9 |
}
|
| 10 |
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 16 |
}
|
| 17 |
|
| 18 |
-
|
| 19 |
-
|
| 20 |
-
|
| 21 |
-
|
| 22 |
-
|
| 23 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 24 |
}
|
| 25 |
|
| 26 |
-
|
| 27 |
-
|
|
|
|
|
|
|
| 28 |
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
/* Base Reset & Typography */
|
| 2 |
+
:root {
|
| 3 |
+
--font-main: 'JetBrains Mono', monospace;
|
| 4 |
+
--color-bg: #0a0a0a;
|
| 5 |
+
--color-surface: #111111;
|
| 6 |
+
--color-border: #333333;
|
| 7 |
+
--color-primary: #e5e5e5;
|
| 8 |
+
--color-muted: #888888;
|
| 9 |
+
--color-accent: #ff6600;
|
| 10 |
}
|
| 11 |
|
| 12 |
+
body {
|
| 13 |
+
background-color: var(--color-bg);
|
| 14 |
+
color: var(--color-primary);
|
| 15 |
+
font-family: var(--font-main);
|
| 16 |
+
/* Custom scrollbar for Webkit */
|
| 17 |
}
|
| 18 |
|
| 19 |
+
/* Custom Scrollbar */
|
| 20 |
+
::-webkit-scrollbar {
|
| 21 |
+
width: 8px;
|
| 22 |
+
height: 8px;
|
| 23 |
+
}
|
| 24 |
+
::-webkit-scrollbar-track {
|
| 25 |
+
background: var(--color-bg);
|
| 26 |
+
}
|
| 27 |
+
::-webkit-scrollbar-thumb {
|
| 28 |
+
background: #222;
|
| 29 |
+
border: 1px solid var(--color-border);
|
| 30 |
+
border-radius: 4px;
|
| 31 |
+
}
|
| 32 |
+
::-webkit-scrollbar-thumb:hover {
|
| 33 |
+
background: #333;
|
| 34 |
}
|
| 35 |
|
| 36 |
+
/* Typography adjustments */
|
| 37 |
+
h1, h2, h3, h4, h5, h6 {
|
| 38 |
+
color: var(--color-primary);
|
| 39 |
+
font-weight: 500; /* Monospace fonts look better slightly lighter than bold */
|
| 40 |
+
}
|
| 41 |
+
a {
|
| 42 |
+
color: inherit;
|
| 43 |
+
text-decoration: none;
|
| 44 |
+
transition: color 0.2s ease;
|
| 45 |
+
}
|
| 46 |
+
code {
|
| 47 |
+
font-family: var(--font-main);
|
| 48 |
}
|
| 49 |
|
| 50 |
+
/* Utility Helpers for Active States */
|
| 51 |
+
.nav-item-active {
|
| 52 |
+
color: var(--color-accent) !important;
|
| 53 |
+
border-left-color: var(--color-accent) !important;
|
| 54 |
}
|
| 55 |
+
.toc-item-active {
|
| 56 |
+
color: var(--color-accent) !important;
|
| 57 |
+
border-left-color: var(--color-accent) !important;
|
| 58 |
+
}
|