<rss xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" version="2.0"><channel><title>建站 - 标签 - 灿若星河 | 郝建锋</title><link>https://philohao.com/tags/%E5%BB%BA%E7%AB%99/</link><description>建站 - 标签 - 灿若星河 | 郝建锋</description><generator>Hugo -- gohugo.io</generator><language>zh-CN</language><managingEditor>haojianfeng1997@gmail.com (Jianfeng.Hao)</managingEditor><webMaster>haojianfeng1997@gmail.com (Jianfeng.Hao)</webMaster><lastBuildDate>Tue, 17 Sep 2019 14:28:00 +0800</lastBuildDate><atom:link href="https://philohao.com/tags/%E5%BB%BA%E7%AB%99/index.xml" rel="self" type="application/rss+xml"/><item><title>Hugo 操作纪要-个人向</title><link>https://philohao.com/2019/09/20190917/</link><pubDate>Tue, 17 Sep 2019 14:28:00 +0800</pubDate><dc:creator>Jianfeng.Hao</dc:creator><author>haojianfeng1997@gmail.com (Jianfeng.Hao)</author><guid isPermaLink="true">https://philohao.com/2019/09/20190917/</guid><description>个人 Hugo 操作纪要，记录新建内容、本地预览和常用维护命令。</description><content:encoded><![CDATA[<h2 id="基本使用">基本使用</h2>
<h3 id="hugo-命令">hugo 命令</h3>
<p>一般的 hugo 命令包括 <strong>命令</strong> 及 <strong>参数</strong> 两项，作为个人博主日常主要使用 <code>生成新内容</code> 和 <code>本地运行</code> 两个命令，具体的使用方法如下：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span><span class="lnt">13
</span><span class="lnt">14
</span><span class="lnt">15
</span><span class="lnt">16
</span><span class="lnt">17
</span><span class="lnt">18
</span><span class="lnt">19
</span><span class="lnt">20
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">使用方法:
</span></span><span class="line"><span class="cl">  hugo
</span></span><span class="line"><span class="cl">  hugo [flags]
</span></span><span class="line"><span class="cl">  hugo [command]
</span></span><span class="line"><span class="cl">  hugo [command] [flags]
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">节选的 command:
</span></span><span class="line"><span class="cl">  new         为你的站点创建新的内容
</span></span><span class="line"><span class="cl">  server      一个高性能的 web 服务器
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">节选的 flags:
</span></span><span class="line"><span class="cl">  -D, --buildDrafts                包括被标记为 draft 的文章
</span></span><span class="line"><span class="cl">  -E, --buildExpired               包括已过期的文章
</span></span><span class="line"><span class="cl">  -F, --buildFuture                包括将在未来发布的文章
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">举几个栗子:
</span></span><span class="line"><span class="cl">  hugo -D                          生成静态文件并包括 draft 为 true 的文章
</span></span><span class="line"><span class="cl">  hugo new post/new-content.md     新建一篇文章
</span></span><span class="line"><span class="cl">  hugo new site mysite             新建一个称为 mysite 的站点
</span></span><span class="line"><span class="cl">  hugo server -E                   启动服务器并包括已过期的文章
</span></span></code></pre></td></tr></table>
</div>
</div><p>更多的 hugo 命令可以参考 <a href="https://gohugo.io/getting-started/usage/" target="_blank" rel="noopener noreffer">官方文档</a>。</p>
<h3 id="目录结构">目录结构</h3>
<ol>
<li>站点目录结构</li>
</ol>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">~/blog $ tree -L 1
</span></span><span class="line"><span class="cl">.                   # 对比             Hexo
</span></span><span class="line"><span class="cl">├── archetypes/     # 文章模板          scaffolds/
</span></span><span class="line"><span class="cl">├── content/        # 文章目录          source/_posts/
</span></span><span class="line"><span class="cl">├── data/           # Hugo 数据文件     source/_data/
</span></span><span class="line"><span class="cl">├── layouts/        # 布局模板
</span></span><span class="line"><span class="cl">├── public/         # 生成的静态文件     public/
</span></span><span class="line"><span class="cl">├── resources/      # Hugo 缓存
</span></span><span class="line"><span class="cl">├── static/         # 网站的静态文件     source/
</span></span><span class="line"><span class="cl">├── themes/         # 主题目录          themes/
</span></span><span class="line"><span class="cl">└── config.toml     # 配置文件          _config.yml
</span></span></code></pre></td></tr></table>
</div>
</div><ol start="2">
<li>主题目录结构</li>
</ol>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span><span class="lnt">3
</span><span class="lnt">4
</span><span class="lnt">5
</span><span class="lnt">6
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">~/blog/themes/divine $ tree -L 1
</span></span><span class="line"><span class="cl">.
</span></span><span class="line"><span class="cl">├── archetypes/
</span></span><span class="line"><span class="cl">├── images/
</span></span><span class="line"><span class="cl">├── layouts/
</span></span><span class="line"><span class="cl">└── static/
</span></span></code></pre></td></tr></table>
</div>
</div><p>站点目录下的文件可以覆盖主题目录下的相应文件——这意味着可以在不修改主题文件的前提下方便地定制主题。在 Hugo 中，如果想要定制主题，只需在站点目录下新建相应的文件即可。这是非常利于主题的维护的，只需使用 Git 的 submodule 的方式安装 Hugo 的主题，然后更新时只需直接在站点根目录下敲一条命令回车即可，非常方便！</p>
<h2 id="文章设置">文章设置</h2>
<h3 id="文章模板">文章模板</h3>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span><span class="lnt">13
</span><span class="lnt">14
</span><span class="lnt">15
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;{{ replace .Name &#34;</span>-<span class="s2">&#34; &#34;</span><span class="w"> </span><span class="s2">&#34; | title }}&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">date</span><span class="p">:</span><span class="w"> </span>{{<span class="w"> </span><span class="l">.Date }}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">categories</span><span class="p">:</span><span class="w"> </span><span class="l">Diary, Reading, Studying</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">tags</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">x</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">xx</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">xxx</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;home&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">toc</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">mathjax</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">codes</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="l">bash, diff, markdown, python, r]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">comments</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">vertical</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">draft</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
</span></span></span></code></pre></td></tr></table>
</div>
</div>]]></content:encoded></item></channel></rss>