Built-in content.text plugin

[traut]

Background

In addition to the installable plugins (#3), fabric must have built-in plugins to allow generation of simple content without the need to download extra components.

Related: #13, #18

Design

content.text plugin is be a part of the fabric binary.

Specification

• the plugin has no configuration options
• API interface:
  • local context object
  • required text string attribute
  • optional format_as enum string attribute with allowed values title, code and blockquote (nil by default)
  • optional absolute_title_size int attribute (nil by default)
  • optional code_language string attribute

Behavior

The plugin renders and returns a text value as a template string using local context as input data and formats it in Markdown according to format_as parameter (if provided).

If format_as set to code, the text is formatted with triple backticks. If code_language is provided, the language should be set after the first triple backtick.

If format_as is title and absolute_title_size is set, the Markdown title size is absolute_title_size * #
If format_as is title and absolute_title_size is not set, the relative title size is calculated from the local context object that contains a document body (issue TBD) -- the multiplier for # for a Markdown title prefix is the number of title text seen previously in the document

Deliverables

• new built-in content.text plugin
• unit test for the plugin

[traut]

implemented in #43

[traut]

reopening, pending #17, to add the implementation of a relative title size

[traut]

moved to v0.4 milestone because it depends on #98, as agreed in a conversation on slack