PWAs(漸進式 web 應用程序) 是使用一些特定的科技和標準模式開發的,允許它們同時利用 web 和本機應用程序功能。

HBS 提供了一些基本的特性,如將網站安裝到主荧幕、預緩存檔案和離線可用。

站点配置§

首先,我們需要指定 pwa 參數,即使為空。

名稱類型預設值描述
pwaObject-
pwa.manifestObject-Web app manifest
pwa.manifest.nameString-默認為站點標題
pwa.manifest.short_nameString-站點短名稱
pwa.manifest.displayStringstandalone
pwa.manifest.descriptionString-默認為站點描述
pwa.manifest.theme_colorString-
pwa.manifest.background_colorString-
pwa.manifest.iconsArray-
pwa.manifest.icons.sizesString-圖標尺寸,如:“96x96”
pwa.manifest.icons.srcString-圖標 URL
pwa.precacheObject-Precache assets
pwa.precache.fontsArray-Precache fonts
pwa.precache.imagesArray-Precache images
pwa.precache.pagesArray-Precache pages
pwa.precache.scriptsArray-Precache scripts
pwa.precache.stylesArray-Precache styles

Manifest§

主題會自動生成 manifest.json

離線§

離線頁面§

如果在沒有網絡的情况下請求新頁面,將顯示離線頁面。

我們需要在 content 目錄中創建一個名為 offline/_index.md 的離線頁面,其首要內容如下。

1+++
2title = 'Offline'
3+++

離線圖片§

與離線頁面壹樣,有壹個脫機圖片用於在沒有網絡的情況下請求圖片。HBS 提供了壹個內置的離線圖片,文件名是 assets/images/offline.png。 妳可以通過在妳的網站根目錄下創建妳自己的具有相同文件名的離線圖片來覆蓋它。

預載§

params.toml

1[pwa]
2  [pwa.precache]
3    fonts = ['/assets/katex/fonts/KaTeX_Math-Italic.woff2']
4    images = ['/images/logo.webp', '/images/profile.webp']
5    pages = ['/']
6    scripts = ['/assets/js/foo.js']
7    styles = ['https://fonts.googleapis.com/css2?family=Roboto&display=swap']

params.yaml

 1pwa:
 2  precache:
 3    fonts:
 4    - /assets/katex/fonts/KaTeX_Math-Italic.woff2
 5    images:
 6    - /images/logo.webp
 7    - /images/profile.webp
 8    pages:
 9    - /
10    scripts:
11    - /assets/js/foo.js
12    styles:
13    - https://fonts.googleapis.com/css2?family=Roboto&display=swap

params.json

 1{
 2   "pwa": {
 3      "precache": {
 4         "fonts": [
 5            "/assets/katex/fonts/KaTeX_Math-Italic.woff2"
 6         ],
 7         "images": [
 8            "/images/logo.webp",
 9            "/images/profile.webp"
10         ],
11         "pages": [
12            "/"
13         ],
14         "scripts": [
15            "/assets/js/foo.js"
16         ],
17         "styles": [
18            "https://fonts.googleapis.com/css2?family=Roboto\u0026display=swap"
19         ]
20      }
21   }
22}