Зміст
Плагін Включення
Compatible with DokuWiki
2009-02-14, 2008-05-05
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
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>...}}
.
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}}
Демо
Демо поки не є останньою версією, бо існують проблеми сумісності з плагіном блогу.
Ви можете спробувати цей плагін тут.
Помилки
Прохання повідомити про помилки до Відстежувача помилок.
Додаткові ресурси
Зміни
- Виникла помилка під час отримання RSS-стрічки: http://darcs.chimeric.de//darcsweb.cgi?r=include;a=atom
Переклади
Англійський (оригінал від 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'] = 'пространство имен для страниц пользователя';