{"id":24645221,"url":"https://github.com/Protomyst/Hugo-PaperMod-Deploy","last_synced_at":"2025-10-07T04:32:16.992Z","repository":{"id":272633140,"uuid":"917103104","full_name":"Protomyst/Hugo-PaperMod-Deploy","owner":"Protomyst","description":"使用 Github Pages 快速搭建博客 / 文档网站：保持专注于内容创作","archived":false,"fork":false,"pushed_at":"2025-01-30T07:48:43.000Z","size":524,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T04:49:52.892Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://2024365.xyz","language":"Python","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/Protomyst.png","metadata":{"files":{"readme":null,"changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-01-15T11:07:57.000Z","updated_at":"2025-03-13T13:06:02.000Z","dependencies_parsed_at":"2025-01-15T19:19:58.421Z","dependency_job_id":"9ec2e2b3-0b30-4179-89fe-d1a3723dbc04","html_url":"https://github.com/Protomyst/Hugo-PaperMod-Deploy","commit_stats":null,"previous_names":["protomyst/easy-blog","protomyst/hugo-papermod-deploy"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Protomyst/Hugo-PaperMod-Deploy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protomyst%2FHugo-PaperMod-Deploy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protomyst%2FHugo-PaperMod-Deploy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protomyst%2FHugo-PaperMod-Deploy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protomyst%2FHugo-PaperMod-Deploy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Protomyst","download_url":"https://codeload.github.com/Protomyst/Hugo-PaperMod-Deploy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Protomyst%2FHugo-PaperMod-Deploy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278722656,"owners_count":26034459,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"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":[],"created_at":"2025-01-25T14:14:32.028Z","updated_at":"2025-10-07T04:32:16.986Z","avatar_url":"https://github.com/Protomyst.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Easy-Blog\n## 先看效果：[**DEMO**](https://2024365.xyz/)\n![网站图片](assets/image-3.png)\n**干干净净，简简单单**\n\n---\n这个方案的核心价值是：\n\n- 降低门槛：任何人都可以快速开始\n- 节省时间：避免在配置上浪费时间\n- 保持专注：把精力放在内容创作上\n\u003e **“最好的工具是你意识不到它的存在的工具。”**\n\n这个方案就是为此而设计：让你专注于写作，而不是工具配置。开始使用只需要：\n\n1. 复制工作流文件  \n2. 新建 Markdown 文件  \n3. 开始写作  \n\n就是这么简单。\n\n虽然默认配置简单，但保留了扩展空间：\n\n- 可以自定义主题样式\n- 支持添加评论系统\n- 已集成搜索功能\n- 支持自定义域名\n\n---\n\n## 一、准备工作\n### 创建 GitHub 账号\n- 访问 GitHub 注册账号  \n- 完成邮箱验证\n\n    **恕不赘述**\n### 创建新仓库\n- 点击右上角 “+” \u003e “New repository”  \n- 仓库名称设置为: docs（或其他你喜欢的名字）  \n- 勾选 “Add a README.md”  \n- 点击 “Create repository”\n\n![Create repository](assets/image.png)\n\n## 二、添加文档\n### 创建文档目录\n- 在仓库根目录创建你想要的文件夹结构\n- 例如：技术文档/、笔记/ 等\n\n### 添加文档文件\n- 将 Markdown 文件放入相应目录\n\n![alt text](assets/image-1.png)\n示例结构：\n```plaintext\nArticles/\n├── README.md\n├── 技术文档/\n│   ├── README.md\n│   ├── 01-安装.md\n│   └── 02-配置.md\n└── 笔记/\n    ├── README.md\n    ├── 01-生活.md\n    └── 02-学习.md\n```\n\n## 三、配置 GitHub Pages\n### 进入仓库设置\n- 点击仓库顶部的 “Settings” 标签  \n- 左侧边栏找到 “Pages”\n\n### 配置发布源\n- 在 “Build and deployment” 下  \n- Source 选择 “GitHub Actions”\n- 点击蓝色小字 “Create Your Own”\n![Create Your Own](assets/image-2.png)\n\n### 配置工作流\n- 打开 [我写好的 Github Action](https://github.com/Protomyst/Easy-Blog/blob/main/Hugo-PaperMod.yml)\n- 复制全部内容到你自己的Github Action的文件编辑器，将文件命名为 `Hugo-PaperMod.yml`\n- 点击 \"Commit changes...\" 保存工作流，将会自动触发部署\n- 等待部署完成后访问：https://[你的用户名].github.io/[你的仓库名]，即可看到文档网站\n![网站图片](assets/image-3.png)\n\n【注】：配置完成后，每次推送更改都会自动触发部署。\n\n## 四、维护和更新\n### 添加新文档\n- 直接在 GitHub 网页上添加或编辑文件\n- 或在本地编辑后推送到 GitHub\n\n### 注意事项\n- 文件命名\n  文件名称即为网站文章的标题  \n- 图片处理\n  推荐在 markdown 中使用图床  \n- 主题定制\n  可以修改 config.toml 中配置，或调整 layouts/index.html 样式\n- README.md\n  仓库所有的 README.md 均不会显示在网站上（你可以手动取消这一限制）\n- 页面标题和描述\n  可以在复制的 Github Action 中修改 title(88,106行) 和 Content(107行) 的内容\n\n\n## 常见问题\n- 部署失败\n  检查仓库权限设置，查看 Actions 日志  \n- 页面不更新\n  等待几分钟后刷新（请一定尝试**使用无痕模式访问**），重新手动部署或检查文件是否正确提交  \n\n## 五、配置自定义域名（可选）\n### 前提条件\n- 已按前面教程部署文档网站\n- 拥有可用域名\n- 能访问域名的 DNS 设置\n\n### 配置步骤\n1. GitHub 仓库设置\n   - 仓库 \u003e Settings \u003e Pages \u003e “Custom domain”  \n   - 输入想要的域名并保存\n3. DNS 配置（任选一种）\n   - 方法一：CNAME 记录\n     - 类型：CNAME\n     - 主机记录：docs(或其他你喜欢的名字,要与上面自定义的二级域名一致)\n     - 记录值：[你的Github用户名].github.io\n   - 方法二：A 记录\n     - 类型：A\n     - 主机记录：docs\n     - 记录值：185.199.108.153\n   - 【注】Cloudflare 用户请不要开启 CDN 功能（小黄云）\n  ![DNS 配置](assets/image-4.png)\n4. 等待 DNS 生效\n    - 一般 1-2 小时\n5. 启用 HTTPS  \n   - 等证书签发后，选中“Enforce HTTPS” 复选框（否则浏览器会提示不安全）\n![效果图](assets/image-5.png)\n---\n\n# 让我们一起共建有料的网站吧！","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FProtomyst%2FHugo-PaperMod-Deploy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FProtomyst%2FHugo-PaperMod-Deploy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FProtomyst%2FHugo-PaperMod-Deploy/lists"}