diff --git a/blog/index.html b/blog/index.html index 1e9b0ff1..fa4f2ccd 100644 --- a/blog/index.html +++ b/blog/index.html @@ -1,4 +1,4 @@ -Blog - Tableau

Concepts

Core concepts of Tableau.

Terminology

Basics

TermDefinition
WorkbookAn excel file.
A XML file.
A bundle of CSV files named with the same prefix seperated by #.
WorksheetA sheet in a excel file.
A root node of a XML file.
A CSV file.
MetasheetA worksheet named @TABLEAU to specify tableau parser options.
RowThe row in a sheet.
ColumnThe column in a sheet.
CellThe intersection of a row and a column.
In-cellThe inner-side of a cell.
Cross-cellContinuous cells of a row or a column.

Worksheet

TermDefinition
NamerowExact row number of column name definition at a worksheet.
โš ๏ธ NOTE: each column name must be unique in a worksheet!
Default: 1.
TyperowExact row number of column type definition at a worksheet.
Default: 2.
NoterowExact row number of column note at a worksheet.
Default: 3.
DatarowStart row number of data at a worksheet.
Default: 4.
NamelineThe line number of column name definition in a cell. 0 means the whole cell.
Default: 0.
TypelineThe line number of column type definition in a cell. 0 means the whole cell.
Default: 0.
SepSeparator for:
1. separating in-cell list elements.
2. separating in-cell map items.
Default: ,.
SubsepSubseparator for separating in-cell map Key-Value pair.
Default: :.
NestedNested naming of the namerow.
Default: false.
LayoutIncell, vertical(cross-cell) or horizontal(cross-cell).
TransposeInterchanging the rows and columns of a given sheet.

Mappings to Protoconf

TermProtoconf
WorkbookOne protoconf(.proto) file.
WorksheetOne top-level message in a protoconf file, except the tableau metasheet named @TABLEAU.
columnOne field in a message

A simple mapping example

Input: an excel file

A workbook(HelloWorld.xlsx) with two data worksheets(ItemConf and ActivityConf) and an empty tableau metasheet(@TABLEAU).

IDNameType
map<uint32, Item>stringint32
Item’s ID.Item’s name.Item’s type.
1item1100
2item2200
3item3300
IDNameOpen
map<uint32, Activity>stringbool
Activity’s ID.Activity’s name.Activity is open?
1activity1true
2activity2false
3activity3

Output: a protoconf file

A protoconf file(hello_world.proto) with two top-level messages(ItemConf and ActivityConf).

hello_world.proto
// Generated by tableauc 0.2.1. DO NOT EDIT.
 syntax = "proto3";
 package protoconf;
 option go_package = "github.com/tableauio/demo/examples/helloworld/protoconf";
@@ -60,8 +60,8 @@
     bool open = 3 [(tableau.field) = {name:"Open"}];
   }
 }
-
Last modified on August 28, 2024
Edit this page on GitHub
← Metasheet
Naming convention →
+
Last modified on September 2, 2024
Edit this page on GitHub
← Metasheet
Naming convention →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/basics/enum/index.html b/docs/basics/enum/index.html index 79019e33..22cb66ff 100644 --- a/docs/basics/enum/index.html +++ b/docs/basics/enum/index.html @@ -1,4 +1,4 @@ -Enum - Tableau +

Then the three forms of enum value are all accepted:

Enum value numberEnum value nameEnum value alias
0FRUIT_TYPE_UNKNOWNUnknown
1FRUIT_TYPE_APPLEApple
2FRUIT_TYPE_ORANGEOrange
3FRUIT_TYPE_BANANABanana

NOTE: Enum type must be predefined.

Go to read details about predefiend Enum type. Predefined types โ†’

Validation

As enum type is predefined, so the tableau parser will auto validate the enum value.

Last modified on September 2, 2024
Edit this page on GitHub
← Grammar and types
Predefined types →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/basics/grammar-and-types/index.html b/docs/basics/grammar-and-types/index.html index 4792ba64..32ecdd69 100644 --- a/docs/basics/grammar-and-types/index.html +++ b/docs/basics/grammar-and-types/index.html @@ -1,4 +1,4 @@ -Grammar and types - Tableau

Grammar and types

This guide discusses Tableau's basic grammar, variable declarations, and data types.

Overview

Tableau borrows most of its syntax and types from Protocol Buffers (proto3) and Golang.

Scalar types

Details disccused at Protocol Buffers Proto3 Scalar.

KindTypesDefault
Numbersint32, uint32
int64, uint64
float, double		0
0
0.0
Booleansboolfalse
Stringsstring""
Bytesbytes""

Well-known types

Datetime

TypeDefaultDescription
datetime0000-00-00 00:00:00Format: yyyy-MM-dd HH:mm:ss.
e.g.: 2020-01-01 05:10:00.
date0000-00-00Format: yyyy-MM-dd or yyyyMMdd.
e.g.: 2020-01-01 or 20200101.
time00:00:00Format: HH:mm:ss or HHmmss, HH:mm or HHmm.
e.g.: 05:10:00 or 051000, 05:10 or 0510.

Tips

Duration

TypeDefaultDescription
duration0sFormat like: "72h3m0.5s".
Refer golang duration string form.

Tips

Composite types

TypeDescription
structA struct is mapped to a protobuf message.
listA list is mapped to a protobuf repeated field.
mapA map is mapped to a protobuf map field.

struct

FeatureDescription
Horizontal layoutEach scalar field located in one cell.
Simple incell structEach field must be scalar type.
It is a comma-separated list of fields. E.g.: 1,test,3.0.
If the data list’s size is not same as struct’s fields, then fields will be filled in order. Fields not configured will be filled with default values due to its scalar type.

list

FeatureDescription
Horizontal layoutThis is list’s default layout.
Element type can be struct or scalar.
Vertical layoutList’s element type should be struct.
Simple incell listElement type must be scalar.
It is a comma-separated list of elements. E.g.: 1,2,3.
ScalableScalable or dynamic list size.
Ignore empty elementSmart recognition of empty element at any position.

map

FeatureDescription
Horizontal layout
Vertical layoutThis is map’s default layout.
Hash mapImplemented as unordered map or hash map.
Ordered mapSupported by tableauio/loader.
- C++
Simple incell mapBoth key and value must be scalar type.
It is a comma-separated list of key:value pairs.
E.g.: 1:10,2:20,3:30.
ScalableScalable or dynamic map size.
Ignore empty itemSmart recognition of empty item at any position.

Enumeration

FeatureDescription
Three forms of enum value1. Enum value number.
2. Enum value name.
3. Enum value alias name (with EnumValueOptions specified).
ValidationAuto-check legality of enum values.

Empty value

TypeDescription
scalarEmpty scalar will be emplaced with scalar type’s default value.
structEmpty struct will not be spawned if all fields are empty.
listEmpty list will not be spawned if list’s size is 0.
Empty struct will not be appended if list’s element(struct type) is empty.
mapEmpty map will not be spawned if map’s size is 0. Empty struct will not be inserted if map’s value(struct type) is empty.
nestingRecursively empty.
Last modified on August 28, 2024
Edit this page on GitHub
← Naming convention
Enum →
+Help

Grammar and types

This guide discusses Tableau's basic grammar, variable declarations, and data types.

Overview

Tableau borrows most of its syntax and types from Protocol Buffers (proto3) and Golang.

Scalar types

Details disccused at Protocol Buffers Proto3 Scalar.

KindTypesDefault
Numbersint32, uint32
int64, uint64
float, double		0
0
0.0
Booleansboolfalse
Stringsstring""
Bytesbytes""

Well-known types

Datetime

TypeDefaultDescription
datetime0000-00-00 00:00:00Format: yyyy-MM-dd HH:mm:ss.
e.g.: 2020-01-01 05:10:00.
date0000-00-00Format: yyyy-MM-dd or yyyyMMdd.
e.g.: 2020-01-01 or 20200101.
time00:00:00Format: HH:mm:ss or HHmmss, HH:mm or HHmm.
e.g.: 05:10:00 or 051000, 05:10 or 0510.

Tips

Duration

TypeDefaultDescription
duration0sFormat like: "72h3m0.5s".
Refer golang duration string form.

Tips

Composite types

TypeDescription
structA struct is mapped to a protobuf message.
listA list is mapped to a protobuf repeated field.
mapA map is mapped to a protobuf map field.

struct

FeatureDescription
Horizontal layoutEach scalar field located in one cell.
Simple incell structEach field must be scalar type.
It is a comma-separated list of fields. E.g.: 1,test,3.0.
If the data list’s size is not same as struct’s fields, then fields will be filled in order. Fields not configured will be filled with default values due to its scalar type.

list

FeatureDescription
Horizontal layoutThis is list’s default layout.
Element type can be struct or scalar.
Vertical layoutList’s element type should be struct.
Simple incell listElement type must be scalar.
It is a comma-separated list of elements. E.g.: 1,2,3.
ScalableScalable or dynamic list size.
Ignore empty elementSmart recognition of empty element at any position.

map

FeatureDescription
Horizontal layout
Vertical layoutThis is map’s default layout.
Hash mapImplemented as unordered map or hash map.
Ordered mapSupported by tableauio/loader.
- C++
Simple incell mapBoth key and value must be scalar type.
It is a comma-separated list of key:value pairs.
E.g.: 1:10,2:20,3:30.
ScalableScalable or dynamic map size.
Ignore empty itemSmart recognition of empty item at any position.

Enumeration

FeatureDescription
Three forms of enum value1. Enum value number.
2. Enum value name.
3. Enum value alias name (with EnumValueOptions specified).
ValidationAuto-check legality of enum values.

Empty value

TypeDescription
scalarEmpty scalar will be emplaced with scalar type’s default value.
structEmpty struct will not be spawned if all fields are empty.
listEmpty list will not be spawned if list’s size is 0.
Empty struct will not be appended if list’s element(struct type) is empty.
mapEmpty map will not be spawned if map’s size is 0. Empty struct will not be inserted if map’s value(struct type) is empty.
nestingRecursively empty.
Last modified on September 2, 2024
Edit this page on GitHub
← Naming convention
Enum →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/basics/index.html b/docs/basics/index.html index 9ff512e1..33000759 100644 --- a/docs/basics/index.html +++ b/docs/basics/index.html @@ -1,4 +1,4 @@ -Basics - Tableau +

See Protobuf style: enums.

Examples

NameStyleExample
workbookPascalCaseHelloWorld.xlsx
worksheetPascalCaseHelloWorld
struct (message)PascalCaseHelloWorld
field (column)PascalCaseHelloWorld
Last modified on September 2, 2024
Edit this page on GitHub
← Concepts
Grammar and types →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/basics/predefined-types/index.html b/docs/basics/predefined-types/index.html index b19dfac3..c2a99f99 100644 --- a/docs/basics/predefined-types/index.html +++ b/docs/basics/predefined-types/index.html @@ -1,4 +1,4 @@ -Predefined types - Tableau +

Variable naming

In horizontal map or horizontal list, you can define custom variable name with the predefined struct.

Last modified on September 2, 2024
Edit this page on GitHub
← Enum
Overview →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/basics/sitemap.xml b/docs/basics/sitemap.xml index d46f12e7..8ac61f5f 100644 --- a/docs/basics/sitemap.xml +++ b/docs/basics/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/basics/concepts/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/naming-convention/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/grammar-and-types/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/predefined-types/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/basics/concepts/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/naming-convention/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/grammar-and-types/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/predefined-types/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/csv/index.html b/docs/csv/index.html index e3caa8c4..0d065550 100644 --- a/docs/csv/index.html +++ b/docs/csv/index.html @@ -1,4 +1,4 @@ -CSV - Tableau

Overview

Intro to CSV workbook and worksheet.

Concepts

As Tableau recognizes the pattern <BookName>#<SheetName>.csv, so a CSV workbook (Glob Pattern) <BookName>#*.csv is composed of multiple CSV worksheets (files) in the same directory.

E.g.:

A CSV workbook HelloWorld#*.csv is composed of three CSV worksheets:

  1. Worksheet Item: HelloWorld#Item.csv
  2. Worksheet Activity: HelloWorld#Activity.csv
  3. Worksheet @TABLEAU: HelloWorld#@TABLEAU.csv

Guide

As the CSV worksheet is same as the Excel worksheet, so just read Excel Guide โ†’

Last modified on August 28, 2024
Edit this page on GitHub
← Metasheet
Scalar →
+Help

Overview

Intro to CSV workbook and worksheet.

Concepts

As Tableau recognizes the pattern <BookName>#<SheetName>.csv, so a CSV workbook (Glob Pattern) <BookName>#*.csv is composed of multiple CSV worksheets (files) in the same directory.

E.g.:

A CSV workbook HelloWorld#*.csv is composed of three CSV worksheets:

  1. Worksheet Item: HelloWorld#Item.csv
  2. Worksheet Activity: HelloWorld#Activity.csv
  3. Worksheet @TABLEAU: HelloWorld#@TABLEAU.csv

Guide

As the CSV worksheet is same as the Excel worksheet, so just read Excel Guide โ†’

Last modified on September 2, 2024
Edit this page on GitHub
← Metasheet
Scalar →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/csv/sitemap.xml b/docs/csv/sitemap.xml index a4724b67..a1ccea8f 100644 --- a/docs/csv/sitemap.xml +++ b/docs/csv/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/csv/overview/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/csv/overview/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/design/index.html b/docs/design/index.html index 4e065839..cd103249 100644 --- a/docs/design/index.html +++ b/docs/design/index.html @@ -1,4 +1,4 @@ -Design - Tableau

Metadata

We create an IDL called Protoconf to describe Excel's structure(metadata), based on Protobuf (proto3).

Notation

The syntax is specified using Extended Backus-Naur Form (EBNF).

Workbook -> Protoconf

Basic

workbook: (AliasTest)DemoTest, worksheet: (AliasActivity)DemoActivity

ActivityIDActivityNameActivityBeginTimeActivityDurationChapterIDChapterNameSectionIDSectionNameSectionItem1IdSectionItem1NumSectionItem2IdSectionItem2Num
map<uint32,Activity>stringtimestampdurationmap<uint32,Chapter>string[Section]uint32int32[.Item]int32int32int32int32
1activity12020-01-01 05:00:0072h1chapter11section11001110022
1activity12020-01-01 05:00:0072h1chapter12section21001110022
1activity12020-01-01 05:00:0072h2chapter21section11001110022
2activity22020-01-01 05:00:0072h3m0.5s1chapter11section11001110022
// common.proto
+Help
Metadata
We create an IDL called Protoconf to describe Excel's structure(metadata), based on Protobuf (proto3).
Notation 
The syntax is specified using Extended Backus-Naur Form (EBNF).
Workbook -> Protoconf 
Basic 
workbook: (AliasTest)DemoTest, worksheet: (AliasActivity)DemoActivity
  • protoconf file name is alias_test.proto. If with no (), name will be demo_test.proto
  • configuration message name is AliasActivity. If with no (), name will be DemoActivity
  • list: [ELEM-TYPE]COLUMN-TYPE, COLUMN-TYPE is column type, ELEM-TYPE is message name and list prefix (must not conflict with the protobuf keyword).
  • map: map<KEY-TYPE,VALUE-TYPE>, KEY-TYPE must be scalar types, and VALUE-TYPE is message name and map prefix (must not conflict with build-in scalar type).
  • import message types: .TYPE, e.g.: .Item represents the message Item already defined in the same protobuf package, and should not redefine it.
  • well-known types
    • Timestamp: google.protobuf.Timestamp
    • Duration: google.protobuf.Duration
ActivityIDActivityNameActivityBeginTimeActivityDurationChapterIDChapterNameSectionIDSectionNameSectionItem1IdSectionItem1NumSectionItem2IdSectionItem2Num
map<uint32,Activity>stringtimestampdurationmap<uint32,Chapter>string[Section]uint32int32[.Item]int32int32int32int32
1activity12020-01-01 05:00:0072h1chapter11section11001110022
1activity12020-01-01 05:00:0072h1chapter12section21001110022
1activity12020-01-01 05:00:0072h2chapter21section11001110022
2activity22020-01-01 05:00:0072h3m0.5s1chapter11section11001110022
// common.proto
 message Item {
   int32 id = 1 [(tableau.field).name = "Id"];
   int32 num= 2 [(tableau.field).name = "Num"];
@@ -107,8 +107,8 @@
     string desc= 2;
   }
 }
-
  • Incell message: comma seperated sequence: {TYPE [NAME],TYPE [NAME]}, NAME is optional, and will be auto generated as field + <tagid> if not specified.
  • Incell list: []TYPE, TYPE must be scalar type.
  • Incell map: map[KEY]VALUE, KEY and VALUE must be scalar types.
  • Incell message list: []TYPE, TYPE must be message type.
  • Incell message map: map[KEY]VALUE, KEY is scalar, and VALUE must be message type.
Protoconf -> Workbook 
TODO…
Last modified on August 28, 2024
Edit this page on GitHub
← Overview
Scalar →

+

Protoconf -> Workbook

TODO…

Last modified on September 2, 2024
Edit this page on GitHub
← Overview
Scalar →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/design/overview/index.html b/docs/design/overview/index.html index 2a2dde44..b720b04e 100644 --- a/docs/design/overview/index.html +++ b/docs/design/overview/index.html @@ -1,4 +1,4 @@ -Overview - Tableau +2019-10-12 07:20:50.52Z # This is only accepted in RFC 3339 (without T)

Use RFC 3339 , which is following ISO 8601.

Transpose

Validation

Error Message

Performace

Last modified on September 2, 2024
Edit this page on GitHub
← FAQ
Metadata →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/design/sitemap.xml b/docs/design/sitemap.xml index bb98746d..583714d0 100644 --- a/docs/design/sitemap.xml +++ b/docs/design/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/design/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/design/metadata/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/design/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/design/metadata/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/excel/field-property/index.html b/docs/excel/field-property/index.html index a7bbe785..d054838e 100644 --- a/docs/excel/field-property/index.html +++ b/docs/excel/field-property/index.html @@ -1,4 +1,4 @@ -Field property - Tableau

Field property

Different properties of tableau field.

Overview

OptionTypeDescription
uniqueboolCheck map key uniqueness.
Default: false.
rangestringFormat: "left, right". E.g.: "1,10", "1,~", "~,10".
Different interpretations of range:
- number: value range.
- string: count of utf-8 code point.
referstringFormat: "SheetName(SheetAlias).ColumnName".
Ensure this field is in another sheet’s column value space. Multiple refers are comma-separated.
sequenceint64Ensure this field’s value is a sequence and begins with this value.
defaultstringUse this default value if cell is empty.
fixedboolAuto-detected fixed size of horizontal list/map.
Default: false.
sizeuint32Specify fixed size of horizontal list/map.
formFormSpecify cell data form of incell struct.
- FORM_TEXT
- FORM_JSON
json_namestringSpecify field’s custom JSON name instead of lowerCamelCase name of proto field name.
presentboolMust fill cell data explicitly if present is true.
Default: false.

Option unique

Option unique can be specified as true in the map field property. Then the tableauc will report an error if a duplicate key is appeared.

Option range

Option range can be specified as format: "left, right" (left and right are both inclusive).

Different interpretations of range:

Option refer

Option refer is some like the FOREIGN KEY constraint in SQL to prevent actions that would destroy links between tables. However, tableau refer can refer to any sheet’s column even if it is not map key column, and multiple refers (comma-separated) are also supported. It is used to ensure this field is at least in one of the other sheets' column value space (aka message’s field value space).

Format: "SheetName(SheetAlias).ColumnName[,SheetName(SheetAlias).ColumnName]...".

For example:

Option sequence

Option sequence is used to ensure this fieldโ€™s value is a sequence and begins with this value, and mainly used for map key and list element.

For example:

Option default

If option default is set, then use it as default value if cell is empty.

Option fixed

If option fixed is set as true, then auto-detect fixed size of horizontal list/map.

For example:

Option size

Option size is used to specify fixed size of horizontal list/map.

For example:

Option form

Option form is used to specify cell data form of incell struct.

Two kinds of form can be specified:

For detailed demos, see Advanced predefined incell struct โ†’.

Option json_name

By default, JSON name is deduced from the field’s proto name by converting it to camelCase. Now you -can explicitly specify it by json_name prop option.

For example:

For example, a worksheet ItemConf in HelloWorld.xlsx:

IDRarity_1SpecialEffect_2
map<int32, Item>int32|{json_name:“rarity_1”}int32|{json_name:“specialEffect_2”}
Item’s IDItem’s rarity.Item’s special effect.
110101
220102
330103

Option present

If option present is set as true, then cell data cannot be empty and must be filled explicitly. -Otherwise an error will be reported.

Last modified on August 28, 2024
Edit this page on GitHub
← Infinite nesting
Metasheet →
+can explicitly specify it by json_name prop option.

For example:

For example, a worksheet ItemConf in HelloWorld.xlsx:

IDRarity_1SpecialEffect_2
map<int32, Item>int32|{json_name:“rarity_1”}int32|{json_name:“specialEffect_2”}
Item’s IDItem’s rarity.Item’s special effect.
110101
220102
330103

Option present

If option present is set as true, then cell data cannot be empty and must be filled explicitly. +Otherwise an error will be reported.

Last modified on September 2, 2024
Edit this page on GitHub
← Infinite nesting
Metasheet →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/index.html b/docs/excel/index.html index d6e98ab4..1c952a9c 100644 --- a/docs/excel/index.html +++ b/docs/excel/index.html @@ -1,4 +1,4 @@ -Excel - Tableau +
Last modified on September 2, 2024
Edit this page on GitHub
← Map in map
Field property →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/list-in-list/index.html b/docs/excel/list-in-list/index.html index 83168bf8..3def067e 100644 --- a/docs/excel/list-in-list/index.html +++ b/docs/excel/list-in-list/index.html @@ -1,4 +1,4 @@ -List in list - Tableau

List in list

The nesting specification of list in list.

Nested in vertical-list

Horizontal-list in vertical-list

A worksheet ItemConf in HelloWorld.xlsx:

IDNameProp1IDProp1ValueProp2IDProp2Value
[Item]uint32string[Prop]int32int64int32int64
Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
1Apple110220
2Orange330
3Banana

Generated:

hello_world.proto
// --snip--
+Help
List in list
The nesting specification of list in list.
Nested in vertical-list 
Horizontal-list in vertical-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDNameProp1IDProp1ValueProp2IDProp2Value
[Item]uint32string[Prop]int32int64int32int64
Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
1Apple110220
2Orange330
3Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -80,7 +80,7 @@
         }
     ]
 }
-
Vertical-list in vertical-keyed-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDNamePropIDPropValue
[Item]<uint32>string[Prop]int32int64
Item’s IDItem’s nameProp’s IDProp’s value
1Apple110
2Orange120
2Banana230
Generated:
hello_world.proto
// --snip--
+
Vertical-list in vertical-keyed-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDNamePropIDPropValue
[Item]<uint32>string[Prop]int32int64
Item’s IDItem’s nameProp’s IDProp’s value
1Apple110
2Orange120
2Banana230
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -125,7 +125,7 @@
         }
     ]
 }
-
Incell-list in vertical-keyed-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDProp
[Item]uint32[]int32
Item’s IDItem’s props
110,20,30
210,20
310
Generated:
hello_world.proto
// --snip--
+
Incell-list in vertical-keyed-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDProp
[Item]uint32[]int32
Item’s IDItem’s props
110,20,30
210,20
310
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -162,7 +162,7 @@
         }
     ]
 }
-
First-field in horizontal-list 
Horizontal-list in horizontal-list 
A worksheet ItemConf in HelloWorld.xlsx:
Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
[Reward][Item]int32int32int32int32stringint32int32string
Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
110220Lotto10100Super Lotto
Generated:
hello_world.proto
// --snip--
+
First-field in horizontal-list 
Horizontal-list in horizontal-list 
A worksheet ItemConf in HelloWorld.xlsx:
Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
[Reward][Item]int32int32int32int32stringint32int32string
Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
110220Lotto10100Super Lotto
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -208,7 +208,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
[Reward][.Item]int32int32int32int32stringint32int32string
Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
110220Lotto10100Super Lotto
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
[Reward][.Item]int32int32int32int32stringint32int32string
Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
110220Lotto10100Super Lotto
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -247,8 +247,8 @@
         }
     ]
 }
-
Last modified on August 28, 2024
Edit this page on GitHub
← Struct in map
List in map →

+
Last modified on September 2, 2024
Edit this page on GitHub
← Struct in map
List in map →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/list-in-map/index.html b/docs/excel/list-in-map/index.html index 57ca6691..24fb1ab1 100644 --- a/docs/excel/list-in-map/index.html +++ b/docs/excel/list-in-map/index.html @@ -1,4 +1,4 @@ -List in map - Tableau

List in map

The nesting specification of list in map.

Nested in vertical-map

Horizontal-list in vertical-map

A worksheet ItemConf in HelloWorld.xlsx:

IDNameProp1IDProp1ValueProp2IDProp2Value
map<uint32, Item>string[Prop]int32int64int32int64
Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
1Apple110220
2Orange330
3Banana

Generated:

hello_world.proto
// --snip--
+Help
List in map
The nesting specification of list in map.
Nested in vertical-map 
Horizontal-list in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDNameProp1IDProp1ValueProp2IDProp2Value
map<uint32, Item>string[Prop]int32int64int32int64
Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
1Apple110220
2Orange330
3Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -80,7 +80,7 @@
         }
     }
 }
-
Vertical-list in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDNamePropIDPropValue
map<uint32, Item>string[Prop]int32int64
Item’s IDItem’s nameProp’s IDProp’s value
1Apple110
2Orange120
2Banana230
Generated:
hello_world.proto
// --snip--
+
Vertical-list in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDNamePropIDPropValue
map<uint32, Item>string[Prop]int32int64
Item’s IDItem’s nameProp’s IDProp’s value
1Apple110
2Orange120
2Banana230
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -125,7 +125,7 @@
         }
     }
 }
-
Incell-list in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDProp
map<uint32, Item>[]int32
Item’s IDItem’s props
110,20,30
210,20
310
Generated:
hello_world.proto
// --snip--
+
Incell-list in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDProp
map<uint32, Item>[]int32
Item’s IDItem’s props
110,20,30
210,20
310
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -162,8 +162,8 @@
         }
     }
 }
-
Last modified on August 28, 2024
Edit this page on GitHub
← List in list
Map in list →

+
Last modified on September 2, 2024
Edit this page on GitHub
← List in list
Map in list →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/list/index.html b/docs/excel/list/index.html index 6aaf9797..3db8c7be 100644 --- a/docs/excel/list/index.html +++ b/docs/excel/list/index.html @@ -1,4 +1,4 @@ -List - Tableau

List

This guide demonstrates different features of list type.

Horizontal list

There are three kinds of horizontal list:

  1. Horizontal scalar/enum list, as element type is scalar. E.g: []int32.
  2. Horizontal incell struct list, as element type is incell struct. E.g: []{int32 ID, string Name}Item.
  3. Horizontal struct list, as element type is struct. E.g: [Item]int32.

Horizontal scalar list

A worksheet ItemConf in HelloWorld.xlsx:

Param1Param2Param3
[]int32int32int32
Param1’s valueParam2’s valueParam3’s value
123

Generated:

hello_world.proto
// --snip--
+Help
List
This guide demonstrates different features of list type.
Horizontal list 
There are three kinds of horizontal list:
  1. Horizontal scalar/enum list, as element type is scalar. E.g: []int32.
  2. Horizontal incell struct list, as element type is incell struct. E.g: []{int32 ID, string Name}Item.
  3. Horizontal struct list, as element type is struct. E.g: [Item]int32.
Horizontal scalar list 
A worksheet ItemConf in HelloWorld.xlsx:
Param1Param2Param3
[]int32int32int32
Param1’s valueParam2’s valueParam3’s value
123
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -51,7 +51,7 @@
   FRUIT_TYPE_ORANGE  = 3 [(tableau.evalue).name = "Orange"];
   FRUIT_TYPE_BANANA  = 4 [(tableau.evalue).name = "Banana"];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
Param1Param2Param3
[]enum<.FruitType>enum<.FruitType>enum<.FruitType>
Param1’s valueParam2’s valueParam3’s value
1FRUIT_TYPE_ORANGEBanana
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
Param1Param2Param3
[]enum<.FruitType>enum<.FruitType>enum<.FruitType>
Param1’s valueParam2’s valueParam3’s value
1FRUIT_TYPE_ORANGEBanana
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -67,7 +67,7 @@
         "FRUIT_TYPE_BANANA"
     ]
 }
-
Horizontal struct list 
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
[Item]uint32stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple2Orange3Banana
Generated:
hello_world.proto
// --snip--
+
Horizontal struct list 
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
[Item]uint32stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple2Orange3Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -99,7 +99,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NumItem2IDItem2NumItem3IDItem3Num
[.Item]int32int32int32int32int32int32
Item1’s IDItem1’s numItem2’s IDItem3’s numItem3’s IDItem3’s num
110022003300
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NumItem2IDItem2NumItem3IDItem3Num
[.Item]int32int32int32int32int32int32
Item1’s IDItem1’s numItem2’s IDItem3’s numItem3’s IDItem3’s num
110022003300
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -124,7 +124,7 @@
         }
     ]
 }
-
Horizontal incell-struct list 
A worksheet ItemConf in HelloWorld.xlsx:
Item1Item2Item3
[]{int32 ID, string Name}ItemItemItem
Item1’s infoItem2’s infoItem3’s info
1,Apple2,Orange3,Banana
Generated:
hello_world.proto
// --snip--
+
Horizontal incell-struct list 
A worksheet ItemConf in HelloWorld.xlsx:
Item1Item2Item3
[]{int32 ID, string Name}ItemItemItem
Item1’s infoItem2’s infoItem3’s info
1,Apple2,Orange3,Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -156,7 +156,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
Item1Item2Item3
[]{.Item}.Item.Item
Item1’s infoItem2’s infoItem3’s info
1,1002,2003,300
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
Item1Item2Item3
[]{.Item}.Item.Item
Item1’s infoItem2’s infoItem3’s info
1,1002,2003,300
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -181,7 +181,7 @@
         }
     ]
 }
-
Vertical list 
There are two kinds of vertical list:
  1. Vertical scalar list, as list element type is scalar. E.g: []int32.
  2. Vertical struct list, as list element type is struct. E.g: [Item]int32.
Vertical scalar list 
No need to support, use [Item]SCALAR instead:
  • [Item]int32
  • [Item]enum<.FruitType>
Vertical struct list 
A worksheet ItemConf in HelloWorld.xlsx:
IDNameDesc
[Item]uint32stringstring
Item’s IDItem’s nameItem’s desc
1AppleA kind of delicious fruit.
2OrangeA kind of sour fruit.
3BananaA kind of calorie-rich fruit.
Generated:
hello_world.proto
// --snip--
+
Vertical list 
There are two kinds of vertical list:
  1. Vertical scalar list, as list element type is scalar. E.g: []int32.
  2. Vertical struct list, as list element type is struct. E.g: [Item]int32.
Vertical scalar list 
No need to support, use [Item]SCALAR instead:
  • [Item]int32
  • [Item]enum<.FruitType>
Vertical struct list 
A worksheet ItemConf in HelloWorld.xlsx:
IDNameDesc
[Item]uint32stringstring
Item’s IDItem’s nameItem’s desc
1AppleA kind of delicious fruit.
2OrangeA kind of sour fruit.
3BananaA kind of calorie-rich fruit.
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -217,7 +217,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
IDNum
[.Item]int32int32
Item’s IDItem’s num
1100
2200
3300
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
IDNum
[.Item]int32int32
Item’s IDItem’s num
1100
2200
3300
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -242,7 +242,7 @@
         }
     ]
 }
-
Vertical incell-struct list 
A worksheet ItemConf in HelloWorld.xlsx:
Item
[]{int32 ID,int32 Num}Item
Item’s info
1,100
2,200
3,300
Generated:
hello_world.proto
// --snip--
+
Vertical incell-struct list 
A worksheet ItemConf in HelloWorld.xlsx:
Item
[]{int32 ID,int32 Num}Item
Item’s info
1,100
2,200
3,300
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -274,7 +274,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
Item
[]{.Item}
Item’s info
1,100
2,200
3,300
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
Item
[]{.Item}
Item’s info
1,100
2,200
3,300
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -299,7 +299,7 @@
         }
     ]
 }
-
Incell list 
There are two kinds of in-cell list:
  1. Incell scalar list, as list value type is scalar. E.g: []int32.
  2. Incell struct list, as list value type is struct. E.g: [Item]int32.
Incell scalar list 
A worksheet ItemConf in HelloWorld.xlsx:
Param
[]int32
Param list
1,2,3
4,5
6
The Param column’s type is incell list []int32, as the list element is scalar type int32.
Generated:
hello_world.proto
// --snip--
+
Incell list 
There are two kinds of in-cell list:
  1. Incell scalar list, as list value type is scalar. E.g: []int32.
  2. Incell struct list, as list value type is struct. E.g: [Item]int32.
Incell scalar list 
A worksheet ItemConf in HelloWorld.xlsx:
Param
[]int32
Param list
1,2,3
4,5
6
The Param column’s type is incell list []int32, as the list element is scalar type int32.
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -317,7 +317,7 @@
         6
     ]
 }
-
Incell struct list 
No need to support.
Horizontal list size 
Dynamic size 
By default, all lists are Dynamically Sized Types. List elements should be present continuously, otherwise an error is reported if an empty element is existed in between.
Fixed size 
Implicit fixed size 
The list size is auto resolved by the max present list elements in name row.
In this example below, though the second element Item2 is empty, it is legal as the field property fixed is set true. Besides, Item2 will also be generated as an empty element. You can see it in the generated file ItemConf.json.
A worksheet ItemConf in HelloWorld.xlsx.
Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
[Item]uint32|{fixed:true}stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple3Banana
Generated:
hello_world.proto
// --snip--
+
Incell struct list 
No need to support.
Horizontal list size 
Dynamic size 
By default, all lists are Dynamically Sized Types. List elements should be present continuously, otherwise an error is reported if an empty element is existed in between.
Fixed size 
Implicit fixed size 
The list size is auto resolved by the max present list elements in name row.
In this example below, though the second element Item2 is empty, it is legal as the field property fixed is set true. Besides, Item2 will also be generated as an empty element. You can see it in the generated file ItemConf.json.
A worksheet ItemConf in HelloWorld.xlsx.
Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
[Item]uint32|{fixed:true}stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple3Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -345,7 +345,7 @@
         }
     ]
 }
-
Explicit fixed size 
The list size is explicitly set by field property size.
In this example below, field property size is set as 2, then list elements after the second element Item2 will all be truncated. Besides, Item2 will also be generated as an empty element. You can see it in the generated file ItemConf.json.
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
[Item]uint32|{size:2}stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple3Banana
Generated:
hello_world.proto
// --snip--
+
Explicit fixed size 
The list size is explicitly set by field property size.
In this example below, field property size is set as 2, then list elements after the second element Item2 will all be truncated. Besides, Item2 will also be generated as an empty element. You can see it in the generated file ItemConf.json.
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
[Item]uint32|{size:2}stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple3Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -369,7 +369,7 @@
         }
     ]
 }
-
Advanced features 
Horizontal column-skipped list 
A worksheet ItemConf in HelloWorld.xlsx:
DProp1IDProp1ValueProp2IDProp2Value
map<uint32, Item>[Prop]int32int32int32int32
Item’s IDProp1โ€™s IDProp1โ€™s nameProp1โ€™s valueProp2โ€™s IDProp2โ€™s nameProp2โ€™s value
11Apple1002Orange200
23Banana3004Pomelo400
35Watermelon500
Generated:
hello_world.proto
// --snip--
+
Advanced features 
Horizontal column-skipped list 
A worksheet ItemConf in HelloWorld.xlsx:
DProp1IDProp1ValueProp2IDProp2Value
map<uint32, Item>[Prop]int32int32int32int32
Item’s IDProp1โ€™s IDProp1โ€™s nameProp1โ€™s valueProp2โ€™s IDProp2โ€™s nameProp2โ€™s value
11Apple1002Orange200
23Banana3004Pomelo400
35Watermelon500
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -424,7 +424,7 @@
         }
     }
 }
-
Keyed list 
Keyed list is same as normal list, except that ColumnType (first field type) is surrounded by angle brackets <>, and is treated as map key.
Syntax: [ElemType]<ColumnType>
Vertical struct keyed-list 
For example, a worksheet ItemConf in HelloWorld.xlsx:
IDPropIDPropName
[Item]<uint32>map<int32, Prop>string
Item’s IDProp’s IDProp’s name
11sweet
21sweet
22delicious
Generated:
hello_world.proto
// --snip--
+
Keyed list 
Keyed list is same as normal list, except that ColumnType (first field type) is surrounded by angle brackets <>, and is treated as map key.
Syntax: [ElemType]<ColumnType>
Vertical struct keyed-list 
For example, a worksheet ItemConf in HelloWorld.xlsx:
IDPropIDPropName
[Item]<uint32>map<int32, Prop>string
Item’s IDProp’s IDProp’s name
11sweet
21sweet
22delicious
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -466,7 +466,7 @@
         }
     ]
 }
-
Scalar keyed-list 
A worksheet ItemConf in HelloWorld.xlsx:
Param
[]<int32>
Param list
1,2,2,3
Generated:
hello_world.proto
// --snip--
+
Scalar keyed-list 
A worksheet ItemConf in HelloWorld.xlsx:
Param
[]<int32>
Param list
1,2,2,3
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -481,8 +481,8 @@
         3
     ]
 }
-
Last modified on August 28, 2024
Edit this page on GitHub
← Union
Map →

+
Last modified on September 2, 2024
Edit this page on GitHub
← Union
Map →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/map-in-list/index.html b/docs/excel/map-in-list/index.html index 82bc49a7..f2b51b12 100644 --- a/docs/excel/map-in-list/index.html +++ b/docs/excel/map-in-list/index.html @@ -1,4 +1,4 @@ -Map in list - Tableau

Map in list

The nesting specification of map in list.

Nested in vertical-list

Horizontal-map in vertical-list

A worksheet ItemConf in HelloWorld.xlsx:

IDNameProp1IDProp1ValueProp2IDProp2Value
[Item]uint32stringmap<int32, Prop>int64int32int64
Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
1Apple110220
2Orange330
3Banana

Generated:

hello_world.proto
// --snip--
+Help
Map in list
The nesting specification of map in list.
Nested in vertical-list 
Horizontal-map in vertical-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDNameProp1IDProp1ValueProp2IDProp2Value
[Item]uint32stringmap<int32, Prop>int64int32int64
Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
1Apple110220
2Orange330
3Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -80,7 +80,7 @@
         }
     ]
 }
-
Vertical-map in vertical-keyed-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDNamePropIDPropValue
[Item]<uint32>stringmap<int32, Prop>int64
Item’s IDItem’s nameProp’s IDProp’s value
1Apple110
2Orange120
2Banana230
Generated:
hello_world.proto
// --snip--
+
Vertical-map in vertical-keyed-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDNamePropIDPropValue
[Item]<uint32>stringmap<int32, Prop>int64
Item’s IDItem’s nameProp’s IDProp’s value
1Apple110
2Orange120
2Banana230
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -125,7 +125,7 @@
         }
     ]
 }
-
Incell-map in vertical-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDProps
[Item]uint32map<int32, string>
Item’s IDItem’s props
11:sour,2:sweet,3:delicious
21:sour,2:sweet
31:sour
Generated:
hello_world.proto
// --snip--
+
Incell-map in vertical-list 
A worksheet ItemConf in HelloWorld.xlsx:
IDProps
[Item]uint32map<int32, string>
Item’s IDItem’s props
11:sour,2:sweet,3:delicious
21:sour,2:sweet
31:sour
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -162,7 +162,7 @@
         }
     ]
 }
-
First-field in horizontal-list 
Horizontal-map in horizontal-list 
A worksheet ItemConf in HelloWorld.xlsx:
Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
[Reward]map<int32, Item>int32int32int32stringint32int32string
Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
110220Lotto10100Super Lotto
Generated:
hello_world.proto
// --snip--
+
First-field in horizontal-list 
Horizontal-map in horizontal-list 
A worksheet ItemConf in HelloWorld.xlsx:
Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
[Reward]map<int32, Item>int32int32int32stringint32int32string
Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
110220Lotto10100Super Lotto
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -208,7 +208,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
[Reward]map<int32, .Item>int32int32int32stringint32int32string
Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
110220Lotto10100Super Lotto
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
[Reward]map<int32, .Item>int32int32int32stringint32int32string
Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
110220Lotto10100Super Lotto
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -247,8 +247,8 @@
         }
     ]
 }
-
Last modified on August 28, 2024
Edit this page on GitHub
← List in map
Map in map →

+
Last modified on September 2, 2024
Edit this page on GitHub
← List in map
Map in map →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/map-in-map/index.html b/docs/excel/map-in-map/index.html index ed976a80..cd036ca3 100644 --- a/docs/excel/map-in-map/index.html +++ b/docs/excel/map-in-map/index.html @@ -1,4 +1,4 @@ -Map in map - Tableau

Map in map

The nesting specification of map in map.

Nested in vertical-map

Horizontal-map in vertical-map

A worksheet ItemConf in HelloWorld.xlsx:

IDNameProp1IDProp1ValueProp2IDProp2Value
map<uint32, Item>stringmap<int32, Prop>int64int32int64
Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
1Apple110220
2Orange330
3Banana

Generated:

hello_world.proto
// --snip--
+Help
Map in map
The nesting specification of map in map.
Nested in vertical-map 
Horizontal-map in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDNameProp1IDProp1ValueProp2IDProp2Value
map<uint32, Item>stringmap<int32, Prop>int64int32int64
Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
1Apple110220
2Orange330
3Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -80,7 +80,7 @@
         }
     }
 }
-
Vertical-map in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDNamePropIDPropValue
map<uint32, Item>stringmap<int32, Prop>int64
Item’s IDItem’s nameProp’s IDProp’s value
1Apple110
2Orange120
2Orange230
Generated:
hello_world.proto
// --snip--
+
Vertical-map in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDNamePropIDPropValue
map<uint32, Item>stringmap<int32, Prop>int64
Item’s IDItem’s nameProp’s IDProp’s value
1Apple110
2Orange120
2Orange230
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -125,7 +125,7 @@
         }
     }
 }
-
Incell-map in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDProps
map<uint32, Item>map<int32, string>
Item’s IDItem’s props
11:sour,2:sweet,3:delicious
21:sour,2:sweet
31:sour
Generated:
hello_world.proto
// --snip--
+
Incell-map in vertical-map 
A worksheet ItemConf in HelloWorld.xlsx:
IDProps
map<uint32, Item>map<int32, string>
Item’s IDItem’s props
11:sour,2:sweet,3:delicious
21:sour,2:sweet
31:sour
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -162,8 +162,8 @@
         }
     }
 }
-
Last modified on August 28, 2024
Edit this page on GitHub
← Map in list
Infinite nesting →

+
Last modified on September 2, 2024
Edit this page on GitHub
← Map in list
Infinite nesting →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/map/index.html b/docs/excel/map/index.html index 5fd1b40a..e23893ec 100644 --- a/docs/excel/map/index.html +++ b/docs/excel/map/index.html @@ -1,4 +1,4 @@ -Map - Tableau

Map

This guide demonstrates different features of map type.

Horizontal map

There are some kinds of horizontal map:

  1. Horizontal scalar map, as map value type is scalar. E.g: map<int32, int32>.
  2. Horizontal struct map, as map value type is struct. E.g: map<int32, Item>.
  3. Horizontal predefined-struct map, as map value type is predefined struct. E.g: map<int32, .Item>.

Horizontal scalar map

No need to support, use this instead: map<int32, Item>.

Horizontal struct map

A worksheet ItemConf in HelloWorld.xlsx:

Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
map<uint32, Item>stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple2Orange3Banana

Generated:

hello_world.proto
// --snip--
+Help
Map
This guide demonstrates different features of map type.
Horizontal map 
There are some kinds of horizontal map:
  1. Horizontal scalar map, as map value type is scalar. E.g: map<int32, int32>.
  2. Horizontal struct map, as map value type is struct. E.g: map<int32, Item>.
  3. Horizontal predefined-struct map, as map value type is predefined struct. E.g: map<int32, .Item>.
Horizontal scalar map 
No need to support, use this instead: map<int32, Item>.
Horizontal struct map 
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
map<uint32, Item>stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple2Orange3Banana
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -62,7 +62,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NumItem2IDItem2NumItem3IDItem3Num
map<int32, .Item>int32int32int32int32int32
Item1’s IDItem1’s numItem2’s IDItem3’s numItem3’s IDItem3’s num
110022003300
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
Item1IDItem1NumItem2IDItem2NumItem3IDItem3Num
map<int32, .Item>int32int32int32int32int32
Item1’s IDItem1’s numItem2’s IDItem3’s numItem3’s IDItem3’s num
110022003300
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -87,7 +87,7 @@
         }
     }
 }
-
Vertical map 
There are some kinds of vertical map:
  1. Vertical scalar map, as map value type is scalar. E.g: map<int32, int32>.
  2. Vertical struct map, as map value type is struct. E.g: map<int32, Item>.
  3. Vertical predefined-struct map, as map value type is predefined struct. E.g: map<int32, .Item>.
Vertical scalar map 
No need to support, use map<int32, Item> instead.
Vertical struct map 
A worksheet ItemConf in HelloWorld.xlsx:
IDNameDesc
map<uint32, Item>stringstring
Itemโ€™s IDItemโ€™s nameItemโ€™s desc
1AppleA kind of delicious fruit.
2OrangeA kind of sour fruit.
3BananaA kind of calorie-rich fruit.
Generated:
hello_world.proto
// --snip--
+
Vertical map 
There are some kinds of vertical map:
  1. Vertical scalar map, as map value type is scalar. E.g: map<int32, int32>.
  2. Vertical struct map, as map value type is struct. E.g: map<int32, Item>.
  3. Vertical predefined-struct map, as map value type is predefined struct. E.g: map<int32, .Item>.
Vertical scalar map 
No need to support, use map<int32, Item> instead.
Vertical struct map 
A worksheet ItemConf in HelloWorld.xlsx:
IDNameDesc
map<uint32, Item>stringstring
Itemโ€™s IDItemโ€™s nameItemโ€™s desc
1AppleA kind of delicious fruit.
2OrangeA kind of sour fruit.
3BananaA kind of calorie-rich fruit.
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -123,7 +123,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
A worksheet ItemConf in HelloWorld.xlsx:
IDNum
map<int32, .Item>int32
Item’s IDItem’s num
1100
2200
3300
Generated:
hello_world.proto
// --snip--
+
A worksheet ItemConf in HelloWorld.xlsx:
IDNum
map<int32, .Item>int32
Item’s IDItem’s num
1100
2200
3300
Generated:
hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -148,7 +148,7 @@
         }
     }
 }
-
Incell map 
There are some kinds of in-cell map:
  1. in-cell scalar map, as map value type is scalar. E.g: map<int32, int32>.
  2. in-cell struct map, as map value type is struct. E.g: map<int32, Item>.
Incell scalar map 
A worksheet ItemConf in HelloWorld.xlsx:
Items
map<uint32, string>
Items
1:Apple,2:Orange,3:Banana,4,:Peach
The Items column’s type is in-cell map map<uint32, string>, as the map value is scalar type string.
โš ๏ธ NOTE: If you want explicit pattern like: [Key:Value]..., then set the field property present as true.
+

Incell map

There are some kinds of in-cell map:

  1. in-cell scalar map, as map value type is scalar. E.g: map<int32, int32>.
  2. in-cell struct map, as map value type is struct. E.g: map<int32, Item>.

Incell scalar map

A worksheet ItemConf in HelloWorld.xlsx:

Items
map<uint32, string>
Items
1:Apple,2:Orange,3:Banana,4,:Peach

The Items column’s type is in-cell map map<uint32, string>, as the map value is scalar type string.

โš ๏ธ NOTE: If you want explicit pattern like: [Key:Value]..., then set the field property present as true. See Option present โ†’.

Generated:

hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -179,7 +179,7 @@
   FRUIT_FLAVOR_SOUR = 2 [(tableau.evalue).name = "Sour"];
   FRUIT_FLAVOR_SWEET = 3 [(tableau.evalue).name = "Sweet"];
 }
-

A worksheet ItemConf in HelloWorld.xlsx:

FruitFlavorItem
map<enum<.FruitType>, int64>map<int64, enum<.FruitFlavor»map<enum<.FruitType>, enum<.FruitFlavor»
FruitsFlavorsItems
Apple:1,Orange:21:Fragrant,2:SweetApple:Fragrant,Orange:Sour

Generated:

hello_world.proto
// --snip--
+

A worksheet ItemConf in HelloWorld.xlsx:

FruitFlavorItem
map<enum<.FruitType>, int64>map<int64, enum<.FruitFlavor»map<enum<.FruitType>, enum<.FruitFlavor»
FruitsFlavorsItems
Apple:1,Orange:21:Fragrant,2:SweetApple:Fragrant,Orange:Sour

Generated:

hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -224,7 +224,7 @@
         }
     }
 }
-

Empty key map

If map key is not configured, then it will be treated as default value of map key type. Default value is illustrated at Scalar types โ†’.

A worksheet ItemConf in HelloWorld.xlsx:

IDDesc
map<uint32, Item>string
Item’s IDItem’s name
1Apple
Orange
3Banana

Generated:

hello_world.proto
// --snip--
+

Empty key map

If map key is not configured, then it will be treated as default value of map key type. Default value is illustrated at Scalar types โ†’.

A worksheet ItemConf in HelloWorld.xlsx:

IDDesc
map<uint32, Item>string
Item’s IDItem’s name
1Apple
Orange
3Banana

Generated:

hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -266,7 +266,7 @@
   FruitType key = 1;
   ...
 }
-

A worksheet ItemConf in HelloWorld.xlsx:

TypePrice
map<enum<.FruitType>, Item>int32
Item’s typeItem’s price
Apple100
Orange200
Banana300

Generated:

hello_world.proto
// --snip--
+

A worksheet ItemConf in HelloWorld.xlsx:

TypePrice
map<enum<.FruitType>, Item>int32
Item’s typeItem’s price
Apple100
Orange200
Banana300

Generated:

hello_world.proto
// --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -295,7 +295,7 @@
         }
     }
 }
-

Horizontal map size

Dynamic size

By default, all maps are Dynamically Sized Types. Map items should be present continuously, otherwise an error is reported if an empty item is existed in between.

Fixed size

Implicit fixed size

The map size is auto resolved by the max map items present in name row.

In this example below, though the second map item Item2 is empty, it is legal as the field property fixed is set true. Besides, Item2 will also be generated as an empty map item. You can see it in the generated file ItemConf.json.

A worksheet ItemConf in HelloWorld.xlsx:

Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
map<uint32, Item>|{fixed:true}stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple3Banana

Generated:

hello_world.proto
// --snip--
+

Horizontal map size

Dynamic size

By default, all maps are Dynamically Sized Types. Map items should be present continuously, otherwise an error is reported if an empty item is existed in between.

Fixed size

Implicit fixed size

The map size is auto resolved by the max map items present in name row.

In this example below, though the second map item Item2 is empty, it is legal as the field property fixed is set true. Besides, Item2 will also be generated as an empty map item. You can see it in the generated file ItemConf.json.

A worksheet ItemConf in HelloWorld.xlsx:

Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
map<uint32, Item>|{fixed:true}stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple3Banana

Generated:

hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -323,7 +323,7 @@
         }
     }
 }
-

Explicit fixed size

The map size is explicitly set by field property size.

In this example below, field property size is set as 2, then map items after the second item Item2 will all be truncated. Besides, Item2 will also be generated as an empty map item. You can see it in the generated file ItemConf.json.

A worksheet ItemConf in HelloWorld.xlsx:

Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
map<uint32, Item>|{size:2}stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple3Banana

Generated:

hello_world.proto
// --snip--
+

Explicit fixed size

The map size is explicitly set by field property size.

In this example below, field property size is set as 2, then map items after the second item Item2 will all be truncated. Besides, Item2 will also be generated as an empty map item. You can see it in the generated file ItemConf.json.

A worksheet ItemConf in HelloWorld.xlsx:

Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
map<uint32, Item>|{size:2}stringuint32stringuint32string
Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
1Apple3Banana

Generated:

hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -347,7 +347,7 @@
         }
     }
 }
-

Advanced features

Horizontal column-skipped map

A worksheet ItemConf in HelloWorld.xlsx:

DProp1IDProp1ValueProp2IDProp2Value
map<uint32, Item>map<int32, Prop>int32int32int32
Item’s IDProp1โ€™s IDProp1โ€™s nameProp1โ€™s valueProp2โ€™s IDProp2โ€™s nameProp2โ€™s value
11Apple1002Orange200
23Banana3004Pomelo400
35Watermelon500

Generated:

hello_world.proto
// --snip--
+

Advanced features

Horizontal column-skipped map

A worksheet ItemConf in HelloWorld.xlsx:

DProp1IDProp1ValueProp2IDProp2Value
map<uint32, Item>map<int32, Prop>int32int32int32
Item’s IDProp1โ€™s IDProp1โ€™s nameProp1โ€™s valueProp2โ€™s IDProp2โ€™s nameProp2โ€™s value
11Apple1002Orange200
23Banana3004Pomelo400
35Watermelon500

Generated:

hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -407,8 +407,8 @@
 }

Ordered-map

In the metasheet @TABLEAU, set the OrderedMap option to true, then ordered map accessers will be generated. This feature is powered by tableauio/loader. Currently supported programming languages are:

  • C++
  • Golang
  • C#

Example

If we want ItemConf to generate ordered map accessers, then set -OrderedMap option to true of metasheet @TABLEAU:

IDName
map<uint32, Item>string
Item’s IDItem’s Name
1Apple
2Orange
3Banana
SheetOrderedMap
ItemConftrue

More useful options are illustrated at metasheet chapter. Metasheet @TABLEAU โ†’

Last modified on August 28, 2024
Edit this page on GitHub
← List
Struct in struct →
+OrderedMap option to true of metasheet @TABLEAU:

IDName
map<uint32, Item>string
Item’s IDItem’s Name
1Apple
2Orange
3Banana
SheetOrderedMap
ItemConftrue

More useful options are illustrated at metasheet chapter. Metasheet @TABLEAU โ†’

Last modified on September 2, 2024
Edit this page on GitHub
← List
Struct in struct →
- \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/metasheet/index.html b/docs/excel/metasheet/index.html index 2eb64098..f6273738 100644 --- a/docs/excel/metasheet/index.html +++ b/docs/excel/metasheet/index.html @@ -1,4 +1,4 @@ -Metasheet - Tableau

Metasheet

The metasheet is a worksheet named "@TABLEAU" to specify tableau parser options.

Overview

Options below can be specified in the metasheet @TABLEAU to affect the corresponding worksheet’s layout, ability, loader and so on.

OptionTypeDescription
SheetstringThe worksheet name needed to be processed.
AliasstringRename worksheet to be used as the generated protoconf message name.
Namerowint32Exact row number of column name definition at a worksheet.
Default: 1.
Typerowint32Exact row number of column type definition at a worksheet.
Default: 2.
Noterowint32Exact row number of column note definition at a worksheet.
Default: 3.
Datarowint32Start row number of data at a worksheet.
Default: 4.
Namelineint32The line number of column name definition in a cell. 0 means the whole cell.
Default: 0.
Typelineint32The line number of column type definition in a cell. 0 means the whole cell.
Default: 0.
TransposeboolInterchanging the rows and columns of a given sheet.
NestedboolNested naming of the namerow.
Default: false.
SepstringSeparator for:
ย ย  1. separating in-cell list elements.
ย ย  2. separating in-cell map items.
Default: ,.
SubsepstringSubseparator for separating in-cell map Key-Value pair.
Default: :.
Merger[]stringMerge multiple workbook sheets (comma-separated) into this one with the same structure.
E.g.: Item1.xlsx,Item2.xlsx.
AdjacentKeyboolMerge adjacent rows with the same key. If the key cell is not set, it will be treated the same as the nearest key above the same column.
Default:false.
FieldPresenceboolIn order to track field presence of basic types (numeric, string, bytes, and enums), the generated field will be labeled optional.
Default:false.
ScatterboolConvert multiple sheets separately with same schema.
OrderedMapboolGenerate OrderedMap accessers or not.
Default: false.
Supported: C++.
Index[]stringGenerate index accessers, and multiple indexes are comma-separated.
- Single-column index is in the forma: <ColumnName>[@IndexName], if IndexName is not set, it will be this column’s parent struct type name.
- Multi-column index (or composite index) is in the form: ([column1, column2, column3,...])[@IndexName]
E.g.:
- ID
- ID@Item
- (ID,Type)
- (ID,Type)@Item
- ID, (ID,Type)@Item
Supported: C++.

Empty @TABLEAU

If metasheet @TABLEAU is empty, then all other worksheets in the same workbook will be processed.

A simple example

There is a worksheet Sheet1 in HelloWorld.xlsx, we want to rename sheet to -ItemConf, define custom seperator as |, and generate ordered map accessers.

So the metasheet @TABLEAU in HelloWorld.xlsx should be configured as:

IDName
map<uint32, Item>string
Item’s IDItem’s Name
1Apple
2Orange
3Banana
SheetAliasSepOrderedMap
Sheet1ItemConf|true

Option Transpose

In linear algebra, the transpose of a matrix is an operator which flips a matrix over its diagonal. Likewise, the transpose of a sheet (2D matrix) means interchanging its rows into columns or columns into rows.

See more details about Excel: Transpose (rotate) data from rows to columns or vice versa.

Option Transpose is specified as true in the metasheet @TABLEAU.

A worksheet HeroConf in HelloWorld.xlsx:

IDint32Hero’s ID123
NamestringHero’s nameRobin
DescstringHero’s descriptionA big hero!
Skill[]int32Hero’s skills100,101,102
SheetTranspose
HeroConftrue

Generated:

hello_world.proto
// --snip--
+ItemConf, define custom seperator as |, and generate ordered map accessers.
So the metasheet @TABLEAU in HelloWorld.xlsx should be configured as:
IDName
map<uint32, Item>string
Item’s IDItem’s Name
1Apple
2Orange
3Banana
SheetAliasSepOrderedMap
Sheet1ItemConf|true
Option Transpose 
In linear algebra, the transpose of a matrix is an operator which flips a matrix over its diagonal. Likewise, the transpose of a sheet (2D matrix) means interchanging its rows into columns or columns into rows.
See more details about Excel: Transpose (rotate) data from rows to columns or vice versa.
Option Transpose is specified as true in the metasheet @TABLEAU.
A worksheet HeroConf in HelloWorld.xlsx:
IDint32Hero’s ID123
NamestringHero’s nameRobin
DescstringHero’s descriptionA big hero!
Skill[]int32Hero’s skills100,101,102
SheetTranspose
HeroConftrue
Generated:
hello_world.proto
// --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message HeroConf {
@@ -53,7 +53,7 @@
     ]
 }
 
Option Merger 
Option Merger is used to merge multiple sheets (comma-separated) with same schema to one.
Each element can be:
  1. just a workbook file path or Glob path (relative to this workbook): <Workbook>,
-then the sheet name is the same as this sheet.
  2. a workbook file path (relative to this workbook) with a worksheet name: <Workbook>#<Worksheet>.
For example:
The first (main) workbook: a worksheet ZoneConf in MergerMain.xlsx (with @TABLEAU):
IDNameDifficulty
map<uint32, Zone>stringint32
Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
1Infinity100
SheetMerger
ZoneConfMerger*.xlsx
The second (sub) workbook: a worksheet ZoneConf in Merger2.xlsx (without @TABLEAU):
IDNameDifficulty
map<uint32, Zone>stringint32
Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
2Desert200
The third (sub) workbook: a worksheet ZoneConf in Merger3.xlsx (without @TABLEAU):
IDNameDifficulty
map<uint32, Zone>stringint32
Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
3Snowfield300
Generated:
merger_main.proto
// --snip--
+then the sheet name is the same as this sheet.
  • a workbook file path (relative to this workbook) with a worksheet name: <Workbook>#<Worksheet>.
    • For example:
    The first (main) workbook: a worksheet ZoneConf in MergerMain.xlsx (with @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    1Infinity100
    SheetMerger
    ZoneConfMerger*.xlsx
    The second (sub) workbook: a worksheet ZoneConf in Merger2.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    2Desert200
    The third (sub) workbook: a worksheet ZoneConf in Merger3.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    3Snowfield300
    Generated:
    merger_main.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ZoneConf {
@@ -86,7 +86,7 @@
     }
 }
 
    Option Scatter 
    Option Scatter is used to scatter multiple sheets (comma-separated) with same schema to different generated config files.
    Each element can be:
    1. just a workbook file path or Glob path (relative to this workbook): <Workbook>,
-then the sheet name is the same as this sheet.
    2. a workbook file path (relative to this workbook) with a worksheet name: <Workbook>#<Worksheet>.
    For example, there are three workbooks (each with same sheet schema, and Scatter1.xlsx is the main workbook):
    • Scatter1.xlsx
    • Scatter2.xlsx
    • Scatter3.xlsx
    The first (main) workbook: a worksheet ZoneConf in Scatter1.xlsx (with @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    1Infinity100
    SheetScatter
    ZoneConfScatter*.xlsx
    The second (sub) workbook: a worksheet ZoneConf in Scatter2.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    2Desert200
    The third (sub) workbook: a worksheet ZoneConf in Scatter3.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    3Snowfield300
    Generated protoconf:
    scatter_1.proto
    // --snip--
+then the sheet name is the same as this sheet.
  • a workbook file path (relative to this workbook) with a worksheet name: <Workbook>#<Worksheet>.
    • For example, there are three workbooks (each with same sheet schema, and Scatter1.xlsx is the main workbook):
    • Scatter1.xlsx
    • Scatter2.xlsx
    • Scatter3.xlsx
    The first (main) workbook: a worksheet ZoneConf in Scatter1.xlsx (with @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    1Infinity100
    SheetScatter
    ZoneConfScatter*.xlsx
    The second (sub) workbook: a worksheet ZoneConf in Scatter2.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    2Desert200
    The third (sub) workbook: a worksheet ZoneConf in Scatter3.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    3Snowfield300
    Generated protoconf:
    scatter_1.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ZoneConf {
@@ -127,8 +127,8 @@
     }
 }
 
    Option Index 
    Option Index can be specified to generate index accessers, and multiple indexes are comma-separated.
-There are two kinds of indexes in tableau: one is single-column index, and another is multi-column index (aka composite index).
    Each column type can be:
    • scalar: numbers, booleans, strings, and bytes.
    • enum: e.g.: enum<.FruiteType>
    • incell scalar list: e.g: []int32
    • incell enum list: e.g: []enum<.FruiteType>
    Example: two worksheets ItemConf and ShopConf in HelloWorld.xlsx:
    • ItemConf: index on columns of the same struct as map value.
    • ShopConf: index on columns of the same struct as list element.
    IDNameDesc
    map<int32, Item>stringstring
    Item’s IDItem’s nameItem’s desc
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    IDTypeDesc
    [Shop]int32int32string
    Shop’s IDShop’s typeShop’s desc
    11Shoes shop.
    21T-Shirt shop.
    32Fruite shop.
    SheetIndex
    ItemConfID@Item, Name@AwardItem, (ID,Name)@SpecialItem
    ShopConfID@Shop, Type@ThemeShop, (ID,Type)@SpecialShop
    Single-column index 
    Format: <ColumnName>[@IndexName].
    The sign @ is the separator between column name and index name. if IndexName is not set, it will be this columnโ€™s parent struct type name. One or more indexes can be specified by comma-separated rule.
    Examples:
    • ID
    • ID@Item
    • ID, Name@AwardItem
    • ID@Item, Name@AwardItem
    Multi-column index 
    Format: ([ColumnName1, ColumnName2, ColumnName3,...])[@IndexName].
    Multi-column index (or composite index) is composed of multiple columns in the same struct (in list or map) to increase query speed.
    The sign @ is the separator between enclosed column names by parentheses and index name. if IndexName is not set, it will be this columnโ€™s parent struct type name. One or more indexes can be specified by comma-separated rule.
    Examples:
    • (ID,Name)
    • (ID,Name)@AwardItem
    • ID@Item, (ID,Name)@AwardItem: one single-column index and one multi-column index.
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Field property
    Concepts →
    +There are two kinds of indexes in tableau: one is single-column index, and another is multi-column index (aka composite index).

    Each column type can be:

    • scalar: numbers, booleans, strings, and bytes.
    • enum: e.g.: enum<.FruiteType>
    • incell scalar list: e.g: []int32
    • incell enum list: e.g: []enum<.FruiteType>

    Example: two worksheets ItemConf and ShopConf in HelloWorld.xlsx:

    • ItemConf: index on columns of the same struct as map value.
    • ShopConf: index on columns of the same struct as list element.
    IDNameDesc
    map<int32, Item>stringstring
    Item’s IDItem’s nameItem’s desc
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    IDTypeDesc
    [Shop]int32int32string
    Shop’s IDShop’s typeShop’s desc
    11Shoes shop.
    21T-Shirt shop.
    32Fruite shop.
    SheetIndex
    ItemConfID@Item, Name@AwardItem, (ID,Name)@SpecialItem
    ShopConfID@Shop, Type@ThemeShop, (ID,Type)@SpecialShop

    Single-column index

    Format: <ColumnName>[@IndexName].

    The sign @ is the separator between column name and index name. if IndexName is not set, it will be this columnโ€™s parent struct type name. One or more indexes can be specified by comma-separated rule.

    Examples:

    • ID
    • ID@Item
    • ID, Name@AwardItem
    • ID@Item, Name@AwardItem

    Multi-column index

    Format: ([ColumnName1, ColumnName2, ColumnName3,...])[@IndexName].

    Multi-column index (or composite index) is composed of multiple columns in the same struct (in list or map) to increase query speed.

    The sign @ is the separator between enclosed column names by parentheses and index name. if IndexName is not set, it will be this columnโ€™s parent struct type name. One or more indexes can be specified by comma-separated rule.

    Examples:

    • (ID,Name)
    • (ID,Name)@AwardItem
    • ID@Item, (ID,Name)@AwardItem: one single-column index and one multi-column index.
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Field property
    Concepts →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/scalar/index.html b/docs/excel/scalar/index.html index b0c86d7f..b23c664d 100644 --- a/docs/excel/scalar/index.html +++ b/docs/excel/scalar/index.html @@ -1,4 +1,4 @@ -Scalar - Tableau

    Scalar

    This guide demonstrates different features of scalar type.

    Scalar

    A worksheet Apple in HelloWorld.xlsx:

    IDNameDesc
    uint32stringstring
    Item’s IDItem’s NameItem’s Description
    1AppleA kind of delicious fruit.

    In this worksheet, three scalar fields are defined:

    1. ID: uint32
    2. Name: string
    3. Desc: string

    Generated:

    hello_world.proto
    // --snip--
+Help
    Scalar
    This guide demonstrates different features of scalar type.
    Scalar 
    A worksheet Apple in HelloWorld.xlsx:
    IDNameDesc
    uint32stringstring
    Item’s IDItem’s NameItem’s Description
    1AppleA kind of delicious fruit.
    In this worksheet, three scalar fields are defined:
    1. ID: uint32
    2. Name: string
    3. Desc: string
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message Apple {
@@ -45,8 +45,8 @@
     "name": "Apple",
     "desc": "A kind of delicious fruit."
 }
-
    Note 
    Scalar type is usually used to define fields of struct type. Struct โ†’
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Overview
    Struct →
    
+

    Note

    Scalar type is usually used to define fields of struct type. Struct โ†’

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Overview
    Struct →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/sitemap.xml b/docs/excel/sitemap.xml index d6b3d6d3..c719ba1d 100644 --- a/docs/excel/sitemap.xml +++ b/docs/excel/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/excel/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/union/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/infinite-nesting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/field-property/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/metasheet/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/excel/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/infinite-nesting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/field-property/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/metasheet/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/excel/struct-in-list/index.html b/docs/excel/struct-in-list/index.html index 53c4849c..01348345 100644 --- a/docs/excel/struct-in-list/index.html +++ b/docs/excel/struct-in-list/index.html @@ -1,4 +1,4 @@ -Struct in list - Tableau

    Struct in list

    The nesting specification of struct in list.

    Nested in vertical-list

    Struct in vertical-list

    A worksheet ItemConf in HelloWorld.xlsx:

    IDNamePropIDPropValue
    [Item]uint32string{Prop}int32int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange220
    3Banana

    Generated:

    hello_world.proto
    // --snip--
+Help
    Struct in list
    The nesting specification of struct in list.
    Nested in vertical-list 
    Struct in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    [Item]uint32string{Prop}int32int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange220
    3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -72,7 +72,7 @@
         }
     ]
 }
-
    Incell-struct in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropID
    [Item]uint32string{int32 ID,int64 Value}Prop
    Item’s IDItem’s nameProp’s ID
    1Apple1,100
    2Orange2,200
    3Banana
    Generated:
    hello_world.proto
    // --snip--
+
    Incell-struct in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropID
    [Item]uint32string{int32 ID,int64 Value}Prop
    Item’s IDItem’s nameProp’s ID
    1Apple1,100
    2Orange2,200
    3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -114,7 +114,7 @@
         }
     ]
 }
-
    First-field in horizontal-list 
    Struct in horizontal-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1ItemIDReward1ItemNumReward1NameReward2ItemIDReward2ItemNumReward2Name
    [Reward]{Item}int32int32stringint32int32string
    Item1’s IDItem1’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
+
    First-field in horizontal-list 
    Struct in horizontal-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1ItemIDReward1ItemNumReward1NameReward2ItemIDReward2ItemNumReward2Name
    [Reward]{Item}int32int32stringint32int32string
    Item1’s IDItem1’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -152,7 +152,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1ItemIDReward1ItemNumReward1NameReward2ItemIDReward2ItemNumReward2Name
    [Reward]{.Item}int32int32stringint32int32string
    Item1’s IDItem1’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1ItemIDReward1ItemNumReward1NameReward2ItemIDReward2ItemNumReward2Name
    [Reward]{.Item}int32int32stringint32int32string
    Item1’s IDItem1’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -183,7 +183,7 @@
         }
     ]
 }
-
    Incell-struct in horizontal-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1ItemReward1NameReward2ItemReward2Name
    [Reward]{int32 ID, int32 Num}ItemstringItemstring
    Reward1’s itemReward’s nameReward2’s itemReward’s name
    1,10Lotto2,20Super Lotto
    Generated:
    hello_world.proto
    // --snip--
+
    Incell-struct in horizontal-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1ItemReward1NameReward2ItemReward2Name
    [Reward]{int32 ID, int32 Num}ItemstringItemstring
    Reward1’s itemReward’s nameReward2’s itemReward’s name
    1,10Lotto2,20Super Lotto
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -218,8 +218,8 @@
         }
     ]
 }
-
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Struct in struct
    Struct in map →
    
+
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Struct in struct
    Struct in map →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/struct-in-map/index.html b/docs/excel/struct-in-map/index.html index 60c46ca4..6c777674 100644 --- a/docs/excel/struct-in-map/index.html +++ b/docs/excel/struct-in-map/index.html @@ -1,4 +1,4 @@ -Struct in map - Tableau

    Struct in map

    The nesting specification of struct in map.

    Nested in vertical-map

    Struct in vertical-map

    A worksheet ItemConf in HelloWorld.xlsx:

    IDItemIDItemNum
    map<int32, Reward>{Item}int32int32
    Reward’s IDItem’s IDItem’s Num
    1110
    2220
    3

    Generated:

    hello_world.proto
    // --snip--
+Help
    Struct in map
    The nesting specification of struct in map.
    Nested in vertical-map 
    Struct in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDItemIDItemNum
    map<int32, Reward>{Item}int32int32
    Reward’s IDItem’s IDItem’s Num
    1110
    2220
    3
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -72,7 +72,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    IDItemIDItemNum
    map<int32, Reward>{.Item}int32int32
    Reward’s IDItem’s IDItem’s Num
    1110
    2220
    3
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    IDItemIDItemNum
    map<int32, Reward>{.Item}int32int32
    Reward’s IDItem’s IDItem’s Num
    1110
    2220
    3
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -107,7 +107,7 @@
         }
     }
 }
-
    Incell-struct in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDItem
    map<int32, Reward>{int32 ID, int32 Num}Item
    Reward’s IDItem’s info
    11,100
    22,200
    3
    Generated:
    hello_world.proto
    // --snip--
+
    Incell-struct in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDItem
    map<int32, Reward>{int32 ID, int32 Num}Item
    Reward’s IDItem’s info
    11,100
    22,200
    3
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -145,8 +145,8 @@
         }
     }
 }
-
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Struct in list
    List in list →
    
+
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Struct in list
    List in list →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/struct-in-struct/index.html b/docs/excel/struct-in-struct/index.html index 8db3c88f..10de239a 100644 --- a/docs/excel/struct-in-struct/index.html +++ b/docs/excel/struct-in-struct/index.html @@ -1,4 +1,4 @@ -Struct in struct - Tableau

    Struct in struct

    The nesting specification of struct in struct.

    Struct in struct

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardIDRewardItemIDRewardItemNum
    {Reward}int32{Item}int32int32
    Reward’s IDItem’s IDItem’s num
    1110

    Generated:

    hello_world.proto
    // --snip--
+Help
    Struct in struct
    The nesting specification of struct in struct.
    Struct in struct 
    A worksheet ItemConf in HelloWorld.xlsx:
    RewardIDRewardItemIDRewardItemNum
    {Reward}int32{Item}int32int32
    Reward’s IDItem’s IDItem’s num
    1110
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -59,7 +59,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    RewardIDRewardItemIDRewardItemNum
    {Reward}int32{.Item}int32int32
    Reward’s IDItem’s IDItem’s num
    1110
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    RewardIDRewardItemIDRewardItemNum
    {Reward}int32{.Item}int32int32
    Reward’s IDItem’s IDItem’s num
    1110
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -81,7 +81,7 @@
         }
     }
 }
-
    Incell-struct in struct 
    A worksheet ItemConf in HelloWorld.xlsx:
    RewardIDRewardItem
    {Reward}int32{int32 ID, int32 Num}Item
    Reward’s IDReward’s item
    11,100
    2,200
    Generated:
    hello_world.proto
    // --snip--
+
    Incell-struct in struct 
    A worksheet ItemConf in HelloWorld.xlsx:
    RewardIDRewardItem
    {Reward}int32{int32 ID, int32 Num}Item
    Reward’s IDReward’s item
    11,100
    2,200
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -106,8 +106,8 @@
         }
     }
 }
-
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Map
    Struct in list →
    
+
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Map
    Struct in list →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/struct/index.html b/docs/excel/struct/index.html index 8f760722..ba45bfc1 100644 --- a/docs/excel/struct/index.html +++ b/docs/excel/struct/index.html @@ -1,4 +1,4 @@ -Struct - Tableau

    Struct

    This guide demonstrates different features of struct type.

    Cross-cell struct

    Syntax: <StructType>ColumnType.

    Each column name should be prefixed with the same struct variable name, which is just the same as struct type name by default.

    For example, a worksheet ItemConf in HelloWorld.xlsx:

    PropertyIDPropertyNamePropertyDesc
    {Property}int32stringstring
    Property’s IDProperty’s NameProperty’s Description
    1OrangeA kind of sour fruit.

    Note that each column name in ItemConf is prefixed with struct variable name Property which is same as struct type name.

    Generated:

    hello_world.proto
    // --snip--
+Help
    Struct
    This guide demonstrates different features of struct type.
    Cross-cell struct 
    Syntax: <StructType>ColumnType.
    Each column name should be prefixed with the same struct variable name, which is just the same as struct type name by default.
    For example, a worksheet ItemConf in HelloWorld.xlsx:
    PropertyIDPropertyNamePropertyDesc
    {Property}int32stringstring
    Property’s IDProperty’s NameProperty’s Description
    1OrangeA kind of sour fruit.
    Note that each column name in ItemConf is prefixed with struct variable name Property which is same as struct type name.
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -50,7 +50,7 @@
         "desc":  "A kind of sour fruit."
     }
 }
-
    Note 
    Cross-cell struct is usually used together with:
    • cross-cell horizontal/vertical map, as map value type. Map โ†’
    • cross-cell horizontal/vertical list, as list element type. List โ†’
    Incell struct 
    Each field type of the struct should be scalar type.
    For example, a worksheet ItemConf in HelloWorld.xlsx:
    IDProp
    map<int32, Item>{int32 ID,string Name,string Desc}Property
    Item’s IDItem’s property.
    11,Orange,A good fruit.
    22,Apple
    33
    The Property column’s type is in-cell struct {int32 ID,string Name,string Desc}Property.
    Generated:
    hello_world.proto
    // --snip--
+
    Note 
    Cross-cell struct is usually used together with:
    • cross-cell horizontal/vertical map, as map value type. Map โ†’
    • cross-cell horizontal/vertical list, as list element type. List โ†’
    Incell struct 
    Each field type of the struct should be scalar type.
    For example, a worksheet ItemConf in HelloWorld.xlsx:
    IDProp
    map<int32, Item>{int32 ID,string Name,string Desc}Property
    Item’s IDItem’s property.
    11,Orange,A good fruit.
    22,Apple
    33
    The Property column’s type is in-cell struct {int32 ID,string Name,string Desc}Property.
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -100,7 +100,7 @@
   string name = 2 [(tableau.field) = {name:"Name"}];
   string desc = 3 [(tableau.field) = {name:"Desc"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProp
    map<uint32, Item>{.Property}
    Item’s IDItem’s property.
    11,Orange,A good fruit.
    22,Apple
    33
    The Prop column’s type is a predefined struct Property.
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProp
    map<uint32, Item>{.Property}
    Item’s IDItem’s property.
    11,Orange,A good fruit.
    22,Apple
    33
    The Prop column’s type is a predefined struct Property.
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -145,7 +145,7 @@
   int32 id = 1 [(tableau.field).name = "ID"];
   int32 num = 2 [(tableau.field).name = "Num"];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    RewardItemIDRewardItemNumCostItemIDCostItemNumPredefinedItemIDPredefinedItemNum
    {Item(RewardItem)}int32int32{Item(CostItem)}int32int32{.Item(PredefinedItem)}int32int32
    Item’s IDItem’s IDCost’s IDCost’s IDPredefined item’s IDPredefined item’s ID
    110022001020
    Details:
+

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardItemIDRewardItemNumCostItemIDCostItemNumPredefinedItemIDPredefinedItemNum
    {Item(RewardItem)}int32int32{Item(CostItem)}int32int32{.Item(PredefinedItem)}int32int32
    Item’s IDItem’s IDCost’s IDCost’s IDPredefined item’s IDPredefined item’s ID
    110022001020

    Details: In type cell {Item(RewardItem)}int32, RewardItem is the custom variable name of new defined struct Item. And in type cell {Item(CostItem)}int32, CostItem is the custom variable name of just already defined struct Item in the same scope. Finally, in type cell {.Item(PredefinedItem)}int32, PredefinedItem is the custom variable name of predefined struct Item at global (at the same protobuf package).

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -185,7 +185,7 @@
   float y = 2;
   float z = 3;
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    Transform1Transform2
    {.Transform}|{form:FORM_TEXT}{.Transform}|{form:FORM_JSON}
    Box’s transform1Box’s transform2
    position:{x:1 y:2 z:3} rotation:{x:4 y:5 z:6} scale:{x:7 y:8 z:9}{“position”:{“x”:1, “y”:2, “z”:3}, “rotation”:{“x”:4, “y”:5, “z”:6}, “scale”:{“x”:7, “y”:8, “z”:9}}

    Generated:

    hello_world.proto
    // --snip--
+

    A worksheet ItemConf in HelloWorld.xlsx:

    Transform1Transform2
    {.Transform}|{form:FORM_TEXT}{.Transform}|{form:FORM_JSON}
    Box’s transform1Box’s transform2
    position:{x:1 y:2 z:3} rotation:{x:4 y:5 z:6} scale:{x:7 y:8 z:9}{“position”:{“x”:1, “y”:2, “z”:3}, “rotation”:{“x”:4, “y”:5, “z”:6}, “scale”:{“x”:7, “y”:8, “z”:9}}

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -230,8 +230,8 @@
         }
     }
 }
-
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Scalar
    Union →
    +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Scalar
    Union →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/excel/union/index.html b/docs/excel/union/index.html index aafab901..677331ba 100644 --- a/docs/excel/union/index.html +++ b/docs/excel/union/index.html @@ -1,4 +1,4 @@ -Union - Tableau

    Union

    This guide demonstrates different features of union type.

    Theory

    In protoconf, union type means the tagged union: a data structure used to hold a value that could take on several different, but fixed, types. Only one of the types can be in use at any one time, and a tag field explicitly indicates which one is in use. More details can be learned from wikipedia Tagged union.

    Tagged union in different programming languages:

    Tableau use protobuf message to bundle enum type and oneof type together to implement tagged union. By default, each enum value (>0) is bound to a field with the same tag number of oneof type.

    Union definition

    For example, union type Target in common.proto is predefined as:

    // Predefined union type.
+Help
    Union
    This guide demonstrates different features of union type.
    Theory 
    In protoconf, union type means the tagged union: a data structure used to hold a value that could take on several different, but fixed, types. Only one of the types can be in use at any one time, and a tag field explicitly indicates which one is in use. More details can be learned from wikipedia Tagged union.
    Tagged union in different programming languages:
    Tableau use protobuf message to bundle enum type and oneof type together to implement tagged union. By default, each enum value (>0) is bound to a field with the same tag number of oneof type.
    Union definition 
    For example, union type Target in common.proto is predefined as:
    // Predefined union type.
 message Target {
   option (tableau.union) = true;
 
@@ -83,7 +83,181 @@
     // no field tag 3
   }
 }
-
    Predefined union in map 
    Based on predefined union type Target.
    A worksheet TaskConf in HelloWorld.xlsx:
    IDTargetTypeTargetField1TargetField2TargetField3Progress
    map<int32, Task>{.Target}enum<.Target.Type>unionunionunionint32
    IDTarget’s typeTarget’s field1Target’s field2Target’s field3Progress
    1PVP110Apple,Orange,Banana3
    2PVE1,100,9991,2,31:10,2:20,3:3010
    3Story1001,101:Apple,2:OrangeFragrant:1,Sour:210
    4Skill128
    Generated:
    hello_world.proto
    // --snip--
+
    Predefined union in list 
    Based on predefined union type Target.
    A worksheet TaskConf in HelloWorld.xlsx:
    IDTarget1TypeTarget1Field1Target1Field2Target1Field3Target2TypeTarget2Field1Target2Field2Target2Field3
    map<int32, Task>[.Target]enum<.Target.Type>unionunionunionenum<.Target.Type>unionunionunion
    IDTarget1’s typeTarget1’s field1Target1’s field2Target1’s field3Target2’s typeTarget2’s field1Target2’s field2Target2’s field3
    1PVP110Apple,Orange,BananaPVE1,100,9991,2,31:10,2:20,3:30
    2Story1001,101:Apple,2:OrangeFragrant:1,Sour:2Skill12
    Generated:
    hello_world.proto
    // --snip--
+import "common.proto";
+option (tableau.workbook) = {name:"HelloWorld.xlsx"};
+
+message TaskConf {
+  option (tableau.worksheet) = {name:"TaskConf" namerow:1 typerow:2 noterow:3 datarow:4};
+
+  map<int32, Task> task_map = 1 [(tableau.field) = {key:"ID" layout:LAYOUT_VERTICAL}];
+  message Task {
+    int32 id = 1 [(tableau.field) = {name:"ID"}];
+    repeated protoconf.Target target_list = 2 [(tableau.field) = {name:"Target" layout:LAYOUT_HORIZONTAL}];
+  }
+}
+
    TaskConf.json
    {
+    "taskMap": {
+        "1": {
+            "id": 1,
+            "targetList": [
+                {
+                    "type": "TYPE_PVP",
+                    "pvp": {
+                        "type": 1,
+                        "damage": "10",
+                        "types": [
+                            "FRUIT_TYPE_APPLE",
+                            "FRUIT_TYPE_ORANGE",
+                            "FRUIT_TYPE_BANANA"
+                        ]
+                    }
+                },
+                {
+                    "type": "TYPE_PVE",
+                    "pve": {
+                        "mission": {
+                            "id": 1,
+                            "level": 100,
+                            "damage": "999"
+                        },
+                        "heros": [
+                            1,
+                            2,
+                            3
+                        ],
+                        "dungeons": {
+                            "1": "10",
+                            "2": "20",
+                            "3": "30"
+                        }
+                    }
+                }
+            ]
+        },
+        "2": {
+            "id": 2,
+            "targetList": [
+                {
+                    "type": "TYPE_STORY",
+                    "story": {
+                        "cost": {
+                            "id": 1001,
+                            "num": 10
+                        },
+                        "fruits": {
+                            "1": "FRUIT_TYPE_APPLE",
+                            "2": "FRUIT_TYPE_ORANGE"
+                        },
+                        "flavors": {
+                            "1": {
+                                "key": "FRUIT_FLAVOR_FRAGRANT",
+                                "value": 1
+                            },
+                            "2": {
+                                "key": "FRUIT_FLAVOR_SOUR",
+                                "value": 2
+                            }
+                        }
+                    }
+                },
+                {
+                    "type": "TYPE_SKILL",
+                    "skill": {
+                        "id": 1,
+                        "damage": "2"
+                    }
+                }
+            ]
+        }
+    }
+}
+
    TaskConf.txt
    task_map: {
+  key: 1
+  value: {
+    id: 1
+    target_list: {
+      type: TYPE_PVP
+      pvp: {
+        type: 1
+        damage: 10
+        types: FRUIT_TYPE_APPLE
+        types: FRUIT_TYPE_ORANGE
+        types: FRUIT_TYPE_BANANA
+      }
+    }
+    target_list: {
+      type: TYPE_PVE
+      pve: {
+        mission: {
+          id: 1
+          level: 100
+          damage: 999
+        }
+        heros: 1
+        heros: 2
+        heros: 3
+        dungeons: {
+          key: 1
+          value: 10
+        }
+        dungeons: {
+          key: 2
+          value: 20
+        }
+        dungeons: {
+          key: 3
+          value: 30
+        }
+      }
+    }
+  }
+}
+task_map: {
+  key: 2
+  value: {
+    id: 2
+    target_list: {
+      type: TYPE_STORY
+      story: {
+        cost: {
+          id: 1001
+          num: 10
+        }
+        fruits: {
+          key: 1
+          value: FRUIT_TYPE_APPLE
+        }
+        fruits: {
+          key: 2
+          value: FRUIT_TYPE_ORANGE
+        }
+        flavors: {
+          key: 1
+          value: {
+            key: FRUIT_FLAVOR_FRAGRANT
+            value: 1
+          }
+        }
+        flavors: {
+          key: 2
+          value: {
+            key: FRUIT_FLAVOR_SOUR
+            value: 2
+          }
+        }
+      }
+    }
+    target_list: {
+      type: TYPE_SKILL
+      skill: {
+        id: 1
+        damage: 2
+      }
+    }
+  }
+}
+
    Predefined union in map 
    Based on predefined union type Target.
    A worksheet TaskConf in HelloWorld.xlsx:
    IDTargetTypeTargetField1TargetField2TargetField3Progress
    map<int32, Task>{.Target}enum<.Target.Type>unionunionunionint32
    IDTarget’s typeTarget’s field1Target’s field2Target’s field3Progress
    1PVP110Apple,Orange,Banana3
    2PVE1,100,9991,2,31:10,2:20,3:3010
    3Story1001,101:Apple,2:OrangeFragrant:1,Sour:210
    4Skill128
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -280,7 +454,7 @@
         progress:  8
     }
 }
-
    Predefined incell union in map 
    Based on predefined union type Target.
    A worksheet TaskConf in HelloWorld.xlsx:
    IDTarget1Target2Progress
    map<int32, Task>{.Target}|{form:FORM_TEXT}{.Target}|{form:FORM_JSON}int32
    IDTarget1Target2Progress
    1type:TYPE_PVP pvp:{type:1 damage:10 types:FRUIT_TYPE_APPLE types:FRUIT_TYPE_ORANGE types:FRUIT_TYPE_BANANA}{“type”:“TYPE_PVP”,“pvp”:{“type”:1,“damage”:“10”,“types”:[“FRUIT_TYPE_APPLE”,“FRUIT_TYPE_ORANGE”,“FRUIT_TYPE_BANANA”]}}3
    2type:TYPE_PVE pve:{mission:{id:1 level:100 damage:999} heros:1 heros:2 heros:3 dungeons:{key:1 value:10} dungeons:{key:2 value:20} dungeons:{key:3 value:30}}{“type”:“TYPE_PVE”,“pve”:{“mission”:{“id”:1,“level”:100,“damage”:“999”},“heros”:[1,2,3],“dungeons”:{“1”:“10”,“2”:“20”,“3”:“30”}}}10
    3type:TYPE_STORY story:{cost:{id:1001 num:10} fruits:{key:1 value:FRUIT_TYPE_APPLE} fruits:{key:2 value:FRUIT_TYPE_ORANGE} flavors:{key:1 value:{key:FRUIT_FLAVOR_FRAGRANT value:1}} flavors:{key:2 value:{key:FRUIT_FLAVOR_SOUR value:2}}}{“type”:“TYPE_STORY”,“story”:{“cost”:{“id”:1001,“num”:10},“fruits”:{“1”:“FRUIT_TYPE_APPLE”,“2”:“FRUIT_TYPE_ORANGE”},“flavors”:{“1”:{“key”:“FRUIT_FLAVOR_FRAGRANT”,“value”:1},“2”:{“key”:“FRUIT_FLAVOR_SOUR”,“value”:2}}}}10
    4type:TYPE_SKILL skill:{id:1 damage:2}{“type”:“TYPE_SKILL”,“skill”:{“id”:1,“damage”:“2”}}8
    Generated:
    hello_world.proto
    // --snip--
+
    Predefined incell union in map 
    Based on predefined union type Target.
    A worksheet TaskConf in HelloWorld.xlsx:
    IDTarget1Target2Progress
    map<int32, Task>{.Target}|{form:FORM_TEXT}{.Target}|{form:FORM_JSON}int32
    IDTarget1Target2Progress
    1type:TYPE_PVP pvp:{type:1 damage:10 types:FRUIT_TYPE_APPLE types:FRUIT_TYPE_ORANGE types:FRUIT_TYPE_BANANA}{“type”:“TYPE_PVP”,“pvp”:{“type”:1,“damage”:“10”,“types”:[“FRUIT_TYPE_APPLE”,“FRUIT_TYPE_ORANGE”,“FRUIT_TYPE_BANANA”]}}3
    2type:TYPE_PVE pve:{mission:{id:1 level:100 damage:999} heros:1 heros:2 heros:3 dungeons:{key:1 value:10} dungeons:{key:2 value:20} dungeons:{key:3 value:30}}{“type”:“TYPE_PVE”,“pve”:{“mission”:{“id”:1,“level”:100,“damage”:“999”},“heros”:[1,2,3],“dungeons”:{“1”:“10”,“2”:“20”,“3”:“30”}}}10
    3type:TYPE_STORY story:{cost:{id:1001 num:10} fruits:{key:1 value:FRUIT_TYPE_APPLE} fruits:{key:2 value:FRUIT_TYPE_ORANGE} flavors:{key:1 value:{key:FRUIT_FLAVOR_FRAGRANT value:1}} flavors:{key:2 value:{key:FRUIT_FLAVOR_SOUR value:2}}}{“type”:“TYPE_STORY”,“story”:{“cost”:{“id”:1001,“num”:10},“fruits”:{“1”:“FRUIT_TYPE_APPLE”,“2”:“FRUIT_TYPE_ORANGE”},“flavors”:{“1”:{“key”:“FRUIT_FLAVOR_FRAGRANT”,“value”:1},“2”:{“key”:“FRUIT_FLAVOR_SOUR”,“value”:2}}}}10
    4type:TYPE_SKILL skill:{id:1 damage:2}{“type”:“TYPE_SKILL”,“skill”:{“id”:1,“damage”:“2”}}8
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message TaskConf {
@@ -438,8 +612,8 @@
         }
     }
 }
-
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Struct
    List →
    
+
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Struct
    List →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/help/faq/index.html b/docs/help/faq/index.html index 7a56aac3..2dc78c63 100644 --- a/docs/help/faq/index.html +++ b/docs/help/faq/index.html @@ -1,4 +1,4 @@ -FAQ - Tableau

    FAQ

    Answers to frequently asked questions.

    Question 1 ?

    TODO …

    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Troubleshooting
    Overview →
    +Help

    FAQ

    Answers to frequently asked questions.

    Question 1 ?

    TODO …

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Troubleshooting
    Overview →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/help/how-to-update/index.html b/docs/help/how-to-update/index.html index 7f8a1538..0f56b0ff 100644 --- a/docs/help/how-to-update/index.html +++ b/docs/help/how-to-update/index.html @@ -1,4 +1,4 @@ -How to Update - Tableau

    How to Update

    Regularly update the installed toolchain to keep your tableau stable, usable, and secure.

    tableauc

    TODO …

    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Guide
    Troubleshooting →
    +Help

    How to Update

    Regularly update the installed toolchain to keep your tableau stable, usable, and secure.

    tableauc

    TODO …

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Guide
    Troubleshooting →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/help/index.html b/docs/help/index.html index 143091bb..f998e614 100644 --- a/docs/help/index.html +++ b/docs/help/index.html @@ -1,4 +1,4 @@ -Help - Tableau

    Troubleshooting

    Solutions to common problems.

    Problems updating tableauc config

    TODO …

    Problems with loader

    TODO …

    Last modified on August 28, 2024
    Edit this page on GitHub
    ← How to Update
    FAQ →
    +Help

    Troubleshooting

    Solutions to common problems.

    Problems updating tableauc config

    TODO …

    Problems with loader

    TODO …

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← How to Update
    FAQ →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/index.html b/docs/index.html index 109c7a6c..7d803cfc 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,4 +1,4 @@ -Docs - Tableau

    Docs

    C++ →
    Concepts →
    Enum →
    Enum →
    Enum →
    FAQ →
    Field Property →
    Go →
    Grammar and Types →
    Guide →
    Guide →
    How to Update →
    Infinite Nesting →
    Introduction →
    List →
    List →
    List →
    List in List →
    List in Map →
    Map →
    Map →
    Map →
    Map in List →
    Map in Map →
    Metadata →
    Metasheet →
    Metasheet →
    Metasheet →
    Naming Convention →
    Overview →
    Overview →
    Overview →
    Predefined Types →
    Quick Start →
    Scalar →
    Scalar →
    Scalar →
    Struct →
    Struct →
    Struct →
    Struct in List →
    Struct in Map →
    Struct in Struct →
    Troubleshooting →
    Union →
    +Help

    Docs

    C++ →
    Concepts →
    Enum →
    Enum →
    Enum →
    FAQ →
    Field Property →
    Go →
    Grammar and Types →
    Guide →
    Guide →
    How to Update →
    Infinite Nesting →
    Introduction →
    List →
    List →
    List →
    List in List →
    List in Map →
    Map →
    Map →
    Map →
    Map in List →
    Map in Map →
    Metadata →
    Metasheet →
    Metasheet →
    Metasheet →
    Naming Convention →
    Overview →
    Overview →
    Overview →
    Predefined Types →
    Quick Start →
    Scalar →
    Scalar →
    Scalar →
    Struct →
    Struct →
    Struct →
    Struct in List →
    Struct in Map →
    Struct in Struct →
    Troubleshooting →
    Union →
    Union →
    Union →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/prologue/index.html b/docs/prologue/index.html index 479b56bf..a07c6a47 100644 --- a/docs/prologue/index.html +++ b/docs/prologue/index.html @@ -1,4 +1,4 @@ -Prologue - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Overview
    Quick Start →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/prologue/quick-start/index.html b/docs/prologue/quick-start/index.html index 53cd431f..d97bd8af 100644 --- a/docs/prologue/quick-start/index.html +++ b/docs/prologue/quick-start/index.html @@ -1,4 +1,4 @@ -Quick Start - Tableau

    Quick Start

    One page summary of how to convert a workbook file to proto and JSON files by tableauc.

    1. Download tableauc

    Select the appropriate tableauc (aka Tableau Compiler) to download:

    Windows

    DownloadWindows x64

    Linux

    DownloadLinux x64

    Apple

    DownloadmacOS x64

    DownloadmacOS arm64

    More platforms are available on tableau releases โ†’.

    2. Add a workbook

    Add HelloWorld.xlsx with two sheets:

    IDNameDesc
    map<int32, Item>stringstring
    Itemโ€™s IDItemโ€™s nameItemโ€™s description
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.

    3. Run tableauc

    Run command: ./tableauc HelloWorld.xlsx

    Then hello_world.proto and Item.json are generated:

    hello_world.proto
    syntax = "proto3";
+Help
    Quick Start
    One page summary of how to convert a workbook file to proto and JSON files by tableauc.
    1. Download tableauc 
    Select the appropriate tableauc (aka Tableau Compiler) to download:
    Windows
    DownloadWindows x64
    Linux
    DownloadLinux x64
    Apple
    DownloadmacOS x64
    DownloadmacOS arm64
    More platforms are available on tableau releases โ†’.
    2. Add a workbook 
    Add HelloWorld.xlsx with two sheets:
    • Item: Copy data below to this worksheet.
    • @TABLEAU: Just leave it empty now. It is the tableau metasheet โ†’ for specifying parser options.
    IDNameDesc
    map<int32, Item>stringstring
    Itemโ€™s IDItemโ€™s nameItemโ€™s description
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    3. Run tableauc 
    Run command: ./tableauc HelloWorld.xlsx
    Then hello_world.proto and Item.json are generated:
    hello_world.proto
    syntax = "proto3";
 
 package protoconf;
 
@@ -67,8 +67,8 @@
         }
     }
 }
-
    Congratulations! Youโ€™ve just run the tableauc to convert a workbook to proto and JSON files.
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Introduction
    
+

    Congratulations! Youโ€™ve just run the tableauc to convert a workbook to proto and JSON files.

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Introduction
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/prologue/sitemap.xml b/docs/prologue/sitemap.xml index a03b2ce1..c851a25f 100644 --- a/docs/prologue/sitemap.xml +++ b/docs/prologue/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/prologue/introduction/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/prologue/quick-start/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/prologue/introduction/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/prologue/quick-start/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/sitemap.xml b/docs/sitemap.xml index 8e430bc3..3ef9a671 100644 --- a/docs/sitemap.xml +++ b/docs/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/help/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/design/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/csv/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/tutorial/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/prologue/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/help/how-to-update/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/help/troubleshooting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/help/faq/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/design/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/design/metadata/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/tableau/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/loader/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/checker/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/csv/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/union/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/infinite-nesting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/field-property/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/concepts/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/naming-convention/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/grammar-and-types/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/predefined-types/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/tutorial/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/prologue/introduction/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/prologue/quick-start/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/help/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/design/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/csv/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/tutorial/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/prologue/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/help/how-to-update/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/help/troubleshooting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/help/faq/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/design/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/design/metadata/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/tableau/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/loader/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/checker/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/csv/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/infinite-nesting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/field-property/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/concepts/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/naming-convention/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/grammar-and-types/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/predefined-types/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/tutorial/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/prologue/introduction/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/prologue/quick-start/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/tutorial/index.html b/docs/tutorial/index.html index 2093285b..8c520aa0 100644 --- a/docs/tutorial/index.html +++ b/docs/tutorial/index.html @@ -1,4 +1,4 @@ -Tutorial - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Predefined types
    Introduction →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/tutorial/sitemap.xml b/docs/tutorial/sitemap.xml index 4a747d1f..e0ca9b51 100644 --- a/docs/tutorial/sitemap.xml +++ b/docs/tutorial/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/tutorial/overview/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/tutorial/overview/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/xml/enum/index.html b/docs/xml/enum/index.html index 3edec383..c570506d 100644 --- a/docs/xml/enum/index.html +++ b/docs/xml/enum/index.html @@ -1,4 +1,4 @@ -Enum - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Scalar
    Struct →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/xml/index.html b/docs/xml/index.html index e29a8123..e92e406a 100644 --- a/docs/xml/index.html +++ b/docs/xml/index.html @@ -1,4 +1,4 @@ -XML - Tableau
    +Help
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/xml/index.xml b/docs/xml/index.xml index 14386cf5..99af7e6f 100644 --- a/docs/xml/index.xml +++ b/docs/xml/index.xml @@ -3,9 +3,10 @@ hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.xml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; uint32 id = 1 [(tableau.field) = {name:&quot;ID&quot;}]; int32 num = 2 [(tableau.Enumhttps://tableauio.github.io/docs/xml/enum/Fri, 23 Aug 2024 11:21:01 +0800https://tableauio.github.io/docs/xml/enum/Enum # Enum type FruitType in common.proto is predefined as: enum FruitType { FRUIT_TYPE_UNKNOWN = 0 [(tableau.evalue).name = &quot;Unknown&quot;]; FRUIT_TYPE_APPLE = 1 [(tableau.evalue).name = &quot;Apple&quot;]; FRUIT_TYPE_ORANGE = 3 [(tableau.evalue).name = &quot;Orange&quot;]; FRUIT_TYPE_BANANA = 4 [(tableau.evalue).name = &quot;Banana&quot;]; } A worksheet ItemConf in HelloWorld.xml: &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;ID&gt;uint32&lt;/ID&gt; &lt;Type&gt;enum&lt;.FruitType&gt;&lt;/Type&gt; &lt;Desc&gt;string&lt;/Desc&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;ID&gt;1&lt;/ID&gt; &lt;Type&gt;FRUIT_TYPE_APPLE&lt;/Type&gt; &lt;Desc&gt;A kind of delicious fruit.&lt;/Desc&gt; &lt;/ItemConf&gt; Generated:Structhttps://tableauio.github.io/docs/xml/struct/Tue, 13 Oct 2020 15:21:01 +0200https://tableauio.github.io/docs/xml/struct/General struct # A worksheet ItemConf in HelloWorld.xml: -&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;Item ID=&quot;uint32&quot; StartTime=&quot;datetime&quot;&gt; &lt;Expiry&gt;duration&lt;/Expiry&gt; &lt;/Item&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;Item ID=&quot;1&quot; StartTime=&quot;2024-10-01 10:10:10&quot;&gt; &lt;Expiry&gt;1h&lt;/Expiry&gt; &lt;/Item&gt; &lt;/ItemConf&gt; Tips +&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;Item ID=&quot;uint32&quot; StartTime=&quot;datetime&quot;&gt; &lt;Expiry&gt;duration&lt;/Expiry&gt; &lt;/Item&gt; &lt;Item2 ID=&quot;{OtherItem}uint32&quot; Name=&quot;string&quot; /&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;Item ID=&quot;1&quot; StartTime=&quot;2024-10-01 10:10:10&quot;&gt; &lt;Expiry&gt;1h&lt;/Expiry&gt; &lt;/Item&gt; &lt;Item2 ID=&quot;1&quot; Name=&quot;gold&quot; /&gt; &lt;/ItemConf&gt; Tips Well-known type: datetime โ†’ Well-known type: duration โ†’ Generated: -hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.xml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; Item item = 1 [(tableau.field) = {name:&quot;Item&quot;}]; message Item { uint32 id = 1 [(tableau.Listhttps://tableauio.github.io/docs/xml/list/Tue, 13 Oct 2020 15:21:01 +0200https://tableauio.github.io/docs/xml/list/Scalar list # A worksheet ItemConf in HelloWorld.xml: +hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.xml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; Item item = 1 [(tableau.Unionhttps://tableauio.github.io/docs/xml/union/Mon, 02 Sep 2024 19:21:01 +0800https://tableauio.github.io/docs/xml/union/Union definition # For example, union type Target in common.proto is predefined as: +// Predefined union type. message Target { option (tableau.union) = true; Type type = 9999 [(tableau.field) = { name: &quot;Type&quot; }]; oneof value { option (tableau.oneof) = { field: &quot;Field&quot; }; Pvp pvp = 1; // Binded to enum value 1: TYPE_PVP. Pve pve = 2; // Binded to enum value 2: TYPE_PVP. Story story = 3; // Binded to enum value 3: TYPE_STORY.Listhttps://tableauio.github.io/docs/xml/list/Tue, 13 Oct 2020 15:21:01 +0200https://tableauio.github.io/docs/xml/list/Scalar list # A worksheet ItemConf in HelloWorld.xml: &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;Item&gt;[int32]&lt;/Item&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;Item&gt;1&lt;/Item&gt; &lt;Item&gt;2&lt;/Item&gt; &lt;Item&gt;3&lt;/Item&gt; &lt;/ItemConf&gt; Generated: hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.xml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; repeated int32 item_list = 1 [(tableau.field) = {name:&quot;Item&quot;}]; } ItemConf.json { &quot;itemList&quot;: [ 1, 2, 3 ] } Enum list # Enum type FruitType in common.Maphttps://tableauio.github.io/docs/xml/map/Tue, 13 Oct 2020 15:21:01 +0200https://tableauio.github.io/docs/xml/map/Incell scalar map # A worksheet ItemConf in HelloWorld.xml: &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;Item&gt;map&lt;uint32, string&gt;&lt;/Item&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;Item&gt;1:dog,2:bird,3:cat&lt;/Item&gt; &lt;/ItemConf&gt; Generated: diff --git a/docs/xml/list/index.html b/docs/xml/list/index.html index 97110cb9..f5efcce2 100644 --- a/docs/xml/list/index.html +++ b/docs/xml/list/index.html @@ -1,4 +1,4 @@ -List - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Union
    Map →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/xml/map/index.html b/docs/xml/map/index.html index 0a4435b0..df813e81 100644 --- a/docs/xml/map/index.html +++ b/docs/xml/map/index.html @@ -1,4 +1,4 @@ -Map - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← List
    Metasheet →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/xml/metasheet/index.html b/docs/xml/metasheet/index.html index 0b4c9c6b..23fab60d 100644 --- a/docs/xml/metasheet/index.html +++ b/docs/xml/metasheet/index.html @@ -1,4 +1,4 @@ -Metasheet - Tableau +

    Without metasheet

    If one XML file has no metasheet (In other words, has no comment block beginning with @TABLEAU), no protobuf and json will be generated.

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Map
    Overview →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/xml/scalar/index.html b/docs/xml/scalar/index.html index c4d069af..c729632f 100644 --- a/docs/xml/scalar/index.html +++ b/docs/xml/scalar/index.html @@ -1,4 +1,4 @@ -Scalar - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Metasheet
    Enum →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/xml/sitemap.xml b/docs/xml/sitemap.xml index ce3f2393..4f76d6de 100644 --- a/docs/xml/sitemap.xml +++ b/docs/xml/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/xml/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/metasheet/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/xml/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/metasheet/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/xml/struct/index.html b/docs/xml/struct/index.html index 673079bf..1667d63f 100644 --- a/docs/xml/struct/index.html +++ b/docs/xml/struct/index.html @@ -1,4 +1,4 @@ -Struct - Tableau

    Struct

    XML struct guide.

    General struct

    A worksheet ItemConf in HelloWorld.xml:

    <?xml version="1.0" encoding="UTF-8"?>
+Help
    Struct
    XML struct guide.
    General struct 
    A worksheet ItemConf in HelloWorld.xml:
    <?xml version="1.0" encoding="UTF-8"?>
 <!--
 <@TABLEAU>
     <Item Sheet="ItemConf" />
@@ -40,6 +40,7 @@
     <Item ID="uint32" StartTime="datetime">
       <Expiry>duration</Expiry>
     </Item>
+    <Item2 ID="{OtherItem}uint32" Name="string" />
 </ItemConf>
 -->
 
@@ -47,6 +48,7 @@
     <Item ID="1" StartTime="2024-10-01 10:10:10">
       <Expiry>1h</Expiry>
     </Item>
+    <Item2 ID="1" Name="gold" />
 </ItemConf>
 
    Tips
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xml"};
@@ -60,12 +62,21 @@
     google.protobuf.Timestamp start_time = 2 [(tableau.field) = {name:"StartTime"}];
     google.protobuf.Duration expiry = 3 [(tableau.field) = {name:"Expiry"}];
   }
+  OtherItem item_2 = 2 [(tableau.field) = {name:"Item2"}];
+  message OtherItem {
+    uint32 id = 1 [(tableau.field) = {name:"ID"}];
+    string name = 2 [(tableau.field) = {name:"Name"}];
+  }
 }
 
    ItemConf.json
    {
     "item": {
         "id": 1,
         "startTime": "2024-10-01T02:10:10Z",
         "expiry": "3600s"
+    },
+    "item2": {
+        "id": 1,
+        "name": "gold"
     }
 }
 
    Reuse same-level struct 
    A worksheet ItemConf in HelloWorld.xml:
    <?xml version="1.0" encoding="UTF-8"?>
@@ -79,6 +90,9 @@
       <Expiry>duration</Expiry>
     </Item>
     <NewItem @type="{Item}" />
+    <OtherItem ID="{Item}uint32" StartTime="datetime">
+      <Expiry>duration</Expiry>
+    </OtherItem>
 </ItemConf>
 -->
 
@@ -89,6 +103,9 @@
     <NewItem ID="2" StartTime="2026-10-01 10:10:10">
       <Expiry>2h</Expiry>
     </NewItem>
+    <OtherItem ID="3" StartTime="2028-10-01 10:10:10">
+      <Expiry>3h</Expiry>
+    </OtherItem>
 </ItemConf>
 
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xml"};
@@ -103,6 +120,7 @@
     google.protobuf.Duration expiry = 3 [(tableau.field) = {name:"Expiry"}];
   }
   Item new_item = 2 [(tableau.field) = {name:"NewItem"}];
+  Item other_item = 3 [(tableau.field) = {name:"OtherItem"}];
 }
 
    ItemConf.json
    {
     "item": {
@@ -114,6 +132,11 @@
         "id": 2,
         "startTime": "2026-10-01T02:10:10Z",
         "expiry": "7200s"
+    },
+    "otherItem": {
+        "id": 3,
+        "startTime": "2028-10-01T02:10:10Z",
+        "expiry": "10800s"
     }
 }
 
    Predefined struct 
    Item in common.proto is predefined as:
    message Item {
@@ -128,11 +151,13 @@
 
 <ItemConf>
     <Item @type="{.Item}" />
+    <Item2 ID="{.Item}int32" Num="int32"  />
 </ItemConf>
 -->
 
 <ItemConf>
     <Item ID="1" Num="10" />
+    <Item2 ID="2" Num="20" />
 </ItemConf>
 
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
@@ -142,15 +167,99 @@
   option (tableau.worksheet) = {name:"ItemConf"};
 
   protoconf.Item item = 1 [(tableau.field) = {name:"Item"}];
+  protoconf.Item item_2 = 2 [(tableau.field) = {name:"Item2"}];
+}
+
    ItemConf.json
    {
+    "item": {
+        "id": 1,
+        "num": 10
+    },
+    "item2": {
+        "id": 2,
+        "num": 20
+    }
+}
+
    Incell struct 
    A worksheet ItemConf in HelloWorld.xml:
    <?xml version="1.0" encoding="UTF-8"?>
+<!--
+<@TABLEAU>
+    <Item Sheet="ItemConf" />
+</@TABLEAU>
+
+<ItemConf Item="{uint32 ID, int32 Num}Item" >
+    <Item2>{uint32 ID, int32 Num}OtherItem</Item2>
+</ItemConf>
+-->
+
+<ItemConf Item="2, 20">
+    <Item2>1, 10</Item2>
+</ItemConf>
+
    Generated:
    hello_world.proto
    // --snip--
+option (tableau.workbook) = {name:"HelloWorld.xml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  Item item = 1 [(tableau.field) = {name:"Item" span:SPAN_INNER_CELL}];
+  message Item {
+    uint32 id = 1 [(tableau.field) = {name:"ID"}];
+    int32 num = 2 [(tableau.field) = {name:"Num"}];
+  }
+  OtherItem item_2 = 2 [(tableau.field) = {name:"Item2" span:SPAN_INNER_CELL}];
+  message OtherItem {
+    uint32 id = 1 [(tableau.field) = {name:"ID"}];
+    int32 num = 2 [(tableau.field) = {name:"Num"}];
+  }
+}
+
    ItemConf.json
    {
+    "item": {
+        "id": 2,
+        "num": 20
+    },
+    "item2": {
+        "id": 1,
+        "num": 10
+    }
+}
+
    Incell predefined struct 
    Item in common.proto is predefined as:
    message Item {
+    int32 id = 1 [(tableau.field) = {name:"ID"}];
+    int32 num = 2 [(tableau.field) = {name:"Num"}];
+}
+
    A worksheet ItemConf in HelloWorld.xml:
    <?xml version="1.0" encoding="UTF-8"?>
+<!--
+<@TABLEAU>
+    <Item Sheet="ItemConf" />
+</@TABLEAU>
+
+<ItemConf Item="{.Item}">
+    <Item2>{.Item}</Item2>
+</ItemConf>
+-->
+
+<ItemConf Item="2, 20">
+    <Item2>1, 10</Item2>
+</ItemConf>
+
    Generated:
    hello_world.proto
    // --snip--
+import "common.proto";
+option (tableau.workbook) = {name:"HelloWorld.xml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  protoconf.Item item = 1 [(tableau.field) = {name:"Item" span:SPAN_INNER_CELL}];
+  protoconf.Item item_2 = 2 [(tableau.field) = {name:"Item2" span:SPAN_INNER_CELL}];
 }
 
    ItemConf.json
    {
     "item": {
+        "id": 2,
+        "num": 20
+    },
+    "item2": {
         "id": 1,
         "num": 10
     }
 }
-
    Incell struct 
    Incell general struct 
    Incell predefined struct 
    Last modified on August 28, 2024
    Edit this page on GitHub
    ← Enum
    List →
    
+
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Enum
    Union →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/xml/union/index.html b/docs/xml/union/index.html new file mode 100644 index 00000000..fe86de37 --- /dev/null +++ b/docs/xml/union/index.html @@ -0,0 +1,228 @@ +Union - Tableau

    Union

    XML union guide.

    Union definition

    For example, union type Target in common.proto is predefined as:

    // Predefined union type.
+message Target {
+  option (tableau.union) = true;
+
+  Type type = 9999 [(tableau.field) = { name: "Type" }];
+  oneof value {
+    option (tableau.oneof) = {
+      field: "Field"
+    };
+    Pvp pvp = 1;      // Binded to enum value 1: TYPE_PVP.
+    Pve pve = 2;      // Binded to enum value 2: TYPE_PVP.
+    Story story = 3;  // Binded to enum value 3: TYPE_STORY.
+    Skill skill = 4;  // Binded to enum value 4: TYPE_SKILL.
+  }
+
+  enum Type {
+    TYPE_NIL = 0;
+    TYPE_PVP = 1 [(tableau.evalue) = { name: "PVP" }];
+    TYPE_PVE = 2 [(tableau.evalue) = { name: "PVE" }];
+    TYPE_STORY = 3 [(tableau.evalue) = { name: "Story" }];
+    TYPE_SKILL = 4 [(tableau.evalue) = { name: "Skill" }];
+  }
+  message Pvp {
+    int32 type = 1;                          // scalar
+    int64 damage = 2;                        // scalar
+    repeated protoconf.FruitType types = 3;  // incell enum list
+  }
+  message Pve {
+    Mission mission = 1;             // incell struct
+    repeated int32 heros = 2;        // incell list
+    map<int32, int64> dungeons = 3;  // incell map
+
+    message Mission {
+      int32 id = 1;
+      uint32 level = 2;
+      int64 damage = 3;
+    }
+  }
+  message Story {
+    protoconf.Item cost = 1;                     // incell predefined struct
+    map<int32, protoconf.FruitType> fruits = 2;  // incell map with value as enum type
+    map<int32, Flavor> flavors = 3;              // incell map with key as enum type
+    message Flavor {
+      protoconf.FruitFlavor key = 1 [(tableau.field) = { name: "Key" }];
+      int32 value = 2 [(tableau.field) = { name: "Value" }];
+    }
+  }
+  message Skill {
+    int32 id = 1;      // scalar
+    int64 damage = 2;  // scalar
+    // no field tag 3
+  }
+}
+

    Predefined union

    A worksheet ItemConf in HelloWorld.xml:

    <?xml version="1.0" encoding="UTF-8"?>
+<!--
+<@TABLEAU>
+    <Item Sheet="ItemConf" />
+</@TABLEAU>
+
+<ItemConf>
+    <Target @type="{.Target}" />
+</ItemConf>
+-->
+
+<ItemConf>
+    <Target Type="PVP" Field1="1" Field2="10" Field3="Apple,Orange,Banana"/>
+</ItemConf>
+

    Generated:

    hello_world.proto
    // --snip--
+option (tableau.workbook) = {name:"HelloWorld.xml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  protoconf.Target target = 1 [(tableau.field) = {name:"Target"}];
+}
+
    ItemConf.json
    {
+    "target": {
+        "type": "TYPE_PVP",
+        "pvp": {
+            "type": 1,
+            "damage": "10",
+            "types": [
+                "FRUIT_TYPE_APPLE",
+                "FRUIT_TYPE_ORANGE",
+                "FRUIT_TYPE_BANANA"
+            ]
+        }
+    }
+}
+

    Predefined incell union

    A worksheet ItemConf in HelloWorld.xml:

    <?xml version="1.0" encoding="UTF-8"?>
+<!--
+<@TABLEAU>
+    <Item Sheet="ItemConf" />
+</@TABLEAU>
+
+<ItemConf>
+    <Target>{.Target}|{form:FORM_TEXT}</Target>
+</ItemConf>
+-->
+
+<ItemConf>
+    <Target>type:TYPE_PVE pve:{mission:{id:1 level:100 damage:999} heros:1 heros:2 heros:3 dungeons:{key:1 value:10} dungeons:{key:2 value:20} dungeons:{key:3 value:30}}</Target>
+</ItemConf>
+

    Generated:

    hello_world.proto
    // --snip--
+option (tableau.workbook) = {name:"HelloWorld.xml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  protoconf.Target target = 1 [(tableau.field) = {name:"Target" span:SPAN_INNER_CELL prop:{form:FORM_TEXT}}];
+}
+
    ItemConf.json
    {
+    "target": {
+        "type": "TYPE_PVE",
+        "pve": {
+            "mission": {
+                "id": 1,
+                "level": 100,
+                "damage": "999"
+            },
+            "heros": [
+                1,
+                2,
+                3
+            ],
+            "dungeons": {
+                "1": "10",
+                "2": "20",
+                "3": "30"
+            }
+        }
+    }
+}
+

    Predefined union list

    A worksheet ItemConf in HelloWorld.xml:

    <?xml version="1.0" encoding="UTF-8"?>
+<!--
+<@TABLEAU>
+    <Item Sheet="ItemConf" />
+</@TABLEAU>
+
+<ItemConf>
+    <Target @type="[.Target]" />
+</ItemConf>
+-->
+
+<ItemConf>
+    <Target Type="Story" Field1="1001,10" Field2="1:Apple,2:Orange" Field3="Fragrant:1,Sour:2"/>
+    <Target Type="Skill" Field1="1" Field2="2"/>
+</ItemConf>
+

    Generated:

    hello_world.proto
    // --snip--
+import "common.proto";
+option (tableau.workbook) = {name:"HelloWorld.xml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  repeated protoconf.Target target_list = 1 [(tableau.field) = {name:"Target"}];
+}
+
    ItemConf.json
    {
+    "targetList": [
+        {
+            "type": "TYPE_STORY",
+            "story": {
+                "cost": {
+                    "id": 1001,
+                    "num": 10
+                },
+                "fruits": {
+                    "1": "FRUIT_TYPE_APPLE",
+                    "2": "FRUIT_TYPE_ORANGE"
+                },
+                "flavors": {
+                    "1": {
+                        "key": "FRUIT_FLAVOR_FRAGRANT",
+                        "value": 1
+                    },
+                    "2": {
+                        "key": "FRUIT_FLAVOR_SOUR",
+                        "value": 2
+                    }
+                }
+            }
+        },
+        {
+            "type": "TYPE_SKILL",
+            "skill": {
+                "id": 1,
+                "damage": "2"
+            }
+        }
+    ]
+}
+
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Struct
    List →
    + + + + \ No newline at end of file diff --git a/docs/yaml/enum/index.html b/docs/yaml/enum/index.html index 2f597894..22b97049 100644 --- a/docs/yaml/enum/index.html +++ b/docs/yaml/enum/index.html @@ -1,4 +1,4 @@ -Enum - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Scalar
    Guide →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/yaml/index.html b/docs/yaml/index.html index 1b9a1b15..f2a0651a 100644 --- a/docs/yaml/index.html +++ b/docs/yaml/index.html @@ -1,4 +1,4 @@ -YAML - Tableau
    +Help
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/yaml/index.xml b/docs/yaml/index.xml index f4b750ba..c53651e3 100644 --- a/docs/yaml/index.xml +++ b/docs/yaml/index.xml @@ -5,7 +5,8 @@ enum FruitType { FRUIT_TYPE_UNKNOWN = 0 [(tableau.evalue).name = &quot;Unkno # define metasheet: generate all sheets &quot;@sheet&quot;: &quot;@TABLEAU&quot; --- # define schema &quot;@sheet&quot;: &quot;@ItemConf&quot; ID: uint32 Type: &quot;enum&lt;.FruitType&gt;&quot; Desc: string --- &quot;@sheet&quot;: ItemConf ID: 1 Type: FRUIT_TYPE_APPLE Desc: A kind of delicious fruit.    Structhttps://tableauio.github.io/docs/yaml/struct/Sat, 22 Jun 2024 10:00:00 +0800https://tableauio.github.io/docs/yaml/struct/General struct # A worksheet ItemConf in HelloWorld.yaml: # define metasheet: generate all sheets &quot;@sheet&quot;: &quot;@TABLEAU&quot; --- # define schema &quot;@sheet&quot;: &quot;@ItemConf&quot; Item: &quot;@type&quot;: &quot;{Item}&quot; ID: uint32 StartTime: datetime Expiry: duration --- &quot;@sheet&quot;: ItemConf Item: ID: 1 StartTime: 2024-10-01 10:10:10 Expiry: 1h Tips Well-known type: datetime โ†’ Well-known type: duration โ†’ Generated: -hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.yaml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; Item item = 1 [(tableau.Listhttps://tableauio.github.io/docs/yaml/list/Sat, 22 Jun 2024 10:00:00 +0800https://tableauio.github.io/docs/yaml/list/Scalar list # A worksheet ItemConf in HelloWorld.yaml: +hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.yaml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; Item item = 1 [(tableau.Unionhttps://tableauio.github.io/docs/yaml/union/Mon, 02 Sep 2024 19:21:01 +0800https://tableauio.github.io/docs/yaml/union/Union definition # For example, union type Target in common.proto is predefined as: +// Predefined union type. message Target { option (tableau.union) = true; Type type = 9999 [(tableau.field) = { name: &quot;Type&quot; }]; oneof value { option (tableau.oneof) = { field: &quot;Field&quot; }; Pvp pvp = 1; // Binded to enum value 1: TYPE_PVP. Pve pve = 2; // Binded to enum value 2: TYPE_PVP. Story story = 3; // Binded to enum value 3: TYPE_STORY.Listhttps://tableauio.github.io/docs/yaml/list/Sat, 22 Jun 2024 10:00:00 +0800https://tableauio.github.io/docs/yaml/list/Scalar list # A worksheet ItemConf in HelloWorld.yaml: # define metasheet: generate all sheets &quot;@sheet&quot;: &quot;@TABLEAU&quot; --- # define schema &quot;@sheet&quot;: &quot;@ItemConf&quot; Items: &quot;[int32]&quot; --- &quot;@sheet&quot;: ItemConf Items: [1, 2, 3] Generated: hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.yaml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; repeated int32 items = 1 [(tableau.field) = {name:&quot;Items&quot;}]; } ItemConf.json { &quot;items&quot;: [ 1, 2, 3 ] } Enum list # Enum type FruitType in common.Maphttps://tableauio.github.io/docs/yaml/map/Sat, 22 Jun 2024 10:00:00 +0800https://tableauio.github.io/docs/yaml/map/Scalar map # A worksheet ItemConf in HelloWorld.yaml: # define metasheet: generate all sheets &quot;@sheet&quot;: &quot;@TABLEAU&quot; --- # define schema &quot;@sheet&quot;: &quot;@ItemConf&quot; Items: &quot;map&lt;uint32, string&gt;&quot; --- &quot;@sheet&quot;: ItemConf Items: 1: dog 2: bird 3: cat Generated: diff --git a/docs/yaml/list/index.html b/docs/yaml/list/index.html index 761b3992..7610cd7a 100644 --- a/docs/yaml/list/index.html +++ b/docs/yaml/list/index.html @@ -1,4 +1,4 @@ -List - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Union
    Map →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/yaml/map/index.html b/docs/yaml/map/index.html index 68ea6489..19066d88 100644 --- a/docs/yaml/map/index.html +++ b/docs/yaml/map/index.html @@ -1,4 +1,4 @@ -Map - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← List
    Metasheet →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/yaml/metasheet/index.html b/docs/yaml/metasheet/index.html index 405fff04..4f201a09 100644 --- a/docs/yaml/metasheet/index.html +++ b/docs/yaml/metasheet/index.html @@ -1,4 +1,4 @@ -Metasheet - Tableau +

    TODO

    More details…

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Map
    Scalar →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/yaml/scalar/index.html b/docs/yaml/scalar/index.html index 937f07a5..16305ff3 100644 --- a/docs/yaml/scalar/index.html +++ b/docs/yaml/scalar/index.html @@ -1,4 +1,4 @@ -Scalar - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Metadata
    Enum →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/yaml/sitemap.xml b/docs/yaml/sitemap.xml index e8840982..c05eddea 100644 --- a/docs/yaml/sitemap.xml +++ b/docs/yaml/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/docs/yaml/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/metasheet/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/docs/yaml/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/metasheet/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/docs/yaml/struct/index.html b/docs/yaml/struct/index.html index 59ad43e1..c842fe1f 100644 --- a/docs/yaml/struct/index.html +++ b/docs/yaml/struct/index.html @@ -1,4 +1,4 @@ -Struct - Tableau +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Go
    Union →
    - \ No newline at end of file + \ No newline at end of file diff --git a/docs/yaml/union/index.html b/docs/yaml/union/index.html new file mode 100644 index 00000000..d6a281c0 --- /dev/null +++ b/docs/yaml/union/index.html @@ -0,0 +1,226 @@ +Union - Tableau

    Union

    yaml union guide.

    Union definition

    For example, union type Target in common.proto is predefined as:

    // Predefined union type.
+message Target {
+  option (tableau.union) = true;
+
+  Type type = 9999 [(tableau.field) = { name: "Type" }];
+  oneof value {
+    option (tableau.oneof) = {
+      field: "Field"
+    };
+    Pvp pvp = 1;      // Binded to enum value 1: TYPE_PVP.
+    Pve pve = 2;      // Binded to enum value 2: TYPE_PVP.
+    Story story = 3;  // Binded to enum value 3: TYPE_STORY.
+    Skill skill = 4;  // Binded to enum value 4: TYPE_SKILL.
+  }
+
+  enum Type {
+    TYPE_NIL = 0;
+    TYPE_PVP = 1 [(tableau.evalue) = { name: "PVP" }];
+    TYPE_PVE = 2 [(tableau.evalue) = { name: "PVE" }];
+    TYPE_STORY = 3 [(tableau.evalue) = { name: "Story" }];
+    TYPE_SKILL = 4 [(tableau.evalue) = { name: "Skill" }];
+  }
+  message Pvp {
+    int32 type = 1;                          // scalar
+    int64 damage = 2;                        // scalar
+    repeated protoconf.FruitType types = 3;  // incell enum list
+  }
+  message Pve {
+    Mission mission = 1;             // incell struct
+    repeated int32 heros = 2;        // incell list
+    map<int32, int64> dungeons = 3;  // incell map
+
+    message Mission {
+      int32 id = 1;
+      uint32 level = 2;
+      int64 damage = 3;
+    }
+  }
+  message Story {
+    protoconf.Item cost = 1;                     // incell predefined struct
+    map<int32, protoconf.FruitType> fruits = 2;  // incell map with value as enum type
+    map<int32, Flavor> flavors = 3;              // incell map with key as enum type
+    message Flavor {
+      protoconf.FruitFlavor key = 1 [(tableau.field) = { name: "Key" }];
+      int32 value = 2 [(tableau.field) = { name: "Value" }];
+    }
+  }
+  message Skill {
+    int32 id = 1;      // scalar
+    int64 damage = 2;  // scalar
+    // no field tag 3
+  }
+}
+

    Predefined union

    A worksheet ItemConf in HelloWorld.yaml:

    # define metasheet: generate all sheets
+"@sheet": "@TABLEAU"
+---
+# define schema
+"@sheet": "@ItemConf"
+Target: "{.Target}"
+---
+"@sheet": ItemConf
+Target:
+  Type: PVP
+  Field1: 1
+  Field2: 10
+  Field3: "Apple,Orange,Banana"
+
+

    Generated:

    hello_world.proto
    // --snip--
+option (tableau.workbook) = {name:"HelloWorld.yaml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  protoconf.Target target = 1 [(tableau.field) = {name:"Target"}];
+}
+
    ItemConf.json
    {
+    "target": {
+        "type": "TYPE_PVP",
+        "pvp": {
+            "type": 1,
+            "damage": "10",
+            "types": [
+                "FRUIT_TYPE_APPLE",
+                "FRUIT_TYPE_ORANGE",
+                "FRUIT_TYPE_BANANA"
+            ]
+        }
+    }
+}
+

    Predefined incell union

    A worksheet ItemConf in HelloWorld.yaml:

    # define metasheet: generate all sheets
+"@sheet": "@TABLEAU"
+---
+# define schema
+"@sheet": "@ItemConf"
+Target:
+  "@type": "{.Target}|{form:FORM_TEXT}"
+  "@incell": true
+---
+"@sheet": ItemConf
+Target: "type:TYPE_PVE pve:{mission:{id:1 level:100 damage:999} heros:1 heros:2 heros:3 dungeons:{key:1 value:10} dungeons:{key:2 value:20} dungeons:{key:3 value:30}}"
+

    Generated:

    hello_world.proto
    // --snip--
+option (tableau.workbook) = {name:"HelloWorld.yaml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  protoconf.Target target = 1 [(tableau.field) = {name:"Target" span:SPAN_INNER_CELL prop:{form:FORM_TEXT}}];
+}
+
    ItemConf.json
    {
+    "target": {
+        "type": "TYPE_PVE",
+        "pve": {
+            "mission": {
+                "id": 1,
+                "level": 100,
+                "damage": "999"
+            },
+            "heros": [
+                1,
+                2,
+                3
+            ],
+            "dungeons": {
+                "1": "10",
+                "2": "20",
+                "3": "30"
+            }
+        }
+    }
+}
+

    Predefined union list

    A worksheet ItemConf in HelloWorld.yaml:

    # define metasheet: generate all sheets
+"@sheet": "@TABLEAU"
+---
+# define schema
+"@sheet": "@ItemConf"
+Targets: "[.Target]"
+---
+"@sheet": ItemConf
+Targets: 
+  - Type: Story
+    Field1: "1001,10"
+    Field2: "1:Apple,2:Orange"
+    Field3: "Fragrant:1,Sour:2"
+  - Type: Skill
+    Field1: 1
+    Field2: 2
+

    Generated:

    hello_world.proto
    // --snip--
+import "common.proto";
+option (tableau.workbook) = {name:"HelloWorld.yaml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  repeated protoconf.Target targets = 1 [(tableau.field) = {name:"Targets"}];
+}
+
    ItemConf.json
    {
+    "targets": [
+        {
+            "type": "TYPE_STORY",
+            "story": {
+                "cost": {
+                    "id": 1001,
+                    "num": 10
+                },
+                "fruits": {
+                    "1": "FRUIT_TYPE_APPLE",
+                    "2": "FRUIT_TYPE_ORANGE"
+                },
+                "flavors": {
+                    "1": {
+                        "key": "FRUIT_FLAVOR_FRAGRANT",
+                        "value": 1
+                    },
+                    "2": {
+                        "key": "FRUIT_FLAVOR_SOUR",
+                        "value": 2
+                    }
+                }
+            }
+        },
+        {
+            "type": "TYPE_SKILL",
+            "skill": {
+                "id": 1,
+                "damage": "2"
+            }
+        }
+    ]
+}
+
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← Struct
    List →
    + + + + \ No newline at end of file diff --git a/en/sitemap.xml b/en/sitemap.xml index 5567f751..fe952477 100644 --- a/en/sitemap.xml +++ b/en/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/blog/say-hello-to-tableau/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/checker/guide/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/help/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/help/how-to-update/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/help/troubleshooting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/help/faq/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/design/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/design/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/design/metadata/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/tableau/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/loader/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/checker/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/tableau/guide/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/loader/c++/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/api/loader/go/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/yaml/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/xml/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/csv/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/csv/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/union/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/infinite-nesting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/field-property/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/excel/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/concepts/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/naming-convention/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/grammar-and-types/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/basics/predefined-types/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/tutorial/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/tutorial/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/prologue/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/prologue/introduction/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/prologue/quick-start/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/docs/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/contact/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/contributors/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/privacy-policy/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/contributors/wenchy/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/blog/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/blog/say-hello-to-tableau/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/checker/guide/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/help/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/help/how-to-update/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/help/troubleshooting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/help/faq/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/design/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/design/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/design/metadata/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/tableau/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/loader/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/checker/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/tableau/guide/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/loader/c++/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/api/loader/go/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/yaml/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/xml/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/csv/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/csv/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/struct-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/list-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/map-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/infinite-nesting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/field-property/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/excel/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/concepts/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/naming-convention/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/grammar-and-types/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/basics/predefined-types/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/tutorial/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/tutorial/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/prologue/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/prologue/introduction/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/prologue/quick-start/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/docs/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/contact/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/contributors/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/privacy-policy/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/contributors/wenchy/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/blog/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/index.html b/index.html index a0988be6..093dd124 100644 --- a/index.html +++ b/index.html @@ -1,4 +1,4 @@ -Tableau - Modern Configuration Converter

    Metadata

    Notation

    The syntax is specified using Extended Backus-Naur Form (EBNF).

    Workbook -> Protoconf

    Basic

    workbook: (AliasTest)DemoTest, worksheet: (AliasActivity)DemoActivity

    • protoconf file name is alias_test.proto. If with no (), name will be demo_test.proto
    • configuration message name is AliasActivity. If with no (), name will be DemoActivity
    • list: [ELEM-TYPE]COLUMN-TYPE, COLUMN-TYPE is column type, ELEM-TYPE is message name and list prefix (must not conflict with the protobuf keyword).
    • map: map<KEY-TYPE,VALUE-TYPE>, KEY-TYPE must be scalar types, and VALUE-TYPE is message name and map prefix (must not conflict with build-in scalar type).
    • import message types: .TYPE, e.g.: .Item represents the message Item already defined in the same protobuf package, and should not redefine it.
    • well-known types
      • Timestamp: google.protobuf.Timestamp
      • Duration: google.protobuf.Duration
    ActivityIDActivityNameActivityBeginTimeActivityDurationChapterIDChapterNameSectionIDSectionNameSectionItem1IdSectionItem1NumSectionItem2IdSectionItem2Num
    map<uint32,Activity>stringtimestampdurationmap<uint32,Chapter>string[Section]uint32int32[.Item]int32int32int32int32
    1activity12020-01-01 05:00:0072h1chapter11section11001110022
    1activity12020-01-01 05:00:0072h1chapter12section21001110022
    1activity12020-01-01 05:00:0072h2chapter21section11001110022
    2activity22020-01-01 05:00:0072h3m0.5s1chapter11section11001110022
    // common.proto
 message Item {
   int32 id = 1 [(tableau.field).name = "Id"];
   int32 num= 2 [(tableau.field).name = "Num"];
diff --git a/nl/en/docs/design/overview/index.html b/nl/en/docs/design/overview/index.html
index a351b15c..5c26e09d 100644
--- a/nl/en/docs/design/overview/index.html
+++ b/nl/en/docs/design/overview/index.html
@@ -1,4 +1,4 @@
-Overview - Tableau

    Field property

    Overview

    OptionTypeDescription
    uniqueboolCheck map key uniqueness.
    Default: false.
    rangestringFormat: "left, right". E.g.: "1,10", "1,~", "~,10".
    Different interpretations of range:
    - number: value range.
    - string: count of utf-8 code point.
    referstringFormat: "SheetName(SheetAlias).ColumnName".
    Ensure this field is in another sheet’s column value space. Multiple refers are comma-separated.
    sequenceint64Ensure this field’s value is a sequence and begins with this value.
    defaultstringUse this default value if cell is empty.
    fixedboolAuto-detected fixed size of horizontal list/map.
    Default: false.
    sizeuint32Specify fixed size of horizontal list/map.
    formFormSpecify cell data form of incell struct.
    - FORM_TEXT
    - FORM_JSON
    json_namestringSpecify field’s custom JSON name instead of lowerCamelCase name of proto field name.
    presentboolMust fill cell data explicitly if present is true.
    Default: false.

    Option unique

    Option unique can be specified as true in the map field property. Then the tableauc will report an error if a duplicate key is appeared.

    Option range

    Option range can be specified as format: "left, right" (left and right are both inclusive).

    Different interpretations of range:

    • number: value range, e.g.: "1,10", "1,~", "~,10".
    • string: count of utf-8 code point.
    • list: length of list.
    • map: length of map.

    Option refer

    Option refer is some like the FOREIGN KEY constraint in SQL to prevent actions that would destroy links between tables. However, tableau refer can refer to any sheet’s column even if it is not map key column, and multiple refers (comma-separated) are also supported. It is used to ensure this field is at least in one of the other sheets' column value space (aka message’s field value space).

    Format: "SheetName(SheetAlias).ColumnName[,SheetName(SheetAlias).ColumnName]...".

    For example:

    • map<uint32, Reward>|{refer:"ItemConf.ID"}: single-refer without alias, so sheet name is just the generated protobuf message name.
    • map<uint32, Reward>|{refer:"ItemConf.ID,EquipConf.ID"}: multi-refer without alias, then sheet alias is the generated protobuf message name.
    • map<uint32, Reward>|{refer:"Sheet1(ItemConf).ID"}: single-refer with alias, then sheet alias is the generated protobuf message name.

    Option sequence

    Option sequence is used to ensure this fieldโ€™s value is a sequence and begins with this value, and mainly used for map key and list element.

    For example:

    • map<uint32, Item>|{sequence:1}: this map key must follow the sequence rule which begins with value 1.

    Option default

    If option default is set, then use it as default value if cell is empty.

    Option fixed

    If option fixed is set as true, then auto-detect fixed size of horizontal list/map.

    For example:

    Option size

    Option size is used to specify fixed size of horizontal list/map.

    For example:

    Option form

    Option form is used to specify cell data form of incell struct.

    Two kinds of form can be specified:

    For detailed demos, see Advanced predefined incell struct โ†’.

    Option json_name

    By default, JSON name is deduced from the field’s proto name by converting it to camelCase. Now you -can explicitly specify it by json_name prop option.

    For example:

    For example, a worksheet ItemConf in HelloWorld.xlsx:

    IDRarity_1SpecialEffect_2
    map<int32, Item>int32|{json_name:“rarity_1”}int32|{json_name:“specialEffect_2”}
    Item’s IDItem’s rarity.Item’s special effect.
    110101
    220102
    330103

    Option present

    If option present is set as true, then cell data cannot be empty and must be filled explicitly. +can explicitly specify it by json_name prop option.

    For example:

    For example, a worksheet ItemConf in HelloWorld.xlsx:

    IDRarity_1SpecialEffect_2
    map<int32, Item>int32|{json_name:“rarity_1”}int32|{json_name:“specialEffect_2”}
    Item’s IDItem’s rarity.Item’s special effect.
    110101
    220102
    330103

    Option present

    If option present is set as true, then cell data cannot be empty and must be filled explicitly. Otherwise an error will be reported.

    diff --git a/nl/en/docs/excel/index.html b/nl/en/docs/excel/index.html index 2bc37739..2781ea44 100644 --- a/nl/en/docs/excel/index.html +++ b/nl/en/docs/excel/index.html @@ -1,4 +1,4 @@ -Excel - Tableau
    ServerTypeServerConfTypeServerConfConditionTypeServerConfConditionValue
    map<enum<.ServerType>, Server>[Conf]<enum<.ConfType»[Condition]int32
    Server nameSheet nameCondition typeCondition value
    SERVER_TYPE_GAMECONF_TYPE_CLOUD0113
    0134
    SERVER_TYPE_ACTIVITYCONF_TYPE_CLOUD
    1
    CONF_TYPE_LOCAL934
    CONF_TYPE_LOCAL912
    CONF_TYPE_LOCAL
    Remote
    MatchServerCONF_TYPE_UNKNOWN
    SheetNested
    LoaderConftrue

    Generated:

    hello_world.proto
    // --snip--
+
    ServerTypeServerConfTypeServerConfConditionTypeServerConfConditionValue
    map<enum<.ServerType>, Server>[Conf]<enum<.ConfType»[Condition]int32
    Server nameSheet nameCondition typeCondition value
    SERVER_TYPE_GAMECONF_TYPE_CLOUD0113
    0134
    SERVER_TYPE_ACTIVITYCONF_TYPE_CLOUD
    1
    CONF_TYPE_LOCAL934
    CONF_TYPE_LOCAL912
    CONF_TYPE_LOCAL
    Remote
    MatchServerCONF_TYPE_UNKNOWN
    SheetNested
    LoaderConftrue

    Generated:

    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
diff --git a/nl/en/docs/excel/list-in-list/index.html b/nl/en/docs/excel/list-in-list/index.html
index 235dc42e..32da4e00 100644
--- a/nl/en/docs/excel/list-in-list/index.html
+++ b/nl/en/docs/excel/list-in-list/index.html
@@ -1,4 +1,4 @@
-List in list - Tableau
    List in list
    Nested in vertical-list 
    Horizontal-list in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameProp1IDProp1ValueProp2IDProp2Value
    [Item]uint32string[Prop]int32int64int32int64
    Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
    1Apple110220
    2Orange330
    3Banana
    Generated:
    hello_world.proto
    // --snip--
+Prologue
    List in list
    Nested in vertical-list 
    Horizontal-list in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameProp1IDProp1ValueProp2IDProp2Value
    [Item]uint32string[Prop]int32int64int32int64
    Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
    1Apple110220
    2Orange330
    3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -70,7 +70,7 @@
         }
     ]
 }
-
    Vertical-list in vertical-keyed-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    [Item]<uint32>string[Prop]int32int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange120
    2Banana230
    Generated:
    hello_world.proto
    // --snip--
+
    Vertical-list in vertical-keyed-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    [Item]<uint32>string[Prop]int32int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange120
    2Banana230
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -115,7 +115,7 @@
         }
     ]
 }
-
    Incell-list in vertical-keyed-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProp
    [Item]uint32[]int32
    Item’s IDItem’s props
    110,20,30
    210,20
    310
    Generated:
    hello_world.proto
    // --snip--
+
    Incell-list in vertical-keyed-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProp
    [Item]uint32[]int32
    Item’s IDItem’s props
    110,20,30
    210,20
    310
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -152,7 +152,7 @@
         }
     ]
 }
-
    First-field in horizontal-list 
    Horizontal-list in horizontal-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
    [Reward][Item]int32int32int32int32stringint32int32string
    Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110220Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
+
    First-field in horizontal-list 
    Horizontal-list in horizontal-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
    [Reward][Item]int32int32int32int32stringint32int32string
    Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110220Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -198,7 +198,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
    [Reward][.Item]int32int32int32int32stringint32int32string
    Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110220Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
    [Reward][.Item]int32int32int32int32stringint32int32string
    Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110220Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
diff --git a/nl/en/docs/excel/list-in-map/index.html b/nl/en/docs/excel/list-in-map/index.html
index 94d55f75..69a0de37 100644
--- a/nl/en/docs/excel/list-in-map/index.html
+++ b/nl/en/docs/excel/list-in-map/index.html
@@ -1,4 +1,4 @@
-List in map - Tableau
    List in map
    Nested in vertical-map 
    Horizontal-list in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameProp1IDProp1ValueProp2IDProp2Value
    map<uint32, Item>string[Prop]int32int64int32int64
    Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
    1Apple110220
    2Orange330
    3Banana
    Generated:
    hello_world.proto
    // --snip--
+Prologue
    List in map
    Nested in vertical-map 
    Horizontal-list in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameProp1IDProp1ValueProp2IDProp2Value
    map<uint32, Item>string[Prop]int32int64int32int64
    Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
    1Apple110220
    2Orange330
    3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -70,7 +70,7 @@
         }
     }
 }
-
    Vertical-list in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    map<uint32, Item>string[Prop]int32int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange120
    2Banana230
    Generated:
    hello_world.proto
    // --snip--
+
    Vertical-list in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    map<uint32, Item>string[Prop]int32int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange120
    2Banana230
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -115,7 +115,7 @@
         }
     }
 }
-
    Incell-list in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProp
    map<uint32, Item>[]int32
    Item’s IDItem’s props
    110,20,30
    210,20
    310
    Generated:
    hello_world.proto
    // --snip--
+
    Incell-list in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProp
    map<uint32, Item>[]int32
    Item’s IDItem’s props
    110,20,30
    210,20
    310
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
diff --git a/nl/en/docs/excel/list/index.html b/nl/en/docs/excel/list/index.html
index 62ecb435..255f7c57 100644
--- a/nl/en/docs/excel/list/index.html
+++ b/nl/en/docs/excel/list/index.html
@@ -1,4 +1,4 @@
-List - Tableau
    List
    Horizontal list 
    There are three kinds of horizontal list:
    1. Horizontal scalar/enum list, as element type is scalar. E.g: []int32.
    2. Horizontal incell struct list, as element type is incell struct. E.g: []{int32 ID, string Name}Item.
    3. Horizontal struct list, as element type is struct. E.g: [Item]int32.
    Horizontal scalar list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Param1Param2Param3
    []int32int32int32
    Param1’s valueParam2’s valueParam3’s value
    123
    Generated:
    hello_world.proto
    // --snip--
+Prologue
    List
    Horizontal list 
    There are three kinds of horizontal list:
    1. Horizontal scalar/enum list, as element type is scalar. E.g: []int32.
    2. Horizontal incell struct list, as element type is incell struct. E.g: []{int32 ID, string Name}Item.
    3. Horizontal struct list, as element type is struct. E.g: [Item]int32.
    Horizontal scalar list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Param1Param2Param3
    []int32int32int32
    Param1’s valueParam2’s valueParam3’s value
    123
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -41,7 +41,7 @@
   FRUIT_TYPE_ORANGE  = 3 [(tableau.evalue).name = "Orange"];
   FRUIT_TYPE_BANANA  = 4 [(tableau.evalue).name = "Banana"];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    Param1Param2Param3
    []enum<.FruitType>enum<.FruitType>enum<.FruitType>
    Param1’s valueParam2’s valueParam3’s value
    1FRUIT_TYPE_ORANGEBanana
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    Param1Param2Param3
    []enum<.FruitType>enum<.FruitType>enum<.FruitType>
    Param1’s valueParam2’s valueParam3’s value
    1FRUIT_TYPE_ORANGEBanana
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -57,7 +57,7 @@
         "FRUIT_TYPE_BANANA"
     ]
 }
-
    Horizontal struct list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    [Item]uint32stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple2Orange3Banana
    Generated:
    hello_world.proto
    // --snip--
+
    Horizontal struct list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    [Item]uint32stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple2Orange3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -89,7 +89,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NumItem2IDItem2NumItem3IDItem3Num
    [.Item]int32int32int32int32int32int32
    Item1’s IDItem1’s numItem2’s IDItem3’s numItem3’s IDItem3’s num
    110022003300
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NumItem2IDItem2NumItem3IDItem3Num
    [.Item]int32int32int32int32int32int32
    Item1’s IDItem1’s numItem2’s IDItem3’s numItem3’s IDItem3’s num
    110022003300
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -114,7 +114,7 @@
         }
     ]
 }
-
    Horizontal incell-struct list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1Item2Item3
    []{int32 ID, string Name}ItemItemItem
    Item1’s infoItem2’s infoItem3’s info
    1,Apple2,Orange3,Banana
    Generated:
    hello_world.proto
    // --snip--
+
    Horizontal incell-struct list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1Item2Item3
    []{int32 ID, string Name}ItemItemItem
    Item1’s infoItem2’s infoItem3’s info
    1,Apple2,Orange3,Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -146,7 +146,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1Item2Item3
    []{.Item}.Item.Item
    Item1’s infoItem2’s infoItem3’s info
    1,1002,2003,300
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1Item2Item3
    []{.Item}.Item.Item
    Item1’s infoItem2’s infoItem3’s info
    1,1002,2003,300
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -171,7 +171,7 @@
         }
     ]
 }
-
    Vertical list 
    There are two kinds of vertical list:
    1. Vertical scalar list, as list element type is scalar. E.g: []int32.
    2. Vertical struct list, as list element type is struct. E.g: [Item]int32.
    Vertical scalar list 
    No need to support, use [Item]SCALAR instead:
    • [Item]int32
    • [Item]enum<.FruitType>
    Vertical struct list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameDesc
    [Item]uint32stringstring
    Item’s IDItem’s nameItem’s desc
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    Generated:
    hello_world.proto
    // --snip--
+
    Vertical list 
    There are two kinds of vertical list:
    1. Vertical scalar list, as list element type is scalar. E.g: []int32.
    2. Vertical struct list, as list element type is struct. E.g: [Item]int32.
    Vertical scalar list 
    No need to support, use [Item]SCALAR instead:
    • [Item]int32
    • [Item]enum<.FruitType>
    Vertical struct list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameDesc
    [Item]uint32stringstring
    Item’s IDItem’s nameItem’s desc
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -207,7 +207,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNum
    [.Item]int32int32
    Item’s IDItem’s num
    1100
    2200
    3300
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNum
    [.Item]int32int32
    Item’s IDItem’s num
    1100
    2200
    3300
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -232,7 +232,7 @@
         }
     ]
 }
-
    Vertical incell-struct list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Item
    []{int32 ID,int32 Num}Item
    Item’s info
    1,100
    2,200
    3,300
    Generated:
    hello_world.proto
    // --snip--
+
    Vertical incell-struct list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Item
    []{int32 ID,int32 Num}Item
    Item’s info
    1,100
    2,200
    3,300
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -264,7 +264,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    Item
    []{.Item}
    Item’s info
    1,100
    2,200
    3,300
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    Item
    []{.Item}
    Item’s info
    1,100
    2,200
    3,300
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -289,7 +289,7 @@
         }
     ]
 }
-
    Incell list 
    There are two kinds of in-cell list:
    1. Incell scalar list, as list value type is scalar. E.g: []int32.
    2. Incell struct list, as list value type is struct. E.g: [Item]int32.
    Incell scalar list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Param
    []int32
    Param list
    1,2,3
    4,5
    6
    The Param column’s type is incell list []int32, as the list element is scalar type int32.
    Generated:
    hello_world.proto
    // --snip--
+
    Incell list 
    There are two kinds of in-cell list:
    1. Incell scalar list, as list value type is scalar. E.g: []int32.
    2. Incell struct list, as list value type is struct. E.g: [Item]int32.
    Incell scalar list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Param
    []int32
    Param list
    1,2,3
    4,5
    6
    The Param column’s type is incell list []int32, as the list element is scalar type int32.
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -307,7 +307,7 @@
         6
     ]
 }
-
    Incell struct list 
    No need to support.
    Horizontal list size 
    Dynamic size 
    By default, all lists are Dynamically Sized Types. List elements should be present continuously, otherwise an error is reported if an empty element is existed in between.
    Fixed size 
    Implicit fixed size 
    The list size is auto resolved by the max present list elements in name row.
    In this example below, though the second element Item2 is empty, it is legal as the field property fixed is set true. Besides, Item2 will also be generated as an empty element. You can see it in the generated file ItemConf.json.
    A worksheet ItemConf in HelloWorld.xlsx.
    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    [Item]uint32|{fixed:true}stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple3Banana
    Generated:
    hello_world.proto
    // --snip--
+
    Incell struct list 
    No need to support.
    Horizontal list size 
    Dynamic size 
    By default, all lists are Dynamically Sized Types. List elements should be present continuously, otherwise an error is reported if an empty element is existed in between.
    Fixed size 
    Implicit fixed size 
    The list size is auto resolved by the max present list elements in name row.
    In this example below, though the second element Item2 is empty, it is legal as the field property fixed is set true. Besides, Item2 will also be generated as an empty element. You can see it in the generated file ItemConf.json.
    A worksheet ItemConf in HelloWorld.xlsx.
    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    [Item]uint32|{fixed:true}stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -335,7 +335,7 @@
         }
     ]
 }
-
    Explicit fixed size 
    The list size is explicitly set by field property size.
    In this example below, field property size is set as 2, then list elements after the second element Item2 will all be truncated. Besides, Item2 will also be generated as an empty element. You can see it in the generated file ItemConf.json.
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    [Item]uint32|{size:2}stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple3Banana
    Generated:
    hello_world.proto
    // --snip--
+
    Explicit fixed size 
    The list size is explicitly set by field property size.
    In this example below, field property size is set as 2, then list elements after the second element Item2 will all be truncated. Besides, Item2 will also be generated as an empty element. You can see it in the generated file ItemConf.json.
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    [Item]uint32|{size:2}stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -359,7 +359,7 @@
         }
     ]
 }
-
    Advanced features 
    Horizontal column-skipped list 
    A worksheet ItemConf in HelloWorld.xlsx:
    DProp1IDProp1ValueProp2IDProp2Value
    map<uint32, Item>[Prop]int32int32int32int32
    Item’s IDProp1โ€™s IDProp1โ€™s nameProp1โ€™s valueProp2โ€™s IDProp2โ€™s nameProp2โ€™s value
    11Apple1002Orange200
    23Banana3004Pomelo400
    35Watermelon500
    Generated:
    hello_world.proto
    // --snip--
+
    Advanced features 
    Horizontal column-skipped list 
    A worksheet ItemConf in HelloWorld.xlsx:
    DProp1IDProp1ValueProp2IDProp2Value
    map<uint32, Item>[Prop]int32int32int32int32
    Item’s IDProp1โ€™s IDProp1โ€™s nameProp1โ€™s valueProp2โ€™s IDProp2โ€™s nameProp2โ€™s value
    11Apple1002Orange200
    23Banana3004Pomelo400
    35Watermelon500
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -414,7 +414,7 @@
         }
     }
 }
-
    Keyed list 
    Keyed list is same as normal list, except that ColumnType (first field type) is surrounded by angle brackets <>, and is treated as map key.
    Syntax: [ElemType]<ColumnType>
    Vertical struct keyed-list 
    For example, a worksheet ItemConf in HelloWorld.xlsx:
    IDPropIDPropName
    [Item]<uint32>map<int32, Prop>string
    Item’s IDProp’s IDProp’s name
    11sweet
    21sweet
    22delicious
    Generated:
    hello_world.proto
    // --snip--
+
    Keyed list 
    Keyed list is same as normal list, except that ColumnType (first field type) is surrounded by angle brackets <>, and is treated as map key.
    Syntax: [ElemType]<ColumnType>
    Vertical struct keyed-list 
    For example, a worksheet ItemConf in HelloWorld.xlsx:
    IDPropIDPropName
    [Item]<uint32>map<int32, Prop>string
    Item’s IDProp’s IDProp’s name
    11sweet
    21sweet
    22delicious
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -456,7 +456,7 @@
         }
     ]
 }
-
    Scalar keyed-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Param
    []<int32>
    Param list
    1,2,2,3
    Generated:
    hello_world.proto
    // --snip--
+
    Scalar keyed-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Param
    []<int32>
    Param list
    1,2,2,3
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
diff --git a/nl/en/docs/excel/map-in-list/index.html b/nl/en/docs/excel/map-in-list/index.html
index bb9f7433..ee6f614a 100644
--- a/nl/en/docs/excel/map-in-list/index.html
+++ b/nl/en/docs/excel/map-in-list/index.html
@@ -1,4 +1,4 @@
-Map in list - Tableau
    Map in list
    Nested in vertical-list 
    Horizontal-map in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameProp1IDProp1ValueProp2IDProp2Value
    [Item]uint32stringmap<int32, Prop>int64int32int64
    Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
    1Apple110220
    2Orange330
    3Banana
    Generated:
    hello_world.proto
    // --snip--
+Prologue
    Map in list
    Nested in vertical-list 
    Horizontal-map in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameProp1IDProp1ValueProp2IDProp2Value
    [Item]uint32stringmap<int32, Prop>int64int32int64
    Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
    1Apple110220
    2Orange330
    3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -70,7 +70,7 @@
         }
     ]
 }
-
    Vertical-map in vertical-keyed-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    [Item]<uint32>stringmap<int32, Prop>int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange120
    2Banana230
    Generated:
    hello_world.proto
    // --snip--
+
    Vertical-map in vertical-keyed-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    [Item]<uint32>stringmap<int32, Prop>int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange120
    2Banana230
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -115,7 +115,7 @@
         }
     ]
 }
-
    Incell-map in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProps
    [Item]uint32map<int32, string>
    Item’s IDItem’s props
    11:sour,2:sweet,3:delicious
    21:sour,2:sweet
    31:sour
    Generated:
    hello_world.proto
    // --snip--
+
    Incell-map in vertical-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProps
    [Item]uint32map<int32, string>
    Item’s IDItem’s props
    11:sour,2:sweet,3:delicious
    21:sour,2:sweet
    31:sour
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -152,7 +152,7 @@
         }
     ]
 }
-
    First-field in horizontal-list 
    Horizontal-map in horizontal-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
    [Reward]map<int32, Item>int32int32int32stringint32int32string
    Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110220Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
+
    First-field in horizontal-list 
    Horizontal-map in horizontal-list 
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
    [Reward]map<int32, Item>int32int32int32stringint32int32string
    Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110220Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -198,7 +198,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
    [Reward]map<int32, .Item>int32int32int32stringint32int32string
    Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110220Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    Reward1Item1IDReward1Item1NumReward1Item2IDReward1Item2NumReward1NameReward2Item1IDReward2Item1NumReward2Name
    [Reward]map<int32, .Item>int32int32int32stringint32int32string
    Item1’s IDItem1’s numItem2’s IDItem2’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110220Lotto10100Super Lotto
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
diff --git a/nl/en/docs/excel/map-in-map/index.html b/nl/en/docs/excel/map-in-map/index.html
index 1152fd61..d41c46f3 100644
--- a/nl/en/docs/excel/map-in-map/index.html
+++ b/nl/en/docs/excel/map-in-map/index.html
@@ -1,4 +1,4 @@
-Map in map - Tableau
    Map in map
    Nested in vertical-map 
    Horizontal-map in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameProp1IDProp1ValueProp2IDProp2Value
    map<uint32, Item>stringmap<int32, Prop>int64int32int64
    Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
    1Apple110220
    2Orange330
    3Banana
    Generated:
    hello_world.proto
    // --snip--
+Prologue
    Map in map
    Nested in vertical-map 
    Horizontal-map in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameProp1IDProp1ValueProp2IDProp2Value
    map<uint32, Item>stringmap<int32, Prop>int64int32int64
    Item’s IDItem’s nameProp1’s IDProp1’s valueProp2’s IDProp2’s value
    1Apple110220
    2Orange330
    3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -70,7 +70,7 @@
         }
     }
 }
-
    Vertical-map in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    map<uint32, Item>stringmap<int32, Prop>int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange120
    2Orange230
    Generated:
    hello_world.proto
    // --snip--
+
    Vertical-map in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNamePropIDPropValue
    map<uint32, Item>stringmap<int32, Prop>int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange120
    2Orange230
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -115,7 +115,7 @@
         }
     }
 }
-
    Incell-map in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProps
    map<uint32, Item>map<int32, string>
    Item’s IDItem’s props
    11:sour,2:sweet,3:delicious
    21:sour,2:sweet
    31:sour
    Generated:
    hello_world.proto
    // --snip--
+
    Incell-map in vertical-map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDProps
    map<uint32, Item>map<int32, string>
    Item’s IDItem’s props
    11:sour,2:sweet,3:delicious
    21:sour,2:sweet
    31:sour
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
diff --git a/nl/en/docs/excel/map/index.html b/nl/en/docs/excel/map/index.html
index 91af2b11..e329b59d 100644
--- a/nl/en/docs/excel/map/index.html
+++ b/nl/en/docs/excel/map/index.html
@@ -1,4 +1,4 @@
-Map - Tableau
    Map
    Horizontal map 
    There are some kinds of horizontal map:
    1. Horizontal scalar map, as map value type is scalar. E.g: map<int32, int32>.
    2. Horizontal struct map, as map value type is struct. E.g: map<int32, Item>.
    3. Horizontal predefined-struct map, as map value type is predefined struct. E.g: map<int32, .Item>.
    Horizontal scalar map 
    No need to support, use this instead: map<int32, Item>.
    Horizontal struct map 
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    map<uint32, Item>stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple2Orange3Banana
    Generated:
    hello_world.proto
    // --snip--
+Prologue
    Map
    Horizontal map 
    There are some kinds of horizontal map:
    1. Horizontal scalar map, as map value type is scalar. E.g: map<int32, int32>.
    2. Horizontal struct map, as map value type is struct. E.g: map<int32, Item>.
    3. Horizontal predefined-struct map, as map value type is predefined struct. E.g: map<int32, .Item>.
    Horizontal scalar map 
    No need to support, use this instead: map<int32, Item>.
    Horizontal struct map 
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    map<uint32, Item>stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple2Orange3Banana
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -52,7 +52,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NumItem2IDItem2NumItem3IDItem3Num
    map<int32, .Item>int32int32int32int32int32
    Item1’s IDItem1’s numItem2’s IDItem3’s numItem3’s IDItem3’s num
    110022003300
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    Item1IDItem1NumItem2IDItem2NumItem3IDItem3Num
    map<int32, .Item>int32int32int32int32int32
    Item1’s IDItem1’s numItem2’s IDItem3’s numItem3’s IDItem3’s num
    110022003300
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -77,7 +77,7 @@
         }
     }
 }
-
    Vertical map 
    There are some kinds of vertical map:
    1. Vertical scalar map, as map value type is scalar. E.g: map<int32, int32>.
    2. Vertical struct map, as map value type is struct. E.g: map<int32, Item>.
    3. Vertical predefined-struct map, as map value type is predefined struct. E.g: map<int32, .Item>.
    Vertical scalar map 
    No need to support, use map<int32, Item> instead.
    Vertical struct map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameDesc
    map<uint32, Item>stringstring
    Itemโ€™s IDItemโ€™s nameItemโ€™s desc
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    Generated:
    hello_world.proto
    // --snip--
+
    Vertical map 
    There are some kinds of vertical map:
    1. Vertical scalar map, as map value type is scalar. E.g: map<int32, int32>.
    2. Vertical struct map, as map value type is struct. E.g: map<int32, Item>.
    3. Vertical predefined-struct map, as map value type is predefined struct. E.g: map<int32, .Item>.
    Vertical scalar map 
    No need to support, use map<int32, Item> instead.
    Vertical struct map 
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNameDesc
    map<uint32, Item>stringstring
    Itemโ€™s IDItemโ€™s nameItemโ€™s desc
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -113,7 +113,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNum
    map<int32, .Item>int32
    Item’s IDItem’s num
    1100
    2200
    3300
    Generated:
    hello_world.proto
    // --snip--
+
    A worksheet ItemConf in HelloWorld.xlsx:
    IDNum
    map<int32, .Item>int32
    Item’s IDItem’s num
    1100
    2200
    3300
    Generated:
    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -138,7 +138,7 @@
         }
     }
 }
-
    Incell map 
    There are some kinds of in-cell map:
    1. in-cell scalar map, as map value type is scalar. E.g: map<int32, int32>.
    2. in-cell struct map, as map value type is struct. E.g: map<int32, Item>.
    Incell scalar map 
    A worksheet ItemConf in HelloWorld.xlsx:
    Items
    map<uint32, string>
    Items
    1:Apple,2:Orange,3:Banana,4,:Peach
    The Items column’s type is in-cell map map<uint32, string>, as the map value is scalar type string.
    โš ๏ธ NOTE: If you want explicit pattern like: [Key:Value]..., then set the field property present as true.
+

    Incell map

    There are some kinds of in-cell map:

    1. in-cell scalar map, as map value type is scalar. E.g: map<int32, int32>.
    2. in-cell struct map, as map value type is struct. E.g: map<int32, Item>.

    Incell scalar map

    A worksheet ItemConf in HelloWorld.xlsx:

    Items
    map<uint32, string>
    Items
    1:Apple,2:Orange,3:Banana,4,:Peach

    The Items column’s type is in-cell map map<uint32, string>, as the map value is scalar type string.

    โš ๏ธ NOTE: If you want explicit pattern like: [Key:Value]..., then set the field property present as true. See Option present โ†’.

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -169,7 +169,7 @@
   FRUIT_FLAVOR_SOUR = 2 [(tableau.evalue).name = "Sour"];
   FRUIT_FLAVOR_SWEET = 3 [(tableau.evalue).name = "Sweet"];
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    FruitFlavorItem
    map<enum<.FruitType>, int64>map<int64, enum<.FruitFlavor»map<enum<.FruitType>, enum<.FruitFlavor»
    FruitsFlavorsItems
    Apple:1,Orange:21:Fragrant,2:SweetApple:Fragrant,Orange:Sour

    Generated:

    hello_world.proto
    // --snip--
+

    A worksheet ItemConf in HelloWorld.xlsx:

    FruitFlavorItem
    map<enum<.FruitType>, int64>map<int64, enum<.FruitFlavor»map<enum<.FruitType>, enum<.FruitFlavor»
    FruitsFlavorsItems
    Apple:1,Orange:21:Fragrant,2:SweetApple:Fragrant,Orange:Sour

    Generated:

    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -214,7 +214,7 @@
         }
     }
 }
-

    Empty key map

    If map key is not configured, then it will be treated as default value of map key type. Default value is illustrated at Scalar types โ†’.

    A worksheet ItemConf in HelloWorld.xlsx:

    IDDesc
    map<uint32, Item>string
    Item’s IDItem’s name
    1Apple
    Orange
    3Banana

    Generated:

    hello_world.proto
    // --snip--
+

    Empty key map

    If map key is not configured, then it will be treated as default value of map key type. Default value is illustrated at Scalar types โ†’.

    A worksheet ItemConf in HelloWorld.xlsx:

    IDDesc
    map<uint32, Item>string
    Item’s IDItem’s name
    1Apple
    Orange
    3Banana

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -256,7 +256,7 @@
   FruitType key = 1;
   ...
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    TypePrice
    map<enum<.FruitType>, Item>int32
    Item’s typeItem’s price
    Apple100
    Orange200
    Banana300

    Generated:

    hello_world.proto
    // --snip--
+

    A worksheet ItemConf in HelloWorld.xlsx:

    TypePrice
    map<enum<.FruitType>, Item>int32
    Item’s typeItem’s price
    Apple100
    Orange200
    Banana300

    Generated:

    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -285,7 +285,7 @@
         }
     }
 }
-

    Horizontal map size

    Dynamic size

    By default, all maps are Dynamically Sized Types. Map items should be present continuously, otherwise an error is reported if an empty item is existed in between.

    Fixed size

    Implicit fixed size

    The map size is auto resolved by the max map items present in name row.

    In this example below, though the second map item Item2 is empty, it is legal as the field property fixed is set true. Besides, Item2 will also be generated as an empty map item. You can see it in the generated file ItemConf.json.

    A worksheet ItemConf in HelloWorld.xlsx:

    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    map<uint32, Item>|{fixed:true}stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple3Banana

    Generated:

    hello_world.proto
    // --snip--
+

    Horizontal map size

    Dynamic size

    By default, all maps are Dynamically Sized Types. Map items should be present continuously, otherwise an error is reported if an empty item is existed in between.

    Fixed size

    Implicit fixed size

    The map size is auto resolved by the max map items present in name row.

    In this example below, though the second map item Item2 is empty, it is legal as the field property fixed is set true. Besides, Item2 will also be generated as an empty map item. You can see it in the generated file ItemConf.json.

    A worksheet ItemConf in HelloWorld.xlsx:

    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    map<uint32, Item>|{fixed:true}stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple3Banana

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -313,7 +313,7 @@
         }
     }
 }
-

    Explicit fixed size

    The map size is explicitly set by field property size.

    In this example below, field property size is set as 2, then map items after the second item Item2 will all be truncated. Besides, Item2 will also be generated as an empty map item. You can see it in the generated file ItemConf.json.

    A worksheet ItemConf in HelloWorld.xlsx:

    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    map<uint32, Item>|{size:2}stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple3Banana

    Generated:

    hello_world.proto
    // --snip--
+

    Explicit fixed size

    The map size is explicitly set by field property size.

    In this example below, field property size is set as 2, then map items after the second item Item2 will all be truncated. Besides, Item2 will also be generated as an empty map item. You can see it in the generated file ItemConf.json.

    A worksheet ItemConf in HelloWorld.xlsx:

    Item1IDItem1NameItem2IDItem2NameItem3IDItem3Name
    map<uint32, Item>|{size:2}stringuint32stringuint32string
    Item1’s IDItem1’s nameItem2’s IDItem2’s nameItem3’s IDItem3’s name
    1Apple3Banana

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -337,7 +337,7 @@
         }
     }
 }
-

    Advanced features

    Horizontal column-skipped map

    A worksheet ItemConf in HelloWorld.xlsx:

    DProp1IDProp1ValueProp2IDProp2Value
    map<uint32, Item>map<int32, Prop>int32int32int32
    Item’s IDProp1โ€™s IDProp1โ€™s nameProp1โ€™s valueProp2โ€™s IDProp2โ€™s nameProp2โ€™s value
    11Apple1002Orange200
    23Banana3004Pomelo400
    35Watermelon500

    Generated:

    hello_world.proto
    // --snip--
+

    Advanced features

    Horizontal column-skipped map

    A worksheet ItemConf in HelloWorld.xlsx:

    DProp1IDProp1ValueProp2IDProp2Value
    map<uint32, Item>map<int32, Prop>int32int32int32
    Item’s IDProp1โ€™s IDProp1โ€™s nameProp1โ€™s valueProp2โ€™s IDProp2โ€™s nameProp2โ€™s value
    11Apple1002Orange200
    23Banana3004Pomelo400
    35Watermelon500

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -397,7 +397,7 @@
 }

    Ordered-map

    In the metasheet @TABLEAU, set the OrderedMap option to true, then ordered map accessers will be generated. This feature is powered by tableauio/loader. Currently supported programming languages are:

    • C++
    • Golang
    • C#

    Example

    If we want ItemConf to generate ordered map accessers, then set -OrderedMap option to true of metasheet @TABLEAU:

    IDName
    map<uint32, Item>string
    Item’s IDItem’s Name
    1Apple
    2Orange
    3Banana
    SheetOrderedMap
    ItemConftrue

    More useful options are illustrated at metasheet chapter. Metasheet @TABLEAU โ†’

    +OrderedMap option to true of metasheet @TABLEAU:

    IDName
    map<uint32, Item>string
    Item’s IDItem’s Name
    1Apple
    2Orange
    3Banana
    SheetOrderedMap
    ItemConftrue

    More useful options are illustrated at metasheet chapter. Metasheet @TABLEAU โ†’

    \ No newline at end of file diff --git a/nl/en/docs/excel/metasheet/index.html b/nl/en/docs/excel/metasheet/index.html index 81f62aa4..0d672973 100644 --- a/nl/en/docs/excel/metasheet/index.html +++ b/nl/en/docs/excel/metasheet/index.html @@ -1,4 +1,4 @@ -Metasheet - Tableau

    Metasheet

    Overview

    Options below can be specified in the metasheet @TABLEAU to affect the corresponding worksheet’s layout, ability, loader and so on.

    OptionTypeDescription
    SheetstringThe worksheet name needed to be processed.
    AliasstringRename worksheet to be used as the generated protoconf message name.
    Namerowint32Exact row number of column name definition at a worksheet.
    Default: 1.
    Typerowint32Exact row number of column type definition at a worksheet.
    Default: 2.
    Noterowint32Exact row number of column note definition at a worksheet.
    Default: 3.
    Datarowint32Start row number of data at a worksheet.
    Default: 4.
    Namelineint32The line number of column name definition in a cell. 0 means the whole cell.
    Default: 0.
    Typelineint32The line number of column type definition in a cell. 0 means the whole cell.
    Default: 0.
    TransposeboolInterchanging the rows and columns of a given sheet.
    NestedboolNested naming of the namerow.
    Default: false.
    SepstringSeparator for:
    ย ย  1. separating in-cell list elements.
    ย ย  2. separating in-cell map items.
    Default: ,.
    SubsepstringSubseparator for separating in-cell map Key-Value pair.
    Default: :.
    Merger[]stringMerge multiple workbook sheets (comma-separated) into this one with the same structure.
    E.g.: Item1.xlsx,Item2.xlsx.
    AdjacentKeyboolMerge adjacent rows with the same key. If the key cell is not set, it will be treated the same as the nearest key above the same column.
    Default:false.
    FieldPresenceboolIn order to track field presence of basic types (numeric, string, bytes, and enums), the generated field will be labeled optional.
    Default:false.
    ScatterboolConvert multiple sheets separately with same schema.
    OrderedMapboolGenerate OrderedMap accessers or not.
    Default: false.
    Supported: C++.
    Index[]stringGenerate index accessers, and multiple indexes are comma-separated.
    - Single-column index is in the forma: <ColumnName>[@IndexName], if IndexName is not set, it will be this column’s parent struct type name.
    - Multi-column index (or composite index) is in the form: ([column1, column2, column3,...])[@IndexName]
    E.g.:
    - ID
    - ID@Item
    - (ID,Type)
    - (ID,Type)@Item
    - ID, (ID,Type)@Item
    Supported: C++.

    Empty @TABLEAU

    If metasheet @TABLEAU is empty, then all other worksheets in the same workbook will be processed.

    A simple example

    There is a worksheet Sheet1 in HelloWorld.xlsx, we want to rename sheet to -ItemConf, define custom seperator as |, and generate ordered map accessers.

    So the metasheet @TABLEAU in HelloWorld.xlsx should be configured as:

    IDName
    map<uint32, Item>string
    Item’s IDItem’s Name
    1Apple
    2Orange
    3Banana
    SheetAliasSepOrderedMap
    Sheet1ItemConf|true

    Option Transpose

    In linear algebra, the transpose of a matrix is an operator which flips a matrix over its diagonal. Likewise, the transpose of a sheet (2D matrix) means interchanging its rows into columns or columns into rows.

    See more details about Excel: Transpose (rotate) data from rows to columns or vice versa.

    Option Transpose is specified as true in the metasheet @TABLEAU.

    A worksheet HeroConf in HelloWorld.xlsx:

    IDint32Hero’s ID123
    NamestringHero’s nameRobin
    DescstringHero’s descriptionA big hero!
    Skill[]int32Hero’s skills100,101,102
    SheetTranspose
    HeroConftrue

    Generated:

    hello_world.proto
    // --snip--
+ItemConf, define custom seperator as |, and generate ordered map accessers.
    So the metasheet @TABLEAU in HelloWorld.xlsx should be configured as:
    IDName
    map<uint32, Item>string
    Item’s IDItem’s Name
    1Apple
    2Orange
    3Banana
    SheetAliasSepOrderedMap
    Sheet1ItemConf|true
    Option Transpose 
    In linear algebra, the transpose of a matrix is an operator which flips a matrix over its diagonal. Likewise, the transpose of a sheet (2D matrix) means interchanging its rows into columns or columns into rows.
    See more details about Excel: Transpose (rotate) data from rows to columns or vice versa.
    Option Transpose is specified as true in the metasheet @TABLEAU.
    A worksheet HeroConf in HelloWorld.xlsx:
    IDint32Hero’s ID123
    NamestringHero’s nameRobin
    DescstringHero’s descriptionA big hero!
    Skill[]int32Hero’s skills100,101,102
    SheetTranspose
    HeroConftrue
    Generated:
    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message HeroConf {
@@ -43,7 +43,7 @@
     ]
 }
 
    Option Merger 
    Option Merger is used to merge multiple sheets (comma-separated) with same schema to one.
    Each element can be:
    1. just a workbook file path or Glob path (relative to this workbook): <Workbook>,
-then the sheet name is the same as this sheet.
    2. a workbook file path (relative to this workbook) with a worksheet name: <Workbook>#<Worksheet>.
    For example:
    The first (main) workbook: a worksheet ZoneConf in MergerMain.xlsx (with @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    1Infinity100
    SheetMerger
    ZoneConfMerger*.xlsx
    The second (sub) workbook: a worksheet ZoneConf in Merger2.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    2Desert200
    The third (sub) workbook: a worksheet ZoneConf in Merger3.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    3Snowfield300
    Generated:
    merger_main.proto
    // --snip--
+then the sheet name is the same as this sheet.
  • a workbook file path (relative to this workbook) with a worksheet name: <Workbook>#<Worksheet>.
    • For example:
    The first (main) workbook: a worksheet ZoneConf in MergerMain.xlsx (with @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    1Infinity100
    SheetMerger
    ZoneConfMerger*.xlsx
    The second (sub) workbook: a worksheet ZoneConf in Merger2.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    2Desert200
    The third (sub) workbook: a worksheet ZoneConf in Merger3.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    3Snowfield300
    Generated:
    merger_main.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ZoneConf {
@@ -76,7 +76,7 @@
     }
 }
 
    Option Scatter 
    Option Scatter is used to scatter multiple sheets (comma-separated) with same schema to different generated config files.
    Each element can be:
    1. just a workbook file path or Glob path (relative to this workbook): <Workbook>,
-then the sheet name is the same as this sheet.
    2. a workbook file path (relative to this workbook) with a worksheet name: <Workbook>#<Worksheet>.
    For example, there are three workbooks (each with same sheet schema, and Scatter1.xlsx is the main workbook):
    • Scatter1.xlsx
    • Scatter2.xlsx
    • Scatter3.xlsx
    The first (main) workbook: a worksheet ZoneConf in Scatter1.xlsx (with @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    1Infinity100
    SheetScatter
    ZoneConfScatter*.xlsx
    The second (sub) workbook: a worksheet ZoneConf in Scatter2.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    2Desert200
    The third (sub) workbook: a worksheet ZoneConf in Scatter3.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    3Snowfield300
    Generated protoconf:
    scatter_1.proto
    // --snip--
+then the sheet name is the same as this sheet.
  • a workbook file path (relative to this workbook) with a worksheet name: <Workbook>#<Worksheet>.
    • For example, there are three workbooks (each with same sheet schema, and Scatter1.xlsx is the main workbook):
    • Scatter1.xlsx
    • Scatter2.xlsx
    • Scatter3.xlsx
    The first (main) workbook: a worksheet ZoneConf in Scatter1.xlsx (with @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    1Infinity100
    SheetScatter
    ZoneConfScatter*.xlsx
    The second (sub) workbook: a worksheet ZoneConf in Scatter2.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    2Desert200
    The third (sub) workbook: a worksheet ZoneConf in Scatter3.xlsx (without @TABLEAU):
    IDNameDifficulty
    map<uint32, Zone>stringint32
    Zoneโ€™s IDZoneโ€™s nameZoneโ€™s difficulty
    3Snowfield300
    Generated protoconf:
    scatter_1.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ZoneConf {
@@ -117,7 +117,7 @@
     }
 }
 
    Option Index 
    Option Index can be specified to generate index accessers, and multiple indexes are comma-separated.
-There are two kinds of indexes in tableau: one is single-column index, and another is multi-column index (aka composite index).
    Each column type can be:
    • scalar: numbers, booleans, strings, and bytes.
    • enum: e.g.: enum<.FruiteType>
    • incell scalar list: e.g: []int32
    • incell enum list: e.g: []enum<.FruiteType>
    Example: two worksheets ItemConf and ShopConf in HelloWorld.xlsx:
    • ItemConf: index on columns of the same struct as map value.
    • ShopConf: index on columns of the same struct as list element.
    IDNameDesc
    map<int32, Item>stringstring
    Item’s IDItem’s nameItem’s desc
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    IDTypeDesc
    [Shop]int32int32string
    Shop’s IDShop’s typeShop’s desc
    11Shoes shop.
    21T-Shirt shop.
    32Fruite shop.
    SheetIndex
    ItemConfID@Item, Name@AwardItem, (ID,Name)@SpecialItem
    ShopConfID@Shop, Type@ThemeShop, (ID,Type)@SpecialShop
    Single-column index 
    Format: <ColumnName>[@IndexName].
    The sign @ is the separator between column name and index name. if IndexName is not set, it will be this columnโ€™s parent struct type name. One or more indexes can be specified by comma-separated rule.
    Examples:
    • ID
    • ID@Item
    • ID, Name@AwardItem
    • ID@Item, Name@AwardItem
    Multi-column index 
    Format: ([ColumnName1, ColumnName2, ColumnName3,...])[@IndexName].
    Multi-column index (or composite index) is composed of multiple columns in the same struct (in list or map) to increase query speed.
    The sign @ is the separator between enclosed column names by parentheses and index name. if IndexName is not set, it will be this columnโ€™s parent struct type name. One or more indexes can be specified by comma-separated rule.
    Examples:
    • (ID,Name)
    • (ID,Name)@AwardItem
    • ID@Item, (ID,Name)@AwardItem: one single-column index and one multi-column index.
    +There are two kinds of indexes in tableau: one is single-column index, and another is multi-column index (aka composite index).

    Each column type can be:

    • scalar: numbers, booleans, strings, and bytes.
    • enum: e.g.: enum<.FruiteType>
    • incell scalar list: e.g: []int32
    • incell enum list: e.g: []enum<.FruiteType>

    Example: two worksheets ItemConf and ShopConf in HelloWorld.xlsx:

    • ItemConf: index on columns of the same struct as map value.
    • ShopConf: index on columns of the same struct as list element.
    IDNameDesc
    map<int32, Item>stringstring
    Item’s IDItem’s nameItem’s desc
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.
    IDTypeDesc
    [Shop]int32int32string
    Shop’s IDShop’s typeShop’s desc
    11Shoes shop.
    21T-Shirt shop.
    32Fruite shop.
    SheetIndex
    ItemConfID@Item, Name@AwardItem, (ID,Name)@SpecialItem
    ShopConfID@Shop, Type@ThemeShop, (ID,Type)@SpecialShop

    Single-column index

    Format: <ColumnName>[@IndexName].

    The sign @ is the separator between column name and index name. if IndexName is not set, it will be this columnโ€™s parent struct type name. One or more indexes can be specified by comma-separated rule.

    Examples:

    • ID
    • ID@Item
    • ID, Name@AwardItem
    • ID@Item, Name@AwardItem

    Multi-column index

    Format: ([ColumnName1, ColumnName2, ColumnName3,...])[@IndexName].

    Multi-column index (or composite index) is composed of multiple columns in the same struct (in list or map) to increase query speed.

    The sign @ is the separator between enclosed column names by parentheses and index name. if IndexName is not set, it will be this columnโ€™s parent struct type name. One or more indexes can be specified by comma-separated rule.

    Examples:

    • (ID,Name)
    • (ID,Name)@AwardItem
    • ID@Item, (ID,Name)@AwardItem: one single-column index and one multi-column index.
    \ No newline at end of file diff --git a/nl/en/docs/excel/page/2/index.html b/nl/en/docs/excel/page/2/index.html index 19bc307a..10ed9b0e 100644 --- a/nl/en/docs/excel/page/2/index.html +++ b/nl/en/docs/excel/page/2/index.html @@ -1,4 +1,4 @@ -Excel - Tableau

    Scalar

    Scalar

    A worksheet Apple in HelloWorld.xlsx:

    IDNameDesc
    uint32stringstring
    Item’s IDItem’s NameItem’s Description
    1AppleA kind of delicious fruit.

    In this worksheet, three scalar fields are defined:

    1. ID: uint32
    2. Name: string
    3. Desc: string

    Generated:

    hello_world.proto
    // --snip--
+Prologue

    Scalar

    Scalar

    A worksheet Apple in HelloWorld.xlsx:

    IDNameDesc
    uint32stringstring
    Item’s IDItem’s NameItem’s Description
    1AppleA kind of delicious fruit.

    In this worksheet, three scalar fields are defined:

    1. ID: uint32
    2. Name: string
    3. Desc: string

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message Apple {
diff --git a/nl/en/docs/excel/sitemap.xml b/nl/en/docs/excel/sitemap.xml
index ac97b179..6dea282a 100644
--- a/nl/en/docs/excel/sitemap.xml
+++ b/nl/en/docs/excel/sitemap.xml
@@ -1 +1 @@
-https://tableauio.github.io/nl/en/docs/excel/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/union/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/infinite-nesting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/field-property/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/metasheet/2024-08-28T12:06:34+08:00weekly0.5
\ No newline at end of file
+https://tableauio.github.io/nl/en/docs/excel/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/infinite-nesting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/field-property/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/metasheet/2024-09-02T20:36:29+08:00weekly0.5
\ No newline at end of file
diff --git a/nl/en/docs/excel/struct-in-list/index.html b/nl/en/docs/excel/struct-in-list/index.html
index aef9a25b..899ee494 100644
--- a/nl/en/docs/excel/struct-in-list/index.html
+++ b/nl/en/docs/excel/struct-in-list/index.html
@@ -1,4 +1,4 @@
-Struct in list - Tableau

    Struct in list

    Nested in vertical-list

    Struct in vertical-list

    A worksheet ItemConf in HelloWorld.xlsx:

    IDNamePropIDPropValue
    [Item]uint32string{Prop}int32int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange220
    3Banana

    Generated:

    hello_world.proto
    // --snip--
+Prologue

    Struct in list

    Nested in vertical-list

    Struct in vertical-list

    A worksheet ItemConf in HelloWorld.xlsx:

    IDNamePropIDPropValue
    [Item]uint32string{Prop}int32int64
    Item’s IDItem’s nameProp’s IDProp’s value
    1Apple110
    2Orange220
    3Banana

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -62,7 +62,7 @@
         }
     ]
 }
-

    Incell-struct in vertical-list

    A worksheet ItemConf in HelloWorld.xlsx:

    IDNamePropID
    [Item]uint32string{int32 ID,int64 Value}Prop
    Item’s IDItem’s nameProp’s ID
    1Apple1,100
    2Orange2,200
    3Banana

    Generated:

    hello_world.proto
    // --snip--
+

    Incell-struct in vertical-list

    A worksheet ItemConf in HelloWorld.xlsx:

    IDNamePropID
    [Item]uint32string{int32 ID,int64 Value}Prop
    Item’s IDItem’s nameProp’s ID
    1Apple1,100
    2Orange2,200
    3Banana

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -104,7 +104,7 @@
         }
     ]
 }
-

    First-field in horizontal-list

    Struct in horizontal-list

    A worksheet ItemConf in HelloWorld.xlsx:

    Reward1ItemIDReward1ItemNumReward1NameReward2ItemIDReward2ItemNumReward2Name
    [Reward]{Item}int32int32stringint32int32string
    Item1’s IDItem1’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110Lotto10100Super Lotto

    Generated:

    hello_world.proto
    // --snip--
+

    First-field in horizontal-list

    Struct in horizontal-list

    A worksheet ItemConf in HelloWorld.xlsx:

    Reward1ItemIDReward1ItemNumReward1NameReward2ItemIDReward2ItemNumReward2Name
    [Reward]{Item}int32int32stringint32int32string
    Item1’s IDItem1’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110Lotto10100Super Lotto

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -142,7 +142,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    Reward1ItemIDReward1ItemNumReward1NameReward2ItemIDReward2ItemNumReward2Name
    [Reward]{.Item}int32int32stringint32int32string
    Item1’s IDItem1’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110Lotto10100Super Lotto

    Generated:

    hello_world.proto
    // --snip--
+

    A worksheet ItemConf in HelloWorld.xlsx:

    Reward1ItemIDReward1ItemNumReward1NameReward2ItemIDReward2ItemNumReward2Name
    [Reward]{.Item}int32int32stringint32int32string
    Item1’s IDItem1’s numReward’s nameItem1’s IDItem1’s numReward’s name
    110Lotto10100Super Lotto

    Generated:

    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -173,7 +173,7 @@
         }
     ]
 }
-

    Incell-struct in horizontal-list

    A worksheet ItemConf in HelloWorld.xlsx:

    Reward1ItemReward1NameReward2ItemReward2Name
    [Reward]{int32 ID, int32 Num}ItemstringItemstring
    Reward1’s itemReward’s nameReward2’s itemReward’s name
    1,10Lotto2,20Super Lotto

    Generated:

    hello_world.proto
    // --snip--
+

    Incell-struct in horizontal-list

    A worksheet ItemConf in HelloWorld.xlsx:

    Reward1ItemReward1NameReward2ItemReward2Name
    [Reward]{int32 ID, int32 Num}ItemstringItemstring
    Reward1’s itemReward’s nameReward2’s itemReward’s name
    1,10Lotto2,20Super Lotto

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
diff --git a/nl/en/docs/excel/struct-in-map/index.html b/nl/en/docs/excel/struct-in-map/index.html
index bf0cc4be..16968232 100644
--- a/nl/en/docs/excel/struct-in-map/index.html
+++ b/nl/en/docs/excel/struct-in-map/index.html
@@ -1,4 +1,4 @@
-Struct in map - Tableau

    Struct in map

    Nested in vertical-map

    Struct in vertical-map

    A worksheet ItemConf in HelloWorld.xlsx:

    IDItemIDItemNum
    map<int32, Reward>{Item}int32int32
    Reward’s IDItem’s IDItem’s Num
    1110
    2220
    3

    Generated:

    hello_world.proto
    // --snip--
+Prologue

    Struct in map

    Nested in vertical-map

    Struct in vertical-map

    A worksheet ItemConf in HelloWorld.xlsx:

    IDItemIDItemNum
    map<int32, Reward>{Item}int32int32
    Reward’s IDItem’s IDItem’s Num
    1110
    2220
    3

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -62,7 +62,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    IDItemIDItemNum
    map<int32, Reward>{.Item}int32int32
    Reward’s IDItem’s IDItem’s Num
    1110
    2220
    3

    Generated:

    hello_world.proto
    // --snip--
+

    A worksheet ItemConf in HelloWorld.xlsx:

    IDItemIDItemNum
    map<int32, Reward>{.Item}int32int32
    Reward’s IDItem’s IDItem’s Num
    1110
    2220
    3

    Generated:

    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -97,7 +97,7 @@
         }
     }
 }
-

    Incell-struct in vertical-map

    A worksheet ItemConf in HelloWorld.xlsx:

    IDItem
    map<int32, Reward>{int32 ID, int32 Num}Item
    Reward’s IDItem’s info
    11,100
    22,200
    3

    Generated:

    hello_world.proto
    // --snip--
+

    Incell-struct in vertical-map

    A worksheet ItemConf in HelloWorld.xlsx:

    IDItem
    map<int32, Reward>{int32 ID, int32 Num}Item
    Reward’s IDItem’s info
    11,100
    22,200
    3

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
diff --git a/nl/en/docs/excel/struct-in-struct/index.html b/nl/en/docs/excel/struct-in-struct/index.html
index b810bff4..3707edfe 100644
--- a/nl/en/docs/excel/struct-in-struct/index.html
+++ b/nl/en/docs/excel/struct-in-struct/index.html
@@ -1,4 +1,4 @@
-Struct in struct - Tableau

    Struct in struct

    Struct in struct

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardIDRewardItemIDRewardItemNum
    {Reward}int32{Item}int32int32
    Reward’s IDItem’s IDItem’s num
    1110

    Generated:

    hello_world.proto
    // --snip--
+Prologue

    Struct in struct

    Struct in struct

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardIDRewardItemIDRewardItemNum
    {Reward}int32{Item}int32int32
    Reward’s IDItem’s IDItem’s num
    1110

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -49,7 +49,7 @@
     int32 id = 1 [(tableau.field) = {name:"ID"}];
     int32 num = 2 [(tableau.field) = {name:"Num"}];
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardIDRewardItemIDRewardItemNum
    {Reward}int32{.Item}int32int32
    Reward’s IDItem’s IDItem’s num
    1110

    Generated:

    hello_world.proto
    // --snip--
+

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardIDRewardItemIDRewardItemNum
    {Reward}int32{.Item}int32int32
    Reward’s IDItem’s IDItem’s num
    1110

    Generated:

    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -71,7 +71,7 @@
         }
     }
 }
-

    Incell-struct in struct

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardIDRewardItem
    {Reward}int32{int32 ID, int32 Num}Item
    Reward’s IDReward’s item
    11,100
    2,200

    Generated:

    hello_world.proto
    // --snip--
+

    Incell-struct in struct

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardIDRewardItem
    {Reward}int32{int32 ID, int32 Num}Item
    Reward’s IDReward’s item
    11,100
    2,200

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
diff --git a/nl/en/docs/excel/struct/index.html b/nl/en/docs/excel/struct/index.html
index a3804f7d..21ec75d6 100644
--- a/nl/en/docs/excel/struct/index.html
+++ b/nl/en/docs/excel/struct/index.html
@@ -1,4 +1,4 @@
-Struct - Tableau

    Struct

    Cross-cell struct

    Syntax: <StructType>ColumnType.

    Each column name should be prefixed with the same struct variable name, which is just the same as struct type name by default.

    For example, a worksheet ItemConf in HelloWorld.xlsx:

    PropertyIDPropertyNamePropertyDesc
    {Property}int32stringstring
    Property’s IDProperty’s NameProperty’s Description
    1OrangeA kind of sour fruit.

    Note that each column name in ItemConf is prefixed with struct variable name Property which is same as struct type name.

    Generated:

    hello_world.proto
    // --snip--
+Prologue

    Struct

    Cross-cell struct

    Syntax: <StructType>ColumnType.

    Each column name should be prefixed with the same struct variable name, which is just the same as struct type name by default.

    For example, a worksheet ItemConf in HelloWorld.xlsx:

    PropertyIDPropertyNamePropertyDesc
    {Property}int32stringstring
    Property’s IDProperty’s NameProperty’s Description
    1OrangeA kind of sour fruit.

    Note that each column name in ItemConf is prefixed with struct variable name Property which is same as struct type name.

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -40,7 +40,7 @@
         "desc":  "A kind of sour fruit."
     }
 }
-

    Note

    Cross-cell struct is usually used together with:

    • cross-cell horizontal/vertical map, as map value type. Map โ†’
    • cross-cell horizontal/vertical list, as list element type. List โ†’

    Incell struct

    Each field type of the struct should be scalar type.

    For example, a worksheet ItemConf in HelloWorld.xlsx:

    IDProp
    map<int32, Item>{int32 ID,string Name,string Desc}Property
    Item’s IDItem’s property.
    11,Orange,A good fruit.
    22,Apple
    33

    The Property column’s type is in-cell struct {int32 ID,string Name,string Desc}Property.

    Generated:

    hello_world.proto
    // --snip--
+

    Note

    Cross-cell struct is usually used together with:

    • cross-cell horizontal/vertical map, as map value type. Map โ†’
    • cross-cell horizontal/vertical list, as list element type. List โ†’

    Incell struct

    Each field type of the struct should be scalar type.

    For example, a worksheet ItemConf in HelloWorld.xlsx:

    IDProp
    map<int32, Item>{int32 ID,string Name,string Desc}Property
    Item’s IDItem’s property.
    11,Orange,A good fruit.
    22,Apple
    33

    The Property column’s type is in-cell struct {int32 ID,string Name,string Desc}Property.

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
@@ -90,7 +90,7 @@
   string name = 2 [(tableau.field) = {name:"Name"}];
   string desc = 3 [(tableau.field) = {name:"Desc"}];
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    IDProp
    map<uint32, Item>{.Property}
    Item’s IDItem’s property.
    11,Orange,A good fruit.
    22,Apple
    33

    The Prop column’s type is a predefined struct Property.

    Generated:

    hello_world.proto
    // --snip--
+

    A worksheet ItemConf in HelloWorld.xlsx:

    IDProp
    map<uint32, Item>{.Property}
    Item’s IDItem’s property.
    11,Orange,A good fruit.
    22,Apple
    33

    The Prop column’s type is a predefined struct Property.

    Generated:

    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -135,7 +135,7 @@
   int32 id = 1 [(tableau.field).name = "ID"];
   int32 num = 2 [(tableau.field).name = "Num"];
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardItemIDRewardItemNumCostItemIDCostItemNumPredefinedItemIDPredefinedItemNum
    {Item(RewardItem)}int32int32{Item(CostItem)}int32int32{.Item(PredefinedItem)}int32int32
    Item’s IDItem’s IDCost’s IDCost’s IDPredefined item’s IDPredefined item’s ID
    110022001020

    Details: +

    A worksheet ItemConf in HelloWorld.xlsx:

    RewardItemIDRewardItemNumCostItemIDCostItemNumPredefinedItemIDPredefinedItemNum
    {Item(RewardItem)}int32int32{Item(CostItem)}int32int32{.Item(PredefinedItem)}int32int32
    Item’s IDItem’s IDCost’s IDCost’s IDPredefined item’s IDPredefined item’s ID
    110022001020

    Details: In type cell {Item(RewardItem)}int32, RewardItem is the custom variable name of new defined struct Item. And in type cell {Item(CostItem)}int32, CostItem is the custom variable name of just already defined struct Item in the same scope. Finally, in type cell {.Item(PredefinedItem)}int32, PredefinedItem is the custom variable name of predefined struct Item at global (at the same protobuf package).

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -175,7 +175,7 @@
   float y = 2;
   float z = 3;
 }
-

    A worksheet ItemConf in HelloWorld.xlsx:

    Transform1Transform2
    {.Transform}|{form:FORM_TEXT}{.Transform}|{form:FORM_JSON}
    Box’s transform1Box’s transform2
    position:{x:1 y:2 z:3} rotation:{x:4 y:5 z:6} scale:{x:7 y:8 z:9}{“position”:{“x”:1, “y”:2, “z”:3}, “rotation”:{“x”:4, “y”:5, “z”:6}, “scale”:{“x”:7, “y”:8, “z”:9}}

    Generated:

    hello_world.proto
    // --snip--
+

    A worksheet ItemConf in HelloWorld.xlsx:

    Transform1Transform2
    {.Transform}|{form:FORM_TEXT}{.Transform}|{form:FORM_JSON}
    Box’s transform1Box’s transform2
    position:{x:1 y:2 z:3} rotation:{x:4 y:5 z:6} scale:{x:7 y:8 z:9}{“position”:{“x”:1, “y”:2, “z”:3}, “rotation”:{“x”:4, “y”:5, “z”:6}, “scale”:{“x”:7, “y”:8, “z”:9}}

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message ItemConf {
diff --git a/nl/en/docs/excel/union/index.html b/nl/en/docs/excel/union/index.html
index 29465aa6..a4960464 100644
--- a/nl/en/docs/excel/union/index.html
+++ b/nl/en/docs/excel/union/index.html
@@ -1,4 +1,4 @@
-Union - Tableau

    Predefined union in map

    Based on predefined union type Target.

    A worksheet TaskConf in HelloWorld.xlsx:

    IDTargetTypeTargetField1TargetField2TargetField3Progress
    map<int32, Task>{.Target}enum<.Target.Type>unionunionunionint32
    IDTarget’s typeTarget’s field1Target’s field2Target’s field3Progress
    1PVP110Apple,Orange,Banana3
    2PVE1,100,9991,2,31:10,2:20,3:3010
    3Story1001,101:Apple,2:OrangeFragrant:1,Sour:210
    4Skill128

    Generated:

    hello_world.proto
    // --snip--
+

    Predefined union in list

    Based on predefined union type Target.

    A worksheet TaskConf in HelloWorld.xlsx:

    IDTarget1TypeTarget1Field1Target1Field2Target1Field3Target2TypeTarget2Field1Target2Field2Target2Field3
    map<int32, Task>[.Target]enum<.Target.Type>unionunionunionenum<.Target.Type>unionunionunion
    IDTarget1’s typeTarget1’s field1Target1’s field2Target1’s field3Target2’s typeTarget2’s field1Target2’s field2Target2’s field3
    1PVP110Apple,Orange,BananaPVE1,100,9991,2,31:10,2:20,3:30
    2Story1001,101:Apple,2:OrangeFragrant:1,Sour:2Skill12

    Generated:

    hello_world.proto
    // --snip--
+import "common.proto";
+option (tableau.workbook) = {name:"HelloWorld.xlsx"};
+
+message TaskConf {
+  option (tableau.worksheet) = {name:"TaskConf" namerow:1 typerow:2 noterow:3 datarow:4};
+
+  map<int32, Task> task_map = 1 [(tableau.field) = {key:"ID" layout:LAYOUT_VERTICAL}];
+  message Task {
+    int32 id = 1 [(tableau.field) = {name:"ID"}];
+    repeated protoconf.Target target_list = 2 [(tableau.field) = {name:"Target" layout:LAYOUT_HORIZONTAL}];
+  }
+}
+
    TaskConf.json
    {
+    "taskMap": {
+        "1": {
+            "id": 1,
+            "targetList": [
+                {
+                    "type": "TYPE_PVP",
+                    "pvp": {
+                        "type": 1,
+                        "damage": "10",
+                        "types": [
+                            "FRUIT_TYPE_APPLE",
+                            "FRUIT_TYPE_ORANGE",
+                            "FRUIT_TYPE_BANANA"
+                        ]
+                    }
+                },
+                {
+                    "type": "TYPE_PVE",
+                    "pve": {
+                        "mission": {
+                            "id": 1,
+                            "level": 100,
+                            "damage": "999"
+                        },
+                        "heros": [
+                            1,
+                            2,
+                            3
+                        ],
+                        "dungeons": {
+                            "1": "10",
+                            "2": "20",
+                            "3": "30"
+                        }
+                    }
+                }
+            ]
+        },
+        "2": {
+            "id": 2,
+            "targetList": [
+                {
+                    "type": "TYPE_STORY",
+                    "story": {
+                        "cost": {
+                            "id": 1001,
+                            "num": 10
+                        },
+                        "fruits": {
+                            "1": "FRUIT_TYPE_APPLE",
+                            "2": "FRUIT_TYPE_ORANGE"
+                        },
+                        "flavors": {
+                            "1": {
+                                "key": "FRUIT_FLAVOR_FRAGRANT",
+                                "value": 1
+                            },
+                            "2": {
+                                "key": "FRUIT_FLAVOR_SOUR",
+                                "value": 2
+                            }
+                        }
+                    }
+                },
+                {
+                    "type": "TYPE_SKILL",
+                    "skill": {
+                        "id": 1,
+                        "damage": "2"
+                    }
+                }
+            ]
+        }
+    }
+}
+
    TaskConf.txt
    task_map: {
+  key: 1
+  value: {
+    id: 1
+    target_list: {
+      type: TYPE_PVP
+      pvp: {
+        type: 1
+        damage: 10
+        types: FRUIT_TYPE_APPLE
+        types: FRUIT_TYPE_ORANGE
+        types: FRUIT_TYPE_BANANA
+      }
+    }
+    target_list: {
+      type: TYPE_PVE
+      pve: {
+        mission: {
+          id: 1
+          level: 100
+          damage: 999
+        }
+        heros: 1
+        heros: 2
+        heros: 3
+        dungeons: {
+          key: 1
+          value: 10
+        }
+        dungeons: {
+          key: 2
+          value: 20
+        }
+        dungeons: {
+          key: 3
+          value: 30
+        }
+      }
+    }
+  }
+}
+task_map: {
+  key: 2
+  value: {
+    id: 2
+    target_list: {
+      type: TYPE_STORY
+      story: {
+        cost: {
+          id: 1001
+          num: 10
+        }
+        fruits: {
+          key: 1
+          value: FRUIT_TYPE_APPLE
+        }
+        fruits: {
+          key: 2
+          value: FRUIT_TYPE_ORANGE
+        }
+        flavors: {
+          key: 1
+          value: {
+            key: FRUIT_FLAVOR_FRAGRANT
+            value: 1
+          }
+        }
+        flavors: {
+          key: 2
+          value: {
+            key: FRUIT_FLAVOR_SOUR
+            value: 2
+          }
+        }
+      }
+    }
+    target_list: {
+      type: TYPE_SKILL
+      skill: {
+        id: 1
+        damage: 2
+      }
+    }
+  }
+}
+

    Predefined union in map

    Based on predefined union type Target.

    A worksheet TaskConf in HelloWorld.xlsx:

    IDTargetTypeTargetField1TargetField2TargetField3Progress
    map<int32, Task>{.Target}enum<.Target.Type>unionunionunionint32
    IDTarget’s typeTarget’s field1Target’s field2Target’s field3Progress
    1PVP110Apple,Orange,Banana3
    2PVE1,100,9991,2,31:10,2:20,3:3010
    3Story1001,101:Apple,2:OrangeFragrant:1,Sour:210
    4Skill128

    Generated:

    hello_world.proto
    // --snip--
 import "common.proto";
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
@@ -270,7 +444,7 @@
         progress:  8
     }
 }
-

    Predefined incell union in map

    Based on predefined union type Target.

    A worksheet TaskConf in HelloWorld.xlsx:

    IDTarget1Target2Progress
    map<int32, Task>{.Target}|{form:FORM_TEXT}{.Target}|{form:FORM_JSON}int32
    IDTarget1Target2Progress
    1type:TYPE_PVP pvp:{type:1 damage:10 types:FRUIT_TYPE_APPLE types:FRUIT_TYPE_ORANGE types:FRUIT_TYPE_BANANA}{“type”:“TYPE_PVP”,“pvp”:{“type”:1,“damage”:“10”,“types”:[“FRUIT_TYPE_APPLE”,“FRUIT_TYPE_ORANGE”,“FRUIT_TYPE_BANANA”]}}3
    2type:TYPE_PVE pve:{mission:{id:1 level:100 damage:999} heros:1 heros:2 heros:3 dungeons:{key:1 value:10} dungeons:{key:2 value:20} dungeons:{key:3 value:30}}{“type”:“TYPE_PVE”,“pve”:{“mission”:{“id”:1,“level”:100,“damage”:“999”},“heros”:[1,2,3],“dungeons”:{“1”:“10”,“2”:“20”,“3”:“30”}}}10
    3type:TYPE_STORY story:{cost:{id:1001 num:10} fruits:{key:1 value:FRUIT_TYPE_APPLE} fruits:{key:2 value:FRUIT_TYPE_ORANGE} flavors:{key:1 value:{key:FRUIT_FLAVOR_FRAGRANT value:1}} flavors:{key:2 value:{key:FRUIT_FLAVOR_SOUR value:2}}}{“type”:“TYPE_STORY”,“story”:{“cost”:{“id”:1001,“num”:10},“fruits”:{“1”:“FRUIT_TYPE_APPLE”,“2”:“FRUIT_TYPE_ORANGE”},“flavors”:{“1”:{“key”:“FRUIT_FLAVOR_FRAGRANT”,“value”:1},“2”:{“key”:“FRUIT_FLAVOR_SOUR”,“value”:2}}}}10
    4type:TYPE_SKILL skill:{id:1 damage:2}{“type”:“TYPE_SKILL”,“skill”:{“id”:1,“damage”:“2”}}8

    Generated:

    hello_world.proto
    // --snip--
+

    Predefined incell union in map

    Based on predefined union type Target.

    A worksheet TaskConf in HelloWorld.xlsx:

    IDTarget1Target2Progress
    map<int32, Task>{.Target}|{form:FORM_TEXT}{.Target}|{form:FORM_JSON}int32
    IDTarget1Target2Progress
    1type:TYPE_PVP pvp:{type:1 damage:10 types:FRUIT_TYPE_APPLE types:FRUIT_TYPE_ORANGE types:FRUIT_TYPE_BANANA}{“type”:“TYPE_PVP”,“pvp”:{“type”:1,“damage”:“10”,“types”:[“FRUIT_TYPE_APPLE”,“FRUIT_TYPE_ORANGE”,“FRUIT_TYPE_BANANA”]}}3
    2type:TYPE_PVE pve:{mission:{id:1 level:100 damage:999} heros:1 heros:2 heros:3 dungeons:{key:1 value:10} dungeons:{key:2 value:20} dungeons:{key:3 value:30}}{“type”:“TYPE_PVE”,“pve”:{“mission”:{“id”:1,“level”:100,“damage”:“999”},“heros”:[1,2,3],“dungeons”:{“1”:“10”,“2”:“20”,“3”:“30”}}}10
    3type:TYPE_STORY story:{cost:{id:1001 num:10} fruits:{key:1 value:FRUIT_TYPE_APPLE} fruits:{key:2 value:FRUIT_TYPE_ORANGE} flavors:{key:1 value:{key:FRUIT_FLAVOR_FRAGRANT value:1}} flavors:{key:2 value:{key:FRUIT_FLAVOR_SOUR value:2}}}{“type”:“TYPE_STORY”,“story”:{“cost”:{“id”:1001,“num”:10},“fruits”:{“1”:“FRUIT_TYPE_APPLE”,“2”:“FRUIT_TYPE_ORANGE”},“flavors”:{“1”:{“key”:“FRUIT_FLAVOR_FRAGRANT”,“value”:1},“2”:{“key”:“FRUIT_FLAVOR_SOUR”,“value”:2}}}}10
    4type:TYPE_SKILL skill:{id:1 damage:2}{“type”:“TYPE_SKILL”,“skill”:{“id”:1,“damage”:“2”}}8

    Generated:

    hello_world.proto
    // --snip--
 option (tableau.workbook) = {name:"HelloWorld.xlsx"};
 
 message TaskConf {
diff --git a/nl/en/docs/help/faq/index.html b/nl/en/docs/help/faq/index.html
index d2448dc9..c242dadf 100644
--- a/nl/en/docs/help/faq/index.html
+++ b/nl/en/docs/help/faq/index.html
@@ -1,4 +1,4 @@
-FAQ - Tableau

    Quick Start

    1. Download tableauc

    Select the appropriate tableauc (aka Tableau Compiler) to download:

    Windows

    DownloadWindows x64

    Linux

    DownloadLinux x64

    Apple

    DownloadmacOS x64

    DownloadmacOS arm64

    More platforms are available on tableau releases โ†’.

    2. Add a workbook

    Add HelloWorld.xlsx with two sheets:

    • Item: Copy data below to this worksheet.
    • @TABLEAU: Just leave it empty now. It is the tableau metasheet โ†’ for specifying parser options.
    IDNameDesc
    map<int32, Item>stringstring
    Itemโ€™s IDItemโ€™s nameItemโ€™s description
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.

    3. Run tableauc

    Run command: ./tableauc HelloWorld.xlsx

    Then hello_world.proto and Item.json are generated:

    hello_world.proto
    syntax = "proto3";
+Prologue

    Quick Start

    1. Download tableauc

    Select the appropriate tableauc (aka Tableau Compiler) to download:

    Windows

    DownloadWindows x64

    Linux

    DownloadLinux x64

    Apple

    DownloadmacOS x64

    DownloadmacOS arm64

    More platforms are available on tableau releases โ†’.

    2. Add a workbook

    Add HelloWorld.xlsx with two sheets:

    • Item: Copy data below to this worksheet.
    • @TABLEAU: Just leave it empty now. It is the tableau metasheet โ†’ for specifying parser options.
    IDNameDesc
    map<int32, Item>stringstring
    Itemโ€™s IDItemโ€™s nameItemโ€™s description
    1AppleA kind of delicious fruit.
    2OrangeA kind of sour fruit.
    3BananaA kind of calorie-rich fruit.

    3. Run tableauc

    Run command: ./tableauc HelloWorld.xlsx

    Then hello_world.proto and Item.json are generated:

    hello_world.proto
    syntax = "proto3";
 
 package protoconf;
 
diff --git a/nl/en/docs/prologue/sitemap.xml b/nl/en/docs/prologue/sitemap.xml
index d729e622..ee63db19 100644
--- a/nl/en/docs/prologue/sitemap.xml
+++ b/nl/en/docs/prologue/sitemap.xml
@@ -1 +1 @@
-https://tableauio.github.io/nl/en/docs/prologue/introduction/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/prologue/quick-start/2024-08-28T12:06:34+08:00weekly0.5
\ No newline at end of file
+https://tableauio.github.io/nl/en/docs/prologue/introduction/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/prologue/quick-start/2024-09-02T20:36:29+08:00weekly0.5
\ No newline at end of file
diff --git a/nl/en/docs/sitemap.xml b/nl/en/docs/sitemap.xml
index e9466c76..dbb2bedc 100644
--- a/nl/en/docs/sitemap.xml
+++ b/nl/en/docs/sitemap.xml
@@ -1 +1 @@
-https://tableauio.github.io/nl/en/docs/help/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/design/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/api/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/csv/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/tutorial/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/prologue/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/help/how-to-update/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/help/troubleshooting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/help/faq/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/design/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/design/metadata/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/api/tableau/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/api/loader/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/api/checker/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/csv/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/scalar/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/union/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-struct/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map-in-list/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map-in-map/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/infinite-nesting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/field-property/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/metasheet/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/concepts/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/naming-convention/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/grammar-and-types/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/enum/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/predefined-types/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/tutorial/overview/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/prologue/introduction/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/nl/en/docs/prologue/quick-start/2024-08-28T12:06:34+08:00weekly0.5
\ No newline at end of file
+https://tableauio.github.io/nl/en/docs/help/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/design/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/api/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/csv/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/tutorial/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/prologue/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/help/how-to-update/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/help/troubleshooting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/help/faq/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/design/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/design/metadata/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/api/tableau/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/api/loader/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/api/checker/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/yaml/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/xml/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/csv/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/scalar/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/union/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-struct/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/struct-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/list-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map-in-list/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/map-in-map/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/infinite-nesting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/field-property/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/excel/metasheet/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/concepts/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/naming-convention/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/grammar-and-types/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/enum/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/basics/predefined-types/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/tutorial/overview/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/prologue/introduction/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/nl/en/docs/prologue/quick-start/2024-09-02T20:36:29+08:00weekly0.5
\ No newline at end of file
diff --git a/nl/en/docs/tutorial/index.html b/nl/en/docs/tutorial/index.html
index 17bb49f7..35efb29b 100644
--- a/nl/en/docs/tutorial/index.html
+++ b/nl/en/docs/tutorial/index.html
@@ -1,4 +1,4 @@
-Tutorial - Tableau

    Map

    XML map guide.
    +Prologue

    Map

    XML map guide.
    \ No newline at end of file diff --git a/nl/en/docs/xml/index.xml b/nl/en/docs/xml/index.xml index 80baffc5..2456985f 100644 --- a/nl/en/docs/xml/index.xml +++ b/nl/en/docs/xml/index.xml @@ -3,9 +3,10 @@ hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.xml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; uint32 id = 1 [(tableau.field) = {name:&quot;ID&quot;}]; int32 num = 2 [(tableau.Enumhttps://tableauio.github.io/nl/en/docs/xml/enum/Fri, 23 Aug 2024 11:21:01 +0800https://tableauio.github.io/nl/en/docs/xml/enum/Enum # Enum type FruitType in common.proto is predefined as: enum FruitType { FRUIT_TYPE_UNKNOWN = 0 [(tableau.evalue).name = &quot;Unknown&quot;]; FRUIT_TYPE_APPLE = 1 [(tableau.evalue).name = &quot;Apple&quot;]; FRUIT_TYPE_ORANGE = 3 [(tableau.evalue).name = &quot;Orange&quot;]; FRUIT_TYPE_BANANA = 4 [(tableau.evalue).name = &quot;Banana&quot;]; } A worksheet ItemConf in HelloWorld.xml: &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;ID&gt;uint32&lt;/ID&gt; &lt;Type&gt;enum&lt;.FruitType&gt;&lt;/Type&gt; &lt;Desc&gt;string&lt;/Desc&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;ID&gt;1&lt;/ID&gt; &lt;Type&gt;FRUIT_TYPE_APPLE&lt;/Type&gt; &lt;Desc&gt;A kind of delicious fruit.&lt;/Desc&gt; &lt;/ItemConf&gt; Generated:Structhttps://tableauio.github.io/nl/en/docs/xml/struct/Tue, 13 Oct 2020 15:21:01 +0200https://tableauio.github.io/nl/en/docs/xml/struct/General struct # A worksheet ItemConf in HelloWorld.xml: -&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;Item ID=&quot;uint32&quot; StartTime=&quot;datetime&quot;&gt; &lt;Expiry&gt;duration&lt;/Expiry&gt; &lt;/Item&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;Item ID=&quot;1&quot; StartTime=&quot;2024-10-01 10:10:10&quot;&gt; &lt;Expiry&gt;1h&lt;/Expiry&gt; &lt;/Item&gt; &lt;/ItemConf&gt; Tips +&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;Item ID=&quot;uint32&quot; StartTime=&quot;datetime&quot;&gt; &lt;Expiry&gt;duration&lt;/Expiry&gt; &lt;/Item&gt; &lt;Item2 ID=&quot;{OtherItem}uint32&quot; Name=&quot;string&quot; /&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;Item ID=&quot;1&quot; StartTime=&quot;2024-10-01 10:10:10&quot;&gt; &lt;Expiry&gt;1h&lt;/Expiry&gt; &lt;/Item&gt; &lt;Item2 ID=&quot;1&quot; Name=&quot;gold&quot; /&gt; &lt;/ItemConf&gt; Tips Well-known type: datetime โ†’ Well-known type: duration โ†’ Generated: -hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.xml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; Item item = 1 [(tableau.field) = {name:&quot;Item&quot;}]; message Item { uint32 id = 1 [(tableau.Listhttps://tableauio.github.io/nl/en/docs/xml/list/Tue, 13 Oct 2020 15:21:01 +0200https://tableauio.github.io/nl/en/docs/xml/list/Scalar list # A worksheet ItemConf in HelloWorld.xml: +hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.xml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; Item item = 1 [(tableau.Unionhttps://tableauio.github.io/nl/en/docs/xml/union/Mon, 02 Sep 2024 19:21:01 +0800https://tableauio.github.io/nl/en/docs/xml/union/Union definition # For example, union type Target in common.proto is predefined as: +// Predefined union type. message Target { option (tableau.union) = true; Type type = 9999 [(tableau.field) = { name: &quot;Type&quot; }]; oneof value { option (tableau.oneof) = { field: &quot;Field&quot; }; Pvp pvp = 1; // Binded to enum value 1: TYPE_PVP. Pve pve = 2; // Binded to enum value 2: TYPE_PVP. Story story = 3; // Binded to enum value 3: TYPE_STORY.Listhttps://tableauio.github.io/nl/en/docs/xml/list/Tue, 13 Oct 2020 15:21:01 +0200https://tableauio.github.io/nl/en/docs/xml/list/Scalar list # A worksheet ItemConf in HelloWorld.xml: &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;Item&gt;[int32]&lt;/Item&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;Item&gt;1&lt;/Item&gt; &lt;Item&gt;2&lt;/Item&gt; &lt;Item&gt;3&lt;/Item&gt; &lt;/ItemConf&gt; Generated: hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.xml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; repeated int32 item_list = 1 [(tableau.field) = {name:&quot;Item&quot;}]; } ItemConf.json { &quot;itemList&quot;: [ 1, 2, 3 ] } Enum list # Enum type FruitType in common.Maphttps://tableauio.github.io/nl/en/docs/xml/map/Tue, 13 Oct 2020 15:21:01 +0200https://tableauio.github.io/nl/en/docs/xml/map/Incell scalar map # A worksheet ItemConf in HelloWorld.xml: &lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt; &lt;!-- &lt;@TABLEAU&gt; &lt;Item Sheet=&quot;ItemConf&quot; /&gt; &lt;/@TABLEAU&gt; &lt;ItemConf&gt; &lt;Item&gt;map&lt;uint32, string&gt;&lt;/Item&gt; &lt;/ItemConf&gt; --&gt; &lt;ItemConf&gt; &lt;Item&gt;1:dog,2:bird,3:cat&lt;/Item&gt; &lt;/ItemConf&gt; Generated: diff --git a/nl/en/docs/xml/list/index.html b/nl/en/docs/xml/list/index.html index 8bd5ddf8..3f289476 100644 --- a/nl/en/docs/xml/list/index.html +++ b/nl/en/docs/xml/list/index.html @@ -1,4 +1,4 @@ -List - Tableau
    +
    \ No newline at end of file diff --git a/nl/en/docs/xml/union/index.html b/nl/en/docs/xml/union/index.html new file mode 100644 index 00000000..cbeb53e3 --- /dev/null +++ b/nl/en/docs/xml/union/index.html @@ -0,0 +1,217 @@ +Union - Tableau

    Union

    Union definition

    For example, union type Target in common.proto is predefined as:

    // Predefined union type.
+message Target {
+  option (tableau.union) = true;
+
+  Type type = 9999 [(tableau.field) = { name: "Type" }];
+  oneof value {
+    option (tableau.oneof) = {
+      field: "Field"
+    };
+    Pvp pvp = 1;      // Binded to enum value 1: TYPE_PVP.
+    Pve pve = 2;      // Binded to enum value 2: TYPE_PVP.
+    Story story = 3;  // Binded to enum value 3: TYPE_STORY.
+    Skill skill = 4;  // Binded to enum value 4: TYPE_SKILL.
+  }
+
+  enum Type {
+    TYPE_NIL = 0;
+    TYPE_PVP = 1 [(tableau.evalue) = { name: "PVP" }];
+    TYPE_PVE = 2 [(tableau.evalue) = { name: "PVE" }];
+    TYPE_STORY = 3 [(tableau.evalue) = { name: "Story" }];
+    TYPE_SKILL = 4 [(tableau.evalue) = { name: "Skill" }];
+  }
+  message Pvp {
+    int32 type = 1;                          // scalar
+    int64 damage = 2;                        // scalar
+    repeated protoconf.FruitType types = 3;  // incell enum list
+  }
+  message Pve {
+    Mission mission = 1;             // incell struct
+    repeated int32 heros = 2;        // incell list
+    map<int32, int64> dungeons = 3;  // incell map
+
+    message Mission {
+      int32 id = 1;
+      uint32 level = 2;
+      int64 damage = 3;
+    }
+  }
+  message Story {
+    protoconf.Item cost = 1;                     // incell predefined struct
+    map<int32, protoconf.FruitType> fruits = 2;  // incell map with value as enum type
+    map<int32, Flavor> flavors = 3;              // incell map with key as enum type
+    message Flavor {
+      protoconf.FruitFlavor key = 1 [(tableau.field) = { name: "Key" }];
+      int32 value = 2 [(tableau.field) = { name: "Value" }];
+    }
+  }
+  message Skill {
+    int32 id = 1;      // scalar
+    int64 damage = 2;  // scalar
+    // no field tag 3
+  }
+}
+

    Predefined union

    A worksheet ItemConf in HelloWorld.xml:

    <?xml version="1.0" encoding="UTF-8"?>
+<!--
+<@TABLEAU>
+    <Item Sheet="ItemConf" />
+</@TABLEAU>
+
+<ItemConf>
+    <Target @type="{.Target}" />
+</ItemConf>
+-->
+
+<ItemConf>
+    <Target Type="PVP" Field1="1" Field2="10" Field3="Apple,Orange,Banana"/>
+</ItemConf>
+

    Generated:

    hello_world.proto
    // --snip--
+option (tableau.workbook) = {name:"HelloWorld.xml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  protoconf.Target target = 1 [(tableau.field) = {name:"Target"}];
+}
+
    ItemConf.json
    {
+    "target": {
+        "type": "TYPE_PVP",
+        "pvp": {
+            "type": 1,
+            "damage": "10",
+            "types": [
+                "FRUIT_TYPE_APPLE",
+                "FRUIT_TYPE_ORANGE",
+                "FRUIT_TYPE_BANANA"
+            ]
+        }
+    }
+}
+

    Predefined incell union

    A worksheet ItemConf in HelloWorld.xml:

    <?xml version="1.0" encoding="UTF-8"?>
+<!--
+<@TABLEAU>
+    <Item Sheet="ItemConf" />
+</@TABLEAU>
+
+<ItemConf>
+    <Target>{.Target}|{form:FORM_TEXT}</Target>
+</ItemConf>
+-->
+
+<ItemConf>
+    <Target>type:TYPE_PVE pve:{mission:{id:1 level:100 damage:999} heros:1 heros:2 heros:3 dungeons:{key:1 value:10} dungeons:{key:2 value:20} dungeons:{key:3 value:30}}</Target>
+</ItemConf>
+

    Generated:

    hello_world.proto
    // --snip--
+option (tableau.workbook) = {name:"HelloWorld.xml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  protoconf.Target target = 1 [(tableau.field) = {name:"Target" span:SPAN_INNER_CELL prop:{form:FORM_TEXT}}];
+}
+
    ItemConf.json
    {
+    "target": {
+        "type": "TYPE_PVE",
+        "pve": {
+            "mission": {
+                "id": 1,
+                "level": 100,
+                "damage": "999"
+            },
+            "heros": [
+                1,
+                2,
+                3
+            ],
+            "dungeons": {
+                "1": "10",
+                "2": "20",
+                "3": "30"
+            }
+        }
+    }
+}
+

    Predefined union list

    A worksheet ItemConf in HelloWorld.xml:

    <?xml version="1.0" encoding="UTF-8"?>
+<!--
+<@TABLEAU>
+    <Item Sheet="ItemConf" />
+</@TABLEAU>
+
+<ItemConf>
+    <Target @type="[.Target]" />
+</ItemConf>
+-->
+
+<ItemConf>
+    <Target Type="Story" Field1="1001,10" Field2="1:Apple,2:Orange" Field3="Fragrant:1,Sour:2"/>
+    <Target Type="Skill" Field1="1" Field2="2"/>
+</ItemConf>
+

    Generated:

    hello_world.proto
    // --snip--
+import "common.proto";
+option (tableau.workbook) = {name:"HelloWorld.xml"};
+
+message ItemConf {
+  option (tableau.worksheet) = {name:"ItemConf"};
+
+  repeated protoconf.Target target_list = 1 [(tableau.field) = {name:"Target"}];
+}
+
    ItemConf.json
    {
+    "targetList": [
+        {
+            "type": "TYPE_STORY",
+            "story": {
+                "cost": {
+                    "id": 1001,
+                    "num": 10
+                },
+                "fruits": {
+                    "1": "FRUIT_TYPE_APPLE",
+                    "2": "FRUIT_TYPE_ORANGE"
+                },
+                "flavors": {
+                    "1": {
+                        "key": "FRUIT_FLAVOR_FRAGRANT",
+                        "value": 1
+                    },
+                    "2": {
+                        "key": "FRUIT_FLAVOR_SOUR",
+                        "value": 2
+                    }
+                }
+            }
+        },
+        {
+            "type": "TYPE_SKILL",
+            "skill": {
+                "id": 1,
+                "damage": "2"
+            }
+        }
+    ]
+}
+
    + + + \ No newline at end of file diff --git a/nl/en/docs/yaml/enum/index.html b/nl/en/docs/yaml/enum/index.html index faf8939c..7349cd18 100644 --- a/nl/en/docs/yaml/enum/index.html +++ b/nl/en/docs/yaml/enum/index.html @@ -1,4 +1,4 @@ -Enum - Tableau

    Enum

    YAML enum guide.

    List

    YAML list guide.

    Map

    YAML map guide.
    +Prologue

    Enum

    YAML enum guide.

    List

    YAML list guide.

    Map

    YAML map guide.
    \ No newline at end of file diff --git a/nl/en/docs/yaml/index.xml b/nl/en/docs/yaml/index.xml index 14b5dbf1..954816f1 100644 --- a/nl/en/docs/yaml/index.xml +++ b/nl/en/docs/yaml/index.xml @@ -5,7 +5,8 @@ enum FruitType { FRUIT_TYPE_UNKNOWN = 0 [(tableau.evalue).name = &quot;Unkno # define metasheet: generate all sheets &quot;@sheet&quot;: &quot;@TABLEAU&quot; --- # define schema &quot;@sheet&quot;: &quot;@ItemConf&quot; ID: uint32 Type: &quot;enum&lt;.FruitType&gt;&quot; Desc: string --- &quot;@sheet&quot;: ItemConf ID: 1 Type: FRUIT_TYPE_APPLE Desc: A kind of delicious fruit.Structhttps://tableauio.github.io/nl/en/docs/yaml/struct/Sat, 22 Jun 2024 10:00:00 +0800https://tableauio.github.io/nl/en/docs/yaml/struct/General struct # A worksheet ItemConf in HelloWorld.yaml: # define metasheet: generate all sheets &quot;@sheet&quot;: &quot;@TABLEAU&quot; --- # define schema &quot;@sheet&quot;: &quot;@ItemConf&quot; Item: &quot;@type&quot;: &quot;{Item}&quot; ID: uint32 StartTime: datetime Expiry: duration --- &quot;@sheet&quot;: ItemConf Item: ID: 1 StartTime: 2024-10-01 10:10:10 Expiry: 1h Tips Well-known type: datetime โ†’ Well-known type: duration โ†’ Generated: -hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.yaml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; Item item = 1 [(tableau.Listhttps://tableauio.github.io/nl/en/docs/yaml/list/Sat, 22 Jun 2024 10:00:00 +0800https://tableauio.github.io/nl/en/docs/yaml/list/Scalar list # A worksheet ItemConf in HelloWorld.yaml: +hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.yaml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; Item item = 1 [(tableau.Unionhttps://tableauio.github.io/nl/en/docs/yaml/union/Mon, 02 Sep 2024 19:21:01 +0800https://tableauio.github.io/nl/en/docs/yaml/union/Union definition # For example, union type Target in common.proto is predefined as: +// Predefined union type. message Target { option (tableau.union) = true; Type type = 9999 [(tableau.field) = { name: &quot;Type&quot; }]; oneof value { option (tableau.oneof) = { field: &quot;Field&quot; }; Pvp pvp = 1; // Binded to enum value 1: TYPE_PVP. Pve pve = 2; // Binded to enum value 2: TYPE_PVP. Story story = 3; // Binded to enum value 3: TYPE_STORY.Listhttps://tableauio.github.io/nl/en/docs/yaml/list/Sat, 22 Jun 2024 10:00:00 +0800https://tableauio.github.io/nl/en/docs/yaml/list/Scalar list # A worksheet ItemConf in HelloWorld.yaml: # define metasheet: generate all sheets &quot;@sheet&quot;: &quot;@TABLEAU&quot; --- # define schema &quot;@sheet&quot;: &quot;@ItemConf&quot; Items: &quot;[int32]&quot; --- &quot;@sheet&quot;: ItemConf Items: [1, 2, 3] Generated: hello_world.proto // --snip-- option (tableau.workbook) = {name:&quot;HelloWorld.yaml&quot;}; message ItemConf { option (tableau.worksheet) = {name:&quot;ItemConf&quot;}; repeated int32 items = 1 [(tableau.field) = {name:&quot;Items&quot;}]; } ItemConf.json { &quot;items&quot;: [ 1, 2, 3 ] } Enum list # Enum type FruitType in common.Maphttps://tableauio.github.io/nl/en/docs/yaml/map/Sat, 22 Jun 2024 10:00:00 +0800https://tableauio.github.io/nl/en/docs/yaml/map/Scalar map # A worksheet ItemConf in HelloWorld.yaml: # define metasheet: generate all sheets &quot;@sheet&quot;: &quot;@TABLEAU&quot; --- # define schema &quot;@sheet&quot;: &quot;@ItemConf&quot; Items: &quot;map&lt;uint32, string&gt;&quot; --- &quot;@sheet&quot;: ItemConf Items: 1: dog 2: bird 3: cat Generated: diff --git a/nl/en/docs/yaml/list/index.html b/nl/en/docs/yaml/list/index.html index 8a59a4f2..7ff6c98c 100644 --- a/nl/en/docs/yaml/list/index.html +++ b/nl/en/docs/yaml/list/index.html @@ -1,4 +1,4 @@ -List - Tableau

    ๅธธ่ง้—ฎ้ข˜

    Answers to frequently asked questions.

    Question 1 ?

    TODO …

    Last modified on August 28, 2024
    Edit this page on GitHub
    ← ็–‘้šพ่งฃ็ญ”
    +ๅธฎๅŠฉ

    ๅธธ่ง้—ฎ้ข˜

    Answers to frequently asked questions.

    Question 1 ?

    TODO …

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← ็–‘้šพ่งฃ็ญ”
    - \ No newline at end of file + \ No newline at end of file diff --git a/zh/docs/help/how-to-update/index.html b/zh/docs/help/how-to-update/index.html index 4ecca8a3..3f947ad0 100644 --- a/zh/docs/help/how-to-update/index.html +++ b/zh/docs/help/how-to-update/index.html @@ -1,4 +1,4 @@ -ๅฆ‚ไฝ•ๆ›ดๆ–ฐ - Tableau

    ๅฆ‚ไฝ•ๆ›ดๆ–ฐ

    Regularly update the installed toolchain to keep your tableau stable, usable, and secure.

    tableauc

    TODO …

    Last modified on August 28, 2024
    Edit this page on GitHub
    ← ็ฎ€ไป‹
    ็–‘้šพ่งฃ็ญ” →
    +ๅธฎๅŠฉ

    ๅฆ‚ไฝ•ๆ›ดๆ–ฐ

    Regularly update the installed toolchain to keep your tableau stable, usable, and secure.

    tableauc

    TODO …

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← ็ฎ€ไป‹
    ็–‘้šพ่งฃ็ญ” →
    - \ No newline at end of file + \ No newline at end of file diff --git a/zh/docs/help/index.html b/zh/docs/help/index.html index 7c7b4e3d..7be24068 100644 --- a/zh/docs/help/index.html +++ b/zh/docs/help/index.html @@ -1,4 +1,4 @@ -ๅธฎๅŠฉ - Tableau

    ็–‘้šพ่งฃ็ญ”

    Solutions to common problems.

    Problems updating tableauc config

    TODO …

    Problems with loader

    TODO …

    Last modified on August 28, 2024
    Edit this page on GitHub
    ← ๅฆ‚ไฝ•ๆ›ดๆ–ฐ
    ๅธธ่ง้—ฎ้ข˜ →
    +ๅธฎๅŠฉ

    ็–‘้šพ่งฃ็ญ”

    Solutions to common problems.

    Problems updating tableauc config

    TODO …

    Problems with loader

    TODO …

    Last modified on September 2, 2024
    Edit this page on GitHub
    ← ๅฆ‚ไฝ•ๆ›ดๆ–ฐ
    ๅธธ่ง้—ฎ้ข˜ →
    - \ No newline at end of file + \ No newline at end of file diff --git a/zh/docs/index.html b/zh/docs/index.html index 91e7a528..ace5b930 100644 --- a/zh/docs/index.html +++ b/zh/docs/index.html @@ -1,4 +1,4 @@ -Docs - Tableau     +
    Last modified on September 2, 2024
    Edit this page on GitHub
    ← ๅฟซ้€Ÿๅผ€ๅง‹
    ๅฆ‚ไฝ•ๆ›ดๆ–ฐ →
    - \ No newline at end of file + \ No newline at end of file diff --git a/zh/docs/prologue/quick-start/index.html b/zh/docs/prologue/quick-start/index.html index fb2e62e4..1231a696 100644 --- a/zh/docs/prologue/quick-start/index.html +++ b/zh/docs/prologue/quick-start/index.html @@ -1,4 +1,4 @@ -ๅฟซ้€Ÿๅผ€ๅง‹ - Tableau +

    Then *.pb.go files will be generated to examples/helloworld/protoconf, and JSON files will be generated to examples/helloworld/excel2conf/_out.

    Congratulations! Youโ€™ve just run a modern configuration converter application with Tableau.

    Last modified on September 2, 2024
    Edit this page on GitHub
    ็ฎ€ไป‹ →
    - \ No newline at end of file + \ No newline at end of file diff --git a/zh/docs/prologue/sitemap.xml b/zh/docs/prologue/sitemap.xml index 2996e360..2b476ffe 100644 --- a/zh/docs/prologue/sitemap.xml +++ b/zh/docs/prologue/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/zh/docs/prologue/quick-start/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/zh/docs/prologue/introduction/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/zh/docs/prologue/quick-start/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/zh/docs/prologue/introduction/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/zh/docs/sitemap.xml b/zh/docs/sitemap.xml index 58914522..5acfecff 100644 --- a/zh/docs/sitemap.xml +++ b/zh/docs/sitemap.xml @@ -1 +1 @@ -https://tableauio.github.io/zh/docs/help/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/zh/docs/prologue/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/zh/docs/help/how-to-update/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/zh/docs/help/troubleshooting/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/zh/docs/help/faq/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/zh/docs/prologue/quick-start/2024-08-28T12:06:34+08:00weekly0.5https://tableauio.github.io/zh/docs/prologue/introduction/2024-08-28T12:06:34+08:00weekly0.5 \ No newline at end of file +https://tableauio.github.io/zh/docs/help/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/zh/docs/prologue/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/zh/docs/help/how-to-update/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/zh/docs/help/troubleshooting/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/zh/docs/help/faq/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/zh/docs/prologue/quick-start/2024-09-02T20:36:29+08:00weekly0.5https://tableauio.github.io/zh/docs/prologue/introduction/2024-09-02T20:36:29+08:00weekly0.5 \ No newline at end of file diff --git a/zh/index.html b/zh/index.html index 44b574fd..4acc1bd3 100644 --- a/zh/index.html +++ b/zh/index.html @@ -1,4 +1,4 @@ -Tableau - Modern Configuration Converter