The Generic Sensor API defines a framework for exposing sensor data to the Web platform in a consistent way. In particular, the specification defines a blueprint for writing specifications of concrete sensors along with an abstract Sensor interface that can be extended to accommodate different sensor types.
A number of sensor APIs are being built on top of the Generic Sensor API. The Proximity Sensor specification defines an API to monitor the presence of nearby objects without physical contact. The Ambient Light Sensor specification defines an API to monitor the ambient light level or illuminance of the device's environment..
+A number of sensor APIs are being built on top of the Generic Sensor API. The Proximity Sensor specification defines an API to monitor the presence of nearby objects without physical contact. The Ambient Light Sensor specification defines an API to monitor the ambient light level or illuminance of the device's environment..
The detection of motion is made possible by a combination of low-level and high-level motion sensor specifications, also built on top of the Generic Sensor API:
diff --git a/games/userinput.ja.html b/games/userinput.ja.html index 18b622d9..b25bc542 100644 --- a/games/userinput.ja.html +++ b/games/userinput.ja.html @@ -58,7 +58,7 @@Generic Sensor API はセンサーからのデータをウェブプラットフォームに統一的な形で公開するためのフレームワークを定義します。特に、この仕様では異なったセンサーに対応させるために拡張可能な抽象化された Sensor インターフェースにより、特定のセンサーについての仕様を作成するための青写真を提供します。
この Generic Sensor API に基づいて様々なセンサー API が定義されつつあります。Proximity Sensor 仕様は物理的接触がない近接オブジェクトの存在を検出するための API を定義しています。Ambient Light Sensor 仕様は背景光レベルや照度を検出するための APIを定義しています。
+この Generic Sensor API に基づいて様々なセンサー API が定義されつつあります。Proximity Sensor 仕様は物理的接触がない近接オブジェクトの存在を検出するための API を定義しています。Ambient Light Sensor 仕様は背景光レベルや照度を検出するための APIを定義しています。
動作の検出は Generic Sensor API の上に定義された低レベル・高レベルのモーションセンサー仕様の組み合わせで実現されています:
diff --git a/mobile/sensors.html b/mobile/sensors.html index 01c84014..fbb3c647 100644 --- a/mobile/sensors.html +++ b/mobile/sensors.html @@ -31,7 +31,7 @@The Proximity Sensor specification defines an API to monitor the presence of nearby objects without physical contact.
-The Ambient Light Sensor specification defines an API to monitor the ambient light level or illuminance of the device's environment.
+The Ambient Light Sensor specification defines an API to monitor the ambient light level or illuminance of the device's environment.
The Battery Status API exposes information about the battery status of the hosting service (however, note the future of this last specification is uncertain due to identified potential privacy-invasive usage of the API).
diff --git a/mobile/sensors.zh.html b/mobile/sensors.zh.html index 7946154f..0893b505 100644 --- a/mobile/sensors.zh.html +++ b/mobile/sensors.zh.html @@ -31,7 +31,7 @@接近度传感器规范定义了一个API来监控附近物体的存在，而无需物理接触。
-环境光线传感器规范定义了一个API来监控环境光照水平。
+环境光线传感器规范定义了一个API来监控环境光照水平。
diff --git a/package.json b/package.json index c56f56f6..54f19330 100644 --- a/package.json +++ b/package.json @@ -2,6 +2,7 @@ "name": "web-roadmaps", "dependencies": { "ajv-cli": "^3.0.0", + "browser-specs": "^1.14.0", "fetch-filecache-for-crawling": "^3.0.2", "jsdom": "^16.2.2", "mdn-browser-compat-data": "^1.0.0", diff --git a/tools/extract-spec-data.js b/tools/extract-spec-data.js index 85dbf2a4..151ff6c1 100644 --- a/tools/extract-spec-data.js +++ b/tools/extract-spec-data.js @@ -1,6 +1,7 @@ /******************************************************************************* Helper script that parses data files and fetches additional information from -the W3C API for TR specs and from Specref for other specs. +browser-specs (title, ED, repository), the W3C API (WG, status, etc.) and from +Specref for specs that are neither in browser-specs nor in the W3C API. To parse files: node tools/extract-spec-data.js data/3dcamera.json data/webvtt.json @@ -10,6 +11,7 @@ const fetch = require('fetch-filecache-for-crawling'); const path = require('path'); const fs = require('fs'); const https = require('https'); +const browserSpecs = require('browser-specs'); /** @@ -73,6 +75,13 @@ const publishers = { parentPublisher: 'W3C', isGroup: true }, + 'CSSWG': { + label: 'Cascading Style Sheets (CSS) Working Group', + url: 'https://www.w3.org/Style/CSS/', + urlPattern: /drafts\.(csswg|fxtf|css-houdini)\.org/i, + isGroup: true, + parentPublisher: 'W3C' + }, 'OGC': { label: 'Open Geospatial Consortium', url: 'http://www.opengeospatial.org/', @@ -124,6 +133,44 @@ function requireFromWorkingDirectory(filename) { } +/** + * Return the entry in browser-specs that matches the given spec, or null if the + * given spec does not exist in browser-specs + * + * @function + * @param {Object} spec The spec object to parse + * @return {Object} The entry in browser-specs that matches spec, or null + */ +function getBrowserSpec(spec) { + let data = spec.data || {}; + let specUrl = data.url || data.TR || data.edDraft || data.editors || data.ls; + return browserSpecs.find(s => { + if (specUrl) { + return (s.url === specUrl) || + (s.nightly.url === specUrl) || + (s.release && s.release.url === specUrl); + } + else { + return (s.shortname === spec.id) || + ((s.series.shortname === spec.id) && + (s.series.currentSpecification === s.shortname)); + } + }); +} + + +/** + * Return true if given spec is in browser-specs + * + * @function + * @param {Object} spec The spec object to parse + * @return {Boolean} True if spec should be considered to be a TR spec + */ +function isBrowserSpec(spec) { + return !!getBrowserSpec(spec); +} + + /** * Return true if given spec is a TR document. * @@ -323,7 +370,21 @@ async function extractSpecData(files, config) { } } - // Fetch spec info from Specref when spec is not a TR spec. + // Complete spec info with info from browser-specs + specs = specs.map(spec => { + const browserSpec = getBrowserSpec(spec); + if (!browserSpec) { + return spec; + } + const data = spec.data; + data.url = data.url || browserSpec.url; + data.edDraft = data.edDraft || browserSpec.nightly.url; + data.repository = data.repository || browserSpec.nightly.repository; + data.title = data.title || browserSpec.title; + return spec; + }); + + // Fetch spec info from Specref when spec is not a TR spec // (Proceed in chunks not to end up with a URL that is thousands of bytes // long, and only fetch a given lookup URL once) let lookupUrls = specs