Picolisp Wiki Старт
Контент
- Авторизация и создание аккаунта
- Инициализация документа
- Гипертекстовые ссылки
- Структурная разметка
- Разметка внешнего вида
- Специальные символы
- Плавающая разметка объекта
- Некоторые примеры
Авторизация и создание аккаунта
Кликните LOG IN ссылку в левом меню, а затем нажмите кнопку Create account в предложенной форме.Инициализация документа
После входа в систему с аккаунтом кликните MY ACCOUNT для создания нового документа или откройте любую страницу с помощью меню или по ссылке для её редактирования, где для входа в режим редакции в левом верхнем углу расположена ссылка EditГипертекстовые ссылки
Добавление новой внутренней ссылки на документ, который может и не существовать:={myarticle Это мой документ}
Добавьте Summary, посмотрите Preview и если все нормально, то сохраните изменения.
При нажатии на ссылку несуществующего документа будет предложена форма для её создания с именем myarticle.
- И так синтаксис для внутренней ссылки
={Page Title}
"Title" - опционально, то есть его может и не быть. "Page" - это короткое имя страницы (документа), чтобы его можно было найти по имени в URL.
Для примера: страница "Interfacing with Other Software" локализована с адресом https://picolisp.com/53673/22551483888197633~?interfacing имееет заголовок "Picolisp Wiki: interfacing". "Page" элемент разметки будет "interfacing".
={interfacing Interfacing with Other Software}
Interfacing with Other Software - Синтаксис для ссылки на внешний ресурс
^{url Title}
"Title" тоже не обязателен. "url" это ресурс url.
Пример: документ "The Picolisp Reference" размещен по адресу https://software-lab.de/doc/ref.html.
^{https://software-lab.de/doc/ref.html The Picolisp Reference}
The Picolisp Reference
Структурная разметка
- Заголовок n{Заголовок} (n натуральное число от 1 до 6) → <hn>...</hn>
- Неупорядоченный список *{(элемент неупорядоченного списка)} → <ul>...</ul>
- Упорядоченный список +{(элемент упорядоченного списка)} → <ol>...</ol>
- Элемент списка -{элемент списка} → <li>...</li>
- Таблица %{содержание таблицы} → <table>...</table>
- Строка таблицы ~{содержание строки} → <tr>...</tr>
- Ячейка таблицы |{содержание ячейки} → <td>...</td>
- Отформатированный текст
:{ отформатированный тест}
→ <pre>
отформатированный текст</pre> - Перевод строки &{n} (n - натуральное число) → столько <br/> какое n
- Перевод строки с очищенными плавающими элементами &{-n} (n - натуральное число) → как выше, но первым будет <br class="clr"/>
Разметка внешнего вида
- Italics /{Italics} → <i>...</i>
- Bold !{Bold} → <b>...</b>
- Подчеркивание _{...} → <u>...</u>
- Код :{Код} → <span class="code">...</span>
- CSS атрибуты
${attribute: value;attribute: value;(другая css декларация...); (целевой контент)}
→ <div style="attribute: value;...">(целевой контент)</div>
Специальные символы
- Comments #{Комментарий} → Не включается в HTML
- Экранированная скобка \{ → {
Объект плавающей разметки
- Размещение слева от текста <{имя объекта} → тег зависит от типа объекта, но имеет class="left"
- Течет вместе с содержимым @{имя объекта} → тег зависит от типа объекта, но имеет class="nofloat"
- Размещение справа от объекта >{имя объекта} → тег зависит от типа объекта, но имеет class="right"
Некоторые примеры
Лучший примеры - это существующие страницы, к которым Вы имеете доступ и всегда можете посмотреть. Например, достаточно один раз посмотреть образец разметки таблицы, чтобы понять описание.- Таблица
%{Контент таблицы}
Конвертируется в тег <table> с Контентом таблицы, состоящим из строк таблицы rows - Строка таблицы
~{контент строки}
Конвертируется в тег <tr> tс контентом строки, состоящим из ячеек таблицы - Ячейка таблицы
|{контент ячейки}
Конвертируется в тег <td> с контентом ячейки, состоящим из произвольных строк
%{ ~{ |{!{Meaning}} |{!{markup}} |{!{HTML}} } ~{ |{Table frame} |{:{%{...}}} |{:{<table>...</table}} } ~{ |{Table row} |{:{~{...}}} |{:{<tr>...</tr>}} } ~{ |{Table cell} |{:{|{...}}} |{:{<td>...</td>}} } }И будет выглядеть так:
Meaning | markup | HTML |
Table frame | %{...} | <table>...</table |
Table row | ~{...} | <tr>...</tr> |
Table cell | |{...} | <td>...</td> |
${attribute: value;attribute: value;(other css declaration...); target text or markup on the next line}Можно добавлять стили к тексту или тегам. Различные стили должны быть написаны на одной строке, разделенные точкой с запятой. Анализ останавливается на горизонтальной табуляции, переводе строки или возврате каретки и на закрывающей фигурной скобке.
Разметка преобразуется в охватывающий тег <div> , который инкапсулирует целевое содержимое и содержит атрибуты стиля как встроенный стиль. Из-за этого стиль, добавленный таким образом к элементу, не может переопределить стиль, определенный в глобальной таблице стилей для этого элемента. Смотрите https://picolisp.com/wiki/wiki/wiki.css для стилей, которые применяются к любому элементу в вики Picolisp.
Пример:
${border: red solid 1px;background-color: yellow;color:green; 4{Документация PicoLisp}}содержит три объявления стилей, которые преобразуются в::
<div style="border: red solid 1px;background-color: yellow;color:green;"> <h4>Документация PicoLisp</h4></div>и отображается следующим образом:
Документация PicoLisp
Обратите внимание, что поскольку стиль применяется через инкапсуляцию содержимого внутри блока <div>, , результатом будет блок. Таким образом, невозможно частично применить стиль к строке и сохранить эту часть внутри строки:
${border: red solid 1px;background-color: yellow;color:green; Документация PicoLisp} очень хорошо написана.will be converted into:
<div style="border: red solid 1px;background-color: yellow;color:green;">Документация PicoLisp</div> очень хорошо написана.и отобразится типа этого:
Документация PicoLisp
очень хорошо написана.Здесь "Документация Picolisp" не определен как заголовок <h4>, а просто текст. Поскольку глобальная таблица стилей не определяет цвет для обычного текста, можно применить объявление color:green;. Но поскольку стиль применяется посредством создания "капсулы"<div> вокруг строки, эта часть будет отображаться на своей собственной строке.
Объекты, загруженные в вики или ссылающиеся с других страниц в нижней части окна редактирования, могут быть настроены на плавающее содержимое по бокам или нет.
Разметка преобразуется в тег объекта, который зависит от типа объекта:
- Картинка: <img src="path/to/object" alt="имя объекта" class="left"/>
- Пример видео: <video src="path/to/object" class="nofloat" preload="none" controls>имя объекта</video>
https://picolisp.com/wiki/?rudocwiki
06jan25 | Serj-Aleks |