@windypro-rourou/dsh-eda 0.1.0 → 0.1.2

package/skill/format/pcb/text.md

@@ -0,0 +1,62 @@
+# Text System
+
+## STRING Text
+
+When `STRING` is on a signal layer, from the DRC perspective it is:
+
+1. Net-less.
+2. A BBox with `position` at 0,0, `rotation angle` 0, and `whether mirrored` 0.
+3. A rectangular area after applying `position`, `rotation angle`, and `whether mirrored` transformations.
+
+```json
+{ "type": "STRING", "id":"UUID", "ticket": 1 }||
+{
+  "partitionId":null,
+  "groupId":0,
+  "locked":1,
+  "zIndex":0.2693,
+  "layerId":1,
+  "positionX":300,
+  "positionY":600,
+  "text":"any text",
+  "fontFamily":"SimSun",
+  "fontSize":50,
+  "strokeWidth":10,
+  "bold":0,
+  "italic":0,
+  "origin":5,
+  "angle":15,
+  "reverse":1,
+  "reverseExpansion":0,
+  "mirror":1,
+  "width":100,
+  "height":200,
+  "path":["complex polygon"],
+}|
+["STRING", "e100", 0, 1, 0.2693, 1, 300, 600, "any text", "SimSun", 50, 10, 0, 0, 5, 15, 1, 0, 1]
+```
+
+1. type text `STRING`.
+2. id primitive ID, unique within the document.
+3. ticket logical clock.
+4. partitionId partition ID it belongs to, null means no partition. Ignored for footprints.
+5. groupId group ID: 0 no group, non-zero is the group flag, same flag means same group.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. layerId layer.
+9. positionX position X.
+10. positionY position Y.
+11. text content.
+12. fontFamily font name.
+13. fontSize font size.
+14. strokeWidth stroke width.
+15. bold whether bold.
+16. italic whether italic.
+17. origin alignment mode: `0` top-left, `1` top-center, `2` top-right, `3` middle-left, `4` middle-center, `5` middle-right, `6` bottom-left, `7` bottom-center, `8` bottom-right.
+18. angle rotation angle.
+19. reverse whether reverse expansion.
+20. expansion reverse expansion size: size of the reverse expansion area, supports negative numbers.
+21. mirror whether mirrored. Generally, when text appears on the bottom layer, this should also be adjusted to `1`.
+22. width height, `null` if none.
+23. height width, `null` if none.
+24. path complex polygon array, `null` if none.

package/skill/format/project/blob.md

@@ -0,0 +1,30 @@
+# BLOB True-Color Image
+
+```json
+{ "type": "META", "id": "BLOB-HASH-ID",  "ticket": 1 }||{ "filename": "dadas", "data": "data:image/png;base64,asdfasdfwer" }|
+```
+
+1. filename file name.
+2. data reserved metadata; binary data uses a specification similar to `Data URLs`, but with differences.
+
+    1. General format, fully compatible with `Data URLs`: `data:[<mediatype>][;base64],<data>`
+
+        - e.g. `data:image/png;base64,asdfasdfwer`
+        - e.g. `data:text/html,<html></html>`
+        - In general, this format should be used whenever possible, so it can be loaded directly with Web APIs without algorithm conversion.
+
+    2. Extended format, extending functionality by adding encodings such as gzip/deflate: `data:<mediatype>[pipeline],<data>`
+
+    - e.g. `data:text/html;gzip;base64,asdfasdf`
+        1. First base64-decode `asdfasdf`.
+        2. Then decompress with gzip.
+        3. Finally load as `text/html`.
+    - e.g. `data:text/css;deflate;aes128;base64,aaaaaaa`
+        1. First base64-decode `aaaaaaa`.
+        2. Then decrypt with aes128 (specific encryption/decryption logic to be determined).
+        3. Then decompress with deflate.
+        4. Finally load as `text/css`.
+
+```json
+{ "type": "META", "id": "ID",  "ticket": 1 }||{ "filename": "dadas", "data": "data:application/vnd.ms-excel;base64,xxsasdfawerwerqwer" }|
+```

package/skill/format/project/common.md

@@ -0,0 +1,42 @@
+# Common Data
+
+Each document carries basic information, creation information, and modification information, which are maintained by the project manager.
+
+### Basic Information
+
+```json
+{ "type": "META", "ticket": 1 }||data
+```
+
+1. type "META" basic information.
+2. data specific data, different for each document.
+
+### Creation Information
+
+Same for every document.
+
+```json
+{ "type": "META_CREATE", "ticket": 1 }||
+{
+    "creator": { "uuid":"UUID", "nickname":"nickname", "username":"username", },
+    "createTime": 1725593026474,
+}|
+```
+
+1. type "META_CREATE" creation information.
+2. creator creator.
+3. createTime creation time.
+
+### Modification Information
+
+```json
+{ "type": "META_MODIFY", "ticket": 1 }||
+{
+    "modifier": { "uuid":"UUID", "nickname":"nickname", "username":"username", },
+    "createTime": 1725593026474,
+}|
+```
+
+1. type "META_MODIFY" modification information.
+2. modifier modifier.
+3. updateTime update time.

package/skill/format/project/group.md

@@ -0,0 +1,62 @@
+# Component Grouping
+
+## Document Header
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "COMPONENT_GROUP", "uuid": "UUID", "client": "clientID" }|
+```
+
+1. type: `DOCHEAD`, document header identifier.
+2. docType: `COMPONENT_GROUP` component grouping.
+3. uuid: unique identifier, random id.
+4. client: terminal identifier for eventual consistency.
+
+### META Basic Information
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+	/** Name */
+	"title": string,
+	/** Parent component group uuid of the child component group */
+	"parent": string,
+	/** Component groups belonging directly to a variant do not participate in the component group tree */
+	"belong": string,
+	/** Sort order in the component group tree */
+	"zIndex": number,
+	/** Schematic */
+	"schematicId": string,
+}|
+```
+
+### GROUP_INDEX Sorting of Component Groups in Variants
+
+```json
+{ "type": "GROUP_INDEX", "ticket": 1, "id": "variantId" }||
+{
+	"zIndex": 1,
+}|
+```
+
+1. type: `GROUP_INDEX`
+2. ticket: logical clock.
+3. id: variant uuid.
+4. zIndex: sort order within the variant.
+
+### GROUP_DATA Attribute Data
+
+```json
+{ "type": "GROUP_DATA", "id": "e176@uuid",  "ticket": 1 }||data
+```
+
+1. type `GROUP_DATA` attribute data.
+2. id combined id, separated by `@`:
+    1. The first is the primitive ID.
+    2. The second is the instance page ID.
+3. data attribute override, data signature is `{ [key: string]: string }| `
+
+```json
+{ "type": "GROUP_DATA", "id": "e176@uuid1",  "ticket": 1 }||{ "Designator": "U15", "ASDF": "1234" }|
+{ "type": "GROUP_DATA", "id": "e177@uuid1",  "ticket": 2 }||{ "NUMBER": 2 }|
+{ "type": "GROUP_DATA", "id": "e176@uuid2",  "ticket": 3 }||{ "Author": "abc" }|
+```

package/skill/format/project/index.md

@@ -0,0 +1,12 @@
+# Project Log Format
+
+This document only describes data that belongs to the project but not to the canvas. For specific canvas data, please refer to the separate documents.
+
+## Contents
+
+- [Common Data](/en/format/project/common.md) - Includes basic information, creation information, modification information, etc.
+- [Basic Information](/en/format/project/meta.md) - Includes metadata for project config, board, schematic, PCB, panel, symbol, footprint, device, etc.
+- [BLOB True-Color Image](/en/format/project/blob.md) - True-color image data format.
+- [Instance Attribute Override](/en/format/project/instance.md) - Instance attribute override format.
+- [Variant](/en/format/project/variant.md) - Variant data format.
+- [Component Grouping](/en/format/project/group.md) - Component grouping data format.

package/skill/format/project/instance.md

@@ -0,0 +1,32 @@
+# Instance Attribute Override
+
+## Document Header
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "INSTANCE", "uuid": "SCH-UNIQUE-ID_$5|e100_$1|e55_$6|e15_$8", "client": "clientID" }|
+```
+
+1. type: `DOCHEAD`, document header identifier.
+2. docType: `INSTANCE` instance attribute override.
+3. uuid: hierarchical ID, unique within the project, IDs separated by `_`.
+    1. The first is the top-level schematic ID.
+    2. The last goes only to the sheet ID.
+    3. All in between use the numbering combination syntax to locate `Block Symbol`, e.g. `$1|e2`, where `$1` is the sheet ID and `e2` is the `Block Symbol` ID.
+4. client: terminal identifier for eventual consistency.
+
+## Attribute Override
+
+```json
+{ "type": "INSTANCE_ATTR", "id": "e176",  "ticket": 1 }||data
+```
+
+1. type `INSTANCE_ATTR` instance attribute override.
+2. id primitive ID.
+3. data attribute override, data signature is `{ [parentId: string]: { [key: string]: string }| }|`
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "INSTANCE", "uuid": "SCH-UNIQUE-ID_$5|e100_$1|e55_$6|e15_$8", "client": "clientID" }|
+{ "type": "INSTANCE_ATTR", "id": "e176",  "ticket": 1 }||{ "Designator": "U15", "ASDF": "1234" }|
+{ "type": "INSTANCE_ATTR", "id": "e176e5",  "ticket": 1 }||{ "NUMBER": 2 }|
+{ "type": "INSTANCE_ATTR", "id": "e178",  "ticket": 1 }||{ "Author": "abc" }|
+```

package/skill/format/project/meta.md

@@ -0,0 +1,189 @@
+# Basic Information
+
+### Project Config
+
+Stores project configuration data, previously kept in the backend project details.
+
+```json
+{ "type": "META", "ticket": 1 }||{ "name": "name", "default_sheet": "default_sheet_uuid"}|
+```
+
+1. name project name.
+2. default_sheet default sheet of the project.
+
+### Board
+
+```json
+{ "type": "META", "ticket": 1 }||{ "title": "title", "sort": 1}|
+```
+
+1. title board name.
+2. sort sort weight.
+
+### Schematic
+
+```json
+{ "type": "META", "ticket": 1 }||{ "name": "name", "board":"", "source": "", "version": ""}|
+```
+
+1. name name.
+2. board uuid of the board it belongs to, empty if none.
+3. source source document uuid.
+4. version version, update time of the source document.
+
+### Schematic Page
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+    "name": "Page Name",
+    "schematic": "SID",
+    "description": "description",
+    "sort": 0.5,
+    "source": "",
+    "version": "",
+}|
+```
+
+1. name name.
+2. schematic uuid of the schematic it belongs to.
+3. description description.
+4. sort sort weight.
+5. source source document uuid.
+6. version version, update time of the source document.
+
+### PCB
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+    "name": "PCB Name",
+    "board": "boardId",
+    "description": "description",
+    "parentId":"",
+    "sort": 0.5,
+    "source": "",
+    "version": "",
+}|
+```
+
+1. name name.
+2. board uuid of the board it belongs to, empty if none.
+3. description description.
+4. parentId parent PCB UUID, empty if none.
+5. sort sort weight.
+6. source source document uuid.
+7. version version, update time of the source document.
+
+Child PCB
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+    "name": "Child PCB Name",
+    "board": "",
+    "description": "description",
+    "parentId":"UUID",
+    "sort": 0.2,
+    "source": "",
+    "version": "",
+}|
+```
+
+### Panel
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+    "name": "Panel Name",
+    "description": "description",
+    "sort": 0.5,
+}|
+```
+
+1. name name.
+2. description description.
+3. sort sort weight.
+
+### Symbol
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+    "name": "Name",
+    "description": "description",
+    "type": 2,
+    "tags": "tag1",
+    "source": "",
+    "version": "",
+}|
+```
+
+1. name name.
+2. description description.
+3. type symbol type.
+4. tags classification tags.
+5. source source document uuid.
+6. version version, update time of the source document.
+
+### Footprint
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+    "name": "Name",
+    "description": "description",
+    "type": 4,
+    "tags": "tag1",
+    "source": "",
+    "version": "",
+    "pcb": "",
+}|
+```
+
+1. name name.
+2. description description.
+3. type footprint type.
+4. tags classification tags.
+5. source source document uuid.
+6. version version, update time of the source document.
+7. pcb uuid of the pcb it belongs to, empty by default. Only special footprints have this field.
+
+Special Footprint
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+    "name": "Name",
+    "description": "description",
+    "type": 4,
+    "tags": "tag1",
+    "source": "",
+    "version": "",
+    "pcb": "pcbUuid",
+}|
+```
+
+### Device
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+    "name": "Name",
+    "description": "description",
+    "type": 4,
+    "tags": "tag1",
+    "source": "",
+    "version": "",
+    "attributes": {},
+    "images": "",
+}|
+```
+
+1. name name.
+2. description description.
+3. tags classification tags.
+4. source source document uuid.
+5. version version, update time of the source document.
+6. attributes device attributes Key-Value.
+7. images image links.

package/skill/format/project/variant.md

@@ -0,0 +1,30 @@
+# Variant
+
+## Document Header
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "VARIANT", "uuid": "UUID", "client": "clientID" }|
+```
+
+1. type: `DOCHEAD`, document header identifier.
+2. docType: `VARIANT` variant data.
+3. uuid: unique identifier, random id.
+4. client: terminal identifier for eventual consistency.
+
+## META Basic Information
+
+```json
+{ "type": "META", "ticket": 1 }||
+{
+	/** Name */
+	"title": string,
+	/** Description */
+	"description": string,
+	/** Schematic */
+	"schematicId": string,
+	/** Sort order */
+	"zIndex": number,
+	/** Whether there are ungrouped items */
+	"notGrouped": boolean,
+}|
+```

package/skill/format/schematic/attr.md

@@ -0,0 +1,41 @@
+# ATTR Attribute
+
+ATTR is a relatively generic primitive that means:
+
+1. It expresses one of multiple attributes composed of a KEY-VALUE pair.
+2. It can be displayed on the canvas and controls what content is displayed, as well as style and position.
+
+When the affiliation ID is not specified, it defaults to the current block-level primitive.
+
+```json
+{ "type": "ATTR", "id": "UUID", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": false, "zIndex": 0.1, "parentId": "UUID", "key":"string", "value":"string", "keyVisible":false, "valueVisible":false, "positionX":200, "positionY":200, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+1. type attribute name: ATTR.
+2. id unique ID.
+3. ticket logical clock.
+4. partId sub-library ID, exclusive to symbol pages; ignored on schematics.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. locked whether locked.
+7. zIndex Z-axis height.
+8. parentId affiliation ID: the primitive it belongs to, `""` means it belongs to the current block. _Default block is the file._
+9. key attribute Key.
+10. value attribute Value.
+11. keyVisible whether to display Key.
+12. valueVisible whether to display Value.
+13. positionX position X: fixed to `null` for attributes that have never been displayed.
+14. positionY position Y: fixed to `null` for attributes that have never been displayed.
+15. rotation rotation angle, rotated around `position`.
+16. color color.
+17. fillColor background color.
+18. fontFamily font name.
+19. fontSize font size, same unit as coordinates.
+20. strikeout whether to strike out.
+21. underline whether to underline.
+22. italic whether italic.
+23. fontWeight whether bold.
+24. vAlign vertical alignment: 0 top, 1 middle, 2 bottom.
+25. hAlign horizontal alignment: 0 left, 1 center, 2 right.
+
+When the attribute Value contains the `~` character, XTools needs to implement overline text from the start to the end: text is overlined starting at odd-numbered `~` and ending at even-numbered `~`.

package/skill/format/schematic/common.md

@@ -0,0 +1,47 @@
+# Common Format
+
+This chapter details the format specification of the EasyEDA schematic file. Schematic files mainly consist of the following parts:
+
+- **Common Configuration**: Document header and canvas configuration.
+- **Structural Elements**: PART sub-libraries and GROUP combinations.
+- **Attributes**: Primitive attribute definitions.
+- **Wires**: Wires, buses, and bus entries.
+- **Text**: Text elements.
+- **Shapes**: Rectangles, polygons, circles, arcs, Bezier curves, ellipses.
+- **Pins**: Pin definitions.
+- **Components**: Schematic component instances.
+- **Objects**: Binary objects (images, etc.).
+- **Tables**: Tables and cells.
+
+
+## Document Header
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "SCH_PAGE", "uuid": "UUID", "client": "clientID" }|
+```
+
+```json
+{ "type": "DOCHEAD" }||{ "docType": "SYMBOL", "uuid": "UUID", "client": "clientID" }|
+```
+
+-   type: "DOCHEAD", document header identifier.
+-   docType: document type, "SCH_PAGE": schematic, "SYMBOL": symbol.
+-   uuid: document unique ID, unique within the project.
+-   client: terminal identifier for eventual consistency.
+
+## Canvas Configuration
+
+Editor additional information, used for data analysis and other functions. Currently occupied fields:
+
+```json
+{ "type": "CANVAS", "ticket": 1 }||
+{
+  "originX":0,
+  "originY":0,
+}|
+```
+
+1. type: "CANVAS", canvas configuration identifier.
+2. ticket logical clock.
+3. originX canvas origin X.
+4. originY canvas origin Y.

package/skill/format/schematic/component.md

@@ -0,0 +1,91 @@
+# COMPONENT
+
+-   `COMPONENT` references a Symbol. Since a Symbol supports multiple Parts, it carries a `sub-library ID` to indicate which one; for a single-Part device, the default value `""` is used.
+-   A `COMPONENT` can bind many `ATTR`s; specific attribute behavior is defined by the tool.
+
+### Symbol Types
+
+| Symbol Type ID | Symbol Type     | Description                                                                                                                                                                                                                   |
+| :-------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 2               | Part Symbol     | Common device.                                                                                                                                                                                                               |
+| 17              | Block Symbol    | Hierarchical symbol.                                                                                                                                                                                                         |
+| 18              | NetFlag Symbol  | Global net symbol.                                                                                                                                                                                                         |
+| 19              | NetPort Symbol  | Hierarchical net export symbol.                                                                                                                                                                                              |
+| 20              | Sheet Symbol    | Provides a reuse mechanism for schematic sheets.                                                                                                                                                                             |
+| 21              | NoneElec Symbol | Non-electrical symbol. NoneElec is a class of non-electrical primitives without `PIN`.<br>Can also be used as a reuse mechanism for special icons, copyright statements, etc.<br>NoneElec stands for None Electrical. |
+| 22              | Short Symbol    | Short Symbol is a special Symbol that must have two `PIN`s.<br>All nets connected to the `PIN`s of the same `Short Symbol` are electrically shorted.<br>For example, if net A is connected to PIN1 and net B to PIN2, A and B are the same net. |
+
+### Component Primitive
+
+```json
+{ "type": "COMPONENT", "id": "UUID", "ticket": 1 }||
+{
+    "partId": "e176",
+    "groupId": 0,
+    "positionX": 300,
+    "positionY": 200,
+    "rotation": 15,
+    "isMirror": false,
+    "data": {},
+}|
+```
+
+1. type COMPONENT identifier: COMPONENT.
+2. id ID, unique within the file.
+3. ticket logical clock.
+4. partId sub-library ID.
+5. groupId group ID, cannot be 0, empty by default when none.
+6. zIndex Z-axis height: all non-attribute child elements are distributed within Z0 ~ Z9, e.g. Z of 23.554 means child elements are auto-distributed within 23.5540 ~ 23.5549.
+7. positionX position X.
+8. positionY position Y.
+9. rotation rotation angle, around `position`.
+10. isMirror whether mirrored.
+11. data pure data attributes: additional information for internal editor logic.
+
+The Symbol referenced by a Component is transformed in the following order:
+
+1. Rotate counter-clockwise around the origin (0,0) by the `rotation angle`.
+2. If `isMirror` is `1`, mirror horizontally around the Y-axis at the origin (0,0).
+3. Translate by `position`.
+
+Or equivalently (but more cumbersome to implement):
+
+1. Translate by `position`.
+2. Rotate counter-clockwise around `position` by the `rotation angle`.
+3. If `isMirror` is `1`, mirror horizontally around the Y-axis at `position`.
+
+```json
+{ "type": "ATTR", "id": "e187", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e176", "key":"Device", "value":"device-uuid-1", "keyVisible":true, "valueVisible":true, "positionX":300, "positionY":200, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+Device uuid, consistent with the file name corresponding to the device in project.json.
+
+```json
+{ "type": "ATTR", "id": "e188", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e176", "key":"Symbol", "value":"symbol-uuid-1", "keyVisible":true, "valueVisible":true, "positionX":300, "positionY":200, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+An `ATTR` inside `COMPONENT` with the same name as one in the template will override it. Overriding Symbol affects the binding between the device and the symbol.
+
+```json
+{ "type": "ATTR", "id": "e188", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e176", "key":"Footprint", "value":"footprint-uuid-1", "keyVisible":true, "valueVisible":true, "positionX":300, "positionY":200, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+An `ATTR` inside `COMPONENT` with the same name as one in the template will override it. Overriding Footprint affects the binding between the device and the footprint.
+
+```json
+{ "type": "ATTR", "id": "e188", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e176", "key":"Designator", "value":"U1", "keyVisible":true, "valueVisible":true, "positionX":300, "positionY":200, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+An `ATTR` inside `COMPONENT` with the same name as one in the template will override it.
+
+```json
+{ "type": "ATTR", "id": "e180", "ticket": 1 }||
+{ "partId": "", "groupId": 0, "locked": true, "zIndex": 0.1, "parentId": "e176e5", "key":"NUMBER", "value":"1", "keyVisible":true, "valueVisible":true, "positionX":108, "positionY":804.5, "rotation":0, "color":null, "fillColor":null, "fontFamily":null, "fontSize":null, "strikeout":null, "underline":null, "italic":null, "fontWeight":null, "vAlign":0, "hAlign":2,}|
+```
+
+The key to `PIN` attribute override lies in the `parentId` of `ATTR`.
+The ID has two parts, e.g. `e176e5`, where `e176` is the `COMPONENT` ID and `e5` is the `PIN` ID in the template.

package/skill/format/schematic/index.md

@@ -0,0 +1,14 @@
+# SCH Schematic Type Document
+
+This chapter details the format specification of the EasyEDA schematic file. Schematic files mainly consist of the following parts:
+
+- [Common Format](/en/format/schematic/common.md): document header and canvas configuration.
+- [Structural Elements](/en/format/schematic/structure.md): PART sub-library and GROUP combination.
+- [Attributes](/en/format/schematic/attr.md): primitive attribute definitions.
+- [Wires](/en/format/schematic/wire.md): wires, buses, and bus entries.
+- [Text](/en/format/schematic/text.md): text elements.
+- [Shapes](/en/format/schematic/shape.md): rectangles, polygons, circles, arcs, Bezier curves, ellipses.
+- [Pins](/en/format/schematic/pin.md): pin definitions.
+- [Components](/en/format/schematic/component.md): schematic component instances.
+- [Objects](/en/format/schematic/obj.md): binary objects (images, etc.).
+- [Tables](/en/format/schematic/table.md): tables and cells.