docs: add version catalog tutorial

Author: fankes

docs-source/src/en/library/hikage-compiler.md

@@ -56,6 +56,48 @@ dependencies {
 }
 ```
 
+### Version Catalog
+
+Add dependency in your project's `gradle/libs.versions.toml`.
+
+```toml
+[versions]
+ksp = "<ksp-version>"
+hikage-compiler = "<version>"
+
+[plugins]
+ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
+
+[libraries]
+hikage-compiler = { module = "com.highcapable.hikage:hikage-compiler", version.ref = "hikage-compiler" }
+```
+
+Configure dependency in your root project `build.gradle.kts`.
+
+```kotlin
+plugins {
+    // ...
+    alias(libs.plugins.ksp) apply false
+}
+```
+
+Configure dependency in your project `build.gradle.kts`.
+
+```kotlin
+plugins {
+    // ...
+    alias(libs.plugins.ksp)
+}
+
+dependencies {
+    // ...
+    ksp(libs.hikage.compiler)
+}
+```
+
+Please change `<version>` to the version displayed at the top of this document,
+and change `<ksp-version>` to the KSP version corresponding to the Kotlin version currently used by your project.
+
 ### Traditional Method
 
 Configure dependency in your root project `build.gradle.kts`.

docs-source/src/en/library/hikage-core.md

@@ -29,6 +29,26 @@ Configure dependency in your project `build.gradle.kts`.
 implementation(com.highcapable.hikage.hikage.core)
 ```
 
+### Version Catalog
+
+Add dependency in your project's `gradle/libs.versions.toml`.
+
+```toml
+[versions]
+hikage-core = "<version>"
+
+[libraries]
+hikage-core = { module = "com.highcapable.hikage:hikage-core", version.ref = "hikage-core" }
+```
+
+Configure dependency in your project `build.gradle.kts`.
+
+```kotlin
+implementation(libs.hikage.core)
+```
+
+Please change `<version>` to the version displayed at the top of this document.
+
 ### Traditional Method
 
 Configure dependency in your project `build.gradle.kts`.

docs-source/src/en/library/hikage-extension-betterandroid.md

@@ -29,6 +29,26 @@ Configure dependency in your project `build.gradle.kts`.
 implementation(com.highcapable.hikage.hikage.extension.betterandroid)
 ```
 
+### Version Catalog
+
+Add dependency in your project's `gradle/libs.versions.toml`.
+
+```toml
+[versions]
+hikage-extension-betterandroid = "<version>"
+
+[libraries]
+hikage-extension-betterandroid = { module = "com.highcapable.hikage:hikage-extension-betterandroid", version.ref = "hikage-extension-betterandroid" }
+```
+
+Configure dependency in your project `build.gradle.kts`.
+
+```kotlin
+implementation(libs.hikage.extension.betterandroid)
+```
+
+Please change `<version>` to the version displayed at the top of this document.
+
 ### Traditional Method
 
 Configure dependency in your project `build.gradle.kts`.

docs-source/src/en/library/hikage-extension-compose.md

@@ -37,6 +37,26 @@ Configure dependency in your project `build.gradle.kts`.
 implementation(com.highcapable.hikage.hikage.extension.compose)
 ```
 
+### Version Catalog
+
+Add dependency in your project's `gradle/libs.versions.toml`.
+
+```toml
+[versions]
+hikage-extension-compose = "<version>"
+
+[libraries]
+hikage-extension-compose = { module = "com.highcapable.hikage:hikage-extension-compose", version.ref = "hikage-extension-compose" }
+```
+
+Configure dependency in your project `build.gradle.kts`.
+
+```kotlin
+implementation(libs.hikage.extension.compose)
+```
+
+Please change `<version>` to the version displayed at the top of this document.
+
 ### Traditional Method
 
 Configure dependency in your project `build.gradle.kts`.

docs-source/src/en/library/hikage-extension.md

@@ -29,6 +29,26 @@ Configure dependency in your project `build.gradle.kts`.
 implementation(com.highcapable.hikage.hikage.extension)
 ```
 
+### Version Catalog
+
+Add dependency in your project's `gradle/libs.versions.toml`.
+
+```toml
+[versions]
+hikage-extension = "<version>"
+
+[libraries]
+hikage-extension = { module = "com.highcapable.hikage:hikage-extension", version.ref = "hikage-extension" }
+```
+
+Configure dependency in your project `build.gradle.kts`.
+
+```kotlin
+implementation(libs.hikage.extension)
+```
+
+Please change `<version>` to the version displayed at the top of this document.
+
 ### Traditional Method
 
 Configure dependency in your project `build.gradle.kts`.

docs-source/src/en/library/hikage-widget-androidx.md

@@ -29,6 +29,26 @@ Configure dependency in your project `build.gradle.kts`.
 implementation(com.highcapable.hikage.hikage.widget.androidx)
 ```
 
+### Version Catalog
+
+Add dependency in your project's `gradle/libs.versions.toml`.
+
+```toml
+[versions]
+hikage-widget-androidx = "<version>"
+
+[libraries]
+hikage-widget-androidx = { module = "com.highcapable.hikage:hikage-widget-androidx", version.ref = "hikage-widget-androidx" }
+```
+
+Configure dependency in your project `build.gradle.kts`.
+
+```kotlin
+implementation(libs.hikage.widget.androidx)
+```
+
+Please change `<version>` to the version displayed at the top of this document.
+
 ### Traditional Method
 
 Configure dependency in your project `build.gradle.kts`.

docs-source/src/en/library/hikage-widget-material.md

@@ -29,6 +29,26 @@ Configure dependency in your project `build.gradle.kts`.
 implementation(com.highcapable.hikage.hikage.widget.material)
 ```
 
+### Version Catalog
+
+Add dependency in your project's `gradle/libs.versions.toml`.
+
+```toml
+[versions]
+hikage-widget-material = "<version>"
+
+[libraries]
+hikage-widget-material = { module = "com.highcapable.hikage:hikage-widget-material", version.ref = "hikage-widget-material" }
+```
+
+Configure dependency in your project `build.gradle.kts`.
+
+```kotlin
+implementation(libs.hikage.widget.material)
+```
+
+Please change `<version>` to the version displayed at the top of this document.
+
 ### Traditional Method
 
 Configure dependency in your project `build.gradle.kts`.

docs-source/src/zh-cn/library/hikage-compiler.md

@@ -56,6 +56,47 @@ dependencies {
 }
 ```
 
+### Version Catalog
+
+在你的项目 `gradle/libs.versions.toml` 中添加依赖。
+
+```toml
+[versions]
+ksp = "<ksp-version>"
+hikage-compiler = "<version>"
+
+[plugins]
+ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
+
+[libraries]
+hikage-compiler = { module = "com.highcapable.hikage:hikage-compiler", version.ref = "hikage-compiler" }
+```
+
+在你的根项目 `build.gradle.kts` 中配置依赖。
+
+```kotlin
+plugins {
+    // ...
+    alias(libs.plugins.ksp) apply false
+}
+```
+
+在你的项目 `build.gradle.kts` 中配置依赖。
+
+```kotlin
+plugins {
+    // ...
+    alias(libs.plugins.ksp)
+}
+
+dependencies {
+    // ...
+    ksp(libs.hikage.compiler)
+}
+```
+
+请将 `<version>` 修改为此文档顶部显示的版本，并将 `<ksp-version>` 修改为你项目当前使用的 Kotlin 版本对应的 KSP 版本。
+
 ### 传统方式
 
 在你的根项目 `build.gradle.kts` 中配置依赖。

docs-source/src/zh-cn/library/hikage-core.md

@@ -29,6 +29,26 @@ libraries:
 implementation(com.highcapable.hikage.hikage.core)
 ```
 
+### Version Catalog
+
+在你的项目 `gradle/libs.versions.toml` 中添加依赖。
+
+```toml
+[versions]
+hikage-core = "<version>"
+
+[libraries]
+hikage-core = { module = "com.highcapable.hikage:hikage-core", version.ref = "hikage-core" }
+```
+
+在你的项目 `build.gradle.kts` 中配置依赖。
+
+```kotlin
+implementation(libs.hikage.core)
+```
+
+请将 `<version>` 修改为此文档顶部显示的版本。
+
 ### 传统方式
 
 在你的项目 `build.gradle.kts` 中配置依赖。

docs-source/src/zh-cn/library/hikage-extension-betterandroid.md

@@ -29,6 +29,26 @@ libraries:
 implementation(com.highcapable.hikage.hikage.extension.betterandroid)
 ```
 
+### Version Catalog
+
+在你的项目 `gradle/libs.versions.toml` 中添加依赖。
+
+```toml
+[versions]
+hikage-extension-betterandroid = "<version>"
+
+[libraries]
+hikage-extension-betterandroid = { module = "com.highcapable.hikage:hikage-extension-betterandroid", version.ref = "hikage-extension-betterandroid" }
+```
+
+在你的项目 `build.gradle.kts` 中配置依赖。
+
+```kotlin
+implementation(libs.hikage.extension.betterandroid)
+```
+
+请将 `<version>` 修改为此文档顶部显示的版本。
+
 ### 传统方式
 
 在你的项目 `build.gradle.kts` 中配置依赖。