5189
Комментарий:
|
← Версия 9 от 2009-10-26 14:36:13 ⇥
5194
|
Удаления помечены так. | Добавления помечены так. |
Строка 14: | Строка 14: |
* Макрос и действие CreateMaterialPassport, которые позволяют создавать страницы паспорта, используя формочку (по аналогии с макросом/действием NewPage) | * Макрос и действие !CreateMaterialPassport, которые позволяют создавать страницы паспорта, используя формочку (по аналогии с макросом/действием !NewPage) |
Строка 17: | Строка 17: |
CreateMaterialPassport (таких уже сейчас есть несколько, например | !CreateMaterialPassport (таких уже сейчас есть несколько, например |
Строка 41: | Строка 41: |
cjf), потом закачиваете средствами MaterialFiles, потом | cjf), потом закачиваете средствами !MaterialFiles, потом |
Строка 45: | Строка 45: |
макрос MaterialFiles на ссылку на эти страницы (ничего специального я | макрос !MaterialFiles на ссылку на эти страницы (ничего специального я |
Полиси по материалам, включаемых в состав модулей.
Требования, предъявляемые к материалам
- Материалы должны быть вычитаны на предмет пригодности ПСПО
- Материалы должны быть проверены на лицензионную чистоту
- Материалы должны иметь паспорт
Технология оформления материала
Всё начинается с создания паспорта материала. По принятому соглашению, паспорты материалов являются подстраницами страницы PspoMaterials. Вообще, никто не мешает создать паспорт вручную. Но для облегчения жизни существует две вещи:
Шаблон http://uneex.ru/MaterialPassportTemplate , в котором имеется заготовка для страницы материала
Макрос и действие CreateMaterialPassport, которые позволяют создавать страницы паспорта, используя формочку (по аналогии с макросом/действием NewPage)
Суммируя вышесказанное, рекомендуемый метод создания страницы паспорта таков: вы заходите на страницу, где размещён макрос CreateMaterialPassport (таких уже сейчас есть несколько, например PSPO и PspoMaterials; кроме того, данный макрос вполне себе настраивается, см. документацию, так что вы вполне себе можете положить макрос с заданными параметрами куда-нибудь на свою страницу, например), заполняете форму и нажимаете кнопку "Создать паспорт материала", после чего оказываетесь на созданной странице с заполненными полями.
Среди полей, которые стоит заполнить, имеются два особенных: Format и License. Эти поля являются собенными потому, что фактически указанные в них значения будут являться параметрами для соответственно макросов FormatInfo и LicenseInfo на новосозданной странице материала. Суть этих макросов в том, что они вставляют текст со страниц PspoMaterials/FormatInfo/PspoMaterials/LicenseInfo под заголовками, перечисленными в параметрах. Таким образом, <<LicenseInfo(GFDL,CC-BY-SA)>> преобразуется в
и так далее.
Далее. Внизу сгенерированной страницы имеется макрос <<MaterialFiles()>>. Это способ управления файлами материала. Он умеет достаточно мало: upload, move, delete, pack/unpack, mkdir. (Рас)паковка работает пока только для архивов bzip2. Соответственно, если нужно загрузить дерево файлов, то сначала вы их архивируете (tar cjf), потом закачиваете средствами MaterialFiles, потом распаковываете.
В случае, если создаётся паспорт для страниц вики, просто замените макрос MaterialFiles на ссылку на эти страницы (ничего специального я по этому поводу не хакал, просто таково соглашение). Также, вероятнее всего, будет логичным размещать их как подстраницы страницы паспорта в некоторых случаях.
Для создания ссылки на паспорт материала используйте макрос PassportLink, например, так: <<PassportLink(MaterialName)>>.
Документация: