Updating the code and text that results in the /dart-vm/dart-by-example file on www.

Author: sfshaza2

dart_io_mini_samples/README.md

@@ -1,8 +1,11 @@
-## Dart I/O and Command Line Apps
+## Writing code for the Dart VM
+
+### Dart I/O and Command Line Apps
 
 * [Introduction](example/introduction.md)
 
-### Files, directories, and symlinks
+## Files, directories, and symlinks
+
 * [Deleting a file, directory, or symlink](example/files_directories_and_symlinks/deleting_a_file_directory_or_symlink.dart)
 * [Renaming a file, directory, or symlink](example/files_directories_and_symlinks/renaming_a_file_directory_or_symlink.dart)
 * [Finding the type of a filesystem object](example/files_directories_and_symlinks/finding_the_type_of_a_filesystem_object.dart)
@@ -11,7 +14,6 @@
 * [Reading a file as a string](example/files_directories_and_symlinks/files/reading_a_file_as_a_string.dart)
 * [Reading a file as lines](example/files_directories_and_symlinks/files/reading_a_file_as_lines.dart)
 * [Reading a file as bytes](example/files_directories_and_symlinks/files/reading_a_file_as_bytes.dart)
-* [Using a stream to read a file](example/files_directories_and_symlinks/files/reading_a_file_using_a_stream.dart)
 * [Handling errors when reading a file](example/files_directories_and_symlinks/files/handling_errors_when_reading_a_file.dart)
 * [Writing a string to a file](example/files_directories_and_symlinks/files/writing_a_string_to_a_file.dart)
 * [Writing bytes to a file](example/files_directories_and_symlinks/files/writing_bytes_to_a_file.dart)
@@ -23,7 +25,8 @@
 * [Checking if a path represents a symlink](example/files_directories_and_symlinks/symlinks/checking_if_a_path_represents_a_symlink.dart)
 * [Getting the target of a symlink](example/files_directories_and_symlinks/symlinks/getting_the_target_of_a_link.dart)
 
-### HTTP requests and responses
+## HTTP requests and responses
+
 * [Making a GET request](example/http/making_a_get_request.dart)
 * [Making a POST request](example/http/making_a_post_request.dart)
 * [Adding custom headers to a request](example/http/adding_custom_headers.dart)
@@ -34,37 +37,41 @@
 * [Getting the response content in binary format](example/http/getting_the_response_content_in_binary_format.dart)
 * [Getting the response headers](example/http/getting_the_response_headers.dart)
 
-### HTTP server
+## HTTP server
+
 * [Implementing a 'Hello world' HTTP server](example/http_server/implementing_a_hello_world_http_server.dart)
-* [Listing directory contents](example/http_server/listing_directory_contents.dart)
-* [Serving index.html](example/http_server/serving_index_html.dart)
-* [Serving a 404](example/http_server/serving_a_404.dart)
 * [Routing requests based on URL patterns](example/http_server/routing_requests_based_on_url_patterns.dart)
 
-### Sockets
+## Sockets
+
 * [Using serversockets server](example/sockets/using_serversockets_server.dart)
 * [Using serversockets client](example/sockets/using_serversockets_client.dart)
 
-### Websockets
+## Websockets
+
 * [Using websockets server](example/websockets/using_websockets_server.dart)
 * [Using websockets client](example/websockets/using_websockets_client.dart)
 
-### OS and hardware information
+## OS and hardware information
+
 * [Getting environment variables](example/platform/getting_environment_variables.dart)
 * [Identifying the operating system](example/platform/identifying_the_operating_system.dart)
 * [Getting information about the script being run](example/platform/getting_information_about_the_script_being_run.dart)
 
-### Interacting with processes
+## Interacting with processes
+
 * [Running a process](example/interacting_with_processes/running_a_process.dart)
 * [Obtaining the exit code when running a process](example/interacting_with_processes/obtaining_the_exit_code_when_running_a_process.dart)
 
-### Working with paths
+## Working with paths
+
 * [Joining paths](example/paths/joining_paths.dart)
 * [Parsing a path into components](example/paths/parsing_a_path_into_components.dart)
 * [Calculating relative paths](example/paths/calculating_relative_paths.dart)
 * [Converting between a URI and a path](example/paths/converting_between_a_uri_and_a_path.dart)
 * [Getting information about a file path](example/paths/getting_information_about_a_file_path.dart)
 * [Getting the path separator for the current platform](example/paths/getting_the_path_separator_for_the_current_platform.dart)
 
-###  Other resources
+##  Other resources
+
 * [Other resources](example/other_resources.md)

dart_io_mini_samples/example/introduction.md

@@ -18,5 +18,5 @@ See the
 [source on Github](https://github.com/dart-lang/dart-samples/tree/master/dart_io_mini_samples).
 
 After looking at the following code examples, refer to
-[Writing Command-line Apps: A Programmer's Guide](/docs/serverguide.html)
-for additional information about I/O, command-line apps, and servers.
+[Write Command-line Apps](/tutorials/dart-vm/cmdline)
+for additional information about I/O and command-line apps.

dart_io_mini_samples/example/other_resources.md

@@ -1,27 +1,27 @@
-Read the [dart:io library API docs](https://api.dartlang.org/docs/channels/stable/latest/dart_io.html).
+Read the [dart:io library API docs]({{site.dart_api}}/dart-io/dart-io-library.html).
 
-Here are links to the commonly used classes and packages in these
-examples:
+Here are links to the commonly used classes and packages in these examples:
 
-* Files, Directories, and Symlinks
+* Using files, directories, and symlinks
 
-  * [FileSystemEntity class](https://api.dartlang.org/docs/channels/stable/latest/dart_io/FileSystemEntity.html)
-  * [File class](https://api.dartlang.org/docs/channels/stable/latest/dart_io/File.html)
-  * [Directory class](https://api.dartlang.org/docs/channels/stable/latest/dart_io/Directory.html)
-  * [Link class (for symlinks)](https://api.dartlang.org/docs/channels/stable/latest/dart_io/Link.html)
-
-* HTTP requests and responses
-  * [http Pub package](https://api.dartlang.org/docs/channels/stable/latest/http.html)
+  * [FileSystemEntity class]({{site.dart_api}}/dart-io/FileSystemEntity-class.html)
+  * [File class]({{site.dart_api}}/dart-io/File-class.html)
+  * [Directory class]({{site.dart_api}}/dart-io/Directory-class.html)
+  * [Link class (for symlinks)]({{site.dart_api}}/dart-io/Link-class.html)
 
 * HTTP server
-  * [HttpServer class](https://api.dartlang.org/docs/channels/stable/latest/dart_io/HttpServer.html)
-  * [http_server Pub package](https://api.dartlang.org/docs/channels/stable/latest/http_server.html)
+
+  * [HttpServer class]({{site.dart_api}}/dart-io/HttpServer-class.html)
+  * [http_server Pub package](https://pub.dartlang.org/packages/http_server)
 
 * OS and hardware information
-  * [Platform class](https://api.dartlang.org/docs/channels/stable/latest/dart_io/Platform.html)
+
+  * [Platform class]({{site.dart_api}}/dart-io/Platform-class.html)
 
 * Interacting with processes
-  * [Process class](https://api.dartlang.org/docs/channels/stable/latest/dart_io/Process.html)
+
+  * [Process class]({{site.dart_api}}/dart-io/Process-class.html)
 
 * Working with paths
-  * [path Pub package](https://api.dartlang.org/docs/channels/stable/latest/path.html)
+
+  * [path Pub package](https://pub.dartlang.org/packages/path)

dart_io_mini_samples/generate_md_for_dartlang.dart

@@ -1,3 +1,9 @@
+//
+// Run "dart generate_md_for_dartlang.dart > index.md".
+// Copy that file to /dart-vm/dart-by-example in the www repo.
+// This file uses fodder from README.md and example/* to generate
+// the final page.
+//
 import 'dart:io';
 import 'package:path/path.dart' as PATH;
 
@@ -26,9 +32,13 @@ printExample(List<String> lines) {
 const fileHeader = '''
 ---
 layout: default
+title: "Cookbook: Dart by Example"
+short-title: "Cookbook"
+permalink: /dart-vm/dart-by-example
+description: "A cookbook, or set of examples, showing idiomatic Dart code."
+
 header:
   css: ["index.css"]
-has-permalinks: true
 ---
 
 ''';
@@ -49,7 +59,7 @@ main() {
         var file = new File(abspath);
 
         if (PATH.extension(abspath) != '.md') {
-          print('#### ${match.group(1)}');
+          print('### ${match.group(1)}');
           print('');
           printExample(file.readAsLinesSync());
         } else {
@@ -59,12 +69,6 @@ main() {
     } else {
       // Print non-link lines from the README.
       print(line);
-      // Title line.
-      if (line.startsWith('## ')) {
-        print('{:.no_toc}');
-        print('');
-        print('{% include default_toc.html %}');
-      }
     }
   }
 }