{"id":26033278,"url":"https://github.com/attajak/fixit-bundle-gitmodule","last_synced_at":"2025-08-03T14:33:40.331Z","repository":{"id":275067756,"uuid":"922446918","full_name":"attajak/fixit-bundle-gitmodule","owner":"attajak","description":"Hugo FixIt Bundle (Gitmodule)​","archived":false,"fork":false,"pushed_at":"2025-03-05T19:51:41.000Z","size":88,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-05T20:49:19.767Z","etag":null,"topics":["fixit","fixit-bundle","gitmodules","hugo"],"latest_commit_sha":null,"homepage":"https://attajak.github.io/hugo-fixit-bundle/","language":"TOML","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/attajak.png","metadata":{"files":{"readme":"README.cn.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-26T08:25:15.000Z","updated_at":"2025-03-05T19:51:44.000Z","dependencies_parsed_at":"2025-03-05T02:18:33.059Z","dependency_job_id":"4de19209-06f8-4dd5-9b21-17e71e5ce1be","html_url":"https://github.com/attajak/fixit-bundle-gitmodule","commit_stats":null,"previous_names":["attajak/hugo-fixit-test","attajak/hugo-fixit-bundle","attajak/fixit-bundle-gitmodule"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/attajak%2Ffixit-bundle-gitmodule","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/attajak%2Ffixit-bundle-gitmodule/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/attajak%2Ffixit-bundle-gitmodule/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/attajak%2Ffixit-bundle-gitmodule/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/attajak","download_url":"https://codeload.github.com/attajak/fixit-bundle-gitmodule/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242309921,"owners_count":20106737,"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":["fixit","fixit-bundle","gitmodules","hugo"],"created_at":"2025-03-07T00:40:43.345Z","updated_at":"2025-03-07T00:40:43.853Z","avatar_url":"https://github.com/attajak.png","language":"TOML","readme":"# Hugo FixIt 博客模板（Git）\n\n👉 中文 | [English](README.en.md)\n\n这是 Hugo 主题 [FixIt](https://github.com/hugo-fixit/FixIt) 的快速启动模板。它使用 [Git 子模块](https://git-scm.com/book/en/v2/Git-Tools-Submodules) 功能来加载主题。如果你更熟悉 Go，可以 [查看这个模板](https://github.com/hugo-fixit/hugo-fixit-starter)。\n\n它提供了基本的主题结构和配置。已经设置了 GitHub Actions，可以自动部署博客到 GitHub Pages。此外，还有一个定时任务，每天自动更新主题。\n\n## 目录结构\n\n```bash\n▸ .github/       # GitHub configuration\n▸ archetypes/    # page archetypes (like scaffolds of archetypes)\n▸ assets/        # css, js, third-party libraries etc.\n▸ config/        # configuration files\n▸ content/       # markdown files for hugo project\n▸ data/          # blog data (allow: yaml, json, toml), e.g. friends.yml\n▸ public/        # build directory\n▸ static/        # static files, e.g. favicon.ico\n▸ themes/        # theme submodules\n```\n\n## 快速入门\n\n完整的快速入门请参阅此 [页面](https://fixit.lruihao.cn/documentation/getting-started/)。\n\n### 准备\n\n[Hugo](https://gohugo.io/installation/): \u003e= 0.132.0 (extended version)\n\n### 使用此模板\n\n#### CLI\n\n```bash\nnpx fixit-cli create my-blog\n```\n\n#### 手动\n\n1. 点击 [**Use this template**](https://github.com/hugo-fixit/hugo-fixit-starter1/generate)，在 GitHub 上创建你的仓库。\n\n    \u003cimg width=\"913\" alt=\"image\" src=\"https://github.com/hugo-fixit/hugo-fixit-starter1/assets/33419593/d5fbd940-3ffd-4750-b1e6-4e87b50b0696\"\u003e\n\n2. 仓库创建后，只需克隆并开始使用！\n\n    ```bash\n    # 使用你自己的仓库 URL 进行克隆\n    git clone --recursive https://github.com/\u003cyour_name\u003e/\u003cyour_blog_repo\u003e.git\n    ```\n\n\u003e [!TIP]\n\u003e 仓库名决定了你的 GitHub Pages URL，例如：\n\u003e\n\u003e | 仓库名 | GitHub Pages |\n\u003e | :--- | :--- |\n\u003e | `\u003cyour_name\u003e.github.io` | `https://\u003cyour_name\u003e.github.io/` |\n\u003e | `blog` | `https://\u003cyour_name\u003e.github.io/blog/` |\n\n### 启动站点\n\n```bash\n# 开发环境\nhugo server\n# 生产环境\nhugo server -e production\n```\n\n### 构建站点\n\n当你的站点准备部署时，运行以下命令：\n\n```bash\nhugo\n```\n\n### 部署到 GitHub Pages\n\n\u003e [!NOTE]\n\u003e 聪明的你可能已经注意到，模板初始化后的第一次 GitHub Actions 自动部署失败了。这是因为你还没有配置 Workflow 权限和 GitHub Pages。\n\n1. 转到 Setting =\u003e Actions =\u003e General =\u003e Workflow permissions =\u003e 选中 \"Read and write permissions\"。\n2. GitHub Pages 设置：Setting =\u003e Pages =\u003e Source: GitHub Actions。\n3. 修改 `config/_default/hugo.toml` 文件中的 `baseURL` 为你的站点 URL。\n4. 提交上一步的修改到 `main` 分支，GitHub Actions 将自动打包并部署站点到 GitHub Pages。\n\n### 更新主题\n\n之后，你可以使用以下命令升级主题：\n\n```bash\n# 手动更新主题\ngit submodule update --remote --merge themes/FixIt\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003e通过 NPM 脚本启动\u003c/summary\u003e\n\n  ```bash\n  npm install\n  # 构建博客\n  npm run build\n  # 运行带有监视的本地调试服务器\n  npm run server\n  # 在生产环境中运行本地调试服务器\n  npm run server:production\n  # 更新主题子模块\n  npm run update:theme\n  ```\n\n\u003c/details\u003e\n\n## 故障排除\n\n\u003cdetails\u003e\n  \u003csummary\u003eremote: Permission to git denied to github-actions[bot].\u003c/summary\u003e\n  转到 Setting =\u003e Actions =\u003e General =\u003e Workflow permissions =\u003e 选中 \"Read and write permissions\"。\n\u003c/details\u003e\n\n\u003c!-- 该项目是使用 [hugo-fixit-starter1](https://github.com/hugo-fixit/hugo-fixit-starter1) 生成的。 --\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fattajak%2Ffixit-bundle-gitmodule","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fattajak%2Ffixit-bundle-gitmodule","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fattajak%2Ffixit-bundle-gitmodule/lists"}