visitors (intermediate)
Access keys (See also Wikipedia:access keys) are keyboard shortcuts for tasks that would otherwise require a mouse click. They are part of markup that may exist on any webpage. On PmWiki steps have been taken to make it easier to use access keys throughout a site, and to make it possible to adjust key assignments to accommodate different languages and preferences.
Access keys require you to hold down two or more keys.
Exceptions exist for specific browsers, and specific versions. For example,
Note, in cases of conflicts between the keyboard shortcuts assigned by browsers and access keys assigned by links and other markup on webpages, many browsers, including Mozilla, Netscape and Internet Explorer, allow access keys to override the browser defaults and require a different sequence to continue using overridden browser assignments (typically, by pressing and releasing the Alt key, instead of holding it down).
The following is a list of the currently defined access keys for built-in actions. Remember that the letters identified below must be used together with the combination listed above (depending on your operating system and browser). Note that some actions do not have a corresponding access key by default.
| Key Name | Key Value | Function |
|---|---|---|
| ak_view | view | |
| ak_edit | e | edit |
| ak_history | h | history |
| ak_attach | attach | |
| ak_print | ||
| ak_backlinks | backlinks | |
| ak_logout | logout | |
| ak_recentchanges | c | recent changes |
| ak_save | s | save or publish page |
| ak_saveedit | u | save and keep editing |
| ak_savedraft | d | save draft |
| ak_preview | p | preview page |
| ak_textedit | , | jump to edit textarea |
| ak_em | emphasize text | |
| ak_strong | strong text |
Note: If the 'Key Value' is the same as the 'Key Name', the access key is currently undefined.
Following table explains which button is activated by which access key. Note that the Cancel button has no access key.
| Standard Edit mode | Draft Edit mode | Used Access Key |
|---|---|---|
| Save | Publish | ak_save |
| Save draft | ak_savedraft | |
| Save and edit | Save draft and edit | ak_saveedit |
| Preview | Preview | ak_preview |
admins (intermediate)
PmWiki uses the same "phrase translation" methods for access key mappings as it does for internationalization. This makes it possible for administrators, skins, language translators, and visitors to all influence the way that specific keys are mapped to actions.
See SitePreferences and Site.Preferences for more information and a template.
Note that some skins (e.g., Lean) don't use the translation mechanism. In this case one must edit the template file itself in order to change the access keys.
By convention, the translation phrases for all of the access key actions start with the characters "ak_", so that the page variable "$[ak_edit]" is replaced by the access key for editing as defined by the current preferences, language, skin default, or site default.
Access keys are implemented in html as optional parameters that can be added to links and many other types of markup.
Example: <a href="http://example.com" accesskey="x">Example</a> would create a link to example.com that could be triggered by clicking on the linked word "example" or using the access key Akey+x. That same action key link could be created in PmWiki markup by typing %accesskey="x"%[[http://example.com|Example]]%%, like this: Example. Try it and see if it works. Note that this AKey+x access key only works this way on this page, because it is simply a shortcut for accessing the link that exists only on this page.
The list of access key assignments in default PmWiki installations generally work throughout a site because links have been created in PmWiki skins and editing screens that incorporate access key parameters using the access key translation phrases. One location where those links can be viewed is Site.PageActions. That page contains the links that the default PmWiki skin, and many other skins, use to generate links such as "View" "Edit" and "History" that appear on most pages (other than editing screens). Each of the links in that page also has an %accesskey=$[ak_xxx]% declaration in front of it, which enables a specific access key for that link.