ExtractInfo
Обёртка вокруг [[Include(SomePageName, , from="^==[ ]*" + header + "[ ]*==$", to="^----$")]]. Сответственно, включает в страницу, где есть макрос, куски страницы SourcePageName, ограниченные заголовками второго уровня с указанными названиями и горизонтальной чертой. Данный макрос используют макросы LicenseInfo и FormatInfo (с изменённым значением по умолчанию параметра Source).
Использование
[[ExtractInfo(Header1)]]
Вставит текст между "== Header1 ==" и ---- из страницы по умолчанию (.)
[[ExtractInfo(Header1,Header2)]]
Вставит текст между "== Header1 ==" и ----, а также между "== Header2 ==" и ---- из страницы по умолчанию (.)
[[ExtractInfo(Header1,Header2,Source=PageName)]]
Вставит текст между "== Header1 ==" и ----, а также между "== Header2 ==" и ---- из указанной страницы (PageName)
Пример
[[ExtractInfo(PDF,ODT,Source=PspoMaterials/FormatInfo)]] |
Файлы PDF можно просмотреть при помощи программы evince (gnome), kpdf (KDE), zathura или xpdf. Файлы в формате ODT можно просмотреть при помощи OpenOffice.org Writer, AbiWord или KOffice (KDE). |
[[ExtractInfo(GFDL,Source=PspoMaterials/LicenseInfo)]] |
|
TODO
- Переписать ограничители как параметры со значениями по умолчанию
FormatInfo
Макрос для вставки информации о формате.
Использование
[[FormatInfo(Format1,Format2,...)]]
Добавит информацию о форматах Format1, Format2 и так далее из страницы по умолчанию (../FormatInfo)
[[FormatInfo(Format1,Format2,...,Source=PspoMaterials/LicenseInfo)]]
Добавит информацию о лицензиях Format1, Format2 и так далее из указанной страницы (PspoMaterials/FormatInfo)
Пример:
[[FormatInfo(PDF,ODT,Source=PspoMaterials/FormatInfo)]] |
Файлы PDF можно просмотреть при помощи программы evince (gnome), kpdf (KDE), zathura или xpdf. Файлы в формате ODT можно просмотреть при помощи OpenOffice.org Writer, AbiWord или KOffice (KDE). |
LicenseInfo
Макрос для вставки информации о лицензии.
Использование
[[LicenseInfo(License1,License2,...)]]
Добавит информацию о лицензиях License1, License2 и так далее из страницы по умолчанию (../LicenseInfo)
[[LicenseInfo(License1,License2,...,Source=PspoMaterials/LicenseInfo)]]
Добавит информацию о лицензиях License1, License2 и так далее из указанной страницы (PspoMaterials/LicenseInfo)
Пример:
[[LicenseInfo(GFDL,CC-BY-SA,Source=PspoMaterials/LicenseInfo)]] |
|
CreateMaterialPassport
Вставляет форму для генерации нового паспорта материала.
Использование
[[CreateMaterialPassport()]]
- Вставляет форму, у которой не заполнены поля без значений по умолчанию
[[CreateMaterialPassport(),Option1=Value1,Option2=Value2,...]]
- Вставляет форму, у которой изменены параметры по умолчанию.
Параметры
Параметр |
Тип |
Значение по умолчанию |
Описание |
Name |
Имя страницы |
отсутствует |
Имя новой страницы паспорта материала |
Title |
строка |
отсутствует |
Название материала |
OriginalTitle |
строка |
отсутствует |
Оригинальное название материала |
Base |
Имя страницы |
Базовая страница для паспорта |
|
Author |
строка |
отсутствует |
Автор материала |
License |
строка |
отсутствует |
Лицензия материала |
LicenseBase |
Имя страницы |
Страница с информацией о лицензиях |
|
Format |
строка |
отсутствует |
Формат материала |
FormatBase |
Имя страницы |
Страница с информацией о форматах |
|
URL |
строка |
отсутствует |
Ссылка на источник |
Template |
Имя страницы |
Шаблон для создания паспорта материала |
|
NameLabel |
строка |
"Имя страинцы" |
Надпись для поля с именем новой страницы |
TitleLabel |
строка |
"Название" |
Надпись для поля с названием материала |
OriginalTitleLabel |
строка |
"Оригинальное название" |
Надпись для поля с оригинальным названием материала |
BaseLabel |
строка |
"Базовая страница" |
Надпись для поля с базовой страницей для паспорта |
AuthorLabel |
строка |
"Автор" |
Надпись для поля с автором материала |
LicenseLabel |
строка |
"Лицензия" |
Надпись для поля с лицензией материала |
LicenseBaseLabel |
строка |
"Страница описания лицензий" |
Надпись для поля со страницей с информацией о лицензиях |
FormatLabel |
строка |
"Формат" |
Надпись для поля с форматом материала |
FormatBaseLabel |
строка |
"Страница описания форматов" |
Надпись для поля со страницей с информацией о форматах |
URLLabel |
строка |
"Источник" |
Надпись для поля со ссылкой на источник |
TemplateLabel |
строка |
"Шаблон" |
Надпись для поля с шаблоном для создания паспорта материала |
SubmitLabel |
строка |
"Создать паспорт материала" |
Надпись на кнопке отсылки формы |
ShowSetFields |
флаг |
отсутствует |
Если данный параметр задан, то отображаются все поля, у которых заданы значения |
EditSetFields |
флаг |
отсутствует |
Если задан данный параметр и ShowSetFields, то поля, у которых заданы значения, доступны для редактирования |
По умолчанию, отображаются только те поля, у которых отсутствуют значения по умолчанию.
Для задания в параметрах нескольких форматов или лицензиях используйте ";" вместо ",".
Поведение
При нажатии на кнопку сздания материала вызывается action CreateMaterialPassport с указанными в фрме параметрами. Список передаваемых параметров: Name, Title, OriginalTitle, Base, Author, License, LicenseBase, Format, FormatBase, URL, Template.
Примеры
[[CreateMaterialPassport()]] |
|
[[CreateMaterialPassport(Author=RMS, License=GFDL;CC-BY-SA, SubmitLabel=Создать документ за авторством Столлмана)]] |
|
[[CreateMaterialPassport(Author=RMS, License=GFDL;CC-BY-SA, SubmitLabel=Создать документ за авторством Столлмана, ShowSetFields=true)]] |
|
[[CreateMaterialPassport(Author=RMS, License=GFDL;CC-BY-SA, SubmitLabel=Создать документ за авторством Столлмана, ShowSetFields=true, EditSetFields=true)]] |
MaterialFiles
Макрос для управления файлами материала. Использует действие ../../Actions/MaterialFiles для управления файлов.
Параметры
Параметром без значения является имя (Name) материала, для которого генерируется макрос. Если оно не указано, то макрос генерируется для текущей страницы.
Параметр |
Тип |
Значение по умолчанию |
Описание |
base |
Имя страницы |
Базовая страница для страницы паспорта материала |
Использование
Макрос генерирует дерево файлов материала с кнопками для выполнение действий, на которые имеются права.
PassportLink
Макрос генерирует ссылку на паспорт материала.
Параметры
Параметр |
Тип |
Значение по умолчанию |
Описание |
Base |
Имя страницы |
Базовая страница для страницы паспорта материала |
|
FilePath |
http-адрес |
/static |
Базовый путь к файлам материалов |
Format |
Строка |
"auto" |
Класс материала. Возможные значения: auto, MpguLecture, CmcLecture, Lecture, Presentation, AltDoc, Illustration, WikipediaArticle, RFC, LinuxBook, Book, HowTo, Kde, SchoolServer, Generic. При использовании значения auto включается мозг, который (на данный момент, последовательным применением захардкоденных регэкспов к имени страницы) определяет, какой формат использовать. Не путать с форматом материала. Если параметр Icon пустой, то ссылка на иконку генерируется как <IconPrefix><Format><IconSuffix> |
Icon |
http-адрес |
"" |
Путь к иконке, используемой в ссылке. В случае, если путь пустой, используются параметры IconPrefix и IconSuffix |
IconPrefix |
http-адрес |
/static/__icons/material_ |
Префикс пути к иконке, используемой в ссылке. Используется при пустом значении параметра Icon |
IconSuffix |
http-адрес |
".png" |
Суффикс пути к иконке, используемой в ссылке. Используется при пустом значении параметра Icon |
Text |
Строка |
title |
Что используется в качестве текста ссылки. Возможные варианты: name, title, origtitle |
Direct |
Флаг |
False |
Если равен True, генерируется ссылка непосредственно файлы материала, иначе на страницу паспорта |
DirectBrain |
Флаг |
True |
Только если включена опция Direct: если равен True, делается попытка найти индексную страницу (или единственный файл в директории), иначе генерируется ссылка на директорию. |
DirectPath |
Строка |
None |
Только если включена опция Direct: пусть до конкретного файла в материале. |
DirectPathDesc |
Строка |
none |
Только если включена опция Direct: комментарий для конкретного файла в материале. |
Примеры использования
Код |
Результат |
Описание |
<<PassportLink(RFC_1855)>> |
Генерируется ссылка на паспорт материала RFC_1855. |
|
<<PassportLink(RFC_1855,Text=name)>> |
Генерируется ссылка на паспорт материала RFC_1855, в качестве текста используется имя материала. |
|
<<PassportLink(AltDocs_backup,Direct=True)>> |
Генерируется ссылка на файлы материала AltDocs_backup. В данном случае должна сгенерироваться ссылка на индексный файл, так как он наличествует в директории. |
|
<<PassportLink(AltDocs_backup,Direct=True,DirectBrain=False)>> |
Генерируется ссылка на файлы материала AltDocs_backup. В данном случае должна сгенерироваться ссылка на директорию, так как принудительно отлючена опция DirectBrain. |
|
<<PassportLink(RFC_1855,Direct=True)>> |
Генерируется ссылка на файлы материала RFC_1855. Не смотря на опцию DirectBrain, включенную по умолчанию, ссылка генерируется на директорию, так как индексный файл не найден. |
|
<<PassportLink(RFC_1855,Format=Lecture)>> |
Генерируется ссылка на паспорт материала RFC_1855, формат задан принудительно. |
|
<<PassportLink(AltDocs_linuxnovice,Direct=True,DirectPath=ch02s11.html)>> |
Генерируется ссылка на файл ch02s11.html материала AltDocs_linuxnovice. |
|
<<PassportLink(AltDocs_linuxnovice,Direct=True,DirectPath=ch02s11.html,DirectPathDesc=Emacs для начинающих)>> |
|
Генерируется ссылка на файл ch02s11.html материала AltDocs_linuxnovice с описанием «Emacs для начинающих». |
RFC 1855: Netiquette Guidelines
Резервное копирование информации
RFC 1855: Netiquette Guidelines