ПивоXML
Язык разметки
ПивоXML
Расширение имени файла
.xml
Тип интернет-СМИ
application/xml[1]
text/xml[2]
Единый идентификатор типа (UTI)public.xml
Конформация ИМПпубличный.текст
Тип форматаЯзык разметки
Содержится вXML
Расширенный отСГМЛ
Стандарт1.0
Открытый формат ?Да
ПивоXML
СтатусОпубликовано
Год начался2005
РедакторыБрэд Смит, Дрю Эвис, Майкл Тейлор, Эндрю Перрон, Дэвид Джонсон
Сопутствующие стандартыXML-схема
ДоменСериализация данных
Веб-сайтПивоXML

BeerXML — это бесплатный, полностью определенный стандарт описания данных XML [3] , разработанный для обмена рецептами пивоварения [ 4] и другими данными пивоварения . Таблицы рецептов, а также другие записи, такие как графики хмеля и солодовые счета, могут быть представлены с помощью BeerXML для использования программным обеспечением для пивоварения .

BeerXML — это открытый стандарт , являющийся подмножеством языка разметки Extensible Markup Language ( XML ). BeerXML — это язык разметки , который определяет набор правил для кодирования документов в формате , который может быть как понятен человеку, так и понятен машине .

BeerXML поддерживается рядом веб-сайтов, компьютерных программ [5] [6] и все большим числом приложений для Android [7], Windows Phone [8] и iOS. [9] [10]

Плагины и расширения, поддерживающие BeerXML, были написаны для различных платформ, включая Ruby через RubyGems , [11] WordPress , [12] PHP [13] и JavaScript [14].

Многие производители оборудования для пивоварения включают BeerXML в свои системы [15] [16] [17] , а сторонние плагины и исправления разрабатываются для оборудования управления пивоваренными заводами и встроенных систем [18], что позволяет автоматизировать и точно контролировать и синхронизировать такие процессы, как затирание [19] и, возможно, брожение .

Распространенные приложения и примеры использования

BeerXML используется как в любительском [20] , так и в профессиональном [21] пивоварении и облегчает обмен данными о пивоварении через Интернет . [22] Пользователи различных приложений, таких как программное обеспечение с открытым исходным кодом [23] Brewtarget (более 52 000 загрузок [24] ), могут обмениваться данными через XML с пользователями популярного фирменного программного обеспечения, такого как Beersmith и ORRTIZ: BMS 4 Breweries, или загружать свои данные для обмена на совместимых с BeerXML сайтах обмена и облачных платформах, таких как Brewtoad (более 50 000 зарегистрированных пользователей [25] ) или Beersmith Recipe Cloud (с 43 000 зарегистрированных пользователей). Пользователь сайта по разработке, обмену и созданию рецептов, такого как Brewersfriend.com, может импортировать и экспортировать [26] BeerXML в мобильные приложения и из них или вводить его в базу данных соревнований по пивоварению [27], такую ​​как система The Brew Competition Online Entry & Management (BCOE&M).

Принятие BeerXML в качестве стандарта ведет к новым разработкам, таким как базы данных ингредиентов [28] , которые пытаются стандартизировать определения и характеристики ингредиентов. Пивовары могут использовать платформы, такие как Brewblogger.com, для создания рецептов и регистрации своего дня пивоварения для публикации в блоге и для экспорта в базы данных [29] [30] и общие приложения электронных таблиц . [31]

Приложения JavaScript, такие как brauhaus.js (разработанные на основе сайта обмена рецептами Malt.io [32] ), позволяют пользователям запускать их на локальном компьютере или в веб-браузере для выполнения через любой веб-браузер, соответствующий стандартам.

Поддерживаемые поля

Следующие поля формируют основную информацию структуры BeerXML

  • Рецепты
 Название рецепта Пивовар Метод заваривания (цельное зерно, частичное затирание, экстракт ) Тип рецепта ( эль , лагер , гибрид и т. д.) Объем рецепта (Продолжительность цикла) Объем кипячения ( размер сусла ) Время кипения (продолжительность) Эффективность рецепта Оценочные значения OG ( Оригинальная гравитация ) FG ( Конечная плотность ) Цвет (SRM) Горечь ( IBU ) Содержание алкоголя (%abv)
  • Хмель
 Имя Источник Описание Альфа-кислоты Бета-кислоты Сохраняемость (HSI) Гумулен  Кариофиллен  Когумулон  Мирцен Farsene (явно не включен в BeerXML v1) Общее количество масла (не включено явно в BeerXML v1)

Зависит от рецепта — когда добавляется (кипячение, затирание, первое сусло, сушка и т. д.)

 Количество Время (продолжительность)
  • Ферментируемые вещества
 Имя Источник Описание Тип (зерно, сахар и т.д.) Потенциал Рекомендовать Mash (правда или ложь) IBU галлон/фунт (для охмеленного экстракта) Цвет (° Ловибонда ) Содержание влаги Содержание белка Диастатическая сила ( °Линтнера ) Максимальное использование (% помола )

Конкретный рецепт

 Количество Позднее добавление (правда или ложь)
  • Добавки (в BeerXML v1 они называются MISC для «разное»)
 Имя Описание Тип ( осветление , специи, травы и т. д.)

В зависимости от рецепта — когда добавляется (кипячение, первичное приготовление и т. д.)

 Количество Время (продолжительность)

Дрожжи

 Имя Поставщик Номер по каталогу Описание Тип (Эль, Лагер и т.д.) Форма (сухая, жидкая и т.д.) Лучше всего подходит для Диапазон температур  Ослабление флокуляции Максимальное повторное использование

Конкретный рецепт

 Количество Добавлено к вторичному (истина или ложь) Время культивировалось

Ограничения

BeerXML 1.0 поддерживает не более трех этапов ферментации. [33] Хотя это не является ограничением в реальном мире для многих пивоваров, оно вносит несоответствие, когда программный инструмент или веб-сервис, который допускает несколько или неограниченное количество этапов ферментации, хочет реализовать BeerXML как механизм импорта/экспорта. Например, когда инструкция графика ферментации для подачи при 21 градусе Цельсия , позволяет снизиться до 17 в течение трех дней, а затем понижает на 1 градус в день, пока сусло не достигнет 10 градусов, выдерживать в течение 12 дней перед переливом для созревания. Это не могло быть учтено в формальной структуре, требующей использования неформальных/необязательных и немашиночитаемых полей.

Все единицы преобразуются в единицы СИ внутри. В результате теряется точность при преобразовании единиц, не входящих в СИ, будь то имперские, американские традиционные или метрические. [ необходимо разъяснение ]

В текущем определении вклад хмелевого масла в медь явно не поддерживается.

Уровни фарсена явно не поддерживаются в текущем определении.

Не делается различий между весом и массой [34]

Разработка

Стандарт BeerXML имеет предложенную вторую версию, которая обсуждалась и находится в стадии разработки. Она не была проверена или опубликована, поскольку ее набор функций все еще находится в стадии обсуждения. [35]

XML-заголовок

Как и в XML, все файлы начинаются со строки заголовка в качестве первой строки. После заголовка XML должен начинаться набор записей (например <RECIPES>…</RECIPES>, или <HOPS> … </HOPS>).

Пример требуемого заголовка XML с тегом Recipes :

<?xml версия="1.0" кодировка="UTF-8"?> <РЕЦЕПТЫ  > … </РЕЦЕПТЫ>

Имена тегов

Имена тегов всегда пишутся заглавными буквами . Например, «HOP» допустимо, но «hop» и «Hop» — нет.

Версия

Все записи имеют обязательный тег <VERSION>, который обозначает версию стандарта XML. В настоящее время все установлены на целое число 1 для этой версии стандарта. Предполагается, что будущие версии стандарта будут обратно совместимы со старыми версиями, но тег VERSION позволяет новым программам проверять наличие более высокой версии стандарта или выполнять преобразования, если это необходимо для обратной совместимости.

Форматы данных

  • Record Set – специальный тег, который начинает определенный набор данных. Например, таблица XML, состоящая из набора записей о прыжках, может начинаться с тега <HOPS>, чтобы обозначить, что это начало записей о прыжках. После последней записи будет использоваться тег </HOPS>.
  • Запись — обозначает тег, который начинает или заканчивает определенную запись, например, «HOP» может начинать запись о хмеле, а «FERMENTABLE» может начинать запись о ферментируемом продукте.
  • Процент - обозначает процент - все проценты выражаются в процентах от 100 - например, 10,4% записывается как «10,4», а не «0,104».
  • Список - Данные имеют только фиксированное количество значений, которые выбираются из списка в таблице описания для тега. Эти элементы чувствительны к регистру , и никакие другие значения не допускаются.
  • Текст — данные имеют свободный формат текста. Для многострочных записей переносы строк будут сохранены, где это возможно, и текст может быть обрезан при импорте, если текст слишком длинный для сохранения импортирующей программой. Многострочные записи могут быть разделены либо новой строкой ( формат Unix ), либо комбинацией возврата каретки и новой строки ( формат DOS ). Импортирующие программы должны принимать любой из них.
  • Boolean - тип данных Boolean может быть TRUE или FALSE, с TRUE и FALSE заглавными буквами. Для необязательных полей должно быть указано значение по умолчанию - значение по умолчанию используется, если значение отсутствует.
  • Целое число — целое число без десятичной точки . Может включать отрицательные значения — примеры включают ...-3, -2, -1, 0, 1, 2, 3,...
  • Плавающая точка — число с плавающей точкой , обычно выражаемое в простейшей форме десятичной точкой, например «1,2», «0,004» и т. д. Программы должны стремиться хранить как можно больше значащих цифр, чтобы избежать усечения или потери небольших значений.

Единицы

Все единицы фиксированы. Импортирующая или экспортирующая программа несет ответственность за конвертацию в единицы, указанные ниже, и из них, если это необходимо.

Единицы веса
Все веса измеряются в килограммах (кг). Для небольших значений программа экспорта постарается сохранить как можно больше значимых цифр .
Единицы измерения объема
Все объемы измеряются в литрах (л). Для небольших значений программа экспорта постарается сохранить как можно больше значимых цифр.
Единицы измерения температуры
Все температуры измеряются в градусах Цельсия .
Единицы времени
Все значения времени указаны в минутах или их долях , если иное не указано в описании тега.
Единицы удельного веса
Удельный вес измеряется относительно веса образца воды того же размера . Например, «1,035», «1,060» и т. д.
Единицы измерения давления
Давление измеряется в килопаскалях (кПа).

Нестандартные теги

Согласно стандарту XML, все нестандартные теги должны игнорироваться импортирующей программой. Это позволяет реализации сохранять дополнительную информацию, если это необходимо, используя собственные теги. Любые теги, не определенные как часть этого стандарта, могут быть безопасно проигнорированы импортирующей программой.

Необязательные теги

Необязательное «Приложение A» добавляет теги для использования при отображении данных пивоварения с использованием таблиц стилей XML или генераторов отчетов, совместимых с XML . Поскольку теги в приложении предназначены только для отображения и могут включать округленные значения и различные единицы измерения, эти теги приложения предназначены для отображения, а не для импорта данных.

Смотрите также

Ссылки

  1. ^ St. Laurent , Simon; Makoto, Murata; Kohn, Dan (январь 2001 г.). "XML Media Types, RFC 3023". Internet Engineering Task Force. стр.  9–11 . Получено 04.01.2010 .
  2. ^ St. Laurent, Simon; Makoto, Murata; Kohn, Dan (январь 2001 г.). "XML Media Types, RFC 3023". Internet Engineering Task Force. стр.  7–9 . Получено 04.01.2010 .
  3. ^ "BeerXML — стандарт XML для данных по пивоварению, версия 1.0". BeerXML.com . Группа BeerXML . Получено 14 февраля 2014 г. .
  4. ^ Джонстон, Кейси (10 октября 2013 г.). «Компьютеризированная пивная машина упрощает домашнее пивоварение». CNN.com . CNN/Turner . Получено 15 февраля 2014 г. .
  5. ^ Ревелл, Мэтью. «Пиво как в пиве». launchpad.net . Launchpad . Получено 19 февраля 2014 г. .
  6. ^ «Mise à jour: JolieBulle 2.9 — Импорт списка ингредиентов. Это возможность импорта списка ингредиентов в формате BeerXML» (на французском языке). Tuxfamily.org . Проверено 15 февраля 2014 г.
  7. ^ "Приложения BeerXML в Google Play" . Получено 11 февраля 2014 г.
  8. ^ "Pocket Brewer Windows Phone BeerXML". The Pocket Brewer . Получено 14 февраля 2014 г.
  9. ^ Паркер, Дэвид. "Приложение для составления рецептов для iOS". DJP Software . Получено 15 февраля 2014 г.
  10. ^ Гриффит, Уильям. "HomeBrew Assistant". homebrewassistant.com . iTunes Store . Получено 15 февраля 2014 г. .
  11. ^ Палмер, Брайан. "BeerXML At RubyGems". Ruby Gems . Получено 15 февраля 2014 г.
  12. ^ Спрингер, Дерек. "BeerXML Shortcode For WordPress". WordPress.org . WordPress . Получено 15 февраля 2014 г. .
  13. ^ Хотеллинг, Джордж. "Парсер и генератор PHP BeerXML". GitHub . Получено 15 февраля 2014 г.
  14. ^ Тейлор, Дэниел Г. "Плагин импорта и экспорта BeerXML для Brauhaus.js". GitHub . Получено 15 февраля 2014 г.
  15. ^ Ингрэм, Натан (2 октября 2013 г.). «PicoBrew Zymatic — это Nespresso в пивоварении». Vox Media . The Verge . Получено 15 февраля 2014 г.
  16. ^ Тайсон, Марк (октябрь 2013 г.). «Ex-Microsoft execs launch beer making device on Kickstarter». Hexus . HEXUS.net — независимый сайт новостей и обзоров технологий номер один в Великобритании . Получено 15 февраля 2014 г.
  17. ^ Кейси, Джонстон (октябрь 2013 г.). «Компьютеризированная пивная машина избавляет от необходимости заниматься домашним пивоварением». arstechnica.com . arstechnica.com/gadgets/2013/10/a-computerized-beer-machine-takes-the-legwork-out-of-home-brewing/ . Получено 14 февраля 2014 г.
  18. ^ "BeerXML2BrewTroller beta - Загрузите BeerXML на свой BrewTroller". SourceForge.net. 30 мая 2013 г. Получено 15 февраля 2014 г.
  19. ^ Вольф, Майкл. «Вот маленькая коробочка, которая может навсегда изменить мир пива». medium.com . Получено 15 февраля 2014 г.
  20. ^ "Страница советов Brew Competition BeerXML" . Получено 11 февраля 2014 г. .
  21. ^ "3BBL Micro Brewery". Bru-Gear.com . BruGear LLC. Архивировано из оригинала 22 февраля 2014 года . Получено 15 февраля 2014 года .
  22. ^ "Страница Brew Monkey BeerXML". brew-monkey.com.
  23. ^ "Brewtarget". gitorious.org . Gitorious. Архивировано из оригинала 21 февраля 2014 года . Получено 15 февраля 2014 года .
  24. ^ "Статья Linux.com о Brewtarget". Linux.com . Получено 14 февраля 2014 г. .
  25. ^ "Brewtoad User Stats". Brewtoad.com. Архивировано из оригинала 2014-02-09 . Получено 2014-02-14 .
  26. ^ «Часто задаваемые вопросы о Brewer's Friend». Brewersfriend.com.
  27. ^ "BrewCompetition.com BeerXML guidelines". Система онлайн-регистрации и управления конкурсом Brew Competition (BCOE&M).
  28. ^ «Проект базы данных пива». BeerDB.org.
  29. ^ "Brewthology database system". Пивоварня Twin Hills. Архивировано из оригинала 22 февраля 2014 года . Получено 14 февраля 2014 года .
  30. ^ Peretto, Bryan (6 января 2014 г.). "База данных рецептов пивоварения BeerXML на основе PHP". SourceForge . Получено 15 февраля 2014 г.
  31. ^ "Набор функций Brewblogger". Платформа Brew Blogger.
  32. ^ Тейлор, Дэниел Г. "Новый релиз brauhaus.js". Malt.io. Архивировано из оригинала 22 февраля 2014 года . Получено 15 февраля 2014 года .
  33. ^ «Знаете ли вы, что можно импортировать и экспортировать рецепты через BeerXML?». ibrewmaster.com . iBrewmaster. Архивировано из оригинала 21 февраля 2014 г. . Получено 15 февраля 2014 г. .
  34. ^ "Поддерживаемые устройства - Руководство пользователя Brewtarget 2.02". Brewtarget . Получено 15 февраля 2014 г. .
  35. ^ "Предложение схемы BeerXML 2". Форум разработчиков BeerXML . BeerXML.com . Получено 14 февраля 2014 г.
В Wikibooks есть книга по теме: Тема:XML
В Wikibooks есть книга по теме: Тема:Пивоварение
  • Домашняя страница BeerXML
  • Спецификация BeerXML 1.0
  • Парсер и генератор PHP BeerXML
  • WordPress плагин BeerXML
  • Библиотека Ruby для парсинга и генерации beerxml
  • Плагин BeerXML для Wordpress с коротким кодом от FiveBlades
Взято с "https://en.wikipedia.org/w/index.php?title=BeerXML&oldid=1260971153"