From 41143073aa5a436ccd7e0a1965a14f7e3db26149 Mon Sep 17 00:00:00 2001 From: Yuki Takei Date: Mon, 22 Dec 2025 13:37:49 +0000 Subject: [PATCH 1/4] update import.md --- .../admin-guide/management-cookbook/import.md | 90 ++----------------- .../admin-guide/management-cookbook/import.md | 85 +----------------- 2 files changed, 10 insertions(+), 165 deletions(-) diff --git a/docs/en/admin-guide/management-cookbook/import.md b/docs/en/admin-guide/management-cookbook/import.md index fb753d5ffb..1ca56fa93c 100644 --- a/docs/en/admin-guide/management-cookbook/import.md +++ b/docs/en/admin-guide/management-cookbook/import.md @@ -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. @@ -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 @@ -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]. - - import1 - -4. Save the generated token. - - 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]. - -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. diff --git a/docs/ja/admin-guide/management-cookbook/import.md b/docs/ja/admin-guide/management-cookbook/import.md index e7227bca89..03cafe5381 100644 --- a/docs/ja/admin-guide/management-cookbook/import.md +++ b/docs/ja/admin-guide/management-cookbook/import.md @@ -1,7 +1,5 @@ # データのインポート -GROWI v3.7.2 以降でGROWI、 esa.io、Qiita:Team のデータをインポートする機能をサポートしています。 - ## GROWI アーカイブデータインポート GROWI のアーカイブデータの zip ファイルからデータをインポートします。 @@ -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] します。 - - import1 - -4. 生成されたトークンを保存します。 - - 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] にチェックを入れ、[発行する] をクリックします。 - -import3 - -4. 生成されたトークンを保存します。 -5. GROWI に管理者アカウントでログインし、[管理/データインポート] (`/admin/importer`) にアクセスします。 -6. [Qiita:Team からのインポート] において、Qiita:Team のチーム名とアクセストークン（先ほど保存したトークン）を入力し、更新します。 -7. [接続テスト] を実行し、`Test connection to qiita:team success.` のアラートが表示されたら接続成功です。 -8. Qiita:Team に接続可能な状態で [インポート] を実行するとページのインポートが開始されます。 From 029b798a1127b04fc71ea9c43f38afe829053003 Mon Sep 17 00:00:00 2001 From: Yuki Takei Date: Mon, 22 Dec 2025 13:42:26 +0000 Subject: [PATCH 2/4] docs: add sections for upgrading older versions in English and Japanese --- docs/.vuepress/config-docs-growi-org.js | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/.vuepress/config-docs-growi-org.js b/docs/.vuepress/config-docs-growi-org.js index 092467fc23..e2bda27abd 100644 --- a/docs/.vuepress/config-docs-growi-org.js +++ b/docs/.vuepress/config-docs-growi-org.js @@ -198,6 +198,12 @@ module.exports = { '/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', @@ -462,6 +468,12 @@ module.exports = { '/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', From d04b649f23e17e91504d15d998f33d58497fa865 Mon Sep 17 00:00:00 2001 From: Yuki Takei Date: Mon, 22 Dec 2025 14:09:04 +0000 Subject: [PATCH 3/4] fix textlint error --- docs/ja/admin-guide/management-cookbook/import.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ja/admin-guide/management-cookbook/import.md b/docs/ja/admin-guide/management-cookbook/import.md index 03cafe5381..cbde3cb41a 100644 --- a/docs/ja/admin-guide/management-cookbook/import.md +++ b/docs/ja/admin-guide/management-cookbook/import.md @@ -54,7 +54,7 @@ GROWI アーカイブデータは同バージョンの GROWI のみインポー ## esa.io のデータインポート :::warning -GROWI v7.4 以降、esa.io からのデータインポートはサポートされなくなりました +GROWI v7.4 以降、esa.io からのデータインポートはサポートされなくなりました。 ::: @@ -62,6 +62,6 @@ GROWI v7.4 以降、esa.io からのデータインポートはサポートさ ## Qiita:Team のデータインポート :::warning -GROWI v7.4 以降、Qiita:Team からのデータインポートはサポートされなくなりました +GROWI v7.4 以降、Qiita:Team からのデータインポートはサポートされなくなりました。 ::: From 254db4dfc071eaf52ab00dbbeae8d1ddd67dc0f8 Mon Sep 17 00:00:00 2001 From: Yuki Takei Date: Mon, 22 Dec 2025 14:09:20 +0000 Subject: [PATCH 4/4] add 74x.md --- docs/.vuepress/config-docs-growi-org.js | 2 ++ docs/.vuepress/config-help-growi-cloud.js | 2 ++ docs/en/admin-guide/upgrading/74x.md | 38 +++++++++++++++++++++++ docs/ja/admin-guide/upgrading/74x.md | 38 +++++++++++++++++++++++ 4 files changed, 80 insertions(+) create mode 100644 docs/en/admin-guide/upgrading/74x.md create mode 100644 docs/ja/admin-guide/upgrading/74x.md diff --git a/docs/.vuepress/config-docs-growi-org.js b/docs/.vuepress/config-docs-growi-org.js index e2bda27abd..44734a66d3 100644 --- a/docs/.vuepress/config-docs-growi-org.js +++ b/docs/.vuepress/config-docs-growi-org.js @@ -194,6 +194,7 @@ 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', @@ -464,6 +465,7 @@ 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', diff --git a/docs/.vuepress/config-help-growi-cloud.js b/docs/.vuepress/config-help-growi-cloud.js index 38fb255121..9d41f7da4e 100644 --- a/docs/.vuepress/config-help-growi-cloud.js +++ b/docs/.vuepress/config-help-growi-cloud.js @@ -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', @@ -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', diff --git a/docs/en/admin-guide/upgrading/74x.md b/docs/en/admin-guide/upgrading/74x.md new file mode 100644 index 0000000000..3a0f959c71 --- /dev/null +++ b/docs/en/admin-guide/upgrading/74x.md @@ -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. diff --git a/docs/ja/admin-guide/upgrading/74x.md b/docs/ja/admin-guide/upgrading/74x.md new file mode 100644 index 0000000000..1bb90058dd --- /dev/null +++ b/docs/ja/admin-guide/upgrading/74x.md @@ -0,0 +1,38 @@ +# GROWI v7.4.x へのアップグレード + +GROWI v7.4 では、ページ表示・ページ遷移時のパフォーマンス、そしてサイドバー等に表示されるページツリーのレンダリングパフォーマンスとメモリ消費量が大幅に改善されました。 + + +## 目次 + +[[toc]] + + +## [廃止] esa.io および Qiita:Team からのインポート機能 + +管理画面から、esa.io および Qiita:Team からデータをインポートする機能が削除されました。 + + +## 利用者向け + +### [改善] ページ表示・ページ遷移のパフォーマンスアップ + +初回アクセス時、ページ遷移時ののデータ取得ロジックやレンダリング効率を抜本的に見直し、大幅なパフォーマンスアップを達成しました。 + + +### [改善] ページツリーのパフォーマンスアップ + + +v7.3 系以前では、サイドバーのページツリーやページ選択用のモーダル等に大量のページを表示する際、ブラウザへの負荷が高まるケースがありました。 + +v7.4 系ではこれを改善し、大量のデータを表示するようなシーンでも良好なレンダリングパフォーマンスを実現し、メモリ消費に関しても最適化されました。 + + +### [改善] 空ページ表示時のページコントロール + +空ページ表示時でも、ページ右上のコントロールからページ検索や GROWI AI 呼び出し、ページ名変更や削除などの一部の操作を可能にしました。 + + +## アップグレード前にチェックすべきこと + +なし。