8.6 KiB
Themes in Terminology
This document describes how Terminology interacts with themes and what needs to be handled by themes.
See ChangeLog.theme
on changes related to themes.
Color classes
Based on the chosen color scheme, Terminology sets the following color classes on all the following edje groups:
BG
: the background color of the terminalFG
: the default foreground colorCURSOR
: the color of the cursorGLOW
: the color in the UI to ouline elementsHIGHLIGHT
: the color used as main color when an element is highlightedGLOW_TXT
: text colors with some glowGLOW_TXT_HIGHLIGHT
: text with glow that is highlightedEND_SELECTION
: on selections, the color of the handles used to expand or shrink the area of the selectionTAB_MISSED
: the number of tabs where a bell has rung, tabs that need attentionTAB_MISSED_OVER
: same but when the mouse is over that numberTAB_TITLE
: the colors of the active tab titleBG_SENDFILE
is the background color when there is a sendfile action. Seeman tysend
. It is set to#404040
.
The following table explains how color classes are set from color scheme values:
Color Class | Object color | Outline color | Shadow color |
---|---|---|---|
BG |
Colors.bg |
Colors.bg |
Colors.bg |
FG |
Normal.def |
Normal.def |
Normal.def |
CURSOR |
Colors.main |
Colors.main |
Colors.main |
GLOW |
Colors.main |
Colors.main |
Colors.main |
GLOW_TXT_HIGHLIGHT |
Colors.hl |
Colors.main |
Colors.main |
END_SELECTION |
Colors.end_sel |
Colors.end_sel |
Colors.end_sel |
TAB_MISSED |
Colors.tab_missed_1 |
Colors.tab_missed_2 |
Colors.tab_missed_3 |
TAB_MISSED_OVER |
Colors.tab_missed_1 |
Colors.tab_missed_2 |
Colors.tab_missed_3 |
TAB_TITLE |
Normal.def |
Colors.tab_title_2 |
Colors.bg |
BG_SENDFILE |
#404040 |
#404040 |
#404040 |
Let's dive into the edje groups that Terminology uses.
Group terminology/base
All windows contain a group terminology/base
.
Contains what is global to a window.
Swallowed parts
Part terminology.content
where terminology/background
, or a split widget can be swallowed.
Part terminology.cmdbox
To swallow a command box. It reacts to the following signals:
cmdbox,show
cmdbox,hide
Part terminology.about
It reacts to the following signals:
about,show
about,hide
Part terminology.optdetails
Detailed settings panel. It reacts to the following signals:
optdetails,show
optdetails,hide
It emits the following signal:optdetails,hide,done
Part terminology.options
It reacts to the following signals:
options,show
options,hide
Part terminology.controls
The controls box shown on right click. It reacts to the following signals:
controls,show
controls,hide
Special parts
Part youtube.txt
A text part used to hold YouTube channel
when the About is shown.
Part twitter.txt
A text part used to hold YouTube channel
when the About is shown.
Signals emitted
Signal about,twitter
When the Twitter link on the About page is clicked.
Signal about,twitter,ctx
When the Twitter link on the About page is right-clicked.
Signal about,youtube
When the YouTube link on the About page is clicked.
Signal about,youtube,ctx
When the YouTube link on the About page is right-clicked.
Signal optdetails,hide,done
When the swallowed part terminology.optdetails
is finally hidden.
Signals received
Signals about,show
and about,hide
Used to hide or show the about page, swallowed in terminology.about
.
Signals controls,show
and controls,hide
Used to hide or show the controls, swallowed in terminology.controls
.
Signals options,show
and options,hide
Used to hide or show the options panel, swallowed in terminology.options
.
Signals optdetails,show
and optdetails,hide
Used to hide or show the options details settings panel, swallowed in terminology.optdetails
.
Signals cmdbox,show
and cmdbox,hide
Used to hide or show the command box, swallowed in terminology.cmdbox
.
Group terminology/background
Swallowed parts
Parts terminology.content
Here is swallowed an object of group terminology.background
.
Special parts
Parts tabdrag
and tabmiddle
Their geometry are used to adjust drag values.
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.
Signals received
Signals tabbar,off
and tabbar,on
Whether to display a tab bar. Default is off.
Signals tab_btn,off
and tab_btn,on
Whether to display a tab button to easily navigate through tabs. Default is off.
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.
Signals drag_left,off
, drag_right,off
, drag_top,off
, drag_bottom,off
When to stop an animation started by the related *,on
signals.
Signals drag_over_tabs,on
and drag_over_tabs,off
When the mouse, while dragging a tab, enters or leaves the tab region.
Signals grouped,on
and grouped,off
When input is broadcast to multiple terminals.
Signal emitted
Signal tab,hdrag
To notify that the current tab is being dragged.
Signal tab,drag,stop
To notify that the current tab is no longer being dragged.
Signal tab,drag,move
To notify that the current tab is being dragged outside of other tabs.
Group terminology/core
Swallowed parts
Part terminology.background
Actual background. It reacts to the following signals based on the media to play in background:
media,off
media,image
media,scale
media,edje
media,movie
Part terminology.tabregion
Here is swalloed a fully transparent rectangle to move down the textgrid.
Part terminology.content
Where actual text grid goes.
Signals received
Signals tabbar,off
and tabbar,on
Whether to display a tab bar. Default is off.
Signals tab_btn,off
and tab_btn,on
Whether to display a tab button to easily navigate through tabs. Default is off.
Signals hdrag,on
and hdrag,off
Whether to restrict (default) horizontal tab drag
Signal emitted
Signals tab,drag
and tab,drag,stop
To notify that the current tab is being dragged.
Signals tab,mouse,down
Whenever the left mouse button is pressed on a tab.
Group terminology/about
Text parts
Part terminology.text
The text of the About message.
Group terminology.tabbar_back
An inactive tab item
Text parts
Part terminology.title
Title of the tab.
Signal emitted
Signal tab,activate
When clicked on it, to notify that the user wants to go to that tab.
Signals received
Signal bell
To mark the tab as having missed a bell.
Signal bell,off
To unmark the tab as having missed a bell.
Signals grouped,on
and grouped,off
When input is broadcast to multiple terminals.
Group terminology/keybinding
TODO
Group terminology/miniview
TODO
Group terminology/fontpreview
TODO
Group terminology/selection
An object used when selecting text. TODO
Group terminology/cursor
TODO
Group terminology/cursor_bar
TODO
Group terminology/cursor_underline
TODO
Group terminology/sel/base
TODO
Group terminology/sel/item
TODO
Group terminology/link
An object overlayd on text that is a link.
Group terminology/mediabusy
TODO
Group terminology/mediactrl
TODO
Group terminology/tab_drag_thumb
A thumbnail of a tab being dragged.
Swallowed part
Part terminology.content
Here is swallowed an object of group terminology.background
.
Text part
Part terminology.title
Title of the tab.
Signal received
Signal bell
To mark the tab as having missed a bell.
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
.
Text part
Part name
Name of the color being previewed