π Table of Contents
- Quick Start Decision Matrix
- Version 5.8.1 Key Features
- Core Section Guidelines
- Advanced Literary Analysis
- Enhancement Sections
- Second Temple Literature
- Songs & Poetry
- Mobile Navigation
- Quality Assurance
- Bibliography & Sources Guidelines
- Technical Implementation
- Advanced Techniques & Best Practices
- Common Pitfalls & Solutions
- Template Files & Examples
- Resources & Tools
- Version Changelog
π Quick Start Decision Matrix
1οΈβ£ Character Type Classification
| Character Type | Required Sections | Optional Sections | Enhancement Sections | Example |
|---|---|---|---|---|
| Major Patriarch/Matriarch | All core + enhancement sections | Multi-page structure | All 5 recommended | Abraham, Sarah |
| Prophet | All core + prophetic sections | Second Temple if NT referenced | Wordplay, Enhanced Messianic | Moses, Elijah |
| King/Ruler | All core + reign sections | Political context | Covenant Context, Unique Aspects | David, Solomon |
| Judge | All core + deliverance cycle | Military campaigns | Eden Connections | Deborah, Gideon |
| Priest | All core sections | Temple service details | Covenant Context | Aaron, Eli |
| NT Apostle/Disciple | All core sections | Ministry journey | Enhanced Messianic crucial | Peter, Paul |
| Woman | All core sections | Gender dynamics, Songs (if applicable) | Often all enhancements | Ruth, Esther |
| Minor Character | Core sections only | Can combine 3-4 | Usually none | Jabez, Achan |
2οΈβ£ Complexity Assessment
- SIMPLE (1-2 chapters): Core sections, no enhancements, auto-generated mobile tabs
- MODERATE (3-5 chapters): All required + 1-2 enhancements, auto-generated mobile tabs
- COMPLEX (6+ chapters): All sections + 3-5 enhancements, auto-generated mobile tabs
- BOOK-SPANNING: Full treatment with all enhancements, priority-based mobile tabs
3οΈβ£ Essential Metadata Setup
<meta name="character-gender" content="[male/female]">
<meta name="profile-type" content="[single-page/multi-page]">
<meta name="character-id" content="[character-id]">
<meta name="book-id" content="[book-id]">
<meta name="template-version" content="5.8.1">
π Version 5.8.1 Key Features
Dynamic Mobile Navigation
Mobile tabs are now automatically generated based on present sections!
- No manual configuration needed - tabs adapt to your content
- Smart prioritization - shows most important sections when many exist
- Maximum 5 tabs for optimal mobile usability
- Swipe gestures for navigation between sections
- Hide on scroll down, show on scroll up
- Priority system ensures key sections always appear:
- Overview (priority 1)
- Narrative/Journey (priority 2)
- Biblical Theology (priority 2)
- Application (priority 2)
- Themes (priority 3)
How It Works
// Automatic detection and generation
// No HTML needed - just include your sections
// character-page.js handles everything:
- Detects all sections with IDs
- Applies icon and label mapping
- Prioritizes if >5 sections exist
- Generates responsive tab interface
ποΈ Core Section Guidelines
Section 1: Overview
Critical Requirements:
- Name Fields:
- OT Characters: Hebrew ONLY unless NT theological significance
- NT Characters: Greek PRIMARY, Hebrew/Aramaic if relevant
- Etymology: Break down root meanings and theological significance
- Tags: 5-7 maximum (2 primary, 3-5 secondary)
- Summary: 3-4 sentences covering scope and significance
- Theological Significance Box: 2-3 sentences on redemptive importance
Section 2: Narrative Journey
Structure Requirements:
- Minimum Events: 4 for moderate characters, 2-3 for minor
- Event Format: Title + Scripture + 2-3 descriptive sentences
- Hebrew/Greek Terms: Include for key emotional/theological moments
- Pattern Box: Optional insight identifying cycles/development
Timeline Animation: Use .timeline-item class for scroll animations
Section 3: Literary Context & Structure
Four Required Cards:
- π Position in Book - Structural placement significance
- π Literary Patterns - Repetitions, parallels, MINOR chiasms
- π Character Function - Protagonist, antagonist, foil, catalyst
- βοΈ Narrative Techniques - Authorial presentation methods
π Advanced Literary Analysis
Chiastic Structure Analysis
- Spans multiple chapters
- Serves as primary organizing structure
- Center has crucial theological significance
- Recognized by multiple scholars
Documentation Format:
<div class="chiasm-structure">
<div class="chiasm-line">A [Opening theme]</div>
<div class="chiasm-line indent-1">B [Development]</div>
<div class="chiasm-line indent-2">C [Crisis/conflict]</div>
<div class="chiasm-center">CENTER: [Theological pivot point]</div>
<div class="chiasm-line indent-2">Cβ² [Resolution mirrors]</div>
<div class="chiasm-line indent-1">Bβ² [Development mirrors]</div>
<div class="chiasm-line">Aβ² [Closing theme]</div>
</div>
Comprehensive Literary Techniques Checklist
Parallelism Types
- Synonymous: Same idea in different words
- Synthetic: Second line completes first line's thought
- Antithetic: Contrasting ideas for emphasis
- Climactic: Building intensity through repetition
- Emblematic: Metaphor/symbol illustrating truth
Structural Patterns
- Inclusio/Bookends: Opening and closing with same phrase/theme
- Ring Composition: Concentric narrative circles
- Panel Structure: Episodes framing central narrative
- Doublets: Repeated stories with development
- Triadic Patterns: Three-fold repetition for completion
Sound Patterns & Wordplay
- Paronomasia: Sound-based word connections
- Alliteration: Repeated consonant sounds
- Assonance: Repeated vowel sounds
- Consonance: Repeated consonant patterns
- Name Etymology: Meaning connections to character development
Narrative Techniques
- Progressive Revelation: Information unveiled gradually
- Narrative Gaps: Strategic silences creating tension
- Focalization Shifts: Changing perspectives
- Direct Discourse: Character speeches revealing personality
- Type Scenes: Repeated narrative patterns
Imagery & Metaphor Systems
- Dominant Metaphors: Controlling images throughout narrative
- Symbol Development: Objects gaining meaning through story
- Irony Patterns: Situational, dramatic, or verbal
- Foreshadowing: Early hints of later developments
- Echo Patterns: Repeated words/phrases across narrative
β‘ Enhancement Sections (Complex Characters)
When to Include Enhancement Sections
1. Eden Connections Section
Include when: Character has clear creation/fall/redemption parallels
Content Framework:
- New Adam/Eve theology applications
- Paradise/Garden themes and echoes
- Creation ex nihilo patterns (life from death)
- Promise in exile parallels
- Deception patterns from Genesis 3
- Seed promise advancement (protoevangelium development)
2. Hebrew/Greek Wordplay Grid
Include when: 3+ significant linguistic patterns present
Documentation Method:
<div class="word-study">
<h4>[Hebrew/Greek Term]</h4>
<p><strong>Pattern:</strong> [Description of wordplay]</p>
<p><strong>Progression:</strong> [How usage develops]</p>
<p><strong>Significance:</strong> [Theological impact]</p>
</div>
3. Covenant Context Section
Include when: Character is active covenant participant
Categories to Address:
- International Treaties: Foreign nation relationships
- Clan/Tribal Alliances: Family and kinship bonds
- Marriage Covenants: Partnership in divine purpose
- Personal Covenants: Direct divine relationships
- Genealogical Significance: Place in redemptive line
4. Unique Aspects Section
Include when: Character has 5+ distinctive features
Documentation Focus:
- Features unique to this character in Scripture
- "Only" statements and unprecedented elements
- Distinctive narrative techniques used only here
- Unprecedented actions or experiences
- Theological innovations through this character
5. Enhanced Messianic Contribution
Include when: Character directly advances messianic line/understanding
Structure:
- Trajectory Timeline: How messianic promise develops through character
- Narrative Shaping: How character's story shapes messianic expectations
- Theological Shaping: Doctrinal contributions to messianic understanding
- Typology Chains: Connections leading to Christ
- Direct Prophecies: Explicit messianic predictions
π Second Temple Literature Section
When to Include (Mandatory Criteria)
β INCLUDE when character has:
- NT references drawing from Jewish interpretive traditions
- Second Temple developments that NT authors assume
- Interpretive layers between OT text and NT usage
High Priority Characters
| Character | NT Passage | Second Temple Source | Transformation Type |
|---|---|---|---|
| Sarah/Hagar | Galatians 4:21-31 | Allegorical interpretation traditions | Literal history β theological categories |
| Abraham | Romans 4; Hebrews 11 | Faith paradigm development | Individual β universal model |
| Moses | Jude 9 | Assumption of Moses | Hidden tradition β revealed conflict |
| Enoch | Jude 14-15 | 1 Enoch 1:9 | Direct quotation with application |
| Adam | Romans 5; 1 Cor 15 | Life of Adam and Eve | Individual β corporate representative |
| David | Multiple NT | Son of Man + Psalm 110 | Royal β cosmic authority |
Transformation Techniques Taxonomy
- Presumed Fluency: NT assumes audience knows tradition
- Temporal Collapse: Future expectations β present reality
- Textual Braiding: Multiple texts β single claim
- Authority Demonstration: Shows rather than argues
- Ethical Surprise: Apocalyptic serves unexpected mercy
- Role Reversal: Power dynamics inverted
- Embodied Fulfillment: Abstract becomes concrete
- Personal Identification: Divine identifies with human
π΅ Songs & Poetry Section
Biblical Women with Songs (Mandatory Inclusion)
| Character | Song Reference | Type | Link Pattern |
|---|---|---|---|
| Miriam | Exodus 15:20-21 | Victory song | /studies/women/songs/miriam-song.html |
| Deborah | Judges 5 | Victory song with Barak | /studies/women/songs/deborah-song.html |
| Hannah | 1 Samuel 2:1-10 | Thanksgiving prayer | /studies/women/songs/hannah-song.html |
| Mary | Luke 1:46-55 | Magnificat | /studies/women/songs/mary-song.html |
π± Mobile Navigation (New in v5.8.1)
Automatic Tab Generation
No manual configuration needed! The system automatically:
-
Detects Present Sections
- Scans for all sections with IDs
- Matches against configuration database
- Applies appropriate icons and labels
-
Smart Selection (if >5 sections)
- Uses priority system (1-5)
- Always includes Overview if present
- Balances coverage vs. usability
-
Priority Levels
Priority 1: Overview Priority 2: Narrative, Biblical Theology, Application Priority 3: Themes, Messianic, Literary Context Priority 4: ANE Context, Intertext, Questions, Chiasm Priority 5: Enhancement sections (Eden, Wordplay, etc.) -
User Experience Features
- Hide on scroll down, show on scroll up
- Swipe left/right between sections
- Active state tracking
- Smooth scroll to sections
- Maximum 5 tabs for usability
β Comprehensive Quality Assurance
Pre-Publication Checklist
Metadata & Structure
- Template version set to "5.8.1"
- Character gender, profile-type, character-id, book-id configured
- Data attributes on title element match metadata
- Body class includes
woman-profileif female - All [bracketed] placeholders replaced
Navigation & UX
- Quick navigation items match actual sections
- Chiasm nav item added only if chiasm section included
- Second Temple nav item added only if section included
- All interactive elements meet 44px minimum touch target
- Reading progress bar implemented
- Back to top button functional
- Mobile tabs auto-generating correctly NEW v5.8.1
Content Completeness
- All 7 core sections present and substantial
- Character type badge appropriate
- Complexity indicator accurate
- Enhancement sections appropriate to character type
- Second Temple section included if NT connections present
- Songs section for women with biblical songs
Literary Analysis Quality
- Major chiasms separate from literary patterns
- Minor chiasms properly placed in patterns card
- Literary techniques documented with examples
- Hebrew/Greek text properly formatted
- Narrative techniques specific to character
Scripture & Sources
- All scripture references use abbreviated format
- Hebrew text displays correctly (RTL)
- Greek text displays correctly (LTR)
- Etymology explained clearly with breakdown
- Bibliography meets minimum requirements:
- Major characters: 15+ sources
- Moderate characters: 10+ sources
- Minor characters: 5+ sources
Content Quality Standards
Writing Excellence
- Seminary Level: Academic rigor without unnecessary jargon
- Present Tense: For narrative description
- Active Voice: When possible
- Specific Citations: Always include verse references
- Descriptive First: What text says before application
Hebrew/Greek Standards
- OT Characters: Hebrew names ONLY in meta fields
- NT Characters: Greek names PRIMARY in meta fields
- Inline Usage: Key theological terms with transliteration
- Proper Display: RTL for Hebrew, LTR for Greek
- Etymology: Root breakdown with theological significance
π Bibliography & Sources Guidelines
Source Categories (Required Order)
-
Primary Sources
- Hebrew Bible (BHS)
- Greek New Testament (NA28) if applicable
- LXX if theologically relevant
-
Major Commentaries
- Minimum 2 required for any character
- Academic series preferred (ICC, WBC, NICOT, etc.)
-
Literary & Narrative Analysis
- Required for all characters
- Include literary specialists (Alter, Fokkelman, etc.)
-
Second Temple & Jewish Sources (Conditional)
- Include when Second Temple section present
- Charlesworth (OT Pseudepigrapha) essential
- Specific text studies relevant to character
-
Ancient Near Eastern Context
- Include when ANE parallels significant
- Archaeological evidence when available
-
Theological & Thematic Studies
- Biblical theology perspectives
- Systematic theology connections
-
Reference Works
- Hebrew/Greek lexicons
- Dictionaries and encyclopedias
Citation Best Practices
- Chicago Manual of Style, 17th edition
- Descriptive usage tags: Never use section numbers
- Specific page references: When citing particular insights
- Multiple usage: Tag with all relevant sections
Usage Tag Standards
<span class="usage-tag">Narrative Journey, Themes, Biblical Theology</span>
<span class="usage-note">Character development and theological themes, pp. 156-178</span>
π§ Technical Implementation
Required CSS Classes
Content Classes
.theology-card- Main content cards.chiasm-card- Major chiastic structures.timeline-item- Narrative timeline entries.animate-on-scroll- Scroll-triggered animations
Language & Navigation
.hebrew/.greek- Language formatting.bibliography-section- Expandable bibliography.mobile-section-tabs- Auto-generated mobile nav (v5.8.1)
JavaScript Features
- Reading Progress: Calculates scroll percentage
- Quick Navigation: Active section highlighting
- Intersection Observer: Lazy-load animations
- Mobile Menu: Responsive navigation
- Bibliography Toggle: Expand/collapse functionality
- Dynamic Mobile Tabs: Auto-generation based on content (v5.8.1)
Performance Optimization
- Minified CSS: Use
global-v2.css - Font Preloading: SBL Hebrew/Greek fonts
- Image Optimization: WebP format preferred
- Lazy Loading: Images and heavy content sections
- Efficient Mobile Tabs: Only generated when needed (v5.8.1)
π§° Advanced Techniques & Best Practices
Character-Specific Optional Sections
For Prophets:
<div class="theology-card animate-on-scroll">
<h3>Prophetic Messages & Fulfillment</h3>
<table>
<thead>
<tr><th>Oracle</th><th>Context</th><th>Fulfillment</th></tr>
</thead>
<tbody>
<tr><td>[Prophecy]</td><td>[Historical context]</td><td>[How fulfilled]</td></tr>
</tbody>
</table>
</div>
For Kings/Rulers:
<div class="theology-card animate-on-scroll">
<h3>Reign Summary & Evaluation</h3>
<div class="grid-2">
<div>
<h4>Political Context</h4>
<ul><li>[Major political events]</li></ul>
</div>
<div>
<h4>Theological Evaluation</h4>
<ul><li>[Did what was right/evil in LORD's sight]</li></ul>
</div>
</div>
</div>
For Women:
<div class="theology-card animate-on-scroll">
<h3>Gender Dynamics & Power Structures</h3>
<div class="grid-2">
<div>
<h4>π© Female Agency</h4>
<ul><li>[Evidence of authority/decision-making]</li></ul>
</div>
<div>
<h4>β‘ Patriarchal Subversion</h4>
<ul><li>[How story challenges/affirms norms]</li></ul>
</div>
</div>
</div>
Multi-Page Profile Structure
File Structure:
/studies/characters/[book]/[character]/[character].html (main)
/studies/characters/[book]/[character]/early-life.html
/studies/characters/[book]/[character]/ministry.html
/studies/characters/[book]/[character]/legacy.html
Navigation Between Pages:
<div class="page-navigation">
<h3>Multi-Page Study Navigation</h3>
<div class="page-nav-grid">
<a href="[character].html" class="page-nav-item current">
<h4>Main Profile</h4>
<p class="nav-subtitle">Overview & core analysis</p>
</a>
<a href="early-life.html" class="page-nav-item">
<h4>Early Life</h4>
<p class="nav-subtitle">Formative experiences</p>
</a>
</div>
</div>
π― Common Pitfalls & Solutions
β What to Avoid
- Wrong name fields: Greek for OT characters
- Generic cross-references: Missing multi-page profile links
- Numbered section references: Use descriptive names in bibliography
- Over-enhancement: Minor characters don't need all enhancements
- Missing Second Temple: NT connections without background analysis
- Chiasm confusion: Minor patterns in major chiasm sections
- Generic questions: Make study questions character-specific
- Manual mobile tabs: Never hardcode mobile navigation v5.8.1
β Excellence Indicators
- Character-specific insights: Not generic biblical information
- Literary sophistication: Advanced narrative analysis
- Theological integration: Clear redemptive-historical connections
- Academic rigor: Seminary-level scholarship
- Practical application: Contemporary relevance without forcing
- Cross-textual awareness: Biblical theology connections
- User experience: Professional presentation with smooth functionality
- Adaptive navigation: Mobile tabs match actual content v5.8.1
π Template Files & Examples
Available Templates
biblical-character-template-v5-8-1.html- Current template with dynamic mobile tabscharacter-page-v5-8.js- Enhanced with auto-generating mobile navigationsarah.html- Complete example (complex character)hagar.html- Example with Second Temple sectiondelilah.html- Moderate character example
Hub Integration
- Characters automatically appear in appropriate hubs
- JSON data structure for hub display
- Search functionality integration
- Cross-reference system
- Mobile-optimized hub navigation
Testing Checklist
// Console verification commands
console.log('Template Version:', document.querySelector('meta[name="template-version"]')?.content);
console.log('Character ID:', document.querySelector('[data-character-id]')?.getAttribute('data-character-id'));
console.log('Quick Nav Items:', document.querySelectorAll('.quick-nav-item').length);
console.log('Animate Elements:', document.querySelectorAll('.animate-on-scroll').length);
console.log('Mobile Tabs:', document.querySelectorAll('.mobile-section-tabs .tab-item').length);
console.log('Tab Priority:', window.innerWidth <= 768 ? 'Active' : 'Desktop mode');
π Resources & Tools
Recommended Software
- Bible Software: Logos, Accordance, BibleWorks
- Hebrew/Greek Fonts: SBL Hebrew, SBL Greek (free from SBL)
- HTML Editor: VS Code with Live Server extension
- Citation Management: Zotero with SBL Handbook of Style
- Version Control: Git for template management
Academic Resources
- Commentaries: Use major academic series
- Literary Analysis: Alter, Fokkelman, Berlin, Sternberg
- Second Temple: Charlesworth, GarcΓa MartΓnez, Collins
- Biblical Theology: Alexander, Dempster, Goldsworthy
- Hebrew/Greek: BDB, BDAG, HALOT, TDNT, NIDOTTE
π Version Changelog
Version 4.1 (Current)
- Dynamic Mobile Navigation: Complete documentation for v5.8.1 auto-generating tabs
- Priority System: Explanation of smart tab selection algorithm
- No Manual Configuration: Removed all references to hardcoded mobile tabs
- Enhanced Testing: Added mobile tab verification to checklist
- Template v5.8.1 Integration: Full documentation of dynamic features
Last Updated: October 2025 β’ Template Version: 5.8.1 β’ Documentation Version: 4.1
License: Educational and ministry use. Attribution appreciated but not required.