Upgrading (CIDRAM/CIDRAM#121).

Author: Maikuolan

readme.de.md

@@ -10,6 +10,7 @@
 - 7. [BEKANNTE KOMPATIBILITÄTSPROBLEME](#user-content-SECTION7)
 - 8. [HÄUFIG GESTELLTE FRAGEN (FAQ)](#user-content-SECTION8)
 - 9. [RECHTSINFORMATION](#user-content-SECTION9)
+- 10. [UPGRADE VON FRÜHEREN HAUPTVERSIONEN](#user-content-SECTION10)
 
 *Regarding translations: My native language is English. Because this is a free and open-source hobby project which generates zero income, and translatable content is likely to change as the features and functionality supported by the project changes, it doesn't make sense for me to spend money for translations. Because I'm the sole author/developer/maintainer for the project and I'm not a ployglot, any translations I produce are very likely to contain errors. Sorry, but realistically, that won't ever change. If you find any such errors/typos/mistakes/etc, your assistance to correct them would be very much appreciated. Pull requests are invited and encouraged. Otherwise, if you find these errors too much to handle, just stick with the original English source. If a translation is irredeemably incomprehensible, let me know which, and I can delete it. If you're not sure how to perform pull requests, ask. I can help.*
 
@@ -2259,4 +2260,31 @@ Alternativ gibt es einen kurzen (nicht autoritativen) Überblick über die GDPR/
 ---
 
 
-Zuletzt aktualisiert: 14. Juni 2023 (2023.06.14).
+### 10. <a name="SECTION10"></a>UPGRADE VON FRÜHEREN HAUPTVERSIONEN
+
+#### 10.0 CIDRAM v3
+
+Es gibt erhebliche Unterschiede zwischen v3 und früheren Hauptversionen. Einstiegspunkte, Module, und der Updater unterscheiden sich in v3 im Vergleich zu früheren Hauptversionen. Aufgrund der Unterschiede wäre die Durchführung einer Neuinstallation die beste Möglichkeit, von früheren Hauptversionen auf v3 zu aktualisieren.
+
+Wenn Sie Ihre Konfiguration und Ihre Hilfsregeln behalten möchten, rufen Sie vor Beginn des Upgrade-Vorgangs die Front-End-Datensicherung-Seite auf. Von dort aus können Konfigurations und Hilfsregeln exportiert werden. Beim Exportieren wird eine Datei heruntergeladen. Nach dem Upgrade auf die neue Hauptversion können mit dieser Datei die zuvor exportierten Daten in die Installation importiert werden.
+
+Module, die für frühere Hauptversionen vorgesehen waren, müssten aufgrund von Änderungen in der Struktur der Module umgeschrieben werden, damit sie für v3 ordnungsgemäß funktionieren. Eine direkte Migration wird nicht funktionieren. Dasselbe gilt auch für Ereignissen.
+
+v3 bringt keine Änderungen an Signaturdateien, so Signaturdateien die für frühere Hauptversionen gedacht waren, ohne zu erwartende Probleme direkt in v3 migriert werden können.
+
+Seit v3 haben Module, Signaturdateien, und Ereignisse jeweils eigene Verzeichnisse (so Sie werden in diese Verzeichnisse und nicht in das Stammverzeichnis).
+
+Einige der für frühere Hauptversionen öffentlich verfügbaren Signaturdateien, Module, und Blocklisten sind obsolet, so für v3 nicht alles verfügbar sein wird. In den meisten Fällen werden sie aufgrund der seit v3 hinzugefügten neuen Funktionen ohnehin nicht benötigt.
+
+Es gibt einige subtile Änderungen an der Struktur der Hilfsregeln und an der Konfiguration, aber wenn Sie die Import/Export Funktionalität auf der Front-End-Datensicherung-Seite verwenden, müssen Sie nichts manuell umschreiben, anpassen, oder neu erstellen. Beim Import weiß CIDRAM, was benötigt wird, und erledigt dies automatisch für Sie.
+
+#### 10.1 CIDRAM v4
+
+CIDRAM v4 existiert derzeit nicht. Wenn jedoch die Zeit für ein Upgrade von v3 auf v4 gekommen ist, sollte der Upgrade-Prozess viel einfacher sein. Bis dahin werden wir nicht genau wissen, wie unterschiedlich es sein wird, aber ich antizipieren, dass die Unterschiede viel geringer sein werden als zuvor, und bereits von Anfang an Mechanismen in v3 implementiert wurden, um den Upgrade-Prozess einfacher zu gestalten. Solange es keine wesentlichen Änderungen am Updater oder an der Einstiegspunkte gibt, sollte es theoretisch möglich sein, ein Upgrade vollständig über das Front-End durchzuführen, keine Neuinstallation erforderlich.
+
+Detailliertere Informationen werden zu einem späteren Zeitpunkt hier in der Dokumentation enthalten sein.
+
+---
+
+
+Zuletzt aktualisiert: 24. Juli 2023 (2023.07.24).

readme.en.md

@@ -2247,15 +2247,15 @@ Alternatively, there's a brief (non-authoritative) overview of GDPR/DSGVO availa
 
 #### 10.0 CIDRAM v3
 
-There are significant differences between v3 and previous major versions. Importantly, the way entrypoints work, the way modules are structured, and the way the updater works for v3 is different to the way those things worked for previous major versions. Because of these differences, the best way to ugprade to v3 from previous major versions would be to perform a fresh installation.
+There are significant differences between v3 and previous major versions. Importantly, the way entrypoints work, the way modules are structured, and the way the updater works for v3 is different to the way those things worked for previous major versions. Because of these differences, the best way to upgrade to v3 from previous major versions would be to perform a fresh installation.
 
 If you want to keep your configuration and your auxiliary rules, before beginning the upgrade process, go to the front-end backup page. From there, configuration and auxiliary rules can be exported. Exporting will cause a file to be downloaded. After upgrading to the new major version, that file can be used to import the previously exported data to the installation.
 
 Because of changes to the way modules are structured, modules intended for previous major versions would need to be rewritten in order to work properly for v3. Direct migration won't work. The same is true for events.
 
 The way signature files are structured has not changed, so signature files intended for previous major verions can be directly migrated into v3 without any problems anticipated.
 
-Modules, signature files, and events each have their own dedicated directories, which is a new addition since v3 (so, for v3, they would each go into their respective dedicated directories, instead of the root of the vault).
+Since v3, modules, signature files, and events each have their own dedicated directories (so, for v3, they would each go into their respective dedicated directories, instead of the root of the vault).
 
 Some of the signature files, modules, and blocklists publicly available for previous major versions have been deprecated, so not everything will be available for v3. In most cases, they won't be needed anyway, due to new features and core functionality added since v3.
 
@@ -2270,4 +2270,4 @@ More detailed information will be included here, in the documentation, at an app
 ---
 
 
-Last Updated: 21 July 2023 (2023.07.21).
+Last Updated: 24 July 2023 (2023.07.24).

readme.ja.md

@@ -10,6 +10,7 @@
 - ７.[適合性問題](#user-content-SECTION7)
 - ８.[よくある質問（ＦＡＱ）](#user-content-SECTION8)
 - ９.[法律情報](#user-content-SECTION9)
+- １０.[以前のメジャー・バージョンからのアップグレード](#user-content-SECTION10)
 
 *Regarding translations: My native language is English. Because this is a free and open-source hobby project which generates zero income, and translatable content is likely to change as the features and functionality supported by the project changes, it doesn't make sense for me to spend money for translations. Because I'm the sole author/developer/maintainer for the project and I'm not a ployglot, any translations I produce are very likely to contain errors. Sorry, but realistically, that won't ever change. If you find any such errors/typos/mistakes/etc, your assistance to correct them would be very much appreciated. Pull requests are invited and encouraged. Otherwise, if you find these errors too much to handle, just stick with the original English source. If a translation is irredeemably incomprehensible, let me know which, and I can delete it. If you're not sure how to perform pull requests, ask. I can help.*
 
@@ -2220,4 +2221,31 @@ CIDRAMは、マーケティングやアドバタイジング目的で情報を
 ---
 
 
-最終アップデート：２０２３年６月１４日。
+### １０.<a name="SECTION10"></a>以前のメジャー・バージョンからのアップグレード
+
+#### 10.0 CIDRAM v3
+
+v3と以前のメジャー・バージョンの間には大きな違いがあります。​特に、エントリポイントの動作方法、モジュールの構造化方法、およびv3でのアップデータの動作方法は、以前のメジャー・バージョンでの動作方法とは異なります。​これらの違いのため、以前のメジャー・バージョンからv3にアップグレードする最善の方法は、新規インストールを実行することです。
+
+コンフィギュレーションと補助ルールを保持したい場合は、アップグレード・プロセスを開始する前に、フロントエンド・バックアップ・ページに移動してください。​そこから、コンフィギュレーションと補助ルールをエクスポートできます。​エクスポートすると、ファイルがダウンロードされます。​新しいメジャー・バージョンにアップグレードした後、そのファイルを使用して、以前にエクスポートしたデータをインストール環境にインポートできます。
+
+モジュールの構造が変更されたため、v3で適切に動作するには、以前のメジャー・バージョン向けのモジュールを書き直す必要があります。​直接移行は機能しません。​同じことがイベントにも当てはまります。
+
+シグネチャ・ファイルの構造は変更されていないため、以前のメジャー・バージョン向けのシグネチャ・ファイルは問題なくv3に直接移行できます。
+
+v3以降、モジュール、シグネチャ・ファイル、イベントにはそれぞれ専用のディレクトリがあります（したがって、ルートではなく、これらのディレクトリに配置されます）。
+
+陳腐化により、以前のメジャー・バージョンのシグネチャ・ファイル、モジュール、ブロックリストの一部（ほんの一部）は、v3では利用できなくなります。​v3以降に追加された新機能により、ほとんどの場合、それらは必要ありません。
+
+補助ルールの構造には微妙な変更がいくつかあり、コンフィギュレーションにも変更がありますが、フロントエンド・バックアップ・ページでインポートおよびエクスポート機能を使用する場合は、手動で書き換えたり、調整したり、再作成したりする必要はありません。​インポート時に、CIDRAMは何が必要かを認識し、自動的に処理します。
+
+#### 10.1 CIDRAM v4
+
+v4はまだ存在しません。​ただし、v3からv4にアップグレードするときは、アップグレード・プロセスがはるかに簡単になるはずです。​その時が来るまで、どれほど大きな違いがあるのか正確にはわかりませんが、違いは以前よりもはるかに小さくなると予想しており、アップグレード・プロセスを簡素化するためのメカニズムが最初からv3に実装されています。​アップデーターやエントリポイントの動作方法に大きな変更がない限り、理論的には、新規インストールを実行することなく、フロントエンド経由で完全にアップグレードできるはずです。
+
+より詳細な情報は、将来の適切な時期にドキュメントに追加される予定です。
+
+---
+
+
+最終アップデート：２０２３年７月２４日。

readme.ko.md

@@ -10,6 +10,7 @@
 - 7. [알려진 호환성 문제](#user-content-SECTION7)
 - 8. [자주 묻는 질문 (FAQ)](#user-content-SECTION8)
 - 9. [법률 정보](#user-content-SECTION9)
+- 10. [이전 주 버전에서 업그레이드](#user-content-SECTION10)
 
 *Regarding translations: My native language is English. Because this is a free and open-source hobby project which generates zero income, and translatable content is likely to change as the features and functionality supported by the project changes, it doesn't make sense for me to spend money for translations. Because I'm the sole author/developer/maintainer for the project and I'm not a ployglot, any translations I produce are very likely to contain errors. Sorry, but realistically, that won't ever change. If you find any such errors/typos/mistakes/etc, your assistance to correct them would be very much appreciated. Pull requests are invited and encouraged. Otherwise, if you find these errors too much to handle, just stick with the original English source. If a translation is irredeemably incomprehensible, let me know which, and I can delete it. If you're not sure how to perform pull requests, ask. I can help.*
 
@@ -2237,4 +2238,31 @@ CIDRAM은 마케팅이나 광고 목적으로 정보를 수집하거나 처리
 ---
 
 
-최종 업데이트 : 2023년 6월 14일.
+### 10. <a name="SECTION10"></a>이전 주 버전에서 업그레이드
+
+#### 10.0 CIDRAM v3
+
+v3와 이전 주 버전 간에는 상당한 차이가 있습니다. 진입점이 작동하는 방식, 모듈이 구성되는 방식, 및 업데이터가 v3에서 작동하는 방식은 이전 주요 버전에서 작동하는 방식과 다릅니다. 이러한 차이점 때문에, 이전 주 버전에서 v3로 업그레이드하는 가장 좋은 방법은 새로 설치하는 것입니다.
+
+구성 및 보조 규칙을 유지하려면, 업그레이드 프로세스를 시작하기 전에, 프런트 엔드 백업 페이지로 이동하십시오. 여기에서, 구성 및 보조 규칙을 내보낼 수 있습니다. 내보내면 파일이 다운로드됩니다. 새 주 버전으로 업그레이드한 후, 해당 파일을 사용하여 이전에 내보낸 데이터를 설치로 가져올 수 있습니다.
+
+모듈이 구성되는 방식이 변경되었기 때문에, v3에서 제대로 작동하려면 이전 주 버전용 모듈을 다시 작성해야 합니다. 직접 마이그레이션이 작동하지 않습니다. 이벤트도 마찬가지입니다.
+
+서명 파일이 구성되는 방식은 변경되지, 않았으므로 이전 주요 버전용 서명 파일을 예상되는 문제 없이 v3로 직접 마이그레이션할 수 있습니다.
+
+v3부터, 모듈, 서명 파일, 및 이벤트에는 각각 고유한 전용 디렉터리가 있습니다 (그래서 그들은 vault 바닥 대신에 거기로 갈 것입니다).
+
+이전 주 버전의 서명 파일, 모듈, 및 차단 목록 중 일부는 v3에서 사용할 수 없습니다. 대부분의 경우, v3 이후에 추가된 새로운 기능으로 인해, 필요하지 않습니다.
+
+보조 규칙 및 구성이 약간 변경되었지만, 프런트 엔드 백업 페이지에서 가져오기/내보내기 기능을 사용하면, 수동으로 수행할 작업이 불필요. 가져올 때, CIDRAM은 무엇이 필요한지 알고 자동으로 처리합니다.
+
+#### 10.1 CIDRAM v4
+
+v4는 아직 존재하지 않습니다. 그러나, v3에서 v4로 업그레이드할 때가 되면 업그레이드 프로세스가 훨씬 간단해집니다. 때가 오기 전까지는, 얼마나 크게 달라질지 정확히 알 수 없지만, 그 차이는 이전보다 훨씬 적을 것으로 예상되며, 업그레이드 프로세스를 더 간단하게 만들기 위해 메커니즘이 v3에 이미 구현되었습니다. 업데이터나 진입점이 작동하는 방식에 큰 변화가 없는 한, 이론상 새로 설치할 필요 없이 프런트 엔드를 통해 완전히 업그레이드할 수 있어야 합니다.
+
+더 자세한 정보는 향후 적절한 시기에 설명서에 포함됩니다.
+
+---
+
+
+최종 업데이트 : 2023년 7월 24일.

readme.zh-tw.md

@@ -10,6 +10,7 @@
 - 7. [已知的兼容問題](#user-content-SECTION7)
 - 8. [常見問題（FAQ）](#user-content-SECTION8)
 - 9. [法律信息](#user-content-SECTION9)
+- 10. [從以前的主要版本升級](#user-content-SECTION10)
 
 *Regarding translations: My native language is English. Because this is a free and open-source hobby project which generates zero income, and translatable content is likely to change as the features and functionality supported by the project changes, it doesn't make sense for me to spend money for translations. Because I'm the sole author/developer/maintainer for the project and I'm not a ployglot, any translations I produce are very likely to contain errors. Sorry, but realistically, that won't ever change. If you find any such errors/typos/mistakes/etc, your assistance to correct them would be very much appreciated. Pull requests are invited and encouraged. Otherwise, if you find these errors too much to handle, just stick with the original English source. If a translation is irredeemably incomprehensible, let me know which, and I can delete it. If you're not sure how to perform pull requests, ask. I can help.*
 
@@ -2195,4 +2196,31 @@ CIDRAM不收集或處理任何信息用於營銷或廣告目的，既不銷售
 ---
 
 
-最後更新：2023年6月14日。
+### 10. <a name="SECTION10"></a>從以前的主要版本升級
+
+#### 10.0 CIDRAM v3
+
+v3與之前的主要版本之間存在顯著差異。​特別是，入口點、模塊、和更新程序的工作方式不同。​因此，從以前的主要版本升級到v3的最佳方法是執行全新安裝。
+
+如果您想保留配置和輔助規則，在開始升級過程之前，轉到前端備份頁面。​從那裡，可以導出配置和輔助規則。​導出將導致下載文件。​升級到新的主要版本後，該文件可用於將之前導出的數據導入到安裝中。
+
+由於模塊結構的差異，要適用於v3，舊模塊需要重寫。​直接遷移不行。​對於事件來說也是如此。
+
+簽名文件結構沒有改變，所以舊簽名文件可以直接遷移到v3。​預計沒有問題。
+
+從v3開始，模塊、簽名文件、和事件都有專用目錄（所以他們會進入這些目錄而不是根目錄）。
+
+一些簽名文件、模塊、和阻止列表已被棄用並且不可用於v3。​在大多數情況下，由於自v3以來添加了新功能，因此不需要它們。
+
+輔助規則結構和配置有一些細微的變化，但如果您在前端備份頁面使用導入/導出功能，則無需手動執行任何操作。​導入時，CIDRAM知道需要什麼，並會自動為您處理。
+
+#### 10.1 CIDRAM v4
+
+v4目前不存在。​不過，當從v3升級到v4時，升級過程應該會簡單得多。​在那之前，我們不會確切地知道會有多大的不同，但我預計差異會比以前小得多。​v3中已經實施了一些機制，使升級過程更加簡單。​如果更新程序和入口點差別不大，則應該可以完全通過前端進行升級，而無需執行全新安裝。
+
+未來將包含更詳細的信息。
+
+---
+
+
+最後更新：2023年7月24日。