Add Workbooks. Update README.md.

Author: CXuesong

README.md

@@ -1,3 +1,161 @@
 # LUAON.NET
 
-Writing LUA table expression becomes easy.
+Writing LUA table expressions becomes easy. It's LUA Object Notation (or LUA Table Notation).
+
+| Package                                  | Status                                   |
+| ---------------------------------------- | ---------------------------------------- |
+| [CXuesong.Luaon](https://www.nuget.org/packages/CXuesong.Luaon) | ![NuGet version (CXuesong.Luaon)](https://img.shields.io/nuget/vpre/CXuesong.Luaon.svg?style=flat-square) ![NuGet version (CXuesong.Luaon)](https://img.shields.io/nuget/dt/CXuesong.Luaon.svg?style=flat-square) |
+| [CXuesong.Luaon.Json](https://www.nuget.org/packages/CXuesong.Luaon.Json) | ![NuGet version (CXuesong.Luaon.Json)](https://img.shields.io/nuget/vpre/CXuesong.Luaon.Json.svg?style=flat-square) ![NuGet version (CXuesong.Luaon.Json)](https://img.shields.io/nuget/dt/CXuesong.Luaon.Json.svg?style=flat-square) |
+
+[Try out the packages with Xamarin Workbooks!](Workbooks)
+
+## CXuesong.Luaon
+
+This package contains classes for writing Lua tables in a manner similar to `Newtonsoft.Json`, such as
+
+Basic simple-value converter
+
+```c#
+using Luaon;
+LuaConvert.ToString(12345)
+```
+
+```lua
+12345
+```
+
+```c#
+// Custom string delimiter
+LuaConvert.ToString("string expression\n\nNew line", "[=====[")
+```
+
+```lua
+[=====[string expression
+New line]=====]
+```
+
+A primitive counterpart of `Newtonsoft.Json.Linq`.
+
+```c#
+using Luaon.Linq;
+var table = new LTable();
+table.Add("Item1");
+table.Add("Key1", 123);
+table.Add("Key with space", 789);
+table.Add("Item2");
+table.Add(100, "Value100");
+table.Add("ChildTable", new LTable(1, 2, 3, 4, 5));
+table.ToString();
+```
+
+```lua
+{
+  "Item1",
+  Key1 = 123,
+  ["Key with space"] = 789,
+  "Item2",
+  [100] = "Value100",
+  ChildTable = {
+    1,
+    2,
+    3,
+    4,
+    5
+  }
+}
+```
+
+Access table values in a Lua way.
+
+```c#
+table[2]
+```
+
+```lua
+"Item2"
+```
+
+And a Lua table writer
+
+```c#
+using System.IO;
+using (var sw = new StringWriter())
+{
+    using (var lw = new LuaTableTextWriter(sw) {
+        Formatting = Formatting.Prettified,
+        CloseWriter = false
+    })
+    {
+        lw.WriteStartTable();
+        lw.WriteLiteral("Records");
+        lw.WriteKey("Updated");
+        lw.WriteLiteral(DateTime.Now);
+        lw.WriteLiteral("Value1");
+        lw.WriteLiteral("Value2");
+        lw.WriteLiteral("Value3");
+        lw.WriteEndTable();
+    }
+    return sw.ToString();
+}
+```
+
+```lua
+{
+  "Records",
+  Updated = "2018-01-12T23:13:27.7863687+08:00",
+  "Value1",
+  "Value2",
+  "Value3"
+}
+```
+
+## CXuesong.Luaon.Json
+
+This package contains `JsonLuaWriter`, a `JsonWriter` implementation that writes Lua tables instead of JS objects.
+
+```c#
+using Luaon.Json;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+using System.IO;
+
+var obj = new {
+    Name = "Graystripe",
+    Affiliation = new {
+        Current = "ThunderClan",
+        Past = new [] { "RiverClan", "Kittypet", "Loner" },
+    },
+    Age = 132   // Months
+};
+
+var serializer = new JsonSerializer();
+using (var sw = new StringWriter())
+{
+    using (var jlw = new JsonLuaWriter(sw) {
+        CloseOutput = false,
+        Formatting = Formatting.Indented})
+    {
+        serializer.Serialize(jlw, obj);
+    }
+    return sw.ToString();
+}
+```
+
+```lua
+{
+  Name = "Graystripe",
+  Affiliation = {
+    Current = "ThunderClan",
+    Past = {
+      "RiverClan",
+      "Kittypet",
+      "Loner"
+    }
+  },
+  Age = 132
+}
+```
+
+## As for table readers
+
+It's not my priority yet XD If you want it, consider opening an issue or PR to let me know ^ _ ^

Workbooks/Luaon.Json.workbook

@@ -0,0 +1,50 @@
+---
+uti: com.xamarin.workbook
+id: 28bfdbe0-89c3-48c2-9fb4-8a306c6758e3
+title: Luaon.Json
+platforms:
+- DotNetCore
+packages:
+- id: CXuesong.Luaon
+  version: 0.1.1
+- id: CXuesong.Luaon.Json
+  version: 0.1.0
+---
+
+```csharp
+#r "Luaon.NET"
+#r "Luaon.Json"
+```
+
+```csharp
+using Luaon.Json;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+```
+
+We also have a `JsonWriter` implementation that allows you to write JSON in Lua way.
+
+```csharp
+using System.IO;
+
+var obj = new {
+    Name = "Graystripe",
+    Affiliation = new {
+        Current = "ThunderClan",
+        Past = new [] { "RiverClan", "Kittypet", "Loner" },
+    },
+    Age = 132   // Months
+};
+
+var serializer = new JsonSerializer();
+using (var sw = new StringWriter())
+{
+    using (var jlw = new JsonLuaWriter(sw) {
+        CloseOutput = false,
+        Formatting = Formatting.Indented})
+    {
+        serializer.Serialize(jlw, obj);
+    }
+    return sw.ToString();
+}
+```

Workbooks/Luaon.workbook

@@ -0,0 +1,94 @@
+---
+uti: com.xamarin.workbook
+id: 87471c2e-6d90-49ef-94e1-6ad4663015b0
+title: Luaon
+platforms:
+- DotNetCore
+packages:
+- id: CXuesong.Luaon
+  version: 0.1.1
+- id: CXuesong.Luaon.Json
+  version: 0.1.0
+---
+
+```csharp
+#r "Luaon.NET"
+```
+
+```csharp
+using Luaon;
+```
+
+You can convert various values into Lua expressions with `LuaConvert`.
+
+```csharp
+LuaConvert.ToString(12345)
+```
+
+```csharp
+LuaConvert.ToString("string expression\n\nNew line")
+```
+
+```csharp
+// Custom string delimiter
+LuaConvert.ToString("string expression\n\nNew line", "[=====[")
+```
+
+Like `Newtonsoft.Json.Linq`, you can create a `LTable`, insert values into it, and convert it into string of Lua expression.
+
+```csharp
+using Luaon.Linq;
+var table = new LTable();
+table.Add("Item1");
+table.Add("Item2");
+table.Add("Item3");
+table.Add("Key1", 123);
+table.Add("Key2", 456);
+table.Add("Key with space", 789);
+table.Add("Item4");
+table.Add(100, "Value100");
+table.Add("ChildTable", new LTable(1, 2, 3, 4, 5));
+table.ToString();
+```
+
+```csharp
+// You can access table fields in a LUA way.
+(table[1], table[4], table["Key with space"], table[100], table["ChildTable"][2])
+```
+
+```csharp
+// You can convert LValue from and to other basic data types, just like JValue
+(int)table["Key2"] * 100
+```
+
+For advanced users, you can operate on `LuaTableTextWriter` directly. But the API of this class might be subject to some major changes. Anyway, I’m making it feel like `JsonTextWriter`, except that for now it does not provide auto-completion. You need to close the table expression manually.
+
+```csharp
+using System.IO;
+using (var sw = new StringWriter())
+{
+    using (var lw = new LuaTableTextWriter(sw) {
+        Formatting = Formatting.Prettified,
+        CloseWriter = false
+    })
+    {
+        lw.WriteStartTable();
+        lw.WriteLiteral("Records");
+        lw.WriteKey("Updated");
+        lw.WriteLiteral(DateTime.Now);
+
+        lw.WriteKey("Item1");
+        lw.WriteStartTable();
+        lw.WriteLiteral("Value1");
+        lw.WriteLiteral("Value2");
+        lw.WriteLiteral("Value3");
+        lw.WriteEndTable();
+
+        lw.WriteKey("Item2");
+        table["ChildTable"].WriteTo(lw);
+        
+        lw.WriteEndTable();
+    }
+    return sw.ToString();
+}
+```

Workbooks/README.md

@@ -0,0 +1,3 @@
+# Workbooks
+
+This folder contains some usage examples that can be opened with [Xamarin Workbooks](https://github.com/Microsoft/workbooks). You may download the latest version of Xamarin Workbooks [here](https://github.com/Microsoft/workbooks/releases).