• Showing Page History #62411

NVDAユーザーガイドの更新

すでにNVDAパッケージに同梱されているNVDAユーザーガイドを更新します。

  • 日本語のソースコードはuser_docs/ja/userguide.htmlから参照できます。
  • ユーザーガイドのソースはuserguide.t2tで、txt2tagsを使ってHTMLに変換します。

revno: 3653

Updated English user guide with the following changes:
  • object navigation: removed paragraph mentioning that NVDA does not have display hooks, not true anymore.
  • Object navigation: remove mention of nextInFlow/previousInFlow/sayAllObjects scripts, they no longer exist.
  • Review cursor: add paragraph explaining how the review cursor works in virtualBuffers (reviews the entire buffer) and Windows (reviews a flat layout

of the window).

  • Saving and Reloading the configuration: changed this section heading to be only two levels deep, not 3 (i.e. its within Configuring NVDA, not Preferences).
  • Saving and reloading the configuration: remove paragraph mentioning nvda.ini.
  • Saving and reloading the configuration: slightly re-wrod paragraph about how NVDA does not automatically ave settings.
  • Added a section within Configuring NVDA called "Configuration files and user profiles" which talks about where NVDA's settings are stored for both the

portable and installed versions.

  • Trouble shooting: added mention that website contains info for email lists and other community resources.

revno: 3715

Large reformat of the English User guide to clean up the way key commands are mentioned, to actually mention laptop key commands, and to allow future

generation of a key commands document from the user guide.

Specific changes:
  • Converted all existing key command lists in to key command tables. Each key command includes a name, a desktop command, a laptop command, and a description.
  • Added a Basic key commands section within the Getting Started section, which just contains a Basic key commands table summarizing stop speech, pause

speech, NVDA Menu, keyboard help mode, quit NVDA and report date/time.

  • Split the About NVDA key commands section in the Getting Started section in to subsections.
  • Added a Keyboard Layout subsection to the Getting Started section, which mentions the two layouts, and a note about laptops and numberpads.
  • Removed the Forms and focus mode subsection from the Virtual buffers section as it seems quite redundant.
  • Mention Adobe Flash and Google Chrome as using virtual buffers in the Virtual buffers section.
  • Document formatting settings section: converted the comma-separated list of formatting types in to a proper list. Also included landmarks which wasn't

listed previously.

  • Preferences menu section: remove all inline mentions of settings dialog key commands, and instead mention the key command in each respective heading.
  • Moved mention of Move mouse to navigator object and move navigator object to mouse out of the navigating by object section and in to the navigating

with the mouse section.

  • Added a Synth Settings Ring section after Voice settings
  • Added a Review Cursor settings section after the Mouse settings section.

revno: 3717

English User Guide: Add markup to allow the Key Commands document to be generated automatically. Some slight reorganisation was needed in one section

to make this work well. Also fix some typos.

revno: 3735

English User guide: Getting NVDA section: rather than just saying "Here" for the link, say

www.nvda-project.org, as the previous link would make no sence if it was printed or brailled.

revno: 3732

English User guide: rewrite section about the NVDA modifier key, to make it clear that any of the NVDA modifier keys can be pressed twice quickly to produce the original key press.

revno: 3734

English User guide: Major highlights section: do not mention Firefox and IE separately, instead just say Browsing the Web with Mozilla Firefox and Windows

Internet Explorer. Same with email (Thunderbird / Outlook Express / Windows Mail). Remove the word early from IBM lotus Symphony mention.

revno: 3733

English user guide: pause speech key command description: note that unpausing will only work if the current synthesizer supports pausing. Although not

actually mentioned in the User guide, SAPI5 is one example of where it does not work.

revno: 3738

English user guide: for each of the last three options in General settings (to do with startup and logon etc), note that the option is only available

for installed copies of NVDA.

revno: 3740

English user guide: include pass key through script in the basic key commands table.

revno: 3741

English user guide: rewrite the top paragtraph in the Virtual Buffer quick key navigation section, and include it in the key commands quick reference

so that the key commands quick references mentions that the Shift key will move to previous.

revno: 3742

English user guide: Added commands: refresh, find, find next and find previous, to the first key command table in the Virtual buffers section.

revno: 3745

English User Guide:

* Rename "Advanced Tools for Developers" to "Extra Tools", as the Speech Viewer isn't just for developers, among other reasons. * Remove the detailed info about the Python Console, as it's not really useful to most users (and thus not relevant to the User Guide). Instead, provide a link to the article on the NVDA web site. * Slight change to the mention of the Tools menu.

revno: 3750

English User Guide: Rename "Troubleshooting NVDA" section to "Further Information" and rewrite somewhat to widen its scope and appear less like an excuse

for outdated documentation.

revno: 3751

English User Guide: Getting NVDA: Add note about needing an installed copy to access secure Windows screens.

revno: 3754

English User Guide: Move information about supported braille displays into an appendix. Remove specific mention of English braille codes.

revno: 3755

English User Guide: Just make Supported Braille Displays into a normal numbered section. txt2tags doesn't support appendix numbering and there's no reason

this absolutely must be an appendix anyway.

revno: 3756

English User Guide: Accessing the log file is hardly a particularly important user task.

revno: 3757

English User Guide: Clarify that you need to install NVDA to access apps running as admin as well.

revno: 3758

English User Guide: Handy Tech Braille Displays: Update link for universal driver to version 1.2.0.6a.

revno: 3762

English User Guide: Now that Supported Braille Displays is a numbered heading, number its sub-headings as well.

revno: 3766

English user guide: place a line break between each sentence within paragraphs in the user guide. This will aide trainslators in future as then diffs

will much more clearly show what sentences have changed. Note that the breaks only appear in the sourc, and not the HTML output. Paragraphs that act as descriptions for key commands have not beensplit as the processing to generate the key commands document only graabs the first line.

revno: 3767

English user guide: Voice Settings section: remove description of Synth Settings Ring scripts, as they are now document in their own section below voice

settings. Instead of that description, just add a sentence linking to the Synth Settings Ring section, mentioning that its a quicker alternative way of changing speech parameters.

revno: 3768

English user guide: Remove redundant information from the NVDA menu section describing each submenu etc. The top description is more than enough.

revno: 3769

English user guide: add a subsection to the Document Formatting settings section, for the Announce Formatting Changes after the Cursor option. Also change

the word 'All' to 'Most' in the top paragraph of the Document Formatting Settings section, as not 'all' checkboxes are used to configure specific format types. Also remove the mention of Wordpad and Microsoft Word from the top sentence of the Document Formatting Settings section as formatting is definitly supported any many other places.

revno: 3770

English user guide: clarify the fact that there is a performance decrease if enabling the Announce formatting changes after the cursor -- Document Formatting

Settings.

revno: 3771

English user guide changes:
  • Move information about each supported synthesizer in to a Supported Speech Synthesizers section just before Supported Braille Displays.
  • Majorly rewrite information about each speech synthesizer. Note: could someone !*please!* contribute some information about the AudioLogic and NewFon

synthesizers, thanks.

  • Synthesizer dialog section: rearrange so that the Synthesizer option is its own subsection, and add a subsection for the Output Device option.

===revno: 3772

English user guide: remove another sentence I missed about the synth settings ring, from the Voice settings dialog section. Thanks Jamie.

revno: 3773

English user guide: Added small bit of info for the Audiologic speech synthesizer.

revno: 3783

English User Guide: Supported Speech Synthesizers:
  • eSpeak: Remove mention of SAPI runtime, as this won't make sense to most users.

* SAPI 4/5: There should be a space between SAPI and the number, so add it.

  • SAPI 4: Add link to SAPI 4 runtime binaries.

* AudioLogic: Rename to Audiologic Tts3, which is the full name of the synth. Also clarify that it must be installed on the system. * Add info about Newfon. * Other minor fixes.

revno: 3784

English User Guide: Handy Tech Displays: Clarify that only some USB displays need USB drivers installed, as Handy Tech now have some HID displays.

revno: 3785

English User Guide: We seem to have settled on U.S. English somehow, so change "organized" to "organised". <looks disgruntled>

revno: 3786

English User Guide: Preferences: Add an introductory paragraph. Move info about OK and Cancel buttons from the General Settings sub-section to this paragraph,

as it is relevant to all settings dialogs.

revno: 3790

English User Guide: Mention support for Windows Live Mail.

revno: 3802

English User Guide: Newfon: Change link to downloads section of Russian community site.

revno: 3803

English User Guide: Mention that pressing Report title thrice copies to clipboard.

revno: 3829

English User Guide: Don't even mention Windows 2000, as recent user testing seems to indicate that this is now completely broken.

revno: 3835

English User Guide: Remove last update date. We always forget to update it, nothing else in NVDA includes a last update date and it just isn't necessary. Translators should do this also.