https://yusanwen-code.github.io/tags/github-pages/Recent content in Github-Pages on 姚玉亮的网络日志Hugo -- gohugo.iozh-CNSun, 15 Dec 2024 10:30:00 +0800https://yusanwen-code.github.io/posts/deploy-guide/Sun, 15 Dec 2024 10:30:00 +0800https://yusanwen-code.github.io/posts/deploy-guide/<h2 id="部署到-github-pages">部署到 GitHub Pages </h2><h3 id="前置要求">前置要求 </h3><ol> <li>GitHub 账号</li> <li>安装 Git</li> <li>安装 Hugo（Extended 版本）</li> </ol> <h3 id="本地预览">本地预览 </h3><div class="highlight"><div style="color:#e6edf3;background-color:#0d1117;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <pre tabindex="0" style="color:#e6edf3;background-color:#0d1117;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">1 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">2 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">3 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">4 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">5 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">6 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">7 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <pre tabindex="0" style="color:#e6edf3;background-color:#0d1117;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#8b949e;font-style:italic"># 进入博客目录</span> </span></span><span style="display:flex;"><span>cd my-geek-blog </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#8b949e;font-style:italic"># 启动开发服务器</span> </span></span><span style="display:flex;"><span>hugo server -D </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#8b949e;font-style:italic"># 访问 http://localhost:1313</span> </span></span></code></pre></td></tr></table> </div> </div><h3 id="部署步骤">部署步骤 </h3><ol> <li> <p><strong>创建 GitHub 仓库</strong></p> <ul> <li>仓库名：<code>yourusername.github.io</code>（这是用户站点）</li> <li>或者任意名称（这是项目站点）</li> </ul> </li> <li> <p><strong>推送代码</strong></p> <div class="highlight"><div style="color:#e6edf3;background-color:#0d1117;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <pre tabindex="0" style="color:#e6edf3;background-color:#0d1117;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">1 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">2 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">3 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">4 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">5 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#737679">6 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <pre tabindex="0" style="color:#e6edf3;background-color:#0d1117;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>git init </span></span><span style="display:flex;"><span>git add . </span></span><span style="display:flex;"><span>git commit -m <span style="color:#a5d6ff">&#34;Initial commit&#34;</span> </span></span><span style="display:flex;"><span>git branch -M main </span></span><span style="display:flex;"><span>git remote add origin https://github.com/yourusername/yourusername.github.io.git </span></span><span style="display:flex;"><span>git push -u origin main </span></span></code></pre></td></tr></table> </div> </div></li> <li> <p><strong>配置 GitHub Pages</strong></p> <ul> <li>进入仓库 Settings → Pages</li> <li>Source 选择 &ldquo;Deploy from a branch&rdquo;</li> <li>Branch 选择 &ldquo;gh-pages&rdquo;</li> <li>保存</li> </ul> </li> <li> <p><strong>等待部署</strong></p> <ul> <li>GitHub Actions 会自动运行</li> <li>大约 1-2 分钟后即可访问</li> </ul> </li> </ol> <h3 id="自定义域名可选">自定义域名（可选） </h3><ol> <li>在 <code>static/</code> 目录下创建 <code>CNAME</code> 文件</li> <li>文件内容为你的域名，如 <code>blog.yourdomain.com</code></li> <li>在域名服务商添加 CNAME 记录指向 <code>yourusername.github.io</code></li> </ol> <hr> <blockquote> <p>你的博客已经 ready，去写作吧！</p> </blockquote>