Micron Playground

-∿ < `c`!Hello!`! This is output from `*micron`* Micron generates formatted text for your terminal `a -∿ < Nomad Network supports a simple and functional markup language called `*micron`*. If you are familiar with `*markdown`* or `*HTML`*, you will feel right at home writing pages with micron. With micron you can easily create structured documents and pages with formatting, colors, glyphs and icons, ideal for display in terminals. >>Recommendations and Requirements While micron can output formatted text to even the most basic terminal, there's a few capabilities your terminal `*must`* support to display micron output correctly, and some that, while not strictly necessary, make the experience a lot better. Formatting such as `_underline`_, `!bold`! or `*italics`* will be displayed if your terminal supports it. If you are having trouble getting micron output to display correctly, try using `*gnome-terminal`* or `*alacritty`*, which should work with all formatting options out of the box. Most other terminals will work fine as well, but you might have to change some settings to get certain formatting to display correctly. >>>Encoding All micron sources are intepreted as UTF-8, and micron assumes it can output UTF-8 characters to the terminal. If your terminal does not support UTF-8, output will be faulty. >>>Colors Shading and coloring text and backgrounds is integral to micron output, and while micron will attempt to gracefully degrade output even to 1-bit terminals, you will get the best output with terminals supporting at least 256 colors. True-color support is recommended. >>>Terminal Font While any unicode capable font can be used with micron, it's highly recommended to use a `*"Nerd Font"`* (see https://www.nerdfonts.com/), which will add a lot of extra glyphs and icons to your output. > A Few Demo Outputs `F222`Bddd `cWith micron, you can control layout and presentation `a `` `B33f You can change background ... `` `B393 `r`F320... and foreground colors`f `a `b If you want to make a break, horizontal dividers can be inserted. They can be plain, like the one below this text, or you can style them with unicode characters and glyphs, like the wavy divider in the beginning of this document. - `cText can be `_underlined`_, `!bold`! or `*italic`*. You can also `_`*`!`B5d5`F222combine`f`b`_ `_`Ff00f`Ff80o`Ffd0r`F9f0m`F0f2a`F0fdt`F07ft`F43fi`F70fn`Fe0fg`` for some fabulous effects. `a >>>Sections and Headings You can define an arbitrary number of sections and sub sections, each with their own named headings. Text inside sections will be automatically indented. - If you place a divider inside a section, it will adhere to the section indents. >>>>> If no heading text is defined, the section will appear as a sub-section without a header. This can be useful for creating indented blocks of text, like this one. >Micron tags Tags are used to format text with micron. Some tags can appear anywhere in text, and some must appear at the beginning of a line. If you need to write text that contains a sequence that would be interpreted as a tag, you can escape it with the character \\. In the following sections, the different tags will be introduced. Any styling set within micron can be reset to the default style by using the special \\`\\` tag anywhere in the markup, which will immediately remove any formatting previously specified. >>Alignment To control text alignment use the tag \\`c to center text, \\`l to left-align, \\`r to right-align, and \\`a to return to the default alignment of the document. Alignment tags must appear at the beginning of a line. Here is an example: `Faaa `= `cThis line will be centered. So will this. `aThe alignment has now been returned to default. `rThis will be aligned to the right `` `= `` The above markup produces the following output: `Faaa`B333 `cThis line will be centered. So will this. `aThe alignment has now been returned to default. `rThis will be aligned to the right `` >>Formatting Text can be formatted as `!bold`! by using the \\`! tag, `_underline`_ by using the \\`_ tag and `*italic`* by using the \\`* tag. Here's an example of formatting text: `Faaa `= We shall soon see `!bold`! paragraphs of text decorated with `_underlines`_ and `*italics`*. Some even dare `!`*`_combine`` them! `= `` The above markup produces the following output: `Faaa`B333 We shall soon see `!bold`! paragraphs of text decorated with `_underlines`_ and `*italics`*. Some even dare `!`*`_combine`!`*`_ them! `` >>Sections To create sections and subsections, use the > tag. This tag must be placed at the beginning of a line. To specify a sub-section of any level, use any number of > tags. If text is placed after a > tag, it will be used as a heading. Here is an example of sections: `Faaa `= >High Level Stuff This is a section. It contains this text. >>Another Level This is a sub section. >>>Going deeper A sub sub section. We could continue, but you get the point. >>>> Wait! It's worth noting that we can also create sections without headings. They look like this. `= `` The above markup produces the following output: `Faaa`B333 >High Level Stuff This is a section. It contains this text. >>Another Level This is a sub section. >>>Going deeper A sub sub section. We could continue, but you get the point. >>>> Wait! It's worth noting that we can also create sections without headings. They look like this. `` >Colors Foreground colors can be specified with the \\`F tag, followed by three hexadecimal characters. To return to the default foreground color, use the \\`f tag. Background color is specified in the same way, but by using the \\`B and \\`b tags. Here's a few examples: `Faaa `= You can use `B5d5`F222 color `f`b `Ff00f`Ff80o`Ffd0r`F9f0m`F0f2a`F0fdt`F07ft`F43fi`F70fn`Fe0fg`f for some fabulous effects. `= `` The above markup produces the following output: `Faaa`B333 You can use `B5d5`F222 color `f`B333 `Ff00f`Ff80o`Ffd0r`F9f0m`F0f2a`F0fdt`F07ft`F43fi`F70fn`Fe0fg`f for some fabulous effects. `` >Links Links to pages, files or other resources can be created with the \\`[ tag, which should always be terminated with a closing ]. You can create links with and without labels, it is up to you to control the formatting of links with other tags. Although not strictly necessary, it is good practice to at least format links with underlining. Here's a few examples: `Faaa `= Here is a link without any label: `[72914442a3689add83a09a767963f57c:/page/index.mu] This is a `[labeled link`72914442a3689add83a09a767963f57c:/page/index.mu] to the same page, but it's hard to see if you don't know it Here is `F00a`_`[a more visible link`72914442a3689add83a09a767963f57c:/page/index.mu]`_`f `= `` The above markup produces the following output: `Faaa`B333 Here is a link without any label: `[72914442a3689add83a09a767963f57c:/page/index.mu] This is a `[labeled link`72914442a3689add83a09a767963f57c:/page/index.mu] to the same page, but it's hard to see if you don't know it Here is `F00f`_`[a more visible link`72914442a3689add83a09a767963f57c:/page/index.mu]`_`f `` When links like these are displayed in the built-in browser, clicking on them or activating them using the keyboard will cause the browser to load the specified URL. >Fields & Requests Nomad Network let's you use simple input fields for submitting data to node-side applications. Submitted data, along with other session variables will be available to the node-side script / program as environment variables. >>Request Links Links can contain request variables and a list of fields to submit to the node-side application. You can include all fields on the page, only specific ones, and any number of request variables. To simply submit all fields on a page to a specified node-side page, create a link like this: `Faaa `= `[Submit Fields`:/page/fields.mu`*] `= `` Note the `!*`! following the extra `!\\``! at the end of the path. This `!*`! denotes `*all fields`*. You can also specify a list of fields to include: `Faaa `= `[Submit Fields`:/page/fields.mu`username|auth_token] `= `` If you want to include pre-set variables, you can do it like this: `Faaa `= `[Query the System`:/page/fields.mu`username|auth_token|action=view|amount=64] `= `` >> Fields Here's an example of creating a field. We'll create a field named `!user_input`! and fill it with the text `!Pre-defined data`!. Note that we are using background color tags to make the field more visible to the user: `Faaa `= A simple input field: `B444`<user_input`Pre-defined data>`b `= `` You must always set a field `*name`*, but you can of course omit the pre-defined value of the field: `Faaa `= An empty input field: `B444`<demo_empty`>`b `= `` You can set the size of the field like this: `Faaa `= A sized input field: `B444`<16|with_size`>`b `= `` It is possible to mask fields, for example for use with passwords and similar: `Faaa `= A masked input field: `B444`<!|masked_demo`hidden text>`b `= `` And you can of course control all parameters at the same time: `Faaa `= Full control: `B444`<!32|all_options`hidden text>`b `= `` Collecting the above markup produces the following output: `Faaa`B333 A simple input field: `B444`<user_input`Pre-defined data>`B333 An empty input field: `B444`<demo_empty`>`B333 A sized input field: `B444`<16|with_size`>`B333 A masked input field: `B444`<!|masked_demo`hidden text>`B333 Full control: `B444`<!32|all_options`hidden text>`B333 `b >>> Checkboxes In addition to text fields, Checkboxes are another way of submitting data. They allow the user to make a single selection or select multiple options. `Faaa `= `<?|field_name|value`>`b Label Text` `= When the checkbox is checked, it's field will be set to the provided value. If there are multiple checkboxes that share the same field name, the checked values will be concatenated when they are sent to the node by a comma. `` `B444`<?|sign_up|1`>`b Sign me up` You can also pre-check both checkboxes and radio groups by appending a |* after the field value. `B444`<?|checkbox|1|*`>`b Pre-checked checkbox` >>> Radio groups Radio groups are another input that lets the user chose from a set of options. Unlike checkboxes, radio buttons with the same field name are mutually exclusive. Example: `= `B900`<^|color|Red`>`b Red `B090`<^|color|Green`>`b Green `B009`<^|color|Blue`>`b Blue `= will render: `B900`<^|color|Red`>`b Red `B090`<^|color|Green`>`b Green `B009`<^|color|Blue`>`b Blue In this example, when the data is submitted, `B444` field_color`b will be set to whichever value from the list was selected. `` >Comments You can insert comments that will not be displayed in the output by starting a line with the # character. Here's an example: `Faaa `= # This line will not be displayed This line will `= `` The above markup produces the following output: `Faaa`B333 # This line will not be displayed This line will `` >Literals To display literal content, for example source-code, or blocks of text that should not be interpreted by micron, you can use literal blocks, specified by the \\`= tag. Below is the source code of this entire document, presented as a literal block. - `=

-∿ < `c`!Привет!`! Это вывод из `*micron`* Micron генерирует форматированный текст для вашего терминала `a -∿ < Nomad Network поддерживает простой и функциональный язык разметки под названием `*micron`*. Если вы знакомы с `*markdown`* или `*HTML`*, вы почувствуете себя как дома при написании страниц с micron. С micron вы можете легко создавать структурированные документы и страницы с форматированием, цветами, глифами и иконками, идеально подходящие для отображения в терминалах. >>Рекомендации и Требования Хотя micron может выводить форматированный текст даже в самый базовый терминал, есть несколько возможностей, которые ваш терминал `*должен`* поддерживать для правильного отображения вывода micron, и некоторые, которые, хотя и не строго необходимы, значительно улучшают опыт. Форматирование, такое как `_подчеркивание`_, `!жирный`! или `*курсив`*, будет отображаться, если ваш терминал поддерживает это. Если у вас возникают проблемы с правильным отображением вывода micron, попробуйте использовать `*gnome-terminal`* или `*alacritty`*, которые должны работать со всеми опциями форматирования из коробки. Большинство других терминалов также будут работать нормально, но вам может потребоваться изменить некоторые настройки, чтобы определенное форматирование отображалось правильно. >>>Кодировка Все исходники micron интерпретируются как UTF-8, и micron предполагает, что может выводить символы UTF-8 в терминал. Если ваш терминал не поддерживает UTF-8, вывод будет некорректным. >>>Цвета Затенение и окрашивание текста и фонов является неотъемлемой частью вывода micron, и хотя micron будет пытаться плавно деградировать вывод даже до 1-битных терминалов, вы получите лучший вывод с терминалами, поддерживающими как минимум 256 цветов. Рекомендуется поддержка True-color. >>>Шрифт Терминала Хотя любой шрифт с поддержкой unicode может использоваться с micron, настоятельно рекомендуется использовать `*"Nerd Font"`* (см. https://www.nerdfonts.com/), который добавит много дополнительных глифов и иконок в ваш вывод. > Несколько Демонстрационных Выводов `F222`Bddd `cС micron вы можете управлять макетом и представлением `a `` `B33f Вы можете изменять фон ... `` `B393 `r`F320... и цвета переднего плана`f `a `b Если вы хотите сделать разрыв, можно вставить горизонтальные разделители. Они могут быть простыми, как тот, что ниже этого текста, или вы можете стилизовать их символами unicode и глифами, как волнистый разделитель в начале этого документа. - `cТекст может быть `_подчеркнутым`_, `!жирным`! или `*курсивом`*. Вы также можете `_`*`!`B5d5`F222комбинировать`f`b`_ `_`Ff00f`Ff80o`Ffd0r`F9f0m`F0f2a`F0fdt`F07ft`F43fi`F70fn`Fe0fg`` для некоторых потрясающих эффектов. `a >>>Секции и Заголовки Вы можете определить произвольное количество секций и подсекций, каждая со своими именованными заголовками. Текст внутри секций будет автоматически с отступом. - Если вы поместите разделитель внутри секции, он будет соответствовать отступам секции. >>>>> Если текст заголовка не определен, секция появится как подсекция без заголовка. Это может быть полезно для создания блоков текста с отступом, как этот. >Теги Micron Теги используются для форматирования текста с micron. Некоторые теги могут появляться где угодно в тексте, а некоторые должны появляться в начале строки. Если вам нужно написать текст, содержащий последовательность, которая будет интерпретирована как тег, вы можете экранировать его символом \\. В следующих разделах будут представлены различные теги. Любое стилевое оформление, установленное в micron, может быть сброшено к стилю по умолчанию с помощью специального тега \\`\\` в любом месте разметки, который немедленно удалит любое форматирование, указанное ранее. >>Выравнивание Для управления выравниванием текста используйте тег \\`c для центрирования текста, \\`l для выравнивания по левому краю, \\`r для выравнивания по правому краю и \\`a для возврата к выравниванию по умолчанию документа. Теги выравнивания должны появляться в начале строки. Вот пример: `Faaa `= `cЭта строка будет центрирована. И эта тоже. `aВыравнивание теперь возвращено к умолчанию. `rЭто будет выровнено по правому краю `` `= `` Вышеуказанная разметка производит следующий вывод: `Faaa`B333 `cЭта строка будет центрирована. И эта тоже. `aВыравнивание теперь возвращено к умолчанию. `rЭто будет выровнено по правому краю `` >>Форматирование Текст может быть отформатирован как `!жирный`! с помощью тега \\`!, `_подчеркивание`_ с помощью тега \\`_ и `*курсив`* с помощью тега \\`*. Вот пример форматирования текста: `Faaa `= Мы скоро увидим `!жирные`! абзацы текста, украшенные `_подчеркиваниями`_ и `*курсивом`*. Некоторые даже осмеливаются `!`*`_комбинировать`` их! `= `` Вышеуказанная разметка производит следующий вывод: `Faaa`B333 Мы скоро увидим `!жирные`! абзацы текста, украшенные `_подчеркиваниями`_ и `*курсивом`*. Некоторые даже осмеливаются `!`*`_комбинировать`!`*`_ их! `` >>Секции Для создания секций и подсекций используйте тег >. Этот тег должен быть помещен в начале строки. Чтобы указать подсекцию любого уровня, используйте любое количество тегов >. Если текст помещен после тега >, он будет использован как заголовок. Вот пример секций: `Faaa `= >Высокоуровневые Вещи Это секция. Она содержит этот текст. >>Другой Уровень Это подсекция. >>>Углубляясь Под-подсекция. Мы могли бы продолжить, но вы поняли суть. >>>> Подождите! Стоит отметить, что мы также можем создавать секции без заголовков. Они выглядят так. `= `` Вышеуказанная разметка производит следующий вывод: `Faaa`B333 >Высокоуровневые Вещи Это секция. Она содержит этот текст. >>Другой Уровень Это подсекция. >>>Углубляясь Под-подсекция. Мы могли бы продолжить, но вы поняли суть. >>>> Подождите! Стоит отметить, что мы также можем создавать секции без заголовков. Они выглядят так. `` >Цвета Цвета переднего плана могут быть указаны с помощью тега \\`F, за которым следуют три шестнадцатеричных символа. Чтобы вернуться к цвету переднего плана по умолчанию, используйте тег \\`f. Цвет фона указывается таким же образом, но с использованием тегов \\`B и \\`b. Вот несколько примеров: `Faaa `= Вы можете использовать `B5d5`F222 цвет `f`b `Ff00f`Ff80o`Ffd0r`F9f0m`F0f2a`F0fdt`F07ft`F43fi`F70fn`Fe0fg`f для некоторых потрясающих эффектов. `= `` Вышеуказанная разметка производит следующий вывод: `Faaa`B333 Вы можете использовать `B5d5`F222 цвет `f`B333 `Ff00f`Ff80o`Ffd0r`F9f0m`F0f2a`F0fdt`F07ft`F43fi`F70fn`Fe0fg`f для некоторых потрясающих эффектов. `` >Ссылки Ссылки на страницы, файлы или другие ресурсы могут быть созданы с помощью тега \\`[, который всегда должен завершаться закрывающей ]. Вы можете создавать ссылки с метками и без них, вам решать, как форматировать ссылки с помощью других тегов. Хотя это не строго необходимо, хорошей практикой является хотя бы форматирование ссылок с подчеркиванием. Вот несколько примеров: `Faaa `= Вот ссылка без метки: `[72914442a3689add83a09a767963f57c:/page/index.mu] Это `[помеченная ссылка`72914442a3689add83a09a767963f57c:/page/index.mu] на ту же страницу, но ее трудно увидеть, если вы не знаете об этом Вот `F00a`_`[более видимая ссылка`72914442a3689add83a09a767963f57c:/page/index.mu]`_`f `= `` Вышеуказанная разметка производит следующий вывод: `Faaa`B333 Вот ссылка без метки: `[72914442a3689add83a09a767963f57c:/page/index.mu] Это `[помеченная ссылка`72914442a3689add83a09a767963f57c:/page/index.mu] на ту же страницу, но ее трудно увидеть, если вы не знаете об этом Вот `F00f`_`[более видимая ссылка`72914442a3689add83a09a767963f57c:/page/index.mu]`_`f `` Когда такие ссылки отображаются во встроенном браузере, нажатие на них или активация с помощью клавиатуры приведет к загрузке указанного URL браузером. >Поля и Запросы Nomad Network позволяет использовать простые поля ввода для отправки данных в приложения на стороне узла. Отправленные данные, наряду с другими переменными сессии, будут доступны скрипту/программе на стороне узла как переменные окружения. >>Ссылки Запросов Ссылки могут содержать переменные запроса и список полей для отправки в приложение на стороне узла. Вы можете включить все поля на странице, только определенные, и любое количество переменных запроса. Чтобы просто отправить все поля на странице на указанную страницу на стороне узла, создайте ссылку следующим образом: `Faaa `= `[Отправить Поля`:/page/fields.mu`*] `= `` Обратите внимание на `!*`! после дополнительного `!\\``! в конце пути. Этот `!*`! обозначает `*все поля`*. Вы также можете указать список полей для включения: `Faaa `= `[Отправить Поля`:/page/fields.mu`username|auth_token] `= `` Если вы хотите включить предустановленные переменные, вы можете сделать это так: `Faaa `= `[Запросить Систему`:/page/fields.mu`username|auth_token|action=view|amount=64] `= `` >> Поля Вот пример создания поля. Мы создадим поле с именем `!user_input`! и заполним его текстом `!Предопределенные данные`!. Обратите внимание, что мы используем теги цвета фона, чтобы сделать поле более видимым для пользователя: `Faaa `= Простое поле ввода: `B444`<user_input`Предопределенные данные>`b `= `` Вы всегда должны устанавливать `*имя`* поля, но вы, конечно, можете опустить предопределенное значение поля: `Faaa `= Пустое поле ввода: `B444`<demo_empty`>`b `= `` Вы можете установить размер поля следующим образом: `Faaa `= Поле ввода с размером: `B444`<16|with_size`>`b `= `` Возможно маскировать поля, например, для использования с паролями и подобным: `Faaa `= Маскированное поле ввода: `B444`<!|masked_demo`скрытый текст>`b `= `` И вы, конечно, можете управлять всеми параметрами одновременно: `Faaa `= Полный контроль: `B444`<!32|all_options`скрытый текст>`b `= `` Собрав вышеуказанную разметку, получаем следующий вывод: `Faaa`B333 Простое поле ввода: `B444`<user_input`Предопределенные данные>`B333 Пустое поле ввода: `B444`<demo_empty`>`B333 Поле ввода с размером: `B444`<16|with_size`>`B333 Маскированное поле ввода: `B444`<!|masked_demo`скрытый текст>`B333 Полный контроль: `B444`<!32|all_options`скрытый текст>`B333 `b >>> Флажки В дополнение к текстовым полям, Флажки — это еще один способ отправки данных. Они позволяют пользователю сделать один выбор или выбрать несколько опций. `Faaa `= `<?|field_name|value`>`b Текст Метки` `= Когда флажок установлен, его поле будет установлено в предоставленное значение. Если есть несколько флажков, которые используют одно и то же имя поля, установленные значения будут объединены при отправке на узел через запятую. `` `B444`<?|sign_up|1`>`b Записать меня` Вы также можете предустановить как флажки, так и группы переключателей, добавив |* после значения поля. `B444`<?|checkbox|1|*`>`b Предустановленный флажок` >>> Группы Переключателей Группы переключателей — это еще один ввод, который позволяет пользователю выбрать из набора опций. В отличие от флажков, переключатели с одним и тем же именем поля являются взаимоисключающими. Пример: `= `B900`<^|color|Красный`>`b Красный `B090`<^|color|Зеленый`>`b Зеленый `B009`<^|color|Синий`>`b Синий `= будет отображаться: `B900`<^|color|Красный`>`b Красный `B090`<^|color|Зеленый`>`b Зеленый `B009`<^|color|Синий`>`b Синий В этом примере, когда данные отправляются, `B444` field_color`b будет установлено в любое значение из списка, которое было выбрано. `` >Комментарии Вы можете вставлять комментарии, которые не будут отображаться в выводе, начав строку с символа #. Вот пример: `Faaa `= # Эта строка не будет отображаться Эта строка будет `= `` Вышеуказанная разметка производит следующий вывод: `Faaa`B333 # Эта строка не будет отображаться Эта строка будет `` >Литералы Для отображения буквального контента, например исходного кода или блоков текста, которые не должны интерпретироваться micron, вы можете использовать буквальные блоки, указанные тегом \\`=. Ниже представлен исходный код всего этого документа, представленный как буквальный блок. - `=