ПивоXML
 | |
| Расширение имени файла |
.xml |
|---|---|
| Тип интернет-СМИ | |
| Единый идентификатор типа (UTI) | public.xml |
| конформация ИМВП | public.text |
| Тип формата | Язык разметки |
| Содержится | XML |
| Расширено с | СГМЛ |
| Стандартный | 1.0 |
| Открытый формат ? | Да |
| Статус | Опубликовано |
|---|---|
| Год начался | 2005 |
| Редакторы | Брэд Смит, Дрю Эвис, Майкл Тейлор, Эндрю Перрон, Дэвид Джонсон |
| Сопутствующие стандарты | XML-схема |
| Домен | Сериализация данных |
| Веб-сайт | ПивоXML |
BeerXML — это бесплатное, полностью определенное XML. описание данных [ 3 ] стандарт предназначен для обмена пивоварения рецептами [ 4 ] и другие пивоваренные данные. Таблицы рецептов, а также другие записи, такие как графики хмеля и счета за солод , могут быть представлены с помощью BeerXML для использования программным обеспечением для пивоварения .
BeerXML — это открытый стандарт , являющийся подмножеством расширяемого языка разметки ( XML ). BeerXML — это язык разметки , определяющий набор правил для кодирования документов в формат , читаемый как человеком, так и машиной .
BeerXML поддерживается рядом веб-сайтов и компьютерных программ. [ 5 ] [ 6 ] и растущее число Android [ 7 ] Windows Телефон [ 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 (с 43 000 зарегистрированных пользователей). Пользователь сайта разработки, обмена и создания рецептов, такого как Brewersfriend.com, может импортировать и экспортировать [ 26 ] BeerXML в мобильные приложения и обратно или введите его в базу данных пивоваренных соревнований. [ 27 ] например, система онлайн-заявки и управления The Brew Competition (BCOE&M).
Принятие BeerXML в качестве стандарта ведет к новым разработкам, таким как базы данных ингредиентов. [ 28 ] которые пытаются стандартизировать определения и характеристики ингредиентов. Пивовары могут использовать такие платформы, как Brewblogger.com, для создания рецептов и регистрации своего пивоваренного дня для публикации в блоге и экспорта в базы данных. [ 29 ] [ 30 ] и распространенные приложения для работы с электронными таблицами . [ 31 ]
Приложения JavaScript, такие как brauhaus.js (разработанные на сайте обмена рецептами Malt.io). [ 32 ] ) позволяют пользователям запускать их на локальном компьютере или в веб-браузере для выполнения через любой веб-браузер, соответствующий стандартам.
Поддерживаемые поля
[ редактировать ]Следующие поля формируют основную информацию структуры BeerXML.
- Рецепты
Recipe name Brewer Brewing method (All grain, Partial Mash, Extract ) Recipe Type (Ale, Lager, Hybrid, etc.) Recipe volume (Run length) Boil volume (Wort size) Boil time (duration) Recipe efficiency Estimated values OG (Original Gravity) FG (Final Gravity) Color (SRM) Bitterness (IBU) Alcohol content (%abv)
- Хмель
Name Origin Description Alpha acids Beta acids Storageability (HSI) Humulene Caryophyllene Cohumulone Myrcene Farsene (not explicitly included in BeerXML v1) Total oil (not explicitly included in BeerXML v1)
В зависимости от рецепта — при добавлении (варка, затирание, первое сусло, сушка и т. д.)
Amount Time (duration)
- Ферментируемые продукты
Name Origin Description Type (Grain, Sugar, etc.) Potential Recommend Mash (true or false) IBU gal/lb (for hopped extract) Color (°Lovibond) Moisture content Protein content Diastatic power (°Lintner) Maximum used (% of grist)
Специальный рецепт
Amount Late Addition (true or false)
- Добавки (называемые MISC для разного в BeerXML v1)
Name Description Type (Fining, Spice, Herb, etc.)
В зависимости от рецепта — при добавлении (варка, первичный и т. д.)
Amount Time (duration)
Name Supplier Catalog number Description Type (Ale, Lager, etc.) Form (Dry, Liquid, etc.) Best for Temperature range Flocculation Attenuation Max reuse
Специальный рецепт
Amount Added to secondary (true or false) Time cultured
Ограничения
[ редактировать ]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» — нет.
Версия
[ редактировать ]Все записи имеют обязательный тег <VERSION>, обозначающий версию стандарта XML. все значения установлены на целое число В настоящее время для этой версии стандарта 1. Предполагается, что будущие версии стандарта будут обратно совместимы со старыми версиями, но тег VERSION позволяет новым программам проверять наличие более высокой версии стандарта или выполнять преобразования, если требуется обратная совместимость.
Форматы данных
[ редактировать ]- Набор записей — специальный тег, который запускает определенный набор данных. Например, XML-таблица, состоящая из набора записей переходов, может начинаться с тега <HOPS>, обозначающего, что это начало записей переходов. После последней записи будет использоваться тег </HOPS>.
- Запись — обозначает тег, который начинает или завершает определенную запись — например, «HOP» может начинать запись о хмеле, а «FERMENTABLE» может начинать запись о ферментируемом продукте.
- Процент — обозначает процент — все проценты выражаются в процентах от 100 — например, 10,4% записывается как «10,4», а не «0,104».
- Список. Данные имеют только фиксированное количество значений, выбранных из списка в таблице описания тега. Эти элементы чувствительны к регистру , и никакие другие значения не допускаются.
- Текст. Данные представляют собой текст в свободном формате. Для многострочных записей разрывы строк будут сохраняться, где это возможно, и текст может быть усечен при импорте, если текст слишком длинный для сохранения программой-импортером. Многострочные записи могут быть разделены либо новой строкой ( Unix формат ), либо комбинацией возврата каретки и новой строки ( формат DOS ). Импортирующие программы должны принимать и то, и другое.
- Логический тип данных. Логический тип данных может иметь значение ИСТИНА или ЛОЖЬ, причем ИСТИНА и ЛОЖЬ написаны заглавными буквами. Для необязательных полей следует указать значение по умолчанию — значение по умолчанию используется, если значение отсутствует.
- Целое число — целое число без десятичной точки . Могут включать отрицательные значения. Примеры: ...-3, -2, -1, 0, 1, 2, 3,...
- Плавающая точка. Число с плавающей запятой , обычно выражаемое в простейшей форме с десятичной точкой, например «1,2», «0,004» и т. д. Программы должны стараться хранить как можно больше значащих цифр, чтобы избежать усечения или потери небольших значений. .
Единицы
[ редактировать ]Все агрегаты фиксированы. В обязанности программы импорта или экспорта входит преобразование в приведенные ниже единицы измерения и обратно, если это необходимо.
- Единицы веса
- Все веса измеряются в килограммах (кг). Для небольших значений программа экспорта постарается сохранить как больше значащих цифр . можно
- Единицы объема
- Все объемы измеряются в литрах (л). Для небольших значений программа экспорта постарается сохранить как можно больше значащих цифр.
- Единицы температуры
- Все температуры измеряются в градусах Цельсия .
- Единицы удельного веса
- Удельный вес измеряется относительно веса образца воды того же размера . Например, «1,035», «1,060» и так далее.
- Единицы измерения давления
- Давление измеряется в килопаскалях (кПа).
Нестандартные теги
[ редактировать ]Согласно стандарту XML, все нестандартные теги должны игнорироваться программой импорта. Это позволяет реализации при желании хранить дополнительную информацию, используя собственные теги. Любые теги, не определенные как часть этого стандарта, могут безопасно игнорироваться программой-импортером.
Дополнительные теги
[ редактировать ]Дополнительное «Приложение А» добавляет теги для использования при отображении данных о пивоварении с использованием таблиц стилей XML или генераторов отчетов, совместимых с XML . Поскольку теги в приложении предназначены только для отображения и могут включать округленные значения и различные единицы измерения. Эти теги приложения предназначены для отображения, а не для импорта данных.
См. также
[ редактировать ]
- Измерение пива
- Пивоварение
- Гравитация (алкогольный напиток)
- Домашнее пивоварение
- Хмель
- Смешайте ингредиенты
Ссылки
[ редактировать ]- ^ Сен-Лоран, Симон; Макото, Мурата; Кон, Дэн (январь 2001 г.). «Типы носителей XML, RFC 3023» . Рабочая группа по интернет-инжинирингу. стр. 9–11 . Проверено 4 января 2010 г.
- ^ Сен-Лоран, Симон; Макото, Мурата; Кон, Дэн (январь 2001 г.). «Типы носителей XML, RFC 3023» . Рабочая группа по интернет-инжинирингу. стр. 7–9 . Проверено 4 января 2010 г.
- ^ «BeerXML — стандарт XML для данных пивоварения, версия 1.0» . BeerXML.com . Группа BeerXML . Проверено 14 февраля 2014 г.
- ^ Джонстон, Кейси (10 октября 2013 г.). «Компьютеризированная пивоварня избавит вас от работы по домашнему пивоварению» . CNN.com . CNN/Тернер . Проверено 15 февраля 2014 г.
- ^ Ревелл, Мэтью. «Пиво как пиво» . launchpad.net . Панель запуска . Проверено 19 февраля 2014 г.
- ^ «Обновление: JolieBulle 2.9 — Импорт списка ингредиентов. Теперь можно импортировать список ингредиентов в формате BeerXML» (на французском языке). Tuxfamily.org . Проверено 15 февраля 2014 г.
- ^ «Приложения BeerXML в Google Play» . Проверено 11 февраля 2014 г.
- ^ «Карманный пивовар Windows Phone BeerXML» . Карманный пивовар . Проверено 14 февраля 2014 г.
- ^ Паркер, Дэвид. «Приложение для составления рецептов для iOS» . Программное обеспечение DJP . Проверено 15 февраля 2014 г.
- ^ Гриффит, Уильям. «Помощник по домашнему пивоварению» . homebrewassistant.com . Магазин iTunes . Проверено 15 февраля 2014 г.
- ^ Палмер, Брайан. «BeerXML в RubyGems» . Рубиновые драгоценности . Проверено 15 февраля 2014 г.
- ^ Спрингер, Дерек. «Шорткод BeerXML для WordPress» . WordPress.org . WordPress . Проверено 15 февраля 2014 г.
- ^ Хотеллинг, Джордж. «Парсер и генератор PHP BeerXML» . Гитхаб . Проверено 15 февраля 2014 г.
- ^ Тейлор, Дэниел Г. «Плагин импорта и экспорта BeerXML для Brauhaus.js» . Гитхаб . Проверено 15 февраля 2014 г.
- ^ Ингрэм, Натан (2 октября 2013 г.). «PicoBrew Zymatic — это Nespresso в пивоварении» . Вокс Медиа . Грань . Проверено 15 февраля 2014 г.
- ^ Тайсон, Марк (октябрь 2013 г.). «Бывшие руководители Microsoft запускают на Kickstarter устройство для приготовления пива» . Гексус . HEXUS.net — независимый веб-сайт новостей и обзоров технологий номер один в Великобритании . Проверено 15 февраля 2014 г.
- ^ Кейси, Джонстон (октябрь 2013 г.). «Компьютеризированная пивоварня избавляет от необходимости заниматься домашним пивоварением» . arstechnica.com . arstechnica.com/gadgets/2013/10/a-computerized-beer-machine-takes-the-legwork-out-of-home-brewing/ . Проверено 14 февраля 2014 г.
- ^ «BeerXML2BrewTroller beta — Загрузите BeerXML на свой BrewTroller» . SourceForge.net. 30 мая 2013 года . Проверено 15 февраля 2014 г.
- ^ Вольф, Майкл. «Вот маленькая коробочка, которая может навсегда изменить мир пива» . Medium.com . Проверено 15 февраля 2014 г.
- ^ «Страница рекомендаций Brew Competition BeerXML» . Проверено 11 февраля 2014 г.
- ^ «Микро-пивоварня 3BBL» . Bru-Gear.com . ООО БрюГир. Архивировано из оригинала 22 февраля 2014 года . Проверено 15 февраля 2014 г.
- ^ «Страница Brew Monkey BeerXML» . Brew-monkey.com.
- ^ «Брютарджет» . сайт gitorious.org . Гиториозный. Архивировано из оригинала 21 февраля 2014 года . Проверено 15 февраля 2014 г.
- ^ «Статья на Linux.com о Brewtarget» . Linux.com . Проверено 14 февраля 2014 г.
- ^ «Статистика пользователей Brewtoad» . Brewtoad.com. Архивировано из оригинала 9 февраля 2014 г. Проверено 14 февраля 2014 г.
- ^ «Часто задаваемые вопросы о друзьях пивоваров» . Сайт BrewersFriend.com.
- ^ «Руководство BrewCompetition.com BeerXML» . Система онлайн-заявки и управления пивоваренным конкурсом (BCOE&M).
- ^ «Проект базы данных пива» . BeerDB.org.
- ^ «Система баз данных по пивоварению» . Пивоварня Твин Хиллз. Архивировано из оригинала 22 февраля 2014 года . Проверено 14 февраля 2014 г.
- ^ Перетто, Брайан (6 января 2014 г.). «База данных рецептов пивоварения BeerXML на базе PHP» . СоурсФордж . Проверено 15 февраля 2014 г.
- ^ «Набор функций Brewblogger» . Платформа Brew Blogger.
- ^ Тейлор, Дэниел Г. «Новая версия brauhaus.js» . Мальт.io. Архивировано из оригинала 22 февраля 2014 года . Проверено 15 февраля 2014 г.
- ^ «Знаете ли вы, что можно импортировать и экспортировать рецепты через BeerXML?» . ibrewmaster.com . iBrewmaster. Архивировано из оригинала 21 февраля 2014 года . Проверено 15 февраля 2014 г.
- ^ «Поддерживаемые модули — Руководство пользователя Brewtarget 2.02» . Брютаргет . Проверено 15 февраля 2014 г.
- ^ «Предложение схемы BeerXML 2» . Форум разработчиков BeerXML . BeerXML.com . Проверено 14 февраля 2014 г.
Внешние ссылки
[ редактировать ]