Skip to content

README.mdx

Latest commit

 

History

History
122 lines (96 loc) · 4.97 KB

README.mdx

File metadata and controls

122 lines (96 loc) · 4.97 KB
Raw
title README
keywords
README
astro-blogs
Vedic Astrology
Astrology
description Comprehensive guide on README. Learn about its significance, effects, and remedies in Vedic Astrology.

AstroFusion Blogs

A comprehensive repository of Vedic Astrology content, structured as a documentation site. This project aims to provide deep, authoritative, and SEO-friendly articles on various aspects of Vedic Science, including Rasi, Houses, Planets, Dashas, Nakshatras, and more.

🌟 Project Overview

AstroFusion Blogs is a curated collection of knowledge designed for both enthusiasts and students of Vedic Astrology. The content is formatted in MDX (Markdown with JSX) to support rich text and potential interactive components.

📂 Directory Structure

The repository is organized by locales as single sources of truth, containing all astrological categories:

astro-blogs/
├── en/               # English (Production Ready - 22 Categories, 1,226 articles)
├── hi/               # Hindi (Vedic Translation - 20 Categories, 1,238 articles)
├── ne/               # Nepali (Vedic Translation - 20 Categories, 1,226 articles)
├── scripts/          # Node & Python utilities (indexes, validation, BLUF injection)
└── blog-*-index.json # Split & master navigation trees

Categories included in each locale:

  • 01_Rasi: Zodiac signs (Mesha to Meena).
  • 02_Houses: The 12 astrological houses and their significations.
  • 03_Planets: Detailed descriptions of Planets and Upagrahas.
  • 04_DashaSystem: Vimshottari and Yogini Dasha systems.
  • 05_Nakshatra: The 27 Lunar Mansions.
  • 06_Planet_in_Houses: Analysis of planets placed in specific houses.
  • 07_Calculations: Astrological calculations (e.g., Shadbala).
  • 08_Planet_in_Rashi: Planets placed in specific zodiac signs.
  • 10_Lord_in_Houses: Deep dive into House Lords placed in other houses.
  • 11_Planets_Conjunctions: Effects of multi-planet conjunctions.
  • 14_Divisional_Charts: Vargas (D1 to D60).
  • 17_Ashtakavarga: The system of eightfold classification.
  • 18_Vastu: Vastu Shastra principles.
  • 19_Medical_Astrology: Health and disease prediction.
  • 20_Transit: Planetary transits (Gochara).
  • 21_Numerology: Vedic and Western numerology.

📝 Content Format

All articles are written in MDX format.

Frontmatter Convention

Each file must include YAML frontmatter:

---
title: 'Article Title'
description: 'Concise summary for SEO and AI discovery (150-160 chars)'
keywords: 'keyword1, keyword2, keyword3'
pubDate: '2026-03-27'
category: 'Vedic Astrology Rasi'
locale: 'en'
audioUrl: 'https://cdn.astrofusion.com/en/01_Rasi/0101_Mesha-summary.mp3' # Optional CDN reference
---

AI BLUF & Audio Synthesis Convention

To ensure optimal text-to-speech (TTS) audio generation and AI answer citations, each article section begins with an executive summary wrapped in <AIBlufSummary>:

## Introduction

<AIBlufSummary>
Mesha Rashi (Aries) is the first zodiac sign in Vedic astrology, ruled by fiery Mars. It symbolizes initiation, leadership, dynamic vitality, and pioneering energy.
</AIBlufSummary>

[In-depth article section content continues here...]

File Naming

Files follow a strict naming convention for ordering and SEO: {OrderPrefix}_{TopicSlug}.mdx Example: 0101_Mesha.mdx

🎙️ Audio Generation & Multi-Locale Support

Articles support automated, high-definition voice synthesis powered by the GMI Cloud MiniMax Speech 2.8 batch audio pipeline.

  • Audio Dashboard: Run pnpm audio:blog from the main repo to synthesize executive summaries or full articles.
  • Locales Supported:
    • en - English (Standard Production)
    • hi - Hindi (Vedic Translation)
    • ne - Nepali (Vedic Translation)
  • Output Storage: Local caching at ~/Desktop/AstroFusion_Blogs_Audio/{Category}/{locale}/ and cloud distribution via Cloudflare R2 CDN.

🚀 Getting Started

To browse the content locally:

  1. Clone the repository.
  2. Open the index.mdx file to see the full table of contents.
  3. Navigate through the en/, hi/, and ne/ directories to read specific articles.

🤝 Contribution Guidelines

We welcome contributions to expand this knowledge base.

  1. Topic Selection: Ensure the topic fits into the existing directory structure under the appropriate locale (en/, hi/, or ne/).
  2. Formatting: Strictly follow the MDX structure, <AIBlufSummary> block format, and Frontmatter requirements.
  3. Quality: Content should be detailed, authoritative, and SEO-optimized.
  4. Linking: Use relative paths for internal links (e.g., [Link Text](../Folder/File.mdx)).

🛠️ Tech Stack

  • Content: MDX (Markdown + JSX)
  • Audio Pipeline: GMI Cloud MiniMax Speech 2.8 HD Voice Cloning Pipeline
  • Structure: Multilingual File System (en/, hi/, ne/)
  • Metadata: _meta.json files for navigation ordering (Nextra/Next.js compatible).

Maintained by AstroFusion Team