41 lines
1.3 KiB
Text
41 lines
1.3 KiB
Text
|
@import template.nml
|
||
|
|
@nav.previous = References
|
||
|
|
%<make_doc({}, "Raw", "Raw")>%
|
||
|
|
|
||
|
|
Raws are elements to be rendered as-is by the compiler.
|
||
|
|
|
||
|
|
# Inline raws
|
||
|
|
|
||
|
|
Inline raws are meant to be used inside a paragraph and thus, don't break the paragraph.
|
||
|
|
Here's the syntax for inline raws: ``Plain Text, {?[kind=inline] CONTENT ?}``.
|
||
|
|
Here, ``CONTENT`` will added directly to the resulting document.
|
||
|
|
|
||
|
|
**Example**
|
||
|
|
#+LAYOUT_BEGIN Split
|
||
|
|
``Plain Text, {? <a style="color:red"> ?} Some text {? </a> ?}``
|
||
|
|
#+LAYOUT_NEXT
|
||
|
|
{? <a style="color:red"> ?} Some text {? </a> ?}
|
||
|
|
#+LAYOUT_END
|
||
|
|
|
||
|
|
Raws are better paired with Lua, see &{#custom_style}[caption=Defining a custom style] for how to use them.
|
||
|
|
|
||
|
|
# Block raws
|
||
|
|
|
||
|
|
You can have raw elements take a full block to define additional capabilities.
|
||
|
|
The syntax is similar to inline raws, except that ``kind=block`` is used instead.
|
||
|
|
|
||
|
|
**Example**
|
||
|
|
#+LAYOUT_BEGIN Centered
|
||
|
|
#+LAYOUT_BEGIN Split
|
||
|
|
``Plain Text, {?[kind=block] <img src="assets/duck.jpg" style="max-height:100%;max-width:100%;"> ?}``
|
||
|
|
#+LAYOUT_NEXT
|
||
|
|
{?[kind=block] <img src="assets/duck.jpg" style="max-height:100%;max-width:100%;"> ?}
|
||
|
|
#+LAYOUT_END
|
||
|
|
#+LAYOUT_END
|
||
|
|
|
||
|
|
|
||
|
|
# Properties
|
||
|
|
* ``kind`` The element kind of the resulting raw, defaults to `inline`, allowed values:
|
||
|
|
*- ``inline``: Make the raw element inline
|
||
|
|
*- ``block``: Make the raw element a full block
|