docs: optimise docs

This commit is contained in:
2026-05-23 15:07:43 +08:00
parent 601625f09b
commit b051d8c235
4 changed files with 78 additions and 72 deletions
+1 -1
View File
@@ -1,4 +1,4 @@
MIT License MIT Licence
Copyright (c) 2026 OnixByte Copyright (c) 2026 OnixByte
+16 -16
View File
@@ -2,6 +2,8 @@
title: OnixByte Toolbox title: OnixByte Toolbox
--- ---
import { Tabs, Tab } from "@rspress/core/theme"
## Introduction ## Introduction
OnixByte Toolbox is a Development Kit for Java applications that provides a set of convenient, reusable tools for writing code efficiently. It is designed and maintained by OnixByte as a monorepo containing multiple purpose-built libraries, each addressing a specific development need — from common utilities and cryptography to mathematical computation and identity generation. OnixByte Toolbox is a Development Kit for Java applications that provides a set of convenient, reusable tools for writing code efficiently. It is designed and maintained by OnixByte as a monorepo containing multiple purpose-built libraries, each addressing a specific development need — from common utilities and cryptography to mathematical computation and identity generation.
@@ -11,7 +13,7 @@ The toolkit is available on Maven Central under the `com.onixbyte` group ID. Eac
## Modules ## Modules
| Module | Artifact ID | Description | | Module | Artifact ID | Description |
|----------------------|-----------------------|-------------------------------------------------------| |--------------------|----------------------|---------------------------------------------------------------------------|
| Common Toolbox | `common-toolbox` | Everyday utilities — AES, hashing, Base64, collections, branching, ranges | | Common Toolbox | `common-toolbox` | Everyday utilities — AES, hashing, Base64, collections, branching, ranges |
| Crypto Toolbox | `crypto-toolbox` | Public/private key loading for RSA and ECDSA algorithms | | Crypto Toolbox | `crypto-toolbox` | Public/private key loading for RSA and ECDSA algorithms |
| Math Toolbox | `math-toolbox` | Statistical calculation, percentile analysis, quartile computation | | Math Toolbox | `math-toolbox` | Statistical calculation, percentile analysis, quartile computation |
@@ -23,27 +25,25 @@ The toolkit is available on Maven Central under the `com.onixbyte` group ID. Eac
Add the desired module as a dependency in your build config: Add the desired module as a dependency in your build config:
**Gradle (Kotlin DSL):** <Tabs>
<Tab label="Gradle with Kotlin DSL">
```kotlin ```kotlin title="build.gradle.kts"
implementation("com.onixbyte:common-toolbox:$version") dependencies {
implementation("com.onixbyte:crypto-toolbox:$version") implementation("com.onixbyte:$artefactId:$version")
implementation("com.onixbyte:math-toolbox:$version") }
implementation("com.onixbyte:tuple:$version")
implementation("com.onixbyte:identity-generator:$version")
``` ```
</Tab>
**Maven:** <Tab label="Maven">
```xml title="pom.xml"
```xml
<dependency> <dependency>
<groupId>com.onixbyte</groupId> <groupId>com.onixbyte</groupId>
<artifactId>common-toolbox</artifactId> <artifactId>${artefactId}</artifactId>
<version>${version}</version> <version>${version}</version>
</dependency> </dependency>
``` ```
</Tab>
Refer to the [changelog](https://codecrafters.org.cn/devkit/changelog) for available versions. </Tabs>
## Requirements ## Requirements
@@ -51,4 +51,4 @@ Refer to the [changelog](https://codecrafters.org.cn/devkit/changelog) for avail
## License ## License
OnixByte Toolbox is open-source software released under the MIT License. OnixByte Toolbox is open-source software released under the MIT Licence.
@@ -2,6 +2,8 @@
title: OnixByte Toolbox title: OnixByte Toolbox
--- ---
import { Tabs, Tab } from "@rspress/core/theme"
## 介绍 ## 介绍
OnixByte Toolbox 是一个面向 Java 应用的开发工具包,提供了一系列便捷、可复用的工具,帮助开发者高效编写代码。它由 OnixByte 设计和维护,采用 monorepo 架构,包含多个专用库,每个库解决一个特定的开发需求 — 从通用工具类和密码学,到数学计算和标识符生成。 OnixByte Toolbox 是一个面向 Java 应用的开发工具包,提供了一系列便捷、可复用的工具,帮助开发者高效编写代码。它由 OnixByte 设计和维护,采用 monorepo 架构,包含多个专用库,每个库解决一个特定的开发需求 — 从通用工具类和密码学,到数学计算和标识符生成。
@@ -11,7 +13,7 @@ OnixByte Toolbox 是一个面向 Java 应用的开发工具包,提供了一系
## 模块 ## 模块
| 模块 | Artifact ID | 描述 | | 模块 | Artifact ID | 描述 |
|---|---|---| |--------------------|----------------------|-----------------------------------|
| Common Toolbox | `common-toolbox` | 日常工具类 — AES 加密、哈希、Base64、集合、分支、范围 | | Common Toolbox | `common-toolbox` | 日常工具类 — AES 加密、哈希、Base64、集合、分支、范围 |
| Crypto Toolbox | `crypto-toolbox` | RSA 和 ECDSA 算法的公私钥加载 | | Crypto Toolbox | `crypto-toolbox` | RSA 和 ECDSA 算法的公私钥加载 |
| Math Toolbox | `math-toolbox` | 统计计算、百分位数分析、四分位数计算 | | Math Toolbox | `math-toolbox` | 统计计算、百分位数分析、四分位数计算 |
@@ -23,27 +25,25 @@ OnixByte Toolbox 是一个面向 Java 应用的开发工具包,提供了一系
在构建配置中添加所需模块的依赖: 在构建配置中添加所需模块的依赖:
**Gradle (Kotlin DSL):** <Tabs>
<Tab label="Gradle with Kotlin DSL">
```kotlin ```kotlin title="build.gradle.kts"
implementation("com.onixbyte:common-toolbox:$version") dependencies {
implementation("com.onixbyte:crypto-toolbox:$version") implementation("com.onixbyte:$artefactId:$version")
implementation("com.onixbyte:math-toolbox:$version") }
implementation("com.onixbyte:tuple:$version")
implementation("com.onixbyte:identity-generator:$version")
``` ```
</Tab>
**Maven:** <Tab label="Maven">
```xml title="pom.xml"
```xml
<dependency> <dependency>
<groupId>com.onixbyte</groupId> <groupId>com.onixbyte</groupId>
<artifactId>common-toolbox</artifactId> <artifactId>${artefactId}</artifactId>
<version>${version}</version> <version>${version}</version>
</dependency> </dependency>
``` ```
</Tab>
可查阅[更新日志](https://codecrafters.org.cn/devkit/changelog)了解可用版本。 </Tabs>
## 要求 ## 要求
+15 -9
View File
@@ -2,6 +2,8 @@
title: Regions for Java title: Regions for Java
--- ---
import { Tabs, Tab } from "@rspress/core/theme"
## 介绍 ## 介绍
**regions4j** 是一个轻量级、类型安全的 Java 库,基于 ISO 3166-1 标准提供全面的世界地区元数据。它旨在简化 Java 企业应用中的国际化(i18n)、电信路由和地区数据管理工作。 **regions4j** 是一个轻量级、类型安全的 Java 库,基于 ISO 3166-1 标准提供全面的世界地区元数据。它旨在简化 Java 企业应用中的国际化(i18n)、电信路由和地区数据管理工作。
@@ -30,21 +32,25 @@ title: Regions for Java
## 安装 ## 安装
**Maven:** <Tabs>
<Tab label="Gradle with Kotlin DSL">
```kotlin title="build.gradle.kts"
dependencies {
implementation("com.onixbyte:regions4j:$version")
}
```
</Tab>
```xml <Tab label="Maven">
```xml title="pom.xml"
<dependency> <dependency>
<groupId>com.onixbyte</groupId> <groupId>com.onixbyte</groupId>
<artifactId>regions4j</artifactId> <artifactId>regions4j</artifactId>
<version>2025.12</version> <version>${version}</version>
</dependency> </dependency>
``` ```
</Tab>
**Gradle (Kotlin DSL):** </Tabs>
```kotlin
implementation("com.onixbyte:regions4j:2025.12")
```
> **版本说明:** 该库使用日历化版本管理(`YYYY.MM`)而非语义化版本号。版本字符串如 `2025.12` 可以直观地告诉您地区数据反映的是 2025 年 12 月的 ISO 3166-1 状态。 > **版本说明:** 该库使用日历化版本管理(`YYYY.MM`)而非语义化版本号。版本字符串如 `2025.12` 可以直观地告诉您地区数据反映的是 2025 年 12 月的 ISO 3166-1 状态。