Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Wiki refurbishment #312

Draft
wants to merge 114 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
114 commits
Select commit Hold shift + click to select a range
512edf9
First pass
ronzulu Oct 1, 2024
56259bb
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Oct 1, 2024
f2c4ba8
Attempt to fix: Expected the closing tag `</details>` either after th…
ronzulu Oct 1, 2024
24c3825
Merge branch 'issue-170-improve-for-non-programmers' of https://githu…
ronzulu Oct 1, 2024
7dd2cb5
package-lock
ronzulu Oct 4, 2024
7e93765
Moved FAQ to top level nav
ronzulu Oct 5, 2024
4d7fe5a
Progress
ronzulu Oct 6, 2024
bef2e49
Added page for symbols
ronzulu Oct 6, 2024
69855fc
restructure customization related info
ronzulu Oct 7, 2024
5e07039
More restructuring
ronzulu Oct 8, 2024
7a79ed1
More restructuring
ronzulu Oct 9, 2024
0b89964
Added info about captures
ronzulu Oct 10, 2024
ef088eb
Starting to incorporate info from https://github.com/talonhub/communi…
ronzulu Oct 10, 2024
c06e615
Beefing up the section on keys
ronzulu Oct 10, 2024
d6d9fff
started the formatters page
ronzulu Oct 10, 2024
ab46d6d
Updated formatters
ronzulu Oct 10, 2024
6b5c297
Changing filename
ronzulu Oct 10, 2024
0cf8787
Changing filename
ronzulu Oct 10, 2024
2ee840e
Added PC control page
ronzulu Oct 11, 2024
7cfe96d
Added info about the mouse grid
ronzulu Oct 11, 2024
e8b82d1
Added text and navigation info
ronzulu Oct 11, 2024
bbdae56
Minor update
ronzulu Oct 11, 2024
0ab324d
Added section on chaining and repeating commands
ronzulu Oct 11, 2024
b816f9a
Added info about zip and git installation options
ronzulu Oct 12, 2024
c2f6d4d
Added info about grabbing screenshots
ronzulu Oct 12, 2024
62ed6cd
Added more information from the user file set readme
ronzulu Oct 12, 2024
bffb857
More
ronzulu Oct 12, 2024
1b9ceed
More progress
ronzulu Oct 12, 2024
fd0f13c
Minor
ronzulu Oct 13, 2024
9dafdf1
Beefed up the section on help commands
ronzulu Oct 13, 2024
3645759
Added info about help scope
ronzulu Oct 14, 2024
77a9ff0
Partial restructure of file locations
ronzulu Oct 14, 2024
2b51817
Fixing internal references
ronzulu Oct 14, 2024
e40f66d
More moving files around
ronzulu Oct 14, 2024
2e789bc
Started description of dictation mode
ronzulu Oct 14, 2024
e97ff7a
more progress
ronzulu Oct 14, 2024
8ce3a4b
create new folder for command mode pages
ronzulu Oct 15, 2024
b0976bf
added section on saying individual words et
ronzulu Oct 15, 2024
e187fc7
Moved some integration files around
ronzulu Oct 15, 2024
8e7f38f
completed the section on file managers
ronzulu Oct 15, 2024
4575ee4
moved info about talon sack to under help
ronzulu Oct 16, 2024
7626766
edited the info about writing code
ronzulu Oct 16, 2024
5b9990d
added info about writing code
ronzulu Oct 16, 2024
87d7e45
reorganized educational resources to categorize by topic
ronzulu Oct 17, 2024
32ab428
restructured hardware related markdown files
ronzulu Oct 17, 2024
ba2098f
minor
ronzulu Oct 18, 2024
f87f830
info about writing code
ronzulu Oct 19, 2024
d28c896
Added more info about the common commands
ronzulu Oct 19, 2024
402e2f5
minor update
ronzulu Oct 19, 2024
7169e90
minor
ronzulu Oct 19, 2024
e366f8f
minor
ronzulu Oct 20, 2024
49a41be
Minor
ronzulu Oct 22, 2024
6d93468
minor
ronzulu Oct 26, 2024
454c6ea
more minor changes
ronzulu Oct 26, 2024
6147991
various fixes
ronzulu Oct 27, 2024
ae5af80
fixed broken links
ronzulu Oct 27, 2024
cfcb03e
Merge remote-tracking branch 'upstream/main' into restructure
ronzulu Oct 28, 2024
40e6286
minor changes
ronzulu Oct 28, 2024
3061019
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Oct 28, 2024
9aef10b
progress
ronzulu Oct 30, 2024
a94658d
minor
ronzulu Oct 30, 2024
e15fa72
added description of homophones
ronzulu Oct 30, 2024
5cc2338
Merge branch 'restructure' of https://github.com/ronzulu/talon-commun…
ronzulu Oct 30, 2024
69e3ebc
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Oct 30, 2024
1908d58
added info on the benefits of saying words over phrases
ronzulu Oct 31, 2024
254b3ae
progress
ronzulu Oct 31, 2024
5e7320f
more progress
ronzulu Nov 3, 2024
1c0f818
progress
ronzulu Nov 4, 2024
f588591
progress
ronzulu Nov 4, 2024
214d99f
progress
ronzulu Nov 5, 2024
b98120c
progress
ronzulu Nov 5, 2024
360386f
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Nov 5, 2024
5462ece
progress
ronzulu Nov 6, 2024
e12d86d
moved the talon framework section from customizations to the resource…
ronzulu Nov 6, 2024
076c264
moved things around again
ronzulu Nov 7, 2024
b05c4eb
progress
ronzulu Nov 7, 2024
bf81800
progress
ronzulu Nov 7, 2024
885495a
progress
ronzulu Nov 7, 2024
3beedd5
progress
ronzulu Nov 7, 2024
e79c25d
minor
ronzulu Nov 7, 2024
8d3ff05
minor
ronzulu Nov 7, 2024
24afda5
progress
ronzulu Nov 7, 2024
817bc7c
progress
ronzulu Nov 8, 2024
c6d12e3
progress
ronzulu Nov 8, 2024
b7275b2
progress
ronzulu Nov 9, 2024
64074ed
progress
ronzulu Nov 10, 2024
bf94ab4
progress
ronzulu Nov 10, 2024
3fbc78c
fixed links etc
ronzulu Nov 11, 2024
666612a
progress
ronzulu Nov 12, 2024
2f4f94b
added info about the macro recorder
ronzulu Nov 12, 2024
c560413
progress
ronzulu Nov 12, 2024
4af7016
custom admonitions for to do and feedback
ronzulu Nov 13, 2024
d2ffce9
progress
ronzulu Nov 13, 2024
d6747e3
progress
ronzulu Nov 13, 2024
9c94981
progress
ronzulu Nov 13, 2024
97e1712
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Nov 13, 2024
9275e6c
progress
ronzulu Nov 13, 2024
eae9f4e
progress
ronzulu Nov 13, 2024
9a463d1
Merge branch 'restructure' of https://github.com/ronzulu/talon-commun…
ronzulu Nov 13, 2024
4bd59c6
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Nov 13, 2024
fe865fd
hopefully fixes icon size issue for new wiki preview admonition types
ronzulu Nov 13, 2024
45ee045
Merge branch 'restructure' of https://github.com/ronzulu/talon-commun…
ronzulu Nov 13, 2024
91d8a9e
added section on customizable subtitles, the talon UI, partially orga…
ronzulu Nov 14, 2024
e746c30
continued organization of IMG folder
ronzulu Nov 14, 2024
699752a
added a section on the talon mode indicator
ronzulu Nov 14, 2024
c9c87cc
added section on microphone selection commands
ronzulu Nov 14, 2024
672acd3
added section on automatic sleeping
ronzulu Nov 14, 2024
dde094d
added section on command history
ronzulu Nov 14, 2024
fc5e2ea
completed the section on working with media
ronzulu Nov 14, 2024
afb4884
add info about find and replace
ronzulu Nov 15, 2024
c571870
minor
ronzulu Nov 15, 2024
be6a502
[pre-commit.ci] auto fixes from pre-commit.com hooks
pre-commit-ci[bot] Nov 15, 2024
37b386f
minor
ronzulu Nov 18, 2024
c4f6204
Merge branch 'restructure' of https://github.com/ronzulu/talon-commun…
ronzulu Nov 18, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 22 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,28 @@ Join the [Talon Slack](https://talonvoice.com/chat) to find other folks interest

This wiki belongs to the Talon Community, and contributions are welcome from anyone.

## Build and view changes locally
## Build Notes

### Generating Images for Diagrams

Diagrams are stored in `.graphml` files that were created using
https://www.yworks.com/yed-live

These files are stored within this repository for easy access under the `src/diagrams` directory.

`.graphml` files can be uploaded to yed-live for free, and also modified and converted to an image file for free.

As with all images, these are stored under the `static/img` directory.

### Generating Directory Structure Diagrams

The source for directory structure diagrams are also kept in the `src/diagrams` directory.

These are simple text files that are made pretty by using the `https://tree.nathanfriend.com` website.

This is how the diagrams in [Talon Directory Structure](/docs/Resource%20Hub/terminology.md) were generated.

### Build and view changes locally

Install `npm` then run the following

Expand Down
2 changes: 1 addition & 1 deletion _redirects
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Netlify Redirects file
/blog/ /
/key_action/ /Customization/Talon%20Library%20Reference/key_action
/key_action/ /Customization/Talon%20Library%20Reference/Actions/key_action
/CODE_OF_CONDUCT/ https://github.com/TalonCommunity/Wiki/blob/main/CODE_OF_CONDUCT.md 200
/CONTRIBUTING/ https://github.com/TalonCommunity/Wiki/blob/staging/CONTRIBUTING.md 200
/FAQ/ /Quickstart/FAQ
Expand Down
69 changes: 69 additions & 0 deletions docs/Basic Usage/Command Mode/command_mode.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
sidebar_position: 1
---

# Command Mode

The examples below are just a very small selection of common commands for working with Talon. These are based on the [Talon Community](https://github.com/talonhub/community) user file set.

:::note Switching Modes
See [Mode Switching](/docs/Basic%20Usage/talon-modes.md) for info about switching modes
:::

The following can be performed in command mode:

| Action | Example |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Enter any [single character](./single-characters.md) | for `a` say `air`, `$` say `dollar sign`, function key f2 say `f2`, for the home key say `home` |
| Enter a [sequence of characters](./single-characters.md#entering-multiple-characters) | for `c3po` say `press cap three pit odd` |
| Enter a [single word](./words-and-phrases.md#saying-individual-words) | for `miscellaneous` say `word miscellaneous` |
| Enter a [phrase](./words-and-phrases.md#saying-phrases) with control over formatting | for `my_variable` say `snake my variable`, for `yourVariable` say `camel your variable` |
| Navigate a [document](./text-and-navigation.md#navigation), [select text](./text-and-navigation.md#selecting) within it | `go left`, `go down five times`, `select word left` |
| [Clipboard](./edit-menu-type-functions.md#cut-copy-and-paste) commands, [clearing and duplicating text](./edit-menu-type-functions.md#deleting-and-duplicating-text) | `cut that`, `clear word left`, `clone line` |
| [Running applications](./pc-control.md#running-applications), [tabs within apps](./pc-control.md#working-with-tabs) | `focus chrome`, `tab new` |
| Controlling the [mouse](./pc-control.md#mouse-commands) and using the [mouse grid](./pc-control.md#mouse-grid) | `dub click`, `left drag`, `mouse grid` |

## Chaining and Repeating Commands

With only a few specific exceptions, commands can be chained.
This means that multiple commands can be said as a single utterance without a pause between them.

For example, instead of saying (with a pause at the end of each line):

```
go address (within a browser window moves to the address bar)
copy that
focus code (makes the VSCode application active)
paste that
```

It could all be said as a single utterance:

```
go address copy that focus code paste that
```

Commands can also be easily repeated, by saying the following after the command to be repeated.

| Commands | Repeats the Previous Command |
| ------------------------------------- | -------------------------------------------------------------------------------- |
| `<ordinals>` | the specified number of times (eg `second`, `third`, `fourth`, ..., `twentieth`) |
| `<numbers_small> times` | the specified number of times (eg `twenty times`) |
| `repeat that` or `twice` | once |
| `repeat that <numbers_small> [times]` | the specified number of times |

These commands can be used in both of the following ways:

- Within the same utterance as the command, eg `asterisk ten times`
- As a separate utterance after the command, eg `asterisk` (pause, Talon inserts a single asterisk), followed by `ten times` (whereby talon inserts a further nine -
so that there is a total of ten)

:::note
Anything that can be said in command mode, is considered a "command".
For example, even though one would not typically consider a letter or symbol as a "command", in Talon, they are.

And therefore they can be repeated - `asterisk ten times` produces `**********`.
:::

You might find the syntax that uses `<numbers_small>` more natural than the one that uses `<ordinals>`.
Although slightly quicker to say, `asterisk tenth` takes more practice than the equivalent `asterisk ten times`
45 changes: 45 additions & 0 deletions docs/Basic Usage/Command Mode/edit-menu-type-functions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
---
sidebar_position: 15
---

# Edit Menu Functions

## Cut, Copy and Paste

| Command | Description |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `copy that` | copies the currently selected text to the clipboard |
| `copy word left`, `copy word right` | copies the word to the left/right of the insertion point |
| `cut that` | cuts the currently selected text to the clipboard |
| `cut word left`, `cut word right` | cuts the word to the left/right of the insertion point |
| `paste that` or `pace that` | paste the contents of the clipboard |
| `paste enter` | paste the contents of the clipboard, and press the enter key |
| `paste match` | (in supported applications) paste the contents of the clipboard matching the text style at the insertion point |

## Deleting and Duplicating Text

| Command | Description |
| ------------------------------------- | --------------------------------------------------------------------------- |
| `clear left`, `clear right` | deletes the character to the left or right of the insertion point |
| `clear up`, `clear down` | deletes the characters from the insertion point, either up or down one line |
| `clear word left`, `clear word right` | delete the word to the left/right of the insertion point |
| `clear way left` | deletes from the current position to the start of the current line |
| `clear way right` | deletes from the current position to the end of the current line |
| `clear way up` | deletes from the current position to the start of the document |
| `clear way down` | deletes from the current position to the end of the document |
| `clone that` | replaces the currently selected text with two copies of it |
| `clone line` | replaces the current line with two copies of it |

## Undo/Redo

| Command | Description |
| ----------- | ---------------- |
| `undo that` | performs an undo |
| `redo that` | performs a redo |

## Searching

| Command | Description |
| ---------- | ----------------------------------------------------------- |
| `find it` | bring up the application's find dialog box |
| `next one` | select the next occurrence that matches the search criteria |
Loading