wenyan-lang
diff --git a/‎README.md‎
Lines changed: 6 additions & 0 deletions b/‎README.md‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎documentation/Runtime.md‎
Lines changed: 59 additions & 0 deletions b/‎documentation/Runtime.md‎
Lines changed: 59 additions & 0 deletions
@@ -95,6 +95,12 @@ You can now translate JavaScript to wenyan-lang using the [wenyanizer](https://g
 - [Plugin for Vim](https://github.com/voldikss/vim-wenyan) by [voldikss](https://github.com/voldikss)
 - [Plugin for Sublime Text](https://github.com/absop/SublimeWenyan) by [absop](https://github.com/absop)
 
+### Browser Runtime
+
+You can now run Wenyan scripts right in your html file.
+
+Please refer to [Browser Runtime](./documentation/Runtime.md)
+
 ### Advance Usage
 
 [Compiler API Specification](./documentation/Compiler-API.md)
 
@@ -0,0 +1,59 @@
+[Back to README](../README.md)
+
+# Wenyan Browser Runtime
+
+You can now run Wenyan as normal Javscript script right in your html.
+
+[**Check out the demo**](https://jsfiddle.net/antfu/u532ny49/2/)
+
+## Installation
+
+Add following script in the `<head>` of your html file.
+
+```html
+<script src='https://unpkg.com/@wenyanlang/runtime'></script>
+```
+
+That's all, you are good to go!
+
+## Usage
+
+To use wenyan in script, you **HAVE TO** specify `type="application/wenyan"` for the `<script>` tag. For example:
+
+```html
+<script type="application/wenyan">
+吾有一數。曰三。名之曰「甲」。
+為是「甲」遍。
+  吾有一言。曰「「問天地好在。」」。書之。
+云云。
+</script>
+```
+
+### Scoped script
+
+By default, all the variables in wenyan will exposed globally. For the previous example, `甲` is accessible by `window.甲`. If you do not want to messed up your globals, you can specify the `scoped` attr.
+
+```html
+<script type="application/wenyan" scoped>
+吾有一數。曰三。名之曰「甲」。
+</script>
+```
+
+### Remote scripts
+
+You can import remote scripts as you will do for Javascript.
+
+```html
+<script type="application/wenyan" src="https://raw.githubusercontent.com/LingDong-/wenyan-lang/master/examples/fizzbuzz.wy"></script>
+```
+
+### DOM Hacks
+
+There are some hacks you can do to access the DOM and browser APIs. This allows wenyan to do some realworld applications.
+
+```html
+<script type="application/wenyan">
+施「((title)=>document.title=title)」於「「文言」」。
+施「((text)=>document.body.innerText=text)」於「「問天地好在。」」。
+</script>
+```