news.html 0000755 0000000 0000000 00000000000 15242273147 0012301 5 ustar 00nobody nobody news.html/INSTALL.md 0000644 0000000 0000000 00000010604 15242273147 0014011 0 ustar 00nobody nobody # 安装与部署
本文档介绍三种使用方式：
1. **本地开发** —— 实时加载 `skin/` 目录调样；
2. **写入本仓库** —— 把皮肤烤进仓库 config，使 `fossil server ` 直接生效；
3. **推送到远程** —— 让线上的 Fossil 实例启用同样的皮肤。
> 前置要求：Fossil ≥ 2.22（本仓库在 2.28 验证通过）。
> 检查版本：`fossil version`
---
## 1. 本地开发模式（推荐改皮肤时使用）
```bash
# 取仓库
fossil clone https://fos.5550110.xyz/foss-0xnd foss-0xnd.fossil
mkdir checkout && cd checkout
fossil open ../foss-0xnd.fossil
# --skin 让 Fossil 直接读 skin/ 下的四个 .txt
fossil server ../foss-0xnd.fossil --skin ./skin --port 8788 --localhost
```
打开 [http://localhost:8788/](http://localhost:8788/)，修改 `skin/*.txt` 保存后浏览器强刷（⌘⇧R）即可看到变化，无需重启。
> `www/index.html` 里引用的 `../../../style.css?v=hapN` 带了指纹，修改 CSS 后把 `N` 递增一下浏览器才会重新抓。
---
## 2. 把皮肤写进本地 repo 的 config 表
开发完成后，一次性把 4 个皮肤文件写入 config，之后用 `fossil server ` 不再需要 `--skin`：
```bash
fossil sql "
INSERT OR REPLACE INTO config(name, value, mtime) VALUES
('css', readfile('skin/css.txt'), strftime('%s','now')),
('header', readfile('skin/header.txt'), strftime('%s','now')),
('footer', readfile('skin/footer.txt'), strftime('%s','now')),
('details', readfile('skin/details.txt'), strftime('%s','now')),
('logo-mimetype', 'image/svg+xml', strftime('%s','now')),
('logo-image', readfile('skin/logo.svg'), strftime('%s','now'));
"
```
同时设置首页（指向自持的 HAProxy 首页骨架）：
```bash
fossil sql "
INSERT OR REPLACE INTO config(name, value, mtime)
VALUES ('index-page', '/doc/tip/www/index.html', strftime('%s','now'));
"
```
验证：
```bash
fossil sql "SELECT name, length(value) FROM config
WHERE name IN ('css','header','footer','details','logo-image','logo-mimetype','index-page');"
```
---
## 3. 推送到远程 Fossil 实例
**关键点**：Fossil 的 `config` 表默认 **不随 `fossil sync` 自动传播**，必须显式 `configuration push`。
```bash
# 推皮肤（css / header / footer / details / logo-image 等皮肤相关键）
fossil configuration push skin
# 推项目级设置（project-name / project-description / index-page 等）
fossil configuration push project
```
执行前请确认：
- 本地 `fossil remote-url` 指向目标远程；
- 你在远程有 **Admin（s）** 权限（否则拒绝）。
推送成功后访问远程：
```bash
curl -sI https://fos.5550110.xyz/foss-0xnd/ # 应 302 到 /doc/tip/www/index.html
curl -s https://fos.5550110.xyz/foss-0xnd/style.css | head -5
```
浏览器 **强制刷新** 即可看到新皮肤（⌘⇧R / Ctrl+F5）。
---
## 常见问题
### Q1. 远程样式没加载 / 链接 404
确认首页使用的是相对路径（`../../../style.css`、`../../../timeline` 等），不要写 `/style.css`。因为线上 Fossil 常挂在 `//` 子路径下，绝对 `/` 会跳到域名根而不是仓库根。
### Q2. 改了 CSS 浏览器还是旧样式
`www/index.html` 的 `` 末尾带 `?v=hapN` 版本号，改 CSS 时递增 `N`（比如 `hap5` → `hap6`）并重新 commit 即可穿透浏览器缓存。皮肤里的 `header.txt` 则通过 `puts [utime]` 已经自动防缓存。
### Q3. `fossil configuration push` 报 `not authorized`
远程用户需要 Admin（`s`）权限才能接受 config 推送。去线上 `/setup_ulist` 给你的账号加 `s` 位。
### Q4. 如何把皮肤当命名皮肤另存（便于切换）
```bash
# Fossil ≥ 2.19 原生 skin 子命令可用：
fossil skin save haproxy # 把当前 config 存成命名皮肤 haproxy
fossil skin current # 查看当前皮肤
fossil skin list # 列出所有命名皮肤
```
> 本仓库验证时用的 2.28 没有 `skin` 子命令（取决于构建配置），直接操作 `config` 表最稳。
---
## 卸载 / 回滚
恢复默认皮肤：
```bash
fossil configuration reset skin
```
取消自定义首页：
```bash
fossil sql "DELETE FROM config WHERE name='index-page';"
```
删除追踪的 `www/` 嵌入文档（如需要）：
```bash
fossil rm www/
fossil commit -m "Revert homepage assets"
```
news.html/LICENSE 0000644 0000000 0000000 00000002052 15242273147 0013364 0 ustar 00nobody nobody MIT License
Copyright (c) 2026 FOSS 0XND
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
news.html/README.md 0000644 0000000 0000000 00000006400 15242273147 0013637 0 ustar 00nobody nobody # FOSS 0XND
一个专用的大型项目模版，参考了 HAProxy 的页面风格，基于 [Fossil SCM](https://fossil-scm.org/) 做版本管理与站点托管。
项目开箱即用：克隆仓库、`fossil server` 起一个端口，即可得到一个紧凑、信息密度高、扫读友好的项目主页，功能包括最新版本表、News、下载矩阵、联系方式，全部以独立 HTML 片段存放于 `www/`，单独编辑不影响皮肤。
---
## 特性
- **HAProxy 风格皮肤**：纯深蓝品牌条 / 钢蓝章节条 / Times 衬线字体 / 紧凑表格
- **四文件皮肤架构**：严格遵循 Fossil 的 `header.txt / footer.txt / css.txt / details.txt`
- **模块化首页**：`www/index.html` 自持 HTML chrome，通过 `
Quick News
Description
This repository hosts a high-performance, distributed project
tracked with Fossil SCM. The home page follows
the layout conventions popularized by the HAProxy project
page — a dense, scan-friendly dashboard that surfaces the
latest releases, news, downloads, and contact information in a
single scroll.
All content blocks below are loaded from modular HTML fragments
checked into www/, so editing a single section does
not require touching the skin.
Performance
Fossil is engineered to remain responsive on repositories with
hundreds of thousands of commits. Typical clone / sync
operations complete in sub-second latencies over SSH or HTTPS,
and the built-in SQLite storage keeps memory usage flat.
Reliability
Every artifact in the repository is content-addressed and
cryptographically verified on read. The append-only design
means history is effectively immutable; accidental loss
requires corrupting the underlying single-file database.
Security — Hardened by default
Role-based capability bits gate every web endpoint. The built-in
HTTP server supports TLS termination, CSRF protection on forms,
and anti-robot heuristics on anonymous traffic.