Help Desk Вспомогательные табы режима редактирования
(:e_preview:)
PmWiki
- PmWiki в мире
- Особенности и возможности
- Примеры сайтов
- Кратко об архитектуре
- Области применения
- Порог входа
- Техническое:
- Варианты интеграции
- PmWiki vs Wikipedia vs CMSs
Rext
Документация
- Установка
- Первые шаги
- Обновление
- Установка как wiki-фермы
- Сценарии развития
- Конфиг
- Файловая структура
- EditMode
- Гид: работа с контентом
- Гид: дизайн и верстка
- Гид: SEO
- Гид: администрирование
- Гид: программирование
- Задать вопрос
Рецепты
- Ключевые:
- Skin: thisSite.tmpl
- AdminPanel
- Skin: editMode.tmpl
- MultyTags (структурированные теги)
- FieldProcessing (создание полей)
- AttachMan[ager]
- Вспомогательные:
- OnClickMarkupper
- Форма добавления страниц
- LessCompiler
- Visits
- Lebedizator (API Типографа Лебедева)
- Ph-Speedups-Less (?)
- RextPacker (сборщик дистрибутива)
- Работа с контентом:
- Викирама: фотогалерея
- Toggles (кнопки и аккордеоны)
- Comments (комментарии+)
- BruteFileLister (транслятор файлов)
- В разработке:
- Инкубатор идей
Статьи
- Как разрабатывать Рецепты?
- О PmWiki.ru
- Формирование разных меню с единым источником данных
- Несколько слов о формировании меню в шаблоне thisSite.tmpl
- Пара CSS-примеров оформления FAQ'ов
- Контентный программинг в PmWiki
- CSV2PmWiki PHP-конвертер для импорта из WordPress
- Как создать и использовать дочерние страницы?
- Правильное именование PV (переменных страницы)
Мы разрабатываем Rext
Внесите сюда то, что считаете наиболее важным для вашего проекта!
Параграфы: параграфы разделяются пустыми строками; -> для отступа, -< для выступа
|
Перевод строки: \\ или [[<<]] |
Списки: * — маркированый, # — нумерованый, :термин:определение — список определений
|
Объединение строк: \ |
Выделения: ''курсив'', '''жирно''', '''''жирный курсив''''', @@курьер@@ (моноширинно)
Ссылки: [[другая страница]], [[http://www.example.com]], [[другая страница | имя ссылки]], [[#якорь]]
| |
Группы: [[Group/Page]] видно Page, [[Group.Page]] видно Group.Page, [[Group(.Page)]] видно Group
|
не разбирать: [=…=] |
Разделители: !!, !!! заглавия, ---- горизонтальная линия
|
оформлено: [@…@] |
Другое: [+крупно+], [++крупнее++], [-мелко-], [--мельче--], '^верхний индекс^', '_нижний индекс_', {+вставлено+}, {-удалено-}
|
Todo:PublicRelease : возможно, стоит это переделать? Надо советоваться.
Таблицы, исходный код, FAQ
Официальная документация: PmWiki:Tables | PmWiki:TableDirectives
|| ||! Заголовок простой таблицы !|| ||!ЗагЛев ||! ЗагЦент ||! ЗагПрав|| ||cell 1 || cell 2 || cell 3|| |
|
Модифицирующие классы следует добавлять вместе с классом .table, примеры:
class="table table-bordered"
class="table table-sortable"
%hlt php%[@ function SDVA(&$var,$val) { foreach($val as $k=>$v) if (!isset($var[$k])) $var[$k]=$v; } function IsEnabled(&$var,$f=0) { return (isset($var)) ? $var : $f; } @] А вот [@$переменная@] в простом тексте. |
function SDVA(&$var,$val) { foreach($val as $k=>$v) if (!isset($var[$k])) $var[$k]=$v; } function IsEnabled(&$var,$f=0) { return (isset($var)) ? $var : $f; } А вот |
>>faq<< Q: Каков вопрос? A: Таков и ответ! >><< | Каков вопрос? Таков и ответ! |
Синтаксис для оформления исходного wiki-кода, создает его «превью»:
(:markup caption='Заголовок' class=horiz:) wiki-код (:markupend:)
Отступы, приступы, списки
Официальная документация: BulletedLists | PmWiki:ListStyles
* Звездочка создает маркированный список. \\ Вот как можно продолжить его с новой строки. # Решетка создает нумерованный список, причем # %item value=3% можно вручную задавать числа А также менять тип нумерации: # %ROMAN% [@%ROMAN%@] но только ## %ALPHA% [@%ALPHA%@] на первом ### %alpha% [@%alpha%@] элементе #### %roman% [@%roman%@] следующего уровня вложенности |
А также менять тип нумерации:
|
Хорошо структурированный текст можно делать и '''простыми отступами''': -> вот такими --> двойными ---> и т.д. Это удобно, если во вложенных уровнях много контента и, например, картинки. -< '''Хитрый приступ''' отодвигает весь текст, кроме первой строчки. Это тоже удобно для создания структурированных конструкций. \\\ Чтобы под приступом написать целую простыню, используйте [@\\\@] или [@\\@] в конце строк. | Хорошо структурированный текст можно делать и простыми отступами: вот такими
двойными
и т.д. Это удобно, если во вложенных уровнях много контента и, например, картинки.
Хитрый приступ отодвигает весь текст, кроме первой строчки. Это тоже удобно для создания структурированных конструкций.
Чтобы под приступом написать целую простыню, используйте \\\ или \\ в конце строк.
|
Intermap-ссылки
PmWiki: https://www.pmwiki.org/wiki/PmWiki/ Cookbook: https://www.pmwiki.org/wiki/Cookbook/ Wiki: http://www.c2.com/cgi/wiki? UseMod: http://www.usemod.com/cgi-bin/wiki.pl? Meatball: http://www.usemod.com/cgi-bin/mb.pl? Wikipedia: https://en.wikipedia.org/wiki/ PITS: https://www.pmwiki.org/wiki/PITS/ PmL10n: https://www.pmwiki.org/wiki/Localization/ Path:
Дефолтные от Rext:
Cooks: https://www.pmwiki.ru/Cooks/
Дополнительно из PmWiki :
(:comment Комментарий в одну строку:)
Расширения из Rext:
--
— двойной дефис создает тире...
— три точки создают «…»@mark@подсвеченный@@
— подсвеченный через <mark>…</mark>@-@текст@@
— вывести текст «как есть». Это нужно в основном для tmpl-макетов, чтобы PmWiki наверняка не окружала текст какими-либо html-тегами
Основные принципы: PmWiki:PageLists | PmWiki:ConditionalMarkup | PmWiki:IncludeOtherPages
(:if auth edit:) ... (:ifend:)
— выводить только для редакторов(:notoc:)
— отключить автоматическую генерацию содержания, класс.notoc
исключает конкретный h* из содержания(:nogroupheader:) | (:nogroupfooter:)
— не выводить общие инклюды группы
Page Text Variables (создаются в контенте страницы):
(:country:Transylvania:)
|:Name: Crisses
|Address: 1313 Mockingbird Lane
— три способа создать Page Text Variable{$:country}
— вызвать ее.
Page Variables (создаются в PHP):
{$FullName}
— обычный вызов;{SomePage$Title}
— вызов переменной с другой страницы;*$PageVariablename}
— вызов переменной из текущей страницы {=$PageVariablename}
— вызов переменной при pagelist, в контексте текущей страницы цикла.
Pagelist-шаблоны сайта :
Список предустановленных шаблонов PmWiki:
fmt=
The "fmt=
" option determines how the resulting list should be displayed.
PmWiki predefines several formats:
fmt=#bygroup
- Display pages within groups (default format)fmt=#simple
- Display a simple ordered list of pages in the form Group.Namefmt=#title
- Display a list of pages by page title. Use "order=title
" to have them sorted by title (default is to order by page name).fmt=#titlespaced
- Display a list of pages by page title, like above, but with spaces between the words in the title.fmt=#group
- Display a list of wikigroups (without listing the pages in the groups)fmt=#include
- Display the contents of each page in the list (note, this could take a very long time for long lists!)fmt=#grouphomes
- An optimized bullet list of group home pages (will work with count=…), requires PmWiki 2.2.103.fmt=#includefaq
- Include just the#faq
sections from pages in the list. (This can also be expensive, especially if the list includes pages that don't have the[[#faq]]
anchor!)fmt=#description
- List pages and append the page's description if it exists. Creates dash by all names, but adding a nested loop to get rid of it causes markup problems (nested loops are not allowed).fmt=#simplename
- Simple bullet list of page names, without the Group name.fmt=#simplenamespaced
- Simple bullet list of spaced page names, without the Group name.fmt=#titlesummary
- A simple bullet list of page title and summary, defined in page by(:Title ttttt:)
and(:Summary:sssss:)
markup.
These formats are defined by page list templates, which can be customized.
This format is not predefined by a page list template:
fmt=count
- Display the number of pages in the list (note the absence of the "#"). In a trail,fmt=count
counts existing and non-existing pages ; to limit count to existing pages, use :if="exists {=$FullName}" fmt=count
(mailing list).
Полная документация: Cooks:Skin-thisSite
Настройки макета дизайна «thisSite»:
Встроенные Рецепты:
Кнопки и аккордеоны
Подробная документация: Cooks:Toggles
Заголовок h4
Базовый способ, вызов через !!!!
Стилизованный заголовок h4
Тот же h4, но выглядит по-другому: !!!!%apply=block center-block%
Чтобы поместить в блок сложный многострочный контент окружайте его в (:div:)...(:divend:)
HTML5-тег <details>
Работает без JavaScript:
(:details summary="...":) ... (:detailsend:)
— обычный вызов;(:details summary="..." open=open:)
— вызов в изначально открытом состоянии;(:details summary="..." class=h4 :)
— вызов в визуальной стилизации под h4
Встроенный в PmWiki синтаксис >>pmtoggle<<
Чем он удобен? Специальными возможностями применения.
Простой синтаксис:
>>pmtoggle<< Первая кнопка >>a<< Первый контент. Можно не беспокоиться об обвязке многострочного контента в ''(:div:)'' >>pmtoggle<< Вторая кнопка >>alert alert-info<< Вместо «а» могут быть любые символы или реально существующие классы. >><<
Совместимость с PmWiki:PageTextVariables:
: %list pmtoggle% Var1 : Каждая кнопка аккордеона : Var2 : становится переменной : Var3 : содержащей открываемое ею значение [[<<]]
Викирама
Базовый синтаксис Mini:
:
Mini:picture.jpg
сгенерить превьюшку picture.jpgMini:pic1.jpg,pic2.jpg,pic3.jpg
сгенерить галерею из этих картинокMini:*
сгенерить галерею из всех картинок данной страницыMini:r*,S*,t*
сгенерить галерею из картинок, начинающихся на r, S или t (чувствительно к регистру).Mini:*.jpg,-pic1.jpg
все JPG'и кроме pic1.jpgMini:pic1.jpg,*
сначала показать pic1.jpg, затем все остальные, кроме него.Mini:*,pic1.jpg
сработает аналогично, точно указанные картинки всегда будут идти перед общими маскамиMini:*.jpg"Текст перед блоком с фото|Текст после блока с фото"
Пересеты Викирамы:
Attach:file.jpg
— фото без превью;Mini:*
— максимум превью в строке (12 для десктопа);Mini1:*
— галерея с одним большим фото и превьюшками;Mini2:*,Mini3:*,Mini4:*,Mini6:**
— то же, чтоMini:*
, но число фото в десктопном разрешении соответствует числу. Эти пресеты удобны для быстрой регулировки размера.Mini5:*
— без бутстрап-обертки, для большей совместимости с оригинальным Mini.Mini7:*
— без всего, полный аналог оригинальногоMini:
Более сложные случаи:
[[https://www.ph-ph.ru/|Attach:sad_girl.jpg]]
— внешняя ссылка с фото%newwin%[[Attach:apexmanagement.png|Текстовая ссылка на картинку]]
%newwin%[[Attach:apexmanagement.png|mini7:apexmanagement.png]]
— прямая ссылка через превьюMini:img.jpg"Описание к фото"
— передается в модальное окно- массовое описание:
Mini:[= image1.jpg"Одно описание" image2.jpg"Другое описание" image3.jpg =]"|Общее описание для всех не описанных фото
Контентные модификации:
Чтобы применить их, достаточно просто перед первым вызовом Mini:
создать слой с классом ph-fotorama и data-
атрибутами, который необходим для достижения желаемого изменения поведения Fotorama.
Например, вот так можно включить показ превьюшек в модальном окне:
(:div class='ph-fotorama' data-nav='thumbs' :) (:divend:) Mini:*
Мультитеги с древовидной структурой (документация):
(:multytags:off:)
: отключает на текущей странице механизм выбора "связанных страниц". Вместо него включится встроенный в PmWiki функционал, автоматически собирающий все вики-ссылки контента страницы. Внимание! Чтобы команда работала, необходимо учесть ее обработку в условиях запуска Мультитегов здесь: ConfigEditMode.
Официальная документация: CSS | Components | JavaScript
Bootstrap: inline-стили
%text-muted%
— тихий текст.%lead%
— выделяющийся крупный текст.%apply=img img-thumbnail%
— обрамить картинку рамкой.%btn btn-primary btn-lg white%[[Ссылка-кнопка]]%%
— сделать ссылку в виде кнопки.- Почему так? Классы btn* — это bootstrap-классы, а white — это команда PmWiki для создания inline-стиля с белым цветом шрифта. Она нужна затем, что классы btn* получит не сама ссылка, а окружающий ее span. Поэтому, без white цвет кнопки совпал бы с цветом ссылки.
%btn btn-default btn-xs glyphicon% [[ LINK |  ]]
— ссылка в виде glyphicon-иконки
Можно использовать Bootstrap Glyphicons прямо в контенте: %glyphicon% %% Коды удобно [[https://glyphicons.bootstrapcheatsheets.com|смотреть здесь]]. | Можно использовать Bootstrap Glyphicons прямо в контенте:
|
Bootstrap: блочная верстка
(:div99 class="panel panel-default":) (:div98 class="panel-heading":)Опциональный заголовок. (:div98 class="panel-body":)Красивая панель, здесь ее контент. (:div98 class="panel-footer":)Опциональный футер. (:div99end:) | Опциональный заголовок.
Красивая панель, здесь ее контент.
|
>>alert alert-success<<
- зеленая плашка
>>alert alert-info<<
- голубая плашка
>>alert alert-warning<<
- желтая плашка
>>alert alert-danger<<
- красная плашка
Спецсимволы HTML:
« | « |
» | » |
& | & |
– | – |
— | — |
← | ← |
↑ | ↑ |
→ | → |
↓ | ↓ |
↔ | ↔ |
AttachManager Error: current user has no permisson to handle 'Attachman' cook.