diff --git a/src/README.md b/src/README.md index 0e79656c..119bef3d 100644 --- a/src/README.md +++ b/src/README.md @@ -6,6 +6,8 @@ - [我想要参与引擎开发或了解如何从源代码开发 WebGAL](developers) +- [我想要了解如何定制开发或贡献 WebGAL Terre 编辑器](developers/terre) + - [如何在编辑器中使用自己或他人开发的定制引擎](derivative) - [我想要了解 WebGAL 引擎的技术实现](tech) diff --git a/src/developers/terre.md b/src/developers/terre.md index c5b6662e..efeb9185 100644 --- a/src/developers/terre.md +++ b/src/developers/terre.md @@ -53,6 +53,53 @@ yarn dev 构建完成后,您可以在 `release` 目录下找到构建产物。 +## 更新 Terre 附带的 WebGAL 引擎模板 + +一般来说,我们会在 WebGAL 更新后将最新版本的引擎模板更新到 Terre 项目中。假如你想在 Terre 中使用你定制的 WebGAL 引擎,请遵循以下步骤: + +1、Clone WebGAL 引擎项目(推荐在相邻目录 Clone,这样可以使用自动化脚本) + +``` +git clone https://github.com/OpenWebGAL/WebGAL.git +``` + +2、**(假设你在 Terre 项目的相邻目录 Clone WebGAL 项目,未这样做的开发者请忽略)** 在 WebGAL 引擎仓库运行自动化脚本构建 WebGAL 到 WebGAL Terre + +``` +sh release-to-terre.sh +``` + +:::warning +**以下步骤适用于手动构建并更新 Terre 中的引擎模板的情况。使用自动化脚本的开发者请忽略!** +::: + +2、构建 WebGAL 项目(此步骤在 WebGAL 引擎仓库中执行) + +``` +yarn +yarn build +``` + +3、删除 WebGAL Terre 里的引擎模板,并移动引擎项目的构建产物到 WebGAL Terre 的模板目录 + +**此处假设你在 Terre 项目的相邻目录 Clone WebGAL 项目,如果你有不同的目录结构,请根据实际情况修改。** + +``` +# 进入 Terre 目录 +cd ../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template || exit +# 删除其他文件 +rm -r assets +rm -r index.html +rm -r webgal-serviceworker.js + +# 进入 WebGAL 构建目录 +cd ../../../../../../WebGAL/packages/webgal || exit +# 复制 +cp -r dist/index.html ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +cp -r dist/assets ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +cp -r dist/webgal-serviceworker.js ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +``` + ## 包介绍 | 包名 | 说明 | diff --git a/src/en/README.md b/src/en/README.md index 4bcdbd63..3b4181d3 100644 --- a/src/en/README.md +++ b/src/en/README.md @@ -6,6 +6,8 @@ - [I want to contribute to the engine development or learn how to develop WebGAL from source](developers) +- [I want to learn how to customize, develop, or contribute to the WebGAL Terre editor](developers/terre) + - [How to use custom engine developed by yourself or others in the editor](derivative) - [I want to learn about the technical implementation of WebGAL engine](tech) diff --git a/src/en/developers/terre.md b/src/en/developers/terre.md index b5951c3b..f170cce7 100644 --- a/src/en/developers/terre.md +++ b/src/en/developers/terre.md @@ -53,6 +53,53 @@ You need to run the build script to generate a releasable version. After the build is complete, you can find the build artifacts in the `release` directory. +## Update the WebGAL Engine Template Included in Terre + +Generally, we will update the latest version of the engine template to the Terre project after the WebGAL update. If you want to use your customized WebGAL engine in Terre, please follow these steps: + +1. Clone the WebGAL engine project (it is recommended to clone in the adjacent directory, so that you can use the automation script) + +``` +git clone https://github.com/OpenWebGAL/WebGAL.git +``` + +2. **(Assuming you cloned the WebGAL project in the directory adjacent to the Terre project, developers who did not do this please ignore)** Run the automation script in the WebGAL engine repository to build WebGAL to WebGAL Terre + +``` +sh release-to-terre.sh +``` + +:::warning +**The following steps apply to manually building and updating the engine template in Terre. Developers using automated scripts please ignore!** +::: + +2. Build the WebGAL project (this step is executed in the WebGAL engine repository) + +``` +yarn +yarn build +``` + +3. Delete the engine template in WebGAL Terre and move the build product of the engine project to the template directory of WebGAL Terre + +**Here we assume that you cloned the WebGAL project in the directory adjacent to the Terre project. If you have a different directory structure, please modify it according to the actual situation.** + +``` +# Enter the Terre directory +cd ../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template || exit +# Delete other files +rm -r assets +rm -r index.html +rm -r webgal-serviceworker.js + +# Enter the WebGAL build directory +cd ../../../../../../WebGAL/packages/webgal || exit +# Copy +cp -r dist/index.html ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +cp -r dist/assets ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +cp -r dist/webgal-serviceworker.js ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +``` + ## Package Introduction | Package Name | Description | diff --git a/src/ja/README.md b/src/ja/README.md index 49aa70b4..9abf7315 100644 --- a/src/ja/README.md +++ b/src/ja/README.md @@ -6,6 +6,8 @@ - [WebGAL の開発に参加したり、ソースコードから WebGAL を開発する方法を学びたい](developers) +- [WebGAL Terre エディターのカスタマイズ開発や貢献について](developers/terre) + - [エディタで自分や他の人が開発したカスタムエンジンを使用する方法](derivative) - [WebGAL エンジンの技術的な実装について知りたい](tech) diff --git a/src/ja/developers/terre.md b/src/ja/developers/terre.md index bcd72951..6124f40d 100644 --- a/src/ja/developers/terre.md +++ b/src/ja/developers/terre.md @@ -53,6 +53,53 @@ yarn dev ビルドが完了すると、`release` ディレクトリにビルド成果物が配置されます。 +## Terre に同梱されている WebGAL エンジンテンプレートの更新 + +通常、WebGAL の更新後、最新バージョンのエンジンテンプレートを Terre プロジェクトに更新します。Terre でカスタマイズした WebGAL エンジンを使用する場合は、次の手順に従ってください。 + +1. WebGAL エンジンリポジトリをクローンします(隣接ディレクトリにクローンすることをお勧めします。これにより、自動化スクリプトを使用できます) + +``` +git clone https://github.com/OpenWebGAL/WebGAL.git +``` + +2. **(Terre プロジェクトの隣接ディレクトリに WebGAL プロジェクトをクローンした場合、そうでない開発者は無視してください)** WebGAL エンジンリポジトリで自動化スクリプトを実行して、WebGAL を WebGAL Terre にビルドします + +``` +sh release-to-terre.sh +``` + +:::warning +**以下の手順は、手動でビルドして Terre のエンジンテンプレートを更新する場合に適用されます。自動化スクリプトを使用する開発者は無視してください!** +::: + +2. WebGAL プロジェクトをビルドします(この手順は WebGAL エンジンリポジトリで実行します) + +``` +yarn +yarn build +``` + +3. WebGAL Terre のエンジンテンプレートを削除し、エンジンプロジェクトのビルド成果物を WebGAL Terre のテンプレートディレクトリに移動します + +**ここでは、Terre プロジェクトの隣接ディレクトリに WebGAL プロジェクトをクローンしていると想定しています。異なるディレクトリ構造を使用している場合は、それに応じて変更してください。** + +``` +# Terre ディレクトリに移動します +cd ../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template || exit +# 他のファイルを削除します +rm -r assets +rm -r index.html +rm -r webgal-serviceworker.js + +# WebGAL ビルドディレクトリに移動します +cd ../../../../../../WebGAL/packages/webgal || exit +# コピーします +cp -r dist/index.html ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +cp -r dist/assets ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +cp -r dist/webgal-serviceworker.js ../../../WebGAL_Terre/packages/terre2/assets/templates/WebGAL_Template +``` + ## パッケージ紹介 | パッケージ名 | 説明 |