push-to-hatenablog

GitHubとはてなブログの連携用環境。GitHubに記事の編集内容をプッシュするとはてなブログの記事も更新されます。

セットアップ

GitHubリポジトリの追加

はてなブログ記事の管理用にGitHubリポジトリを作成してください。

blogsync.yamlの追加

blogsync.example.yamlをblogsync.yamlに変更して、ドメイン名やユーザ名を書き換えてください。
ローカル環境から記事を新規追加するために使用します。

blogsync.yamlについては、以下のページを参照してください。

x-motemen/blogsync #Configuration

Secretの追加(DOMAIN,BSY)

GitHubリポジトリに以下の２つのSecretを追加してください。
GitHubアクションで記事を更新するために使用します。

• DOMAINという名前でSecretを追加してください。値にはブログのドメイン名を設定してください。
• BSYという名前で以下のような値のSecretを追加してください。

[ブログのドメイン]:\n
  username: [ユーザ名]\n
  password: [AtomPubのAPIキー]\n
default:\n
  local_root: entries

※ Secretsの追加はGitHubリポジトリページ/Settings/Secretsから設定できます。詳細は以下のページを参照してください。

暗号化されたシークレットの作成と保存 #暗号化されたシークレットの作成

はてなブログからの記事取得

既存記事をはてなブログから取得する場合は、domain変数を指定してから、masterブランチで以下のコマンドを実行してください。

docker-compose run go blogsync pull ${domain}

はてなブログの更新はmasterブランチからの差分が対象となります。

記事数が多いとはてなブログの更新に時間がかかるため、masterブランチで記事を取得・コミットして、ブログの更新を回避してください。

特に初回の記事取得など記事数が多い場合はmasterブランチで取得するようにしてください。

新しい記事の追加

pathとdomain変数を設定して、以下のコマンドを実行するとはてなブログとローカルに下書きが追加されます。

export TITLE=“リポジトリにある Git Submodule を自動で更新してみた”
export DOMAIN=“ymmmtym.hatenablog.jp”
export ENTRY_PATH=$(date '+%Y/%m/%d')/$(echo ${TITLE} | sed -e "s/\ /_/g")

docker-compose run go blogsync post --title=${TITLE} --draft --custom-path=${ENTRY_PATH} ${DOMAIN} < draft.md

編集した記事の更新

編集した記事ファイルをGitHubへプッシュすると、GitHubアクションによってmasterブランチからの差分がはてなブログでも更新されます。

GitHubアクションの設定は以下を確認してください。

.github/workflows/push.yml

※ masterブランチからの差分が更新対象となるため、masterブランチで記事ファイルを編集しても記事の更新は実行されません。master以外のブランチで編集してください。

Slack通知設定

.github/workflows/push.ymlの調整

Slackに更新ワークフローの結果を通知する場合は、.github/workflows/push.yml内の以下のコメントアウトを解除してください。

# - name: notify to slack
#   uses: mm0202/action_slack-notify@master
#   if: always()
#   env:
#     SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}

Secretの追加(SLACK_WEBHOOK_URL)

GitHubリポジトリページ/Settings/Secretsから以下のSecretを追加してください。

key	value
SLACK_WEBHOOK_URL	Incoming Webhookで指定されたWebhook URL