Typography
This section provides examples of all style elements available to documentation authors and the guidelines on using them.
Links
We have special types of links to refer readers to:
Input:
Raw data is stored in {{<term "slices" "data-slice">}} that are linked from {{<schema "MetadataBlock">}}s.
Result:
Raw data is stored in slices that are linked from MetadataBlock s.
Code Blocks
Input:
```js
const client = OdfClient::new("odf+https://localhost:8080");
```
Result:
const client = OdfClient::new("odf+https://localhost:8080");
Text Blocks
Input:
{{<tip>}}
Tip block
{{</tip>}}
{{<note>}}
Note block
{{</note>}}
{{<info>}}
Info block
{{</info>}}
{{<warning>}}
Warning block
{{</warning>}}
{{<danger>}}
Danger block
{{</danger>}}
Result:
Tip block
Note block
Info block
Warning block
Danger block
Tables
Input:
| Name | Description |
| ---- | :---------: |
| Foo | Test |
| Bar | Test |
Result:
| Name | Description |
|---|---|
| Foo | Test |
| Bar | Test |
Tabs
Input:
{{<tabs
tabTotal="3"
tabID="1"
tabName1="Tab 1"
tabName2="Tab 2"
tabName3="Tab 3">}}
{{<tab tabNum="1">}}
Tab 1 content as text
{{</tab>}}
{{< tab tabNum="2">}}
Tab 2 content
- as
- list
{{</tab>}}
{{< tab tabNum="3">}}
{{<info>}}
Tab 3 content as rich elements
{{</info>}}
{{</tab>}}
{{</tabs>}}
Result:
Tab 1 content as text
Tab 2 content
- as
- list
Tab 3 content as rich elements
Static Image
Input:
{{<image filename="/images/kamu_logo.svg" alt="Kamu logo" width="30%">}}
Result:
YouTube Video
Input:
{{<youtube hN_vpHYmwi0>}}
Result:
YouTube Playlist
Input:
{{<youtube-list PLV91cS45lwVG20Hicztbv7hsjN6x69MJk>}}
Result:
GOAT Diagrams
Input:
```goat
. . . .--- 1 .-- 1 / 1
/ \ | | .---+ .-+ +
/ \ .---+---. .--+--. | '--- 2 | '-- 2 / \ 2
+ + | | | | ---+ ---+ +
/ \ / \ .-+-. .-+-. .+. .+. | .--- 3 | .-- 3 \ / 3
/ \ / \ | | | | | | | | '---+ '-+ +
1 2 3 4 1 2 3 4 1 2 3 4 '--- 4 '-- 4 \ 4
```
Result:
See more examples here.
Mermaid Diagrams
Input:
```mermaid
sequenceDiagram
Alice ->> Bob: Hello Bob, how are you?
Bob-->>John: How about you John?
Bob--x Alice: I am good thanks!
Bob-x John: I am good thanks!
Note right of John: Bob thinks a long
long time, so long
that the text does
not fit on a row.
Bob-->Alice: Checking with John...
Alice->John: Yes... John, how are you?
```
Result:
sequenceDiagram
Alice ->> Bob: Hello Bob, how are you?
Bob-->>John: How about you John?
Bob--x Alice: I am good thanks!
Bob-x John: I am good thanks!
Note right of John: Bob thinks a long
long time, so long
that the text does
not fit on a row.
Bob-->Alice: Checking with John...
Alice->John: Yes... John, how are you?
See more examples here.