https://github.com/appleple/acms-develop
フロントエンドの開発環境が整備された a-blog cms の公式テーマです。
https://github.com/appleple/acms-develop
ablogcms alpinejs htmx pinesui tailwindcss vite
Last synced: 2 months ago
JSON representation
フロントエンドの開発環境が整備された a-blog cms の公式テーマです。
- Host: GitHub
- URL: https://github.com/appleple/acms-develop
- Owner: appleple
- Created: 2024-05-02T02:57:05.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-31T10:24:13.000Z (over 1 year ago)
- Last Synced: 2025-01-31T11:19:55.303Z (over 1 year ago)
- Topics: ablogcms, alpinejs, htmx, pinesui, tailwindcss, vite
- Language: JavaScript
- Homepage:
- Size: 272 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# テーマ「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](https://tailwindcss.com/)
- [Alpine.js](https://alpinejs.dev/)
- [htmx](https://htmx.org/)
- [Vite](https://ja.vitejs.dev/)
- [Pines](https://devdojo.com/pines)
- [tailwindcss typography](https://github.com/tailwindlabs/tailwindcss-typography)
## コントリビューションガイド
このプロジェクトへの貢献に興味を持っていただき、ありがとうございます。以下のガイドラインに従って、プロジェクトへの貢献をお願いいたします。
### プルリクエスト
1. 作業を開始する前に、新しいブランチを作成してください
2. ブランチ名は、`feature/機能名` や `fix/バグ名` などの命名規則に従ってください
3. プルリクエストは develop ブランチに対して作成してください
4. コードの変更は最小限に保ち、1つのプルリクエストにつき1つの機能やバグ修正を含めるようにしてください
5. 以下の点に注意してコードを作成してください：
- コードスタイルは既存のコードに合わせる
- 適切なコメントを追加する
- 必要に応じてドキュメントを更新する
6. プルリクエストの説明には以下を含めてください：
- 変更内容の概要
- 関連するIssue番号（ある場合）
### 開発環境のセットアップ
1. このリポジトリをフォークし、ローカルにクローンします
2. 必要な依存関係をインストールします：
```bash
npm ci
```
3. テーマのディレクトリに移動します：
```bash
cd themes/develop
```
4. 開発サーバーを起動します：
```bash
npm run dev
```
### リリース手順
このプロジェクトでは、セマンティックバージョニングに基づいて以下のリリースコマンドが用意されています：
- `npm run release:patch` - パッチバージョンを更新します（バグ修正など）
- `npm run release:minor` - マイナーバージョンを更新します（後方互換性のある機能追加など）
- `npm run release:major` - メジャーバージョンを更新します（後方互換性のない変更など）
リリースの手順：
1. develop ブランチで開発作業が完了したことを確認
2. 変更の種類に応じて、適切なリリースコマンドを実行
```bash
# 例：パッチリリースの場合
npm run release:patch
```
4. 自動的にバージョン番号が更新され、コミットが作成されます
5. GitHub 上で main ブランチにプルリクエストを作成します
6. プルリクエストがマージされると、GitHub上でタグの発行とリリースの作成が自動で行われます
### コーディング規約
- [Tailwind CSS](https://tailwindcss.com/)のベストプラクティスに従ってください
- コンポーネントは再利用可能で、適切に分割されているようにしてください
- コードの可読性を重視してください