利用VS Code在Azure上构建部署静态页面

陈嘉栋 2020-02-27 我要评论

0x00 前言

前一段时间，我找到了Jendrik Illner的个人网站。除了那里的精彩文章，网站的主题也吸引了我的注意力，而且我发现该网站的主题采用了Hugo的Academic主题。

然后，我认为现在是时候为自己建立一个漂亮的个人网站了。我是Azure的新手，因此本文只是记录在Azure上建立我的个人网站的过程以及遇到的问题。我希望能帮助有同样需求的人。

0x01 在本地运行 Hugo 网站

在我们将静态页面托管到云上之前，最好先在本地运行它们。首先，让我们获取Hugo。我使用macOS来运行Hugo。因此，使用homebrew安装hugo将非常方便。

brew install hugo

hugo安装完成后，我们就可以在终端中使用hugo命令了。例如，我们可以使用hugo version打印出已安装的hugo版本。

而创建hugo网站也变得非常简单，只需执行hugo new site命令即可。

hugo new site hugoInit

这将创建一个名为hugoInit的文件夹，其中包含工程文件。

然后，我们可以进入刚刚创建的新文件夹，在添加新页面并且在本地运行之前，我们可以下载一个Hugo的主题。

git init
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
echo 'theme = "ananke"' >> config.toml

现在，让我们尝试在本地运行该网站。

hugo serve

这样，我们就在本地运行了一个使用ananke主题的网站，在浏览器中访问http://localhost:1313/即可。

至于将新页面添加到我们的网站，只需执行以下命令。

hugo new posts/page.md

默认情况下，hugo serve命令运行网站时，将不会显示文章的草稿。如果需要在本地运行并且查看草稿，只需添加一个-D参数给hugo serve命令。

关于Hugo的命令，可以在Hugo主页上找到更多信息：

https://gohugo.io/getting-started/installing/

接下来，我们将介绍Academic theme。老实说，我认为这个主题就是我想要的。模块化架构，易于组合各种widgets，对markdown的友好支持，并且这个主题很简洁。

它的代码托管在github上，因此我们需要从github下载该项目：

git clone https://github.com/sourcethemes/academic-kickstart.git My_Website

然后初始化工程：

cd My_Website
git submodule update --init --recursive

初始化主题项目后，我们就在本地获取了Academic主题。因为这是一个Hugo的主题，所以我们可以像上面一样运行它。

hugo serve

这样，我们就在本地运行了一个使用Academic主题的网站，同样在浏览器中访问http://localhost:1313/即可。

现在，让我们修改项目以构建我们自己的网站。使用VS Code打开该项目，有两个文件夹值得我们注意。它们是config文件夹和content文件夹。

在config文件夹中，你可以找到config.toml文件，该文件是Academic的配置文件，使用的是TOML语法。例如，你可以将网站标题从默认值“Academic”修改为所需的名称。

另一个有用的文件是params.toml文件。你可以选择配色主题，字体大小以及是否允许用户在日夜模式之间进行切换等。

至于content文件夹，顾名思义，该文件夹包含网站的内容。例如，我们可以修改author文件夹中的_index.md文件以显示自己的信息。也可以通过修改home文件夹中的文件来添加/删除网站的窗口小部件。例如如果不希望在网站中显示“项目”组件，则可以将projects.md文件中的active值更改为false。同样，在这里你也可以找到posts文件夹，是的，所有帖子都在此文件夹中。