Шаблон:Product info: различия между версиями
Перейти к навигации
Перейти к поиску
Содержимое удалено Содержимое добавлено
Nikita (обсуждение | вклад) Ох, как всё сложно |
Oreolek (обсуждение | вклад) мНет описания правки |
||
| (не показано 58 промежуточных версий 3 участников) | |||
| Строка 1: | Строка 1: | ||
{| class="infobox" cell cellpadding="3" cellspacing="0" |
|||
| colspan="2" class="infoHeader" | {{#if: {{{название|}}}|'''{{{название}}}'''{{#vardefine:productname| {{{название}}} }}|'''{{PAGENAME}}'''{{#vardefine:productname| {{PAGENAME}} }} }} |
|||
|- style="{{#if: {{{тип|}}} | | display: none; }}" |
|||
! [[Свойство:Тип|Тип]] |
|||
|<includeonly>{{#arraydefine:type|{{{тип| }}}|,}}{{#arrayprint:type|, |@@@@ |[[Категория:@@@@]] [[Тип::@@@@| ]] [[:Категория:@@@@|@@@@]] }} {{#vardefine:isplatform| {{#arraysearch:type|Менюшные платформы}}{{#arraysearch:type|Парсерные платформы}} }} {{#vardefine:issite| {{#arraysearch:type|Новостные ресурсы}}{{#arraysearch:type|Сайты}} }}</includeonly><nowiki /> |
|||
|- style="{{#if: {{{разработчик|}}} | | display: none; }}" |
|||
! [[:Категория:Персоналии|<includeonly>{{#if: {{#var:issite}} | Администратор(ы) | Разработчик(и) }}</includeonly>]] |
|||
| {{{разработчик}}} |
|||
|- style="{{#if: {{{язык|}}} | | display: none; }}" |
|||
! Языки интерфейса |
|||
| {{{язык}}} |
|||
|- style="{{#if: {{{система|}}} | | {{#ifeq: {{{онлайн|}}} | да | | display: none; }} }}" |
|||
! Операционные системы |
|||
| <includeonly> {{#ifeq: {{{онлайн|}}} | да | [[Категория:Онлайн-платформы]] [[:Категория:Онлайн-платформы|Браузер]]{{#if: {{{система|}}} | ,  | }} {{{система|}}} | {{{система|}}} }} </includeonly> |
|||
|- style="{{#if: {{{написано на|}}} | | display: none; }}" |
|||
! Написано на |
|||
| {{{написано на}}} |
|||
|- style="{{#if: {{{язык разработки|}}} | | display: none; }}" |
|||
! Язык разработки |
|||
| <includeonly> {{#ifeq: {{{язык разработки|}}} | Визуальный редактор | [[{{{язык разработки}}}]] [[Категория:Платформы без программирования]] | {{{язык разработки}}} }} </includeonly> |
|||
|- style="{{#if: {{{читаемый формат|}}} | | display: none; }}" |
|||
! [[:Категория:Расширения файлов|Читаемые форматы файлов]] |
|||
| {{{читаемый формат}}} |
|||
|- style="{{#if: {{{создаваемый формат|}}} | | display: none; }}" |
|||
! [[:Категория:Расширения файлов|Создаваемые форматы файлов]] |
|||
| {{{создаваемый формат}}} |
|||
|- style="{{#if: {{{первый выпуск|}}} | | display: none; }}" |
|||
! [[Свойство:Дата первого релиза|<includeonly>{{#if: {{#var:issite}} | Начало работы | Дата первого выпуска }}</includeonly>]] |
|||
| <includeonly> {{#if: {{{первый выпуск|}}} | [[Дата первого релиза::{{{первый выпуск}}}|{{#ifeq: {{#expr: {{{первый выпуск}}}*1 }} | {{{первый выпуск}}} | {{{первый выпуск}}} | {{#time: j xg Y|{{{первый выпуск}}}|ru }} }}]] | }} </includeonly> |
|||
|- style="{{#if: {{{последняя версия|}}} | | display: none; }}" |
|||
! [[Свойство:Версия|Последняя версия]] |
|||
| {{{последняя версия}}} <includeonly> {{#if: {{{последняя версия|}}} | [[Версия::{{{последняя версия}}}| ]] | }} </includeonly> |
|||
|- style="{{#if: {{{дата последней версии|}}} | | display: none; }}" |
|||
! [[Свойство:Дата последнего релиза|<includeonly>{{#if: {{#var:issite}} | Прекращение работы | Дата последней версии }}</includeonly>]] |
|||
| <includeonly> {{#if: {{{дата последней версии|}}} | [[Дата последнего релиза::{{{дата последней версии}}}|{{#ifeq: {{#expr: {{{дата последней версии}}}*1 }} | {{{дата последней версии}}} | {{{дата последней версии}}} | {{#time: j xg Y|{{{дата последней версии}}}|ru }} }}]] | {{#if: {{{первый выпуск|}}} | [[Дата последнего релиза::{{{первый выпуск}}}| ]] | }} }} </includeonly> |
|||
|- style="{{#if: {{{состояние|}}} | | display: none; }}" |
|||
! Состояние |
|||
| <includeonly>{{#if: {{#var:isplatform}} | {{#ifeq: {{{состояние|}}} | Архивное | [[Категория:Заброшенные платформы]][[Заброшенные системы|{{{состояние}}}]] | {{{состояние}}} }} | {{{состояние}}} }}</includeonly> |
|||
|- style="{{#if: {{{лицензия|}}} | | display: none; }}" |
|||
! <includeonly>{{#if: {{#var:issite}} | Условия использования | Лицензия }}</includeonly> |
|||
| {{{лицензия}}} |
|||
|- style="{{#if: {{{сайт|}}} | | display: none; }}" |
|||
! <includeonly>{{#if: {{#var:issite}} | Адрес | Сайт }}</includeonly> |
|||
| {{{сайт}}} |
|||
|} |
|||
<includeonly><nowiki /> |
|||
[[Название::{{#var:productname}}| ]]<nowiki /> |
|||
</includeonly><nowiki /> |
|||
<noinclude> |
<noinclude> |
||
Данный шаблон используется для систематизации описания на страницах вики различных проектов и разработок из области [[Интерактивная литература|интерактивной литературы]], таких как [[:Категория:Платформы|платформы]], [[:Категория:Инструменты|инструменты]], [[:Категория:Интернет-ресурсы|Интернет-ресурсы]] и прочих. |
|||
{{ ЗаглушкаТекста }} |
|||
Это концепт будущего шаблона для унификации структурированного представления информации о платформах разработки ИЛ, средствах разработки (редакторы, компиляторы), Интернет-ресурсах (информационных и совмещённых с платформами). |
|||
'''Шаблон не готов к использованию. До снятия этой отметки ни в коем случае не пытайтесь его применять на страницах wiki!''' |
|||
Для отслеживания результатов есть страница тестового применения шаблона «[[TADS Toolchain]]», за поломки которой никто обижаться не будет. |
|||
== Заготовка для копирования == |
== Заготовка для копирования == |
||
<pre><nowiki> |
<pre><nowiki> |
||
{{product info |
{{product info |
||
|название = |
|название = |
||
|тип = |
|тип = |
||
|разработчик = |
|разработчик = |
||
|язык = |
|||
|языки интерфейса = |
|||
|система = |
|||
|операционные системы = |
|||
|онлайн = |
|||
|написано на = |
|написано на = |
||
|язык разработки = |
|язык разработки = |
||
|читаемый формат = |
|||
|читаемые форматы данных = |
|||
|создаваемый формат = |
|||
|создаваемые форматы данных = |
|||
|первый выпуск = |
|первый выпуск = |
||
|последняя версия = |
|последняя версия = |
||
| Строка 28: | Строка 71: | ||
}} |
}} |
||
</nowiki></pre> |
</nowiki></pre> |
||
Если название не указано, то оно будет заменено на название статьи. |
|||
== Параметры == |
== Параметры == |
||
Все параметры |
Все параметры необязательны. При их отсутствии (или при наличии с пустыми значениями) соответствующие поля карточки не будут показаны. Если не задан параметр «название», то в качестве названия в карточке будет показываться название статьи. |
||
* название — название продукта произвольной строкой текста |
|||
* (!) тип — тип продукта, один или несколько (через запятую) из вариантов: |
|||
** Инструменты |
|||
** Интерпретаторы |
|||
** Новостные ресурсы |
|||
** Менюшные платформы |
|||
** Парсерные платформы |
|||
** Сайты |
|||
* разработчик — главные лица и организации, принявшие участие в разработке продукта. В виде произвольной строки текста, но конкретные персоны записываются в ней при помощи свойств соответствующего вида, например: |
|||
** Разработчик как [[Разработчик::Имя разработчика]] |
|||
** Локализатор как [[Локализатор::Имя локализатора]] |
|||
** Администратор как [[Администратор::Имя администратора]] |
|||
* языки интерфейса — язык, на котором пользователь будет взаимодействовать с интерфейсом продукта. В виде произвольной строки текста, но конкретные языки записываются в ней при помощи свойств соответствующего вида, например:<br>12 языков, в том числе [[Язык::Русский]] |
|||
* операционные системы — перечень систем, на которых возможно использование продукта. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую. |
|||
* написано на — язык программирования, на котором написан продукт. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую. |
|||
* язык разработки — язык программирования, на котором пользователь будет вести разработку (актуально для платформ и средств разработки), для [[:Категория:Платформы без программирования|платформ без программирования]] следует использовать значение «Визуальный редактор» |
|||
* читаемые форматы данных — форматы файлов, которые можно открывать программой (актуально для интерпретаторов). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла, например, «Текстовые документы (*.txt)». |
|||
* создаваемые форматы данных — форматы файлов, которые можно создавать программой (актуально для платформ и средств разработки (инструментов)). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла, например, «Веб-страница (*.htm;*.html)». |
|||
* первый выпуск — дата выпуска первой версии. Значение в виде максимально подробного указания даты в форматах ДД.ММ.ГГГГ, ММ.ГГГГ или ГГГГ. |
|||
* последняя версия — текущая версия. Значение в виде произвольной строки текста. |
|||
* дата последней версии — дата выпуска текущей версии. Значение в виде максимально подробного указания даты в форматах ДД.ММ.ГГГГ, ММ.ГГГГ или ГГГГ. |
|||
* состояние — текущее состояние продукта: если разрабатывается, поддерживается или активно используется, то «активное», если ничего из этого, то «архивное» |
|||
* лицензия — лицензия, на условиях которой распространяется продукт. Значение в виде произвольной строки текста, но название лицензии желательно делать ссылкой на её текст или описание. |
|||
* сайт — официальный сайт продукта. |
|||
== Зависимости == |
|||
Шаблон Product info имеет зависимости со следующими страницами: |
|||
* '''название''' — название продукта произвольной строкой текста |
|||
* [[:Свойство:Дата]] |
|||
* '''тип''' — тип продукта, один или несколько (через запятую), которые должны соответствовать существующим категориям в вики, например: |
|||
* [[:Свойство:Локализатор]] |
|||
** ''[[:Категория:Менюшные платформы|Менюшные платформы]]'' |
|||
* [[:Свойство:Разработчик]] |
|||
** ''[[:Категория:Парсерные платформы|Парсерные платформы]]'' |
|||
* [[:Свойство:Язык]] |
|||
** Одна из подкатегорий категории [[:Категория:Расширения платформ|Расширения платформ]]. |
|||
* [[:Шаблон:Проекты и разработки]] |
|||
** Одна или несколько из подкатегорий категории [[:Категория:Интерпретаторы|Интерпретаторы]] |
|||
** ''[[:Категория:Инструменты|Инструменты]]'' |
|||
** ''[[:Категория:Новостные ресурсы|Новостные ресурсы]]'' |
|||
** ''[[:Категория:Сайты|Сайты]]'' |
|||
* '''разработчик''' — главные лица и организации, принявшие участие в разработке продукта. В виде произвольной строки текста, но конкретные персоны записываются в ней при помощи свойств соответствующего вида: |
|||
** Разработчик как ''[[Разработчик::Имя разработчика]]'' (например, разработчик какой-то утилиты) |
|||
** Локализатор как ''[[Локализатор::Имя локализатора]]'' (например, локализатор какой-то платформы) |
|||
** Администратор как ''[[Администратор::Имя администратора]]'' (например, администратор какого-то Интернет-ресурса) |
|||
** Технический писатель как ''[[Технический писатель::Имя технического писателя]]'' (например, автор документации для какой-то платформы) |
|||
* '''язык''' — язык, на котором пользователь будет взаимодействовать с интерфейсом продукта. В виде произвольной строки текста, например:<br>''12 языков, в том числе русский'' |
|||
* '''система''' — перечень операционных систем, на которых возможно использование продукта. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую. |
|||
* '''онлайн''' — флаг для [[:Категория:Онлайн-платформы|онлайн-платформ]]: если платформа имеет штатную возможность воспроизведения игр в онлайн-режиме, то данный параметр должен иметь значение «''да''». |
|||
* '''написано на''' — язык программирования, на котором написан продукт. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую. |
|||
* '''язык разработки''' — язык программирования, на котором пользователь будет вести разработку (актуально для платформ и средств разработки), для [[:Категория:Платформы без программирования|платформ без программирования]] следует использовать значение «''Визуальный редактор''» |
|||
* '''читаемый формат''' — форматы файлов, которые можно открывать программой (актуально для интерпретаторов). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла в виде ссылки на статью про соответствующее расширение, например, «''[[.txt|Текстовые документы (*.txt)]]''». |
|||
* '''создаваемый формат''' — форматы файлов, которые можно создавать программой (актуально для платформ и средств разработки (инструментов)). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла в виде ссылки на статью про соответствующее расширение, например, «''[[.html|Веб-страница (*.htm;*.html)]]''». |
|||
* '''первый выпуск''' — дата выпуска первой версии. Значение в виде указания даты в формате ''ДД.ММ.ГГГГ'' или ''ГГГГ''. |
|||
* '''последняя версия''' — текущая версия. Значение в виде произвольной строки текста. |
|||
* '''дата последней версии''' — дата выпуска текущей версии. Значение в виде указания даты в формате ''ДД.ММ.ГГГГ'' или ''ГГГГ''. |
|||
* '''состояние''' — текущее состояние продукта: если разрабатывается, поддерживается или активно используется, то «''Активное''», если ничего из этого, то «''Архивное''». Однако в явной форме указывать значение «''Активное''», как правило, смысла нет. |
|||
* '''лицензия''' — лицензия, на условиях которой распространяется продукт. Значение в виде произвольной строки текста, но название лицензии желательно делать ссылкой на её текст или описание. Для Интернет-ресурсов здесь описываются условия использования (необходимость регистрации и пр.). |
|||
* '''сайт''' — официальный сайт продукта. Значение в виде произвольной строки текста, но желательно, чтобы она была ссылкой, видимая часть которой будет написана в нижнем регистре без схемы URI, «www» и завершающего знака слеша, например, ''[https://www.IFwiki.ru/ ifwiki.ru]'' |
|||
== Примеры использования == |
|||
== To Do == |
|||
Для лучшего понимания принципов применения шаблона можно ознакомиться со следующими статьями вики, демонстрирующими его использование в разных вариантах: |
|||
* Обдумать следующие проблемы: |
|||
*# Свойство «[[:Свойство:Язык|Язык]]» жёстко привязано к играм. Возможно не самая удачная идея использовать его применительно не к играм в параметре «языки интерфейса». |
|||
*# У параметров «операционные системы» и «язык разработки» предполагаются значения в виде произвольных строк, но при этом есть необходимость реагировать на ключевые слова для автоматической простановке категорий «[[:Категория:Онлайн-платформы|Онлайн-платформы]]» и «[[:Категория:Платформы без программирования|Платформы без программирования]]» (см. задачи ниже). Возможно имеет смысл для этих задач ввести отдельные параметры с бинарными значениями этих характеристик. |
|||
* Продумать механизм классификации продуктов типа [[Z-машина|Z-машины]] в параметре «тип». |
|||
* Для заполнения параметра «разработчик» создать свойство «[[:Свойство:Разработчик|Разработчик]]», а также создать для него следующие подсвойства: «[[:Свойство:Локализатор|Локализатор]]» (например, [[Коптельцев, Валентин|Валентин Коптельцев]] по отношению к [[TADS|TADS 2]] или [[Жучков, Антон|Антон Жучков]] по отношению к [[Twine]]). Также возможны такие подсвойства как «[[:Свойство:Ментейнер|Ментейнер]]», «[[:Свойство:Контрибьютер|Контрибьютер]]», «[[:Свойство:Администратор|Администратор]]», но есть сомнения, что для текущего объёма данных нужна столь мелкая классификация. Следует тщательнее изучить вопрос необходимости подобных подсвойств. |
|||
* Для отображения причастности [[:Категория:Персоналии|персоналий]] к тем или иным продуктам создать шаблон «[[:Шаблон:Проекты и разработки|Проекты и разработки]]», который должен будет добавляться на страницу персоны и в табличной форме выводить информацию, генерируемую по значениям свойства «[[:Свойство:Разработчик|Разработчик]]» и его подсвойств, аналогично работе шаблона «[[:Шаблон:Игры автора|Игры автора]]». Прямое внедрение информации от Product info в шаблон «[[:Шаблон:Игры автора|Игры автора]]», пожалуй, всё-таки неуместно. |
|||
* Сделать шаблон Product info как таковой со следующими требованиями: |
|||
*# Значения параметра «тип» должны приводить к автоматической вставке соответствующих категорий |
|||
*# Значение «Визуальный редактор» параметра «язык разработки» должно приводить к автоматической вставке категории «[[:Категория:Платформы без программирования|Платформы без программирования]]» |
|||
*# Значение «web» параметра «операционные системы» должно приводить к автоматической вставке категории «[[:Категория:Онлайн-платформы|Онлайн-платформы]]». |
|||
*# Одновременное наличие значения «Менюшные платформы» или «Парсерные платформы» параметра «тип» и значения «архивное» параметра «состояние» должно приводить к автоматической вставке категории «[[:Категория:Заброшенные платформы|Заброшенные платформы]]», то есть<br>''ЕСЛИ (тип = Менюшные платформы ИЛИ тип = Парсерные платформы) И состояние = архивное ТОГДА вставить Категория:Заброшенные платформы'' |
|||
*# В параметре «язык интерфейса» использовать уже существующее свойство «[[:Свойство:Язык|Язык]]», а для параметров «первый выпуск» и «дата последней версии» также уже существующее свойство «[[:Свойство:Дата|Дата]]». |
|||
* Проверить именование всех потенциально задействованных семантических свойств на предмет отсутствия двусмысленности и коллизий. |
|||
* В конце ещё раз всё перепроверить и обкатать на нескольких тестовых страницах, после чего начать адаптировать под использование шаблона [[:Категория:Платформы|страницы платформ]] в этой wiki. |
|||
* [[RTADS|Статья про Платформу RTADS]] |
|||
См. [[:Обсуждение:Product info|обсуждение]]. |
|||
* [[TADS Toolchain|Статья про инструмент TADS Toolchain]] |
|||
* [[IFHub|Статья про Интернет-ресурс IFHub]] |
|||
[[Категория:Шаблоны]] |
[[Категория:Шаблоны]] |
||
Текущая версия от 07:12, 7 ноября 2023
| Product info |
Данный шаблон используется для систематизации описания на страницах вики различных проектов и разработок из области интерактивной литературы, таких как платформы, инструменты, Интернет-ресурсы и прочих.
Заготовка для копирования
{{product info
|название =
|тип =
|разработчик =
|язык =
|система =
|онлайн =
|написано на =
|язык разработки =
|читаемый формат =
|создаваемый формат =
|первый выпуск =
|последняя версия =
|дата последней версии =
|состояние =
|лицензия =
|сайт =
}}
Параметры
Все параметры необязательны. При их отсутствии (или при наличии с пустыми значениями) соответствующие поля карточки не будут показаны. Если не задан параметр «название», то в качестве названия в карточке будет показываться название статьи.
- название — название продукта произвольной строкой текста
- тип — тип продукта, один или несколько (через запятую), которые должны соответствовать существующим категориям в вики, например:
- Менюшные платформы
- Парсерные платформы
- Одна из подкатегорий категории Расширения платформ.
- Одна или несколько из подкатегорий категории Интерпретаторы
- Инструменты
- Новостные ресурсы
- Сайты
- разработчик — главные лица и организации, принявшие участие в разработке продукта. В виде произвольной строки текста, но конкретные персоны записываются в ней при помощи свойств соответствующего вида:
- Разработчик как [[Разработчик::Имя разработчика]] (например, разработчик какой-то утилиты)
- Локализатор как [[Локализатор::Имя локализатора]] (например, локализатор какой-то платформы)
- Администратор как [[Администратор::Имя администратора]] (например, администратор какого-то Интернет-ресурса)
- Технический писатель как [[Технический писатель::Имя технического писателя]] (например, автор документации для какой-то платформы)
- язык — язык, на котором пользователь будет взаимодействовать с интерфейсом продукта. В виде произвольной строки текста, например:
12 языков, в том числе русский - система — перечень операционных систем, на которых возможно использование продукта. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
- онлайн — флаг для онлайн-платформ: если платформа имеет штатную возможность воспроизведения игр в онлайн-режиме, то данный параметр должен иметь значение «да».
- написано на — язык программирования, на котором написан продукт. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
- язык разработки — язык программирования, на котором пользователь будет вести разработку (актуально для платформ и средств разработки), для платформ без программирования следует использовать значение «Визуальный редактор»
- читаемый формат — форматы файлов, которые можно открывать программой (актуально для интерпретаторов). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла в виде ссылки на статью про соответствующее расширение, например, «[[.txt|Текстовые документы (*.txt)]]».
- создаваемый формат — форматы файлов, которые можно создавать программой (актуально для платформ и средств разработки (инструментов)). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла в виде ссылки на статью про соответствующее расширение, например, «[[.html|Веб-страница (*.htm;*.html)]]».
- первый выпуск — дата выпуска первой версии. Значение в виде указания даты в формате ДД.ММ.ГГГГ или ГГГГ.
- последняя версия — текущая версия. Значение в виде произвольной строки текста.
- дата последней версии — дата выпуска текущей версии. Значение в виде указания даты в формате ДД.ММ.ГГГГ или ГГГГ.
- состояние — текущее состояние продукта: если разрабатывается, поддерживается или активно используется, то «Активное», если ничего из этого, то «Архивное». Однако в явной форме указывать значение «Активное», как правило, смысла нет.
- лицензия — лицензия, на условиях которой распространяется продукт. Значение в виде произвольной строки текста, но название лицензии желательно делать ссылкой на её текст или описание. Для Интернет-ресурсов здесь описываются условия использования (необходимость регистрации и пр.).
- сайт — официальный сайт продукта. Значение в виде произвольной строки текста, но желательно, чтобы она была ссылкой, видимая часть которой будет написана в нижнем регистре без схемы URI, «www» и завершающего знака слеша, например, [https://www.IFwiki.ru/ ifwiki.ru]
Примеры использования
Для лучшего понимания принципов применения шаблона можно ознакомиться со следующими статьями вики, демонстрирующими его использование в разных вариантах: