fls-syntax-blocks

To write grammar blocks in reStructuredText, use the .. syntax:: directive to define syntax rules and literal tokens. This approach aligns with frontmatter metadata to structure grammar conventions for software documentation.

Literal tokens in FLS syntax blocks use the $$ notation to define specific text matches, while identifier rules categorize syntax elements. These conventions help structure grammar definitions within reStructuredText documentation sources.

You define syntax categories by applying identifier rules within .. syntax:: blocks in your reStructuredText sources. This categorizes literal tokens and grammar elements, providing clear explanations for documentation authors.

Yes, you can use FLS syntax blocks for editing existing reStructuredText documentation. The directive provides explanations and examples that integrate with in-text guidance to update literal tokens and syntax categories.

The best way to structure frontmatter metadata for .. syntax:: blocks is to align it with your in-text guidance and literal token definitions. This ensures FLS syntax blocks render correctly and maintain consistent grammar conventions.

Literal tokens may not render correctly in reStructuredText if the $$ notation or identifier rules are misaligned with frontmatter metadata. Verify that your .. syntax:: blocks match the defined FLS grammar conventions.