Hizbs Warsh Dataset

一个全面的古兰经Hizb分区数据集，提供60个古兰经Hizb，包含自上而下和自下而上的编号，支持JSON、XML和SQL多种格式，适用于伊斯兰应用、教育平台或研究项目

A comprehensive Qur'an Hizb partition dataset encompassing 60 Qur'an Hizbs, featuring both top-down and bottom-up numbering systems. It supports multiple formats including JSON, XML and SQL, and is suitable for Islamic applications, educational platforms or research projects.

原始信息汇总

Hizbs Warsh Dataset 数据集概述

数据集基本信息

• 数据集名称：Hizbs Warsh Dataset
• 主要内容：古兰经60个希兹布（Hizb）分区的综合数据集
• 数据规模：包含60个希兹布的完整数据

核心特性

• 完整数据集：包含古兰经全部60个希兹布
• 多种格式：JSON、XML和SQL格式
• 双重编号系统：自上而下（1-60）和自下而上（1-60）排序
• 多语言支持：JavaScript/Node.js和PHP实现
• 丰富元数据：每个希兹布包含名称、起始/结束苏拉、阿亚特和描述信息
• 易于集成：提供npm和Composer包的简单API

数据格式与结构

可用格式

• JSON格式：data/hizbs.json
• XML格式：data/hizbs.xml
• SQL格式：data/hizbs.sql

数据结构

每个希兹布对象包含以下字段：

• id：标识符（1-60）
• name：名称
• start_surah：起始苏拉
• start_ayah：起始阿亚特
• end_surah：结束苏拉
• end_ayah：结束阿亚特
• order_up_to_down：自上而下排序
• order_down_to_top：自下而上排序
• description：描述信息

编程接口

JavaScript/Node.js API

• getAllHizbs()：获取全部60个希兹布
• getHizbById(id)：按ID获取希兹布
• getHizbByOrderUp(order)：按自上而下顺序获取希兹布
• getHizbByOrderDown(order)：按自下而上顺序获取希兹布
• listAll()：获取全部希兹布的别名方法

PHP API

核心方法

• HisbProvider::getAllHizbs()：获取全部希兹布
• HisbProvider::getHizbById(int $id)：按ID获取希兹布
• HisbProvider::getHizbByOrderUpToDown(int $order)：按自上而下顺序获取希兹布
• HisbProvider::getHizbByOrderDownToTop(int $order)：按自下而上顺序获取希兹布

搜索方法

• HisbProvider::getHizbsBySurah(string $surahName)：按苏拉名称查找希兹布
• HisbProvider::searchHizbsByName(string $name, bool $exactMatch = false)：按名称搜索希兹布
• HisbProvider::getHizbsInRange(int $startOrder, int $endOrder)：获取指定顺序范围内的希兹布

工具方法

• HisbProvider::getHizbCount()：获取希兹布总数
• HisbProvider::getRandomHizb()：随机获取一个希兹布
• HisbProvider::isValidHizbId(int $id)：验证希兹布ID有效性
• HisbProvider::isValidHizbOrder(int $order)：验证希兹布顺序有效性

导出方法

• HisbProvider::toJson(?int $hizbId = null)：导出为JSON格式
• HisbProvider::toXml()：导出为XML格式

安装方式

Node.js/JavaScript

bash npm install hizbs-warsh-dataset

PHP

bash composer require redadevcraft/quran-hizb-data

系统要求

Node.js

• Node.js >= 12.0.0

PHP

• PHP >= 7.4
• JSON扩展（通常已包含）
• SimpleXML扩展（用于XML导出）

版本信息

• 当前版本：1.0.0
• 初始发布内容：
  • 完整的60个希兹布数据集
  • JavaScript/Node.js包实现
  • PHP/Composer包实现
  • 多种导出格式（JSON、XML、SQL）
  • 完整的测试套件
  • 完整的文档和示例

许可证

• MIT许可证

作者信息

• 作者：Taleb Mohammed Reda
• 邮箱：[e-mail]
• GitHub：https://github.com/redadevcraft

搜集汇总

数据集介绍

构建方式

在伊斯兰经典文献数字化研究领域，Hizbs Warsh数据集通过系统化整理《古兰经》的六十个希兹布（Hizb）单元构建而成。该数据集采用多层级结构化设计，以传统经注学为基础，将每个希兹布的起始与终止章节、经文段落及双语命名体系进行精准标注。数据生成过程融合了脚本自动化处理与人工校验机制，通过JavaScript和PHP双平台工具链实现从原始经文到JSON、XML、SQL多格式的标准化转换，确保宗教文本的完整性与计量准确性。

使用方法

针对不同技术栈的研究者与开发者，数据集提供了标准化的集成方案。JavaScript环境可通过npm包管理器安装，调用getHizbById、getHizbByOrderUp等接口实现精确数据检索；PHP生态则通过Composer依赖管理工具引入，利用HisbProvider类的静态方法进行多维度查询。数据集还支持通过直接复制data目录下的原始文件实现快速部署，其内置的搜索方法支持按章节名称模糊匹配、按序号范围过滤等高级查询功能，为伊斯兰数字人文研究提供完整的技术支撑。

背景与挑战

背景概述

在伊斯兰数字资源研究领域，古兰经文本结构化数据集对宗教科技应用具有重要价值。Hizbs Warsh Dataset由研究者Taleb Mohammed Reda于2024年创建，专注于提供古兰经六十个希兹布分区的标准化数据。该数据集通过双编号系统与多格式支持，解决了伊斯兰应用程序开发中经文分段数据缺失的核心问题，为教育平台和学术研究提供了可靠的底层数据支撑。

当前挑战

构建过程中面临经文分段数据标准化挑战，需确保六十个希兹布起始章节与经文的精确对应。技术实现需克服双向编号系统与多语言接口的兼容性问题，同时维护阿拉伯语经文在数字环境中的完整性。该数据集持续面临跨平台数据一致性与宗教文本权威性验证的双重考验，需通过持续验证机制保障数据准确性。

常用场景

经典使用场景

在伊斯兰数字人文研究领域，Hizbs Warsh数据集为《古兰经》的章节划分提供了结构化数据支撑。该数据集通过标准化的Hizb分区机制，支持经文检索系统的开发，使得研究人员能够快速定位特定章节的起始与终止位置。其双编号系统兼顾传统阅读习惯与逆向查询需求，为经文学术分析奠定了数据基础。

解决学术问题

该数据集有效解决了伊斯兰文献数字化过程中的核心难题，即经文分段标准化与跨平台数据交互问题。通过提供多语言接口与结构化元数据，它消除了不同研究团队之间的数据格式壁垒，促进了计算语言学与宗教文本分析的跨学科融合。其完整的章节描述体系为经文语义关联研究提供了可扩展的标注框架。

实际应用

在实践层面，该数据集已广泛应用于智能宗教教育平台与移动端诵经应用。教育机构利用其API接口开发交互式学习系统，实现按章节进度追踪与个性化学习路径规划。清真寺数字化项目则依托其多格式数据源，构建了跨平台的经文展示系统，显著提升了信众的经典阅读体验。

数据集最近研究

最新研究方向

在伊斯兰数字人文研究领域，Hizbs Warsh数据集正推动古兰经结构化数据的跨学科应用。当前研究聚焦于利用其双编号系统与多格式支持，开发智能宗教教育平台的可视化阅读引擎，并通过API集成实现古兰经章节的语义关联分析。随着全球伊斯兰科技社区对标准化经文数据需求的增长，该数据集为数字朝拜应用和跨语言经文比对系统提供了核心支撑，促进了传统宗教知识与现代信息技术的深度融合。