{"id":46080184,"url":"https://github.com/little-gt/theme-roricaltheme","last_synced_at":"2026-05-31T12:00:42.227Z","repository":{"id":326226023,"uuid":"1084779140","full_name":"little-gt/THEME-RoricalTheme","owner":"little-gt","description":"一款充满活力的 Typecho 主题，基于 Agron 设计开发，现由 little-gt 继续持续维护和更新。","archived":false,"fork":false,"pushed_at":"2026-05-31T05:36:16.000Z","size":13713,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-31T06:19:51.834Z","etag":null,"topics":["typecho","typecho-theme"],"latest_commit_sha":null,"homepage":"https://blog.garfieldtom.cool","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/little-gt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-28T06:31:18.000Z","updated_at":"2026-05-31T05:36:20.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/little-gt/THEME-RoricalTheme","commit_stats":null,"previous_names":["little-gt/theme-roricaltheme"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/little-gt/THEME-RoricalTheme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/little-gt%2FTHEME-RoricalTheme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/little-gt%2FTHEME-RoricalTheme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/little-gt%2FTHEME-RoricalTheme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/little-gt%2FTHEME-RoricalTheme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/little-gt","download_url":"https://codeload.github.com/little-gt/THEME-RoricalTheme/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/little-gt%2FTHEME-RoricalTheme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33730241,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["typecho","typecho-theme"],"created_at":"2026-03-01T15:14:51.382Z","updated_at":"2026-05-31T12:00:42.215Z","avatar_url":"https://github.com/little-gt.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌸 Rorical Theme for Typecho\n\n\u003e 简洁 · 可爱 · 功能强大\n\u003e\n\u003e 一款为 Typecho 打造的现代化卡片式主题。基于 Argon 设计，并且重构了系统的功能函数以及运行逻辑，支持无插件依赖的阅读统计以及 Cookie 管理器。\n\n[![Rorical](https://img.shields.io/badge/版本-1.2.12-007EC6?style=for-the-badge)](https://github.com/little-gt/THEME-RoricalTheme/) [![License](https://img.shields.io/badge/许可证-GPLv3-blue?style=for-the-badge)](https://www.gnu.org/licenses/gpl-3.0.html) [![Argon](https://img.shields.io/badge/设计支持-Argon-orange?style=for-the-badge\u0026logo=Argon)](https://demos.creative-tim.com/argon-design-system/)\n\n主题预览：\n\n![预览1](screenshot/图片1.jpg)\n\n![预览2](screenshot/图片2.jpg)\n\n![预览3](screenshot/图片3.jpg)\n\n参与讨论：\n\n[Typecho 官方论坛主题帖](https://forum.typecho.org/viewtopic.php?t=25572)\n\n---\n\n## ✨ 特点概览\n\n| 功能模块 | 说明 |\n| :-- | :-- |\n| **轻快交互** | PowerMode 打字特效、鼠标点击涟漪、AJAX 评论与搜索 |\n| **文章增强** | 自动 TOC 目录、阅读统计、字数统计、评论计数 |\n| **兼容优化** | 完全支持 Typecho 1.2.1-1.3.0 / PHP 7.4-8.3 / MySQL 8.X-9.X |\n| **高度自定义** | 独立页面图标与配色、自定义导航栏样式、双端背景、LOGO 设置 |\n| **现代化设计** | 基于 Argon Design System 与 Bootstrap 4，响应式支持多端展示 |\n| **归属地展示** | 评论区 IP 归属展示（依赖 [XQLocation](https://www.toubiec.cn/1194.html)） |\n| **Cookie合规** | 支持 GDPR/最新2026年执行的中国网络安全规范的 Cookie 同意模式 |\n| **评论管理** | 扁平化评论结构、回复提及功能、未登录用户权限控制 |\n| **隐私政策** | 支持自定义隐私政策页面 URL |\n\n---\n\n## 🚀 近期更新\n\n### 🛠️ 功能与性能优化\n- **PJAX 页面变量声明修复**：统一使用 `var page = X` 声明页面标识变量，避免 PJAX 局部刷新时出现 \"Identifier 'page' has already been declared\" 错误\n\n### ⚠️ 重要变更\n- **评论系统简化**：出于兼容性和稳定性考虑，移除了复杂的嵌套评论功能。现采用扁平化评论结构，所有评论按时间顺序显示。此调整：\n  - ✅ 提升了跨版本兼容性（Typecho 1.2.1-1.3.0）\n  - ✅ 减少了 PHP 版本依赖问题（PHP 7.4-8.3）\n  - ✅ 简化了代码维护，提高了稳定性\n  - ✅ 保留了回复功能，用户仍可使用 @ 提及进行互动\n\n---\n\n## ⚙️ 安装指南\n\n1. **下载主题**\n   ```bash\n   git clone https://github.com/little-gt/THEME-RoricalTheme.git\n   ```\n   或直接下载 ZIP 压缩包上传至：\n   ```\n   /usr/themes/RoricalTheme/\n   ```\n\n2. **启用主题**\n\n   * 登录 Typecho 后台 → 外观 → 启用 “Rorical Theme”，并且配置 Rorical Theme 主题的自定义选项。\n\n3. **依赖插件**\n\n   * 安装 [XQLocation](https://www.toubiec.cn/1194.html) 插件以启用 IP 归属显示功能。\n\n---\n\n## 🎨 独立页面图标与颜色配置\n\n\u003e 为导航栏下拉菜单中的独立页面设置专属图标与背景色。\n\n在 Typecho 后台编辑页面时添加自定义字段：\n\n| 字段名     | 示例值                   | 说明                  |\n| :------ | :-------------------- | :------------------ |\n| `color` | `bg-gradient-success` | 设置图标圆形背景色           |\n| `icon`  | `ni-spaceship`        | 设置图标样式（Nucleo Icon） |\n\n**可用颜色值表**\n\n请务必填写下面参考的可用颜色值，否则菜单栏图标的背景颜色将不会正常显示。\n\n| 字段值                   | 颜色效果 |\n| :-------------------- | :--- |\n| `bg-gradient-success` | 绿色   |\n| `bg-gradient-danger`  | 红色   |\n| `bg-gradient-info`    | 蓝色   |\n| `bg-gradient-primary` | 紫色   |\n| `bg-gradient-warning` | 橙色   |\n| `bg-gradient-default` | 灰紫色  |\n\n**可用图标值说明**\n\n请访问 Creative Tim 的 Argon 前端框架的 ICONS 参考值文档，复制文档中对应的值。\n\n[Argon Icons Reference](https://demos.creative-tim.com/argon-design-system/docs/foundation/icons.html)\n\n---\n\n## 🔗 友情链接页面配置\n\n\u003e 使用 `friends.php` 自定义模板创建精美的友情链接展示页面。\n\n### 📝 创建步骤\n\n1. **创建独立页面**\n   - 登录 Typecho 后台 → 管理 → 独立页面 → 新建页面\n\n2. **选择自定义模板**\n   - 在页面编辑器右侧（或底部）找到\"高级选项\"\n   - 在\"自定义模板\"下拉框中选择 **\"友情链接\"**\n\n3. **添加友链内容**\n   - 在页面内容区域使用以下 HTML 格式添加友链数据：\n\n```html\n\u003cdiv id=\"list\"\u003e\n    \u003cul\u003e\n        \u003cli class=\"title\"\u003e网站名称\u003c/li\u003e\n        \u003cli class=\"url\"\u003ehttps://example.com\u003c/li\u003e\n        \u003cli class=\"img\"\u003ehttps://example.com/logo.png\u003c/li\u003e\n        \u003cli class=\"dec\"\u003e网站描述文字\u003c/li\u003e\n    \u003c/ul\u003e\n    \u003c!-- 可以添加多个 \u003cul\u003e 块来展示多个友链 --\u003e\n\u003c/div\u003e\n```\n\n### 📋 字段说明\n\n| 字段 | 必填 | 说明 |\n|:-----|:----:|:-----|\n| `li.title` | 是 | 友链网站名称 |\n| `li.url` | 是 | 友链网站地址（支持 http/https） |\n| `li.img` | 否 | 网站 Logo 或头像图片 URL（留空则使用随机图片） |\n| `li.dec` | 否 | 网站简短描述（建议 20 字以内） |\n\n### 🎨 显示效果\n\n- 自动以卡片式布局展示（每行 4 个，响应式适配）\n- 支持 Logo 圆形头像展示\n- 鼠标悬停卡片上浮效果\n- 点击在新标签页打开友链网站\n\n### ⚠️ 注意事项\n\n- **安全性**：所有字段内容会自动进行 XSS 过滤，防止恶意代码注入\n- **图片优化**：建议使用正方形图片（推荐 200x200px），自动居中裁剪\n- **性能**：页面会自动应用图片懒加载，提升访问速度\n\n---\n\n## 🍪 Cookie 合规功能配置\n\n### 关于 Cookie 合规功能\n\n为了适配 Cookie 管理器功能，需要你新建一个名为“隐私政策”的独立页面，其 URL 形为`example.com/privacy.html`，或者你可以替换`footer.php`下面的代码到特定的隐私政策页面上：\n\n```php\n\u003c?php $this-\u003eoptions-\u003esiteUrl('./privacy.html'); ?\u003e\n```\n\n### 使用 Cookie 合规功能\n\n你可以在 HTML 中随意混合使用外部引用 JS 和内嵌 JS 这两种类型的可选择的 JavaScript，脚本都会自动处理。\n\n**自动清理**：执行后移除 `data-consent-category` 属性，防止混淆。\n\n**通用适配**：支持 `src`、`async`、`defer` 等属性的复制。\n\n#### 1. 外部引用 JS (如引入某个特效库)\n```html\n\u003cscript type=\"text/plain\"\n        data-consent-category=\"functional\"\n        src=\"/path/to/afunction.js\"\u003e\u003c/script\u003e\n```\n\n#### 2. 外部引用 JS (带 async/defer 属性)\n```html\n\u003cscript type=\"text/plain\"\n        data-consent-category=\"analytics\"\n        src=\"https://www.googletagmanager.com/gtag/js?id=XXX\"\n        async\u003e\u003c/script\u003e\n```\n\n#### 3. 内嵌 JS (如初始化代码)\n```html\n\u003cscript type=\"text/plain\" data-consent-category=\"functional\"\u003e\n    console.log(\"功能性脚本已加载\");\n    myFunction.init();\n\u003c/script\u003e\n```\n\n---\n\n## 🎯 主题配置功能\n\n### 🔒 评论权限控制\n\n在 Typecho 后台 → 控制台 → 外观 → 主题设置 → **访客评论设置**：\n\n- **允许未登录用户评论**（默认）：所有访客都可以发表评论\n- **禁止未登录用户评论**：只有登录用户才能评论\n\n**安全特性：**\n- ✅ 前端表单控制 - 未登录用户看不到评论表单\n- ✅ 后端权限验证 - 服务器端二次校验，防止绕过前端提交\n- ✅ AJAX 请求保护 - 返回 JSON 错误响应\n- ✅ 403 状态码 - 符合 HTTP 标准的权限拒绝\n\n#### 自定义禁止评论提示\n\n在 **禁止访客评论提示** 文本框中，你可以自定义提示信息。支持使用占位符：\n\n- `%loginUrl%` - 会自动替换为登录页面链接\n\n**示例：**\n```\n抱歉，本站仅允许登录用户发表评论。请先\u003ca href=\"%loginUrl%\" class=\"text-white\" style=\"text-decoration: underline;\"\u003e登录\u003c/a\u003e您的账户。\n```\n\n### 🔗 自定义隐私政策链接\n\n在主题设置 → **隐私政策链接** 中，你可以设置隐私政策页面的 URL：\n\n**支持的格式：**\n- 相对路径：`./privacy.html` 或 `/privacy.html`\n- 完整 URL：`https://example.com/privacy`\n- 独立页面：创建一个名为\"隐私政策\"的独立页面，然后填入其 URL\n\n该链接会在以下位置显示：\n- Cookie 同意横幅\n- Cookie 设置弹窗\n\n---\n\n## 📢 特效交互控制\n\n* ✅ PowerMode 打字特效（评论区）\n* ✅ 评论区 Cookie 同意提示\n* ✅ 鼠标点击涟漪动画\n* ✅ Lazyload 图片懒加载\n* ✅ AJAX 评论与搜索（PJAX 技术）\n* ✅ 无刷新的一致性浏览体验\n\n---\n\n## 🧱 使用的组件\n\n| 组件         | 描述                             |\n| :---------- | :----------------------------- |\n| **框架**     | Bootstrap 4, jQuery 3.3.1       |\n| **设计系统** | Argon Design System            |\n| **图标库**   | Nucleo Icons, Font Awesome 4.7  |\n| **异步交互** | PJAX                           |\n| **渲染优化** | Lazyload.js                    |\n\n---\n\n## ❤️ 开源与支持\n\n\u003e 如果你喜欢这个项目，请点个 ⭐ Star 支持我们！\n\n* **设计师**：[@Rorical](https://github.com/Rorical/RoricalTheme)\n* **维护者**：[@little-gt](https://github.com/little-gt/THEME-RoricalTheme)\n\n---\n\n**Rorical Theme** — 让博客更活泼、更有趣。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flittle-gt%2Ftheme-roricaltheme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flittle-gt%2Ftheme-roricaltheme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flittle-gt%2Ftheme-roricaltheme/lists"}