Шаблон:Product info: различия между версиями

Материал из IFВики
Перейти к навигации Перейти к поиску
(Читаемые и создаваемые форматы данных)
м
 
(не показано 76 промежуточных версий 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: {{{система|}}} | ,&#32; | }} {{{система|}}} | {{{система|}}} }} </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!'''
 
  
 
== Заготовка для копирования ==
 
== Заготовка для копирования ==
<code>
+
<pre><nowiki>
<pre>
 
<nowiki>
 
 
{{product info
 
{{product info
|название = <!-- если нет — будет заменено на название статьи -->
+
|название =  
|логотип = <!-- только имя файла -->
 
|снимок экрана = <!-- только имя файла -->
 
|подпись =  
 
 
|тип =  
 
|тип =  
|интерфейс =  
+
|разработчик =  
|автор =
+
|язык =  
|разработчик = <!-- либо разработчики -->
+
|система =  
|языки интерфейса =  
+
|онлайн =  
|операционные системы =  
 
 
|написано на =  
 
|написано на =  
 
|язык разработки =  
 
|язык разработки =  
|читаемые форматы данных =  
+
|читаемый формат =  
|создаваемые форматы данных =  
+
|создаваемый формат =  
 
|первый выпуск =  
 
|первый выпуск =  
 
|последняя версия =  
 
|последняя версия =  
Строка 32: Строка 70:
 
|сайт =  
 
|сайт =  
 
}}
 
}}
</nowiki>
+
</nowiki></pre>
</pre>
 
</code>
 
  
 
== Параметры ==
 
== Параметры ==
Все параметры, кроме названия, необязательны. При этом соответствующие поля карточки не будут показаны.
+
Все параметры необязательны. При их отсутствии (или при наличии с пустыми значениями) соответствующие поля карточки не будут показаны. Если не задан параметр «название», то в качестве названия в карточке будет показываться название статьи.
 +
 
 +
* '''название''' — название продукта произвольной строкой текста
 +
* '''тип''' — тип продукта, один или несколько (через запятую), которые должны соответствовать существующим категориям в вики, например:
 +
** ''[[:Категория:Менюшные платформы|Менюшные платформы]]''
 +
** ''[[:Категория:Парсерные платформы|Парсерные платформы]]''
 +
** Одна из подкатегорий категории [[:Категория:Расширения платформ|Расширения платформ]].
 +
** Одна или несколько из подкатегорий категории [[:Категория:Интерпретаторы|Интерпретаторы]]
 +
** ''[[:Категория:Инструменты|Инструменты]]''
 +
** ''[[:Категория:Новостные ресурсы|Новостные ресурсы]]''
 +
** ''[[:Категория:Сайты|Сайты]]''
 +
* '''разработчик''' — главные лица и организации, принявшие участие в разработке продукта. В виде произвольной строки текста, но конкретные персоны записываются в ней при помощи свойств соответствующего вида:
 +
** Разработчик как ''&#91;&#91;Разработчик::Имя разработчика&#93;&#93;'' (например, разработчик какой-то утилиты)
 +
** Локализатор как ''&#91;&#91;Локализатор::Имя локализатора&#93;&#93;'' (например, локализатор какой-то платформы)
 +
** Администратор как ''&#91;&#91;Администратор::Имя администратора&#93;&#93;'' (например, администратор какого-то Интернет-ресурса)
 +
** Технический писатель как ''&#91;&#91;Технический писатель::Имя технического писателя&#93;&#93;'' (например, автор документации для какой-то платформы)
 +
* '''язык''' — язык, на котором пользователь будет взаимодействовать с интерфейсом продукта. В виде произвольной строки текста, например:<br>''12 языков, в том числе русский''
 +
* '''система''' — перечень операционных систем, на которых возможно использование продукта. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
 +
* '''онлайн''' — флаг для [[:Категория:Онлайн-платформы|онлайн-платформ]]: если платформа имеет штатную возможность воспроизведения игр в онлайн-режиме, то данный параметр должен иметь значение «''да''».
 +
* '''написано на''' — язык программирования, на котором написан продукт. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
 +
* '''язык разработки''' — язык программирования, на котором пользователь будет вести разработку (актуально для платформ и средств разработки), для [[:Категория:Платформы без программирования|платформ без программирования]] следует использовать значение «''Визуальный редактор''»
 +
* '''читаемый формат''' — форматы файлов, которые можно открывать программой (актуально для интерпретаторов). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла в виде ссылки на статью про соответствующее расширение, например, «''&#91;&#91;.txt|Текстовые документы (*.txt)&#93;&#93;''».
 +
* '''создаваемый формат''' — форматы файлов, которые можно создавать программой (актуально для платформ и средств разработки (инструментов)). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла в виде ссылки на статью про соответствующее расширение, например, «''&#91;&#91;.html|Веб-страница (*.htm;*.html)&#93;&#93;''».
 +
* '''первый выпуск''' — дата выпуска первой версии. Значение в виде указания даты в формате ''ДД.ММ.ГГГГ'' или ''ГГГГ''.
 +
* '''последняя версия''' — текущая версия. Значение в виде произвольной строки текста.
 +
* '''дата последней версии''' — дата выпуска текущей версии. Значение в виде указания даты в формате ''ДД.ММ.ГГГГ'' или ''ГГГГ''.
 +
* '''состояние''' — текущее состояние продукта: если разрабатывается, поддерживается или активно используется, то «''Активное''», если ничего из этого, то «''Архивное''». Однако в явной форме указывать значение «''Активное''», как правило, смысла нет.
 +
* '''лицензия''' — лицензия, на условиях которой распространяется продукт. Значение в виде произвольной строки текста, но название лицензии желательно делать ссылкой на её текст или описание. Для Интернет-ресурсов здесь описываются условия использования (необходимость регистрации и пр.).
 +
* '''сайт''' — официальный сайт продукта. Значение в виде произвольной строки текста, но желательно, чтобы она была ссылкой, видимая часть которой будет написана в нижнем регистре без схемы URI, «www» и завершающего знака слеша, например, ''&#91;https&#58;//www.IFwiki.ru/ ifwiki.ru&#93;''
  
* название — название продукта
+
== Примеры использования ==
* логотип — изображение логотипа продукта
+
Для лучшего понимания принципов применения шаблона можно ознакомиться со следующими статьями вики, демонстрирующими его использование в разных вариантах:
* снимок экрана — изображение рабочего экрана продукта
 
* подпись — описание пункта «снимок экрана»
 
* тип — тип продукта: платформа, интерпретатор, редактор, средство разработки, Интернет-ресурс и др.
 
* интерфейс — тип интерфейса пользователя: графический (HTML, Qt или др.), командная строка
 
* автор — автор первой версии продукта (возможно уже отошёл от разработки)
 
* разработчик — лица, организации и сообщества, принявшие участие в разработки продукта
 
* языки интерфейса — язык, на котором пользователь будет взаимодействовать с интерфейсом продукта
 
* операционные системы — перечень систем, на которых возможно использование продукта, в том числе web
 
* написано на — язык программирования, на котором написан продукт
 
* язык разработки — язык программирования, на котором пользователь будет вести разработку (актуально для платформ и средств разработки)
 
* читаемые форматы данных — форматы файлов, которые можно открывать программой (актуально для интерпретаторов)
 
* создаваемые форматы данных — форматы файлов, которые можно создавать программой (актуально для платформ и средств разработки)
 
* первый выпуск — дата выпуска первой версии
 
* последняя версия — текущая версия
 
* дата последней версии — дата выпуска текущей версии
 
* статус — текущее состояние продукта: активное, архивное
 
* лицензия — лицензия, на условиях которой распространяется продукт
 
* сайт — официальный сайт продукта
 
  
== To Do ==
+
* [[RTADS|Статья про Платформу RTADS]]
* Ещё раз обдумать структуру и наполнение параметров
+
* [[TADS Toolchain|Статья про инструмент TADS Toolchain]]
* Чётче специфицировать пространство значений параметра «тип».
+
* [[IFHub|Статья про Интернет-ресурс IFHub]]
* Сделать шаблон как таковой со следующими требованиями:
 
*# Параметр «тип» должен соотноситься с существующей в wiki структурой категорий и автоматически добавлять статье с шаблоном подходящие категории, в частности, такие как «[[:Категория:Платформы|Платформы]]», «[[:Категория:Парсерные платформы|Парсерные платформы]]», «[[:Категория:Менюшные платформы|Менюшные платформы]]» и др.
 
*# Значение параметров «автор» и «разработчик» должны автоматически приводить к отображению упомянутых лиц в соответствующем качестве на их страницах в данной wiki (либо интеграцией с шаблоном «[[:Шаблон:Игры автора|Игры автора]]», либо в виде дополнительного шаблона (оптимальный вариант надо обдумать)).
 
*# Возможно ряд прочих параметров имеет смысл делать полноценными свойствами, чтобы, например, была возможность отсортировывать платформы с поддержкой web (надо чётче оценить соотношение трудоёмкости и актуальности реализации).
 
* В конце ещё раз всё перепроверить и начать адаптировать под использование шаблона [[:Категория:Платформы|страницы платформ]] в этой wiki.
 
  
 
[[Категория:Шаблоны]]
 
[[Категория:Шаблоны]]
 
</noinclude>
 
</noinclude>

Текущая версия на 10:12, 7 ноября 2023

Product info
Тип
[[:Категория:Персоналии|]] {{{разработчик}}}
Языки интерфейса {{{язык}}}
Операционные системы
Написано на {{{написано на}}}
Язык разработки
Читаемые форматы файлов {{{читаемый формат}}}
Создаваемые форматы файлов {{{создаваемый формат}}}
[[Свойство:Дата первого релиза|]]
Последняя версия {{{последняя версия}}}
[[Свойство:Дата последнего релиза|]]
Состояние
{{{лицензия}}}
{{{сайт}}}

Данный шаблон используется для систематизации описания на страницах вики различных проектов и разработок из области интерактивной литературы, таких как платформы, инструменты, Интернет-ресурсы и прочих.

Заготовка для копирования

{{product info
|название = 
|тип = 
|разработчик = 
|язык = 
|система = 
|онлайн = 
|написано на = 
|язык разработки = 
|читаемый формат = 
|создаваемый формат = 
|первый выпуск = 
|последняя версия = 
|дата последней версии = 
|состояние = 
|лицензия = 
|сайт = 
}}

Параметры

Все параметры необязательны. При их отсутствии (или при наличии с пустыми значениями) соответствующие поля карточки не будут показаны. Если не задан параметр «название», то в качестве названия в карточке будет показываться название статьи.

  • название — название продукта произвольной строкой текста
  • тип — тип продукта, один или несколько (через запятую), которые должны соответствовать существующим категориям в вики, например:
  • разработчик — главные лица и организации, принявшие участие в разработке продукта. В виде произвольной строки текста, но конкретные персоны записываются в ней при помощи свойств соответствующего вида:
    • Разработчик как [[Разработчик::Имя разработчика]] (например, разработчик какой-то утилиты)
    • Локализатор как [[Локализатор::Имя локализатора]] (например, локализатор какой-то платформы)
    • Администратор как [[Администратор::Имя администратора]] (например, администратор какого-то Интернет-ресурса)
    • Технический писатель как [[Технический писатель::Имя технического писателя]] (например, автор документации для какой-то платформы)
  • язык — язык, на котором пользователь будет взаимодействовать с интерфейсом продукта. В виде произвольной строки текста, например:
    12 языков, в том числе русский
  • система — перечень операционных систем, на которых возможно использование продукта. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
  • онлайн — флаг для онлайн-платформ: если платформа имеет штатную возможность воспроизведения игр в онлайн-режиме, то данный параметр должен иметь значение «да».
  • написано на — язык программирования, на котором написан продукт. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
  • язык разработки — язык программирования, на котором пользователь будет вести разработку (актуально для платформ и средств разработки), для платформ без программирования следует использовать значение «Визуальный редактор»
  • читаемый формат — форматы файлов, которые можно открывать программой (актуально для интерпретаторов). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла в виде ссылки на статью про соответствующее расширение, например, «[[.txt|Текстовые документы (*.txt)]]».
  • создаваемый формат — форматы файлов, которые можно создавать программой (актуально для платформ и средств разработки (инструментов)). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла в виде ссылки на статью про соответствующее расширение, например, «[[.html|Веб-страница (*.htm;*.html)]]».
  • первый выпуск — дата выпуска первой версии. Значение в виде указания даты в формате ДД.ММ.ГГГГ или ГГГГ.
  • последняя версия — текущая версия. Значение в виде произвольной строки текста.
  • дата последней версии — дата выпуска текущей версии. Значение в виде указания даты в формате ДД.ММ.ГГГГ или ГГГГ.
  • состояние — текущее состояние продукта: если разрабатывается, поддерживается или активно используется, то «Активное», если ничего из этого, то «Архивное». Однако в явной форме указывать значение «Активное», как правило, смысла нет.
  • лицензия — лицензия, на условиях которой распространяется продукт. Значение в виде произвольной строки текста, но название лицензии желательно делать ссылкой на её текст или описание. Для Интернет-ресурсов здесь описываются условия использования (необходимость регистрации и пр.).
  • сайт — официальный сайт продукта. Значение в виде произвольной строки текста, но желательно, чтобы она была ссылкой, видимая часть которой будет написана в нижнем регистре без схемы URI, «www» и завершающего знака слеша, например, [https://www.IFwiki.ru/ ifwiki.ru]

Примеры использования

Для лучшего понимания принципов применения шаблона можно ознакомиться со следующими статьями вики, демонстрирующими его использование в разных вариантах: