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

2025/03/02に公開
Zenn
Qiita
sync
tech
 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への同期が行われます。設定内容は以下の通りです。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
          
          # Try to find changed markdown files, but don't fail if none are found
          git diff --name-only ${{ github.event.before }} ${{ github.sha }} | grep "^articles/.*\.md$" > $GITHUB_WORKSPACE/changed_files.txt || true
          
          # If running manually or if before/after SHAs aren't available, check the last commit
          if [ -z "${{ github.event.before }}" ] || [ "$(wc -l < $GITHUB_WORKSPACE/changed_files.txt)" -eq 0 ]; then
            echo "No files found in normal diff, checking last commit..."
            git diff --name-only HEAD~1 HEAD | grep "^articles/.*\.md$" > $GITHUB_WORKSPACE/changed_files.txt || true
          fi
          
          # If still no files found and this is a PR for a specific article, add it manually
          if [ "$(wc -l < $GITHUB_WORKSPACE/changed_files.txt)" -eq 0 ] && [[ "${{ github.event.pull_request.title }}" == *"#"* ]]; then
            PR_NUM=$(echo "${{ github.event.pull_request.title }}" | grep -o '#[0-9]*' | tr -d '#')
            if [ -n "$PR_NUM" ] && [ -f "articles/openhands_introduction.md" ]; then
              echo "articles/openhands_introduction.md" > $GITHUB_WORKSPACE/changed_files.txt
            fi
          fi
          
          echo "📋 Changed markdown files:"
          cat $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 }}
Zennに記事を作成し、mainブランチにpushすると、GitHub Actions が実行され、Qiitaに記事が同期されることを確認します。
GitHubで編集を提案
zennの記事をQiitaにも同期する

Discussion
