Date: 2025-02-23
Status
Accepted
Context
We need standardized blank templates for new book projects that:
- Provide consistent starting structure
- Include common front/back matter
- Support metadata configuration
- Allow easy customization
- Maintain separation from test templates
Decision
We will implement a blank template structure:
- Directory Organization # TODO update with current file structure
src/templates/blank/
├── content/
│ ├── back-matter/
│ ├── chapters/
│ └── front-matter/
├── meta.yaml
└── book.tex
-
Template Types
- Minimal LaTeX templates with placeholders
- Standard front/back matter sections
- Basic chapter structure
- Default metadata configuration
-
Usage Pattern
- Templates copied during project initialization
- Placeholders replaced with project values
- Structure preserved but content customizable
- Clear documentation of available options
Consequences
Positive
- Consistent project initialization
- Reduced setup time
- Standard structure across projects
- Clear customization points
- Separation from test templates
Negative
- Need to maintain template versions
- Must document placeholder usage
- Additional project structure to manage
- May need multiple template variants