文水鱼文集外观库

投稿

把你的那套交上来

走 GitHub issue,一个表单,四个必填项。审核过了会自动进库、自动生成页面,不用你手动建目录。

表单里要填什么

  • 作者——你的 GitHub 用户名,会署在页面和 README 上
  • 名称——2 到 8 个字,别人在卡片上看到的就是它
  • 简介——一句话,说清它什么感觉。可选,但强烈建议写,没简介的卡片看起来很可怜
  • 希望分类——只是意向,最终归类我来定。注意「推荐」不开放
  • JS 内容——用 ```js 代码块包住贴进来;超过 40 KB 就贴 raw 链接

最小可用的一套

三行就够了,其余全部沿用内置的「纸墨」:

三行的例子
// 暖色阅读
主色: #8C5A2B
底色: #F7F1E6
圆角: 12

想动更多?用脚本写法

文件里定义了 function theme(api) 就按脚本执行。能调变量、注入样式、换图标:

脚本写法
function theme(api) {
  api.setVar('--accent', '#7C5CFF');
  api.setVar('--r', '14px');

  api.css(`
    .card { transition: transform .25s ease; }
    .card:hover { transform: translateY(-2px); }
  `);

  api.icon('book', '<path d="M4 5h16v14H4z"/>');
}

会被直接拒的写法

不是审美问题,是安全问题。命中任意一条,自动审核就挂了,改完再关一次 issue 会重审:

  • eval()、new Function() 动态执行
  • fetch() / XMLHttpRequest / new Image() 上报数据
  • 读写 document.cookie、localStorage
  • 动态插入 <script>、iframe
  • 改 location、window.open、postMessage
  • 监听 keydown / input 之类的输入事件
  • 从不明域名加载脚本或样式

审核大概多久

机器人几分钟内会回一条评论,列出规则命中的项和模型读完之后的意见。之后等我点—— 快的时候当天,慢的时候一周。收进库之后你会收到一条评论,里面是文件路径和页面地址。

想提 PR 也行

目录名必须是内容哈希,自己手算容易错。真要提,先本地跑 node scripts/validate-all.mjs,PR 上会跑同一套校验。 更省事的办法还是走 issue,机器人会把哈希算好、目录建好。