@karamem0/zenn-plugin-emoji v0.3.0

zenn-plugin-emoji

Zenn のアイキャッチ絵文字を記事の内容から生成するためのプラグインです。

事前準備

このプラグインでは OpenAI の GPT を使用しますが環境は提供していません。OpenAI または Azure OpenAI Service の環境をあらかじめご用意ください。また、このプラグインを実行したことによるいかなる損害も責任を負いません。

Zenn の GitHub 連携を行っているリポジトリにパッケージをインストールします。

npm install @karamem0/zenn-plugin-emoji

.env または .env.local ファイルを作成し以下の環境変数を設定します。

以下に OpenAI および Azure OpenAI Service 環境ごとの設定例を示します。

• OpenAI の例

  OPENAI_API_KEY=<your-openai-api-key>
  OPENAI_MODEL_NAME=<your-openai-model-name>

• Azure OpenAI Service (API キー) の例

  AZURE_OPENAI_API_KEY=<your-aoai-api-key>
  AZURE_OPENAI_ENDPOINT=https://<your-aoai-resoure-name>.openai.azure.com
  OPENAI_API_VERSION=<your-aoai-api-version>
  OPENAI_MODEL_NAME=<your-aoai-deployment-name>

• Azure OpenAI Service (Entra ID アプリケーション) の例

  Entra ID アプリケーションに対して Cognitive Services OpenAI User のロールの割り当てが必要です。

  AZURE_CLIENT_ID=<your-app-client-id>
  AZURE_CLIENT_SECRET=<your-app-client-secret>
  AZURE_TENANT_ID=<your-app-tenant-id>
  AZURE_OPENAI_ENDPOINT=https://<your-aoai-resoure-name>.openai.azure.com
  OPENAI_API_VERSION=<your-aoai-api-version>
  OPENAI_MODEL_NAME=<your-aoai-deployment-name>

使用方法

アイキャッチ絵文字を生成する

既定ではアイキャッチ絵文字が存在しないファイルを対象にします。オプションを付けない場合はコンソールに結果のみを表示しファイルは更新しません。

npx zenn-emoji articles/*
articles/ebd6b7f4e118f3.md: 💻 プログラミングを学ぶというテーマからコンピュータをイメージしました。

生成したアイキャッチ絵文字でファイルを更新する

-u オプションを付けることで生成したアイキャッチ絵文字でファイルを更新します。

npx zenn-emoji articles/* -u

前回の結果でファイルを更新する

-l オプションを付けることで前回の実行結果でファイルを更新します。すぐにファイルを更新せずに結果を確認してから更新する場合におすすめです。

npx zenn-emoji articles/*       # 生成結果を確認して
npx zenn-emoji articles/* -u -l # ファイルを更新する

すべてのファイルを対象にする

-f オプションを付けることでアイキャッチ絵文字が存在するファイルも対象にします。

npx zenn-emoji articles/* -f
articles/1d7a517be7f801.md: ⏳ 非同期処理という言葉から時間の経過をイメージしました。
articles/261cbfd985d9b8.md: 🌐 AIというテーマから、世界中に広がる技術の可能性をイメージしました。
articles/ebd6b7f4e118f3.md: 💻 プログラミングというテーマから、コンピュータをイメージしました。

オプション