Files

T

History

Lasse R.H. Nielsen 8d46b7cd81 Remove references to .packages from build scripts.

It's just names and comments, they already used
`package_config.json` as the package configuration.

Change-Id: Icd421ed99079fa9058426e1536565658938252ac
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/414100
Commit-Queue: Lasse Nielsen <lrn@google.com>
Reviewed-by: Brian Quinlan <bquinlan@google.com>

2025-03-11 03:37:14 -07:00

build

Remove references to .packages from build scripts.

2025-03-11 03:37:14 -07:00

styles

[vm/docs] Improve VM docs tooling.

2023-02-16 13:42:01 +00:00

templates

[vm/docs] Improve VM docs tooling.

2023-02-16 13:42:01 +00:00

README.md

[vm/docs] Improve VM docs tooling.

2023-02-16 13:42:01 +00:00

README.md

This directory contains helper scripts for rendering runtime wiki pages as HTML.

# Run webserver for development.
$ runtime/tools/wiki/build/build.py

# Build wiki for deployment
$ runtime/tools/wiki/build/build.py --deploy

Markdown extensions

Admonitions and Asides

Blockquotes starting with > **Marker** are converted either:

into sidenotes (if Marker is Note), which will be rendered on margins of the page;
admonitions (if Marker is Source to read, Trying it or Warning).

Referencing C++ symbols and files

Script extends Markdown references with special support for references that use [`ref`][] and [text][`ref`]. The following values for ref are recognized and resolved as links to GitHub at the current commit.

file-path is resolved as a link to the given file;
package:name/path.dart is resolved as a link to file path.dart within package name - actual path is resolved via .dart_tool/package_config.json file in the SDK root;
c++ symbol is resolved as a link to the line in the file which defines the given C++ symbol.

If markdown file contains any references in this form then running runtime/tools/wiki/build/build.py --deploy will generate a reference section at the end of the file. Appending this section allows other Markdown tools (e.g. GitHub viewer) to render such special links correctly.

Prerequisites

Install all Python dependencies.

$ pip3 install coloredlogs jinja2 markdown aiohttp watchdog pymdown-extensions pygments

Install libclang (brew install llvm on Mac OS X).
Install SASS compiler (make sure that SASS binary is in your path).