diff --git a/STYLE_GUIDE b/STYLE_GUIDE index 001b2a72..f9d4ce27 100644 --- a/STYLE_GUIDE +++ b/STYLE_GUIDE @@ -114,14 +114,15 @@ is renamed or moved to another sub-directory, links should be ok. encloses a newly introduced term that is being explained. Use for the first occurrence of the main concept of every manual page, or the first occurrence -of a new concept after a sub-heading if necessary. +of a new concept after a sub-heading if necessary. Renders in bold face. Keep in mind that tags might be used to generate an index of keywords - don't pollute it too much. is used to explain an abbreviation such as LADSPA. Browsers will usually pop up the -definition when the user hovers over the word. +definition when the user hovers over the word. Renders as dotted underlined +in most browsers. On each page, use only for the first occurrence of every abbreviation. Avoid a redundant explanation in the text - the expansion can easily be extracted via CSS for printing. @@ -179,7 +180,7 @@ Any keys or key combinations, mouse buttons or controllers, menu items or textual user input should be marked with this element. It is used here in the widest possible sense, qualified by classes. E.g.: -"Press F to fit all tracks to the height of the Editor window." +"Press f to fit all tracks to the height of the Editor window." "Move Fader 1 on your MIDI controller to bind it. " Since modifier keys are not cross-platform and Ardour makes a point of @@ -187,16 +188,15 @@ abstracting them, do not hard-code "Alt", "Cmd" and friends, use class="modN" instead. So if you want the user to press Ctrl-N on Linux, that's actually N. It will render as "Ctrl+N" for you, and as "Cmd+N" for +class="mod1">N. It will render as "Ctrl N" for you, and as "Cmd N" for your Mac-using friend. Nice, uh? For anything you want the user to type, use as a block-level element. See above for other classes to denote menu items, selections, mouse events and controller actions. -Keys and mouse key names should always be capitalized. We do not need to -distringuish between "x" and "X", because the latter would be "Shift-X". -In case you forget, the stylesheet takes care of this. +Keys and mouse key names should always be entered lowercase, even though the +stylesheet might capitalize them. CSS Classes used with are: .modN @@ -226,7 +226,8 @@ The image tag must contain a 'src="/images/yourimage.png"' element and a descriptive 'alt="A short textual description of the image content"' element. Images are usually placed as block-level elements, i.e. outside of a -paragraph. +paragraph, unless they are no higher than one row and make sense in the text +flow. 5. Other conventions ==================== @@ -294,3 +295,12 @@ content per heading and you do not expect the article to grow. * If pages grow long, consider splitting them into sub-chapters at their headings. * Nobody needs "the next paragraph is about the following" paragraphs. + +5.6. Encoding +------------- + +* Pages should be encoded in UTF-8, with Unix-style newlines if possible +(although that's not critical). Avoid using verbatim special symbols, use +HTML character entities instead, for example for cursor arrows: → +← ↑ ↓. Diacriticals on vowels and other special letters are +probably ok by now, so don't bother with é and friends, just type é. diff --git a/_manual/20_default-keyboard-bindings.html b/_manual/20_default-keyboard-bindings.html index 47d8f16a..2f4d75e5 100644 --- a/_manual/20_default-keyboard-bindings.html +++ b/_manual/20_default-keyboard-bindings.html @@ -1,27 +1,36 @@ --- layout: default title: Default Keyboard Bindings +menu-title: Key Bindings --- - - - -

Almost every available function in Ardour can be executed via a keyboard shortcut (or OSC command). There are many more functions available than there are keys on even the largest current computer keyboards, so only a subset of them are bound to keys by default.

- -

Ardour comes with a rich set of default bindings. The default bindings are "mnemonic" in that they focus on trying use to -the letter that starts the name of an operation as the binding for -that operation. This is not always possible, but it acts as a general -rule. This does not necessarily lead to the best ergonomics for rapid -editing - there are alternative binding sets for that - but it does -make it simpler for newcomers to remember some of the most common -bindings (e.g. "s" for "Split", "p" for "position playhead").

- -

Almost every key binding ("shortcut") in Ardour can be changed. From the main menu choose Window > Key Bindings.

- -

The conventions for using modifier keys (Control, Alt, Command -etc.) differ from platform to platform, so we provide different -bindings for each platform.

- - +

+ Almost every available function in Ardour can be bound to a keyboard + shortcut (and those few that cannot will usually respond to an OSC command). Ardour comes with a + rich set of default key bindings for the most commonly used + functions. +

+

These bindings strive to be mnemonic, that is, easy and intuitive + to remember, and follow widely accepted conventions. As a general rule, + the first letter of an operation will be used for as a shortcut, if + available. This does not necessarily lead to the best ergonomics for + rapid editing — there are alternative binding sets for that — + but it does make it simpler for newcomers to remember some of the most + useful ones, for example
+ S for Region > Edit > Split" + or
+ P for Transport > Playhead > Playhead to Mouse. +

+

+ Almost every key binding in Ardour can be changed in + Window > Key Bindings. +

+

+ The conventions for using modifier keys ( ,  ,   etc.) differ among platforms, so we + provide different default bindings for each. +

{% children %} diff --git a/_manual/20_default-keyboard-bindings/01_mnemonic-bindings-for-linux.html b/_manual/20_default-keyboard-bindings/01_mnemonic-bindings-for-linux.html index 98e074c0..c719ef0d 100644 --- a/_manual/20_default-keyboard-bindings/01_mnemonic-bindings-for-linux.html +++ b/_manual/20_default-keyboard-bindings/01_mnemonic-bindings-for-linux.html @@ -1,311 +1,339 @@ --- layout: default title: Mnemonic Bindings for Linux +menu-title: Linux --- - - -

A printable cheat-sheet with these bindings is available for download in -US Letter and -A4 paper format. +

+ A printable cheat-sheet with the mnemonic bindings for Linux + is available for download in + US Letter and + A4 paper format. +

+

+ This set of bindings assumes an en_US keyboard. However, most if not all + bindings will also work on other keyboards when you use the + AltGr to compose those glyphs that are not directly accessible.

-

Transport & Recording Control

+

Transport & Recording Control

destroy last recording
-
Control+Delete
+
Del
engage record
-
Shift+r
+
r
fast forward
-
Shift+→
+
→
loop play (the loop range)
-
l
+
l
rewind
-
Shift+←
+
←
set playhead position
-
p
+
p
start recording
-
Shift+space
+
Space
stop (keep loop/range play)
-
Control+Alt+space
+
Space
stop and destroy
-
Control+space
+
Space
toggle auto play
-
5
+
5
toggle auto return
-
6
+
6
toggle click (metronome)
-
7
+
7
toggle playhead follows edits
-
Shift+f
+
F
toggle playhead tracking
-
Control+f
+
F
toggle roll
-
space
-
toggle track rec-enable
-
Shift+b
-
toggle track solo status
-
Alt+s
+
Space
+
toggle selected track rec-enable
+
b
+
toggle selected track solo status
+
s
transition to reverse
-
Shift+↓
+
↓
transition to roll
-
Shift+↑
+
↑
-

Session & File Handling

+ +

Session & File Handling

add track(s) or bus(ses)
-
Control+Shift+n
+
n
export session
-
Win+e
+
e
import audio files
-
Control+i
+
i
open a new session
-
Control+n
+
n
open a recent session
-
Control+Shift+o
+
o
open an existing session
-
Control+o
+
o
quit
-
Control+q
+
q
save session
-
Control+s
+
s
snapshot session
-
Control+Shift+s
-
toggle sel. track MIDI input
-
Alt+i
+
s
+
toggle selected track MIDI input
+
i
-

Changing What's Visible

+ +

Changing What's Visible

fit tracks vertically
-
f
+
f
move selected tracks down
-
Control+↓
+
↓
move selected tracks up
-
Control+↑
+
↑
scroll down (page)
-
PageDown
+
PgDn
scroll down (step)
-
↓
+
↓
scroll up (page)
-
PageUp
+
PgUp
scroll up (step)
-
↑
+
↑
toggle editor window mixer
-
Shift+e
-
toggle last 2 zoom states
-
Shift+z
-
zoom (x) to selected region(s)
-
Control+Alt+z
-
zoom (x+y) to selected region
-
Alt+z
+
e
+
visual undo
+
z
+
zoom height to selected region(s)
+
z
+
zoom height and time to selected region
+
z
zoom in
-
=
+
=
zoom out
-
-
+
-
-

Window Visibility

+ +

Window Visibility

-
toggle locations dialog
-
Alt+l
+
toggle locations dialog
+
l(ell)
focus on main clock
-
KP_Divide
+
÷
maximise editor space
-
Control+Alt+f
-
rotate editor & mixer window
-
Alt+m
+
f
+
switch between editor & mixer window
+
m
show rhythm ferret window
-
Alt+f
+
f
toggle big clock
-
Alt+b
+
b
toggle color manager
-
Alt+c
+
c
toggle editor window
-
Alt+e
+
e
toggle global audio patchbay
-
Alt+p
+
p
toggle global midi patchbay
-
Alt+Shift+p
+
p
toggle key bindings editor
-
Alt+k
+
k
toggle preferences dialog
-
Alt+o
+
o
toggle preferences dialog
-
Control+Shift+p
+
p
-

Editing with Edit Point

-

Most edit functions operate on a single "Edit Point". The edit point can be any of: playhead (default), the mouse or an active marker. The choice of Edit Point (by default) also sets the Zoom Focus.

+ +

Editing with Edit Point

+

+ Most edit functions operate on a single Edit Point (EP). The edit + point can be any of: playhead (default), the mouse or an active marker. + The choice of edit point (by default) also sets the Zoom Focus. +

+
EP to next region sync
-
;
+
;
EP to prev region sync
-
'
+
'
cycle to next grid snap mode
-
2
+
2
cycle to next zoom focus
-
1
+
1
insert from region list
-
i
+
i
insert time
-
Control+t
+
t
move EP to playhead
-
Alt+Return
+
↵
next EP w/marker
-
Control+`
+
`
next EP w/o marker
-
`
+
`
trim back
-
k
+
k
trim front
-
j
+
j
trim region end to edit point
-
Shift+}
+
}
trim region start to edit point
-
Shift+{
+
{
trim region to end of prev region
-
Control+j
+
j
trim region to start of next region
-
Control+k
-
use next grid unit
-
3
-
use next grid unit
-
4
-
use next musical grid unit
-
Control+4
+
k
use previous grid unit
-
Control+3
+
3
+
use next grid unit
+
4
+
use previous grid unit
+
3
+
use next musical grid unit
+
4
-

Aligning with the Edit Point

-

Align operations move regions so that their start/end/sync point is at the edit point. "Relative" operations -just align the first region and moves other selected regions to maintain relative positioning.

+ +

Aligning with the Edit Point

+

+ Align operations move regions so that their start/end/sync + point is at the edit point. Relative operations just align the first + region and moves other selected regions to maintain relative positioning. +

+
align end(s)
-
Alt+a
+
a
align start(s)
-
Control+Win+a
+
a
align start(s) relative
-
Win+a
+
a
align sync points
-
Shift+a
+
a
align sync points (relative)
-
a
+
a
range end to next prev edge
-
Control+>
+
>
range end to next region edge
-
>
+
>
range start to next region edge
-
Control+<
+
<
range start to prev region edge
-
<
+
<
-

Edit Point Playback

+ +

Edit Point Playback

play edit range
-
Alt+space
+
Space
play from EP & return
-
Win+space
+
Space
play selected region(s)
-
h
+
h
-

Region Operations

+

Region Operations

duplicate region (multi)
-
Shift+d
+
d
duplicate region (once)
-
Alt+d
+
d
export selected region(s)
-
Control+Win+e
+
e
increase region gain
-
^
+
^
move to original position
-
Alt+o
+
o
mute/unmute
-
Control+m
+
m
normalize
-
n
+
n
nudge backward
-
KP_Subtract
+
–
nudge forward
-
KP_Add
+
+
quantize MIDI notes
-
q
+
q
reduce region gain
-
&
+
&
reverse
-
Alt+r
+
r
set fade in length
-
/
+
/
set fade out length
-
\
+
\
set region sync point
-
v
+
v
split
-
s
+
s
toggle fade in active
-
Control+/
+
/
toggle fade out active
-
Control+\
+
\
transpose
-
Alt+t
+
t
-

Edit Range

-

There are only a few functions that refer to an "Edit Range". The current edit range is defined using combinations of the possible edit points: Playhead, Marker or Mouse.

+ +

Generic Editing

copy
-
Control+c
+
c
cut
-
Control+x
+
x
delete
-
Delete
+
Del
paste
-
Control+v
+
v
redo
-
Control+r
+
r
undo
-
Control+z
+
z
-

Selecting

+ +

Selecting

+

+ There are a few functions that refer to an Edit Range. The + current edit range is defined using combinations of the possible edit + points: playhead, active marker, or mouse. +

+
all after playhead
-
Shift+Control+p
+
p
all before playhead
-
Control+p
+
p
all enclosed by edit range
-
Control+u
+
u
all present in edit range
-
u
+
u
convert edit range to range
-
F6
+
F6
invert selection
-
Shift+i
+
i
select all after EP
-
Control+Shift+e
+
e
select all before EP
-
Control+e
+
e
select all in loop range
-
Control+l
+
l
select all in punch range
-
Control+d
+
d
select everything
-
Control+a
+
a
select next track/bus
-
Alt+↓
+
↓
select previous track/bus
-
Alt+↑
+
↑
-

Defining Loop, Punch Range and Tempo Changes

+ +

Defining Loop, Punch Range and Tempo Changes

set loop range from edit range
-
]
+
]
set loop range from region(s)
-
Alt+]
+
]
set punch range from edit range
-
[
+
[
set punch range from region(s)
-
Alt+[
+
[
set tempo (1 bar) from edit range
-
0
+
0
set tempo (1 bar) from region(s)
-
9
+
9
-

 

- + diff --git a/_manual/20_default-keyboard-bindings/02_mnemonic-bindings-for-os-x.html b/_manual/20_default-keyboard-bindings/02_mnemonic-bindings-for-os-x.html index cb6f2b9c..43d5df3f 100644 --- a/_manual/20_default-keyboard-bindings/02_mnemonic-bindings-for-os-x.html +++ b/_manual/20_default-keyboard-bindings/02_mnemonic-bindings-for-os-x.html @@ -2,307 +2,331 @@ layout: default title: Mnemonic Bindings for OS X --- - - - -

A printable cheat sheet for these bindings is available for download.

-

Transport & Recording Control

+

+ A printable cheat sheet + for these bindings is available for download. +

+ +

Transport & Recording Control

destroy last recording
-
Cmd+Delete
+
Del
engage record
-
Shift+r
+
r
fast forward
-
Shift+→
+
→
loop play (the loop range)
-
l
+
l
rewind
-
Shift+←
+
←
set playhead position
-
p
+
p
start recording
-
Shift+space
+
space
stop (keep loop/range play)
-
Cmd+Control+space
+
space
stop and destroy
-
Cmd+space
+
space
toggle auto play
-
5
+
5
toggle auto return
-
6
+
6
toggle click (metronome)
-
7
+
7
toggle playhead follows edits
-
Shift+f
+
f
toggle playhead tracking
-
Cmd+f
+
f
toggle roll
-
space
+
space
toggle track rec-enable
-
Shift+b
+
b
toggle track solo status
-
Control+s
+
s
transition to reverse
-
Shift+↓
+
↓
transition to roll
-
Shift+↑
+
↑
-

Session & File Handling

+

Session & File Handling

add track(s) or bus(ses)
-
Cmd+Shift+n
+
n
export session
-
Mod1+e
+
e
import audio files
-
Cmd+i
+
i
open a new session
-
Cmd+n
+
n
open a recent session
-
Cmd+Shift+o
+
o
open an existing session
-
Cmd+o
+
o
quit
-
Cmd+q
+
q
save session
-
Cmd+s
+
s
snapshot session
-
Cmd+Shift+s
+
s
toggle sel. track MIDI input
-
Control+i
+
i
-

Changing What's Visible

+

Changing What's Visible

fit tracks vertically
-
f
+
f
move selected tracks down
-
Cmd+↓
+
↓
move selected tracks up
-
Cmd+↑
+
↑
scroll down (page)
-
PageDown
+
PgDn
scroll down (step)
-
↓
+
↓
scroll up (page)
-
PageUp
+
PageUp
scroll up (step)
-
↑
+
↑
toggle editor window mixer
-
Shift+e
+
e
toggle last 2 zoom states
-
Shift+z
-
zoom (x) to selected region(s)
-
Cmd+Control+z
-
zoom (x+y) to selected region
-
Control+z
+
z
+
zoom height to selected region(s)
+
Control+z
+
zoom height and time to selected region
+
z
zoom in
-
=
+
=
zoom out
-
-
+
-
-

Window Visibility

+

Window Visibility

-
toggle locations dialog
-
Control+l
+
toggle locations dialog
+
l
focus on main clock
-
KP_Divide
+
÷
maximise editor space
-
Cmd+Control+f
+
f
rotate editor & mixer window
-
Control+m
+
m
show rhythm ferret window
-
Control+f
+
f
toggle big clock
-
Control+b
+
b
toggle color manager
-
Control+c
+
c
toggle editor window
-
Control+e
+
e
toggle global audio patchbay
-
Control+p
+
p
toggle global midi patchbay
-
Control+Shift+p
+
p
toggle key bindings editor
-
Control+k
+
k
toggle preferences dialog
-
Control+o
+
o
toggle preferences dialog
-
Cmd+Shift+p
+
p
-

Editing with Edit Point

-

Most edit functions operate on a single "Edit Point". The edit point can be any of: playhead (default), the mouse or an active marker. The choice of Edit Point (by default) also sets the Zoom Focus.

+ +

Editing with Edit Point

+

+ Most edit functions operate on a single Edit Point (EP). The + edit + point can be any of: playhead (default), the mouse or an active marker. + The choice of edit point (by default) also sets the Zoom Focus. +

+
EP to next region sync
-
;
+
;
EP to prev region sync
-
'
+
'
cycle to next grid snap mode
-
2
+
2
cycle to next zoom focus
-
1
+
1
insert from region list
-
i
+
i
insert time
-
Cmd+t
+
t
move EP to playhead
-
Control+Return
+
Return
next EP w/marker
-
Cmd+^
+
^
next EP w/o marker
-
`
+
`
trim back
-
k
+
k
trim front
-
j
+
j
trim region end to edit point
-
Shift+}
+
}
trim region start to edit point
-
Shift+{
+
{
trim region to end of prev region
-
Cmd+j
+
j
trim region to start of next region
-
Cmd+k
-
use next grid unit
-
3
-
use next grid unit
-
4
-
use next musical grid unit
-
Cmd+4
+
k
use previous grid unit
-
Cmd+3
+
3
+
use next grid unit
+
4
+
use previous grid unit
+
3
+
use next musical grid unit
+
4
-

Aligning with the Edit Point

-

Align operations move regions so that their start/end/sync point is at the edit point. "Relative" operations -just align the first region and moves other selected regions to maintain relative positioning.

+ +

Aligning with the Edit Point

+

+ Align operations move regions so that their start/end/sync + point is at the edit point. Relative operations just align + the first region and moves other selected regions to maintain relative + positioning. +

+
align end(s)
-
Control+a
+
a
align start(s)
-
Cmd+Mod1+a
+
align start(s) relative
-
Mod1+a
+
align sync points
-
Shift+a
+
a
align sync points (relative)
-
a
+
a
range end to next prev edge
-
Cmd+>
+
>
range end to next region edge
-
>
+
>
range start to next region edge
-
Cmd+<
+
<
range start to prev region edge
-
<
+
<
-

Edit Point Playback

+ +

Edit Point Playback

+
play edit range
-
Control+space
+
Space
play from EP & return
-
Mod1+space
+
Space
play selected region(s)
-
h
+
h
-

Region Operations

+

Region Operations

duplicate region (multi)
-
Shift+d
+
d
duplicate region (once)
-
Control+d
+
d
export selected region(s)
-
Cmd+Mod1+e
+
increase region gain
-
^
+
^
move to original position
-
Control+o
+
o
mute/unmute
-
Cmd+m
+
m
normalize
-
n
+
n
nudge backward
-
KP_Subtract
+
–
nudge forward
-
KP_Add
+
+
quantize MIDI notes
-
q
+
q
reduce region gain
-
&
+
&
reverse
-
Control+r
+
r
set fade in length
-
/
+
/
set fade out length
-
\
+
\
set region sync point
-
v
+
v
split
-
s
+
s
toggle fade in active
-
Cmd+/
+
/
toggle fade out active
-
Cmd+\
+
\
transpose
-
Control+t
+
t
-

Edit Range

-

There are only a few functions that refer to an "Edit Range". The current edit range is defined using combinations of the possible edit points: Playhead, Marker or Mouse.

+ +

Generic Editing

+
copy
-
Cmd+c
+
c
cut
-
Cmd+x
+
x
delete
-
Delete
+
Del
paste
-
Cmd+v
+
v
redo
-
Cmd+r
+
r
undo
-
Cmd+z
+
z
-

Selecting

+ +

Selecting

+

+ There are a few functions that refer to an Edit Range. The + current edit range is defined using combinations of the possible edit + points: playhead, active marker, ormouse. +

+
all after playhead
-
Shift+Cmd+p
+
p
all before playhead
-
Cmd+p
+
p
all enclosed by edit range
-
Cmd+u
+
u
all present in edit range
-
u
+
u
convert edit range to range
-
F6
+
F6
invert selection
-
Shift+i
+
i
select all after EP
-
Cmd+Shift+e
+
Shift+e
select all before EP
-
Cmd+e
+
e
select all in loop range
-
Cmd+l
+
l
select all in punch range
-
Cmd+d
+
d
select everything
-
Cmd+a
+
a
select next track/bus
-
Control+↓
+
↓
select previous track/bus
-
Control+↑
+
↑
-

Defining Loop, Punch Range and Tempo Changes

+

Defining Loop, Punch Range and Tempo Changes

set loop range from edit range
-
]
+
]
set loop range from region(s)
-
Control+]
+
]
set punch range from edit range
-
[
+
[
set punch range from region(s)
-
Control+[
+
[
set tempo (1 bar) from edit range
-
0
+
0
set tempo (1 bar) from region(s)
-
9
+
9
-

 

- + + diff --git a/source/css/app.css b/source/css/app.css index fff165ee..38fb44b5 100644 --- a/source/css/app.css +++ b/source/css/app.css @@ -460,60 +460,55 @@ samp:after { .mod1:before { content: "Ctrl "; } - .mod2:before { content: "Alt "; } - .mod3:before { content: "Shift "; } - .mod4:before { content: "Win "; } - .mod12:before { content: "Ctrl Alt "; } - .mod13:before { content: "Ctrl Shift "; } - .mod14:before { content: "Ctrl Win "; } +.mod23:before { + content: "Alt Shift "; +} +.kp:before { + content: "Keypad "; +} .mac .mod1:before { content: "Cmd "; } - .mac .mod2:before { content: "Ctrl "; } - .mac .mod3:before { content: "Shift "; } - .mac .mod4:before { content: "Opt "; } - .mac .mod12:before { content: "Cmd Ctrl "; } - .mac .mod13:before { content: "Cmd Shift "; } - .mac .mod14:before { content: "Cmd Opt "; } - - +.mac .mod23:before { + content: "Ctrl Shift "; +} #gs_tti0 {