Files in the top-level directory from the latest check-in of branch trunk
- skin
- www
- INSTALL.md
- LICENSE
- README.md
FOSS 0XND
一个专用的大型项目模版,参考了 HAProxy 的页面风格,基于 Fossil SCM 做版本管理与站点托管。
项目开箱即用:克隆仓库、fossil server 起一个端口,即可得到一个紧凑、信息密度高、扫读友好的项目主页,功能包括最新版本表、News、下载矩阵、联系方式,全部以独立 HTML 片段存放于 www/,单独编辑不影响皮肤。
特性
- HAProxy 风格皮肤:纯深蓝品牌条 / 钢蓝章节条 / Times 衬线字体 / 紧凑表格
- 四文件皮肤架构:严格遵循 Fossil 的
header.txt / footer.txt / css.txt / details.txt - 模块化首页:
www/index.html自持 HTML chrome,通过<iframe>内嵌versions.html / news.html / download.html,编辑单个章节无需动皮肤 - TH1 动态导航:
header.txt用 TH1 根据登录态 / 权限位生成左侧 Quick links - 相对路径:首页所有链接采用相对路径,既支持本地根路径又支持远程
/<repo>/子路径 - 响应式:窄视口下自动折叠成单列
目录结构
foss-0xnd/
├── README.md 本文件
├── LICENSE MIT 许可
├── INSTALL.md 安装与部署说明
├── skin/ Fossil 皮肤源文件(四件套)
│ ├── header.txt 顶栏 + 侧栏 + 内容容器开启(TH1 导航)
│ ├── footer.txt 收尾 + 版权 + 渲染耗时
│ ├── css.txt HAProxy 风格整套样式
│ ├── details.txt 皮肤元数据(字体色、时间线样式等)
│ └── logo.svg 默认项目 Logo(顶栏右侧)
└── www/ 首页与模块化片段(Fossil 嵌入文档)
├── index.html 自持 HAProxy chrome 的首页骨架
├── versions.html 最新版本表
├── news.html 快讯条目
└── download.html 下载矩阵
快速开始
# 克隆现有仓库
fossil clone https://fos.5550110.xyz/foss-0xnd foss-0xnd.fossil
mkdir checkout && cd checkout
fossil open ../foss-0xnd.fossil
# 开发模式:直接加载 skin/ 目录,修改即刷
fossil server ../foss-0xnd.fossil --skin ./skin --port 8788 --localhost
open http://localhost:8788/
详细部署(启用 index-page、把皮肤写进 config、推送到远程)见 INSTALL.md。
定制
| 想改什么 | 改哪里 |
|---|---|
| 顶栏标题 / 描述 | Fossil 设置 project-name / project-description,header.txt 里自动读取 |
| 顶栏 Logo | skin/logo.svg,写入仓库 config 的 logo-image 后由 /logo 提供 |
| 配色 / 字体 / 栅格 | skin/css.txt |
| 顶栏 DOM / 侧栏结构 | skin/header.txt |
| 导航项 | skin/header.txt 里的 TH1 菜单块 |
| 首页章节 / 顺序 | www/index.html 里的 <section class="module"> |
| 版本表 / News / 下载矩阵内容 | www/versions.html、www/news.html、www/download.html |
修改 www/ 下任何文件后 fossil commit;修改 skin/ 文件在开发模式下直接生效,正式发布需 fossil configuration push skin(见 INSTALL.md)。
协议
本项目以 MIT License 发布,欢迎 fork / 二改。