| Index: pkg/docgen/lib/src/mdn.dart
|
| diff --git a/pkg/docgen/lib/src/mdn.dart b/pkg/docgen/lib/src/mdn.dart
|
| deleted file mode 100644
|
| index f5fd69b59cb259b089ca48c02a70930363616aec..0000000000000000000000000000000000000000
|
| --- a/pkg/docgen/lib/src/mdn.dart
|
| +++ /dev/null
|
| @@ -1,65 +0,0 @@
|
| -// Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file
|
| -// for details. All rights reserved. Use of this source code is governed by a
|
| -// BSD-style license that can be found in the LICENSE file.
|
| -
|
| -library docgen.mdn;
|
| -
|
| -import 'dart:convert';
|
| -import 'dart:io';
|
| -
|
| -import 'package:logging/logging.dart';
|
| -import 'package:path/path.dart' as p;
|
| -
|
| -// TODO(janicejl): Make MDN content generic or pluggable.
|
| -
|
| -/// Map of all the comments for dom elements from MDN.
|
| -Map<String, dynamic> _mdn;
|
| -
|
| -/// Generates MDN comments from database.json.
|
| -String mdnComment(String root, Logger logger, String domName) {
|
| - //Check if MDN is loaded.
|
| - if (_mdn == null) {
|
| - // Reading in MDN related json file.
|
| - var mdnPath = p.join(root, 'utils/apidoc/mdn/database.json');
|
| - var mdnFile = new File(mdnPath);
|
| - if (mdnFile.existsSync()) {
|
| - _mdn = JSON.decode(mdnFile.readAsStringSync());
|
| - } else {
|
| - logger.warning("Cannot find MDN docs expected at $mdnPath");
|
| - _mdn = {};
|
| - }
|
| - }
|
| -
|
| - var parts = domName.split('.');
|
| - if (parts.length == 2) return _mdnMemberComment(parts[0], parts[1]);
|
| - if (parts.length == 1) return _mdnTypeComment(parts[0]);
|
| -
|
| - throw new StateError('More than two items is not supported: $parts');
|
| -}
|
| -
|
| -/// Generates the MDN Comment for variables and method DOM elements.
|
| -String _mdnMemberComment(String type, String member) {
|
| - var mdnType = _mdn[type];
|
| - if (mdnType == null) return '';
|
| - var mdnMember = mdnType['members'].firstWhere((e) => e['name'] == member,
|
| - orElse: () => null);
|
| - if (mdnMember == null) return '';
|
| - if (mdnMember['help'] == null || mdnMember['help'] == '') return '';
|
| - if (mdnMember['url'] == null) return '';
|
| - return _htmlifyMdn(mdnMember['help'], mdnMember['url']);
|
| -}
|
| -
|
| -/// Generates the MDN Comment for class DOM elements.
|
| -String _mdnTypeComment(String type) {
|
| - var mdnType = _mdn[type];
|
| - if (mdnType == null) return '';
|
| - if (mdnType['summary'] == null || mdnType['summary'] == "") return '';
|
| - if (mdnType['srcUrl'] == null) return '';
|
| - return _htmlifyMdn(mdnType['summary'], mdnType['srcUrl']);
|
| -}
|
| -
|
| -/// Encloses the given content in an MDN div and the original source link.
|
| -String _htmlifyMdn(String content, String url) {
|
| - return '<div class="mdn">' + content.trim() + '<p class="mdn-note">'
|
| - '<a href="' + url.trim() + '">from Mdn</a></p></div>';
|
| -}
|
|
|