ПивоXML - BeerXML

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

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

BeerXML - это открытый стандарт и как подмножество из расширяемый язык разметки (XML). BeerXML - это язык разметки который определяет набор правил для кодирования документов в формат это оба человек читаемый и машиночитаемый.

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

Плагины и расширения, поддерживающие BeerXML, были написаны для множества платформ, включая Рубин через 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 и ОРРТИЗ: BMS 4 Breweries или загружать свои данные для совместного использования на совместимых с BeerXML сайтах обмена и облачных платформах, таких как Brewtoad (более 50 000 зарегистрированных пользователей[25] ) или Beersmith Recipe Cloud (с 43 000 зарегистрированных пользователей). Пользователь сайта по разработке рецептов, обмена и создания, такого как Brewersfriend.com, может импортировать и экспортировать[26] BeerXML в мобильные приложения и обратно или внесите его в базу данных конкурсов пивоварения.[27] например, система онлайн-регистрации и управления пивоваренным конкурсом (BCOE & M).

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

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

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

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

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

В зависимости от рецепта - при добавлении (отваривание, затор, первое сусло, сушка и т. Д.)

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

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

   Сумма позднее добавление (правда или ложь)
  • Добавки (называемые MISC для разного в BeerXML v1)
   Имя Описание Тип (Штраф, Специи, травы и т. Д.)

Конкретный рецепт - При добавлении (Варка, Первичный и т. Д.)

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

Дрожжи

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

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

   Сумма, добавленная к вторичному (истинному или ложному) времени культурный

Ограничения

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

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

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

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

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

Развитие

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

Заголовок XML

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

Требуемый пример заголовка XML с рецептами тег:

<?xml version="1.0" encoding="UTF-8"?><RECIPES>  …</RECIPES>

Имена тегов

Имена тегов всегда верхний регистр. Например, "HOP" приемлемо, но "hop" и "Hop" - нет.

Версия

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

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

  • Набор записей - специальный тег, который запускает определенный набор данных. Например, таблица XML, состоящая из набора записей переходов, может начинаться с тега , чтобы обозначить, что это начало записей переходов. После последней записи будет использоваться тег .
  • Запись - обозначает тег, который запускает или завершает конкретную запись - например, «HOP» может запускать запись переходов, или «FERMENTABLE» может запускать ферментируемую запись.
  • Процент - обозначает процент - все проценты выражаются в процентах из 100 - например, 10,4% записывается как «10,4», а не «0,104»
  • Список - данные содержат только фиксированное количество значений, которые выбираются из списка в таблице описания для тега. Эти предметы чувствительный к регистру, и никакие другие значения не допускаются.
  • Текст - данные представляют собой текст в произвольном формате. Для многострочных записей разрывы строк будут сохранены, где это возможно, и текст может быть усеченный при импорте, если текст слишком длинный для сохранения программой импорта. Многострочные записи могут быть разделены новая линия (Unix формат) или возврат каретки - комбинация новой строки (ДОС формат). Импортирующие программы тоже должны принимать.
  • Логическое значение - The Логический тип данных может иметь значение ИСТИНА или ЛОЖЬ, с заглавными буквами ИСТИНА и ЛОЖЬ. Для необязательных полей следует указать значение по умолчанию - используется значение по умолчанию, если значение отсутствует.
  • Целое число - целое число без десятичная точка. Может включать отрицательные значения - примеры включают ...- 3, -2, -1, 0, 1, 2, 3, ...
  • Плавающая точка - A плавающая точка число, обычно выражаемое в простейшей форме с десятичной точкой, например, «1,2», «0,004» и т. д. Программы должны стремиться хранить как можно больше значащих цифр, чтобы избежать усечения или потери малых значений.

Единицы

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

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

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

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

Дополнительные теги

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

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

использованная литература

  1. ^ «Типы носителей XML, RFC 3023». Инженерная группа Интернета. Январь 2001. С. 9–11.. Получено 2010-01-04.
  2. ^ «Типы носителей XML, RFC 3023». Инженерная группа Интернета. Январь 2001. С. 7–9.. Получено 2010-01-04.
  3. ^ "BeerXML - стандарт XML для данных пивоварения, версия 1.0". BeerXML.com. Группа BeerXML. Получено 14 февраля 2014.
  4. ^ Джонстон, Кейси. "Компьютеризированная пивоваренная машина избавляет от лишних хлопот домашнее пивоварение". CNN.com. CNN / Тернер. Получено 15 февраля 2014.
  5. ^ Ревелл, Мэтью. «Пиво как в пиве». launchpad.net. Панель запуска. Получено 19 февраля 2014.
  6. ^ "Mise à jour: JolieBulle 2.9 - Importing d'une liste d'ingrédients. Il est maintenant possible d'importer une liste d'ingrédients au format BeerXML" (На французском). Tuxfamily.org. Получено 15 февраля 2014.
  7. ^ "Приложения BeerXML в Google Play". Google. Получено 11 февраля 2014.
  8. ^ "Карманный пивовар Windows Phone BeerXML". Карманный пивовар. Получено 14 февраля 2014.
  9. ^ Паркер, Дэвид. «Приложение для рецептов для iOS». Программное обеспечение DJP. Получено 15 февраля 2014.
  10. ^ Гриффит, Уильям. «Помощник по домашнему пивоварению». homebrewassistant.com. ITunes магазин. Получено 15 февраля 2014.
  11. ^ Палмер, Брайан. "BeerXML в RubyGems". Рубиновые Самоцветы. Получено 15 февраля 2014.
  12. ^ Спрингер, Дерек. «Шорткод BeerXML для WordPress». WordPress.org. WordPress. Получено 15 февраля 2014.
  13. ^ Хотеллинг, Джордж. "Парсер и генератор PHP BeerXML". GitHub. Получено 15 февраля 2014.
  14. ^ Тейлор, Дэниел Г. "Плагин импорта и экспорта BeerXML для Brauhaus.js". GitHub. Получено 15 февраля 2014.
  15. ^ Ингрэм, Натан. «PicoBrew Zymatic - это Nespresso пивоварения». Vox Media. Грани. Получено 15 февраля 2014.
  16. ^ Тайсон, Марк. «Бывшие руководители Microsoft запускают устройство для приготовления пива на Kickstarter». Hexus. HEXUS.net - это ведущий британский независимый сайт новостей и обзоров в области технологий.. Получено 15 февраля 2014.
  17. ^ Кейси, Джонстон. "Компьютеризированная пивоваренная машина избавляет от лишних хлопот домашнее пивоварение". 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. Получено 15 февраля 2014.
  19. ^ Волк, Майкл. "Вот маленькая коробочка, которая может навсегда изменить пивной мир". medium.com. Получено 15 февраля 2014.
  20. ^ "Страница рекомендаций по пивоварению BeerXML". Получено 11 февраля 2014.
  21. ^ "Пивоварня 3BBL Micro". Bru-Gear.com. BruGear LLC. Архивировано из оригинал 22 февраля 2014 г.. Получено 15 февраля 2014.
  22. ^ "Сварить пиво обезьяныXML". brew-monkey.com.
  23. ^ "Brewtarget". gitorious.org. Великолепно. Архивировано из оригинал 21 февраля 2014 г.. Получено 15 февраля 2014.
  24. ^ "Статья Linux.com о Brewtarget". Linux.com. Получено 14 февраля 2014.
  25. ^ "Статистика пользователей Brewtoad". Brewtoad.com. Архивировано из оригинал на 2014-02-09. Получено 2014-02-14.
  26. ^ "FAQ Друг пивовара". Brewersfriend.com.
  27. ^ "Рекомендации BrewCompetition.com BeerXML". Система онлайн-входа и управления Brew Competition (BCOE & M).
  28. ^ "Проект пивной базы данных". BeerDB.org.
  29. ^ «Система базы данных пивоварения». Пивоварня Twin Hills. Архивировано из оригинал 22 февраля 2014 г.. Получено 14 февраля 2014.
  30. ^ Перетто, Брайан. "База данных рецептов пивоварения 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.

внешние ссылки