推出 GitaVerse:以编程方式访问《博伽梵歌》诗句 🚀

在现代开发领域,通过干净的 API 和库,开发人员可以更轻松地访问精神和文学文本。**GitaVerse** 是一个现代 TypeScript 库,可让您轻松访问、探索和检索《博伽梵歌》中的 shlokas(诗句)。

🌟 什么是 GitaVerse?

GitaVerse 是一个基于 TypeScript 的 NPM 库,允许开发人员以编程方式获取《薄伽梵歌》的诗句(shlokas),包括翻译、同义词和原始天城文文本。

《薄伽梵歌》是一部深奥的印度教经文,包含 **18 章** 的 700 节经文。使用 GitaVerse,您可以:

  • 根据章节和诗句编号检索个别诗句。
  • 获取特定章节中的所有诗节。
  • 以结构化格式访问翻译、同义词和含义。
  • 轻松构建精神应用程序、教育工具或学习工具。
  • 🚀 GitaVerse 的功能

  • ✅ 获取任何 Shloka:获取任何章节的诗句及其完整详细信息。
  • ✅ 详细信息:包括天城文文本、诗歌翻译、同义词和多重含义。
  • ✅ 有组织的数据:所有数据都使用 TypeScript 接口进行结构化和类型化,以易于使用。
  • ✅ 易于使用的 API:为开发人员提供简洁的基于类的方法。
  • ✅ 轻量级:最小依赖,实现更快的集成。
  • ✅ TypeScript 支持:完整的类型安全性,实现稳健的开发。
  • 📥 安装

    您可以使用 **npm** 或 **yarn** 安装 **GitaVerse**:

    npm install gitaverse

    或者

    yarn add gitaverse

    🔧 如何使用 GitaVerse

    以下是有关如何使用 **GitaVerse** 库的快速指南。

    1.导入GitaVerse并初始化

    首先导入“GitaLibrary”类并初始化它:

    import { GitaLibrary } from "gitaverse";
    
    const gita = new GitaLibrary();

    2. 获取有关《博伽梵歌》的元数据

    获取《博伽梵歌》的概述,如总章节和诗句:

    const metadata = gita.getDescription();
    console.log(metadata);
    
    /*
    Output:
    {
      title: "Bhagavad Gita",
      description: "The Bhagavad Gita, often referred to as the Gita, is a 700-verse Hindu scripture that is part of the Indian epic Mahabharata.",
      totalChapters: 18,
      totalVerses: 700
    }
    */

    3. 获取章节中的所有 Shlokas

    要检索特定章节的所有诗句,请使用“getChapter()”:

    const chapter1Shlokas = gita.getChapter(1);
    
    chapter1Shlokas.forEach((shloka) => {
      console.log(shloka.getSummary());
    });

    4. 获取特定的颂歌

    使用 **章节编号** 和 **诗节编号** 获取特定的 shloka:

    const shloka = gita.getShloka(1, 1);
    
    console.log(shloka.getSummary());
    
    /*
    Output:
    {
      chapter: "1",
      verse: "1",
      devanagari: "धृतराष्ट्र उवाच...",
      verseText: "Dhritarashtra said...",
      synonyms: "Dhritarashtra - King Dhritarashtra...",
      translation: "King Dhritarashtra inquired...",
      meaning: ["Literal meaning of the verse...", "Spiritual significance..."]
    }
    */

    5. 获取按章节分组的所有 Shlokas

    如果您想要获取按章节组织的所有诗句,请使用`getAllVerses()`:

    const allVerses = gita.getAllVerses();
    
    allVerses.forEach((chapter) => {
      console.log(
        `Chapter ${chapter.getShlokas().length} Shlokas available`
      );
    });

    📚 API 方法概述

    以下是可用方法的简要概述:

    GitaLibrary 方法:

    GitaShloka 方法:

    🛠 使用案例

    以下是将 GitaVerse 集成到您的项目中的一些想法:

  • 精神应用程序:构建应用程序来显示带有翻译和解释的 Gita shlokas。
  • 学习工具:为学生开发探索和理解《薄伽梵歌》的工具。
  • API:通过 REST API 为 Web 或移动应用程序提供 Gita 数据。
  • 个人项目:使用它进行个人学习和探索《薄伽梵歌》。
  • 🌐 链接

  • NPM 包:npm 上的 gitaverse
  • GitHub 存储库:GitHub 上的 GitaVerse
  • 🤝 贡献

    欢迎大家投稿!如果您想添加功能或修复问题:

  • 从 GitHub 分叉存储库。
  • 创建一个功能分支。
  • 提交拉取请求。
  • 如果有任何建议或错误,请随时提出问题。

    📄 许可证

    该项目采用 MIT 许可证。请参阅 LICENSE 文件了解更多详细信息。

    ✨ 最后的想法

    借助 **GitaVerse**,探索《薄伽梵歌》的永恒智慧变得简单且对开发人员友好。无论您是构建精神应用程序、学习工具还是个人项目,GitaVerse 都能为您提供以编程方式访问和分享《薄伽梵歌》教义所需的一切。

    —《薄伽梵歌》(第二章,第 47 节)

    **立即开始使用 GitaVerse 探索 Gita!** 🌟