DokuWiki

It's better when it's simple

Користувальницькі налаштування

Налаштування сайту


uk:plugin:include

Плагін Включення

Compatible with DokuWiki

2009-02-14, 2008-05-05

plugin Включає до складу поточної сторінки іншу вікі-сторінку. (попередні автори: Esther Brunner)

The missing download url means that this extension cannot be installed via the Extension Manager. Please see Publishing a Plugin on dokuwiki.org. Recommended are public repository hosts like GitHub, GitLab or Bitbucket.

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

This extension is not in the 'plugin' or 'template' namespace and is therefore ignored.

Similar to composer, displaywikipage, docincluder, dwinsect, dwspecialist, dyncontent, embed, includeuserpage, pagebox, tabinclude, templater, tplinc, wst

Tagged with embed, include

Needed for blog, crosspost, editor, multinamespace, randominc, tiledblog

:!: Не оновлюйте до останньої версії (2009-03-26), якщо ви використовуєте плагін blog, тому що він поки що не працює! Автор оновить плагін blog в ці вихідні! Якщо ви випадково вже оновили версію, її можна понизити за допомогою плагіна plugin-include-old.tgz. :!:

Скачати

Скачати plugin-include.tgz

Опис

Це дуже простий, але зручний плагін, за допомогою якого можна включити іншу вікі-сторінку до поточної.

Синтаксис

Просто вкладіть ідентифікатор сторінки, яка повинна бути включена, у подвійні фігурні дужки:

{{page>[id]#[section]&[flags]}}
{{section>[id]#[section]&[flags]}}
[id] ідентифікатор сторінки, що треба включити; припустимі деякі макроси; ярлики розкладені (:, ., ..) обов'язковий
[section] обмежує включену сторінку для конкретного розділу і його підрозділів необов'язковий; за замовчуванням це вся сторінка
[flags] прапорці розділяються символом &, дивись прапорці необов'язковий

Плагін пропонує два синтаксиси: {{page>...}} та {{section>...}}.

  • page не намагається об'єднати відступ, що дозволяє включенню використовуватися в інших режимах синтаксису блоків - наприклад, folded або boxes. Не використовуйте декілька примірників {{page>...}} в тому ж розділі, бо це викличе проблеми відступу.
  • section зробить спробу вирівняти включену інформацію з поточним рівнем відступу, що дозволяє розділам бути включеними безшовно. Це повинно використовуватися тільки в простій розмітці DokuWiki, бо це призведе до непрацездатного XHTML, якщо використовувати в рамках інших блоків.

Section більш спрямований на включення розділів і сторінок, включаючи цілі сторінки, однак вони можуть бути використані для включення цілих сторінки або окремих розділів. Ключова різниця полягає в тому, як вони будуть взаємодіяти з режимами синтаксису розділів і блоків на місці перебування вікі-сторінки.

Конфігурація

Плагін може бути налаштований в менеджері конфігурації DokuWiki, що доступний в меню адміністратора. Ці параметри також впливають на плагін blog, який використовує плагін include для створення блогу.

noheader Не показувати заголовок вставленого розділу
firstseconly Показати тільки перший розділ включеної сторінки
showtaglogos Показати/сховати зображення для першого тега (якщо сторінка тегів)
showfooter Показати/сховати колонтитул знизу включеної сторінки
showlink Показати/сховати постійне посилання на включену сторінку в колонтитулі сторінки
showdate Показати/сховати дату створення сторінки в колонтитулі сторінки
showuser Показати/сховати ім'я користувача, що створив сторінку в колонтитулі сторінки
showcomments Показати/сховати кількість коментарів в колонтитулі сторінки (потребує плагін discussion)
showlinkbacks Показати / сховати число зворотних посилань в колонтитулі сторінки (потребує плагін linkback)
showtags Показати/сховати теги в колонтитулі сторінки (потребує плагін tag)
showeditbtn Показати/сховати кнопку редагування знизу включеної сторінку
usernamespace Простір імен для користувача сторінки (дивись конфігурацію showuser) (user за замовчуванням)

Макрос

Прості макроси припустимі для подання сторінки по користувачу або по даті. До них відносяться:

@USER@ ім'я користувача
@NAME@ повне ім'я користувача
@GROUP@ first group the user belongs to
@YEAR@ рік - 4 цифри
@MONTH@ місяць - 2 цифри
@DAY@ день - 2 цифри

Приклади:

{{page>@MONTH@:@DAY@:birthdays}}
{{page>@USER@:message}}

Прапорці

Ви можете використовувати прапорці, щоб змінити настроювання за замовчуванням параметрів firstseconly і showfooter:

Параметр За замовчуванням Альтернативний
firstseconly fullpage включає в себе всю сторінку firstseconly включає тільки перший розділ сторінки вікі
showfooter footer показує колонтитул знизу сторінки з інформацією про включену сторінку nofooter колонтитул з інформацією про сторінку
showeditbtn editbtn показує кнопку для редагування (або створення) включеної сторінки noeditbtn ховає кнопку зміни (або створення)
- - - noheader прибирає заголовок з включеної сторінки

Приклад:

{{page>concept&firstseconly&footer}}

Демо

:!: Демо поки не є останньою версією, бо існують проблеми сумісності з плагіном блогу. :!:

Ви можете спробувати цей плагін тут.

Помилки

Прохання повідомити про помилки до Відстежувача помилок.

Додаткові ресурси

Зміни

Переклади

Англійський (оригінал від 2009-03-26)

lib/plugins/include/lang/en/lang.php

<?php
/**
 * English language file
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Esther Brunner <wikidesign@gmail.com>
 */

// custom language strings for the plugin
$lang['readmore']   = '→ Read more...';

//Setup VIM: ex: et ts=2 enc=utf-8 :

lib/plugins/include/lang/en/settings.php

<?php
/**
 * English language file
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Esther Brunner <wikidesign@gmail.com>
 */
 
// for the configuration manager
$lang['firstseconly']  = 'show only the first section of included pages';
$lang['showtaglogos']  = 'show image for first tag';
$lang['showfooter']    = 'show info about included page below';
$lang['showlink']      = 'show permalinks below included page';
$lang['showdate']      = 'show dates below included page';
$lang['showuser']      = 'show usernames below included page';
$lang['showcomments']  = 'show comments below included page (Discussion plugin needed)';
$lang['showlinkbacks'] = 'show linkbacks below included page (Linkback Plugin needed)';
$lang['showtags']      = 'show tags below included page (Tag Plugin needed)';
$lang['showeditbtn']   = 'show edit button';
$lang['doredirect']    = 'redirect to the original page after editing the included page';
$lang['usernamespace'] = 'namespace for user pages';

//Setup VIM: ex: et ts=2 enc=utf-8 :

Український

lib/plugins/include/lang/uk/lang.php

<?php
/**
 * Ukrainian language file
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     DocuWiki's Community (http://www.dokuwiki.org/)
 */

// рядки мови користувача для плагіну
$lang['readmore']   = '→ Читати далі...';

lib/plugins/include/lang/uk/settings.php

<?php
/**
 * Ukrainian language file
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     DocuWiki's Community (http://www.dokuwiki.org/)
 */
 
// для менеджера конфігурації 
$lang['firstseconly']  = 'показувати тільки першу секцію включених сторінок'; 
$lang['showtaglogos']  = 'показувати зображення для першого тегу'; 
$lang['showfooter']    = 'показувати інформацію про включену сторінку нижче'; 
$lang['showlink']      = 'показувати постійні посилання нижче включеної сторінки'; 
$lang['showdate']      = 'показувати дати нижче включеної сторінки'; 
$lang['showuser']      = 'показувати імена користувачів нижче включеної сторінки'; 
$lang['showcomments']  = 'показувати коментарі нижче включеної сторінки (потрібен плагін Discussion)'; 
$lang['showlinkbacks'] = 'показувати зворотні посилання нижче включеної сторінки (потрібен плагін Linkback)'; 
$lang['showtags']      = 'показувати теги нижче включеної сторінки (потрібен плагін Tag)'; 
$lang['showeditbtn']   = 'показувати кнопку редагування'; 
$lang['doredirect']    = 'перенаправляти на вихідну сторінку після редагування включеної сторінки'; 
$lang['usernamespace'] = 'простір імен для сторінок користувача';

Російський

lib/plugins/include/lang/ru/lang.php

<?php
/**
 * Russian language file
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     DocuWiki's Community (http://www.dokuwiki.org/)
 */

// строки языка пользователя для плагина
$lang['readmore']   = '→ Читать дальше...';

lib/plugins/include/lang/ru/settings.php

<?php
/**
 * Russian language file
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     DocuWiki's Community (http://www.dokuwiki.org/)
 */
 
// для менеджера конфигурации
$lang['firstseconly']  = 'показывать только первую секцию включенных страниц';
$lang['showtaglogos']  = 'показывать изображение для первого тега';
$lang['showfooter']    = 'показывать информацию о включенной странице ниже';
$lang['showlink']      = 'показывать постоянные ссылки ниже включенной страницы';
$lang['showdate']      = 'показывать даты ниже включенной страницы';
$lang['showuser']      = 'показывать имена пользователей ниже включенной страницы';
$lang['showcomments']  = 'показывать комментарии ниже включенной страницы (необходим плагин Discussion)';
$lang['showlinkbacks'] = 'показывать обратные ссылки ниже включенной страницы (необходим плагин Linkback)';
$lang['showtags']      = 'показывать теги ниже включенной страницы (необходим плагин Tag)';
$lang['showeditbtn']   = 'показывать кнопку редактирования';
$lang['doredirect']    = 'перенаправлять на исходную страницу после редактирования включенной страницы';
$lang['usernamespace'] = 'пространство имен для страниц пользователя';

Обговорення

uk/plugin/include.txt · Востаннє змінено: 2009-04-30 20:49 повз 95.132.220.173

Якщо не вказано інше, вміст цієї Вікі підпадає під дію такої ліцензії: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki