HubSpot CMS Boilerplate

<p對齊=“中心”> 在 HubSpot CMS 上構建出色網站的直接起點。

<p對齊=“中心”> 文檔 | 演示網站 | 貢獻

[](https://github.com/HubSpot/cms-theme-boilerplate/commits /主要的） [](https://github.com/HubSpot/cms-theme-boilerplate/圖表/貢獻者） [](https://github.com/HubSpot/cms-theme-boilerplate /觀察者） [](https://github.com/HubSpot/cms-theme-boilerplate /觀星者） [](https://github.com/HubSpot/cms-theme-boilerplate /網絡/成員） [](https://website.grader.com/tests/boilerplate.hubspotcms .com) [](https://developers.google.com/web/工具/燈塔） [](https://github.com/HubSpot/cms-theme-boilerplate/blob/main/執照）

＃＃ 目的

HubSpot CMS Boilerplate 旨在為開發人員在網站構建過程中提供先機。雖然 HubSpot CMS 樣板代表了 HubSpot 固執己見的最佳實踐，但我們打算從類似的項目和反饋中學習。我們希望它為所有網站項目提供靈感和實用性！

＃＃ 入門

使用 HubSpot CMS CLI 下載 HubSpot CMS 樣板：

在開始之前，您需要安裝 Node.js、[HubSpot CMS CLI](https://developers.hubspot.com/docs/cms/guides/getting- started-with-local-development#install-dependencies) 已安裝，我們強烈建議您為您的質量保證/測試環境。

1. 導航到您要用於項目的目錄

2. 運行 hs create website-theme <directory> 從 HubSpot CMS Boilerplate 創建一個項目

3. 配置 門戶的本地開發工具( s) 你想用於你的項目。

4. 運行hs watch --portal=<portal> src <directory> --initial-upload上傳項目中的所有文件並【關注變化】（https://developers.hubspot.com/docs/ cms/developer-reference/local-development-cms-cli#watch) 到 src 目錄中的文件

請參考我們的_在 HubSpot CMS 上開發的快速入門指南_ 和我們的_[本地開發入門](https: //designers.hubspot.com/tutorials/getting-started-with-local-development)_ 文章了解更多信息。

要使用 GitHub 和 GitHub Actions 在項目中使用版本控制：

1. Fork HubSpot CMS Boilerplate 存儲庫和[clone](https://help. github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository) 你的分叉存儲庫到你的計算機

2. [在您的分叉存儲庫中設置 GitHub 機密以加密敏感信息以防止公開顯示](https://help.github.com/en/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-秘密）用於HUBSPOT_PORTAL_ID和HUBSPOT_PERSONAL_ACCESS_KEY

3. 在 .github/workflows/deploy.yml 文件中更新您將在設計管理器中部署到的目錄的名稱（當前默認的 dest_dir 是 cms-theme-boilerplate）

4. 通過推送到你的分叉存儲庫的“主”分支，將更改部署到你的設計管理器

請參考我們的 HubSpot CMS 部署 GitHub 操作頁面 和_[使用 GitHub 操作文章設置與 GitHub 存儲庫的持續集成](https:// /designers.hubspot.com/tutorials/github-integration)_ 了解更多信息。

＃＃ 時尚指南

有關 HubSpot CMS Boilerplate 推薦的最佳實踐和代碼格式的詳細信息，請參考我們的 樣式指南。

貢獻

如果您有興趣為 HubSpot CMS 樣板做出貢獻，請閱讀 CONTRIBUTING.md 和 STYLEGUIDE.md 了解如何報告問題、提出功能請求或提出拉取請求。

版本控制

以前的版本及其文檔可用於 下載。為了提供對未來版本的透明度，我們創建了一個項目板，記錄我們為每個 [即將到來的主要和次要版本]（https://github.com/HubSpot/cms-theme-boilerplate/projects）做準備的計劃。

＃＃ 社區

您可以在 [HubSpot Developer Slack] (https://designers.hubspot.com/slack) 的 #hs-cms-boilerplate 頻道中了解 HubSpot CMS 樣板的更新和討論。

＃＃ 執照

該代碼可在 Apache 許可證，版本 2.0 下獲得