Enter the Sanctuary

After adding new words, run the fix script to update already-translated chapter files.

sacred-library-v3/
├── server.py                    ← Flask backend (run this)
│    GROQ_KEYS = [...]           ← Add Groq API keys here
│    GEMINI_KEYS = [...]         ← Legacy Gemini keys (unused)
│
├── backup.py                    ← Full project ZIP backup
├── cleanup_books.py             ← Remove reference books from main library
├── import_kjva.py               ← Restore Apocrypha from KJVA.json
├── import_sefaria.py            ← Import texts from Sefaria.org
├── translate_book.py            ← Translate book to Gujarati (chunked)
├── translate_ai_fields.py       ← Translate ai_en → ai_gu via deep-translator
├── generate_word_study_nt.py    ← Generate NT word study from Strongs
├── generate_ai_word_study.py    ← Generate ai_en via AI (daily)
├── fix_vocabulary.py            ← Re-apply christian_vocab.json to books
├── fix_missing_definitions.py   ← Add EN definitions to 20 skipped NT entries
├── check_corrupted.py           ← Scan chapter files for corruption
├── recover_chapters.py          ← Recover corrupted chapter files
├── migrate_ai_fields.py         ← Migrate legacy ai field to ai_gu
├── KJVA.json                    ← Source for all Apocrypha books
│
├── data_reference/              ← Reference Library (separate from Bible)
│   ├── books.json               ← Reference books list
│   ├── sections.json            ← Reference sections (Talmud, Mishnah, etc.)
│   └── {book}_chapters.json     ← Reference book chapter files
│
├── index.html                   ← Main dashboard
├── book.html                    ← Book reader + interlinear
├── admin.html                   ← Admin panel
├── help.html                    ← Reader's guide
├── word_browser.html            ← Word study browser (opens from admin)
├── video_script.html            ← Video presentation script
├── style.css                    ← All styles
│
├── data/
│   ├── books.json               ← Library index (all 83 books)
│   ├── sections.json            ← Library definitions (OT/NT/Apocrypha)
│   ├── word_study_ot.json       ← Hebrew word study (H1–H8674)
│   ├── word_study_nt.json       ← Greek word study (G1–G5624)
│   ├── strongs_greek.json       ← Greek Strong's lexicon (5523 entries)
│   ├── strongs_hebrew.json      ← Hebrew Strong's lexicon
│   ├── tantt_nt.json            ← NT Greek interlinear data
│   ├── tantt_{book}.json        ← OT Hebrew interlinear (per book)
│   ├── hmorph.json              ← Hebrew morphology data
│   ├── activity_log.json        ← Reader activity tracking
│   ├── genesis_chapters.json    ← OT chapters (en + gu fields)
│   ├── exodus_chapters.json     ← (same pattern for all OT books)
│   ├── john_chapters.json       ← NT chapters (en + gu fields)
│   ├── genesis_history.json     ← Book history + foreword
│   └── english/
│       ├── tobit_chapters.json          ← Apocrypha (en + gu)
│       ├── belandthedragon_chapters.json
│       └── (all other Apocrypha books)
│
└── scripts/
    └── bg.js                    ← Background animation

{
  "id": "genesis",              // Unique book ID (lowercase, no spaces)
  "title": "Genesis",           // English title
  "titleGu": "ઉત્પત્તિ",        // Gujarati title
  "sacred_label": "🕊 · GENESIS · ΑΩ",
  "section": "old_testament",   // old_testament | new_testament | apocrypha
  "data_chapters": "data/genesis_chapters.json",
  "data_history": "data/genesis_history.json",
  "hasGujarati": true,          // false = gray out language toggle
  "skipCover": true,            // true = skip cover, go to chapter grid
  "chapters_note": "50 Chapters"
}

[
  {
    "title": "Chapter 1 — The Creation",
    "titleGu": "પ્રકરણ ૧ — સૃષ્ટિ",
    "verses": [
      { "num": 1, "en": "In the beginning...", "gu": "આદિમાં..." }
    ]
  }
]

{
  "G3056": {
    "w": "λόγος",          // Greek/Hebrew word
    "t": "logos",           // Transliteration
    "pron": "LOH-gos",      // Pronunciation
    "en": "Word, reason",   // English meaning
    "gu": "વચન",            // Gujarati meaning
    "arth": "ઈશ્વરનો...",   // Gujarati arth (extended meaning)
    "example": "John 1:1",  // Usage example
    "note": "...",          // Theological note
    "ai_gu": "...",         // AI explanation in Gujarati
    "ai_en": "...",         // AI explanation in English
  }
}

{
  "foreword": "Personal note about this translation...",
  "sections": [
    { "title": "Historical Background", "body": "..." },
    { "title": "Authorship & Date", "body": "..." },
    { "title": "Theological Significance", "body": "..." }
  ]
}

• Admin password is in server.py — keep this file private
• Login is rate-limited: 5 failed attempts = 5 minute lockout
• All write endpoints require authentication
• Cloudflare tunnel encrypts all traffic to jcbooks.org
• Never expose port 8000 directly to the internet
• Run regular backups via Admin → Backup tab

Manage all books in the library. For each book you can:

• Edit Metadata — title, Gujarati title, description, source info, compiled by, date, and the Skip Cover flag (check for OT/NT books to go straight to chapter grid)
• Edit/View Chapters — view all chapters, click to edit individual chapter content
• Delete Book — permanently removes a book from the library
• Reference Library — import texts from Sefaria.org (Talmud, Mishnah, Josephus), manage sections, publish when ready
• Utility Scripts — run maintenance scripts directly from the browser with ▶ Run Now buttons
• Word Study AI workflow — (1) Add Groq keys to GROQ_KEYS in server.py, (2) run generate_ai_word_study.py daily until complete, (3) run translate_ai_fields.py to convert ai_en → ai_gu
• Reader — Bookmarks — readers tap 🏷️ on any verse to bookmark (max 50, shown grouped by book on dashboard)
• Reader — Verse of the Day — auto-picks from reader's bookmarks daily, shown on dashboard
• Reader — Continue Reading — dashboard card shows last read book/chapter, tap to resume
• Reader — Share Verse — 🔗 copies link, 💬 shares to WhatsApp with verse text
• Reader — Reading Progress — ✓ checkmark on completed chapters in the chapter grid
• Reader — Font Size — S/M/L/XL sizes saved to localStorage automatically
• Reader — Commentary (📖) — tap 📖 in nav bar → commentary drawer. Torah books show two tabs: Matthew Henry (chapter-level) and Rashi (verse-by-verse). Import MH: import_matthew_henry.py --all. Import Rashi: import_sefaria.py --ref "Rashi on Genesis" --id rashi_gen --section commentary. Translate via translate_book.py.
• Audio Test Lab — Admin → 🔊 Audio Test tab. Tests browser text-to-speech voices (English/Gujarati/Hindi) on the current device before rolling out to readers
• Word Frequency Scanner — Admin → Vocabulary Manager. Search any Gujarati word across any book, see all occurrences highlighted, replace in bulk or save to vocabulary

Add new chapters to an existing book by pasting formatted text. Format:

Chapter 1: Title Here
1 | English verse | ગુજરાતી વાક્ય
2 | English verse | ગુજરાતી વાક્ય

Chapters are appended after existing ones.

Select a book and chapter to edit individual verse content, chapter title, and Gujarati title. Changes are saved immediately to the server.

Import chapter titles from a CSV file. CSV format:

book_id,book_en,book_gu,chapter_num,title_en,title_gu
genesis,Genesis,ઉત્પત્તિ,1,The Creation,વિશ્વની ઉત્પત્તિ

• Filter by Book — select a specific book to import only that book's titles
• Replace existing — overwrites current titles if checked
• Gujarati only — checked by default, leaves English titles untouched

Manage library sections (Old Testament, New Testament, Apocryphal). You can:

• Create new sections with name, Gujarati name, color, and icon
• Reorder sections — drag to rearrange on the dashboard
• Assign books to sections
• Delete empty sections

Manage Hebrew and Greek word study definitions.

• Quick Edit — enter a Strong's number (G#### or H####) to edit that word's Gujarati definition, English definition, and notes
• Bulk Import CSV — import many words at once from a CSV file
• Greek (G####) → saved to word_study_nt.json
• Hebrew (H####) → saved to word_study_ot.json
• Replace ALL — wipes the matching file and imports fresh

Import Gujarati Bible text from the godlytalias API directly into any book. Select a book, choose the Bible book to fetch, and import chapter by chapter or all at once.

• Translate Book tab — select a book, click Translate Now, watch live progress, preview EN vs GU side by side
• History & Foreword tab — AI-generate or manually write historical background per book; enable via Edit Metadata Cover Page Options
• Backup tab — type full Windows path + click Start Backup to run backup.py; also restore Apocrypha from KJVA.json
• Utilities tab — all Python scripts with descriptions and commands
• Data Structure tab — full folder tree, file formats, API endpoints
• server.py — set ADMIN_PASSWORD and GEMINI_KEYS at top; login locks after 5 failed attempts
• merge_english_ot.py — run once to add English verses to OT/NT files (required for English search)
• import_kjva.py — restore any Apocrypha book from KJVA.json if corrupted
• translate_book.py — terminal alternative to Translate tab with Christian vocab replacements

Timelines, maps, and visual pages (e.g. timeline_church.html, timeline_tabernacle_3d.html) are added as reference library book entries with an External URL pointing to the HTML file. They appear automatically on the dashboard under the Timelines tile.

1. Upload the HTML file to your server root (same folder as index.html, book.html etc.)
2. Go to Admin → Edit Books tab
3. Click + Add New Book (or use the Add Book tab)
4. Fill in these fields:

   Field	What to enter	Example
   Book ID	Unique, lowercase, no spaces	timeline_church
   Title	English title shown on tile	Spread of the Early Church
   Title Gujarati	Gujarati title shown in ગુ mode	પ્રારંભિક ચર્ચનો ફેલાવો
   Section	Must be timelines	timelines
   External URL	Path to the HTML file	/timeline_church.html
   Status	Published	Published
   Skip Cover Page	✅ Always check this	✅ checked
   Icon / Emoji	Shown on the tile	✝ or 🏕

5. Click Save — the page appears immediately on the dashboard under Timelines

Find a Gujarati word across all NT or OT word study entries and replace it. Applies to the gu (definition) and ai_gu (AI explanation) fields.

Use AI to generate rich explanations for Hebrew and Greek Strong's entries. Saves progress automatically — safe to stop and resume.

Ask AI to write a historical background, author info, theological significance, and foreword for the selected book. You can edit the result before saving.

Downloads a complete snapshot of all library data — books, chapters, word study (OT + NT), sections, and activity log — as a single JSON file.

If an Apocrypha chapter file gets corrupted or emptied, restore it from KJVA.json. Place KJVA.json in your sacred-library-v3 folder first.

Runs backup.py to ZIP the entire project — all code, data, and assets — and saves it to your chosen destination. Copy backup.py to your sacred-library-v3 folder first.

Fetch any NT book from the godlytalias public database (ERV Gujarati — uses શબ્દ and દેવ).

Upload a JSON file from your computer. Works for any structured text — Bible translations, dictionaries, commentaries, maps.

Fetch JSON from any URL — Bible APIs, dictionaries, maps, or any public JSON endpoint.

Sections set to Published will appear in the library. Keep unpublished until content is complete.

Fetch any text from Sefaria.org — Talmud, Mishnah, Midrash, Josephus. Free API, no key needed.

In the beginning God created the heaven and the earth.

શરૂઆતમાં ઈશ્વરે સ્વર્ગ અને પૃથ્વીની સૃષ્ટિ કરી.

After testing, pick what to build: