Спецификации OPML 1.0
Внешний язык маркирования процессоров
Спецификации OPML 1.0 |
|
|
Внешний язык маркирования процессоров
|
Дэйв Винер для UserLand. 9/15/00 DW
Французский перевод Дени Суро для .fr Спецификации на английском языке.
В этой спецификации описывается формат OPML 1.0, который теперь заменен OPML 2.0, но с этим форматом можно познакомиться в документах OPML.
В этом документе описывается формат для хранения планов в XML 1.0 под названием Outline Processor Markup Language или OPML (на французском языке - Tags de Processor de Plan).
Для целей этого документа план представляет собой дерево, где каждый узел содержит набор именованных атрибутов со значениями строк.
Аутсайл (или план) уже давно является обычным способом организации информации на компьютерах. Даже если история с плановым софтом неясна, возможен проект истории.
Первый плановый софт был разработан Дагом Энгельбартом, как часть его системы Augment в 60-х годах.
Living Videotext в 1981-87 годах разработала несколько плановых программ для персональных компьютеров. Их архивируют на сайте UserLand, outliners.
Frontier, распространение которого началось в 1992 году, строится на создании плана. Текстовые редакторы, меню и сценарии в Frontier - это плановое программное обеспечение, а также браузер базы данных объектов.
XML 1.0, формат, на котором основан OPML, является рекомендацией W3C.
Radio UserLand, распространение которого началось в марте 2001 года, - плановое программное обеспечение с собственным форматом файлов в OPML.
OPML используется для каталогов в Manila.
Планы могут использоваться для спецификаций, юридических отчетов, планирования продуктов, презентаций, сценариев, каталогов, личных журналов, дискуссионных групп, чатов и романов.
Плановое программное обеспечение - это программы для чтения, редактирования и реорганизации планов.
В качестве примеров документов OPML: play-лист, спецификации, презентация.
Цель этого формата заключается в том, чтобы обеспечить способ обмена информацией между плановым программным обеспечением и услугами Интернета, на которые можно ориентироваться и которые можно контролировать с помощью планового программного обеспечения.
Идея его конструкции заключается в том, чтобы иметь простой и прозрачный, документируемый, расширяемый и читаемый человеком формат, способный представлять большую панель данных, которую можно просматривать и редактировать. При будущем развитии формата эта цель будет сохраняться. Должен быть возможность для того, кто имеет минимальный технический багаж, прекрасно понять формат путем быстрого чтения одной веб-страницы.
Это открытый формат, что означает, что другие продавцы планового ПО и разработчик сервиса могут свободно использовать формат, чтобы быть совместимыми с Radio UserLand или по любой другой причине.
<opml> является XML-элементом с одним необходимым атрибутом версии; элемент «head» и элемент «body», оба из которых необходимы.
Атрибут version является строкой символа версии формы x.y, где x и y являются цифровыми строками.
<head> содержит ноль или больше дополнительных элементов, как описано ниже.
<title> - название документа.
<dateCreated> - дата-время, указывающее, когда был создан документ.
<dateModified> - дата-время, указывающее, когда документ был изменен в последний раз.
<ownerName> - строка, владелец документа.
<ownerEmail> - строка, адрес владельца документа.
<expansionState> - это список, разделенный запятыми номеров развернутых строк. Номер строки в списке говорит, какие заголовки развивать. Порядок важен. Для каждого элемента в списке X, стартуя на первой вершине, мы двигаемся X раз и развиваем. Мы повторяем каждый элемент в списке.
<greenScrollState> - число, указывающее, какая строка плана отображается в первой строке окна. Это число рассчитывается с учетом уже применяемого состояния развития.
<windowsTop> - число, позиция пикселя верхнего края окна.
<windowsLeft> - число, позиция пикселя левого края окна.
<windowsBottom> - число, позиция пикселя нижнего края окна.
<windowsRight> - число, позиция пикселя правого края окна.
Все вложенные элементы <head> могут быть проигнорированы процессором. Если плоскость открыта в другой плоскости, процессор должен игнорировать элементы windowsXxx, которые управляют только размером и расположением плоскостей, открытых в собственных окнах.
Все даты-часы соответствуют Спецификации даты и времени RFC 822.
Если вы загружаете документ OPML в клиентский компьютер, вы можете выбрать, следует ли использовать expansionState или нет. Мы ни в коем случае не стараемся направлять то, что делает пользователь. Информация expansionState здесь, потому что она нужна в определенных контекстах. Легко представить контексты, где было бы актуально полностью игнорировать его.
<body> содержит элемент «outline» или более поздний.
« Outline» - это XML-элемент, содержащий один или несколько атрибутов и содержащий любое количество вложенных элементов «outline».
Текст - это строка, которая отображается при прохождении или редактировании плана. Для длины атрибута текста нет ограничения.
type - это строка символов, в ней говорится, как интерпретируются другие атрибуты в <outline>.
isComment является строкой, то есть «true» или «false» (true или false), указывающей, комментируется план или нет. По договоренности, если какой-то план комментируется, то все подведомственные планы тоже считаются комментированными. Если его нет, значение ошибается.
isBreakpoint является строкой, то есть «true» или «false», указывающей, помещается ли точка остановки на плоскости. Этот атрибут необходим в основном для планов, используемых для редактирования выполняемых сценариев. Если значение отсутствует, оно ошибается.
До замораживания формата 1.0 элементы первого уровня формата назывались outlineDocument. Радио UserLand по-прежнему продолжает читать эти материалы.
Не заданы ограничения на количество атрибутов, которые может иметь элемент <outline>, или количество элементов <outline>, которые он может содержать.
OPML - это формат файлов, а не протокол. При щелчке по ссылке в HTML-документе документ, хранящийся на сервере, никак не меняется. Таким же образом используется OPML.
Уэйн Стил сделал DTD для OPML 1.0. Спасибо.
Обычно mime-тип документа OPML, когда ты обращаешься к нему через HTTP, - это text/xml. Это позволяет веб-браузерам использовать обычные XML-форматы для просмотра документа OPML. HTTP-сервер Radio UserLand просматривает заголовок Accept запроса, чтобы определить, как он обрабатывает документ OPML. Если в заголовке Accept указано, что клиентский компьютер включает текст/x-opml, то текст XML возвращается без обработки. Если его нет, возвращают текст плана с типом mime text/html.
Авторское право и авторизация
© Авторские права 2000 UserLand Software, Inc. Все права защищены.
Этот документ и его переводы могут быть скопированы и предоставлены другим, и работы, производные для комментария или объяснения или содействия реализации, могут быть написаны, скопированы, опубликованы и распространены полностью или частично без ограничений любого рода, при условии, что уведомление об авторском праве выше и эти абзацы включены в эти копии или производные произведения.
Документ никоим образом не может быть изменен удалением уведомления об авторском праве или ссылок на UserLand или другие организации. Кроме того, поскольку эти ограничения на авторское право применяются к написанию спецификации OPML, ПользовательLand не предъявляет никаких претензий на право собственности в том формате, который он описывает. Любой может по коммерческим или некоммерческим причинам реализовать этот протокол без лицензионных прав или роялти, связанных с UserLand. Вышеуказанные ограниченные разрешения являются бессрочными и не могут быть отозваны ПользователемLand или его преемниками или представителями.
Вышеуказанный документ и информация предоставляются на основании «как есть» и USERLAND DECLINE ВСЕ ГАРАНТИИ, ЭКСПРЕССЫ ИЛИ СВЯЗАННЫЕ С НИМИ, ВКЛЮЧАЯ ЛЮБЫЕ ГАРАНТИИ ТОГО, ЧТО ИСПОЛЬЗОВАНИЕ ВЫШЕУКАЗАННОЙ ИНФОРМАЦИИ НЕ НАРУШИТ НИКАКИХ ПРАВ ИЛИ ЛЮБЫЕ ГАРАНТИИ, СВЯЗАННЫЕ С МАРКЕТИНГОМ ИЛИ ПРИМЕНИМОСТЬЮ ДЛЯ ЛЮБОГО ИСПОЛЬЗОВАНИЯ
© Авторское право 2000-2007, Script News, Inc.
OPML является торговым знаком Script News, Inc.
Последнее обновление: Четверг, Януарий 3, 2002 на 3:56:54 ПМ .
© Авторское право 2007 Дени Суро и .fr для французского перевода.
Лицензия на французский перевод: Условия использования этого документа являются условиями оригинала документа с такой точностью, что уведомление, включающее имя переводчика Дени Суро и URL-адрес сайта, на котором размещен перевод, iqlevsha.ru, должно храниться на любом документе, производном от настоящего документа.
Создание перевода: 24 марта 2007 года .