{"id":26022117,"url":"https://github.com/x1ah/gena","last_synced_at":"2026-01-22T09:39:17.364Z","repository":{"id":45154261,"uuid":"357963837","full_name":"x1ah/gena","owner":"x1ah","description":"导航网站生成器(Start page generator)","archived":false,"fork":false,"pushed_at":"2022-10-30T10:34:03.000Z","size":2296,"stargazers_count":69,"open_issues_count":3,"forks_count":18,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-06T09:58:57.228Z","etag":null,"topics":["nav","navigation","navigation-generator","startpage","startpage-generator","webstack"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/x1ah.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":null,"support":null}},"created_at":"2021-04-14T16:01:19.000Z","updated_at":"2025-02-28T02:33:41.000Z","dependencies_parsed_at":"2022-07-13T18:19:50.623Z","dependency_job_id":null,"html_url":"https://github.com/x1ah/gena","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":"xiachufang/go-skeleton","purl":"pkg:github/x1ah/gena","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x1ah%2Fgena","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x1ah%2Fgena/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x1ah%2Fgena/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x1ah%2Fgena/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/x1ah","download_url":"https://codeload.github.com/x1ah/gena/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/x1ah%2Fgena/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28660770,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"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":["nav","navigation","navigation-generator","startpage","startpage-generator","webstack"],"created_at":"2025-03-06T09:54:23.736Z","updated_at":"2026-01-22T09:39:17.359Z","avatar_url":"https://github.com/x1ah.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# gena\n\n导航网站生成器 | [English Document](https://github.com/x1ah/gena/blob/master/README_EN.md)\n\n![Test](https://github.com/x1ah/gena/workflows/Test/badge.svg) ![Lint](https://github.com/x1ah/gena/workflows/Lint/badge.svg) [![Go Report Card](https://goreportcard.com/badge/github.com/x1ah/gena)](https://goreportcard.com/report/github.com/x1ah/gena) [![goproxy.cn](https://goproxy.cn/stats/github.com/x1ah/gena/badges/download-count.svg)](https://github.com/x1ah/gena)\n\n---\n\n![image](https://user-images.githubusercontent.com/14919255/116836115-ec9e4800-abf7-11eb-9a83-82eb379c130d.png)\n\n## 简介\n\n`gena` 是一个用 Go 语言编写的导航网站生成器，可以通过简单的 YAML 配置文件快速生成美观的导航网站。支持多种模板主题，适合个人、团队或组织使用。\n\n### 特性\n\n- 🚀 **快速生成**：通过 YAML 配置文件快速生成静态 HTML 网站\n- 🎨 **多种模板**：支持 webstack、tilde-enhanced 等多种精美模板\n- 📱 **响应式设计**：所有模板均支持移动端访问\n- 🔍 **搜索功能**：支持多种搜索引擎（webstack 模板）\n- ⌨️ **键盘导航**：支持快捷键快速访问网站（tilde 模板）\n- 🎯 **简单易用**：只需一个配置文件即可生成完整网站\n- 📦 **单文件部署**：生成的 HTML 文件可独立部署到任何静态托管服务\n\n## 安装\n\n### 一键生成（**推荐**）\n\n从 [gena-template](https://github.com/x1ah/gena-template) 自动生成并自动部署到 GitHub Pages\n\n### 源码安装\n\n**go1.21+ required**\n\n```bash\ngo get -u github.com/x1ah/gena/cmd/gena\n```\n\n或者克隆仓库后编译：\n\n```bash\ngit clone https://github.com/x1ah/gena.git\ncd gena\ngo build -o gena ./cmd/gena\n```\n\n查看帮助信息：\n\n```bash\ngena --help\n```\n\n输出：\n```\nUsage of ./gena:\n  -c string\n    \tConfig file (default \"config.yml\")\n```\n\n### 可执行文件下载\n\n从 [Release page](https://github.com/x1ah/gena/releases) 下载对应平台的可执行文件\n\n## 快速开始\n\n### 1. 创建配置文件\n\n参照 [config.yml](https://github.com/x1ah/gena/blob/master/config.yml) 创建你自己的配置文件：\n\n```yaml\n# 网站标题\ntitle: 我的导航站\n\n# 网站描述\ndescription: 我的个人导航网站\n\n# 网站图标\nfavicon: https://example.com/favicon.ico\n\n# 网站 URL\nurl: https://example.com\n\n# GitHub 链接（可选）\ngithub: https://github.com/yourname\n\n# 页脚信息\nfooter: © 2024 My Navigation\n\n# 选择模板：webstack 或 tilde\ntemplate: webstack\n\n# 网站内容\ncontent:\n  categories:\n    - name: 常用网站\n      sites:\n        - name: GitHub\n          description: 代码托管平台\n          url: https://github.com/\n          icon: https://github.com/favicon.ico\n        - name: Google\n          description: 搜索引擎\n          url: https://www.google.com/\n```\n\n### 2. 生成网站\n\n```bash\ngena -c config.yml \u003e index.html\n```\n\n### 3. 预览\n\n直接在浏览器中打开生成的 `index.html` 文件即可预览效果。\n\n## 模板说明\n\n### webstack 模板\n\n基于 [WebStack](http://webstack.cc/) 设计的精美导航模板，适合展示大量网站链接。\n\n**特性：**\n- 侧边栏分类导航\n- 支持多种搜索引擎\n- 响应式设计\n- 夜间模式支持\n- 图标懒加载\n\n**配置示例：**\n\n```yaml\ntemplate: webstack\n\nwebstack:\n  search:\n    enabled: true\n    default: google\n    engines:\n      - google\n      - github\n      - baidu\n      - bing\n```\n\n### tilde 模板\n\n基于 [tilde-enhanced](https://github.com/Ozencb/tilde-enhanced) 的极简起始页模板，支持键盘快速导航。\n\n**特性：**\n- 极简设计，专注内容\n- 键盘快捷键导航（输入首字母快速跳转）\n- 支持搜索功能\n- 支持 URL 直接访问\n- 支持特殊命令（如 `invert!` 切换主题）\n- 深色/浅色主题切换\n\n**配置示例：**\n\n```yaml\ntemplate: tilde\n\ntilde:\n  search:\n    url: https://duckduckgo.com/?q=\n    placeholder: \"Search or enter URL\"\n  theme: dark  # dark 或 light\n  show_keys: false  # 是否显示键盘快捷键\n```\n\n**使用技巧：**\n- 输入网站名称的首字母，按回车快速访问\n- 输入 `?` 查看帮助\n- 输入 `invert!` 切换主题\n- 输入 `[数字]!` 启动对应分类的所有网站\n- 输入 `[key]:[query]` 在指定网站搜索\n- 输入 `[key]/[path]` 访问网站特定路径\n- 直接输入 URL 或域名访问\n\n## 配置说明\n\n### 基础配置\n\n| 字段 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `title` | string | 是 | 网站标题 |\n| `description` | string | 是 | 网站描述 |\n| `template` | string | 是 | 模板名称：`webstack` 或 `tilde` |\n| `url` | string | 否 | 网站 URL |\n| `favicon` | string | 否 | 网站图标 URL |\n| `github` | string | 否 | GitHub 链接 |\n| `footer` | string | 否 | 页脚信息 |\n| `google_analytics` | string | 否 | Google Analytics ID |\n\n### 内容配置\n\n```yaml\ncontent:\n  categories:\n    - name: 分类名称\n      sites:\n        - name: 网站名称\n          description: 网站描述\n          url: https://example.com\n          icon: https://example.com/icon.png  # 可选，不填则自动获取\n```\n\n### webstack 模板配置\n\n```yaml\nwebstack:\n  search:\n    enabled: true              # 是否启用搜索\n    default: google            # 默认搜索引擎\n    engines:                   # 可用的搜索引擎列表\n      - google\n      - github\n      - baidu\n      - bing\n      # ... 更多搜索引擎\n```\n\n支持的搜索引擎：`google`, `baidu`, `bing`, `sougou`, `taobao`, `jd`, `tmall`, `zhihu`, `weibo`, `bilibili`, `douban`, `github`\n\n### tilde 模板配置\n\n```yaml\ntilde:\n  search:\n    url: https://duckduckgo.com/?q=  # 搜索 URL\n    placeholder: \"Search or enter URL\"  # 搜索框占位符\n  theme: dark  # 主题：dark 或 light\n  show_keys: false  # 是否显示键盘快捷键（true 显示按键，false 显示图标）\n```\n\n## 部署\n\n### GitHub Pages\n\n1. 将生成的 `index.html` 推送到 GitHub 仓库\n2. 在仓库设置中启用 GitHub Pages\n3. 选择主分支的根目录作为源\n\n### 其他静态托管服务\n\n生成的 `index.html` 是纯静态文件，可以部署到任何静态托管服务：\n\n- [Netlify](https://www.netlify.com/)\n- [Vercel](https://vercel.com/)\n- [Cloudflare Pages](https://pages.cloudflare.com/)\n- 自己的服务器\n\n## 使用案例\n\n- [when.run/nav](https://when.run/nav/) - 使用 webstack 模板的导航站\n\n## 开发\n\n### 运行测试\n\n```bash\ngo test ./...\n```\n\n### 代码检查\n\n```bash\ngolangci-lint run\n```\n\n### 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 交流群\n\n|QQ 群|\n|:--:|\n|群号：100916933\u003cbr\u003e\u003cimg src=\"https://user-images.githubusercontent.com/14919255/118518920-372cd200-b76b-11eb-8271-0ee04e8df04c.jpeg\" height=\"350px\" /\u003e|\n\n## 许可证\n\n本项目采用 MIT 许可证，详见 [LICENSE](LICENSE) 文件。\n\n## 致谢\n\n- [WebStack](http://webstack.cc/) - webstack 模板设计\n- [tilde-enhanced](https://github.com/Ozencb/tilde-enhanced) - tilde 模板设计\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx1ah%2Fgena","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fx1ah%2Fgena","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx1ah%2Fgena/lists"}