Add gitignore and initial project files
This commit is contained in:
+39
@@ -0,0 +1,39 @@
|
||||
# Dependencies
|
||||
node_modules/
|
||||
|
||||
# Logs
|
||||
npm-debug.log*
|
||||
yarn-debug.log*
|
||||
yarn-error.log*
|
||||
pnpm-debug.log*
|
||||
|
||||
# Runtime data
|
||||
*.pid
|
||||
*.pid.lock
|
||||
*.seed
|
||||
*.out
|
||||
*.err
|
||||
|
||||
# Coverage / build output
|
||||
coverage/
|
||||
dist/
|
||||
build/
|
||||
tmp/
|
||||
temp/
|
||||
.cache/
|
||||
.turbo/
|
||||
.parcel-cache/
|
||||
.vite/
|
||||
|
||||
# Environment files
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
|
||||
# Editor and OS files
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
.vscode/
|
||||
.idea/
|
||||
*.swp
|
||||
*.swo
|
||||
@@ -0,0 +1,177 @@
|
||||
# webook
|
||||
|
||||
📖 一个命令行工具,将 Markdown 笔记目录渲染为 Web 预览页面。
|
||||
|
||||
## 特性
|
||||
|
||||
- **双栏布局** — 左侧文件导航树 + 右侧内容预览
|
||||
- **自动导航** — 启动时递归扫描目录结构,生成可折叠的文件树
|
||||
- **元信息展示** — 显示笔记标题、创建时间、修改时间、字数统计
|
||||
- **浅/暗主题** — 一键切换,主题偏好自动保存到 localStorage
|
||||
- **可隐藏侧边栏** — 专注于阅读内容
|
||||
- **搜索过滤** — 侧边栏顶部搜索框,快速过滤文件(快捷键 `Ctrl+K` / `Cmd+K`)
|
||||
- **代码高亮** — 基于 highlight.js,支持 190+ 编程语言
|
||||
- **本地图片** — 自动重写相对路径图片链接,支持本地静态资源
|
||||
- **热更新** — 文件变更时自动刷新浏览器(WebSocket)
|
||||
- **响应式设计** — 移动端自动适配
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
npm install -g webook
|
||||
```
|
||||
|
||||
或本地开发:
|
||||
|
||||
```bash
|
||||
git clone <repo-url>
|
||||
cd webook
|
||||
npm install
|
||||
npm link # 将 webook 链接到全局
|
||||
```
|
||||
|
||||
## 使用
|
||||
|
||||
### 基本用法
|
||||
|
||||
```bash
|
||||
# 预览当前目录下的 Markdown 笔记
|
||||
webook
|
||||
|
||||
# 预览指定目录
|
||||
webook ~/my-notes
|
||||
|
||||
# 指定端口
|
||||
webook ~/my-notes --port=3000
|
||||
|
||||
# 指定监听地址和网站标题
|
||||
webook ~/my-notes --host=0.0.0.0 --title="我的知识库"
|
||||
```
|
||||
|
||||
### 参数说明
|
||||
|
||||
| 参数 | 说明 | 默认值 |
|
||||
|------|------|--------|
|
||||
| `<dir>` | 笔记根目录路径 | 当前目录 `.` |
|
||||
| `--port, -p <number>` | 监听端口(被占用时自动递增) | `8000` |
|
||||
| `--host, -h <address>` | 监听地址 | `127.0.0.1` |
|
||||
| `--title, -t <title>` | 网站标题 | 根目录名 |
|
||||
| `--theme <path>` | 自定义 CSS 主题文件路径 | 无 |
|
||||
| `--open` | 启动后自动打开浏览器 | `false` |
|
||||
| `--version, -V` | 显示版本号 | — |
|
||||
|
||||
### 示例
|
||||
|
||||
```bash
|
||||
# 最小化使用
|
||||
webook
|
||||
|
||||
# 完整参数
|
||||
webook ~/Documents/notes --port=8080 --host=0.0.0.0 --title="我的笔记" --open
|
||||
|
||||
# 使用自定义主题
|
||||
webook ./docs --theme=./my-theme.css
|
||||
```
|
||||
|
||||
## 页面功能
|
||||
|
||||
### 侧边栏
|
||||
|
||||
- **文件树**:自动递归生成,目录可折叠/展开
|
||||
- **搜索**:输入关键词实时过滤文件,按 `Esc` 清空搜索
|
||||
- **隐藏**:点击工具栏 `☰` 按钮或使用快捷键
|
||||
|
||||
### 内容区
|
||||
|
||||
- 显示笔记标题、创建时间、修改时间、字数
|
||||
- 支持 Markdown 全部语法:标题、表格、代码块、引用、列表、任务列表等
|
||||
- 代码块自动语法高亮
|
||||
|
||||
### 主题切换
|
||||
|
||||
- 点击工具栏 `🌙` / `☀️` 按钮切换浅/暗主题
|
||||
- 选择会自动保存,下次打开保持
|
||||
|
||||
### 移动端
|
||||
|
||||
- 在手机上浏览时,侧边栏默认隐藏
|
||||
- 点击右下角浮动按钮打开侧边栏
|
||||
- 点击遮罩层或选文件后自动关闭
|
||||
|
||||
## 自定义主题
|
||||
|
||||
通过 `--theme` 参数传入外部 CSS 文件路径(支持相对路径和绝对路径),CSS 文件必须是有效的 CSS。建议参考 `public/style.css` 中的 CSS 变量:
|
||||
|
||||
```css
|
||||
:root {
|
||||
--bg-primary: #ffffff;
|
||||
--bg-secondary: #f8f9fa;
|
||||
--text-primary: #212529;
|
||||
--text-secondary: #6c757d;
|
||||
--border-color: #dee2e6;
|
||||
--accent-color: #4a90d9;
|
||||
/* ... */
|
||||
}
|
||||
|
||||
[data-theme="dark"] {
|
||||
--bg-primary: #1a1b1e;
|
||||
--text-primary: #c1c2c5;
|
||||
/* ... */
|
||||
}
|
||||
```
|
||||
|
||||
## 目录结构要求
|
||||
|
||||
webook 只扫描 `.md` 和 `.markdown` 文件。目录推荐按主题分组:
|
||||
|
||||
```
|
||||
my-notes/
|
||||
├── README.md # 首页(如果存在会自动加载)
|
||||
├── 编程/
|
||||
│ ├── JavaScript.md
|
||||
│ └── Python.md
|
||||
├── 阅读/
|
||||
│ └── 读书笔记.md
|
||||
└── 工具/
|
||||
└── Git常用命令.md
|
||||
```
|
||||
|
||||
- 隐藏文件(`.` 开头)和 `node_modules` 会被自动跳过
|
||||
- 目录和文件均按名称字母排序(中文按拼音)
|
||||
|
||||
## npm 发布
|
||||
|
||||
要将 webook 发布到 npm(例如 `@wu2kong/webook`),修改 `package.json` 中的 `name` 字段:
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "@wu2kong/webook",
|
||||
...
|
||||
}
|
||||
```
|
||||
|
||||
然后:
|
||||
|
||||
```bash
|
||||
npm login
|
||||
npm publish --access public
|
||||
```
|
||||
|
||||
发布后,用户可以通过以下命令安装:
|
||||
|
||||
```bash
|
||||
npm install -g @wu2kong/webook
|
||||
```
|
||||
|
||||
## 技术栈
|
||||
|
||||
- **后端**: Node.js + Express
|
||||
- **Markdown 渲染**: markdown-it
|
||||
- **代码高亮**: highlight.js
|
||||
- **文件监听**: chokidar
|
||||
- **热更新**: WebSocket (ws)
|
||||
- **CLI**: commander
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
Executable
+7
@@ -0,0 +1,7 @@
|
||||
#!/usr/bin/env node
|
||||
'use strict';
|
||||
const { main } = require('../src/cli');
|
||||
main().catch((err) => {
|
||||
console.error('Fatal error:', err.message);
|
||||
process.exit(1);
|
||||
});
|
||||
Generated
+1146
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,31 @@
|
||||
{
|
||||
"name": "webook",
|
||||
"version": "1.0.0",
|
||||
"description": "A CLI tool to preview markdown notes in a web browser with live reload",
|
||||
"main": "src/server.js",
|
||||
"bin": {
|
||||
"webook": "./bin/webook.js"
|
||||
},
|
||||
"type": "commonjs",
|
||||
"files": [
|
||||
"bin/",
|
||||
"src/",
|
||||
"views/",
|
||||
"public/"
|
||||
],
|
||||
"scripts": {
|
||||
"start": "node bin/webook.js",
|
||||
"dev": "node bin/webook.js . --port=8000"
|
||||
},
|
||||
"keywords": ["markdown", "notes", "preview", "cli", "web", "live-reload"],
|
||||
"author": "wu2kong",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"chokidar": "^3.6.0",
|
||||
"commander": "^12.1.0",
|
||||
"express": "^4.21.0",
|
||||
"highlight.js": "^11.10.0",
|
||||
"markdown-it": "^14.1.0",
|
||||
"ws": "^8.18.0"
|
||||
}
|
||||
}
|
||||
+438
@@ -0,0 +1,438 @@
|
||||
(function () {
|
||||
'use strict';
|
||||
|
||||
const DATA = window.__WEBOOK__;
|
||||
const navTree = DATA.nav || [];
|
||||
const defaultFile = DATA.defaultFile;
|
||||
const initialContent = DATA.initialContent;
|
||||
|
||||
// === DOM Elements ===
|
||||
const sidebarNav = document.getElementById('sidebarNav');
|
||||
const searchInput = document.getElementById('searchInput');
|
||||
const btnToggleSidebar = document.getElementById('btnToggleSidebar');
|
||||
const btnToggleTheme = document.getElementById('btnToggleTheme');
|
||||
const contentBody = document.getElementById('contentBody');
|
||||
const emptyState = document.getElementById('emptyState');
|
||||
const markdownContent = document.getElementById('markdownContent');
|
||||
const articleTitle = document.getElementById('articleTitle');
|
||||
const articleMeta = document.getElementById('articleMeta');
|
||||
const articleBody = document.getElementById('articleBody');
|
||||
const tocNav = document.getElementById('tocNav');
|
||||
const tocPanel = document.getElementById('tocPanel');
|
||||
const loadingBar = document.getElementById('loadingBar');
|
||||
const sidebar = document.getElementById('sidebar');
|
||||
const mobileNavBtn = document.getElementById('mobileNavBtn');
|
||||
|
||||
let currentFile = null;
|
||||
|
||||
// === Theme ===
|
||||
function getTheme() {
|
||||
return localStorage.getItem('webook-theme') || 'light';
|
||||
}
|
||||
|
||||
function setTheme(theme) {
|
||||
document.documentElement.setAttribute('data-theme', theme);
|
||||
localStorage.setItem('webook-theme', theme);
|
||||
btnToggleTheme.textContent = theme === 'dark' ? '☀︎' : '☾';
|
||||
|
||||
// Swap highlight theme
|
||||
const hlLink = document.querySelector('.theme-highlight');
|
||||
if (hlLink) {
|
||||
hlLink.href = theme === 'dark'
|
||||
? '/_webook/highlight-dark.css'
|
||||
: '/_webook/highlight-light.css';
|
||||
}
|
||||
}
|
||||
|
||||
function toggleTheme() {
|
||||
const current = getTheme();
|
||||
setTheme(current === 'light' ? 'dark' : 'light');
|
||||
}
|
||||
|
||||
// Initialize theme
|
||||
setTheme(getTheme());
|
||||
|
||||
// === Sidebar Toggle ===
|
||||
function getSidebarVisible() {
|
||||
return localStorage.getItem('webook-sidebar') !== 'hidden';
|
||||
}
|
||||
|
||||
function setSidebarVisible(visible) {
|
||||
if (visible) {
|
||||
sidebar.classList.remove('collapsed');
|
||||
localStorage.setItem('webook-sidebar', 'visible');
|
||||
btnToggleSidebar.textContent = '☰';
|
||||
} else {
|
||||
sidebar.classList.add('collapsed');
|
||||
localStorage.setItem('webook-sidebar', 'hidden');
|
||||
btnToggleSidebar.textContent = '☷';
|
||||
}
|
||||
}
|
||||
|
||||
function toggleSidebar() {
|
||||
setSidebarVisible(sidebar.classList.contains('collapsed'));
|
||||
}
|
||||
|
||||
// Initialize sidebar state
|
||||
setSidebarVisible(getSidebarVisible());
|
||||
|
||||
// === Mobile Sidebar ===
|
||||
let sidebarOverlay = null;
|
||||
|
||||
function createOverlay() {
|
||||
if (sidebarOverlay) return;
|
||||
sidebarOverlay = document.createElement('div');
|
||||
sidebarOverlay.className = 'sidebar-overlay';
|
||||
sidebarOverlay.addEventListener('click', hideMobileSidebar);
|
||||
document.body.appendChild(sidebarOverlay);
|
||||
}
|
||||
|
||||
function showMobileSidebar() {
|
||||
createOverlay();
|
||||
sidebar.classList.add('mobile-visible');
|
||||
sidebar.classList.remove('collapsed');
|
||||
sidebarOverlay.classList.add('visible');
|
||||
}
|
||||
|
||||
function hideMobileSidebar() {
|
||||
sidebar.classList.remove('mobile-visible');
|
||||
if (sidebarOverlay) {
|
||||
sidebarOverlay.classList.remove('visible');
|
||||
}
|
||||
// Restore collapsed state if needed
|
||||
if (!getSidebarVisible()) {
|
||||
sidebar.classList.add('collapsed');
|
||||
}
|
||||
}
|
||||
|
||||
// === Navigation Rendering ===
|
||||
function renderNavTree(items, level = 0) {
|
||||
if (!items || items.length === 0) return '';
|
||||
|
||||
let html = '<ul class="nav-tree">';
|
||||
for (const item of items) {
|
||||
if (item.type === 'dir') {
|
||||
html += `
|
||||
<li class="nav-dir collapsed" data-path="${escapeHtml(item.path)}">
|
||||
<div class="nav-dir-header" data-dir-path="${escapeHtml(item.path)}">
|
||||
<span class="nav-dir-arrow">▾</span>
|
||||
<span class="nav-dir-icon" aria-hidden="true"></span>
|
||||
<span class="nav-dir-name">${escapeHtml(item.name)}</span>
|
||||
</div>
|
||||
<div class="nav-dir-children">
|
||||
${renderNavTree(item.children, level + 1)}
|
||||
</div>
|
||||
</li>`;
|
||||
} else {
|
||||
const isActive = item.path === defaultFile;
|
||||
html += `
|
||||
<li class="nav-file${isActive ? ' active' : ''}" data-file-path="${escapeHtml(item.path)}">
|
||||
<span class="nav-file-icon" aria-hidden="true"></span>
|
||||
<span class="nav-file-name">${escapeHtml(item.meta ? item.meta.title : item.name)}</span>
|
||||
</li>`;
|
||||
}
|
||||
}
|
||||
html += '</ul>';
|
||||
return html;
|
||||
}
|
||||
|
||||
function escapeHtml(str) {
|
||||
const div = document.createElement('div');
|
||||
div.textContent = str;
|
||||
return div.innerHTML;
|
||||
}
|
||||
|
||||
// Render nav
|
||||
sidebarNav.innerHTML = renderNavTree(navTree);
|
||||
|
||||
// === Navigation Events ===
|
||||
sidebarNav.addEventListener('click', function (e) {
|
||||
// Directory toggle
|
||||
const dirHeader = e.target.closest('.nav-dir-header');
|
||||
if (dirHeader) {
|
||||
const dirItem = dirHeader.parentElement;
|
||||
dirItem.classList.toggle('collapsed');
|
||||
return;
|
||||
}
|
||||
|
||||
// File click
|
||||
const fileItem = e.target.closest('.nav-file');
|
||||
if (fileItem) {
|
||||
const filePath = fileItem.getAttribute('data-file-path');
|
||||
loadFile(filePath);
|
||||
setActiveFile(fileItem);
|
||||
// On mobile, hide sidebar after selection
|
||||
if (window.innerWidth <= 768) {
|
||||
hideMobileSidebar();
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
function setActiveFile(fileItem) {
|
||||
const prev = sidebarNav.querySelector('.nav-file.active');
|
||||
if (prev) prev.classList.remove('active');
|
||||
if (fileItem) fileItem.classList.add('active');
|
||||
}
|
||||
|
||||
// === Search ===
|
||||
searchInput.addEventListener('input', function () {
|
||||
const query = this.value.trim().toLowerCase();
|
||||
|
||||
if (!query) {
|
||||
// Show all
|
||||
sidebarNav.querySelectorAll('.nav-hidden').forEach(el => el.classList.remove('nav-hidden'));
|
||||
removeEmptyMessage();
|
||||
return;
|
||||
}
|
||||
|
||||
let hasVisible = false;
|
||||
|
||||
// Process directories
|
||||
const dirs = sidebarNav.querySelectorAll('.nav-dir');
|
||||
dirs.forEach(dir => {
|
||||
let dirHasVisible = false;
|
||||
|
||||
const files = dir.querySelectorAll('.nav-file');
|
||||
files.forEach(file => {
|
||||
const name = file.querySelector('.nav-file-name').textContent.toLowerCase();
|
||||
if (name.includes(query)) {
|
||||
file.classList.remove('nav-hidden');
|
||||
dirHasVisible = true;
|
||||
} else {
|
||||
file.classList.add('nav-hidden');
|
||||
}
|
||||
});
|
||||
|
||||
// Show/hide directory
|
||||
if (dirHasVisible) {
|
||||
dir.classList.remove('nav-hidden', 'collapsed');
|
||||
hasVisible = true;
|
||||
} else {
|
||||
dir.classList.add('nav-hidden');
|
||||
}
|
||||
});
|
||||
|
||||
// Root-level files
|
||||
const rootFiles = sidebarNav.querySelectorAll(':scope > .nav-tree > .nav-file');
|
||||
rootFiles.forEach(file => {
|
||||
const name = file.querySelector('.nav-file-name').textContent.toLowerCase();
|
||||
if (name.includes(query)) {
|
||||
file.classList.remove('nav-hidden');
|
||||
hasVisible = true;
|
||||
} else {
|
||||
file.classList.add('nav-hidden');
|
||||
}
|
||||
});
|
||||
|
||||
if (!hasVisible) {
|
||||
showEmptyMessage('未找到匹配的文件');
|
||||
} else {
|
||||
removeEmptyMessage();
|
||||
}
|
||||
});
|
||||
|
||||
function showEmptyMessage(msg) {
|
||||
removeEmptyMessage();
|
||||
const div = document.createElement('div');
|
||||
div.className = 'nav-empty';
|
||||
div.id = 'navEmptyMsg';
|
||||
div.textContent = msg;
|
||||
sidebarNav.appendChild(div);
|
||||
}
|
||||
|
||||
function removeEmptyMessage() {
|
||||
const existing = document.getElementById('navEmptyMsg');
|
||||
if (existing) existing.remove();
|
||||
}
|
||||
|
||||
// === File Loading ===
|
||||
async function loadFile(filePath) {
|
||||
if (currentFile === filePath) return;
|
||||
|
||||
currentFile = filePath;
|
||||
showLoading();
|
||||
|
||||
try {
|
||||
const resp = await fetch('/api/file?path=' + encodeURIComponent(filePath));
|
||||
const json = await resp.json();
|
||||
|
||||
if (!json.success) {
|
||||
throw new Error(json.error || 'Failed to load file');
|
||||
}
|
||||
|
||||
const data = json.data;
|
||||
|
||||
// Update content
|
||||
emptyState.style.display = 'none';
|
||||
markdownContent.style.display = '';
|
||||
|
||||
articleTitle.textContent = data.title;
|
||||
articleBody.innerHTML = data.html;
|
||||
buildTOC();
|
||||
|
||||
// Update meta
|
||||
const created = formatDate(data.meta.created);
|
||||
const modified = formatDate(data.meta.modified);
|
||||
const wordCount = data.meta.wordCount;
|
||||
|
||||
articleMeta.innerHTML = `
|
||||
<span class="article-meta-item">📅 创建: ${created}</span>
|
||||
<span class="article-meta-item">✏️ 修改: ${modified}</span>
|
||||
<span class="article-meta-item">📝 字数: ${wordCount.toLocaleString()}</span>
|
||||
`;
|
||||
|
||||
// Scroll to top
|
||||
contentBody.scrollTop = 0;
|
||||
|
||||
// Update URL hash
|
||||
if (history.pushState) {
|
||||
history.pushState(null, '', '#' + encodeURIComponent(filePath));
|
||||
}
|
||||
|
||||
// Apply syntax highlighting to code blocks in content
|
||||
applyHighlighting();
|
||||
} catch (err) {
|
||||
emptyState.style.display = 'flex';
|
||||
emptyState.querySelector('p').textContent = '加载失败: ' + err.message;
|
||||
markdownContent.style.display = 'none';
|
||||
} finally {
|
||||
hideLoading();
|
||||
}
|
||||
}
|
||||
|
||||
function showLoading() {
|
||||
loadingBar.classList.add('visible');
|
||||
loadingBar.classList.remove('done');
|
||||
}
|
||||
|
||||
function hideLoading() {
|
||||
loadingBar.classList.add('done');
|
||||
setTimeout(() => {
|
||||
loadingBar.classList.remove('visible', 'done');
|
||||
}, 350);
|
||||
}
|
||||
|
||||
function formatDate(isoStr) {
|
||||
if (!isoStr) return '-';
|
||||
const d = new Date(isoStr);
|
||||
const y = d.getFullYear();
|
||||
const m = String(d.getMonth() + 1).padStart(2, '0');
|
||||
const day = String(d.getDate()).padStart(2, '0');
|
||||
const h = String(d.getHours()).padStart(2, '0');
|
||||
const min = String(d.getMinutes()).padStart(2, '0');
|
||||
return `${y}-${m}-${day} ${h}:${min}`;
|
||||
}
|
||||
|
||||
function applyHighlighting() {
|
||||
// highlight.js is loaded via CDN or bundled, but we handle it server-side.
|
||||
// If any code blocks need client-side highlighting, do it here.
|
||||
// For now, server-side rendering handles highlighting.
|
||||
}
|
||||
|
||||
function slugifyHeading(text, index) {
|
||||
return 'toc-' + text
|
||||
.toLowerCase()
|
||||
.replace(/['"`]/g, '')
|
||||
.replace(/[^a-z0-9\u4e00-\u9fff]+/g, '-')
|
||||
.replace(/^-+|-+$/g, '') + '-' + index;
|
||||
}
|
||||
|
||||
function buildTOC() {
|
||||
if (!tocNav || !tocPanel) return;
|
||||
const headings = articleBody.querySelectorAll('h2, h3, h4');
|
||||
if (!headings.length) {
|
||||
tocPanel.classList.add('toc-empty');
|
||||
tocNav.innerHTML = '<div class="toc-empty-state">当前页面没有可用目录</div>';
|
||||
return;
|
||||
}
|
||||
|
||||
tocPanel.classList.remove('toc-empty');
|
||||
const items = [];
|
||||
headings.forEach((heading, index) => {
|
||||
const level = Number(heading.tagName.slice(1));
|
||||
if (!heading.id) {
|
||||
heading.id = slugifyHeading(heading.textContent || 'section', index);
|
||||
}
|
||||
items.push({
|
||||
id: heading.id,
|
||||
text: heading.textContent.trim(),
|
||||
level
|
||||
});
|
||||
});
|
||||
|
||||
tocNav.innerHTML = items.map((item) => `
|
||||
<a class="toc-link toc-level-${item.level}" href="#${escapeHtml(item.id)}" data-target="${escapeHtml(item.id)}">
|
||||
<span class="toc-bullet"></span>
|
||||
<span class="toc-text">${escapeHtml(item.text)}</span>
|
||||
</a>
|
||||
`).join('');
|
||||
}
|
||||
|
||||
// === Initial Load ===
|
||||
if (initialContent) {
|
||||
emptyState.style.display = 'none';
|
||||
markdownContent.style.display = '';
|
||||
articleTitle.textContent = initialContent.title;
|
||||
articleBody.innerHTML = initialContent.html;
|
||||
buildTOC();
|
||||
|
||||
const created = formatDate(initialContent.meta.created);
|
||||
const modified = formatDate(initialContent.meta.modified);
|
||||
const wordCount = initialContent.meta.wordCount;
|
||||
articleMeta.innerHTML = `
|
||||
<span class="article-meta-item">📅 创建: ${created}</span>
|
||||
<span class="article-meta-item">✏️ 修改: ${modified}</span>
|
||||
<span class="article-meta-item">📝 字数: ${wordCount.toLocaleString()}</span>
|
||||
`;
|
||||
|
||||
currentFile = defaultFile;
|
||||
if (defaultFile && history.replaceState) {
|
||||
history.replaceState(null, '', '#' + encodeURIComponent(defaultFile));
|
||||
}
|
||||
}
|
||||
|
||||
// === Hash-based navigation ===
|
||||
function handleHashChange() {
|
||||
const hash = decodeURIComponent(window.location.hash.slice(1));
|
||||
if (hash && hash !== currentFile) {
|
||||
loadFile(hash);
|
||||
// Find and activate the nav item
|
||||
const fileItem = sidebarNav.querySelector(`[data-file-path="${CSS.escape(hash)}"]`);
|
||||
if (fileItem) {
|
||||
setActiveFile(fileItem);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
window.addEventListener('hashchange', handleHashChange);
|
||||
|
||||
// === Event Listeners ===
|
||||
btnToggleTheme.addEventListener('click', toggleTheme);
|
||||
btnToggleSidebar.addEventListener('click', toggleSidebar);
|
||||
mobileNavBtn.addEventListener('click', showMobileSidebar);
|
||||
|
||||
// === Keyboard Shortcuts ===
|
||||
document.addEventListener('keydown', function (e) {
|
||||
// Ctrl+K or Cmd+K: focus search
|
||||
if ((e.ctrlKey || e.metaKey) && e.key === 'k') {
|
||||
e.preventDefault();
|
||||
searchInput.focus();
|
||||
searchInput.select();
|
||||
}
|
||||
|
||||
// Escape: clear search
|
||||
if (e.key === 'Escape' && document.activeElement === searchInput) {
|
||||
searchInput.value = '';
|
||||
searchInput.dispatchEvent(new Event('input'));
|
||||
searchInput.blur();
|
||||
}
|
||||
});
|
||||
|
||||
// Close mobile sidebar on Escape
|
||||
document.addEventListener('keydown', function (e) {
|
||||
if (e.key === 'Escape' && sidebar.classList.contains('mobile-visible')) {
|
||||
hideMobileSidebar();
|
||||
}
|
||||
});
|
||||
|
||||
})();
|
||||
@@ -0,0 +1,39 @@
|
||||
/* Dark theme for highlight.js - GitHub Dark-like */
|
||||
.hljs { display: block; overflow-x: auto; padding: 0; background: transparent; color: #c9d1d9; }
|
||||
.hljs-comment,
|
||||
.hljs-quote { color: #8b949e; font-style: italic; }
|
||||
.hljs-keyword,
|
||||
.hljs-selector-tag,
|
||||
.hljs-subst { color: #ff7b72; font-weight: bold; }
|
||||
.hljs-number,
|
||||
.hljs-literal,
|
||||
.hljs-variable,
|
||||
.hljs-template-variable,
|
||||
.hljs-tag .hljs-attr { color: #79c0ff; }
|
||||
.hljs-string,
|
||||
.hljs-doctag { color: #a5d6ff; }
|
||||
.hljs-title,
|
||||
.hljs-section,
|
||||
.hljs-selector-id { color: #d2a8ff; font-weight: bold; }
|
||||
.hljs-subst { font-weight: normal; }
|
||||
.hljs-type,
|
||||
.hljs-class .hljs-title { color: #d2a8ff; font-weight: bold; }
|
||||
.hljs-tag,
|
||||
.hljs-name,
|
||||
.hljs-attribute { color: #7ee787; font-weight: normal; }
|
||||
.hljs-regexp,
|
||||
.hljs-link { color: #a5d6ff; }
|
||||
.hljs-symbol,
|
||||
.hljs-bullet { color: #ffa657; }
|
||||
.hljs-built_in,
|
||||
.hljs-builtin-name { color: #79c0ff; }
|
||||
.hljs-meta { color: #8b949e; font-weight: bold; }
|
||||
.hljs-deletion { background: #490202; }
|
||||
.hljs-addition { background: #04260f; }
|
||||
.hljs-emphasis { font-style: italic; }
|
||||
.hljs-strong { font-weight: bold; }
|
||||
|
||||
/* Line numbers */
|
||||
.hljs-ln { border-collapse: collapse; }
|
||||
.hljs-ln td { padding: 0; }
|
||||
.hljs-ln-n { text-align: right; padding-right: 8px; color: #484f58; user-select: none; }
|
||||
@@ -0,0 +1,39 @@
|
||||
/* Light theme for highlight.js - GitHub-like */
|
||||
.hljs { display: block; overflow-x: auto; padding: 0; background: transparent; color: #24292e; }
|
||||
.hljs-comment,
|
||||
.hljs-quote { color: #6a737d; font-style: italic; }
|
||||
.hljs-keyword,
|
||||
.hljs-selector-tag,
|
||||
.hljs-subst { color: #d73a49; font-weight: bold; }
|
||||
.hljs-number,
|
||||
.hljs-literal,
|
||||
.hljs-variable,
|
||||
.hljs-template-variable,
|
||||
.hljs-tag .hljs-attr { color: #005cc5; }
|
||||
.hljs-string,
|
||||
.hljs-doctag { color: #032f62; }
|
||||
.hljs-title,
|
||||
.hljs-section,
|
||||
.hljs-selector-id { color: #6f42c1; font-weight: bold; }
|
||||
.hljs-subst { font-weight: normal; }
|
||||
.hljs-type,
|
||||
.hljs-class .hljs-title { color: #6f42c1; font-weight: bold; }
|
||||
.hljs-tag,
|
||||
.hljs-name,
|
||||
.hljs-attribute { color: #22863a; font-weight: normal; }
|
||||
.hljs-regexp,
|
||||
.hljs-link { color: #032f62; }
|
||||
.hljs-symbol,
|
||||
.hljs-bullet { color: #e36209; }
|
||||
.hljs-built_in,
|
||||
.hljs-builtin-name { color: #005cc5; }
|
||||
.hljs-meta { color: #6a737d; font-weight: bold; }
|
||||
.hljs-deletion { background: #ffeef0; }
|
||||
.hljs-addition { background: #f0fff4; }
|
||||
.hljs-emphasis { font-style: italic; }
|
||||
.hljs-strong { font-weight: bold; }
|
||||
|
||||
/* Line numbers */
|
||||
.hljs-ln { border-collapse: collapse; }
|
||||
.hljs-ln td { padding: 0; }
|
||||
.hljs-ln-n { text-align: right; padding-right: 8px; color: #959da5; user-select: none; }
|
||||
@@ -0,0 +1,77 @@
|
||||
(function() {
|
||||
'use strict';
|
||||
|
||||
let socket;
|
||||
let reconnectTimer;
|
||||
let reconnectDelay = 1000;
|
||||
|
||||
function connect() {
|
||||
const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
|
||||
const wsUrl = protocol + '//' + location.host + '/_ws';
|
||||
|
||||
try {
|
||||
socket = new WebSocket(wsUrl);
|
||||
|
||||
socket.onopen = function() {
|
||||
console.log('[webook] Live reload connected');
|
||||
reconnectDelay = 1000;
|
||||
};
|
||||
|
||||
socket.onmessage = function(event) {
|
||||
try {
|
||||
const msg = JSON.parse(event.data);
|
||||
if (msg.type === 'reload') {
|
||||
console.log('[webook] File changed, reloading...');
|
||||
// If a markdown file changed and we're currently viewing it, reload via API
|
||||
if (msg.file && /\.(md|markdown)$/i.test(msg.file)) {
|
||||
const currentFile = getCurrentFile();
|
||||
if (currentFile) {
|
||||
reloadCurrentFile();
|
||||
}
|
||||
} else {
|
||||
// For CSS/js/images, do a full reload
|
||||
location.reload();
|
||||
}
|
||||
}
|
||||
} catch (e) {
|
||||
location.reload();
|
||||
}
|
||||
};
|
||||
|
||||
socket.onclose = function() {
|
||||
console.log('[webook] Live reload disconnected');
|
||||
scheduleReconnect();
|
||||
};
|
||||
|
||||
socket.onerror = function() {
|
||||
socket.close();
|
||||
};
|
||||
} catch (e) {
|
||||
scheduleReconnect();
|
||||
}
|
||||
}
|
||||
|
||||
function scheduleReconnect() {
|
||||
clearTimeout(reconnectTimer);
|
||||
reconnectTimer = setTimeout(function() {
|
||||
reconnectDelay = Math.min(reconnectDelay * 1.5, 30000);
|
||||
connect();
|
||||
}, reconnectDelay);
|
||||
}
|
||||
|
||||
function getCurrentFile() {
|
||||
const hash = decodeURIComponent(location.hash.slice(1));
|
||||
if (hash) return hash;
|
||||
return window.__WEBOOK__ ? window.__WEBOOK__.defaultFile : null;
|
||||
}
|
||||
|
||||
function reloadCurrentFile() {
|
||||
const hash = decodeURIComponent(location.hash.slice(1));
|
||||
if (!hash) return location.reload();
|
||||
|
||||
// Dispatch hashchange to trigger reload
|
||||
window.dispatchEvent(new HashChangeEvent('hashchange'));
|
||||
}
|
||||
|
||||
connect();
|
||||
})();
|
||||
@@ -0,0 +1,411 @@
|
||||
:root {
|
||||
--bg: #f6f7fb;
|
||||
--bg-elevated: rgba(255, 255, 255, 0.86);
|
||||
--bg-panel: #ffffff;
|
||||
--bg-soft: #eef2f7;
|
||||
--bg-hover: #e8eef7;
|
||||
--text: #1f2937;
|
||||
--text-muted: #6b7280;
|
||||
--text-soft: #94a3b8;
|
||||
--border: rgba(148, 163, 184, 0.22);
|
||||
--border-strong: rgba(148, 163, 184, 0.35);
|
||||
--brand: #3a6ff7;
|
||||
--brand-strong: #2757d6;
|
||||
--brand-soft: rgba(58, 111, 247, 0.12);
|
||||
--code-bg: #0f172a;
|
||||
--code-fg: #e5edf9;
|
||||
--shadow-lg: 0 20px 50px rgba(15, 23, 42, 0.08);
|
||||
--shadow-md: 0 10px 28px rgba(15, 23, 42, 0.08);
|
||||
--shadow-sm: 0 4px 16px rgba(15, 23, 42, 0.06);
|
||||
--radius-lg: 20px;
|
||||
--radius-md: 14px;
|
||||
--radius-sm: 10px;
|
||||
--sidebar-width: 300px;
|
||||
--toolbar-height: 68px;
|
||||
--transition: 180ms ease;
|
||||
--font-sans: "Inter", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", system-ui, sans-serif;
|
||||
--font-mono: "SFMono-Regular", "SF Mono", "JetBrains Mono", "Menlo", monospace;
|
||||
}
|
||||
|
||||
[data-theme="dark"] {
|
||||
--bg: #0b1120;
|
||||
--bg-elevated: rgba(15, 23, 42, 0.82);
|
||||
--bg-panel: #0f172a;
|
||||
--bg-soft: #111827;
|
||||
--bg-hover: #182033;
|
||||
--text: #e5edf9;
|
||||
--text-muted: #a3b2c6;
|
||||
--text-soft: #6f8099;
|
||||
--border: rgba(148, 163, 184, 0.16);
|
||||
--border-strong: rgba(148, 163, 184, 0.26);
|
||||
--brand: #7aa2ff;
|
||||
--brand-strong: #93b4ff;
|
||||
--brand-soft: rgba(122, 162, 255, 0.14);
|
||||
--code-bg: #020617;
|
||||
--code-fg: #dbeafe;
|
||||
--shadow-lg: 0 24px 60px rgba(2, 6, 23, 0.34);
|
||||
--shadow-md: 0 14px 32px rgba(2, 6, 23, 0.28);
|
||||
--shadow-sm: 0 6px 18px rgba(2, 6, 23, 0.2);
|
||||
}
|
||||
|
||||
*, *::before, *::after { box-sizing: border-box; }
|
||||
html, body { margin: 0; min-height: 100%; }
|
||||
body {
|
||||
font-family: var(--font-sans);
|
||||
color: var(--text);
|
||||
background:
|
||||
radial-gradient(circle at top left, rgba(58, 111, 247, 0.12), transparent 30%),
|
||||
radial-gradient(circle at top right, rgba(56, 189, 248, 0.10), transparent 26%),
|
||||
linear-gradient(180deg, #fbfcff 0%, var(--bg) 100%);
|
||||
overflow: hidden;
|
||||
}
|
||||
[data-theme="dark"] body {
|
||||
background:
|
||||
radial-gradient(circle at top left, rgba(58, 111, 247, 0.16), transparent 30%),
|
||||
radial-gradient(circle at top right, rgba(56, 189, 248, 0.10), transparent 26%),
|
||||
linear-gradient(180deg, #0b1120 0%, #09101c 100%);
|
||||
}
|
||||
a { color: var(--brand); text-decoration: none; }
|
||||
a:hover { color: var(--brand-strong); }
|
||||
|
||||
.app {
|
||||
display: grid;
|
||||
grid-template-columns: var(--sidebar-width) minmax(0, 1fr);
|
||||
height: 100vh;
|
||||
}
|
||||
|
||||
.sidebar {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
min-width: 0;
|
||||
min-height: 0;
|
||||
padding: 18px 14px 18px 18px;
|
||||
border-right: 1px solid var(--border);
|
||||
background: var(--bg-elevated);
|
||||
backdrop-filter: blur(18px);
|
||||
box-shadow: inset -1px 0 0 rgba(255,255,255,0.3);
|
||||
}
|
||||
.sidebar.collapsed { margin-left: calc(-1 * var(--sidebar-width)); }
|
||||
.sidebar-header { display: grid; gap: 14px; padding-bottom: 14px; }
|
||||
.sidebar-brand {
|
||||
display: flex; align-items: center; gap: 12px;
|
||||
color: var(--text);
|
||||
padding: 10px 12px; border-radius: var(--radius-md);
|
||||
}
|
||||
.sidebar-brand:hover { background: var(--bg-soft); }
|
||||
.sidebar-brand-mark {
|
||||
width: 36px; height: 36px; border-radius: 12px;
|
||||
display: grid; place-items: center;
|
||||
background: linear-gradient(135deg, var(--brand), #7c3aed);
|
||||
color: #fff; font-weight: 700; box-shadow: var(--shadow-sm);
|
||||
}
|
||||
.sidebar-brand-text { display: grid; line-height: 1.15; }
|
||||
.sidebar-brand-text strong { font-size: 15px; }
|
||||
.sidebar-brand-text small { color: var(--text-muted); font-size: 12px; }
|
||||
.search-box input {
|
||||
width: 100%; border: 1px solid var(--border);
|
||||
border-radius: 999px; padding: 11px 14px;
|
||||
background: var(--bg-panel); color: var(--text);
|
||||
outline: none; box-shadow: var(--shadow-sm);
|
||||
}
|
||||
.search-box input:focus { border-color: var(--brand); box-shadow: 0 0 0 4px var(--brand-soft); }
|
||||
.search-box input::placeholder { color: var(--text-soft); }
|
||||
|
||||
.sidebar-nav { flex: 1; overflow: auto; padding: 4px 2px 0 0; }
|
||||
.nav-tree { list-style: none; margin: 0; padding: 0; }
|
||||
.nav-tree ul { list-style: none; margin: 0; padding: 0; }
|
||||
.nav-dir { margin-bottom: 4px; }
|
||||
.nav-dir-header {
|
||||
display: flex; align-items: center; gap: 8px;
|
||||
padding: 10px 12px; border-radius: 12px;
|
||||
color: var(--text-muted); font-size: 13px; font-weight: 600;
|
||||
cursor: pointer; user-select: none;
|
||||
}
|
||||
.nav-dir-header:hover { background: var(--bg-soft); color: var(--text); }
|
||||
.nav-dir-arrow { width: 14px; text-align: center; transition: transform var(--transition); color: var(--text-soft); }
|
||||
.nav-dir.collapsed .nav-dir-arrow { transform: rotate(-90deg); }
|
||||
.nav-dir-icon {
|
||||
width: 12px;
|
||||
height: 12px;
|
||||
border-radius: 4px;
|
||||
border: 1.5px solid currentColor;
|
||||
position: relative;
|
||||
flex: 0 0 auto;
|
||||
opacity: 0.75;
|
||||
}
|
||||
.nav-dir-icon::after {
|
||||
content: '';
|
||||
position: absolute;
|
||||
right: -1px;
|
||||
top: -1px;
|
||||
width: 4px;
|
||||
height: 4px;
|
||||
border-top: 1.5px solid currentColor;
|
||||
border-right: 1.5px solid currentColor;
|
||||
border-radius: 0 4px 0 0;
|
||||
transform: skew(12deg);
|
||||
}
|
||||
.nav-dir-name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
|
||||
.nav-dir-children { overflow: hidden; padding-left: 10px; }
|
||||
.nav-dir.collapsed .nav-dir-children { max-height: 0 !important; }
|
||||
|
||||
.nav-file {
|
||||
display: flex; align-items: center; gap: 10px;
|
||||
margin: 2px 0; padding: 10px 12px 10px 28px;
|
||||
border-radius: 12px; color: var(--text);
|
||||
cursor: pointer; border: 1px solid transparent;
|
||||
}
|
||||
.nav-file:hover { background: var(--bg-soft); }
|
||||
.nav-file.active {
|
||||
background: linear-gradient(180deg, rgba(58,111,247,0.12), rgba(58,111,247,0.08));
|
||||
border-color: rgba(58,111,247,0.18);
|
||||
box-shadow: 0 8px 18px rgba(58,111,247,0.08);
|
||||
}
|
||||
.nav-file-icon {
|
||||
width: 9px;
|
||||
height: 9px;
|
||||
border-radius: 50%;
|
||||
background: currentColor;
|
||||
opacity: 0.45;
|
||||
flex: 0 0 auto;
|
||||
}
|
||||
.nav-file-name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 14px; }
|
||||
.nav-hidden { display: none !important; }
|
||||
.nav-empty {
|
||||
margin: 14px 10px; padding: 18px 14px; border-radius: 16px;
|
||||
background: var(--bg-soft); color: var(--text-muted); text-align: center;
|
||||
}
|
||||
|
||||
.content {
|
||||
min-width: 0; display: flex; flex-direction: column;
|
||||
height: 100vh; overflow: hidden;
|
||||
}
|
||||
.content-toolbar {
|
||||
height: var(--toolbar-height);
|
||||
display: flex; align-items: center; justify-content: space-between;
|
||||
gap: 16px; padding: 0 18px 0 22px;
|
||||
background: var(--bg-elevated); border-bottom: 1px solid var(--border);
|
||||
backdrop-filter: blur(18px);
|
||||
}
|
||||
.toolbar-breadcrumb { display: flex; align-items: center; gap: 10px; min-width: 0; }
|
||||
.toolbar-kicker {
|
||||
display: inline-flex; align-items: center;
|
||||
padding: 5px 10px; border-radius: 999px;
|
||||
background: var(--brand-soft); color: var(--brand); font-size: 12px; font-weight: 700;
|
||||
}
|
||||
.toolbar-divider, .toolbar-title { color: var(--text-muted); font-size: 14px; }
|
||||
.toolbar-title { color: var(--text); font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
|
||||
.toolbar-actions { display: flex; align-items: center; gap: 8px; }
|
||||
.btn-icon {
|
||||
width: 38px; height: 38px; border: 1px solid transparent;
|
||||
border-radius: 12px; background: transparent; color: var(--text-muted);
|
||||
cursor: pointer; display: grid; place-items: center; font-size: 16px;
|
||||
}
|
||||
.btn-icon:hover { background: var(--bg-soft); color: var(--text); border-color: var(--border); }
|
||||
|
||||
.content-body { flex: 1; overflow: auto; }
|
||||
.empty-state {
|
||||
display: grid; place-items: center; min-height: 100%;
|
||||
padding: 32px;
|
||||
}
|
||||
.empty-card {
|
||||
max-width: 420px; width: 100%;
|
||||
padding: 32px; border-radius: 24px;
|
||||
background: var(--bg-elevated); border: 1px solid var(--border);
|
||||
box-shadow: var(--shadow-lg); text-align: center; backdrop-filter: blur(18px);
|
||||
}
|
||||
.empty-icon { font-size: 48px; margin-bottom: 16px; }
|
||||
.empty-card h2 { margin: 0 0 8px; font-size: 22px; }
|
||||
.empty-card p { margin: 0; color: var(--text-muted); line-height: 1.7; }
|
||||
|
||||
.markdown-body {
|
||||
width: min(880px, calc(100% - 48px));
|
||||
margin: 0 auto;
|
||||
padding: 36px 0 72px;
|
||||
}
|
||||
.article-layout {
|
||||
display: grid;
|
||||
grid-template-columns: minmax(0, 1fr) 230px;
|
||||
gap: 24px;
|
||||
align-items: start;
|
||||
}
|
||||
.article-header {
|
||||
padding: 22px 24px; margin-bottom: 24px;
|
||||
border: 1px solid var(--border); border-radius: 24px;
|
||||
background: var(--bg-elevated); box-shadow: var(--shadow-md); backdrop-filter: blur(18px);
|
||||
}
|
||||
.article-title {
|
||||
margin: 0 0 12px; font-size: clamp(30px, 4vw, 44px); line-height: 1.08;
|
||||
letter-spacing: -0.03em; color: var(--text);
|
||||
}
|
||||
.article-meta { display: flex; flex-wrap: wrap; gap: 10px 16px; color: var(--text-muted); font-size: 13px; }
|
||||
.article-meta-item { display: inline-flex; align-items: center; gap: 6px; padding: 6px 10px; border-radius: 999px; background: var(--bg-soft); }
|
||||
.article-body {
|
||||
font-size: 16px; line-height: 1.85; color: var(--text);
|
||||
}
|
||||
.article-body > :first-child { margin-top: 0; }
|
||||
.article-body h1, .article-body h2, .article-body h3, .article-body h4 {
|
||||
letter-spacing: -0.02em; line-height: 1.25; scroll-margin-top: 96px;
|
||||
}
|
||||
.article-body h1 { font-size: 2rem; margin: 1.5em 0 0.6em; }
|
||||
.article-body h2 {
|
||||
font-size: 1.5rem; margin: 1.8em 0 0.8em; padding-bottom: 10px;
|
||||
border-bottom: 1px solid var(--border);
|
||||
}
|
||||
.article-body h3 { font-size: 1.15rem; margin: 1.4em 0 0.65em; }
|
||||
.article-body h4, .article-body h5, .article-body h6 { font-size: 1rem; margin: 1.2em 0 0.6em; }
|
||||
.article-body p { margin: 0.85em 0; color: var(--text); }
|
||||
.article-body a { text-decoration: underline; text-decoration-color: rgba(58,111,247,0.28); text-underline-offset: 2px; }
|
||||
.article-body ul, .article-body ol { padding-left: 1.5em; margin: 0.9em 0; }
|
||||
.article-body li { margin: 0.35em 0; }
|
||||
.article-body blockquote {
|
||||
margin: 1.2em 0; padding: 14px 18px;
|
||||
border-left: 4px solid var(--brand); border-radius: 0 16px 16px 0;
|
||||
background: var(--bg-soft); color: var(--text-muted);
|
||||
}
|
||||
.article-body code {
|
||||
font-family: var(--font-mono); font-size: 0.92em;
|
||||
padding: 0.18em 0.42em; border-radius: 8px;
|
||||
background: rgba(148, 163, 184, 0.14); color: var(--text);
|
||||
}
|
||||
.article-body pre {
|
||||
margin: 1.2em 0; padding: 18px 20px;
|
||||
border-radius: 20px; overflow: auto;
|
||||
background: var(--code-bg) !important; color: var(--code-fg);
|
||||
border: 1px solid rgba(148, 163, 184, 0.12);
|
||||
box-shadow: var(--shadow-md);
|
||||
}
|
||||
.article-body pre code {
|
||||
padding: 0; background: transparent; color: inherit; font-size: 0.92rem;
|
||||
}
|
||||
.article-body table {
|
||||
width: 100%; margin: 1.2em 0; border-collapse: collapse;
|
||||
overflow: hidden; border-radius: 16px; border: 1px solid var(--border);
|
||||
}
|
||||
.article-body th, .article-body td {
|
||||
padding: 11px 14px; border-bottom: 1px solid var(--border); text-align: left;
|
||||
}
|
||||
.article-body th { background: var(--bg-soft); font-weight: 700; }
|
||||
.article-body tr:last-child td { border-bottom: 0; }
|
||||
.article-body img { max-width: 100%; height: auto; border-radius: 18px; box-shadow: var(--shadow-sm); }
|
||||
.article-body hr { margin: 2em 0; border: 0; border-top: 1px solid var(--border); }
|
||||
.article-body input[type="checkbox"] { margin-right: 8px; }
|
||||
|
||||
.toc-panel { display: none; position: sticky; top: 18px; }
|
||||
.toc-card {
|
||||
padding: 16px 14px;
|
||||
border: 1px solid var(--border);
|
||||
border-radius: 20px;
|
||||
background: var(--bg-elevated);
|
||||
box-shadow: var(--shadow-sm);
|
||||
backdrop-filter: blur(18px);
|
||||
}
|
||||
.toc-title {
|
||||
font-size: 12px;
|
||||
font-weight: 700;
|
||||
letter-spacing: 0.08em;
|
||||
text-transform: uppercase;
|
||||
color: var(--text-muted);
|
||||
margin-bottom: 12px;
|
||||
}
|
||||
.toc-nav {
|
||||
display: grid;
|
||||
gap: 4px;
|
||||
}
|
||||
.toc-link {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
padding: 8px 10px;
|
||||
border-radius: 12px;
|
||||
color: var(--text-muted);
|
||||
font-size: 13px;
|
||||
line-height: 1.35;
|
||||
}
|
||||
.toc-link:hover {
|
||||
background: var(--bg-soft);
|
||||
color: var(--text);
|
||||
}
|
||||
.toc-link.toc-level-3 { padding-left: 20px; font-size: 12.5px; }
|
||||
.toc-link.toc-level-4 { padding-left: 30px; font-size: 12px; }
|
||||
.toc-bullet {
|
||||
width: 6px;
|
||||
height: 6px;
|
||||
border-radius: 50%;
|
||||
background: currentColor;
|
||||
opacity: 0.35;
|
||||
flex: 0 0 auto;
|
||||
}
|
||||
.toc-empty-state {
|
||||
color: var(--text-muted);
|
||||
font-size: 13px;
|
||||
padding: 6px 2px 2px;
|
||||
}
|
||||
|
||||
.loading-bar {
|
||||
position: fixed; top: 0; left: 0; height: 3px; width: 0;
|
||||
background: linear-gradient(90deg, var(--brand), #38bdf8);
|
||||
z-index: 1000; pointer-events: none; transition: width 0.25s ease, opacity 0.2s ease;
|
||||
}
|
||||
.loading-bar.visible { width: 55%; }
|
||||
.loading-bar.done { width: 100%; opacity: 0; }
|
||||
|
||||
.mobile-nav-btn { display: none; }
|
||||
|
||||
::-webkit-scrollbar { width: 10px; height: 10px; }
|
||||
::-webkit-scrollbar-track { background: transparent; }
|
||||
::-webkit-scrollbar-thumb {
|
||||
background: rgba(148, 163, 184, 0.35); border-radius: 999px; border: 2px solid transparent; background-clip: content-box;
|
||||
}
|
||||
::-webkit-scrollbar-thumb:hover { background: rgba(148, 163, 184, 0.5); background-clip: content-box; }
|
||||
|
||||
@media (max-width: 900px) {
|
||||
.app { grid-template-columns: 1fr; }
|
||||
.sidebar {
|
||||
position: fixed; inset: 0 auto 0 0; z-index: 220;
|
||||
width: min(86vw, 320px); transform: translateX(-100%);
|
||||
transition: transform 220ms ease;
|
||||
box-shadow: var(--shadow-lg);
|
||||
}
|
||||
.sidebar.mobile-visible { transform: translateX(0); }
|
||||
.sidebar.collapsed { margin-left: 0; }
|
||||
.content-toolbar { padding-left: 18px; }
|
||||
.toolbar-breadcrumb { min-width: 0; }
|
||||
.markdown-body { width: min(100%, calc(100% - 28px)); padding-top: 20px; padding-bottom: 72px; }
|
||||
.article-layout { grid-template-columns: minmax(0, 1fr); }
|
||||
.toc-panel { display: none !important; }
|
||||
.article-header { padding: 20px; }
|
||||
.mobile-nav-btn {
|
||||
display: grid; place-items: center; position: fixed; right: 18px; bottom: 18px;
|
||||
width: 52px; height: 52px; border-radius: 18px;
|
||||
border: 1px solid var(--border); background: var(--bg-elevated);
|
||||
color: var(--text); box-shadow: var(--shadow-lg); z-index: 210;
|
||||
backdrop-filter: blur(18px);
|
||||
}
|
||||
}
|
||||
|
||||
[data-doc-theme="toc"] .content {
|
||||
background:
|
||||
radial-gradient(circle at top right, rgba(58, 111, 247, 0.08), transparent 28%),
|
||||
transparent;
|
||||
}
|
||||
[data-doc-theme="toc"] .markdown-body {
|
||||
width: min(1180px, calc(100% - 48px));
|
||||
}
|
||||
[data-doc-theme="toc"] .article-layout {
|
||||
grid-template-columns: minmax(0, 1fr) 240px;
|
||||
gap: 28px;
|
||||
}
|
||||
[data-doc-theme="toc"] .toc-panel { display: block; }
|
||||
[data-doc-theme="toc"] .toc-card {
|
||||
position: sticky;
|
||||
top: 18px;
|
||||
}
|
||||
|
||||
.sidebar-overlay {
|
||||
display: none; position: fixed; inset: 0; z-index: 210;
|
||||
background: rgba(2, 6, 23, 0.34); backdrop-filter: blur(4px);
|
||||
}
|
||||
@media (max-width: 900px) {
|
||||
.sidebar-overlay.visible { display: block; }
|
||||
}
|
||||
+133
@@ -0,0 +1,133 @@
|
||||
'use strict';
|
||||
|
||||
const { program } = require('commander');
|
||||
const path = require('path');
|
||||
const http = require('http');
|
||||
const net = require('net');
|
||||
const { createServer } = require('./server');
|
||||
const { createWatcher } = require('./watcher');
|
||||
|
||||
/**
|
||||
* Check if a port is available
|
||||
*/
|
||||
function isPortAvailable(port, host) {
|
||||
return new Promise((resolve) => {
|
||||
const server = net.createServer();
|
||||
server.once('error', () => resolve(false));
|
||||
server.once('listening', () => {
|
||||
server.close();
|
||||
resolve(true);
|
||||
});
|
||||
server.listen(port, host);
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Find an available port starting from the given port
|
||||
*/
|
||||
async function findAvailablePort(startPort, host) {
|
||||
let port = startPort;
|
||||
while (!(await isPortAvailable(port, host))) {
|
||||
port++;
|
||||
if (port > startPort + 100) {
|
||||
throw new Error('No available port found in range ' + startPort + '-' + (startPort + 100));
|
||||
}
|
||||
}
|
||||
return port;
|
||||
}
|
||||
|
||||
async function main() {
|
||||
program
|
||||
.name('webook')
|
||||
.description('A CLI tool to preview markdown notes in a web browser')
|
||||
.argument('[dir]', 'Root directory of your markdown notes', '.')
|
||||
.option('-p, --port <number>', 'Port to listen on (auto-detect if not specified)', '0')
|
||||
.option('-h, --host <address>', 'Host address to bind', '127.0.0.1')
|
||||
.option('-t, --title <title>', 'Site title (defaults to directory name)')
|
||||
.option('--theme <path>', 'Custom CSS theme file path')
|
||||
.option('--open', 'Automatically open in browser', false)
|
||||
.version(require('../package.json').version)
|
||||
.parse(process.argv);
|
||||
|
||||
const args = program.args;
|
||||
const opts = program.opts();
|
||||
|
||||
// Resolve directory
|
||||
const dir = path.resolve(args[0] || '.');
|
||||
|
||||
// Validate directory
|
||||
const fs = require('fs');
|
||||
if (!fs.existsSync(dir)) {
|
||||
console.error(`Error: Directory not found: ${dir}`);
|
||||
process.exit(1);
|
||||
}
|
||||
if (!fs.statSync(dir).isDirectory()) {
|
||||
console.error(`Error: Not a directory: ${dir}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
// Determine title
|
||||
const title = opts.title || path.basename(dir);
|
||||
|
||||
// Determine port
|
||||
let port = parseInt(opts.port, 10);
|
||||
if (!port || isNaN(port)) {
|
||||
port = 8000;
|
||||
}
|
||||
port = await findAvailablePort(port, opts.host);
|
||||
|
||||
// Theme
|
||||
const theme = opts.theme || null;
|
||||
|
||||
// Create Express app
|
||||
const app = createServer({ dir, title, theme, port, host: opts.host });
|
||||
|
||||
// Create HTTP server
|
||||
const server = http.createServer(app);
|
||||
|
||||
// Create file watcher
|
||||
const watcher = createWatcher(server, dir);
|
||||
|
||||
// Start server
|
||||
server.listen(port, opts.host, () => {
|
||||
const url = `http://${opts.host === '0.0.0.0' ? 'localhost' : opts.host}:${port}`;
|
||||
console.log('');
|
||||
console.log(' 📖 webook is running!');
|
||||
console.log(` 📂 Notes directory: ${dir}`);
|
||||
console.log(` 🌐 Open: ${url}`);
|
||||
console.log(` 🔄 Live reload: enabled`);
|
||||
console.log('');
|
||||
console.log(' Press Ctrl+C to stop');
|
||||
console.log('');
|
||||
|
||||
// Auto open browser
|
||||
if (opts.open) {
|
||||
const { exec } = require('child_process');
|
||||
const platform = process.platform;
|
||||
const cmd = platform === 'darwin' ? 'open' :
|
||||
platform === 'win32' ? 'start' : 'xdg-open';
|
||||
exec(`${cmd} ${url}`);
|
||||
}
|
||||
});
|
||||
|
||||
// Graceful shutdown
|
||||
function shutdown() {
|
||||
console.log('\n Shutting down...');
|
||||
watcher.close();
|
||||
server.close();
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
process.on('SIGINT', shutdown);
|
||||
process.on('SIGTERM', shutdown);
|
||||
}
|
||||
|
||||
// Auto-execute when run directly (not required by another module)
|
||||
if (!module.parent) {
|
||||
main().catch((err) => {
|
||||
console.error('Fatal error:', err.message);
|
||||
process.exit(1);
|
||||
});
|
||||
}
|
||||
|
||||
module.exports = { main };
|
||||
@@ -0,0 +1,70 @@
|
||||
'use strict';
|
||||
|
||||
const MarkdownIt = require('markdown-it');
|
||||
const hljs = require('highlight.js');
|
||||
const path = require('path');
|
||||
const fs = require('fs');
|
||||
|
||||
/**
|
||||
* Create a markdown renderer instance
|
||||
*/
|
||||
function createRenderer(notesDir) {
|
||||
const md = new MarkdownIt({
|
||||
html: true,
|
||||
linkify: true,
|
||||
typographer: true,
|
||||
breaks: false,
|
||||
highlight: function (str, lang) {
|
||||
if (lang && hljs.getLanguage(lang)) {
|
||||
try {
|
||||
return '<pre class="hljs"><code>' +
|
||||
hljs.highlight(str, { language: lang, ignoreIllegals: true }).value +
|
||||
'</code></pre>';
|
||||
} catch (__) {}
|
||||
}
|
||||
try {
|
||||
return '<pre class="hljs"><code>' +
|
||||
hljs.highlightAuto(str).value +
|
||||
'</code></pre>';
|
||||
} catch (__) {}
|
||||
return '<pre class="hljs"><code>' + md.utils.escapeHtml(str) + '</code></pre>';
|
||||
}
|
||||
});
|
||||
|
||||
// Custom image renderer: rewrite local paths to /_notes/ URLs
|
||||
const defaultImageRender = md.renderer.rules.image || function (tokens, idx, options, env, self) {
|
||||
return self.renderToken(tokens, idx, options);
|
||||
};
|
||||
|
||||
md.renderer.rules.image = function (tokens, idx, options, env, self) {
|
||||
const token = tokens[idx];
|
||||
const src = token.attrGet('src');
|
||||
if (src && !/^https?:\/\//i.test(src) && !src.startsWith('/') && !src.startsWith('data:')) {
|
||||
const fileDir = env.filePath ? path.dirname(env.filePath) : '';
|
||||
const absSrc = path.resolve(notesDir, fileDir, src);
|
||||
if (fs.existsSync(absSrc)) {
|
||||
const relSrc = path.relative(notesDir, absSrc).split(path.sep).join('/');
|
||||
token.attrSet('src', '/_notes/' + relSrc);
|
||||
}
|
||||
}
|
||||
return defaultImageRender(tokens, idx, options, env, self);
|
||||
};
|
||||
|
||||
return {
|
||||
/**
|
||||
* Render markdown content to HTML
|
||||
*/
|
||||
render(content, env = {}) {
|
||||
return md.render(content, env);
|
||||
},
|
||||
|
||||
/**
|
||||
* Get markdown-it instance (for direct use)
|
||||
*/
|
||||
getInstance() {
|
||||
return md;
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
module.exports = { createRenderer };
|
||||
+112
@@ -0,0 +1,112 @@
|
||||
'use strict';
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
/**
|
||||
* Extract title from markdown content (first h1 heading)
|
||||
*/
|
||||
function extractTitle(content, filename) {
|
||||
const match = content.match(/^#\s+(.+)$/m);
|
||||
return match ? match[1].trim() : filename.replace(/\.(md|markdown)$/i, '');
|
||||
}
|
||||
|
||||
/**
|
||||
* Count words: Chinese characters + English words
|
||||
*/
|
||||
function countWords(content) {
|
||||
const chineseChars = (content.match(/[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff]/g) || []).length;
|
||||
const englishWords = (content.match(/[a-zA-Z0-9]+/g) || []).length;
|
||||
return chineseChars + englishWords;
|
||||
}
|
||||
|
||||
function normalizeSortKey(name) {
|
||||
const volumeMatch = name.match(/^(?:第)?卷\s*([一二三四五六七八九十百千0-9]+)$/) || name.match(/^卷\s*([一二三四五六七八九十百千0-9]+)$/);
|
||||
const chapterMatch = name.match(/^第\s*([一二三四五六七八九十百千0-9]+)\s*[章节篇卷]$/);
|
||||
const numericMatch = name.match(/(\d+)/);
|
||||
const toNumber = (value) => {
|
||||
if (/^\d+$/.test(value)) return parseInt(value, 10);
|
||||
const map = { 一: 1, 二: 2, 两: 2, 三: 3, 四: 4, 五: 5, 六: 6, 七: 7, 八: 8, 九: 9, 十: 10, 百: 100, 千: 1000 };
|
||||
if (value.length === 1) return map[value] || Number.MAX_SAFE_INTEGER;
|
||||
if (value === '十') return 10;
|
||||
const digits = value.split('');
|
||||
if (digits.length === 2 && digits[0] === '十') return 10 + (map[digits[1]] || 0);
|
||||
if (digits.length === 2 && digits[1] === '十') return (map[digits[0]] || 0) * 10;
|
||||
return value.split('').reduce((sum, ch) => sum + (map[ch] || 0), 0) || Number.MAX_SAFE_INTEGER;
|
||||
};
|
||||
|
||||
if (volumeMatch) return { group: 0, value: toNumber(volumeMatch[1]), name };
|
||||
if (chapterMatch) return { group: 1, value: toNumber(chapterMatch[1]), name };
|
||||
if (numericMatch) return { group: 2, value: parseInt(numericMatch[1], 10), name };
|
||||
return { group: 3, value: name.toLocaleLowerCase('zh-CN'), name };
|
||||
}
|
||||
|
||||
function compareNames(a, b) {
|
||||
const ak = normalizeSortKey(a.name);
|
||||
const bk = normalizeSortKey(b.name);
|
||||
if (ak.group !== bk.group) return ak.group - bk.group;
|
||||
if (ak.value !== bk.value) return ak.value < bk.value ? -1 : 1;
|
||||
return a.name.localeCompare(b.name, 'zh-CN', { numeric: true, sensitivity: 'base' });
|
||||
}
|
||||
|
||||
/**
|
||||
* Recursively scan directory for markdown files
|
||||
*/
|
||||
function scanDirectory(rootPath, relativePath = '') {
|
||||
const fullPath = path.join(rootPath, relativePath);
|
||||
let entries;
|
||||
try {
|
||||
entries = fs.readdirSync(fullPath, { withFileTypes: true });
|
||||
} catch (err) {
|
||||
return [];
|
||||
}
|
||||
|
||||
const result = [];
|
||||
|
||||
for (const entry of entries) {
|
||||
// Skip hidden files/dirs and node_modules
|
||||
if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;
|
||||
|
||||
const rel = relativePath ? path.posix.join(relativePath, entry.name) : entry.name;
|
||||
|
||||
if (entry.isDirectory()) {
|
||||
const children = scanDirectory(rootPath, rel);
|
||||
if (children.length > 0) {
|
||||
result.push({
|
||||
name: entry.name,
|
||||
path: rel,
|
||||
type: 'dir',
|
||||
children
|
||||
});
|
||||
}
|
||||
} else if (entry.isFile() && /\.(md|markdown)$/i.test(entry.name)) {
|
||||
try {
|
||||
const content = fs.readFileSync(path.join(fullPath, entry.name), 'utf-8');
|
||||
const stats = fs.statSync(path.join(fullPath, entry.name));
|
||||
result.push({
|
||||
name: entry.name,
|
||||
path: rel,
|
||||
type: 'file',
|
||||
meta: {
|
||||
title: extractTitle(content, entry.name),
|
||||
created: stats.birthtime.toISOString(),
|
||||
modified: stats.mtime.toISOString(),
|
||||
wordCount: countWords(content)
|
||||
}
|
||||
});
|
||||
} catch (err) {
|
||||
// Skip files that can't be read
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Sort: directories first (alphabetical), then files (alphabetical)
|
||||
result.sort((a, b) => {
|
||||
if (a.type !== b.type) return a.type === 'dir' ? -1 : 1;
|
||||
return compareNames(a, b);
|
||||
});
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
module.exports = { scanDirectory };
|
||||
+235
@@ -0,0 +1,235 @@
|
||||
'use strict';
|
||||
|
||||
const express = require('express');
|
||||
const path = require('path');
|
||||
const fs = require('fs');
|
||||
const { scanDirectory } = require('./scanner');
|
||||
const { createRenderer } = require('./renderer');
|
||||
|
||||
/**
|
||||
* Generate the HTML page template
|
||||
*/
|
||||
function renderPage({ title, nav, theme, defaultFile, initialContent }) {
|
||||
const navJson = JSON.stringify(nav).replace(/</g, '\\u003c');
|
||||
const isTocTheme = theme === 'toc';
|
||||
const themeLink = theme && !isTocTheme
|
||||
? `<link rel="stylesheet" href="/_notes/${theme.replace(/^\/+/, '')}">`
|
||||
: '';
|
||||
const initialContentJson = initialContent
|
||||
? JSON.stringify(initialContent).replace(/</g, '\\u003c')
|
||||
: 'null';
|
||||
|
||||
return `<!DOCTYPE html>
|
||||
<html lang="zh-CN" data-theme="light" data-doc-theme="${isTocTheme ? 'toc' : 'default'}">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>${title}</title>
|
||||
<link rel="stylesheet" href="/_webook/style.css">
|
||||
<link rel="stylesheet" href="/_webook/highlight-light.css" class="theme-highlight">
|
||||
${themeLink}
|
||||
</head>
|
||||
<body>
|
||||
<div class="app" id="app">
|
||||
<aside class="sidebar" id="sidebar">
|
||||
<div class="sidebar-header">
|
||||
<a class="sidebar-brand" href="/" aria-label="返回首页">
|
||||
<span class="sidebar-brand-mark">W</span>
|
||||
<span class="sidebar-brand-text">
|
||||
<strong>${title}</strong>
|
||||
<small>文档浏览器</small>
|
||||
</span>
|
||||
</a>
|
||||
<div class="search-box">
|
||||
<input type="text" id="searchInput" placeholder="搜索文件..." autocomplete="off">
|
||||
</div>
|
||||
</div>
|
||||
<nav class="sidebar-nav" id="sidebarNav"></nav>
|
||||
</aside>
|
||||
<main class="content">
|
||||
<div class="content-toolbar">
|
||||
<div class="toolbar-breadcrumb">
|
||||
<span class="toolbar-kicker">Docs</span>
|
||||
<span class="toolbar-divider">/</span>
|
||||
<span class="toolbar-title">${title}</span>
|
||||
</div>
|
||||
<div class="toolbar-actions">
|
||||
<button class="btn-icon" id="btnToggleSidebar" title="切换侧边栏">☰</button>
|
||||
<button class="btn-icon" id="btnToggleTheme" title="切换主题">🌙</button>
|
||||
</div>
|
||||
</div>
|
||||
<div class="content-body" id="contentBody">
|
||||
<div class="empty-state" id="emptyState">
|
||||
<div class="empty-card">
|
||||
<div class="empty-icon">📘</div>
|
||||
<h2>选择左侧文件开始阅读</h2>
|
||||
<p>支持 Markdown、代码块、图片和基础排版。</p>
|
||||
</div>
|
||||
</div>
|
||||
<article class="markdown-body" id="markdownContent" style="display:none;">
|
||||
<header class="article-header" id="articleHeader">
|
||||
<h1 class="article-title" id="articleTitle"></h1>
|
||||
<div class="article-meta" id="articleMeta"></div>
|
||||
</header>
|
||||
<div class="article-layout">
|
||||
<div class="article-body" id="articleBody"></div>
|
||||
<aside class="toc-panel" id="tocPanel" aria-label="目录导航">
|
||||
<div class="toc-card">
|
||||
<div class="toc-title">目录</div>
|
||||
<nav class="toc-nav" id="tocNav"></nav>
|
||||
</div>
|
||||
</aside>
|
||||
</div>
|
||||
</article>
|
||||
</div>
|
||||
</main>
|
||||
</div>
|
||||
<div class="loading-bar" id="loadingBar"></div>
|
||||
<div class="mobile-nav-btn" id="mobileNavBtn">☰</div>
|
||||
<script>
|
||||
window.__WEBOOK__ = {
|
||||
nav: ${navJson},
|
||||
defaultFile: ${JSON.stringify(defaultFile || null)},
|
||||
initialContent: ${initialContentJson}
|
||||
};
|
||||
</script>
|
||||
<script src="/_webook/app.js"></script>
|
||||
<script src="/_webook/live-reload.js"></script>
|
||||
</body>
|
||||
</html>`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Create and start the webook server
|
||||
*/
|
||||
function createServer(opts) {
|
||||
const {
|
||||
dir,
|
||||
title,
|
||||
theme,
|
||||
port,
|
||||
host
|
||||
} = opts;
|
||||
|
||||
const app = express();
|
||||
const renderer = createRenderer(dir);
|
||||
|
||||
// Serve webook public assets (CSS, JS)
|
||||
app.use('/_webook', express.static(path.join(__dirname, '..', 'public')));
|
||||
|
||||
// Serve notes directory as static files (for images, attachments, custom theme CSS)
|
||||
app.use('/_notes', express.static(dir));
|
||||
|
||||
// API: Get navigation tree
|
||||
app.get('/api/nav', (req, res) => {
|
||||
try {
|
||||
const nav = scanDirectory(dir);
|
||||
res.json({ success: true, data: nav });
|
||||
} catch (err) {
|
||||
res.status(500).json({ success: false, error: err.message });
|
||||
}
|
||||
});
|
||||
|
||||
// API: Get rendered file content
|
||||
app.get('/api/file', (req, res) => {
|
||||
try {
|
||||
const filePath = req.query.path;
|
||||
if (!filePath) {
|
||||
return res.status(400).json({ success: false, error: 'Missing path parameter' });
|
||||
}
|
||||
|
||||
// Security: prevent directory traversal
|
||||
const safePath = path.normalize(filePath).replace(/^(\.\.(\/|\\|$))+/, '');
|
||||
const fullPath = path.join(dir, safePath);
|
||||
|
||||
if (!fullPath.startsWith(path.resolve(dir))) {
|
||||
return res.status(403).json({ success: false, error: 'Access denied' });
|
||||
}
|
||||
|
||||
if (!fs.existsSync(fullPath)) {
|
||||
return res.status(404).json({ success: false, error: 'File not found' });
|
||||
}
|
||||
|
||||
if (!/\.(md|markdown)$/i.test(fullPath)) {
|
||||
return res.status(400).json({ success: false, error: 'Not a markdown file' });
|
||||
}
|
||||
|
||||
const content = fs.readFileSync(fullPath, 'utf-8');
|
||||
const stats = fs.statSync(fullPath);
|
||||
|
||||
// Render markdown to HTML
|
||||
const env = { filePath: safePath };
|
||||
const html = renderer.render(content, env);
|
||||
|
||||
// Extract metadata
|
||||
const match = content.match(/^#\s+(.+)$/m);
|
||||
const title = match ? match[1].trim() : path.basename(filePath, path.extname(filePath));
|
||||
|
||||
// Count words
|
||||
const chineseChars = (content.match(/[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff]/g) || []).length;
|
||||
const englishWords = (content.match(/[a-zA-Z0-9]+/g) || []).length;
|
||||
|
||||
res.json({
|
||||
success: true,
|
||||
data: {
|
||||
title,
|
||||
html,
|
||||
meta: {
|
||||
created: stats.birthtime.toISOString(),
|
||||
modified: stats.mtime.toISOString(),
|
||||
wordCount: chineseChars + englishWords,
|
||||
fileName: path.basename(filePath)
|
||||
}
|
||||
}
|
||||
});
|
||||
} catch (err) {
|
||||
res.status(500).json({ success: false, error: err.message });
|
||||
}
|
||||
});
|
||||
|
||||
// Main page
|
||||
app.get('/', (req, res) => {
|
||||
try {
|
||||
const nav = scanDirectory(dir);
|
||||
// Try to find a README.md or index.md as default
|
||||
const defaultFiles = ['README.md', 'readme.md', 'index.md', 'INDEX.md'];
|
||||
let initialContent = null;
|
||||
let defaultFile = null;
|
||||
|
||||
for (const df of defaultFiles) {
|
||||
const dfPath = path.join(dir, df);
|
||||
if (fs.existsSync(dfPath)) {
|
||||
defaultFile = df;
|
||||
const content = fs.readFileSync(dfPath, 'utf-8');
|
||||
const env = { filePath: df };
|
||||
const html = renderer.render(content, env);
|
||||
const stats = fs.statSync(dfPath);
|
||||
const match = content.match(/^#\s+(.+)$/m);
|
||||
const dfTitle = match ? match[1].trim() : df.replace(/\.md$/i, '');
|
||||
const chineseChars = (content.match(/[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff]/g) || []).length;
|
||||
const englishWords = (content.match(/[a-zA-Z0-9]+/g) || []).length;
|
||||
|
||||
initialContent = {
|
||||
title: dfTitle,
|
||||
html,
|
||||
meta: {
|
||||
created: stats.birthtime.toISOString(),
|
||||
modified: stats.mtime.toISOString(),
|
||||
wordCount: chineseChars + englishWords,
|
||||
fileName: df
|
||||
}
|
||||
};
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
res.send(renderPage({ title, nav, theme, defaultFile, initialContent }));
|
||||
} catch (err) {
|
||||
res.status(500).send(`<h1>Error</h1><pre>${err.message}</pre>`);
|
||||
}
|
||||
});
|
||||
|
||||
return app;
|
||||
}
|
||||
|
||||
module.exports = { createServer };
|
||||
@@ -0,0 +1,82 @@
|
||||
'use strict';
|
||||
|
||||
const chokidar = require('chokidar');
|
||||
const { WebSocketServer } = require('ws');
|
||||
|
||||
/**
|
||||
* Create file watcher and WebSocket server for live reload
|
||||
*/
|
||||
function createWatcher(httpServer, dir) {
|
||||
const wss = new WebSocketServer({ server: httpServer, path: '/_ws' });
|
||||
|
||||
// Track connected clients
|
||||
const clients = new Set();
|
||||
|
||||
wss.on('connection', (ws) => {
|
||||
clients.add(ws);
|
||||
|
||||
ws.on('close', () => {
|
||||
clients.delete(ws);
|
||||
});
|
||||
|
||||
ws.on('error', () => {
|
||||
clients.delete(ws);
|
||||
});
|
||||
});
|
||||
|
||||
// Broadcast reload message to all clients
|
||||
function broadcast(event) {
|
||||
const msg = JSON.stringify(event);
|
||||
for (const ws of clients) {
|
||||
try {
|
||||
if (ws.readyState === 1) { // WebSocket.OPEN
|
||||
ws.send(msg);
|
||||
}
|
||||
} catch (e) {
|
||||
// ignore
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Watch for file changes
|
||||
const watcher = chokidar.watch(dir, {
|
||||
ignored: [
|
||||
/(^|[\/\\])\../, // dotfiles
|
||||
/node_modules/,
|
||||
/\.git/
|
||||
],
|
||||
persistent: true,
|
||||
ignoreInitial: true,
|
||||
awaitWriteFinish: {
|
||||
stabilityThreshold: 300,
|
||||
pollInterval: 100
|
||||
}
|
||||
});
|
||||
|
||||
let debounceTimer;
|
||||
|
||||
watcher.on('all', (event, filePath) => {
|
||||
// Only trigger reload for markdown files and assets
|
||||
if (/\.(md|markdown|css|js|png|jpg|jpeg|gif|svg|webp|ico)$/i.test(filePath)) {
|
||||
clearTimeout(debounceTimer);
|
||||
debounceTimer = setTimeout(() => {
|
||||
broadcast({ type: 'reload', file: filePath, event });
|
||||
}, 200);
|
||||
}
|
||||
});
|
||||
|
||||
watcher.on('error', (err) => {
|
||||
console.error('Watcher error:', err.message);
|
||||
});
|
||||
|
||||
return {
|
||||
watcher,
|
||||
wss,
|
||||
close() {
|
||||
watcher.close();
|
||||
wss.close();
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
module.exports = { createWatcher };
|
||||
@@ -0,0 +1,9 @@
|
||||
# 我的笔记库
|
||||
|
||||
欢迎来到我的知识库!这里记录了我的学习笔记和思考。
|
||||
|
||||
## 目录
|
||||
|
||||
- [编程笔记](./编程/)
|
||||
- [读书笔记](./阅读/)
|
||||
- [工具使用](./工具/)
|
||||
@@ -0,0 +1,35 @@
|
||||
# Git 常用命令
|
||||
|
||||
## 基础操作
|
||||
|
||||
| 命令 | 说明 |
|
||||
|------|------|
|
||||
| `git init` | 初始化仓库 |
|
||||
| `git clone <url>` | 克隆仓库 |
|
||||
| `git add .` | 暂存所有更改 |
|
||||
| `git commit -m "msg"` | 提交更改 |
|
||||
| `git push` | 推送到远程 |
|
||||
| `git pull` | 拉取远程更新 |
|
||||
|
||||
## 分支管理
|
||||
|
||||
```bash
|
||||
# 创建并切换到新分支
|
||||
git checkout -b feature/new-feature
|
||||
|
||||
# 查看所有分支
|
||||
git branch -a
|
||||
|
||||
# 合并分支
|
||||
git merge feature/new-feature
|
||||
|
||||
# 删除分支
|
||||
git branch -d feature/new-feature
|
||||
```
|
||||
|
||||
## 撤销操作
|
||||
|
||||
- `git reset HEAD <file>` - 取消暂存
|
||||
- `git checkout -- <file>` - 撤销文件修改
|
||||
- `git revert <commit>` - 撤销某次提交
|
||||
- `git reset --soft HEAD~1` - 撤销最近一次 commit(保留更改)
|
||||
@@ -0,0 +1,64 @@
|
||||
# JavaScript 基础
|
||||
|
||||
JavaScript 是一种轻量级的解释型编程语言,支持面向对象、命令式和声明式编程。
|
||||
|
||||
## 数据类型
|
||||
|
||||
JavaScript 有以下几种基本数据类型:
|
||||
|
||||
- `Number` - 数字
|
||||
- `String` - 字符串
|
||||
- `Boolean` - 布尔值
|
||||
- `null` - 空值
|
||||
- `undefined` - 未定义
|
||||
- `Symbol` - 符号(ES6)
|
||||
- `BigInt` - 大整数
|
||||
|
||||
## 代码示例
|
||||
|
||||
```javascript
|
||||
// Hello World
|
||||
function greet(name) {
|
||||
return `Hello, ${name}!`;
|
||||
}
|
||||
|
||||
console.log(greet('World'));
|
||||
|
||||
// 箭头函数
|
||||
const add = (a, b) => a + b;
|
||||
console.log(add(1, 2)); // 3
|
||||
```
|
||||
|
||||
## Promise 和 async/await
|
||||
|
||||
```javascript
|
||||
// Promise 示例
|
||||
function fetchData(url) {
|
||||
return fetch(url)
|
||||
.then(response => response.json())
|
||||
.then(data => console.log(data))
|
||||
.catch(error => console.error('Error:', error));
|
||||
}
|
||||
|
||||
// async/await 写法
|
||||
async function fetchDataAsync(url) {
|
||||
try {
|
||||
const response = await fetch(url);
|
||||
const data = await response.json();
|
||||
console.log(data);
|
||||
} catch (error) {
|
||||
console.error('Error:', error);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 数组方法
|
||||
|
||||
| 方法 | 描述 | 返回值 |
|
||||
|------|------|--------|
|
||||
| `map()` | 映射每个元素 | 新数组 |
|
||||
| `filter()` | 过滤元素 | 新数组 |
|
||||
| `reduce()` | 累加计算 | 单个值 |
|
||||
| `forEach()` | 遍历元素 | undefined |
|
||||
|
||||
> **提示**: 使用现代 JavaScript 特性可以让代码更简洁易读。
|
||||
@@ -0,0 +1,43 @@
|
||||
# Python 学习笔记
|
||||
|
||||
Python 是一门优雅且强大的编程语言。
|
||||
|
||||
## 基本语法
|
||||
|
||||
```python
|
||||
# 列表推导式
|
||||
squares = [x**2 for x in range(10)]
|
||||
print(squares) # [0, 1, 4, 9, 16, 25, 36, 49, 64, 81]
|
||||
|
||||
# 字典推导式
|
||||
word_lengths = {word: len(word) for word in ['hello', 'world', 'python']}
|
||||
print(word_lengths)
|
||||
```
|
||||
|
||||
## 装饰器
|
||||
|
||||
```python
|
||||
def timer(func):
|
||||
def wrapper(*args, **kwargs):
|
||||
import time
|
||||
start = time.time()
|
||||
result = func(*args, **kwargs)
|
||||
print(f"{func.__name__} took {time.time() - start:.4f}s")
|
||||
return result
|
||||
return wrapper
|
||||
|
||||
@timer
|
||||
def slow_function():
|
||||
import time
|
||||
time.sleep(1)
|
||||
return "Done"
|
||||
|
||||
print(slow_function())
|
||||
```
|
||||
|
||||
## 常用库
|
||||
|
||||
1. **NumPy** - 科学计算
|
||||
2. **Pandas** - 数据分析
|
||||
3. **Flask** - Web 框架
|
||||
4. **Requests** - HTTP 请求
|
||||
@@ -0,0 +1,29 @@
|
||||
# 如何阅读一本书
|
||||
|
||||
> 阅读是一门艺术,需要刻意练习。
|
||||
|
||||
## 阅读的四个层次
|
||||
|
||||
### 1. 基础阅读
|
||||
这个层次解决的是"这个句子在说什么?"的问题。
|
||||
|
||||
### 2. 检视阅读
|
||||
在一定时间内,抓住一本书的重点。
|
||||
|
||||
- **有系统的略读**: 看书名、序言、目录、索引
|
||||
- **粗浅的阅读**: 从头到尾先读一遍
|
||||
|
||||
### 3. 分析阅读
|
||||
全盘、完整、优质的阅读,追寻理解。
|
||||
|
||||
### 4. 主题阅读
|
||||
阅读多本书,列举它们之间的相关之处。
|
||||
|
||||
## 做笔记的方法
|
||||
|
||||
- 画底线
|
||||
- 在空白处做星号或其他符号
|
||||
- 在空白处编号
|
||||
- 在空白处记下其他页码
|
||||
- 将关键字或句子圈出来
|
||||
- 在书页空白处做笔记
|
||||
Reference in New Issue
Block a user