BeerXML

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

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

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

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

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

Многие производители пивоваренного оборудования включают BeerXML в свои системы и Сторонние плагины и патчи разрабатываются для оборудования управления пивоварением и встроенных систем, позволяющих автоматизировать и точно контролировать такие процессы, как затирание и потенциально ферментация.

Содержание
  • 1 Общие приложения и примеры использования
  • 2 Поддерживаемые поля
  • 3 Ограничения
  • 4 Разработка
  • 5 XML-заголовок
  • 6 Имена тегов
  • 7 Версия
  • 8 Форматы данных
  • 9 единиц
  • 10 нестандартных тегов
  • 11 Дополнительные теги
  • 12 См. Также
  • 13 Ссылки
  • 14 Внешние ссылки
Общие приложения и примеры использования

BeerXML используется как в любительском, так и в профессиональном пивоварении и облегчает обмен данными о пивоварении через Интернет. Пользователи различных приложений, таких как программное обеспечение с открытым исходным кодом Brewtarget (с более чем 52 000 загрузок), могут обмениваться данными через XML с пользователями популярных проприетарных программ, таких как Beersmith и ORRTIZ: BMS 4 Breweries или загрузите свои данные для обмена на совместимых с BeerXML сайтах обмена и облачных платформах, таких как Brewtoad (более 50 000 зарегистрированных пользователей) или Beersmith Recipe Cloud (с 43 000 зарегистрированных пользователей). Пользователь сайта разработки рецептов, обмена и создания, такого как Brewersfriend.com, может импортировать и экспортировать BeerXML в мобильные приложения и из них или ввести его в базу данных пивоваренного конкурса, такую ​​как система онлайн-входа и управления Brew Competition (BCOE M).

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

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

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

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

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

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

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

в зависимости от рецепта

Количество запоздалого добавления (истина или ложь)
  • Добавки (в BeerXML v1 называется MISC для разного)
Название Описание Тип (Очищение, специи, травы и т. Д.)

Зависит от рецепта - при добавлении (кипячение, первичное и т. Д.)

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

Дрожжи

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

Зависит от рецепта

Количество, добавленное ко вторичному (истинному или ложному) времени культивирование 
Ограничения

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

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

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

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

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

Разработка

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

Заголовок XML

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

Пример обязательного XML-заголовка с тегом Recipes :

Имена тегов

Имена тегов всегда в верхнем регистре. Например, «HOP» приемлем, но «прыжок» и «прыжок» - нет.

Версия

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

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

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

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

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

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

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

См. Также
  • значок Портал пива
Ссылки
Внешние ссылки
В Викиучебнике есть книга по теме: Тема: XML
В Викиучебнике есть книга по теме: Тема: Пивоварение
Последняя правка сделана 2021-05-12 09:34:52
Содержание доступно по лицензии CC BY-SA 3.0 (если не указано иное).
Обратная связь: support@alphapedia.ru
Соглашение
О проекте