You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: projectDocs/dev/developerGuide/developerGuide.t2t
+13-12Lines changed: 13 additions & 12 deletions
Original file line number
Diff line number
Diff line change
@@ -116,12 +116,13 @@ The fields are as follows:
116
116
In most cases, this is just the character or characters of the symbol.
117
117
However, it can also be the identifier of a complex symbol.
118
118
Certain characters cannot be typed into the file, so the following special sequences can be used:
119
-
- \0: null
120
-
- \t: tab
121
-
- \n: line feed
122
-
- \r: carriage return
123
-
- \f: form feed
124
-
- \#: # character (needed because # at the start of a line denotes a comment)
119
+
- \0: null
120
+
- \t: tab
121
+
- \n: line feed
122
+
- \r: carriage return
123
+
- \f: form feed
124
+
- \#: # character (needed because # at the start of a line denotes a comment)
125
+
-
125
126
- replacement: The text which should be spoken for the symbol.
126
127
If the symbol is a complex symbol, \1, \2, etc. can be used to refer to the groups matches, which will be inlined in the replacement, allowing for simpler rules.
127
128
This also means that to get a \ character in the replacement, one has to type \\.
@@ -133,12 +134,12 @@ The default is to inherit the value or "all" if there is nothing to inherit.
133
134
- preserve: Whether the symbol itself should be preserved to facilitate correct pronunciation by the synthesiser.
134
135
For example, symbols which cause pauses or inflection (such as the comma in English) should be preserved.
135
136
This field should be one of the following:
136
-
- never: Never preserve the symbol.
137
-
- always: Always preserve the symbol.
138
-
- norep: Only preserve the symbol if it is not being replaced; i.e. the user has set symbol level lower than the level of this symbol.
139
-
- -: Use the default.
140
-
-
141
-
The default is to inherit the value or "never" if there is nothing to inherit.
137
+
- never: Never preserve the symbol.
138
+
- always: Always preserve the symbol.
139
+
- norep: Only preserve the symbol if it is not being replaced; i.e. the user has set symbol level lower than the level of this symbol.
140
+
- -: Use the default.
141
+
- The default is to inherit the value or "never" if there is nothing to inherit.
142
+
-
142
143
-
143
144
Finally, a display name for the symbol can be provided in a comment after a tab at the end of the line.
144
145
This will be shown to users when editing the symbol information and is especially useful for translators to define translated names for English complex symbols.
- Added an option to NVDA's mouse settings to make NVDA handle situations where the mouse is controlled by another application. (#8452)
2254
2254
- This will allow NVDA to track the mouse when a system is controlled remotely using TeamViewer or other remote control software.
2255
-
- Added the `--enable-start-on-logon` command line parameter to allow configuring whether silent installations of NVDA set NVDA to start at Windows logon or not. Specify true to start at logon or false to not start at logon. If the --enable-start-on-logon argument is not specified at all then NVDA will default to starting at logon, unless it was already configured not to by a previous installation. (#8574)
2255
+
- Added the ``--enable-start-on-logon`` command line parameter to allow configuring whether silent installations of NVDA set NVDA to start at Windows logon or not. Specify true to start at logon or false to not start at logon. If the --enable-start-on-logon argument is not specified at all then NVDA will default to starting at logon, unless it was already configured not to by a previous installation. (#8574)
2256
2256
- It is possible to turn NVDA's logging features off by setting logging level to "disabled" from General settings panel. (#8516)
2257
2257
- The presence of formulae in LibreOffice and Apache OpenOffice spreadsheets is now reported. (#860)
2258
2258
- In Mozilla Firefox and Google Chrome, browse mode now reports the selected item in list boxes and trees.
@@ -2271,7 +2271,7 @@ Please refer to the list of changes further down for more details on this and ho
2271
2271
- This version of NVDA will allow installing and loading of add-ons that do not yet contain Minimum and Last Tested NVDA version information, but upgrading to future versions of NVDA (E.g. 2019.2) may automatically cause these older add-ons to be disabled.
2272
2272
- The move mouse to navigator object command is now available in Microsoft Word as well as for UIA controls, particularly Microsoft Edge. (#7916, #8371)
2273
2273
- Reporting of text under the mouse has been improved within Microsoft Edge and other UIA applications. (#8370)
2274
-
- When NVDA is started with the `--portable-path` command line parameter, the provided path is automatically filled in when trying to create a portable copy of NVDA using the NVDA menu. (#8623)
2274
+
- When NVDA is started with the ``--portable-path`` command line parameter, the provided path is automatically filled in when trying to create a portable copy of NVDA using the NVDA menu. (#8623)
2275
2275
- Updated the path to the Norwegian braille table to reflect the standard from the year 2015. (#9170)
2276
2276
- When navigating by paragraph (control+up or down arrows) or navigating by table cell (control+alt+arrows), the existence of spelling errors will no longer be announced, even if NVDA is configured to announce these automatically. This is because paragraphs and table cells can be quite large, and detecting spelling errors in some applications can be very costly. (#9217)
2277
2277
- NVDA no longer automatically loads custom appModules, globalPlugins and braille and synth drivers from the NVDA user configuration directory. This code should be instead packaged as an add-on with correct version information, ensuring that incompatible code is not run with current versions of NVDA. (#9238)
@@ -2776,10 +2776,10 @@ Highlights of this release include full support for audio ducking in the Windows
2776
2776
- If you want normalized identifiers, there is now an InputGesture.normalizedIdentifiers property which normalizes the identifiers returned by the identifiers property .
2777
2777
- The InputGesture.logIdentifier property is now deprecated. Callers should use InputGesture.identifiers[0] instead. (#6945)
2778
2778
- Removed some deprecated code:
2779
-
- `speech.REASON_*` constants: `controlTypes.REASON_*` should be used instead. (#6846)
2780
-
- `i18nName` for synth settings: `displayName` and `displayNameWithAccelerator` should be used instead. (#6846, #5185)
2781
-
- `config.validateConfig`. (#6846, #667)
2782
-
- `config.save`: `config.conf.save` should be used instead. (#6846, #667)
2779
+
- ``speech.REASON_*`` constants: ``controlTypes.REASON_*`` should be used instead. (#6846)
2780
+
- ``i18nName`` for synth settings: ``displayName`` and ``displayNameWithAccelerator`` should be used instead. (#6846, #5185)
2781
+
- ``config.validateConfig``. (#6846, #667)
2782
+
- ``config.save``: ``config.conf.save`` should be used instead. (#6846, #667)
2783
2783
- The list of completions in the autocomplete context menu of the Python Console no longer shows any object path leading up to the final symbol being completed. (#7023)
2784
2784
- There is now a unit testing framework for NVDA. (#7026)
2785
2785
- Unit tests and infrastructure are located in the tests/unit directory. See the docstring in the tests\unit\__init__.py file for details.
Copy file name to clipboardExpand all lines: user_docs/en/userGuide.t2t
+52-48Lines changed: 52 additions & 48 deletions
Original file line number
Diff line number
Diff line change
@@ -1452,10 +1452,10 @@ The available logging levels are:
1452
1452
- Info: NVDA will log basic information such as startup messages and information useful for developers.
1453
1453
- Debug warning: Warning messages that are not caused by severe errors will be logged.
1454
1454
- Input/output: Input from keyboard and braille displays, as well as speech and braille output will be logged.
1455
-
- If you are concerned about privacy, do not set the logging level to this option.
1455
+
- If you are concerned about privacy, do not set the logging level to this option.
1456
1456
- Debug: In addition to info, warning, and input/output messages, additional debug messages will be logged.
1457
-
- Just like input/output, if you are concerned about privacy, you should not set the logging level to this option.
1458
-
-
1457
+
- Just like input/output, if you are concerned about privacy, you should not set the logging level to this option.
1458
+
-
1459
1459
-
1460
1460
1461
1461
==== Start NVDA after I sign in ====[GeneralSettingsStartAfterLogOn]
@@ -2263,44 +2263,48 @@ For example, if you check the report font name checkbox, each time you arrow ont
2263
2263
The document formatting options are organized into groups.
2264
2264
You can configure reporting of:
2265
2265
- Font
2266
-
- Font name
2267
-
- Font size
2268
-
- Font attributes
2269
-
- Superscripts and subscripts
2270
-
- Emphasis
2271
-
- Highlighted (Marked) text
2272
-
- Style
2273
-
- Colours
2266
+
- Font name
2267
+
- Font size
2268
+
- Font attributes
2269
+
- Superscripts and subscripts
2270
+
- Emphasis
2271
+
- Highlighted (Marked) text
2272
+
- Style
2273
+
- Colours
2274
+
-
2274
2275
- Document information
2275
-
- Comments
2276
-
- Bookmarks
2277
-
- Editor revisions
2278
-
- Spelling errors
2276
+
- Comments
2277
+
- Bookmarks
2278
+
- Editor revisions
2279
+
- Spelling errors
2280
+
-
2279
2281
- Pages and spacing
2280
-
- Page numbers
2281
-
- Line numbers
2282
-
- Line indentation reporting [(Off, Speech, Tones, Both Speech and Tones) #DocumentFormattingSettingsLineIndentation]
2283
-
- Ignore blank lines for line indentation reporting
2284
-
- Paragraph indentation (e.g. hanging indent, first line indent)
2285
-
- Line spacing (single, double, etc.)
2286
-
- Alignment
2282
+
- Page numbers
2283
+
- Line numbers
2284
+
- Line indentation reporting [(Off, Speech, Tones, Both Speech and Tones) #DocumentFormattingSettingsLineIndentation]
2285
+
- Ignore blank lines for line indentation reporting
2286
+
- Paragraph indentation (e.g. hanging indent, first line indent)
2287
+
- Line spacing (single, double, etc.)
2288
+
- Alignment
2289
+
-
2287
2290
- Table information
2288
-
- Tables
2289
-
- Row/column headers (Off, Rows, Columns, Rows and columns)
2290
-
- Cell coordinates
2291
-
- Cell borders (Off, Styles, Both Colours and Styles)
2291
+
- Tables
2292
+
- Row/column headers (Off, Rows, Columns, Rows and columns)
2293
+
- Cell coordinates
2294
+
- Cell borders (Off, Styles, Both Colours and Styles)
2295
+
-
2292
2296
- Elements
2293
-
- Headings
2294
-
- Links
2295
-
- Graphics
2296
-
- Lists
2297
-
- Block quotes
2298
-
- Groupings
2299
-
- Landmarks
2300
-
- Articles
2301
-
- Frames
2302
-
- Clickable
2303
-
-
2297
+
- Headings
2298
+
- Links
2299
+
- Graphics
2300
+
- Lists
2301
+
- Block quotes
2302
+
- Groupings
2303
+
- Landmarks
2304
+
- Articles
2305
+
- Frames
2306
+
- Clickable
2307
+
-
2304
2308
-
2305
2309
2306
2310
To toggle these settings from anywhere, please assign custom gestures using the [Input Gestures dialog #InputGestures].
@@ -2635,11 +2639,11 @@ You can also set the level to character; in this case the symbol will not be spo
2635
2639
This is useful if the symbol causes the synthesizer to pause or change the inflection of the voice.
2636
2640
For example, a comma causes the synthesizer to pause.
2637
2641
There are three options:
2638
-
- never: Never send the actual symbol to the synthesizer.
2639
-
- always: Always send the actual symbol to the synthesizer.
2640
-
- only below symbols' level: Send the actual symbol only if the configured speech symbol level is lower than the level set for this symbol.
2642
+
- never: Never send the actual symbol to the synthesizer.
2643
+
- always: Always send the actual symbol to the synthesizer.
2644
+
- only below symbols' level: Send the actual symbol only if the configured speech symbol level is lower than the level set for this symbol.
2641
2645
For example, you might use this so that a symbol will have its replacement spoken at higher levels without pausing, while still being indicated with a pause at lower levels.
2642
-
-
2646
+
-
2643
2647
-
2644
2648
2645
2649
You can add new symbols by pressing the Add button.
@@ -2678,11 +2682,11 @@ Then, press the key on the keyboard you wish to emulate.
2678
2682
After that, the key will be available from the Emulated system keyboard keys category and you will be able to assign an input gesture to it as described above.
2679
2683
2680
2684
Note:
2681
-
- Emulated keys must have gestures assigned in order to persist when saving / closing the dialog.
2682
-
- An input gesture with modifier keys may not be able to be mapped to an emulated gesture without modifier
2683
-
keys. For instance, setting the emulated input 'a' and configuring an input gesture of 'ctrl+m', may result
2684
-
in the application receiving 'ctrl+a'.
2685
-
-
2685
+
- Emulated keys must have gestures assigned in order to persist when saving / closing the dialog.
2686
+
- An input gesture with modifier keys may not be able to be mapped to an emulated gesture without modifier
2687
+
keys. For instance, setting the emulated input 'a' and configuring an input gesture of 'ctrl+m', may result
2688
+
in the application receiving 'ctrl+a'.
2689
+
-
2686
2690
2687
2691
When you are finished making changes, press the OK button to save them or the Cancel button to discard them.
2688
2692
@@ -3066,10 +3070,10 @@ These voices can also be used with NVDA.
3066
3070
To use these voices, you will need to install two components:
3067
3071
- [Microsoft Speech Platform - Runtime (Version 11), x86 https://www.microsoft.com/download/en/details.aspx?id=27225]
3068
3072
- [Microsoft Speech Platform - Runtime Languages (Version 11) https://www.microsoft.com/download/en/details.aspx?id=27224]
3069
-
- This page includes many files for both speech recognition and text-to-speech.
3073
+
- This page includes many files for both speech recognition and text-to-speech.
3070
3074
Choose the files containing the TTS data for the desired languages/voices.
3071
3075
For example, the file MSSpeech_TTS_en-US_ZiraPro.msi is a U.S. English voice.
0 commit comments