Text Rendering

Layouts keep a document’s shape separate from the values supplied at render time. This chapter covers the render environment, layout loading, context values, the template language, and shared document structure. Start with Text Rendering Overview to find the topic you need.

• Text Rendering Overview
• Rendering Text with Layouts
  • From a Layout to a Document
  • Reading the Layout Language
  • Render Environments, Layouts, and Contexts
  • Render Workflow, StringFormat, and Placeholder Alternatives
• Using the Render Engine
  • A Complete Rendering Pass
  • Configure the Environment
  • Find the Layout by Name
  • Supply Values for This Document
  • Render and Handle Failures
• Configuring the Render Environment
  • Environment Reuse, Concurrent Rendering, and Auto-Reload
  • Global Render Context and Shared Values
  • Local Context Overrides of Global Values
  • Registering Custom Render Filters
  • Configuring Layout Delimiters
  • Configuring Output Escaping
  • Rendering Work and Output Limits
• Loading Render Layouts
  • Logical Layout Names
  • Loading Layouts with FileSystemLoader
  • Loading Compiled Layouts with ResourceLoader
  • Loader Priorities and Local Overrides
  • Implementing a Custom Layout Loader
• Preparing Render Contexts and Values
  • Binding Names in a Render Context
  • Scalar, List, and Map Values
  • Lazy Render Values and Callback Lifetime
• Template Language Syntax
  • Expression, Statement, and Comment Delimiters
  • Value Expressions and Filters
  • Conditional Branches and Local Assignments
  • Loops over Lists and Maps
  • Whitespace Control in Templates
• Sharing Layouts with Inheritance
  • Defining Named Template Blocks
  • Extending a Base Layout and Overriding Blocks
  • Rendering Parent-Block Content with super()
  • Multi-Level Layout Inheritance
  • Content Rules for Base and Extending Layouts
• Template Feature Cheat Sheet
  • Markers and Whitespace
  • Expressions at a Glance
  • Built-In Filters
  • Statements and Layout Structure
  • Output Escaping
  • A Working Layout