{"id":17306,"date":"2026-04-23T19:17:49","date_gmt":"2026-04-23T11:17:49","guid":{"rendered":"https:\/\/www.aiersheng.cc\/?content_edu=%e5%a6%82%e4%bd%95%e4%bd%bf%e7%94%a8-hugogithub-pages-%e6%90%ad%e5%bb%ba%e4%b8%80%e4%b8%aa%e4%b8%aa%e4%ba%ba%e5%8d%9a%e5%ae%a2-2"},"modified":"2026-04-23T19:17:49","modified_gmt":"2026-04-23T11:17:49","slug":"%e5%a6%82%e4%bd%95%e4%bd%bf%e7%94%a8-hugogithub-pages-%e6%90%ad%e5%bb%ba%e4%b8%80%e4%b8%aa%e4%b8%aa%e4%ba%ba%e5%8d%9a%e5%ae%a2-2","status":"publish","type":"content_edu","link":"https:\/\/www.aiersheng.cc\/?content_edu=%e5%a6%82%e4%bd%95%e4%bd%bf%e7%94%a8-hugogithub-pages-%e6%90%ad%e5%bb%ba%e4%b8%80%e4%b8%aa%e4%b8%aa%e4%ba%ba%e5%8d%9a%e5%ae%a2-2","title":{"rendered":"\u5982\u4f55\u4f7f\u7528 hugo+github pages \u642d\u5efa\u4e00\u4e2a\u4e2a\u4eba\u535a\u5ba2"},"content":{"rendered":"

\u7b80\u4ecb
\nhugo \u662f\u4e00\u4e2a\u57fa\u4e8e GO \u8bed\u8a00\u5f00\u53d1\u7684\u535a\u5ba2\u6846\u67b6\uff0c\u76f8\u6bd4\u4e8e hexo \u6765\u8bf4 hugo \u7684\u751f\u6210\u9759\u6001\u8d44\u6e90\u7f51\u9875\u7684\u901f\u5ea6\u66f4\u5feb\u3002\u652f\u6301 Markdown \u8bed\u6cd5\uff0c\u4e5f\u6709\u8f83\u591a\u7684\u4e3b\u9898\u53ef\u4ee5\u9009\u62e9\uff0c\u642d\u5efa\u4e2a\u4eba\u535a\u5ba2\u4e0d\u5931\u4e3a\u4e00\u4e2a\u597d\u7684\u9009\u62e9\u3002<\/p>\n

\u51c6\u5907\u5de5\u4f5c
\n\u5176\u5b9e hugo \u7684\u642d\u5efa\u4e0d\u9700\u8981\u501f\u52a9\u8fc7\u591a\u7684\u5de5\u5177\uff0c\u4ec5\u4ec5\u9700\u8981\u4f60\u7684\u7535\u8111\u4e0a\u6709\u4e00\u4e2a Git \u73af\u5883\uff08\u5de5\u5177\uff09\uff0c\u4e00\u4e2a GitHub \u8d26\u53f7\u3002\u5acc\u5f03\u9ebb\u70e6\u7684\u8bdd\u53ef\u4ee5\u76f4\u63a5\u4e0b\u8f7d\u4f7f\u7528 cmder \u6216\u8005\u662f Git Bash\uff0c\u5982\u679c\u4f60\u4e5f\u662f\u4f7f\u7528\u7684 Windows Terminal \u7684\u8bdd\uff0c\u90a3\u4e48\u53ef\u4ee5\u53c2\u8003\u6211\u4e4b\u524d\u7684 Windows Terminal \u914d\u7f6e\u4e2d\u5173\u4e8e\u5c06 Git Bash \u96c6\u6210\u5230 Windows Terminal \u4e0a\u7684\u535a\u5ba2\u3002\u4e0b\u9762\u7684\u64cd\u4f5c\u6211\u5c06\u5728 Windows Terminal \u4e0a\u8fdb\u884c\u3002\u524d\u9762\u8bf4\u5230\u7684\u5176\u4ed6\u5de5\u5177\u4e5f\u53ef\u4ee5\uff0c\u547d\u4ee4\u6ca1\u6709\u4ec0\u4e48\u5dee\u522b\u3002<\/p>\n

\u4e0b\u8f7d hugo
\n\u7b2c\u4e00\u6b21\u642d\u5efa\u6211\u5efa\u8bae\u4e0b\u8f7d\u4e8c\u8fdb\u5236\u6587\u4ef6\uff0c\u800c\u4e0d\u662f\u5176\u4ed6\u547d\u4ee4\u884c\u65b9\u5f0f\u4e0b\u8f7d\uff0c\u8fd9\u6837\u505a\u662f\u4e3a\u4e86\u51cf\u5c11\u51fa\u9519\u7684\u6982\u7387\u3002\u5148\u53bb GitHub \u4e0b\u8f7d hugo\uff0c\u6839\u636e\u81ea\u5df1\u7684\u7cfb\u7edf\u4e0b\u8f7d\u5bf9\u5e94\u7684\u4e8c\u8fdb\u5236\u6587\u4ef6\u5373\u53ef\u3002\u8fd9\u91cc\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0chugo \u548c hugo_extended \u662f\u6709\u4e9b\u533a\u522b\u7684\uff0c\u90e8\u5206\u4e3b\u9898\u4f1a\u6307\u5b9a\u4f7f\u7528 hugo_extended\u3002<\/p>\n

$\"image\"$
\n\u6240\u4ee5\u4f60\u5728\u4f7f\u7528\u4e3b\u9898\u7684\u65f6\u5019\uff0c\u6216\u8005\u8bf4\u4f60\u5728\u4e0b\u8f7d\u7248\u672c\u7684\u65f6\u5019\u8981\u8003\u8651\u6e05\u695a\u3002\u5728\u7535\u8111\u4e0a\u65b0\u5efa\u4e00\u4e2a\u6587\u4ef6\u5939\uff0c\u4e4b\u540e\u5728\u91cc\u9762\u518d\u65b0\u5efa\u4e00\u4e2a bin \u6587\u4ef6\u5939\uff0c\u7136\u540e\u5c06\u4e0b\u8f7d\u7684\u4e8c\u8fdb\u5236\u6587\u4ef6\u89e3\u538b\u8fc7\u53bb\uff0c\u4fdd\u8bc1 bin \u4e0b\u8f7d\u53ea\u6709 hugo \u7684\u4e8c\u8fdb\u5236\u6587\u4ef6\uff0c\u6ca1\u6709\u518d\u5f80\u4e0b\u7684\u76ee\u5f55\uff0c\u5373 D:hugobinhugo.exe \u8fd9\u6837\u7684\u65b9\u5f0f\u3002\u7136\u540e\u5728\u7cfb\u7edf\u73af\u5883\u53d8\u91cf\u4e2d\u627e\u5230 path \u5c06\u4e8c\u8fdb\u5236\u6587\u4ef6\u7684\u8def\u5f84\u6dfb\u52a0\u8fdb\u53bb\u3002\u5728\u7ec8\u7aef\u8f93\u5165 hugo version\uff0c\u5982\u679c\u663e\u793a\u7248\u672c\u53f7\u5219\u8868\u793a\u73af\u5883\u53d8\u91cf\u914d\u7f6e\u6b63\u786e\uff0c\u5426\u5219\u5c31\u8981\u8fdb\u884c\u68c0\u67e5\u3002<\/p>\n

\u5f00\u59cb\u642d\u5efa
\n\u6211\u4eec\u8fdb\u5165 hugo \u7684\u6587\u4ef6\u5939\u4e2d\u6267\u884c hugo new site blog \u5efa\u7acb\u7ad9\u70b9\u6587\u4ef6\u5939\uff08blog \u53ea\u662f\u4e00\u4e2a\u4f8b\u5b50\uff0c\u4f60\u53ef\u4ee5\u968f\u610f\u53d6\u4ec0\u4e48\u540d\u5b57\uff09\uff0c\u8fdb\u5165 blog \u6587\u4ef6\u5939\u4e2d\u6211\u4eec\u4f1a\u53d1\u73b0\u91cc\u9762\u5185\u5bb9\u5982\u4e0b\uff1a<\/p>\n

archetypes: \u914d\u7f6e\u6587\u7ae0\u5143\u6570\u636e<\/p>\n

content: \u535a\u5ba2\u6587\u7ae0\u6240\u5728\u76ee\u5f55<\/p>\n

data: \u7528\u6765\u5b58\u653e\u6570\u636e\u6587\u4ef6\uff0c\u4e00\u822c\u662f json \u6587\u4ef6<\/p>\n

layouts: \u7f51\u7ad9\u5e03\u5c40<\/p>\n

static: \u4e00\u4e9b\u9759\u6001\u7684\u5185\u5bb9\uff0c\u4f8b\u5982\u56fe\u7247\u7b49<\/p>\n

themes: \u535a\u5ba2\u4e3b\u9898<\/p>\n

config.yml: \u7ad9\u70b9\u914d\u7f6e\u6587\u4ef6\uff0c\u652f\u6301 yml.toml \u548c json \u4e09\u79cd\u683c\u5f0f\u7684<\/p>\n

\u4e0b\u8f7d\u914d\u7f6e\u4e3b\u9898
\n\u8fd9\u65f6\u5019\u6211\u4eec\u5148\u53bb\u9009\u62e9\u4e00\u4e2a\u81ea\u5df1\u559c\u6b22\u7684\u4e3b\u9898\u7136\u540e\u5c06\u5176\u514b\u9686\u4e0b\u6765\uff0c\u6211\u4ee5 PaperMod \u4e3a\u4f8b\u3002<\/p>\n

\u6211\u4eec\u627e\u5230\u4e3b\u9898\u4ed3\u5e93\uff0c\u7136\u540e\u5728 blog \u4e0b\u6267\u884c<\/p>\n

Code<\/p>\n

git clone https:\/\/github.com\/adityatelange\/hugo-PaperMod.git themes\/PaperMod
\n\u8fd9\u4e2a\u65f6\u5019\u6211\u4eec\u5c31\u4f1a\u770b\u5230 themes \u4e0b\u9762\u591a\u4e86\u4e00\u4e2a\u53eb\u505a PaperMod \u7684\u6587\u4ef6\u5939\uff0c\u91cc\u9762\u5b58\u653e\u7684\u5c31\u662f\u4e3b\u9898\u8d44\u6e90\u3002<\/p>\n

\u8fd9\u91cc\u9700\u8981\u6ce8\u610f\u7684\u662f\uff1a\u4e0d\u540c\u7684\u4e3b\u9898\u4e4b\u524d\u7684\u914d\u7f6e\u65b9\u5f0f\u662f\u4e0d\u540c\u7684\uff0c\u751a\u81f3\u4f1a\u5bf9 hugo \u7684\u7248\u672c\u6709\u9650\u5236\uff0c\u6240\u4ee5\u914d\u7f6e\u4e3b\u9898\u7684\u65f6\u5019\u4e00\u5b9a\u8981\u4ed4\u7ec6\u67e5\u9605\u4e3b\u9898\u6587\u6863\u3002\u6709\u4e9b\u4e3b\u9898\u4e0b\u9762\u6709\u4e00\u4e2a exampleSite \u6587\u4ef6\u5939\uff0c\u90a3\u4e48\u4f60\u4e3b\u8981\u627e\u5230\u4e0b\u9762\u7684 config \u6587\u4ef6\uff0c\u7136\u540e\u590d\u5236\u5230 blog \u4e0b\u9762\uff0c\u5c06\u539f\u672c\u7684 config \u6587\u4ef6\u66ff\u6362\u6389\u3002\u4e4b\u540e\u4f60\u518d\u5bf9 config \u6587\u4ef6\u8fdb\u884c\u81ea\u5df1\u7684\u914d\u7f6e\u3002<\/p>\n

\u8fd8\u6709\u4e00\u79cd\u4e3b\u9898\uff0c\u4f8b\u5982\u6211\u8fd9\u91cc\u4f7f\u7528\u7684 PaperMod \u4e0b\u9762\u5c31\u6ca1\u6709 exampleSite\uff0c\u6240\u4ee5\u5c31\u9700\u8981\u81ea\u5df1\u5728\u5b98\u65b9\u6587\u6863\u4e2d\u627e\u5230\u793a\u4f8b\u7684\u914d\u7f6e\u7136\u540e\u590d\u5236\u5230 blog \u4e0b\u7684 config \u4e2d\u3002\u7279\u522b\u8981\u8bf4\u660e\u7684\u662f\u5fc5\u987b\u8981\u5728 theme \u4e2d\u6307\u660e\u4e3b\u9898\u540d\u79f0\uff0c\u5426\u5219 hugo \u4f1a\u627e\u4e0d\u5230\u8be5\u4e3b\u9898\u6a21\u5757\u3002<\/p>\n

\u5982\u679c\u6ca1\u80fd\u514b\u9686\u5230\u4e3b\u9898\uff0c\u90a3\u4e48\u4f60\u9700\u8981\u5148\u6267\u884c\u4e00\u6b21 git init\u3002<\/p>\n

\u90e8\u7f72\u5230 GitHub Pages
\n\u5728 GitHub \u4e0a\u65b0\u5efa\u4e00\u4e2a\u4ed3\u5e93\uff0c\u547d\u540d\u65b9\u5f0f\u4e3a\u4f60\u7684GitHub\u7528\u6237\u540d+github.io, \u52fe\u9009\u7b2c\u4e00\u4e2a\u6dfb\u52a0 README \u6587\u4ef6\uff0c\u70b9\u51fb\u521b\u5efa\u3002<\/p>\n

\u6211\u4eec\u5b8c\u6210\u4e0a\u8ff0\u7684\u914d\u7f6e\u4e4b\u540e\uff0c\u6211\u4eec\u63a5\u4e0b\u6765\u5728 blog \u4e0b\u6267\u884c hugo, \u8fd9\u4e2a\u65f6\u5019\u6211\u4eec\u4f1a\u770b\u5230 blog \u4e2d\u591a\u4e86\u4e00\u4e2a public \u6587\u4ef6\u5939\u3002\u6211\u4eec\u5148\u5728 blog \u4e0b\u6267\u884c hugo new post\/first.md \u751f\u6210\u4e00\u4e2a Markdown \u6587\u4ef6\uff0cvi \u8fdb\u53bb\u4e4b\u540e\u6211\u4eec\u5148\u8f93\u5165 hello world \u7136\u540e\u4fdd\u5b58\u9000\u51fa\u3002\u6211\u4eec\u63a5\u7740\u8f93\u5165 hugo -t \u4e3b\u9898\u540d\u751f\u6210\u9759\u6001\u8d44\u6e90\u6587\u4ef6\uff0c\u8f93\u5165 hugo server -D \u5148\u5728\u672c\u5730\u9884\u89c8\u4e00\u4e0b\u6548\u679c\uff0c\u6ca1\u6709\u95ee\u9898\u4e4b\u540e\u6211\u4eec\u8fdb\u5165 public \u6587\u4ef6\u5939\uff0c\u4f9d\u6b21\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4:<\/p>\n

markdown<\/p>\n

git init(\u521d\u59cb\u5316git)
\ngit add . (\u6dfb\u52a0\u9759\u6001\u6587\u4ef6\u5230\u7f13\u5b58\u533a)
\ngit branch -M master (\u65b0\u5efa\u4e00\u4e2amaster\u5206\u652f)
\ngit commit -m ‘initial commit'(\u63d0\u4ea4\u8bf4\u660e\u968f\u4fbf\u5199)
\ngit remote add origin git@github.com:username\/username.github.io.git
\n(\u8fd9\u662fssh\u63d0\u4ea4\u65b9\u6cd5\uff0c \u9700\u8981\u751f\u6210Token\u642d\u914dGitHub Actions\u81ea\u52a8\u53d1\u5e03\uff09\u3002
\ngit remote add origin https:\/\/github.com\/ilemonEllen\/ilemonEllen.github.io.git
\n(\u8fd9\u662f\u91c7\u7528https\u65b9\u6cd5\u63d0\u4ea4\uff0c\u901a\u8fc7\u672c\u5730\u7684public\u8fde\u63a5\u8fdc\u7a0b\u4ed3\u5e93\u63d0\u4ea4).\u4e8c\u8005\u4efb\u9009\u5176\u4e00\u5c31\u53ef\u4ee5\u3002
\ngit push -u origin master (\u63d0\u4ea4\u5230master\u4e0a)
\n\u7136\u540e\u6211\u4eec\u53bb\u4ed3\u5e93\u4e2d\u70b9\u51fb setting—–pages—-GitHub Pages \u4e0b\u5c06\u53d1\u5e03\u5206\u652f\u6539\u4e3a master. \u7b49\u5f85\u4e00\u4f1a\u513f\uff0c\u4e0d\u51fa\u610f\u5916\u7684\u8bdd\u5f88\u5feb\u5c31\u80fd\u770b\u5230\u4f60\u7684\u535a\u5ba2\u4e86\u3002<\/p>\n

$\"image\"$ <\/p>\n

\u6ce8\u610f\u95ee\u9898
\n1. \u5982\u679c\u4f60\u7684\u535a\u5ba2\u5df2\u7ecf\u6210\u529f\u63d0\u4ea4\u4f46\u662f\u6ca1\u6709\u663e\u793a\u5185\u5bb9<\/p>\n

\u53ea\u9700\u8981\u5c06\u6587\u7ae0\u5143\u6570\u636e\u7684 draft \u7684 true \u6539\u4e3a false\uff0c\u7136\u540e\u63d0\u4ea4\u5c31\u53ef\u4ee5\u4e86\u3002<\/p>\n

2.git \u63d0\u4ea4\u4e0a\u53bb\u7684\u662f blog \u4e0b\u7684\u6587\u4ef6\u5939\uff0c\u4f46\u662f GitHub Pages \u663e\u793a 404<\/p>\n

\u63d0\u4ea4\u535a\u5ba2\u90fd\u662f\u5728 public \u6587\u4ef6\u5939\u4e2d\u63d0\u4ea4\u7684\uff0c\u5728\u63d0\u4ea4\u4e4b\u524d\u8981\u4e5f\u7279\u522b\u6ce8\u610f\u8981\u5148\u6267\u884c hugo -t \u4e3b\u9898\u540d\u64cd\u4f5c\uff0c\u751f\u6210\u9759\u6001\u8d44\u6e90\u6587\u4ef6\u3002\u5728 public \u4e2d\u63d0\u4ea4\u65f6\uff0c\u8981\u6267\u884c git init\uff0c\u4e0d\u7136\u4f1a\u51fa\u73b0\u65e0\u6cd5\u63d0\u4ea4\u6216\u8005\u662f\u53ea\u63d0\u4ea4\u4e0a\u53bb\u4e00\u4e2a public \u6587\u4ef6\u5939\u3002<\/p>\n

3.remote origin already exists \u600e\u4e48\u89e3\u51b3<\/p>\n

\u8fd9\u662f\u56e0\u4e3a\u4f60\u4e4b\u524d\u4e8e\u8be5\u5206\u652f\u7684\u5173\u8054\u6ca1\u6709\u89e3\u9664\uff0c\u6240\u4ee5\u4f60\u9700\u8981\u6267\u884c git remote rm origin\uff0c\u7136\u540e\u518d\u4e0e\u8fdc\u7a0b\u4ed3\u5e93\u5206\u652f\u5efa\u7acb\u8fde\u63a5\u3002<\/p>\n

4. \u51fa\u73b0 LF will be replaced by CRLF \u8b66\u544a<\/p>\n

\u51fa\u73b0\u8fd9\u4e2a\u73b0\u8c61\u7684\u539f\u56e0\u662f\u5728 Windows \u4e2d\u4f7f\u7528 CRLF \u6807\u8bc6\u4e00\u884c\u7684\u7ed3\u675f\uff0c\u800c\u5728 Linux\/UNIX \u7cfb\u7edf\u4e2d\u53ea\u4f7f\u7528 LF \u6807\u8bc6\u4e00\u884c\u7684\u7ed3\u675f\uff0c\u5176\u5b9e\u8fd9\u5bf9\u4e8e\u535a\u5ba2\u90e8\u7f72\u6765\u8bf4\u6ca1\u6709\u4ec0\u4e48\u5f71\u54cd\u3002\u5982\u679c\u8981\u53bb\u6389\u7684\u8bdd\u6211\u4eec\u53ea\u9700\u8981\u6267\u884c\u4ee5\u4e0b\u547d\u4ee4\uff1a<\/p>\n

markdown<\/p>\n

\u67e5\u770bcore.autocrlf\u5c5e\u6027
\ngit config –global –get core.autocrlf
\ngit config –get core.autocrlf
\ntrue
\n\u8bbe\u7f6ecore.autocrlf\u5c5e\u6027
\ngit config core.autocrlf false
\ngit config –get core.autocrlf
\nfalse
\n\u5230\u6b64 hugo+github pages \u7684\u642d\u5efa\u5c31\u7ed3\u675f\u4e86\u3002\u81f3\u4e8e\u4f7f\u7528\u81ea\u52a8\u811a\u672c + GitHub Actions \u81ea\u52a8\u53d1\u5e03\u7f51\u4e0a\u7684\u6559\u7a0b\u6709\u5f88\u591a\uff0c\u6211\u5c31\u4e0d\u5728\u8fd9\u91cc\u8d58\u8ff0\u4e86\u3002<\/p>\n

\u5e38\u7528\u7684\u547d\u4ee4
\nmarkdown<\/p>\n

hugo -t + \u4e3b\u9898\u540d \u672c\u5730\u751f\u6210\u9759\u6001\u8d44\u6e90
\nhugo server -D \u672c\u5730\u9884\u89c8
\nhugo new post\/xxx.md \u65b0\u5efa\u535a\u5ba2\u6587\u7ae0
\ngit add .
\ngit commit -m “\u63d0\u4ea4\u8bf4\u660e”
\ngit push
\ngit remote -v \u67e5\u770b\u5206\u652f\u8fde\u63a5
\ngit branch -a \u67e5\u770b\u8fdc\u7a0b\u5206\u652f
\ngit push origin –delete \u5220\u9664\u8fdc\u7a0b\u5206\u652f<\/p>\n","protected":false},"excerpt":{"rendered":"

\u9664\u4e86\u53ef\u4ee5\u4f7f\u7528 hexo \u6765\u642d\u5efa\u4e2a\u4eba\u535a\u5ba2\u4e4b\u5916\uff0c\u6211\u4eec\u8fd8\u53ef\u4ee5\u4f7f\u7528 hugo \u535a\u5ba2\u6846\u67b6\u6765\u642d\u5efa\u81ea\u5df1\u7684\u4e2a\u4eba\u535a\u5ba2\u3002hugo […]<\/p>\n","protected":false},"featured_media":15797,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"content_category":[],"content_tag":[],"training_type":[],"class_list":["post-17306","content_edu","type-content_edu","status-publish","has-post-thumbnail","hentry"],"_links":{"self":[{"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=\/wp\/v2\/content_edu\/17306","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=\/wp\/v2\/content_edu"}],"about":[{"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=\/wp\/v2\/types\/content_edu"}],"replies":[{"embeddable":true,"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=17306"}],"version-history":[{"count":0,"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=\/wp\/v2\/content_edu\/17306\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=\/wp\/v2\/media\/15797"}],"wp:attachment":[{"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=17306"}],"wp:term":[{"taxonomy":"content_category","embeddable":true,"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcontent_category&post=17306"},{"taxonomy":"content_tag","embeddable":true,"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcontent_tag&post=17306"},{"taxonomy":"training_type","embeddable":true,"href":"https:\/\/www.aiersheng.cc\/index.php?rest_route=%2Fwp%2Fv2%2Ftraining_type&post=17306"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}