applii-homepage

概要

AppLii のホームページを GitHub Pages で公開するためのリポジトリです。Vue.js(Nuxt.js)と GitHub Pages を使用しています。

URL：https://applii.github.io/

環境構築の方法

1. Node.js のインストール

Node.js のインストールが必要です。（バージョンは v18 以上推奨） node -vを実行して、以下のようにバージョンが表示されれば、インストールは成功しています。

node -v
> v20.12.0

2. プロジェクトのセットアップ

リポジトリをクローンし、ルートディレクトリにおいてnpm installを実行することで、必要なライブラリがインストールされます。

実行例：

git clone https://github.com/AppLii/AppLii.github.io
cd AppLii.github.io
npm install

3. ローカルでの開発方法（ホットリロードの使い方）

このプロジェクトではホットリロード（コードの変更を直ちに反映できる機能）を使いながら開発を行えます。

1. Mainブランチ（もしくは作業したいブランチ）に切り替える
2. npm run devを実行する

おそらくhttp://localhost:3000/をブラウザで開いて数十秒待てば、ホームページと同じものが表示されると思います。

これで、環境構築は完了です。

開発方法

ページの追加方法

/pagesディレクトリに新しい Vue ファイルを作成すると、新しいページを追加できます。

例：

• pages/index.vue → / (ホームページ)
• pages/about.vue → /about
• pages/blog/index.vue → /blog

ページデザインの変更方法

デプロイの方法

1. 作成したコードは、必ずMainブランチにコミット・プッシュしてください。
2. 変更を公開するには、MainブランチからReleaseブランチに対してプルリクエストを行ってください。
3. 自動的にビルド・デプロイが行われます。1 分程度かかります。

その他

ブランチについて

MainブランチとReleaseブランチが存在します。

• Mainブランチ：開発用のため、自由に使っても大丈夫です。
• Releaseブランチ：GitHub Pages で公開するページのソースがこのブランチに保存されます。
• （細かく言うと、MainブランチからReleaseブランチにマージすると GitHub Action によって自動的にビルドされ、Releaseブランチの/docsディレクトリにソースファイルが作成される。このソースファイルが Pages で公開される。）