update doc

Author: ogios

data/doc/3.basic_config.md

@@ -59,69 +59,18 @@ _Example:_
 
 ## Widget item
 
-```json
-{
-  "widgets": {
-    "type": "array",
-    "items": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string"
-        },
-        "edge": {
-          "type": "string",
-          "enum": ["top", "bottom", "left", "right"]
-        },
-        "position": {
-          "type": "string",
-          "enum": ["", "top", "bottom", "left", "right", "center"]
-        },
-        "layer": {
-          "type": "string",
-          "enum": ["top", "bottom", "background", "overlay"]
-        },
-        "margins": {
-          "type": "object",
-          "properties": {
-            "top": {
-              "$ref": "#/definitions/numOrPercentage"
-            },
-            "bottom": {
-              "$ref": "#/definitions/numOrPercentage"
-            },
-            "left": {
-              "$ref": "#/definitions/numOrPercentage"
-            },
-            "right": {
-              "$ref": "#/definitions/numOrPercentage"
-            }
-          }
-        },
-        "monitor": {
-          "type": ["integer", "string"],
-          "default": 0
-        },
-        "widget": {
-          "$ref": "#/definitions/AllWidgets"
-        }
-      }
-    }
-  }
-}
-```
-
 Array of widget items. If multiple widgets pile up, the last one in array gets to be on the top.
 
-| Name     | Description                                                             |
-| -------- | ----------------------------------------------------------------------- |
-| name     | Name of the widget, needed with `togglepin`                             |
-| edge     | Edge of the screen, `top/bottom/left/right`                             |
-| position | Ancher of the edge, `top/bottom \|\| left/right`                        |
-| layer    | Layer of the shell (window), `top/bottom/background/overlay`            |
-| margins  | Support relative number ("24%"), `top/bottom/left/right`                |
-| monitor  | Monitor index, or the connector name of the monitor, index start from 0 |
-| widget   | the actual widget, goto `widgets`                                       |
+| Name            | Description                                                             |
+| --------------- | ----------------------------------------------------------------------- |
+| name            | Name of the widget, needed with `togglepin`                             |
+| edge            | Edge of the screen, `top/bottom/left/right`                             |
+| position        | Ancher of the edge, `top/bottom \|\| left/right`                        |
+| layer           | Layer of the shell (window), `top/bottom/background/overlay`            |
+| margins         | Support relative number ("24%"), `top/bottom/left/right`                |
+| monitor         | Monitor index, or the connector name of the monitor, index start from 0 |
+| ignore_exlusive | whether to overlap with other layershell.                               |
+| widget          | the actual widget, goto `widgets`                                       |
 
 _Example:_
 

data/doc/4.widgets/0.button.md

@@ -14,8 +14,8 @@ _Example:_
   "layer": "overlay",
   "widget": {
     "type": "btn",
-    "width": 15,
-    "height": "25%",
+    "thickness": 15,
+    "length": "25%",
     "frame_rate": 90,
     "transition_duration": 150,
     "extra_trigger_size": 5,
@@ -35,15 +35,15 @@ _`*` means required property_.
 const `btn`
 ```
 
-## `width*`
+## `thickness*`
 
 **\*Thickness\*** of the button, from screen edge to the screen center.
 
 Support relative value, **_but don't recommend using relative value for this property_**.
 
 _Type: `int | string`_
 
-## `height*`
+## `length*`
 
 Length of the button.
 

data/doc/4.widgets/1.slide.md

@@ -11,8 +11,8 @@ _Example:_
   "edge": "top",
   "widget": {
     "type": "slide",
-    "width": 20,
-    "height": 400,
+    "thickness": 20,
+    "length": 400,
     "transition_duration": 100,
     "frame_rate": 120,
     "bg_color": "#0D47A1",
@@ -30,17 +30,17 @@ _Example:_
 const `slide`
 ```
 
-## `width*`
+## `thickness*`
 
-**\*Thickness\*** of the button, from screen edge to the screen center.
+**\*Thickness\*** of the widget, from screen edge to the screen center.
 
 Support relative value, **_but don't recommend using relative value for this property_**.
 
 _Type: `int | string`_
 
-## `height*`
+## `length*`
 
-Length of the button.
+Length of the widget.
 
 Support relative value.
 

data/doc/4.widgets/5.box/0.ring.md

@@ -68,9 +68,44 @@ _Default: `5`_
 
 Text on the left side of the ring.
 
+Currently supported template:
+
+- `{float:precision,multiply}`
+  - precision: `round()` of a float number, Default `2`
+  - multiply: the float number will be multiplied by this number, this happens before `precision`. Default 1.
+- `{preset}`, preset content if ur using any `preset`, which means it will be an empty string if u use `custom`.
+
 _Type: `null | string`_  
 _Default: `null`_
 
+## `prefix_hide`
+
+Show only when mouse hover.
+
+_Type: `bool`_  
+_Default: `false`_
+
+## `suffix`
+
+Text on the right side of the ring.
+
+Currently supported template:
+
+- `{float:precision,multiply}`
+  - precision: `round()` of a float number, Default `2`
+  - multiply: the float number will be multiplied by this number, this happens before `precision`. Default 1.
+- `{preset}`, preset content if ur using any `preset`, which means it will be an empty string if u use `custom`.
+
+_Type: `null | string`_  
+_Default: `null`_
+
+## `suffix_hide`
+
+Show only when mouse hover.
+
+_Type: `bool`_  
+_Default: `false`_
+
 ## `font_family`
 
 Font family of all text within ring widget.

data/doc/4.widgets/6.hyprland-workspace.md

@@ -18,15 +18,15 @@
 const `hyprland-workspace`
 ```
 
-## `thickness`
+## `thickness*`
 
 Equivalent to the old `width`, thickness of the hyprland workspace bar.  
 Support relative values(string "xx%").
 
 _Type: `int | string`_  
 _Default: `10`_
 
-## `length`
+## `length*`
 
 Equivalent to the old `height`, length of the hyprland workspace bar.  
 Support relative values(string "xx%").