✨
zennの記事をQiitaにも同期する

2025/03/02に公開
 zennの記事をQiitaにも同期するこの記事では、Zennの記事をQiitaに同期するために、zenn-qiita-sync ツールを使用し、GitHub Actions で自動化する手順を説明します。

Qiitaのトークンを取得 (readとwriteの権限が必要です)。以下の手順でQiitaの個人用アクセストークンを作成します。

Qiita にアクセスします。
右上のプロフィールアイコンをクリックし、設定に移動します。
左側のメニューから「アプリケーション」を押下します。
「個人用アクセストークン」セクションで、「新しいトークンを発行する」をクリックします。

read_qiita と write_qiita のチェックボックスをオンにし、「発行する」をクリックします。
表示されたトークンを安全な場所に保管してください。


GitHubのトークンを取得 (repoとworkflowの権限が必要です)。以下の手順でGitHubの個人用アクセストークンを作成します。

GitHub にアクセスします。
右上のプロフィールアイコンをクリックし、「Settings」に移動します。
左側のメニューから「Developer settings」をクリックします。
「Personal access tokens」 -> 「Tokens (classic)」をクリックします。
「Generate new token (classic)」をクリックします。
Note にトークンの説明 (例: "Qiita sync") を入力します。

repo と workflow のチェックボックスをオンにします。
「Generate token」をクリックします。
表示されたトークンを安全な場所に保管してください。


GitHub Secrets にトークンを設定。 GitHubリポジトリのSettings -> Secrets -> Actions から、QIITA_TOKEN と GH_TOKEN を登録します。

GitHub Actionsの設定を確認。このリポジトリでは、.github/workflows/publish.yml にて C-Naoki/zenn-qiita-sync@main アクションが設定されており、mainブランチへのpushをトリガーに自動的にQiitaへの同期が行われます。

 重複投稿を防ぐための設定以前の設定では記事の重複投稿が発生していましたが、以下の修正により重複を防ぐことができます：

 改善点：
変更ファイル検出の簡素化: 複雑な条件分岐を削除し、コミット差分のみで変更を検出

重複除去の追加: sort -uコマンドで重複ファイルを除去

パラメータの最適化: cleanup-deleted: falseで削除記事の自動削除を無効化

 修正後の設定内容：name: Publish articles

on:
  push:
    branches:
      - main
      - master
  workflow_dispatch:

permissions:
  contents: write

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: false

jobs:
  publish_articles:
    runs-on: ubuntu-latest
    timeout-minutes: 5
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '20'

      - name: Get changed markdown files
        id: files
        run: |
          # Create an empty file first to ensure it exists even if no files match
          touch $GITHUB_WORKSPACE/changed_files.txt
          
          # 最新コミットのみで変更された記事ファイルを検出
          if [ -n "${{ github.event.before }}" ] && [ "${{ github.event.before }}" != "0000000000000000000000000000000000000000" ]; then
            # 通常のプッシュ: 前回のコミットから今回のコミットまでの差分
            git diff --name-only ${{ github.event.before }} ${{ github.sha }} | grep "^articles/.*\.md$" > $GITHUB_WORKSPACE/changed_files.txt || true
          else
            # 初回プッシュまたは手動実行: 最新コミットのみの変更
            git diff --name-only HEAD~1 HEAD | grep "^articles/.*\.md$" > $GITHUB_WORKSPACE/changed_files.txt || true
          fi
          
          echo "📋 Changed markdown files:"
          cat $GITHUB_WORKSPACE/changed_files.txt
          
          # 重複防止のため、ファイルの重複を除去
          sort -u $GITHUB_WORKSPACE/changed_files.txt > $GITHUB_WORKSPACE/changed_files_unique.txt
          mv $GITHUB_WORKSPACE/changed_files_unique.txt $GITHUB_WORKSPACE/changed_files.txt
          
          # Set output variable to indicate if we found any files
          if [ "$(wc -l < $GITHUB_WORKSPACE/changed_files.txt)" -gt 0 ]; then
            echo "found_files=true" >> $GITHUB_OUTPUT
          else
            echo "found_files=false" >> $GITHUB_OUTPUT
          fi
        shell: bash

      - name: Install qiita-cli
        if: steps.files.outputs.found_files == 'true'
        run: |
          npm install @qiita/qiita-cli --save-dev
        shell: bash

      - name: Run zenn-qiita-sync
        if: steps.files.outputs.found_files == 'true'
        uses: C-Naoki/zenn-qiita-sync@main
        with:
          qiita-token: ${{ secrets.QIITA_TOKEN }}
          update-existing: true
          cleanup-deleted: false
          dry-run: false
Zennに記事を作成し、mainブランチにpushすると、GitHub Actions が実行され、Qiitaに記事が同期されることを確認します。
GitHubで編集を提案
zennの記事をQiitaにも同期する

重複投稿を防ぐための設定

改善点：

修正後の設定内容：

Discussion
