设置拥有hestiaHUGO的Hugo
整个行程最早的步骤就是设置拥有hestiaHUGO的Hugo啦。 一个一步一步编好的ZORALab赫斯提亚Hugo从新设置指南。
学习目标
在成功完毕这个指南领导后,您会学到:
如何设置Hugo的Git代码库
如何下载和设置hestiaHUGO
如何开动Hugo的服务器来编制网页内容和
如何在行程中运用Git。
hestiaHUGO方式
有如其他的Hugo模型,hestiaHUGO是有通过它的独特方式来供应界面设计。但是呢,不如其 他的Hugo模型,hestiaHUGO是有它自己的数据处理器而很少运用Hugo本生供应的用具(我们 只用它的partial功能和图画处理器功能而已)。我们这么做主要原因是Hugo在它的历史里 有太多的不一致现象。经历过它带来的痛苦,身为ZORALab的我们绝对不会在重复我们的错 误。加上我们一路的网络开发的经历,我们也在别的领域深深的学上很多不同的哲学。如此 以来,在还没决定要用hestiaHUGO前,您一定要接受以下不折不扣的分别:
1. 您是不可能运用Markdown或者如Hugo建议通过他们的Shortcode来把Markdown怪物化。 2. 为了确保与Go的容易配合,hestiaHUGO设计是编写(拥有Hugo的partial功能)Go Template符合的HTML代码。 3. HTML、CSS和JS统统被统一为一体:**WEB**。我们绝不会如其他CSS和JS的构架把他们 分开。 4. 我们还是无条件地遵守非常不一致的最终用户的浏览器渲染规则: (HTML而已 ➔ HTML+CSS而已(如:JS阻止器)➔ HTML+CSS+JS)。 5. 所有的网页布局供应是UI界面元件层的。 每个元件都会有它自己的Web格式(HTML, CSS, CSS Variables, JS)。 6. 我们**编译**网页而不是呈现而已。每面网页是自行包含的。 7. 在网页布局层,我们给HTML+CSS渲染规则优先特别是运用那非常奥妙的CSS变化值。 8. 我们是为了支持各种语言和运用干净数据而非常数据优先的。我们做到自己供应自己的 数据干净话的功能给您统一运用的境界了。
下载最新的包装
我们先在ZORALab赫斯提亚下载购物中心里下载最新的hesitaHUGO包装。切记:记得只需要
寻找:hestiaHUGO
。
检查包装完整性
在还没有开始前,为了安全,我们建议您检查包装完整性。这里有2个方式:
GPG
或SHASUM
。在这个指南里,我们在以下的片段运用
SHASUM
来检查包装。当完整执行SHASUM
命令后您将会得到一份
HASHED_VALUE的数据。您的唯一任务就是要确定这份HASHED_VALUE是
和下载购物中心所展现数据是100%相同的。
# 在 UNIX 系统 (LINUX / MACOS) # ---------------------------- $ sha512sum hestiaHUGO-vNNNN.zip ... [HASHED_VALUE] # 在 WINDOWS 系统 # --------------- $ certutil -hashfile hestiaHUGO-vNNNN.zip sha512 ... SHA512 hash of hestiaHUGO-vNNNN.zip: [HASHED_VALUE]
设置Git代码库
当您有了一份检查成功的包装在手时,现在就是时候设置Git代码库。第一步:制造和开始您
的Git代码库的文件夹(在这整个指南里,我们称它为DemoHestia
)。
在这文件夹里,你再制造新的文件夹(我们推荐名为sites
)。
然后在这最里面的文件夹里制造新的文件夹叫themes
。
最后呢,您就在这个themes
的文件夹里打开hestiaHUGO的包装。
您的成功文件夹有如以下:
DemoHestia/ └── sites/ └── themes/ └── hestiaHUGO/ ├── config/ ├── server.cmd ├── ... └── ... 其他内容 ...
设置hugo系统文件夹
由于hestiaHUGO的引擎的复杂性,hestiaHUGO有运出在自己的文件夹里同时运出
config/
文件夹和server.cmd
。
您需要把它移出来放入sites/
文件夹里。
最后成果有如:
DemoHestia/ └── sites/ ├── server.cmd │ ├── config/ │ ├── _default/ │ │ ├── caches.toml │ │ └── config.toml │ ├── development/ │ │ └── config.toml │ └── production/ │ └── config.toml │ └── themes/ └── hestiaHUGO/ └── ... 所有内容文件 ...
配置Hugo
如今所有重要的文件已经归处,现在是时候配置Hugo了。大致上,您只需要配置
__sites/config/_default/config.toml
文件的第一部分就行了。
其他的部分就跟着附加的注意文字行使就行了。
没错的话,您只需要配置baseURL
为您想要的域名URL地址就够了。
有空的话,您可以参考Hugo配置指南手册来了解每个数码值的意义。
DemoHestia/ └── sites/ ├── ... │ ├── config/ │ ├── _default/ │ │ ├── ... │ │ └── config.toml │ │ │ └── ... │ └── ... ⤋ # CONFIGURE THESE DATA # ==================== baseURL = "https://hestia.zoralab.com" theme = [ "hestiaHUGO", ] timeout = '10m' archetypeDir = "archetypes" contentDir = "content" assetDir = "assets" dataDir = "data" staticDir = [ "static", ] layoutDir = "layouts" themesDir = ".." publishDir = "public" i18nDir = "i18n" # ╔════════════╗ # ║!! STOP !!║ # ╚════════════╝ !!! 那就够了。别改任何以下的数据。您可能会搞炸hestiaHUGO的。 !!! ...
开动Hugo服务器
如今一却已经设置和配置好了,我们可以开始开动服务器引擎来测试用户。
由于Hugo的有不定的症状,我们建议运用我们的server.cmd
文件来开动它。
虽然您可以运用Hugo的指令来开动,我们坚持建议您别这么做。
您可以通过那文件来了解更多。
$ cd sites/ # if you haven't do so $ ./server.cmd
观光服务器的URL链接地址
当服务器安全无损的运行时,您可以观光展览出的URL链接地址。如今我们还未建设任何网 页内容,您也只能看到一面白页或一直被送去语言性的404网页。在这阶段呢,您已经有一 个含有hestiaHUGO可用的Hugo代码库了!
Git Commit
在还没开始编制任何网页内容前,我们建议您Git Commit掉这个代码库以防未来需要的时间 穿越会点。有一件事必须搞清楚:把hestiaHUGO一起Git Commit。如今的hestiaHUGO不只是 供应UI用具了。它其实还是个数据引擎来稳重化您的Hugo。所以呢,把它分开是会不安全 的。
$ git add . $ git commit -s ---- 根点: 为网站设计需求设置和配置hugo。 这里有网站设计需求的Hugo需求。如此,我们也必须开始它的设置和配置 工作。那就开始吧。 这个代码补丁是为网站设计需求设置和配置hugo。 Signed-off-by: 周健豪 ❬[email protected]❭ ---- $ git push
有关更新hestiaHUGO
在以后如果有需要更新hestiaHUGO,
您只需更换那themes/hestiaHUGO
文件夹就可以了。
Hugo的从新配置如果下载中心手册没有列出是不需要的。
切记:更新引擎有时会不小心破坏您所建设的边缘案例内容设计的。
所以呢,您还是预备好时间检查所有的内容完整性。在这儿,我们也尽量会后向兼容。
DemoHestia/ └── sites/ │ ├── ... │ └── themes/ └── hestiaHUGO/ 🡨 只需更新这个文件夹就行了 └── ...
下一步?
现在hestiaHUGO已经设好了,下一步是建设简单的网页。以下是下一步的URL链接:
建设简单和占位符性的Hugo网页终结
我们已经抵达终结段落了。如有询问,您是可以通过以下管道来联系我们吧:
GitHub论坛