Hisn Al-Muslim adhkar

一个开源的JSON数据集，包含Sheikh Saeed Al-Qahtani的Hisn Al-Muslim（穆斯林堡垒）祈祷词，支持多语言、重复计数和本地音频文件。

An open-source JSON dataset containing the supplications from Hisn Al-Muslim (Muslim Fortress) by Sheikh Saeed Al-Qahtani, supporting multilingual versions, repetition counting and local audio files.

原始信息汇总

🕌 Islamic Pro — Azkar API 数据集概述

数据集简介

这是一个开源的、结构化的 JSON 数据集，内容为 《Hisn Al-Muslim》（堡垒中的穆斯林） 中的祈祷词（Adhkar），作者为 Sheikh Saeed Al-Qahtani。数据集支持多语言、包含重复次数计数和本地音频文件，旨在成为伊斯兰应用程序的标准数据来源。

核心统计

项目	数量
📚 类别（Categories）	132 个
🤲 祈祷词（Adhkar）	185 个
🌍 当前支持语言	3 种（阿拉伯语、英语、土耳其语）
🔢 重复次数字段（count）	每个祈祷词都有
🔊 音频文件	267 个本地 MP3 文件（位于 /audio 目录）
🆓 许可协议	MIT 许可证（免费用于任何用途）

支持的语言

语言代码	语言名称	状态
ar	العربية（阿拉伯语）	✅ 已完成
en	English（英语）	✅ 已完成
tr	Türkçe（土耳其语）	✅ 已完成
bn	বাংলা（孟加拉语）	🔜 即将推出
bs	Bosanski（波斯尼亚语）	🔜 即将推出
es	Español（西班牙语）	🔜 即将推出
fa	فارسی（波斯语）	🔜 即将推出
ha	Hausa（豪萨语）	🔜 即将推出
hi	हिन्दी（印地语）	🔜 即将推出
id	Indonesia（印尼语）	🔜 即将推出
pt	Português（葡萄牙语）	🔜 即将推出
so	Soomaali（索马里语）	🔜 即将推出
sw	Kiswahili（斯瓦希里语）	🔜 即将推出
th	ไทย（泰语）	🔜 即将推出
zh	中文	🔜 即将推出

项目结构

Islamic-Pro-azkar-API/ ├── data/ │ ├── ar.json ← 阿拉伯语源数据（已完成） │ ├── en.json ← 英语数据（已完成） │ └── tr.json ← 土耳其语数据（已完成） ├── audio/ ← 267 个 MP3 音频文件 │ ├── 1.mp3 │ ├── 2.mp3 │ ├── ar_7esn_AlMoslem_by_Doors_028.mp3 │ └── ... ├── LICENSE ← MIT 许可证 └── README.md

数据格式

每个语言文件采用相同的 JSON 结构：

json [ { "id": 1, "category": "Words of remembrance for morning and evening", "audio": "/audio/ar_7esn_AlMoslem_by_Doors_028.mp3", "filename": "ar_7esn_AlMoslem_by_Doors_028", "array": [ { "id": 1, "text": "Allah - there is no deity except Him, the Ever-Living...", "transliteration": "Recite Ayat-Al-Kursiy (Al-Baqarah :255)", "count": 1, "audio": "/audio/75.mp3", "filename": "75" } ] } ]

字段说明

• id: 类别或祈祷词的唯一标识符
• category: 类别名称（如“早晨和晚上的祈祷词”）
• text: 祈祷词原文内容
• transliteration: 音译或指导说明
• count: 重复次数（如 1、3、7、33、100 等）
• audio: 音频文件路径
• filename: 音频文件名

count 字段的意义

count 值	含义	UI 建议
1	诵读一次	简单显示
3	诵读 3 次	显示重复按钮
7	治愈祈祷	显示重复按钮
33	礼拜后的赞词	显示点击计数器
100	日常求饶	显示进度跟踪器

数据来源

• Hisn Al-Muslim 书籍：Sheikh Saeed Al-Qahtani（谢赫·赛义德·阿尔-卡塔尼）
• 音频诵读：Hamad Al-Durayhim（哈马德·阿尔-杜赖希姆）
• 参考网站：https://hisnmuslim.com

快速使用示例

JavaScript / Node.js

js const ar = require(./data/ar.json); const en = require(./data/en.json);

const morning = en.find(cat => cat.id === 1); const text = morning.array[0].text; const count = morning.array[0].count; const audioFile = morning.array[0].audio;

Flutter / Dart

dart final String json = await rootBundle.loadString(assets/data/ar.json); final List data = jsonDecode(json); final category = data[0]; final text = category[array][0][text]; final count = category[array][0][count]; final audio = category[array][0][audio];

React Native

js import adhkar from ./data/en.json;

adhkar.forEach(category => { console.log(category.category); category.array.forEach(dhikr => { console.log(dhikr.text, ×, dhikr.count); }); });

贡献指南

欢迎贡献新的语言翻译。步骤：

1. Fork 该仓库
2. 创建 data/<语言代码>.json 文件，遵循与 en.json 相同的结构
3. 仔细审阅翻译
4. 提交 Pull Request

许可证

MIT 许可证 — 可自由用于任何项目，包括商业用途。

搜集汇总

数据集介绍

构建方式

在伊斯兰教信仰实践的语境中，精准的赞念（Dhikr）文本与其重复次数是礼拜与日常 devotional 活动的核心要素。该数据集的构建严格遵循了谢赫·赛义德·卡赫塔尼所著的权威经典《穆斯林堡垒》（Hisn Al-Muslim），通过系统性的数字化整理，将其中收录的132类、185个独立赞念条目转化为结构化的JSON格式。每个条目均包含阿拉伯语原文、转写、翻译（当前支持阿拉伯语、英语、土耳其语）以及关键的“count”字段，用于精确记录每段赞念在宗教传统中被规定的重复次数。此外，数据集还集成了267个本地MP3音频文件，将文字、音频与元数据深度绑定，形成了一套完整、可机读的伊斯兰文化数字资源。

特点

该数据集以其结构的严谨性与多语言扩展能力在同类资源中脱颖而出。数据按类别组织，每条数据均包含唯一标识符、文本、音译、本地音频路径与重复次数，其中“count”字段通过差异化数值（如1、3、33、100）直观对应不同的诵读场景，使开发者能够根据数值自动适配交互逻辑。项目采用MIT开源许可，彻底解除了商业与非商业使用的法律顾虑。当前已覆盖三种核心语言，并规划了包括孟加拉语、波斯语、中文在内的12种语言扩展路径，使其天然具备跨文化传播的基因。

使用方法

开发者可便捷地将数据集嵌入各类应用程序。在JavaScript/Node.js环境中，通过require语句直接加载JSON文件，利用数组方法按类别或条目ID索引即可获取文本、重复次数与音频路径。对于Flutter/Dart应用，语言文件作为资产加载后经jsonDecode解析即可访问结构化数据。React Native用户则可通过import语句导入整个数据集进行遍历操作。无论采用何种技术栈，均可依据“count”字段的数值特性，在UI层灵活实现单选按钮、自动重复、计数器或进度追踪器等交互模式，从而快速构建功能完备的伊斯兰辅助工具。

背景与挑战

背景概述

在伊斯兰信仰实践中，日常赞念（阿兹卡尔）是维系信徒精神生活的重要仪式，而《Hisn Al-Muslim》（穆斯林堡垒）作为谢赫·赛义德·卡赫塔尼编纂的权威赞念集，其内容在穆斯林世界中具有广泛影响力。该数据集由资深Flutter工程师Yousef I. M. Asalya于伊斯坦布尔创建，旨在解决伊斯兰移动应用领域缺乏结构化、多语言赞念数据源的痛点。作为首个开源、支持多语言（阿拉伯语、英语、土耳其语）并包含重复计数与本地音频文件的Hisn Al-Muslim结构化JSON数据集，它覆盖132个类别、185段赞念及267个MP3音频文件，为伊斯兰应用开发者提供了标准化基础数据。该数据集采用MIT许可协议，极大降低了穆斯林社区数字工具的开发门槛，有力推动了宗教文化遗产的数字化转型。

当前挑战

该数据集面临的核心挑战在于领域问题的复杂性：赞念文本的每一次诵念都有精确的重复次数要求（从单次到百次不等），需在用户界面中巧妙呈现为重复按钮、点击计数器或进度追踪器，这对数据模型的精确性与应用交互设计构成考验。构建过程中，团队需克服多语言翻译的文化适配难题——除已完成的三种语言外，其余12种语言的本地化工作正在推进，每个语种的赞念表述需在保持宗教含义准确的同时兼顾目标语言的文化语境。音频素材的获取与授权亦需审慎处理，267个MP3文件由哈马德·杜拉希姆录制，其质量把控与版权合规是数据集可持续发展的关键，而跨平台一致性测试更对数据结构的鲁棒性提出严苛要求。

常用场景

经典使用场景

在伊斯兰文化与数字人文的交叉领域中，该数据集最为经典的使用场景是构建多语言、多模态的穆斯林祈祷与赞念（Azakr）移动应用或网页平台。开发者可直接调用结构化的JSON数据，按类别（如晨夕赞词、拜后赞词）与重复次数（count字段）渲染交互式用户界面，并同步加载每段赞词对应的本地MP3音频文件。这一范式极大降低了宗教类应用从零整理、校对与维护语料库的门槛，使得开发者能够专注于用户体验设计与功能迭代。

解决学术问题

在学术研究层面，该数据集有效解决了伊斯兰宗教文本数字化过程中长期存在的两大痛点：一是标准化缺失——传统上各应用与网站自建语料库，格式不一、翻译质量参差、重复次数标注混乱；二是多语言支持不足——多数资源仅覆盖阿拉伯语与英语，难以惠及全球十五亿穆斯林中的非阿拉伯语群体。该数据集通过开源MIT协议提供统一的JSON架构与精确的count字段语义，为计算语言学的语料对齐、跨语言信息检索（CLIR）以及宗教传播学的数字化传播效果比较提供了可靠的基础资源。

衍生相关工作

基于该数据集衍生出的经典工作主要包括：第一，各语言社区自发贡献的翻译扩展项目（如孟加拉语、索马里语、中文等15种语言的待办翻译任务），形成了全球协作的宗教文本本地化网络；第二，围绕count字段衍生的UI组件库，如Flutter与React Native社区开发的循环计数器组件、进度追踪仪表盘等，已被多个开源项目复用；第三，音频文件（Hamad Al-Durayhim诵经）与文本的强制对齐研究，以及基于此构建的儿童阿语听读学习应用。这些衍生工作共同构建了一个围绕《堡垒》语料库的微型生态，彰显了结构化宗教开源数据在文化传承与技术融合中的催化作用。