ghost static website generator

Ghost靜態網站產生器

為自訂 Ghost 託管產生靜態 HTML 文件，並將其作為靜態網站發佈在 AWS S3 上。要將靜態部落格網站託管在路徑/blog ( https://yourdomain.com/blog ) 下，需要使用與https://content.yourdomain.com/blog相同的路徑來託管 Ghost。

如果您的部落格託管在https://content.yourdomain.com下，並且您希望將靜態網站託管在https://yourdomain.com/blog下，則這是不可能的。反之亦然。

您也可以透過傳遞下列參數custom_replace_keys和custom_replace_values來替換產生的靜態檔案中的某些文字。有關更多詳細信息，請參閱輸入和範例用法部分。目前還不支援多行替換。

或者，您可以在 AWS S3 或 AWS Amplify 上託管靜態檔案。

若要在 AWS S3 上託管靜態博客，請提供以下輸入參數：

• s3_bucket_name （使儲存桶可公開存取並啟用靜態網站寄存）

• aws_access_key_id

• aws_secret_access_key

• aws_region

要在現有 AWS Amplify 應用程式上託管靜態博客，請提供以下輸入參數：

• aws_amplify_app_id

• aws_amplify_branch_name

• aws_access_key_id

• aws_secret_access_key

• aws_region

輸入

ghost_hosted_url

必要的Ghost 託管 URL 端點。 （ ex: https://content.yourdomain.com/blog ）

ghost_static_host_url

需要託管靜態文件的必要 URL 端點。 （ ex: https://yourdomain.com/blog ）

custom_replace_keys

可選 需要從同一索引處的 custom_replace_values 中的項目替換的逗號分隔項目清單。

custom_replace_values

可選 以逗號分隔 custom_replace_keys 中項目的關聯值。

root_index_jsonld

可選替換根索引檔案中的 ld+json 資料。

breadcrumb_root_index_jsonld

可選在根索引檔案中新增麵包屑 ld+json 資料。

s3_bucket_name

用於上傳靜態 HTML 檔案的可選S3 儲存桶名稱。

aws_access_key_id

可選的AWS 存取密鑰 ID。

aws_secret_access_key

可選的AWS 秘密存取密鑰。

aws_region

可選的AWS 區域。

aws_amplify_app_id

可選放大應用程式 ID。

aws_amplify_branch_name

可選放大分支名稱。

用法範例

 name : Generate Static HTML files
uses : TrueSparrowSystems/ghost-static-website-generator@v4
with :
  ghost_hosted_url : " https://content.yourdomain.com/blog "
  ghost_static_host_url : " https://yourdomain.com/blog "
  s3_bucket_name : " your-s3-bucket-name "
  aws_access_key_id : ${{ secrets.AWS_ACCESS_KEY_ID }} # Accessing it from the gihub secrets
  aws_secret_access_key : ${{ secrets.AWS_SECRET_ACCESS_KEY }} # Accessing it from the gihub secrets
  aws_region : " us-east-1 "
  custom_replace_keys : " key_1, key_2, key_n "
  custom_replace_values : " value_1, value_2, value_n "

使用 docker 本地建置並運行

docker build -t ghost-swg .
docker run -it --env-file .env.sample ghost-swg

對.env.sample檔案進行適當的更改。若要將產生的 HTML 檔案保留在本機（主機系統）目錄中，請使用docker run指令的綁定掛載選項，例如： -v /path/to/local/dir:/src/content