全球最快的网站建设框架
Hugo是最受欢迎的开源静态站点生成器之一。凭借其惊人的速度和灵活性,Hugo再次使构建网站变得有趣。
快速开始
使用美丽的Ananke主题创建一个Hugo网站。
此快速入门macOS在示例中使用。有关如何在其他操作系统上安装Hugo的说明,请参阅install。
建议安装Git来运行本教程。
有关学习雨果的其他方法(如书籍或视频教程),请参阅外部学习资源页面。
步骤1:安装Hugo
Homebrew和的MacPorts软件包管理器macOS可以分别从brew.sh或macports.org安装。如果您正在运行Windows等,请参阅安装。
brew install hugo# orport install hugo
要验证您的新安装,请执行以下操作:
hugo version
步骤2:建立新网站
hugo new site quickstart
上面的代码将在名为的文件夹中创建一个新的Hugo网站quickstart。
步骤3:添加主题
请参阅themes.gohugo.io以获取要考虑的主题列表。本快速入门使用了精美的Ananke主题。
首先,从GitHub下载主题并将其添加到您网站的themes目录中:
cdquickstartgit initgit submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
对于非git用户的注意事项:
如果您尚未安装git,则可以从以下网址下载此主题的最新版本的存档:https : //github.com/budparr/gohugo-theme-ananke/archive/master.zip
解压缩该.zip文件以获得“ gohugo-theme-ananke-master”目录。
将该目录重命名为“ ananke”,并将其移至“ themes /”目录。
然后,将主题添加到站点配置中:
echo'theme = "ananke"'>> config.toml
步骤4:添加一些内容
您可以手动创建内容文件(例如作为content/<CATEGORY>/<FILE>.<FORMAT>)并在其中提供元数据,但是您可以使用该new命令为您做一些事情(例如添加标题和日期):
hugonewposts/my-first-post.md
如果需要,请编辑新创建的内容文件,它将从以下内容开始:
---title: "My First Post"date: 2019-03-26T08:47:11+01:00draft: true
---
草稿不会被部署;完成帖子后,将帖子标题更新为draft: false。更多信息在这里。
步骤5:启动Hugo服务器
现在,在启用草稿的情况下启动Hugo服务器:
▶ hugo server -D| EN+------------------+----+Pages |10Paginator pages |0Non-page files |0Static files |3Processed images |0Aliases |1Sitemaps |1Cleaned |0Totalin11msWatchingforchangesin/Users/bep/quickstart/{content,data,layouts,static,themes}Watchingforconfig changesin/Users/bep/quickstart/config.tomlEnvironment:"development"Serving pagesfrommemoryRunninginFast Render Mode. For full rebuilds on change: hugo server --disableFastRenderWeb Server is available at http://localhost:1313/ (bind address 127.0.0.1)Press Ctrl+C to stop
浏览至http:// localhost:1313 /的新站点。
随意编辑或添加新内容,只需在浏览器中刷新即可快速查看更改(您可能需要在Web浏览器中强制刷新,例如Ctrl-R之类的方法通常可以工作)。
步骤6:自定义主题
您的新站点看起来已经不错了,但是在将其发布给公众之前,您需要对其进行一些调整。
网站配置
config.toml在文本编辑器中打开:
baseURL ="https://example.org/"languageCode ="en-us"title ="My New Hugo Site"theme ="ananke"
将title以上内容替换为更个人的内容。另外,如果您已经准备好域,请设置baseURL。请注意,运行本地开发服务器时不需要此值。
提示:在运行Hugo服务器时,对站点配置或站点中的其他文件进行更改,尽管您可能需要清除缓存,但您会立即在浏览器中看到更改。
有关特定于主题的配置选项,请参见主题站点。
有关进一步的主题自定义,请参见自定义主题。
步骤7:建立静态页面
很简单。只需致电:
hugo -D
./public/默认情况下,输出将位于目录中(-d/--destination标志进行更改,或publishdir在配置文件中进行设置)。