Cheat sheet
Every construct of the studio’s dialect, each in one line. A small document holding most of them comes first; the tables after it list them all, with the page that explains each one. The exercises, :::exercise blocks, are in a section of their own, Writing exercises.
title: A lesson in one screensubtitle: کتاب and its friendslang: entarget: fa## کتاب | ketāb | from Arabic *kitāb* | = *book*The word کتاب = *book* takes the plural کتابها, and [یک PDF]{tl} is aPersian phrase with a Latin word in it.[^1] **Bold**, *italic*, `code`,[تند]{teal translit:tond} in colour, ✗کتابا wrong, ✅ کتابها right → done.> **Remember:** a box holds anything, [\sqrt{16} = 4]{math} included.- **Singular** کتاب- **Plural** کتابها| Form | Meaning ||:--|--:|| کتاب | a book || کتابها | books |[The English under a Persian passage, centred and tinted.]{la align=center bg=sage width=70}[^1]: A footnote, at the foot of the page on paper.Result
A lesson in one screen
کتاب and its friends
کتاب
ketāb
from Arabic kitāb
The word کتاب = book takes the plural کتابها, and یک PDF is a Persian phrase with a Latin word in it.1A footnote, at the foot of the page on paper. Bold, italic, code, تند in colour, ❌کتابا wrong, ✅ کتابها right → done.
Remember: a box holds anything, \sqrt{16} = 4 included.
- Singular
- کتاب
- Plural
- کتابها
| Form | Meaning |
|---|---|
| کتاب | a book |
| کتابها | books |
The English under a Persian passage, centred and tinted.
Notes
- A footnote, at the foot of the page on paper.
1. The document#
| Write | For | Page |
|---|---|---|
--- / title: subtitle: note: lang: target: / --- | the front matter, first in the file | Front matter |
# Title | the title, when the front matter has none | Front matter |
## Section | a numbered section (a typed number is taken off) | Headings |
### Subsection | an unnumbered subsection | Headings |
## word | translit | origin | = *meaning* | a vocabulary entry | Headings |
## word | kana | rōmaji | origin | = *meaning* | a vocabulary entry in Japanese | Headings |
## [word]{teal translit:…} | | origin | a coloured headword, its transliteration in the braces | Headings |
2. Text#
| Write | For | Page |
|---|---|---|
| lines next to each other | one paragraph; a blank line starts the next | Paragraphs |
**bold**, *italic*, `code` | emphasis — never inside a word, never across the target language | Paragraphs |
⏎ | a line break inside a paragraph | Special characters |
✗form, ❌form | a wrong form, in red | Special characters |
✅ | a green tick | Special characters |
→, -> | an arrow, on the screen and on paper | Special characters |
the ZWNJ, «» | the zero-width non-joiner, guillemets | Special characters |
3. The target language#
| Write | For | Page |
|---|---|---|
| کتاب, 日本語, नमस्ते in the prose | a run, found by its script | Target language |
| a paragraph of the script alone | a display line, set larger | Target language |
| a paragraph with no Latin letter | a paragraph in the target language | Target language |
[…]{tl}, […]{fa}, […]{ja}… | a stretch marked as the target language; alone, a block | Target language |
[ … ]{tl} on lines of their own | a passage of several lines | Target language |
{tl bg=quote} — sand rose sage lilac | a tinted block | Target language |
{tl font=nastaliq}, {tl font=gothic} | the second face: Persian, Japanese | Target language |
{tl vertical height=14} | vertical columns: Japanese, Chinese | Target language |
[bello]{tl}, [bello]{it}, any mark | a run of a Latin-script target | Target language |
4. Marks on a word#
| Write | For | Page |
|---|---|---|
[word]{crimson} — indigo teal violet amber | a named colour | Colours |
[word]{#C2185B} | any colour | Colours |
[word]{translit:…} | its transliteration, shown on pointing | Pronunciation |
[word]{kana:… translit:…}, reading: | its reading, in Japanese | Pronunciation |
[word]{teal translit:…} | colour and transliteration together, colour first | Pronunciation |
word = *meaning* | a gloss, gathered into the glossary | Glosses |
[a^2+b^2]{math} | a formula in the line | Mathematics |
5. Blocks#
| Write | For | Page |
|---|---|---|
> … on every line | a box, which holds anything | Boxes |
[…]{la align= bg= width= offset=} as a paragraph | a Latin block; {ltr} is the same | Latin blocks |
- * + / 1. 1) | a list; one level of nesting, two spaces in | Lists |
- **Label** text, every item | a labelled list | Lists |
| a | b | over |:--|--:| | a table; :--: centres; -- alone is an empty cell | Tables |
:::math … ::: | a formula on its own | Mathematics |
:::exercise type … ::: | an exercise | Writing exercises |
6. Notes, links, media#
| Write | For | Page |
|---|---|---|
text[^name] and [^name]: the note | a footnote | Footnotes |
^[the note] | a footnote written in place | Footnotes |
[words](https://…) | a web link | Links |
[](doc:Its name), [words](doc:Its name) | a link to another document, by its name | Links |
{width=60 align=center offset=0} | a picture, on its own line | Media |
{start=1:05.2 end=1:09} | a recording, and the stretch it plays | Media |
@[caption](youtube address){start=90 end=150} | a YouTube video | Media |
7. Not in the dialect#
#### headings, === underlines, code blocks, _x_, ~~x~~, $x$, HTML, escapes, reference links, bare addresses, rules (dropped): see What the studio leaves out.