テーマ「Develop」

フロントエンドの開発環境が整備された a-blog cms の公式テーマです。

ダウンロード

最新版のソースコードは以下のURLからダウンロードできます。Assets > develop.zip をダウンロードしてください。

https://github.com/appleple/acms-develop/releases/latest

GitHub からテーマを使用する手順

1. GitHub から最新版の Develop テーマのソースコードをダウンロードする
2. a-blog cms を設置した環境の themes ディレクトリ直下に、ダウンロードしたファイルに含まれている themes ディレクトリ内のファイルを設置する
3. /setup フォルダをリネームしたフォルダ内にある bin ディレクトリ内に、ダウンロードしたファイルに含まれている/bin/ディレクトリ内のファイルを設置する（すでに 既存のディレクトリがある場合は、上書きする）
4. メンテナンスプログラム（https://ドメイン/setup フォルダをリネームしたフォルダ/index.php）にアクセスする
5. 「インポート実行画面へ」を押下する
6. 「1. インポート先またはその親になるブログを選択してください。」で任意のものを選択、「2. インポートするブログデータ名を選択してください。」は「develop」を選択、「3. コンフィグ関連のインポート設定」は新規インストールの場合は全てチェックして、「インポートを実行する」を押下する

これで、サイトにアクセスすると Develop テーマがインストールされます。

利用しているライブラリ

• Tailwind CSS
• Alpine.js
• htmx
• Vite
• Pines
• tailwindcss typography

コントリビューションガイド

このプロジェクトへの貢献に興味を持っていただき、ありがとうございます。以下のガイドラインに従って、プロジェクトへの貢献をお願いいたします。

プルリクエスト

1. 作業を開始する前に、新しいブランチを作成してください
2. ブランチ名は、feature/機能名 や fix/バグ名 などの命名規則に従ってください
3. プルリクエストは develop ブランチに対して作成してください
4. コードの変更は最小限に保ち、1つのプルリクエストにつき1つの機能やバグ修正を含めるようにしてください
5. 以下の点に注意してコードを作成してください：
   • コードスタイルは既存のコードに合わせる
   • 適切なコメントを追加する
   • 必要に応じてドキュメントを更新する
6. プルリクエストの説明には以下を含めてください：
   • 変更内容の概要
   • 関連するIssue番号（ある場合）

開発環境のセットアップ

1. このリポジトリをフォークし、ローカルにクローンします
2. 必要な依存関係をインストールします：

   npm ci

3. テーマのディレクトリに移動します：

   cd themes/develop

4. 開発サーバーを起動します：

   npm run dev

リリース手順

このプロジェクトでは、セマンティックバージョニングに基づいて以下のリリースコマンドが用意されています：

• npm run release:patch - パッチバージョンを更新します（バグ修正など）
• npm run release:minor - マイナーバージョンを更新します（後方互換性のある機能追加など）
• npm run release:major - メジャーバージョンを更新します（後方互換性のない変更など）

リリースの手順：

1. develop ブランチで開発作業が完了したことを確認
2. 変更の種類に応じて、適切なリリースコマンドを実行

   # 例：パッチリリースの場合
   npm run release:patch

3. 自動的にバージョン番号が更新され、コミットが作成されます
4. GitHub 上で main ブランチにプルリクエストを作成します
5. プルリクエストがマージされると、GitHub上でタグの発行とリリースの作成が自動で行われます

コーディング規約

• Tailwind CSSのベストプラクティスに従ってください
• コンポーネントは再利用可能で、適切に分割されているようにしてください
• コードの可読性を重視してください