Content¶

Reference: the document vocabulary in sextile.content.blocks, for a service turning something richer than strings into frames.

Showing	Block
running text	`Paragraph`
a quotation, which may itself quote	`Quote`
a code listing, drawn as given	`Code`
one item of a list	`ListItem`
a picture a terminal can only name	`Image`
a file named but not retrievable	`Attachment`
a link, numbered so the text can refer to it	`Link`

A Document holds a tuple of these; typesetting.rows_for lays it out into the Rows a Prose part draws — quotations in cyan, listings in green, nesting indented, over-long words broken rather than dropped. transliterate, at the top level of sextile, folds text a terminal cannot draw down to what it can.

from sextile import Page, PageLayout, PageRequest, PageRouter, Sextile
from sextile.content.blocks import Code, Document, ListItem, Paragraph, Quote
from sextile.formatting import Prose
from sextile.viewdata.typesetting import rows_for

_DOC = Document(blocks=(
    Paragraph(("Running text wraps to the width of the frame.",)),
    Quote((Paragraph(("A quotation is drawn in cyan.",)),)),
    ListItem("A list item, marked and indented."),
    Code(("CODE  is drawn  as given",)),
))

router = PageRouter()


@router.page("1", name="digest", title="Digest")
async def digest(request: PageRequest) -> Page:
    return PageLayout(title="DIGEST", parts=[Prose(entries=rows_for(_DOC))]).build(request)


app = Sextile(name="Reader", pages=[*router])

 DIGEST                               1a
  
Running text wraps to the width of the  
frame.                                  
                                        
   A quotation is drawn in cyan.        
                                        
* A list item, marked and indented.     
                                        
 CODE is drawn as given                 
                                        
                                        
                                        
                                        
                                        
                                        
                                        
                                        
                                        
                                        
                                        
                                        
  
 0 index

See sextile.content.blocks for the detail.