Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/.vuepress/config-docs-growi-org.js
Original file line number Diff line number Diff line change
Expand Up @@ -194,10 +194,17 @@ module.exports = {
title: 'Upgrading',
collapsable: false,
children: [
'/en/admin-guide/upgrading/74x.md',
'/en/admin-guide/upgrading/73x.md',
'/en/admin-guide/upgrading/72x.md',
'/en/admin-guide/upgrading/71x.md',
'/en/admin-guide/upgrading/70x.md',
],
},
{
title: 'Upgrading (for older versions)',
collapsable: true,
children: [
'/en/admin-guide/upgrading/63x.md',
'/en/admin-guide/upgrading/62x.md',
'/en/admin-guide/upgrading/61x.md',
Expand Down Expand Up @@ -458,10 +465,17 @@ module.exports = {
title: 'アップグレード',
collapsable: false,
children: [
'/ja/admin-guide/upgrading/74x.md',
'/ja/admin-guide/upgrading/73x.md',
'/ja/admin-guide/upgrading/72x.md',
'/ja/admin-guide/upgrading/71x.md',
'/ja/admin-guide/upgrading/70x.md',
],
},
{
title: 'アップグレード (旧バージョン)',
collapsable: true,
children: [
'/ja/admin-guide/upgrading/63x.md',
'/ja/admin-guide/upgrading/62x.md',
'/ja/admin-guide/upgrading/61x.md',
Expand Down
2 changes: 2 additions & 0 deletions docs/.vuepress/config-help-growi-cloud.js
Original file line number Diff line number Diff line change
Expand Up @@ -208,6 +208,7 @@ module.exports = {
'title': 'アップグレードガイド',
'key': 'upgrade-guide',
'children': [
'/ja/admin-guide/upgrading/74x.md',
'/ja/admin-guide/upgrading/73x.md',
'/ja/admin-guide/upgrading/72x.md',
'/ja/admin-guide/upgrading/71x.md',
Expand Down Expand Up @@ -373,6 +374,7 @@ module.exports = {
'title': 'Uupgrade guide',
'key': 'upgrade-guide',
'children': [
'/en/admin-guide/upgrading/74x.md',
'/en/admin-guide/upgrading/73x.md',
'/en/admin-guide/upgrading/72x.md',
'/en/admin-guide/upgrading/71x.md',
Expand Down
90 changes: 6 additions & 84 deletions docs/en/admin-guide/management-cookbook/import.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# Import Data

GROWI version 3.7.2 and later supports the ability to import data from GROWI, esa.io, and Qiita:Team.

## GROWI archive data import

Imports data from a GROWI archive data zip file.
Expand All @@ -11,11 +9,13 @@ Imports data from a GROWI archive data zip file.
- GROWI archive data can only be imported from the same version of GROWI.

- In a new environment, the import operation should be performed by an Administrator whose username does not exist in the old environment.

:::

:::danger

- Since the data for the import function uses the file system, it may not work properly when the GROWI server is load balanced. For details, see [here](/en/admin-guide/admin-cookbook/loadbalance.html#cautionary-points-about-importing-exporting-data).

:::

### Importable data
Expand Down Expand Up @@ -51,90 +51,12 @@ There are three different rules for importing duplicate data, one for each colle

## Import Data From esa.io

Importing data from esa.io using [API v1](https://docs.esa.io/posts/102) published by esa.io.

### Import Target

| esa.io | | GROWI |
| ---------- | --- | ---------- |
| Articles | → | Pages |
| Category | → | Page Path |

:::danger

- User data will not be imported.
- If a page with the same name already exists in the destination path of GROWI, the page will be skipped.
- If the page's path can't be created in GROWI, the page will be skipped.
- The following metadata on the esa.io page is not imported:
- The user who created the page and the user who last updated the page.
- On GROWI, the current user will be overwritten by the user who executed the import.
- Page creation date and time, the date and time of the page's last update.
- On GROWI, the previous date and time will be overwritten by the date and time when the import is executed.
- star
- watch
- tag
- comment
- WIP/Ship it
- revisions and changelog
- Attachment will be displayed by accessing the attachment URL managed by esa.io. Therefore, if the file is deleted on esa.io, the page will be broken.
:::warning
From GROWI v7.4 onwards, importing data from esa.io is no longer supported.
:::

### Import Method

1. Log in to esa.io with owner account and access [Settings] → [User Settings] → [Applications] from the tab on the left.
2. Click the [Generate new token] under [Personal access tokens] to issue a token to access esa.io from GROWI.
3. Enter the token, check the [Read] box under [Select scopes] then click [Save].

<img :src="$withBase('/assets/images/import1.png')" alt="import1">

4. Save the generated token.

<img :src="$withBase('/assets/images/import2.png')" alt="import2">

5. Log in to GROWI with an administrator account and go to [Admin/Data Import] (`/admin/importer`).
6. In [Import from esa.io] section, enter the esa.io Team name and Access token (the token saved earlier) then update.
7. Execute [Test connection to esa], If `Test connection to esa success.` is displayed then the connection is successful.
8. Execute [Import] while connected to esa.io, and the page import will start.

## Import Data From Qiita:Team

Importing data from Qiita:Team using [API v2](https://qiita.com/api/v2/docs) published by Qiita:Team.

### Import Target

| Qiita:Team | | GROWI |
| ---------- | --- | ---------- |
| Articles | → | Pages |

:::danger

- User data, project data and group data are not imported.
- If a page with the same name already exists in the destination path of GROWI, the page will be skipped.
- If the page path can't be created in GROWI, the page will be skipped.
- The following metadata on Qiita:Team will not be imported:
- The user who created the page and the user who last updated the page.
- On GROWI, the current user will be overwritten by the user who executed the import.
- Page creation date and time, the date and time of the page's last update.
- On GROWI, the previous date and time will be overwritten by the date and time when the import is executed.
- Reaction to a page.
- Public Range, Collaborative Edit Mode
- Tag
- Comment
- Edit History
- Attachment will be displayed by accessing the attachment URL managed by Qiita:Team. Therefore, if the file is deleted on Qiita:Team, the page will be broken.
:::warning
From GROWI v7.4 onwards, importing data from Qiita:Team is no longer supported.
:::


### Import Method

1. Log in to Qiita:Team with the owner account. Click the user icon in the upper right to access [Settings] from the dropdown menu.
2. Open the [Applications] tab on the user account, and under [Personal access tokens], click [Generate new token]
3. Enter [Description], check [read_qiita_team] in [Scopes], then click [Generate token].

<img :src="$withBase('/assets/images/import3.png')" alt="import3">

4. Save the generated token.
5. Log in to GROWI with an administrator account and go to [Admin/Data Import] (`/admin/importer`).
6. In [Import from Qiita:Team] section, enter the Qiita:Team Team name and Access token (the token saved earlier) then update.
7. Execute [Test Connection], If `Test connection to qiita:team success.` is displayed then the connection is successful.
8. Execute [Import] while connected to Qiita:Team, and the page import will start.
38 changes: 38 additions & 0 deletions docs/en/admin-guide/upgrading/74x.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Upgrading to GROWI v7.4.x

In GROWI v7.4, performance for page display and transitions, as well as rendering performance and memory consumption for the page tree displayed in the sidebar,
have been significantly improved.


## Table of Contents

[[toc]]


## [Deprecated] Removal of Import Feature from esa.io and Qiita:Team

The feature to import data from esa.io and Qiita:Team via the admin panel has been removed.


## For Users

### [Improvement] Performance Improvement in Page Display and Transition

We have fundamentally reviewed the data fetching logic and rendering efficiency during initial access and page transitions, achieving significant performance improvements.


### [Improvement] Performance Improvement in Page Tree

In v7.3 and earlier versions, displaying a large number of pages in the sidebar page tree or page selection modals could increase the load on the browser.

In v7.4, this has been improved to achieve good rendering performance even when displaying large amounts of data, and memory consumption has also been optimized.


### [Improvement] Page Controls on Empty Page

Even when displaying an empty page, some operations such as page search, invoking GROWI AI, renaming, and deleting the page are now possible from the controls at the top right of the page.


## Things to Check Before Upgrading

None.
85 changes: 4 additions & 81 deletions docs/ja/admin-guide/management-cookbook/import.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
# データのインポート

GROWI v3.7.2 以降でGROWI、 esa.io、Qiita:Team のデータをインポートする機能をサポートしています。

## GROWI アーカイブデータインポート

GROWI のアーカイブデータの zip ファイルからデータをインポートします。
Expand Down Expand Up @@ -55,90 +53,15 @@ GROWI アーカイブデータは同バージョンの GROWI のみインポー

## esa.io のデータインポート

esa.io が公開している [API v1](https://docs.esa.io/posts/102) を利用して esa.io のデータをインポートします。

### インポート対象
:::warning
GROWI v7.4 以降、esa.io からのデータインポートはサポートされなくなりました。

| esa.io | | GROWI |
| ---------- | --- | ---------- |
| 記事 | → | ページ |
| カテゴリー | → | ページパス |

:::danger

- ユーザーデータはインポートされません。
- 同名ページがインポート先の GROWI にすでに存在している場合、そのページはスキップされます。
- GROWI において作成不可能なページパスの場合、そのページはスキップされます。
- esa.io のページにおける以下のメタデータはインポートされません。
- ページ作成ユーザー、ページ最終更新ユーザー
- GROWI 上ではインポートを実行したユーザーに上書きされます。
- ページ作成日時、ページ最終更新日時
- GROWI 上ではインポートを実行した日時に上書きされます。
- star
- watch
- tag
- comment
- WIP/Ship it
- revisions および changelog
- 添付ファイルは esa.io が管理している添付ファイル用 URL にアクセスするという方法で表示されます。そのため esa.io 上でファイルが削除された場合ページはリンク切れになります。
:::

### インポート方法

1. esa.io に owner アカウントでログインし、左側のタブから [SETTINGS] → [ユーザー設定] → [Applications] の画面にアクセスします。
2. [Personal access tokens] の [Generate new token] ボタンをクリックし、GROWI から esa.io にアクセスするためのトークンを発行します。
3. トークン名を入力し、[Select scopes] の [Read] にチェックを入れ、[Save] します。

<img :src="$withBase('/assets/images/import1.png')" alt="import1">

4. 生成されたトークンを保存します。

<img :src="$withBase('/assets/images/import2.png')" alt="import2">

5. GROWI に管理者アカウントでログインし、[管理/データインポート] (`/admin/importer`) にアクセスします。
6. [esa.io からのインポート] において、esa.io のチーム名とアクセストークン(先ほど保存したトークン)を入力し、更新します。
7. [接続テスト] を実行し、`Test connection to esa success.` のアラートが表示されたら接続成功です。
8. esa.io に接続可能な状態で [インポート] を実行するとページのインポートが開始されます。

## Qiita:Team のデータインポート

Qiita:Team が公開している [API v2](https://qiita.com/api/v2/docs) を利用して Qiita:Team のデータをインポートします。

### インポート対象
:::warning
GROWI v7.4 以降、Qiita:Team からのデータインポートはサポートされなくなりました。

| Qiita:Team | | GROWI |
| ---------- | --- | ---------- |
| 記事 | → | ページ |

:::danger

- ユーザーデータ、プロジェクトデータ、グループデータはインポートされません。
- 同名ページがインポート先の GROWI にすでに存在している場合、そのページはスキップされます。
- GROWI において作成不可能なページパスの場合、そのページはスキップされます。
- Qiita:Team のページにおける以下のメタデータはインポートされません。
- ページ作成ユーザー、ページ最終更新ユーザー
- GROWI 上ではインポートを実行したユーザーに上書きされます。
- ページ作成日時、ページ最終更新日時
- GROWI 上ではインポートを実行した日時に上書きされます。
- ページに対するリアクション
- 公開範囲、共同編集モード
- タグ
- コメント
- 編集履歴
- 添付ファイルは Qiita:Team が管理している添付ファイル用 URL にアクセスするという方法で表示されます。そのため Qiita:Team 上でファイルが削除された場合ページはリンク切れになります。
:::


### インポート方法

1. Qiita:Team に owner アカウントでログインし、右上のユーザーアイコンをクリックすると表示されるドロップダウンから [設定] の画面にアクセスします。
2. ユーザーアカウントの [アプリケーション] タブを開き、[個人用アクセストークン] にて [新しくトークンを発行する] をクリックします。
3. [アクセストークンの説明] を入力し、[スコープ] の [Read_qiita_team] にチェックを入れ、[発行する] をクリックします。

<img :src="$withBase('/assets/images/import3.png')" alt="import3">

4. 生成されたトークンを保存します。
5. GROWI に管理者アカウントでログインし、[管理/データインポート] (`/admin/importer`) にアクセスします。
6. [Qiita:Team からのインポート] において、Qiita:Team のチーム名とアクセストークン(先ほど保存したトークン)を入力し、更新します。
7. [接続テスト] を実行し、`Test connection to qiita:team success.` のアラートが表示されたら接続成功です。
8. Qiita:Team に接続可能な状態で [インポート] を実行するとページのインポートが開始されます。
38 changes: 38 additions & 0 deletions docs/ja/admin-guide/upgrading/74x.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# GROWI v7.4.x へのアップグレード

GROWI v7.4 では、ページ表示・ページ遷移時のパフォーマンス、そしてサイドバー等に表示されるページツリーのレンダリングパフォーマンスとメモリ消費量が大幅に改善されました。


## 目次

[[toc]]


## [廃止] esa.io および Qiita:Team からのインポート機能

管理画面から、esa.io および Qiita:Team からデータをインポートする機能が削除されました。


## 利用者向け

### [改善] ページ表示・ページ遷移のパフォーマンスアップ

初回アクセス時、ページ遷移時ののデータ取得ロジックやレンダリング効率を抜本的に見直し、大幅なパフォーマンスアップを達成しました。


### [改善] ページツリーのパフォーマンスアップ

<!-- textlint-disable weseek/no-doubled-joshi -->
v7.3 系以前では、サイドバーのページツリーやページ選択用のモーダル等に大量のページを表示する際、ブラウザへの負荷が高まるケースがありました。

v7.4 系ではこれを改善し、大量のデータを表示するようなシーンでも良好なレンダリングパフォーマンスを実現し、メモリ消費に関しても最適化されました。


### [改善] 空ページ表示時のページコントロール

空ページ表示時でも、ページ右上のコントロールからページ検索や GROWI AI 呼び出し、ページ名変更や削除などの一部の操作を可能にしました。


## アップグレード前にチェックすべきこと

なし。