FOSS 0XND

一个专用的大型项目模版,参考了Haproxy 的页面风格。

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-descriptionheader.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.htmlwww/news.htmlwww/download.html

修改 www/ 下任何文件后 fossil commit;修改 skin/ 文件在开发模式下直接生效,正式发布需 fossil configuration push skin(见 INSTALL.md)。


协议

本项目以 MIT License 发布,欢迎 fork / 二改。