FontFeature diagrams

README.md

@@ -7,6 +7,7 @@ specially-crafted graphics.
 Assets committed to this repo and pushed to GitHub are immediately
 available for linking and reference.
 
+
 ## URL structure
 
 Reference the assets with this URL structure:
@@ -20,6 +21,7 @@ material library would go in the `assets/material/` directory and be at
 All asset files should be under the `assets` directory in an appropriate
 subdirectory.
 
+
 ## Generation
 
 Images must be code-generated.
@@ -38,7 +40,7 @@ bin/generate.sh -c cupertino,material
 bin/generate.sh -n basic_material_app,blend_mode
 ```
 
-`bin/generate.sh -h` lists available arguments.
+`bin/generate.sh --help` lists available arguments.
 
 ### Prerequisites
 
@@ -57,6 +59,7 @@ in a directory in the `PATH` environment variable. (e.g. PATH=~/<path_to_flutter
 When using an Android device, be sure that the  `adb` command is the same as the one running
 as a server (which is often started by your IDE, so use the same `adb` the IDE is running).
 
+
 ## Optimization
 
 Please consider optimization tools for assets.
@@ -73,6 +76,20 @@ the `assets/tests` directory should not be optimized.
 The automatic generation tool will automatically apply optimization to
 the assets it generates.
 
+
+## Creating new diagrams
+
+To create a new diagram:
+
+1. Add a new file to `packages/diagrams/lib/src/`, and put the tests in there.
+
+2. Export that file from `packages/diagrams/lib/diagrams.dart`.
+
+3. Add your new class to the list in `assets-for-api-docs/utils/diagram_generator/lib/main.dart`.
+
+4. Run `generate.sh --name xxx` where 'xxx' is the name of your diagram.
+
+
 ## Origin of third-party content
 
 * `/assets/videos/bee.mp4`: CC0 Creative Commons, from [https://pixabay.com/en/videos/honey-bee-insect-bee-flower-flying-211/](https://pixabay.com/en/videos/honey-bee-insect-bee-flower-flying-211/)

bin/generate.sh

@@ -6,4 +6,5 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" >/dev/null && pwd)"
 REPO_DIR="$(dirname "$SCRIPT_DIR")"
 
 # Dart needs to be in the path already...
+(cd ${REPO_DIR}/bin; pub get)
 dart --no-sound-null-safety "${REPO_DIR}/bin/generate.dart" "$@"

packages/diagrams/lib/diagrams.dart

@@ -31,6 +31,7 @@ export 'src/expanded.dart';
 export 'src/flat_button.dart';
 export 'src/floating_action_button.dart';
 export 'src/floating_action_button_location.dart';
+export 'src/font_feature.dart';
 export 'src/form.dart';
 export 'src/gesture_detector.dart';
 export 'src/grid_view.dart';

packages/diagrams/lib/src/diagram_step.dart

@@ -36,7 +36,7 @@ abstract class DiagramStep<T extends DiagramMetadata> {
   Future<List<File>> generateDiagrams({List<String> onlyGenerate = const <String>[]}) async {
     final List<File> files = <File>[];
     for (final T diagram in await diagrams) {
-      if (onlyGenerate.isNotEmpty && !onlyGenerate.contains(diagram.name)) {
+      if (onlyGenerate.isNotEmpty && !onlyGenerate.any((String name) => diagram.name.contains(name))) {
         continue;
       }
       files.add(await generateDiagram(diagram));