Hugo 配置圖像處理

處理選項

這些是處理圖像的默認設置：

imaging:
  anchor: Smart
  bgColor: '#ffffff'
  compression: lossy
  quality: 75
  resampleFilter: box

[imaging]
  anchor = 'Smart'
  bgColor = '#ffffff'
  compression = 'lossy'
  quality = 75
  resampleFilter = 'box'

{
   "imaging": {
      "anchor": "Smart",
      "bgColor": "#ffffff",
      "compression": "lossy",
      "quality": 75,
      "resampleFilter": "box"
   }
}

anchor

(string) 裁剪或填充圖像時使用的焦點。有效選項包括 TopLeft、Top、TopRight、Left、Center、Right、BottomLeft、Bottom、BottomRight 或 Smart。Smart 選項使用 smartcrop.js 庫識別圖像中最有趣的區域。默認值是 Smart。

bgColor

(string) 將透明圖像轉換為不支持透明的格式（如 PNG 到 JPEG）時使用的背景色。當旋轉非正交角度的圖像時，如果空間不透明且處理規范中未指定背景色，此顏色也會填充空白空間。值必須是 RGB 十六進制顏色。默認值是 #ffffff。

compression

New in v0.153.5

(string) 圖像使用的編碼策略。選項是 lossy 或 lossless。請注意，lossless 僅由 WebP 格式支持。默認值是 lossy。

quality

(int) 圖像的視覺保真度，適用於使用 lossy 壓縮時的 JPEG 和 WebP 格式。表示為 1 到 100（含）之間的整數。較低的數字優先考慮較小的文件大小，而較高的數字優先考慮視覺清晰度。默認值是 75。

resampleFilter

(string) 調整大小、適配或填充圖像時計算新像素使用的算法。常見選項包括 box、lanczos、catmullRom、mitchellNetravali、linear 或 nearestNeighbor。默認值是 box。

過濾器	描述
box	簡單快速的平均過濾器，適用於縮小
lanczos	高質量重采樣過濾器，適用於攝影圖像，產生銳利的結果
catmullRom	銳利的立方過濾器，比 Lanczos 過濾器更快，同時提供類似的結果
mitchellNetravali	立方過濾器，產生比 CatmullRom 更平滑的結果，振鈴偽影更少
linear	雙線性重采樣過濾器，產生平滑的輸出，比立方過濾器更快
nearestNeighbor	最快的重采樣過濾器，無抗鋸齒

請參閱 源文檔 獲取可用重采樣過濾器的完整列表。如果您希望以提高性能為代價提高圖像質量，可以嘗試使用替代過濾器。

WebP 圖像

這些是特定於處理 WebP 圖像的默認設置：

imaging:
  webp:
    hint: photo
    method: 4
    useSharpYuv: true

[imaging]
  [imaging.webp]
    hint = 'photo'
    method = 4
    useSharpYuv = true

{
   "imaging": {
      "webp": {
         "hint": "photo",
         "method": 4,
         "useSharpYuv": true
      }
   }
}

hint

(string) 處理 WebP 圖像時使用的編碼預設，相當於 cwebp CLI 的 -preset 標志。有效選項包括 drawing、icon、photo、picture 或 text。默認值是 photo。

值	示例
drawing	具有高對比度細節的手繪或線條畫
icon	小型彩色圖像
photo	自然光下的戶外照片
picture	室內照片，如肖像
text	主要是文本的圖像

method

(int) 壓縮算法的努力程度。表示為 0 到 6（含）之間的整數，相當於 cwebp CLI 的 -m 標志。較低的數字優先考慮處理速度，而較高的數字優先考慮壓縮效率。默認值是 4。

useSharpYuv

(bool) 用於 RGB 到 YUV 編碼的轉換方法，相當於 cwebp CLI 的 -sharp_yuv 標志。啟用此選項會優先圖像清晰度，以降低處理速度為代價。默認值是 true。

Exif 方法

這些是圖像 Resource 對象上 Exif 方法的默認設置：

imaging:
  exif:
    disableDate: false
    disableLatLong: false
    excludeFields: ''
    includeFields: ''

[imaging]
  [imaging.exif]
    disableDate = false
    disableLatLong = false
    excludeFields = ''
    includeFields = ''

{
   "imaging": {
      "exif": {
         "disableDate": false,
         "disableLatLong": false,
         "excludeFields": "",
         "includeFields": ""
      }
   }
}

disableDate

(bool) 是否通過返回零值禁用 Date 方法。默認值是 false。

disableLatLong

(bool) 是否通過返回零值禁用 Lat 和 Long 方法。默認值是 false。

excludeFields

(string) 提取元數據時要排除的字段的 正則表達式。

includeFields

(string) 提取元數據時要包含的字段的 正則表達式。如果為空，則使用排除技術元數據的默認集。設置為 '.*' 以包含所有字段。

Meta 方法

這些是圖像 Resource 對象上 Meta 方法的默認設置：

imaging:
  meta:
    fields: []
    sources:
    - exif
    - iptc

[imaging]
  [imaging.meta]
    fields = []
    sources = ['exif', 'iptc']

{
   "imaging": {
      "meta": {
         "fields": [],
         "sources": [
            "exif",
            "iptc"
         ]
      }
   }
}

fields

([]string) 提取元數據時要包含的字段的 glob 切片。如果為空，則使用排除技術元數據的默認集。設置為 ['**'] 以包含所有字段。

sources

([]string) 要包含的元數據源，exif、iptc 或 xmp 中的一個或多個。默認值是 ['exif', 'iptc']。XMP 元數據默認被排除以提高性能。