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

Имя страницы

PspoMaterials

Базовая страница для паспорта

Author

строка

отсутствует

Автор материала

License

строка

отсутствует

Лицензия материала

LicenseBase

Имя страницы

../LicenseInfo

Страница с информацией о лицензиях

Format

строка

отсутствует

Формат материала

FormatBase

Имя страницы

../FormatInfo

Страница с информацией о форматах

URL

строка

отсутствует

Ссылка на источник

Template

Имя страницы

MaterialPassportTemplate

Шаблон для создания паспорта материала

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)]]

Имя страницы:
Название:
Оригинальное название:
Автор:RMS
Лицензия:GFDL,CC-BY-SA
Формат:
Источник:
Базовая страница:PspoMaterials
Страница описания лицензий:../LicenseInfo
Страница описания форматов:../FormatInfo
Шаблон:MaterialPassportTemplate
Аннотация:
Перезаписать:False
 

[[CreateMaterialPassport(Author=RMS, License=GFDL;CC-BY-SA, SubmitLabel=Создать документ за авторством Столлмана, ShowSetFields=true, EditSetFields=true)]]

Имя страницы:
Название:
Оригинальное название:
Автор:
Лицензия:
Формат:
Источник:
Базовая страница:
Страница описания лицензий:
Страница описания форматов:
Шаблон:
Аннотация:
Перезаписать:
 

MaterialFiles

Макрос для управления файлами материала. Использует действие ../../Actions/MaterialFiles для управления файлов.

Параметры

Параметром без значения является имя (Name) материала, для которого генерируется макрос. Если оно не указано, то макрос генерируется для текущей страницы.

Параметр

Тип

Значение по умолчанию

Описание

base

Имя страницы

PspoMaterials

Базовая страница для страницы паспорта материала

Использование

Макрос генерирует дерево файлов материала с кнопками для выполнение действий, на которые имеются права.

Макрос генерирует ссылку на паспорт материала.

Параметры

Параметр

Тип

Значение по умолчанию

Описание

Base

Имя страницы

PspoMaterials

Базовая страница для страницы паспорта материала

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: Netiquette Guidelines

Генерируется ссылка на паспорт материала RFC_1855.

<<PassportLink(RFC_1855,Text=name)>>

 RFC_1855

Генерируется ссылка на паспорт материала 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: Netiquette Guidelines

Генерируется ссылка на файлы материала RFC_1855. Не смотря на опцию DirectBrain, включенную по умолчанию, ссылка генерируется на директорию, так как индексный файл не найден.

<<PassportLink(RFC_1855,Format=Lecture)>>

 RFC 1855: Netiquette Guidelines

Генерируется ссылка на паспорт материала RFC_1855, формат задан принудительно.

<<PassportLink(AltDocs_linuxnovice,Direct=True,DirectPath=ch02s11.html)>>

 Linux и UNIX: Руководство начинающего пользователя

Генерируется ссылка на файл ch02s11.html материала AltDocs_linuxnovice.

<<PassportLink(AltDocs_linuxnovice,Direct=True,DirectPath=ch02s11.html,DirectPathDesc=Emacs для начинающих)>>

 Linux и UNIX: Руководство начинающего пользователя: Emacs для начинающих

Генерируется ссылка на файл ch02s11.html материала AltDocs_linuxnovice с описанием «Emacs для начинающих».

eSyr/WikiHack/Macros (last edited 2008-08-01 23:12:00 by eSyr)