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

Материал из IFВики
Перейти к навигации Перейти к поиску
Содержимое удалено Содержимое добавлено
Ох, как всё сложно
Укороченные названия параметров
Строка 14: Строка 14:
|тип =
|тип =
|разработчик =
|разработчик =
|язык =
|языки интерфейса =
|система =
|операционные системы =
|написано на =
|написано на =
|язык разработки =
|язык разработки =
|читаемый формат =
|читаемые форматы данных =
|создаваемый формат =
|создаваемые форматы данных =
|первый выпуск =
|первый выпуск =
|последняя версия =
|последняя версия =
Строка 28: Строка 28:
}}
}}
</nowiki></pre>
</nowiki></pre>

Если название не указано, то оно будет заменено на название статьи.


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


* название — название продукта произвольной строкой текста
* название — название продукта произвольной строкой текста
Строка 46: Строка 44:
** Локализатор как &#91;&#91;Локализатор::Имя локализатора&#93;&#93;
** Локализатор как &#91;&#91;Локализатор::Имя локализатора&#93;&#93;
** Администратор как &#91;&#91;Администратор::Имя администратора&#93;&#93;
** Администратор как &#91;&#91;Администратор::Имя администратора&#93;&#93;
* языки интерфейса — язык, на котором пользователь будет взаимодействовать с интерфейсом продукта. В виде произвольной строки текста, но конкретные языки записываются в ней при помощи свойств соответствующего вида, например:<br>12 языков, в том числе &#91;&#91;Язык::Русский&#93;&#93;
* язык — язык, на котором пользователь будет взаимодействовать с интерфейсом продукта. В виде произвольной строки текста, но конкретные языки записываются в ней при помощи свойств соответствующего вида, например:<br>12 языков, в том числе &#91;&#91;Язык::Русский&#93;&#93;
* операционные системы — перечень систем, на которых возможно использование продукта. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
* система — перечень систем, на которых возможно использование продукта. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
* написано на — язык программирования, на котором написан продукт. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
* написано на — язык программирования, на котором написан продукт. Значение в виде произвольной строки текста, желательно просто с перечислением названий через запятую.
* язык разработки — язык программирования, на котором пользователь будет вести разработку (актуально для платформ и средств разработки), для [[:Категория:Платформы без программирования|платформ без программирования]] следует использовать значение «Визуальный редактор»
* язык разработки — язык программирования, на котором пользователь будет вести разработку (актуально для платформ и средств разработки), для [[:Категория:Платформы без программирования|платформ без программирования]] следует использовать значение «Визуальный редактор»
* читаемые форматы данных — форматы файлов, которые можно открывать программой (актуально для интерпретаторов). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла, например, «Текстовые документы (*.txt)».
* читаемый формат — форматы файлов, которые можно открывать программой (актуально для интерпретаторов). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла, например, «Текстовые документы (*.txt)».
* создаваемые форматы данных — форматы файлов, которые можно создавать программой (актуально для платформ и средств разработки (инструментов)). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла, например, «Веб-страница (*.htm;*.html)».
* создаваемый формат — форматы файлов, которые можно создавать программой (актуально для платформ и средств разработки (инструментов)). Значение в виде произвольной строки текста, желательно описывать полным названием типа файла, например, «Веб-страница (*.htm;*.html)».
* первый выпуск — дата выпуска первой версии. Значение в виде максимально подробного указания даты в форматах ДД.ММ.ГГГГ, ММ.ГГГГ или ГГГГ.
* первый выпуск — дата выпуска первой версии. Значение в виде максимально подробного указания даты в форматах ДД.ММ.ГГГГ, ММ.ГГГГ или ГГГГ.
* последняя версия — текущая версия. Значение в виде произвольной строки текста.
* последняя версия — текущая версия. Значение в виде произвольной строки текста.
Строка 70: Строка 68:
== To Do ==
== To Do ==
* Обдумать следующие проблемы:
* Обдумать следующие проблемы:
*# Свойство «[[:Свойство:Язык|Язык]]» жёстко привязано к играм. Возможно не самая удачная идея использовать его применительно не к играм в параметре «языки интерфейса».
*# Свойство «[[:Свойство:Язык|Язык]]» жёстко привязано к играм. Возможно не самая удачная идея использовать его применительно не к играм в параметре «язык».
*# У параметров «операционные системы» и «язык разработки» предполагаются значения в виде произвольных строк, но при этом есть необходимость реагировать на ключевые слова для автоматической простановке категорий «[[:Категория:Онлайн-платформы|Онлайн-платформы]]» и «[[:Категория:Платформы без программирования|Платформы без программирования]]» (см. задачи ниже). Возможно имеет смысл для этих задач ввести отдельные параметры с бинарными значениями этих характеристик.
*# У параметров «система» и «язык разработки» предполагаются значения в виде произвольных строк, но при этом есть необходимость реагировать на ключевые слова для автоматической простановке категорий «[[:Категория:Онлайн-платформы|Онлайн-платформы]]» и «[[:Категория:Платформы без программирования|Платформы без программирования]]» (см. задачи ниже). Возможно имеет смысл для этих задач ввести отдельные параметры с бинарными значениями этих характеристик.
* Продумать механизм классификации продуктов типа [[Z-машина|Z-машины]] в параметре «тип».
* Продумать механизм классификации продуктов типа [[Z-машина|Z-машины]] в параметре «тип».
* Для заполнения параметра «разработчик» создать свойство «[[:Свойство:Разработчик|Разработчик]]», а также создать для него следующие подсвойства: «[[:Свойство:Локализатор|Локализатор]]» (например, [[Коптельцев, Валентин|Валентин Коптельцев]] по отношению к [[TADS|TADS 2]] или [[Жучков, Антон|Антон Жучков]] по отношению к [[Twine]]). Также возможны такие подсвойства как «[[:Свойство:Ментейнер|Ментейнер]]», «[[:Свойство:Контрибьютер|Контрибьютер]]», «[[:Свойство:Администратор|Администратор]]», но есть сомнения, что для текущего объёма данных нужна столь мелкая классификация. Следует тщательнее изучить вопрос необходимости подобных подсвойств.
* Для заполнения параметра «разработчик» создать свойство «[[:Свойство:Разработчик|Разработчик]]», а также создать для него следующие подсвойства: «[[:Свойство:Локализатор|Локализатор]]» (например, [[Коптельцев, Валентин|Валентин Коптельцев]] по отношению к [[TADS|TADS 2]] или [[Жучков, Антон|Антон Жучков]] по отношению к [[Twine]]). Также возможны такие подсвойства как «[[:Свойство:Ментейнер|Ментейнер]]», «[[:Свойство:Контрибьютер|Контрибьютер]]», «[[:Свойство:Администратор|Администратор]]», но есть сомнения, что для текущего объёма данных нужна столь мелкая классификация. Следует тщательнее изучить вопрос необходимости подобных подсвойств.
Строка 78: Строка 76:
*# Значения параметра «тип» должны приводить к автоматической вставке соответствующих категорий
*# Значения параметра «тип» должны приводить к автоматической вставке соответствующих категорий
*# Значение «Визуальный редактор» параметра «язык разработки» должно приводить к автоматической вставке категории «[[:Категория:Платформы без программирования|Платформы без программирования]]»
*# Значение «Визуальный редактор» параметра «язык разработки» должно приводить к автоматической вставке категории «[[:Категория:Платформы без программирования|Платформы без программирования]]»
*# Значение «web» параметра «операционные системы» должно приводить к автоматической вставке категории «[[:Категория:Онлайн-платформы|Онлайн-платформы]]».
*# Значение «web» параметра «система» должно приводить к автоматической вставке категории «[[:Категория:Онлайн-платформы|Онлайн-платформы]]».
*# Одновременное наличие значения «Менюшные платформы» или «Парсерные платформы» параметра «тип» и значения «архивное» параметра «состояние» должно приводить к автоматической вставке категории «[[:Категория:Заброшенные платформы|Заброшенные платформы]]», то есть<br>''ЕСЛИ (тип = Менюшные платформы ИЛИ тип = Парсерные платформы) И состояние = архивное ТОГДА вставить Категория:Заброшенные платформы''
*# Одновременное наличие значения «Менюшные платформы» или «Парсерные платформы» параметра «тип» и значения «архивное» параметра «состояние» должно приводить к автоматической вставке категории «[[:Категория:Заброшенные платформы|Заброшенные платформы]]», то есть<br>''ЕСЛИ (тип = Менюшные платформы ИЛИ тип = Парсерные платформы) И состояние = архивное ТОГДА вставить Категория:Заброшенные платформы''
*# В параметре «язык интерфейса» использовать уже существующее свойство «[[:Свойство:Язык|Язык]]», а для параметров «первый выпуск» и «дата последней версии» также уже существующее свойство «[[:Свойство:Дата|Дата]]».
*# В параметре «язык» использовать уже существующее свойство «[[:Свойство:Язык|Язык]]», а для параметров «первый выпуск» и «дата последней версии» также уже существующее свойство «[[:Свойство:Дата|Дата]]».
* Проверить именование всех потенциально задействованных семантических свойств на предмет отсутствия двусмысленности и коллизий.
* Проверить именование всех потенциально задействованных семантических свойств на предмет отсутствия двусмысленности и коллизий.
* В конце ещё раз всё перепроверить и обкатать на нескольких тестовых страницах, после чего начать адаптировать под использование шаблона [[:Категория:Платформы|страницы платформ]] в этой wiki.
* В конце ещё раз всё перепроверить и обкатать на нескольких тестовых страницах, после чего начать адаптировать под использование шаблона [[:Категория:Платформы|страницы платформ]] в этой wiki.

Версия от 14:38, 12 июня 2018

Эта часть ещё не дописана. Вы можете помочь в этом.

Это концепт будущего шаблона для унификации структурированного представления информации о платформах разработки ИЛ, средствах разработки (редакторы, компиляторы), Интернет-ресурсах (информационных и совмещённых с платформами).

Шаблон не готов к использованию. До снятия этой отметки ни в коем случае не пытайтесь его применять на страницах wiki!

Для отслеживания результатов есть страница тестового применения шаблона «TADS Toolchain», за поломки которой никто обижаться не будет.

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

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

Параметры

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

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

Зависимости

Шаблон Product info имеет зависимости со следующими страницами:

To Do

  • Обдумать следующие проблемы:
    1. Свойство «Язык» жёстко привязано к играм. Возможно не самая удачная идея использовать его применительно не к играм в параметре «язык».
    2. У параметров «система» и «язык разработки» предполагаются значения в виде произвольных строк, но при этом есть необходимость реагировать на ключевые слова для автоматической простановке категорий «Онлайн-платформы» и «Платформы без программирования» (см. задачи ниже). Возможно имеет смысл для этих задач ввести отдельные параметры с бинарными значениями этих характеристик.
  • Продумать механизм классификации продуктов типа Z-машины в параметре «тип».
  • Для заполнения параметра «разработчик» создать свойство «Разработчик», а также создать для него следующие подсвойства: «Локализатор» (например, Валентин Коптельцев по отношению к TADS 2 или Антон Жучков по отношению к Twine). Также возможны такие подсвойства как «Ментейнер», «Контрибьютер», «Администратор», но есть сомнения, что для текущего объёма данных нужна столь мелкая классификация. Следует тщательнее изучить вопрос необходимости подобных подсвойств.
  • Для отображения причастности персоналий к тем или иным продуктам создать шаблон «Проекты и разработки», который должен будет добавляться на страницу персоны и в табличной форме выводить информацию, генерируемую по значениям свойства «Разработчик» и его подсвойств, аналогично работе шаблона «Игры автора». Прямое внедрение информации от Product info в шаблон «Игры автора», пожалуй, всё-таки неуместно.
  • Сделать шаблон Product info как таковой со следующими требованиями:
    1. Значения параметра «тип» должны приводить к автоматической вставке соответствующих категорий
    2. Значение «Визуальный редактор» параметра «язык разработки» должно приводить к автоматической вставке категории «Платформы без программирования»
    3. Значение «web» параметра «система» должно приводить к автоматической вставке категории «Онлайн-платформы».
    4. Одновременное наличие значения «Менюшные платформы» или «Парсерные платформы» параметра «тип» и значения «архивное» параметра «состояние» должно приводить к автоматической вставке категории «Заброшенные платформы», то есть
      ЕСЛИ (тип = Менюшные платформы ИЛИ тип = Парсерные платформы) И состояние = архивное ТОГДА вставить Категория:Заброшенные платформы
    5. В параметре «язык» использовать уже существующее свойство «Язык», а для параметров «первый выпуск» и «дата последней версии» также уже существующее свойство «Дата».
  • Проверить именование всех потенциально задействованных семантических свойств на предмет отсутствия двусмысленности и коллизий.
  • В конце ещё раз всё перепроверить и обкатать на нескольких тестовых страницах, после чего начать адаптировать под использование шаблона страницы платформ в этой wiki.

См. обсуждение.