Nasrif30/THE-PWNED-ARCHIVE

# THE PWNED ARCHIVE 一个优质、静态的网络安全作品集与 writeup 归档。在无框架或数据库的情况下构建，完全由 GitHub Pages 和静态 JSON 文件驱动。 ## 项目结构 * `assets/` - 包含头像和 favicon 等全局资源。 * `assets/icons/` - 整个界面中使用的 SVG 图标。 * `assets/screenshots/` - 用于存储挑战截图的目录，按 machine slug 组织。 * `content/` - 包含每个挑战或 machine 实际 writeup 的 Markdown 文件。 * `entries/` - 每个挑战的 JSON 元数据文件（标题、平台、标签等）。 * `data/` - 包含用于驱动侧边栏和个人主页的 `profile.json`。 * `css/` - 所有样式表，按功能划分（变量、布局、组件等）。 * `js/` - 原生 JavaScript 逻辑（路由、归档加载、分析、终端等）。 * `index.html` - 单页应用入口点。 ## 安装与本地测试 1. 将仓库克隆到本地机器。 2. 在项目目录中打开终端。 3. 启动本地 HTTP 服务器。例如，使用 Python： `python -m http.server 3000` 4. 在 Web 浏览器中导航至 `http://localhost:3000`。 ## GitHub Pages 部署 该站点专为直接在 GitHub Pages 上托管而设计。 1. 将此仓库推送到你的 GitHub 账号。 2. 进入仓库的 Settings。 3. 在左侧边栏导航至 "Pages" 部分。 4. 在 "Build and deployment" 下，将 Source 设置为 "Deploy from a branch"。 5. 选择 `main` 分支和 `/ (root)` 文件夹。 6. 保存配置。GitHub 将自动构建并部署你的站点。 ## 如何添加 Room 或 Machine 添加新条目完全基于文件。你无需修改任何 JavaScript 或 HTML。 1. **创建元数据：** 在 `entries/` 目录中创建一个新的 JSON 文件（例如 `entries/my-new-machine.json`）。遵循现有条目的结构。 2. **创建 Writeup：** 在 `content/` 目录中创建相应的 Markdown 文件（例如 `content/my-new-machine.md`）。此文件应在你 JSON 元数据的 `writeup` 键中被引用。 3. **添加截图（可选）：** 在 `assets/screenshots/` 中创建一个与你的 machine slug 同名的文件夹。将图片添加到那里，并在 JSON 文件的 `screenshots` 数组中列出它们的路径。 4. 提交并将更改推送到 GitHub。站点将自动更新。 ## 如何自定义个人资料 编辑 `data/profile.json` 文件。此文件控制你的姓名、handle、简介、学习重点、位置、认证和社交媒体链接。网站将动态更新以反映这些更改。 ## 主题配置 该网站包含一个内置的深色和浅色模式切换功能，可自动保存用户的偏好设置。要调整主题的特定颜色或美学效果，请修改位于 `css/variables.css` 中的 CSS 变量。该设计采用了受 Apple 启发的玻璃拟态美学。

标签：CMS安全, GitHub Pages, Homebrew安装, JavaScript, 前端, 博客, 多模态安全, 网络安全, 自定义脚本, 防御加固, 隐私保护, 静态网站