Skip to content

Commit

Permalink
update terre docs
Browse files Browse the repository at this point in the history
  • Loading branch information
MakinoharaShoko committed Sep 8, 2024
1 parent 6a1120a commit 6529b95
Show file tree
Hide file tree
Showing 6 changed files with 147 additions and 0 deletions.
2 changes: 2 additions & 0 deletions src/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@

- [我想要参与引擎开发或了解如何从源代码开发 WebGAL](developers)

- [我想要了解如何定制开发或贡献 WebGAL Terre 编辑器](developers/terre)

- [如何在编辑器中使用自己或他人开发的定制引擎](derivative)

- [我想要了解 WebGAL 引擎的技术实现](tech)
Expand Down
47 changes: 47 additions & 0 deletions src/developers/terre.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

## 包介绍

| 包名 | 说明 |
Expand Down
2 changes: 2 additions & 0 deletions src/en/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
47 changes: 47 additions & 0 deletions src/en/developers/terre.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
2 changes: 2 additions & 0 deletions src/ja/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@

- [WebGAL の開発に参加したり、ソースコードから WebGAL を開発する方法を学びたい](developers)

- [WebGAL Terre エディターのカスタマイズ開発や貢献について](developers/terre)

- [エディタで自分や他の人が開発したカスタムエンジンを使用する方法](derivative)

- [WebGAL エンジンの技術的な実装について知りたい](tech)
Expand Down
47 changes: 47 additions & 0 deletions src/ja/developers/terre.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

## パッケージ紹介

| パッケージ名 | 説明 |
Expand Down

0 comments on commit 6529b95

Please sign in to comment.