Repository Formats

Migration & Conversion

Repository Formats Overview

Complete guide to all repository formats and specifications supported by Door43

Repository Formats Overview

This section provides comprehensive documentation for all repository formats and specifications used in the Door43 ecosystem. The guides are organized by specification type for better clarity and navigation.

📋 Specifications Covered

Resource Container (RC)

The primary unfoldingWord specification for Bible translation resources.

🌯 Scripture Burrito (SB)

Alternative Bible resource specification with flexible organization.

Tool-Generated Formats

Special formats created by translation tools with unique structures.

🎯 How to Use These Guides

By Specification Type

  • Resource Container: Most common format, used by unfoldingWord for all major resources
  • Scripture Burrito: Alternative format, more flexible but less common
  • Tool-Generated: Special handling for tool-specific formats

By Resource Type

  • Bible Texts: UHB, UGNT, ULT, UST → Resource Container guides
  • Translation Helps: TN, TQ, TW, TWL, TA → Resource Container guides
  • Stories: OBS → Resource Container guides
  • Tool Projects: → Tool-Generated guides
  • Alternative Formats: → Scripture Burrito guides

By Use Case

  • Building Preview Apps: Focus on Resource Container guides (most content)
  • Creating Editing Tools: All specifications for comprehensive support
  • Format Conversion: Migration guides for RC ↔ SB conversion
  • Tool Integration: Tool-Generated guides for specific tool support

📊 Specification Comparison

AspectResource ContainerScripture BurritoTool-Generated
Primary UseStandard unfoldingWord resourcesAlternative Bible resourcesTool-specific projects
File OrganizationFlat structure with manifest.yamlIngredients-based organizationTool-specific patterns
Metadata FormatYAML manifestJSON metadataTool-specific formats
Content TypesUSFM, TSV, MarkdownFlexible MIME typesTool-dependent
ComplexityMediumHighVariable
AdoptionVery HighLowTool-specific

🚀 Getting Started

New to Door43 Resources?

  1. Start with Resource Container Bible Text guide
  2. Learn the basic patterns and file structures
  3. Explore other Resource Container guides as needed

Need Alternative Formats?

  1. Check Scripture Burrito guide
  2. Use Migration guides for format conversion

Working with Tool Projects?

  1. Identify the tool that created the project
  2. Use the appropriate Tool-Generated guide

🔗 Related Documentation

Need help choosing the right guide? Most Door43 resources use the Resource Container specification, so start there unless you know you're working with Scripture Burrito or tool-generated content.