THEMES: improve documentation

This commit is contained in:
Boris Faure 2020-11-28 17:08:07 +01:00
parent 84905e62e9
commit 665a3acbcf
Signed by untrusted user who does not match committer: borisfaure
GPG Key ID: 35C0410516166BE8
1 changed files with 83 additions and 79 deletions

162
THEMES.md
View File

@ -46,28 +46,27 @@ values:
Let's dive into the edje groups that Terminology uses.
# `terminology/base`
Windows contain group `terminology/base`.
# Group `terminology/base`
All windows contain a group `terminology/base`.
Contains what is global to a window.
## Swallowed parts
### `terminology.content`
### Part `terminology.content`
where `terminology/background`, or a split widget can be swallowed.
### `terminology.cmdbox`
### Part `terminology.cmdbox`
To swallow a command box.
It reacts to the following signals:
* `cmdbox,show`
* `cmdbox,hide`
### `terminology.about`
### Part `terminology.about`
It reacts to the following signals:
* `about,show`
* `about,hide`
### `terminology.optdetails`
### Part `terminology.optdetails`
Detailed settings panel.
It reacts to the following signals:
* `optdetails,show`
@ -75,12 +74,12 @@ It reacts to the following signals:
It emits the following signal:
* `optdetails,hide,done`
### `terminology.options`
### Part `terminology.options`
It reacts to the following signals:
* `options,show`
* `options,hide`
### `terminology.controls`
### Part `terminology.controls`
The controls box shown on right click.
It reacts to the following signals:
* `controls,show`
@ -88,101 +87,96 @@ It reacts to the following signals:
## Special parts
### `youtube.txt`
### Part `youtube.txt`
A text part used to hold `Youtube channel` when the About is shown.
### `twitter.txt`
### Part `twitter.txt`
A text part used to hold `Youtube channel` when the About is shown.
## Signals emitted
### `about,twitter`
### Signal `about,twitter`
When the Twitter link on the About page is clicked.
### `about,twitter,ctx`
### Signal `about,twitter,ctx`
When the Twitter link on the About page is right-clicked.
### `about,youtube`
### Signal `about,youtube`
When the Youtube link on the About page is clicked.
### `about,youtube,ctx`
### Signal `about,youtube,ctx`
When the Youtube link on the About page is right-clicked.
### `optdetails,hide,done`
### Signal `optdetails,hide,done`
When the swallowed part `terminology.optdetails` is finally hidden.
## Signals received
### `about,show` and `about,hide`
### Signals `about,show` and `about,hide`
Used to hide or show the about page, swallowed in `terminology.about`.
### `controls,show` and `controls,hide`
### Signals `controls,show` and `controls,hide`
Used to hide or show the controls, swallowed in `terminology.controls`.
### `options,show` and `options,hide`
### Signals `options,show` and `options,hide`
Used to hide or show the options panel, swallowed in `terminology.options`.
### `optdetails,show` and `optdetails,hide`
### Signals `optdetails,show` and `optdetails,hide`
Used to hide or show the options details settings panel, swallowed in `terminology.optdetails`.
### `cmdbox,show` and `cmdbox,hide`
### Signals `cmdbox,show` and `cmdbox,hide`
Used to hide or show the command box, swallowed in `terminology.cmdbox`.
# `terminology/background`
# Group `terminology/background`
## Swallowed parts
### `terminology.content`
### Parts `terminology.content`
Here is swallowed an object of group `terminology.background`.
### TODO
## Special parts
### `tabdrag` and `tabmiddle`
### Parts `tabdrag` and `tabmiddle`
Their geometry are used to adjust drag values.
### `drag_left_outline`, `drag_right_outline`, `drag_top_outline`, `drag_bottom_outline` and `terminology.tabregion`
### Parts `drag_left_outline`, `drag_right_outline`, `drag_top_outline`, `drag_bottom_outline` and `terminology.tabregion`
Their geometry are used to know when the cursor enters them when dragging a
tab.
## Signal received
### `tabbar,off` and `tabbar,on`
## Signals received
### Signals `tabbar,off` and `tabbar,on`
Whether to display a tab bar. Default is off.
### `tab_btn,off` and `tab_btn,on`
### Signals `tab_btn,off` and `tab_btn,on`
Whether to display a tab button to easily navigate through tabs. Default is off.
### `drag_left,on`, `drag_right,on`, `drag_top,on`, `drag_bottom,on`
### Signals `drag_left,on`, `drag_right,on`, `drag_top,on`, `drag_bottom,on`
When to start an animation when the cursor enters `drag_XXXX_outline` while
dragging a tab.
### `drag_left,off`, `drag_right,off`, `drag_top,off`, `drag_bottom,off`
### Signals `drag_left,off`, `drag_right,off`, `drag_top,off`, `drag_bottom,off`
When to stop an animation started by the related `*,on` signals.
### `drag_over_tabs,on` and `drag_over_tabs,off`
### Signals `drag_over_tabs,on` and `drag_over_tabs,off`
When the mouse, while dragging a tab, enters or leaves the tab region.
### `grouped,on` and `grouped,off`
### Signals `grouped,on` and `grouped,off`
When input is broadcast to multiple terminals.
### TODO
## Signal emitted
### `tab,hdrag`
### Signal `tab,hdrag`
To notify that the current tab is being dragged.
### `tab,drag,stop`
### Signal `tab,drag,stop`
To notify that the current tab is no longer being dragged.
### `tab,drag,move`
### Signal `tab,drag,move`
To notify that the current tab is being dragged outside of other tabs.
### TODO
# `terminology/core`
# Group `terminology/core`
## Swallowed parts
### `terminology.background`
### Part `terminology.background`
Actual background.
It reacts to the following signals based on the media to play in background:
@ -192,136 +186,146 @@ It reacts to the following signals based on the media to play in background:
* `media,edje`
* `media,movie`
### `terminology.tabregion`
### Part `terminology.tabregion`
Here is swalloed a fully transparent rectangle to move down the textgrid.
### `terminology.content`
### Part `terminology.content`
Where actual text grid goes.
## Signal received
### `tabbar,off` and `tabbar,on`
## Signals received
### Signals `tabbar,off` and `tabbar,on`
Whether to display a tab bar. Default is off.
### `tab_btn,off` and `tab_btn,on`
### Signals `tab_btn,off` and `tab_btn,on`
Whether to display a tab button to easily navigate through tabs. Default is off.
### `hdrag,on` and `hdrag,off`
### Signals `hdrag,on` and `hdrag,off`
Whether to restrict (default) horizontal tab drag
## Signal emitted
### `tab,drag` and `tab,drag,stop`
### Signals `tab,drag` and `tab,drag,stop`
To notify that the current tab is being dragged.
### `tab,mouse,down`
### Signals `tab,mouse,down`
Whenever the left mouse button is pressed on a tab.
# `terminology/about`
# Group `terminology/about`
## Text parts
### `terminology.text`
### Part `terminology.text`
The text of the __About__ message.
# `terminology.tabbar_back`
# Group `terminology.tabbar_back`
An inactive tab item
## Text parts
### `terminology.title`
### Part `terminology.title`
Title of the tab.
## Signal emitted
### `tab,activate`
### Signal `tab,activate`
When clicked on it, to notify that the user wants to go to that tab.
## Signal received
### `bell`
## Signals received
### Signal `bell`
To mark the tab as having missed a bell.
### `bell,off`
### Signal `bell,off`
To unmark the tab as having missed a bell.
### `grouped,on` and `grouped,off`
### Signals `grouped,on` and `grouped,off`
When input is broadcast to multiple terminals.
# `terminology/keybinding`
# Group `terminology/keybinding`
__TODO__
# `terminology/miniview`
# Group `terminology/miniview`
__TODO__
# `terminology/fontpreview`
# Group `terminology/fontpreview`
__TODO__
# `terminology/selection`
# Group `terminology/selection`
An object used when selecting text.
__TODO__
# `terminology/cursor`
# Group `terminology/cursor`
__TODO__
# `terminology/cursor_bar`
# Group `terminology/cursor_bar`
__TODO__
# `terminology/cursor_underline`
# Group `terminology/cursor_underline`
__TODO__
# `terminology/sel/base`
# Group `terminology/sel/base`
__TODO__
# `terminology/sel/item`
# Group `terminology/sel/item`
__TODO__
# `terminology/link`
# Group `terminology/link`
An object overlayd on text that is a link.
# `terminology/mediabusy`
# Group `terminology/mediabusy`
__TODO__
# `terminology/mediactrl`
# Group `terminology/mediactrl`
__TODO__
# `terminology/tab_drag_thumb`
# Group `terminology/tab_drag_thumb`
A thumbnail of a tab being dragged.
## Swallowed parts
### `terminology.content`
## Swallowed part
### Part `terminology.content`
Here is swallowed an object of group `terminology.background`.
### `terminology.title`
## Text part
### Part `terminology.title`
Title of the tab.
## Signal received
### `bell`
### Signal `bell`
To mark the tab as having missed a bell.
# `terminology/color_preview`
# Group `terminology/colorscheme_preview`
A group to preview a colorscheme. Used in the Colors panel in the settings.
## Swallowed part
### Part `terminology.content`
Where a textgrid showing off a color scheme is displayed.
# Group `terminology/color_preview`
A group to preview a color in a tooltip. The color is defined by the color
class `color_preview`.
## Swallowed part
### `name`
## Text part
### Part `name`
Name of the color being previewed