{"id":13552160,"url":"https://github.com/xianmin/hugo-theme-jane","last_synced_at":"2025-04-12T20:38:46.113Z","repository":{"id":30148196,"uuid":"124070868","full_name":"xianmin/hugo-theme-jane","owner":"xianmin","description":"A readable \u0026 concise theme for Hugo, color schemes to choose, easy to personalize. Working well since 2018.","archived":false,"fork":false,"pushed_at":"2025-03-16T23:53:24.000Z","size":4369,"stargazers_count":951,"open_issues_count":61,"forks_count":288,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-05T19:06:58.158Z","etag":null,"topics":["hugo","hugo-blog-theme","hugo-site","hugo-theme","theme"],"latest_commit_sha":null,"homepage":"https://xianmin.github.io/hugo-theme-jane/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xianmin.png","metadata":{"files":{"readme":"README-zh.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-03-06T11:48:50.000Z","updated_at":"2025-03-29T02:37:13.000Z","dependencies_parsed_at":"2024-08-01T12:20:02.157Z","dependency_job_id":"4dcf8c86-d256-466f-b9da-c7900bc7cf3e","html_url":"https://github.com/xianmin/hugo-theme-jane","commit_stats":{"total_commits":406,"total_committers":56,"mean_commits":7.25,"dds":0.3374384236453202,"last_synced_commit":"1e476ccc61156dc87443f7011cd114a64491b4e1"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xianmin%2Fhugo-theme-jane","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xianmin%2Fhugo-theme-jane/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xianmin%2Fhugo-theme-jane/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xianmin%2Fhugo-theme-jane/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xianmin","download_url":"https://codeload.github.com/xianmin/hugo-theme-jane/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248631668,"owners_count":21136554,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["hugo","hugo-blog-theme","hugo-site","hugo-theme","theme"],"created_at":"2024-08-01T12:01:59.892Z","updated_at":"2025-04-12T20:38:46.074Z","avatar_url":"https://github.com/xianmin.png","language":"CSS","funding_links":[],"categories":["HTML","others"],"sub_categories":[],"readme":"![jane-preview](https://raw.githubusercontent.com/xianmin/hugo-theme-jane/master/images/preview.png)\n\n\n## hugo-theme-jane\n\nJane 是一个专注于阅读体验的 Hugo 主题。最早的版本基于 [hugo-theme-even](https://github.com/olOwOlo/hugo-theme-even) ，在它的基础上进行了重新改造。\n\n[Demo](http://en.xianmin.org/hugo-theme-jane/) | [我的博客](http://www.xianmin.org)\n\n**主要特色：**\n\n- 响应式设计\n- 多国语言支持\n- 支持多个 Shortcode\n- 单独设计的 *标签页* 和 *分类页*\n- 社交网站链接\n- 更好的分页、目录、注脚样式\n- 使用更快的 Chroma 代码高亮\n- 自定义 css，自定义 js，自定义 head\n- 子目录支持\n- 搜索优化\n\n\n## 谁在用 Hugo-theme-Jane\n\n- [ATFeng](https://www.gooth.org/) - A beautiful blog fork from Jane.\n- [Jack Baty's Blog](https://www.baty.net/) - Thousands of posts on the site powered by Hugo \u0026 Theme Jane.\n- [Notes on Blue Skies](https://terrty.net) - Personal blog in Russian by @paskal\n- [贤民的比特记忆](http://www.xianmin.org/) - A Chinese blog.\n- [虞双齐爱折腾](https://yushuangqi.com/) - @ysqi 个人技术博客.\n- [茶歇驿站](https://maiyang.me/) - Go 爱好者，开源爱好者，Go 夜读发起人 @yangwenmai.\n- [Time](https://ifttl.com/) - 个人博客\n- [碎裂之梦](https://h-cheung.gitlab.io/) - 计院学生，开源爱好者，ACM新手\n- Waiting to add more...\n\n\n## 如何使用？\n\n**注意：** 这个教程假设你 **第一次** 使用 [Hugo][] 。 [Hugo][] 是一个非常流行的静态网站生成工具。 你可查看官方文档 [Hugo Official Docs][] 获取更多帮助。\n\n[Hugo]: https://gohugo.io/\n[Hugo Official Docs]: https://gohugo.io/getting-started/\n\n\n\n### 1. 快速安装 Hugo\n\n从 [Hugo Releases](https://github.com/gohugoio/hugo/releases) 上直接下载安装适合你的版本。\n\n\n\n### 2. 快速创建网站\n\n```bash\nhugo new site myBlog\n```\n\n上面的命令将会在一个名为 `myBlog`  的文件夹中创建一个新的 hugo 站点。\n\n\n\n### 3. 快速使用 Hugo-Theme-Jane\n\n把这个主题克隆到 `themes` 文件夹\n\n```bash\ncd myBlog\ngit clone https://github.com/xianmin/hugo-theme-jane.git --depth=1 themes/jane\n```\n\n复制一些示例文本：\n\n```bash\ncp -r themes/jane/exampleSite/content ./\n```\n\n复制默认的站点设置：\n\n```bash\ncp themes/jane/exampleSite/config.toml ./\n```\n\n启动 hugo server ：\n\n```bash\nhugo server\n```\n\n打开 http://localhost:1313/ ，你将会看到一个示例网站。\n\n\n\n### 4. 开始你的博客\n\n默认配置文件 `config.toml` 位于你的网站的根目录，请按自身需要进行定制。\n\n默认的文章文件位于 `./content/post` 目录。\n\n\n\n### 5. 生成你的网站\n\n直接运行 `hugo` ，将会自动生成你的网站到 `public/` 目录。\n\n如果你有额外的时间，并且想更多的了解 [Hugo][] ，请查阅官方文档 [Hugo Official Docs][] 。\n\n\n\n## 站点设置\n\n不妨看一看 [exampleSite](https://github.com/xianmin/hugo-theme-jane/tree/master/exampleSite) 文件夹中的文件。\n\n这个目录包含一个示例 `config.toml` 文件和一些示例文章。\n\n将 `config.toml` 复制到你的网站根目录。按自身需要进行修改。\n\n\n\n## 单篇文章的设置\n\n**Front Matter** : Hugo 允许你使用 yaml， toml 或者 json 语法在你每一篇文章的开头进行设置。\n\n**YAML 示例：**\n\n```yaml\n---\n# 常用定义\ntitle: \"An Example Post\"           # 标题\ndate: 2018-01-01T16:01:23+08:00    # 创建时间\nlastmod: 2018-01-02T16:01:23+08:00 # 最后修改时间\ndraft: false                       # 是否是草稿？\ntags: [\"tag-1\", \"tag-2\", \"tag-3\"]  # 标签\ncategories: [\"index\"]              # 分类\nauthor: \"xianmin\"                  # 作者\n\n# 用户自定义\n# 你可以选择 关闭(false) 或者 打开(true) 以下选项\ncomment: false   # 关闭评论\ntoc: false       # 关闭文章目录\n# 你同样可以自定义文章的版权规则\ncontentCopyright: '\u003ca rel=\"license noopener\" href=\"https://creativecommons.org/licenses/by-nc-nd/4.0/\" target=\"_blank\"\u003eCC BY-NC-ND 4.0\u003c/a\u003e'\nreward: false\t # 关闭打赏\nmathjax: true    # 打开 mathjax\n---\n```\n\n\n\n## 多语言支持\n\nHugo-Theme-Jane 支持创建多语言网站。\n\n你需要为你的网站对 `languages` 进行配置。\n\n翻译位于 `i18n/` 文件夹下。\n\n使用特定的翻译：\n\n```toml\n# 使用中文\ndefaultContentLanguage = \"zh-cn\"  # 默认使用的语言\n[Languages.zh-cn]\n  languageCode = \"zh-cn\"\n```\n\n有关多语言设置，请查看 [Multilingual Mode | Hugo](https://gohugo.io/content-management/multilingual/) 。\n\n\n\n## 怎样开发？\n\n使用 `npm` 安装依赖：\n\n```bash\nnpm install\n```\n\n然后：\n\n```bash\nnpm run dev\n```\n\n这条命令会同时运行  `webpack --watch` 和 `hugo server`  。 如果你修改了任何文件，浏览器将会自动更新。\n\n\n\n## License\n\nHugo-theme-jane is licensed under the MIT license. Check the [LICENSE](LICENSE.md) file for details.\n\n\n# Stackbit\n\nThis theme is ready to import into Stackbit. This theme can be deployed to Netlify and you can connect any headless CMS including Forestry, NetlifyCMS, DatoCMS or Contentful. \n\n[![Create with Stackbit](https://assets.stackbit.com/badge/create-with-stackbit.svg)](https://app.stackbit.com/create?theme=https://github.com/xianmin/hugo-theme-jane)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxianmin%2Fhugo-theme-jane","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxianmin%2Fhugo-theme-jane","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxianmin%2Fhugo-theme-jane/lists"}