-
-
Notifications
You must be signed in to change notification settings - Fork 34
/
Copy pathEPKL_Settings_Default.ini
189 lines (157 loc) · 14 KB
/
EPKL_Settings_Default.ini
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
;
;; ================================================================================================================================================
;; Program Settings Default file
;; for EPiKaL Portable Keyboard Layout (EPKL) by Øystein "DreymaR" Bech-Aase (2015-), based on PKL by Máté Farkas (2008-2010).
;; For more info, see the README files and the Big Bag Of Keyboard Tricks: https://dreymar.colemak.org – select Windows.
;
;; - For Layout choice and settings, use the EPKL_Layouts .ini file(s). For program settings, use EPKL_Settings.
;; - For each of these, there is a Default file and optionally an Override file, the settings in which take precedence.
;; - For Extend layer mappings (navigation/editing etc), see the _eD_Extend.ini file. Set the modifier key in any active LayStack file.
;; - In the Files folder there are Compose, DeadKeys, Extend, PwrStrings and Remap special files with different types of entries.
;; ================================================================================================================================================
;
;; The EPKL Settings GUI:
;; - You can set many of the settings below with a handy EPKL Settings window from the EPKL Layout/Settings menu.
;; - Any changes you submit from that window will be written to your Override file, thus taking precedence.
;; - If you wish, you can then edit the entries manually in the Override file. You may also Reset them with a button.
;; - The Settings GUI can also change the active layout, special keys (Extend and Compose) and individual key mappings.
;
;; EPKL Settings syntax:
;; - You can use yes/y/true/1 and no/n/false/0 as entry values for all Boolean (yes/no) choices.
;; - To disable hotkeys or other settings in your Override file without touching the Default, you can set them to --.
;; - Otherwise, simply comment their line(s) out with a semicolon in the Default file to disable them.
;
;; EPKL Settings Default file info:
;; - Any settings in an EPKL_Settings_Override.ini file will override the corresponding Default settings in this file.
;
;; ================================================================================================================================================
;; EPKL Interface settings:
;; ================================================================================================================================================
;
[pkl]
;; Hotkeys. Set to `--` to deactivate. For syntax rules, see http://www.autohotkey.com/docs/Hotkeys.htm#Symbols
helpImageHotkey = ^+1 ; Ctrl+Shift+1 = Toggle the help image on/off
changeLayHotkey = ^+2 ; Ctrl+Shift+2 = Activate the next layout in the Layouts menu
suspendMeHotkey = ^+3,^+SC029 ; Ctrl+Shift+3 = Suspend/re-enable EPKL. (^+` because sometimes ^+3 didn't work)
exitMeNowHotkey = ^+4 ; Ctrl+Shift+4 = Quit EPKL
refreshMeHotkey = ^+5 ; Ctrl+Shift+5 = Rerun EPKL
settingUIHotkey = ^+6 ; Ctrl+Shift+6 = Show/hide the Layout/Settings... User Interface
runTargetHotkey = ^+7 ; Ctrl+Shift+7 = Open EPKL's home folder, or bring focus to it if already open
zoomImageHotkey = ^+8 ; Ctrl+Shift+8 = Zoom help image in/out. See below for zoom settings.
opaqImageHotkey = ^+9 ; Ctrl+Shift+9 = Toggle help image opacity. See below for its setting.
procStatsHotkey = ^+0 ; Ctrl+Shift+0 = Show the title, process (.exe) and class of the active window
;epklDebugHotkey = ^+SC00D ; Ctrl+Shift+= = EPKL/AHK debug and code test utilities - use at your own risk ;-)
;moveImageHotkey = ^+9 ; Ctrl+Shift+9 = Move help image as if mousing over its left part
;doSuspendHotkey = ^+9 ; Ctrl+Shift+9 = Suspend EPKL ON . Useful for some users, replacing some other key.
;unSuspendHotkey = ^+0 ; Ctrl+Shift+0 = Suspend EPKL OFF. --"--
;; Help image settings.
showHelpImage = yes ; yes/no - Display the layout help image on startup
img_HideStates = none ; --,0,1,6,7,ext,dk# - Hide these help image shift states. Shift+=1, AltGr+=6.
;; Help image transparency. 0 is invisible, 255 opaque. < 0 for transparent background color (WIP).
img_Opacity = 192 ; 0-255 - 0 is invisible, 255 opaque.
;; Help image positions. The image jumps between these positions on mouse-over, and when the moveImageHotkey is used.
img_Positions = TL,TM,TR,BL,BM,BR ; TB+LMR - Allowed help image positions. Top/Bottom, Left/Middle/Right.
img_StartPos = BM ; TB+LMR - Help image start position. --"--
;; The help images have individual size/scaling set in Layout.ini. With the zoom hotkey you can change the global scale.
img_Zooms = 50,100 ; % - Start at the first value, cycle with the Zoom Image hotkey.
;; Left, right, top and bottom margins for help images. A bottom margin of 40 is right above the menu bar.
;; To show the help image on a second monitor, set margins < 0. I used (R,T) = (-1918,-118) for the upper right corner.
img_Mrg_LRTB = 2,2,42,40 ; px - Left, Right, Top, Bottom image margins. Can be <0 for second monitor.
;; Help image horizontal push zone, in percent. If you mouse over this the image jumps right/left.
img_HorZone = 25 ; % - Left/right part of image where mouse-over pushes it horizontally.
;; Menu/dialog language: A file name in the Languages folder (without .ini).
;; - If it is 'auto', language definitions are loaded from the system's default locale
;; - See http://www.autohotkey.com/docs/misc/Languages.htm
menuLanguage = auto ; auto, or a Files\Languages file - Menu/dialog language
;; Advanced Mode adds some items to menus and the About... dialog.
advancedMode = yes ; yes/no - Show extra info/options
;; The default double-click menu item. The entry must match (part of) a menu item text, or you can use #& for position #.
;; NOTE: AdvancedMode affects the number of menu entries. Hotkey full names may change depending on the settings.
;trayMenuDefault = 2& ; pos& - The nth menu item
trayMenuDefault = Suspend ; text - Partial text matches are allowed
;; Target run by the 'Open app/folder' hotkey and menu. By default, brings up EPKL's home folder in File Explorer.
openMenuTarget = . ; app/dir - target for 'Open...' HK/menu
;; ================================================================================================================================================
;; Other EPKL settings:
;; ================================================================================================================================================
;
;; Modifiers that are "Sticky" or "One-Shot" can be tapped then shortly thereafter type the key to be modded.
stickyMods = LShift,RShift ; - Sticky alias One-Shot mods (Note: RCtrl may interfere with AltGr)
stickyTime = 600 ; ms - Sticky/One-Shot modifier tap time
;; Tap-or-Modifier keys have a VK/ModName layout entry. To tap, release the key within the specified time if set > 0 ms.
tapModTime = 200 ; ms - Tap-or-Mod/Dual-Role-Modifier tap time
;; Extend modifiers let you select Multi-Extend layers: Ext+Mod1 -> Ext2; Ext+Mod2 -> Ext3; Ext+Mod1+Mod2 -> Ext4.
extendMods = RAlt,RShift ; - Mod1,Mod2
;; Which Compose keys are used as CoDeKeys? That is, Compose+DeadKey, as explained elsewhere.
CoDeKeys = CDK ;,Def ; ### - These Compose keys (without the ©) are also advanced CoDeKeys
;; If your OS layout has dead keys, put them here. If, say, '^' is a dead key you must hit '^' then Space to type it.
;; "--" or "none" will ignore this. If you write "auto", EPKL will look for the correct mode in the EPKL_Tables file.
systemDeadKeys = auto ; ¨´^`~ etc., --, auto (use tables) - The dead keys of your OS layout
;; The "janitor" inactivity timer can clean up stuck modifiers. It also suspends EPKL by timer or active app, see below.
cleanupTimeOut = 4 ; s - Idle time in sec. before janitor cleanup functions are performed
;; If you often forget to exit EPKL at a shared computer, you can set suspend/exit timeouts in minutes.
;; After this time without keypresses, EPKL will suspend itself and/or shut down.
suspendTimeOut = 0 ; min - Idle time before EPKL is suspended by cleanup. 0 disables it.
exitAppTimeOut = 0 ; min - Idle time before EPKL is shut down by cleanup. 0 disables it.
;; The apps below will suspend EPKL while they're active. Use AHK window info as shown by the ProcStats hotkey.
;; Window class is quite robust. Title will change with docs open etc., and .exe will match all apps with that name.
;; Be aware that window titles may use the em dash (Colemak-eD AltGr+i) and it matters to title matching.
;; Shorthand: Use 'C' for ahk_class and 'X' for ahk_exe matching. For title matching, use 'T' or just the window title.
suspendingApps = -- ;X bash.exe ; T/C/X win. - Autosuspend EPKL. Case matters. E.g., C WordPadClass, X Notepad.exe
;; What AHK TitleMatchMode to use for the above. EPKL default is 2. See https://www.autohotkey.com/docs/v1/lib/SetTitleMatchMode.htm
suspendingMode = -- ; 1/2/3/RegEx - For advanced users; TitleMatchMode to use for suspendingApps detection
;; Layouts with these Locale IDs will suspend EPKL while they're active. Useful, say, if your IME conflicts with your layout.
suspendingLIDs = -- ;f0c1 ; --, 4-xdigit LocaleIDs; see the About... menu
;; If startSuspended is active, EPKL will start up suspended. But it's probably better to just start EPKL when needed?
;startSuspended = yes ; Start EPKL in the Suspended state
;; Compact mode: The layout file is in the same folder as EPKL.exe
compactMode = no ; Run EPKL in compact mode (layout in root folder)
;; The epklDebugHotkey, if active, runs a debug/utility routine from a selection in `_PKL_main.ahk`. Which one is specified here.
whichUtility = 3 ; { 1:KeyHistory,2:ListHotkeys,3:ListVars,4:ListLines,5:WinInfo,6:eD-WIP } - first 4 are AHK debug routines
;; ================================================================================================================================================
;; EPKL Help Image Generator settings:
;; The EPKL HIG generates help images from the active layout, using a SVG image file template and the Inkscape program (v1.1+).
;; ================================================================================================================================================
;
[hig]
;; Path to the Inkscape scalable vector graphics program, required for the Help Image Generator (HIG)
InkscapePath = C:\PortableApps\InkscapePortable\InkscapePortable.exe
;; Efficiency lets you choose whether to make new images in a separate ImgGen folder or directly in the layout folder.
;; Using Efficiency level 1 means that if an image already exists it won't be overwritten but if not it'll be added.
HIG_Efficiency = 1 ; 0: Keeps new images in the ImgGen_ folder. 1: Moves images to the layout folder. 2: Overwrites existing images.
;; Erase the SVG temp file directory after creating the images
HIG_DelTmpSVGs = 1 ; 0: Don't delete. 1: Move to Recycle Bin. 2: Delete completely.
;; Make images only for these shift states, if present in the layout. +1 = Shift, +2 = Ctrl, +6 = AltGr, +8 = SwiSh/SGCaps, +16 = FliCK.
HIG_imgStates = 0:1:6:7 ;:8:9:e:f
;; Refresh DK(s) only: Instead of a full set of images, render only the specified comma-separated dead keys.
;dkOnlyMakeThis = CoDeKey_0,CoDeKey_1;,Ext_Special,Ext_Cmd
;; Heb-Niqqud-Y|O, RingAbov-Lig, Stroke-Bar, Acute-Sup, Ogonek-CmBel, DblAcute-Sci, Currency, DotBelow, Breve, Macron ...
;; Font sizes to use, depending on the number of characters in each label (1,2,3,...). The SVG file default is 32px; 14 px for small text.
imgFontDefault = 32
imgFontSizes = 32,25,17,14,13 ;32,24,18,14,12 ; Font sizes for the help images. Longer entries will be shown as ellipses.
;; If the DK image state suffix is empty, old style (""/"sh") is used to look for EPKL help images. The HIG produces the new style anyway.
img_DKStateSuf = _s
;; Symbol to replace nonprintables such as control characters and ligatures
imgNonCharMark = 0x25AF ; U+25AF/25A1 White Rectangle/Square. U+FFFD Replacment Character (question mark in diamond).
;; Symbols used in the DK layer for keys releasing DK entry 0/1 or combining accents. Remove one to turn it off.
dkBaseCharMark = 0x26AB ; U+2B24/26AB/25CF Black Large/Medium/-- Circle. Large may be too big for the key.
dkCombCharMark = 0x25CC ; U+25CC Dotted Circle. For combining accents.
k_TapOrModMark = 0x25CC ; U+25CC Dotted Circle. For Tap-or-Modifier keys. U+25A0/2B1B Black --/Large Square.
k_RepeatItChar = 0x1F504 ; For the Repeat key.
k_RepeatItMark = 0x1F504 ; U+1F501/2/3/4 – Clockwise Right/left, w/ 1, down/up Open Circle Arrows.
k_ComposerChar = 0x24b8 ; For the Compose key(s). U+2384 Composition Sym. U+24B8 Circled Lat. Cap. Letter C. U+2102 Double-Struck Cap. C.
k_ComposerMark = 0x23fa ; U+23FA Black Circle For Record. U+2B57 Heavy Circle with Circle Inside.
;; The SVG template file used to generate images from, and image dimensions in the template
svgImgTemplate = Other\EPKL_HelpImgGenerator\CmkKbdFig_KLM_Template.svg
imgPosISO = 100,100 ; (x,y) for the upper left corner
imgPosANS = 100,700 ; --"--
imgSizeWH = 812,282 ; 812,226 w/o space bar ; eD WIP: Ortho boards! Make them on the same template, to the right?
imgResDPI = 96 ; Image resolution in DPI (default 96)
;; The max number of files Inkscape should handle in one call. Mine couldn't make more than ≈80 files per batch.
HIG_BatchSize = 72 ; Inkscape file batch size (may depend on available RAM etc?)
;; ; eD WIP: Mark certain keys in bold text and colors, like the Tarmak help images. Uncomment to use on new images.
;markKeyColors = #c00:_E/_N/_K, #009:_J ; Tarmak1 colors
;markKeyColors = #c00:_E/_N/_K, #990:_B/_T/_F, #009:_J ; Tarmak2 colors
;; Debug mode. I only use this to check how the UI works. DebugKey is which idKey to show, if any.
;HIG_DebugMode = 3 ; 0: Normal operation. 1: Show key info. 2: Don't call InkScape. 3: Don't make files either.
HIG_DebugKeyID = 0_Q ; [DKname_] . ShiftState . CO