@@ -108,10 +108,22 @@ title = 'My New Hugo Site'
108108#### テーマ変更
109109テーマは[ Hugo Themes] ( https://themes.gohugo.io/ ) に一覧があります。今回は` ananke ` に変更する例
110110``` bash
111+ cd shindys-note
111112git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke
112113# 設定ファイルでテーマを設定すれば完了です
113114echo ' theme = "ananke"' >> hugo.toml
114115```
116+
117+ ` shindys-note ` を再度クローンしたときに、submoduleが配置されていない場合はリポジトリ内で以下のコマンドを実行してください。
118+ ``` bash
119+ git submodule update --init --recursive
120+ ```
121+
122+ またsubmoduleを解除(テーマをアンインストール)する場合は以下のコマンドを実行後、変更をコミットしてください。(hugo.tomlのthemeも削除してください。)
123+ ``` bash
124+ git submodule deinit -f themes/ananke
125+ git rm -f themes/ananke
126+ ```
115127#### post追加
116128以下のコマンドで` /archetypes/default.md ` をテンプレートとして` /content/posts/hello.md ` を作成します。あくまでテスト用なので、自分であらかじめ作成したドキュメントを` /content/posts ` へ格納してテストしていただいても構いません。テスト用のドキュメントをコミット時に対象とするかは自己判断でお願いします。
117129``` bash
@@ -152,7 +164,7 @@ GitHubのリモートリポジトリの作成方法は多種多様なので、
152164```
153165
154166### 2. GitHub Pages公開環境を` gh-pages ` ブランチに構築する
155- ここでは、GitHub Actionsを使用して` shindys-note ` のデフォルトブランチに更新があった際に、自動でHugoによるビルドを行い成果物をgh-pagesへ反映する仕組みを構築します。手順としては以下の内容を記述した` .github/workflows/deploy.yml ` を` shindys-note ` のデフォルトブランチで作成し、pushするだけです。以下テキストのコメント部分は適宜修正してください 。
167+ ここでは、GitHub Actionsを使用して` shindys-note ` のデフォルトブランチに更新があった際に、自動でHugoによるビルドを行い成果物をgh-pagesへ反映する仕組みを構築します。手順としては以下の内容を記述した` .github/workflows/deploy.yml ` を` shindys-note ` のデフォルトブランチで作成し、pushするだけです。コメント部分に注意して適宜修正してください 。
156168``` yml
157169name : Deploy Hugo site to GitHub Pages
158170
@@ -208,7 +220,7 @@ GitHubリポジトリのActionsタブを見ると成否が伺えます。
208220
209221# ### 3.3 Vaultリポジトリ内にGitHub Actions用のスクリプトを作成
210222以下の内容を記述した`.github/workflows/sync-to-note.yml`を作成し、pushしてください。
211- pushすると、Actionsが動作し、`shindys-note`へ同期が行われます。
223+ pushすると、Actionsが動作し、`shindys-note`へ同期が行われます。コメント部分に注意して適宜修正してください。
212224` ` ` yml
213225name: Sync Vault to shindys-note
214226
@@ -237,8 +249,8 @@ jobs:
237249
238250 - name: Sync folders
239251 run: |
240- rsync -av --delete docs/ shindys-note/content/
241- rsync -av --delete assets/ shindys-note/static/assets/
252+ rsync -av --delete docs/ shindys-note/content/ # テーマによってコピー先は変更してください。
253+ rsync -av --delete assets/ shindys-note/static/assets/ # Vault の設定によって変更してください
242254
243255 - name: Commit and push changes
244256 run: |
@@ -258,4 +270,4 @@ jobs:
2582703. Branchには`gh-pages`、`/(root)`を設定
259271
260272
261- ローカル実行したときと同じ内容が表示されれば 、公開完了です🎵
273+ ローカルでテストしたときと同じ内容が表示されれば 、公開完了です🎵
0 commit comments