Skip to content

Commit

Permalink
feat: hugo quick start with github pages
Browse files Browse the repository at this point in the history
  • Loading branch information
zhaoyang committed Aug 24, 2023
1 parent 043c282 commit 9fd4064
Show file tree
Hide file tree
Showing 6 changed files with 130 additions and 21 deletions.
37 changes: 35 additions & 2 deletions content/posts/my-first-post.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,39 @@ date: 2023-08-24T09:11:47+08:00
# bookSearchExclude: false
---

hello world
2023最新 `hugo` + `github pages` 使用方式

网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题

---

严格按照官方这两个链接,就不会出现问题:
* hugo [quick start](https://gohugo.io/getting-started/quick-start/)
```
hugo new site quickstart
cd quickstart
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo "theme = 'ananke'" >> hugo.toml
hugo server
hugo new content posts/my-first-post.md
open content/posts/my-first-post.md
//然后进行修改
hugo server -D
//观察 http://localhost:1313/
hugo
```
* [Host on GitHub Pages](https://gohugo.io/hosting-and-deployment/hosting-on-github/)

---

需要注意的地方:
* 请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程
我就采坑了,使用了另一个theme,后面在 `localhost` 一直不出现 `my-first-post.md`

* `.github/workflows/hugo.yaml` 一定要注意修改 `HUGO_VERSION` 的值

* `my-first-post.md` 注意删掉/注释掉 draft:true
这样 push到github时,`public/index.html`等几个文件中才包含了 `my-first-post.md`的内容,访问 `https://zyestin.github.io` 时才能找到 `my-first-post.md`入口

come here
9 changes: 7 additions & 2 deletions public/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -123,8 +123,13 @@ <h1 class="f3 fw1 athelas mt0 lh-title">
</a>
</h1>
<div class="f6 f5-l lh-copy nested-copy-line-height nested-links">
hello world
come here
2023最新 hugo + github pages 使用方式
网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题
严格按照官方这两个链接,就不会出现问题:
hugo quick start hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo &#34;theme = &#39;ananke&#39;&#34; &gt;&gt; hugo.toml hugo server hugo new content posts/my-first-post.md open content/posts/my-first-post.md //然后进行修改 hugo server -D //观察 http://localhost:1313/ hugo Host on GitHub Pages 需要注意的地方:
请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程 我就采坑了,使用了另一个theme,后面在 localhost 一直不出现 my-first-post.md
.github/workflows/hugo.yaml 一定要注意修改 HUGO_VERSION 的值
my-first-post.md 注意删掉/注释掉 draft:true 这样 push到github时,public/index.html等几个文件中才包含了 my-first-post.md的内容,访问 https://zyestin.github.io 时才能找到 my-first-post.md入口
</div>
<a href="/posts/my-first-post/" class="ba b--moon-gray bg-light-gray br2 color-inherit dib f7 hover-bg-moon-gray link mt2 ph2 pv1">read more</a>

Expand Down
9 changes: 7 additions & 2 deletions public/index.xml
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,13 @@
<pubDate>Thu, 24 Aug 2023 09:11:47 +0800</pubDate>

<guid>https://zyestin.github.io/posts/my-first-post/</guid>
<description>hello world
come here</description>
<description>2023最新 hugo + github pages 使用方式
网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题
严格按照官方这两个链接,就不会出现问题:
hugo quick start hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo &amp;#34;theme = &amp;#39;ananke&amp;#39;&amp;#34; &amp;gt;&amp;gt; hugo.toml hugo server hugo new content posts/my-first-post.md open content/posts/my-first-post.md //然后进行修改 hugo server -D //观察 http://localhost:1313/ hugo Host on GitHub Pages 需要注意的地方:
请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程 我就采坑了,使用了另一个theme,后面在 localhost 一直不出现 my-first-post.md
.github/workflows/hugo.yaml 一定要注意修改 HUGO_VERSION 的值
my-first-post.md 注意删掉/注释掉 draft:true 这样 push到github时,public/index.html等几个文件中才包含了 my-first-post.md的内容,访问 https://zyestin.github.io 时才能找到 my-first-post.md入口</description>
</item>

</channel>
Expand Down
9 changes: 7 additions & 2 deletions public/posts/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -98,8 +98,13 @@ <h1 class="f3 near-black">
</a>
</h1>
<div class="nested-links f5 lh-copy nested-copy-line-height">
hello world
come here
2023最新 hugo + github pages 使用方式
网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题
严格按照官方这两个链接,就不会出现问题:
hugo quick start hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo &#34;theme = &#39;ananke&#39;&#34; &gt;&gt; hugo.toml hugo server hugo new content posts/my-first-post.md open content/posts/my-first-post.md //然后进行修改 hugo server -D //观察 http://localhost:1313/ hugo Host on GitHub Pages 需要注意的地方:
请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程 我就采坑了,使用了另一个theme,后面在 localhost 一直不出现 my-first-post.md
.github/workflows/hugo.yaml 一定要注意修改 HUGO_VERSION 的值
my-first-post.md 注意删掉/注释掉 draft:true 这样 push到github时,public/index.html等几个文件中才包含了 my-first-post.md的内容,访问 https://zyestin.github.io 时才能找到 my-first-post.md入口
</div>
</div>
</div>
Expand Down
9 changes: 7 additions & 2 deletions public/posts/index.xml
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,13 @@
<pubDate>Thu, 24 Aug 2023 09:11:47 +0800</pubDate>

<guid>https://zyestin.github.io/posts/my-first-post/</guid>
<description>hello world
come here</description>
<description>2023最新 hugo + github pages 使用方式
网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题
严格按照官方这两个链接,就不会出现问题:
hugo quick start hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo &amp;#34;theme = &amp;#39;ananke&amp;#39;&amp;#34; &amp;gt;&amp;gt; hugo.toml hugo server hugo new content posts/my-first-post.md open content/posts/my-first-post.md //然后进行修改 hugo server -D //观察 http://localhost:1313/ hugo Host on GitHub Pages 需要注意的地方:
请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程 我就采坑了,使用了另一个theme,后面在 localhost 一直不出现 my-first-post.md
.github/workflows/hugo.yaml 一定要注意修改 HUGO_VERSION 的值
my-first-post.md 注意删掉/注释掉 draft:true 这样 push到github时,public/index.html等几个文件中才包含了 my-first-post.md的内容,访问 https://zyestin.github.io 时才能找到 my-first-post.md入口</description>
</item>

</channel>
Expand Down
78 changes: 67 additions & 11 deletions public/posts/my-first-post/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,13 @@

<title>My First Post | zyestin</title>
<meta name="viewport" content="width=device-width,minimum-scale=1">
<meta name="description" content="hello world
come here">
<meta name="description" content="2023最新 hugo &#43; github pages 使用方式
网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题
严格按照官方这两个链接,就不会出现问题:
hugo quick start hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo &#34;theme = &#39;ananke&#39;&#34; &gt;&gt; hugo.toml hugo server hugo new content posts/my-first-post.md open content/posts/my-first-post.md //然后进行修改 hugo server -D //观察 http://localhost:1313/ hugo Host on GitHub Pages 需要注意的地方:
请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程 我就采坑了,使用了另一个theme,后面在 localhost 一直不出现 my-first-post.md
.github/workflows/hugo.yaml 一定要注意修改 HUGO_VERSION 的值
my-first-post.md 注意删掉/注释掉 draft:true 这样 push到github时,public/index.html等几个文件中才包含了 my-first-post.md的内容,访问 https://zyestin.github.io 时才能找到 my-first-post.md入口">
<meta name="generator" content="Hugo 0.117.0">


Expand All @@ -31,21 +36,36 @@


<meta property="og:title" content="My First Post" />
<meta property="og:description" content="hello world
come here" />
<meta property="og:description" content="2023最新 hugo &#43; github pages 使用方式
网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题
严格按照官方这两个链接,就不会出现问题:
hugo quick start hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo &#34;theme = &#39;ananke&#39;&#34; &gt;&gt; hugo.toml hugo server hugo new content posts/my-first-post.md open content/posts/my-first-post.md //然后进行修改 hugo server -D //观察 http://localhost:1313/ hugo Host on GitHub Pages 需要注意的地方:
请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程 我就采坑了,使用了另一个theme,后面在 localhost 一直不出现 my-first-post.md
.github/workflows/hugo.yaml 一定要注意修改 HUGO_VERSION 的值
my-first-post.md 注意删掉/注释掉 draft:true 这样 push到github时,public/index.html等几个文件中才包含了 my-first-post.md的内容,访问 https://zyestin.github.io 时才能找到 my-first-post.md入口" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://zyestin.github.io/posts/my-first-post/" /><meta property="article:section" content="posts" />
<meta property="article:published_time" content="2023-08-24T09:11:47+08:00" />
<meta property="article:modified_time" content="2023-08-24T09:11:47+08:00" />
<meta itemprop="name" content="My First Post">
<meta itemprop="description" content="hello world
come here"><meta itemprop="datePublished" content="2023-08-24T09:11:47+08:00" />
<meta itemprop="description" content="2023最新 hugo &#43; github pages 使用方式
网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题
严格按照官方这两个链接,就不会出现问题:
hugo quick start hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo &#34;theme = &#39;ananke&#39;&#34; &gt;&gt; hugo.toml hugo server hugo new content posts/my-first-post.md open content/posts/my-first-post.md //然后进行修改 hugo server -D //观察 http://localhost:1313/ hugo Host on GitHub Pages 需要注意的地方:
请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程 我就采坑了,使用了另一个theme,后面在 localhost 一直不出现 my-first-post.md
.github/workflows/hugo.yaml 一定要注意修改 HUGO_VERSION 的值
my-first-post.md 注意删掉/注释掉 draft:true 这样 push到github时,public/index.html等几个文件中才包含了 my-first-post.md的内容,访问 https://zyestin.github.io 时才能找到 my-first-post.md入口"><meta itemprop="datePublished" content="2023-08-24T09:11:47+08:00" />
<meta itemprop="dateModified" content="2023-08-24T09:11:47+08:00" />
<meta itemprop="wordCount" content="4">
<meta itemprop="wordCount" content="69">
<meta itemprop="keywords" content="" /><meta name="twitter:card" content="summary"/>
<meta name="twitter:title" content="My First Post"/>
<meta name="twitter:description" content="hello world
come here"/>
<meta name="twitter:description" content="2023最新 hugo &#43; github pages 使用方式
网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题
严格按照官方这两个链接,就不会出现问题:
hugo quick start hugo new site quickstart cd quickstart git init git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke echo &#34;theme = &#39;ananke&#39;&#34; &gt;&gt; hugo.toml hugo server hugo new content posts/my-first-post.md open content/posts/my-first-post.md //然后进行修改 hugo server -D //观察 http://localhost:1313/ hugo Host on GitHub Pages 需要注意的地方:
请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程 我就采坑了,使用了另一个theme,后面在 localhost 一直不出现 my-first-post.md
.github/workflows/hugo.yaml 一定要注意修改 HUGO_VERSION 的值
my-first-post.md 注意删掉/注释掉 draft:true 这样 push到github时,public/index.html等几个文件中才包含了 my-first-post.md的内容,访问 https://zyestin.github.io 时才能找到 my-first-post.md入口"/>


</head>
Expand Down Expand Up @@ -118,8 +138,44 @@ <h1 class="f1 athelas mt3 mb1">My First Post</h1>


</header>
<div class="nested-copy-line-height lh-copy serif f4 nested-links mid-gray pr4-l w-two-thirds-l"><p>hello world</p>
<p>come here</p>
<div class="nested-copy-line-height lh-copy serif f4 nested-links mid-gray pr4-l w-two-thirds-l"><p>2023最新 <code>hugo</code> + <code>github pages</code> 使用方式</p>
<p>网上大多是hugo旧版的使用方式,有好几处明显差异的,不值得借鉴,反正我借鉴后出现各种莫名其妙问题</p>
<hr>
<p>严格按照官方这两个链接,就不会出现问题:</p>
<ul>
<li>hugo <a href="https://gohugo.io/getting-started/quick-start/">quick start</a></li>
</ul>
<pre tabindex="0"><code>hugo new site quickstart
cd quickstart
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
echo &#34;theme = &#39;ananke&#39;&#34; &gt;&gt; hugo.toml
hugo server

hugo new content posts/my-first-post.md
open content/posts/my-first-post.md
//然后进行修改
hugo server -D
//观察 http://localhost:1313/
hugo
</code></pre><ul>
<li><a href="https://gohugo.io/hosting-and-deployment/hosting-on-github/">Host on GitHub Pages</a></li>
</ul>
<hr>
<p>需要注意的地方:</p>
<ul>
<li>
<p>请先尝试 hugo文档里提供的theme,即ananke,走通一遍流程
我就采坑了,使用了另一个theme,后面在 <code>localhost</code> 一直不出现 <code>my-first-post.md</code></p>
</li>
<li>
<p><code>.github/workflows/hugo.yaml</code> 一定要注意修改 <code>HUGO_VERSION</code> 的值</p>
</li>
<li>
<p><code>my-first-post.md</code> 注意删掉/注释掉 draft:true
这样 push到github时,<code>public/index.html</code>等几个文件中才包含了 <code>my-first-post.md</code>的内容,访问 <code>https://zyestin.github.io</code> 时才能找到 <code>my-first-post.md</code>入口</p>
</li>
</ul>
<ul class="pa0">

</ul>
Expand Down

0 comments on commit 9fd4064

Please sign in to comment.