TableML Excel编译/解析工具

TableML

TableML, Table Markup Language, 基于电子表格的标记语言，

相似JSON, XML, INI，TableML能够做为软件项目的配置标记语言，

与之不一样的是，您可使用Excel等电子表格编辑软件来配置TableML，自由地添加图标、注释、VB脚本和预编译指令，再由TableML编译器导出干净的TSV格式的配置表表格，编辑方便，使用简单。

目前提供C#版本的运行时、编译器、代码生成器。

 

感谢Mr.Kelly的开源项目，我基于Kelly的TableML基础，进行扩展增长或修改部分功能。

原始版本地址：https://github.com/mr-kelly/TableML

扩展版本地址：https://github.com/zhaoqingqing/TableML

 

Example

您可使用Excel编译以下内容，并保存为文件setting/test.xls:

excel测试文件地址：https://github.com/zhaoqingqing/TableML/blob/custom/TableML/TableMLTests/TestSettings/TestExcel.xls

 

而后使用TableML命令行编译器：

TableML.exe --Src setting --To setting2 --CodeFile Code.cs

 

执行后，将会生成setting2/test.tml文件，打开能够看见编译后内容：

Id	Value
int	string
1	Abcdefg
2	Yuiop

另外附带一份Code.cs，自动生成的代码。

 

TableML编辑规则

以上的例子中，展现了TableML的大部分特性：

• TableML使用Excel等电子表格软件做为编辑器，并经过编译器导出成tml格式文件
• tml格式文件实质是TSV格式，即Tab Sperated Values，相似CSV
• 行头占3行：
  • 第1行是列名
  • 第2行是列的信息，一般是声明列的类型,能够自定义
  • 第3行是列的注释
  • 除外的全部行为内容
• 列名内容以#开头或Comment开头，改列被视为注释列，编译器忽略
• 行内容的第一个单元格内容，以#开头或Comment开头，改行被视为注释行，编译器忽略
• 可使用预编译指令#if和#endif，条件式控制编译的行

 

工程使用说明

1. 经过git clone 或者download master的方式将工程下载到本地
2. 建议使用visual studio2012及更高版本打开 TableML\TableML.sln
3. 在vs中设置TableMLCompilerConsole 为启动项目(解决方案面板，选中项目，右键 - 设为启动项目)
4. 建议把项目的输出设为Release，而后选择 菜单栏 - 生成 - 生成TableMLCompilerConsole
5. 打开目录 TableML\TableMLCompilerConsole\bin\Release 能够看到已经生成了TableML.exe

 

工程简介

TableML

• tml(tsv)文件读取接口，把tsv文件读取至内存，供应用程序访问

 

TableMLCompiler

• 对excel/csv 源文件进行编译，解析配置表规则生成tsv文件

 

TableMLCompilerConsole

• 提供命令行，根据条件对excel进行编译

 

TableMLGUI

• 提供GUI界面，增长编译选定excel，将数据导入到sqlite中
• 增长excel的查错，输出操做日志
• 更多介绍请查看：http://www.cnblogs.com/zhaoqingqing/p/7440867.html

 

TableMLTests

• 编译功能的单元测试

自定义配置

如下功能能够进行自定义或者是我扩展的功能：

1. 从第2列(指定列)开始读

​ 修改SimpleExcelFile.cs中的StartColumnIdx值如：

   public const int StartColumnIdx = 1;

2.每一个表对应一个Class文件

调用方法以下：

batchCompiler.CompileTableMLAllInSingleFile(srcDirectory, OutputDirectory, CodeFilePath, templateString, "AppSettings", ".tml", null, true);

示例代码可参考：LocalDebug.cs中的CompileAll()

 

3.修改生成的代码模版

修改TableML.Compiler.DefaultTemplate中的字符串模版

 

4.预留指定行，自定义行，好比第6行是字段名，第8行是数据类型，第15行是字段注释

扩展SimpleExcelFile.PreserverRowCount = 预留行

修改SimpleExcelFile.ParseExcel中的Worksheet.GetRow(5);

excel读取规则

先读取Excel的行，再读取列，把数据写入到tml文件中。

 

GUI工具内存溢出

若是在使用TableMLGUI时，特别占用内存，建议把excel另存为csv格式，或者减小单个excel文件的大小，以减小内存占用。

 

更多功能

For SQL数据库

TableMLGUI提供一键将excel数据插入到sqlite中。

采用sql的事务机制，在插入大量数据的环境下，耗时更短。

同时在控制台输出sql语句方便调试查错。

 

自动读取配置代码生成

TableML编译器内置Liquid模板引擎。您能够自定义模板内容，来为不一样的语言生成读表类。

TableML是KSFramework的一部分，用于游戏配置表读取代码，支持热重载、分表等机制。

 

TableML for C#/Mono/Xamarin

TableML目前只提供C#版本。当前TableML使用基于Xamarin Studio开发，TableML的C#版本具有了跨平台特性（Windows/Mac/Linux）。