Using Spellcheck in NeoOffice

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 19:55, 24 July 2006 (edit)
Sardisson (Talk | contribs)
(Activating the Writing Tools for Your Preferred Language)
← Previous diff
Current revision (20:05, 16 October 2013) (edit) (undo)
Sardisson (Talk | contribs)
(add and above now that we're well post-10.5)
 
(74 intermediate revisions not shown.)
Line 1: Line 1:
-NeoOffice will correctly configure your preferences to use the language tools (spell check, thesaurus, etc.) for the language that is set as the default in the System Preferences when you launch NeoOffice, provided you have the appropriate writing tools installed. +==Spellcheck and Writing Tools in NeoOffice==
-Note that '''all the writing tools''' (dictionary, thesaurus, hyphenation) '''may not be available for all languages'''; some languages may have only one (usually the dictionary), and some may not have any tools at all.+NeoOffice will correctly configure your preferences to use the language tools (spellcheck, thesaurus, etc.) for the language and region that are set as the defaults in the International pane of the System Preferences when you first launch NeoOffice, provided you have the appropriate writing tools installed.
-==Activating the Writing Tools for Your Preferred Language==+NeoOffice 3.x will automatically use the native Mac OS X spelling dictionaries if they match the language of the text to be checked. See [[Troubleshooting Spellcheck#Issues_with_Locale_Variants_of_Languages|Issues with Locale Variants of Languages]] for more details.
-NeoOffice 2.0 ships with the same set of writing tools that the standard build of OpenOffice.org supplies (see the list below). Other writing tools can be downloaded and activated as described later in this section. In some cases, NeoOffice 2.0 can also use the tools you installed in NeoOffice 1.x. +
-US English, UK English, Austrian German, Swiss German, and German all have the dictionary, thesaurus, and hyphenation pre-installed in NeoOffice 2.0. Dictionaries for Hungarian (also hyphenation), Italian (also hyphenation), Dutch (also hyphenation), Swahili, and Thai, thesauruses for Czech and Slovak, and hyphenation for Danish and Russian are also included. +However, if you add a word to the dictionary in NeoOffice, it will be added to your NeoOffice user dictionary, <code>~/Library/Preferences/NeoOffice-3.0/user/wordbook/standard.dic</code> (where ~ represents your home folder), not your Mac OS X user dictionary. See [[Exporting the Word List from a User Dictionary]] for information on syncing the contents of '''standard.dic''' to your Mac OS X user dictionary.
-In NeoOffice 2.0 Alpha, the download and activation of writing tools uses the standard cross-platform OpenOffice.org Dictionary Wizard method. Choose '''Install new dictionaries…''' from the '''Wizards''' submenu of the '''File''' menu, then follow the steps in the wizard.+NeoOffice also ships with a very limited number of OpenOffice.org writing tools (spelling dictionary, thesaurus, hyphenation), with many of the dictionaries and thesauri formerly found in NeoOffice 2.x omitted; if your language is not supported by the Mac OS X spelling system nor by the OpenOffice.org dictionaries shipped in NeoOffice, see [[Adding Additional Dictionaries]] for information on installing writing tools for your language. (If you want to disable unnecessary writing tools, see [[Adding Additional Dictionaries#Disabling Writing Tools for Unnecessary Languages|Disabling Writing Tools for Unnecessary Languages]].)
-Because the writing tools authors and their communities are always updating these tools, you should run the Dictionary Wizard even if your language's writing tools were pre-installed (or if you upgraded from NeoOffice 1.x).+On Mac OS X 10.5 and above, NeoOffice also includes support for the Mac OS X grammar checker (which on 10.5 supports only US English and only a limited subset of English grammar, at that); this can be activated by opening the {{Menu|Tools}} menu, selecting the {{menu|Add-Ons}} sub-menu, and choosing one of the options from the {{menu|Check Grammar}} sub-menu.
-====Note for users of non-US or non-UK English (and possibly other languages with regional variants)====+===Additional Information about Spellcheck and Writing Tools===
-The new language tools system in NeoOffice 2.0 no longer maps other English variants to the US or UK English tools; you must install the dictionary, etc., for your language to have working writing tools. If you upgraded from NeoOffice 1.x, your list of installed writing tools was preserved and may now be incorrect and cause problems. You can safely delete <tt>~/Library/Preferences/NeoOffice-2.x/user/wordbook/dictionary.lst</tt> to fix potential problems.+* [[Adding Additional Dictionaries]]
- +** Explains various methods of adding dictionaries that NeoOffice can use, as well as how to disable unused writing tools
-====Installing Third-Party Dictionaries====+* [[Selecting the Dictionary to be Used in a Document or Section]]
-Due to licensing problems and other issues, there may be dictionaries for some languages that are not available via the dictionary wizard. If you find a dictionary for your language in either Hunspell (preferred) or MySpell format, it is possible to use this dictionary with NeoOffice.+** Explains how to make sure NeoOffice is using the correct dictionary and provides methods for automating the process
- +* [[Exporting the Word List from a User Dictionary]]
-To install the downloaded dictionary (in .zip format), +** Explains how to get the contents out of the NeoOffice user dictionary
-# Quit NeoOffice if it is running+* [[Troubleshooting Spellcheck]]
-# Copy the zip file into NeoOffice's <tt>share/dict/ooo</tt> folder+** Lists solutions to common problems with spell-checking
-#* <tt>cp ''foo.zip'' /Applications/NeoOffice.app/Contents/share/dict/ooo</tt>+* [[Activating Dictionaries and Configuring Spellcheck in NeoOffice 2.x]]
-# Unzip the dictionary+** Spellcheck-related instructions for NeoOffice 2.x
-#* <tt>unzip /Applications/NeoOffice.app/Contents/share/dict/ooo/''foo.zip''</tt>+* [[Activating Dictionaries in NeoOffice 1.x]]
-# Add the new dictionary to the master <tt>dictionary.lst</tt>+** Spellcheck-related instructions for NeoOffice 1.x
-#* <tt>open -a TextEdit /Applications/NeoOffice.app/Contents/share/dict/ooo/dictionary.lst</tt>+<!-- do we want these descriptions, or just the article titles? -->
-## Add a new line at the end of the file, in the format: <tt>DICT ''ab'' ''CD'' ''foo_bar''</tt>+
-##* <tt>ab</tt> is the [http://www.ics.uci.edu/pub/ietf/http/related/iso639.txt ISO language code] for your locale, e.g. ''en'' for an English-speaking locale+
-##* <tt>CD</tt> is the [http://www.chemie.fu-berlin.de/diverse/doc/ISO_3166.html ISO country code] for your locale, e.g. ''AU'' for Australia+
-##* <tt>foo_bar</tt> is the "root name" of the <tt>.dic</tt> and <tt>.aff</tt> files, e.g. ''en_australia'' for our hypothetical <tt>en_australia.dic</tt> and <tt>en_australia.aff</tt> (you can find this name by watching the output of the unzip command in step 3 above)+
-## Save the modified <tt>dictionary.lst</tt> (making sure it remains plain text if you use TextEdit)+
-# Restart NeoOffice and enjoy your new dictionary!+
-:See the [http://lingucomponent.openoffice.org/manual_instal.html OpenOffice.org manual installation instructions] for more information.+
- +
-=====Known Sources of Third-Party Dictionaries=====+
- +
-* [ftp://foolab.org/pub/software/arspell/ Foolab]: Arabic (عربي)+
-* [http://hunspell.sourceforge.net/ Hunspell SourceForge Project]: Amharic (አማርኛ), Azerbaijani (Azərbaycanca), Bengali (বাংলা), Kashubian (Kaszëbsczi), Persian (فارسی), Hindi (हिंदी), Mongolian (Монгол), Marathi (मराठी), Oriya (ଓଡ଼ିଆ), Punjabi (ਪੰਜਾਬੀ), Tamil (தமிழ்), Uzbek (Ўзбекча), Vietnamese (Việt ngữ),+
- +
-===NeoOffice 1.2.2===+
-First, check to see if your language is one of the 12 shipped in the default NeoOffice install; if your language is not one of those 12, you need to download and install the appropriate [http://www.planamesa.com/neojava/olddownload.php#installlanguages language pack] in order to get the writing tools.+
- +
-In order to active the writing tools for your preferred language, simply ensure that language is set as topmost one in the '''Languages:''' list in the '''Language''' tab of the '''International''' pane of the Mac OS X System Preferences before launching NeoOffice for the first time. +
- +
-'''Note''' that some languages and local variants, such as Hungarian (Magyar) or Português do Brasil, '''do not appear in the Languages: list by default'''; you will have to press the "Edit…" button, check the desired language, and click "OK" before you will be able to move that language to the top of the list.+
- +
-<div style="margin: 0 auto; margin-top: 0.75em; margin-bottom: 0.75em; border: 1px solid #006; background-color: #F0F0FF; text-align: left; width: auto; padding: 4px;">'''DO NOT''' use the Dictionary Autopilot (in the '''Autopilot''' submenu of the '''File''' menu) to add or enable writing tools in NeoOffice 1.2.2; doing so will install files that only work with OpenOffice.org 2.0 and which will cause NeoOffice 1.2.2 to crash when those writing tools are used. '''Only use''' the methods described on this page for adding and enabling writing tools.</div><!--why won't bluebox work here?-->+
- +
-==Enabling Writing Tools for Additional Languages==+
- +
-To install and activate writing tools for additional languages in NeoOffice 2.0 Alpha, simply repeat the steps in the previous section for any additional languages you wish to use.+
- +
-===NeoOffice 1.2.2===+
-NeoOffice does not activate all available dictionaries because of a '''crippling bug in the OpenOffice.org code''' which causes '''tremendous slowdowns when more than one or two dictionaries are activated'''. By default, NeoOffice uses only the dictionary for your default language. +
- +
-If you desire to use writing tools for additional languages (''e.g.'', to work on a document in French and German), you can follow these steps to activate the writing tools for additional languages (again, provided you have the appropriate [http://www.planamesa.com/neojava/download.php#installlanguages language pack] installed for languages other than the 12 in the default NeoOffice install). ''If you use Norwegian (Nynorsk or Bokmål) and run a version of Mac OS X prior to 10.4, see the section [[#Norwegian and Mac OS X 10.3.x|Norwegian and Mac OS X 10.3.x]] below for additional required steps.''+
- +
-For each additional language whose writing tools you wish to enable, perform the following steps:+
-# Install the appropriate [http://www.planamesa.com/neojava/download.php#installlanguages language pack], if necessary.+
-# In the '''Language''' tab of the '''International''' pane of the Mac OS X System Preferences, set the language whose writing tools you wish to enable to be the topmost in the '''Languages:''' list.+
-# Launch NeoOffice.+
-#:NeoOffice will enable the writing tools for the language selected in step 2.+
-# Quit NeoOffice.+
-#: If you wish to enable writing tools for more languages, repeat steps 1-4 for each additional language.+
-# Finally, in the '''Language''' tab of the '''International''' pane of the Mac OS X System Preferences, set the language you wish to use for the user interface in NeoOffice to be the topmost in the '''Languages:''' list (i.e., choose the language that was set as topmost before beginning this process).+
- +
-If you have multiple users on the same Macintosh, you will need to repeat steps 2-5 for each user, as the list of enabled writing tools is set per-user (each language pack needs only to be installed once, though).+
- +
-==Selecting the Dictionary to be Used in a Document or Section==+
- +
-If you have multiple languages and dictionaries enabled, you can control which dictionary is used in a document (or section thereof) by setting the appropriate preferences. +
- +
-To set the language of an entire document, select '''Preferences…''' from the '''NeoOffice''' menu, then click the "plus in a box" next to '''Language Settings''' to expand that section. Next select the '''Languages''' item and set the "Default languages for documents" as desired (either for all new documents, or for the current document only with the appropriate checkbox).+
- +
-To set the the language of a particular section of text, select the text and choose '''Character...''' from the '''Format''' menu; set the appropriate language via the appropriate '''Language''' box in the '''Font''' tab.+
- +
-'''Be sure to set the language of the document and/or each section of text appropriately or spell-check will not work.'''+
- +
-===Automation===+
-[[User:yoxi|yoxi]] offers simple steps for constructing a macro to automate this process, for those who regularly use two or more languages. See [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&p=10013#10013 this post on trinity] for the steps.+
- +
-===Troubleshooting===+
-Sometimes this process gets convoluted; there is a [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=1357 trinity thread] that attempts to walk through troubleshooting why language (and thus dictionary) settings "don't stick" sometimes.+
==Changing the language of the NeoOffice user interface== ==Changing the language of the NeoOffice user interface==
-NeoOffice uses the topmost language in the list in the International pane of the System Preferences to determine the interface language. For details on using an interface language other than the one specified in the System Preferences, consult [[Changing the Language of the User Interface]].+NeoOffice uses the topmost language in the list in the International pane of the System Preferences to determine the interface language. If you want the '''NeoOffice user interface''' (and in some cases the Help) to be in your native language, you must '''install the appropriate [http://www.neooffice.org/neojava/download.php#installlanguages language pack]''' separately.
- +
-==Language-specific Notes for NeoOffice 1.2.2 and below==+
- +
-===Norwegian and Mac OS X 10.3.x===+
- +
-Due to bugs in Apple's language codes in versions of Mac OS X prior to 10.4, dictionaries are not activated automatically when '''Norwegian''' is set as the top-most language in those versions of Mac OS X.+
- +
-Beginning with NeoOffice 1.2 Alpha, if you choose "Norsk" in the System Preferences, NeoOffice will activate the Bokmål dictionary. In order to enable the Nynorsk dictionary, follow the steps below (if you do not wish to use the Nynorsk UI, simply quit NeoOffice after verifying the dictionary has been enabled and return the checkboxes to the state prior to following the below steps).+
- +
-In order to work around the Apple bug and enable the Nynorsk Norwegian dictionary, follow these steps:+
- +
-# First, ensure you have downloaded and installed the [http://www.planamesa.com/neojava/download.php#installlanguages Scandanavian and Baltic language pack].+
-# Select the '''NeoOffice''' application in the Finder and choose '''Get Info''' from the Finder's '''File''' menu. +
-# In the "NeoOffice Info" window, click on the triangle to the left of '''Languages:''' to expand that section.+
-# Uncheck all of the languages except the variant of Norwegian you wish to enable.+
-#: ''You must be a user with administrative rights in order to uncheck these boxes.'' +
-# Launch NeoOffice; your dictionary will be enabled, and NeoOffice will display the user interface in that variant.+
-# If you wish to enable dictionaries for a second variant, quit NeoOffice and repeat steps 4 and 5.+
-#: ''Both dictionaries will remain active once they have been activated; however, only the language (Nynorsk or Bokmål) that is checked in the '''Languages:''' section of the "NeoOfficeJ Info" window will be used as the UI language. If more than one language is checked, NeoOffice will use the one that is first alphabetically.''+
- +
-Apple fixed this bug in Mac OS X 10.4, so users can add Nynorsk or Bokmål to the '''Languages:''' section of the '''International''' System Preferences and follow the normal steps to enable those dictionaries and choose one or the other as the UI language.+
- +
-'''N.B.''' This Apple bug was partially worked around in NeoOffice 1.2 Alpha; however, users of Mac OS X 10.2.x and NeoOffice/J 1.1 will need to follow the full set of steps above.+
- +
-===English and non-US locales (NeoOffice/J 1.1 only)===+
- +
-'''N.B.''' This bug has been fixed in NeoOffice 1.2 Alpha. If your locale does not appear in the "Default languages for documents" item, please [[How to Report Problems with NeoOffice|file a bug]]. (Also note that explicitly setting the "Locale Setting" is no longer necessary. As long as the correct language is selected in "Default languages for documents", the correct currency will be chosen.)+
- +
-''Note: The following is applicable to all non-US English locales (e.g., Australian English, Canadian English, etc.) for which NeoOffice/J has a language option; substitute your language/currency in the appropriate places. It is also applicable to all locales that are not the "mother locale" for a language, e.g., fr-CA, fr-BE, etc.''+
- +
-For all English speakers, NeoOffice/J 1.1 installs the English (US) language dictionary and currency settings by default. If you wish to use the English language writing tools and currency settings specific to a non-US locale, before launching NeoOffice/J for the first time make sure you have your preferred English locale (e.g., British English) properly set in the Mac OS X System Preferences. This locale should be at the top of the list of languages in the '''Language''' tab of the '''International''' pane of the System Preferences (if need be, click the '''Edit List...''' button to add it). +
- +
-Even with your preferred English locale at the top of the list, NeoOffice/J 1.1 may still default to English (US). If so, after launching NeoOffice/J 1.1, open the Preferences, expand the '''Language Settings''' section and click on '''Languages'''. Choose, e.g., ''English (UK)'' from the "Locale setting" menu in the right-hand pane; this will auto-populate the "Default currency" with ''GBP £ English (UK)'' and the "Default languages for documents" with ''English (UK)'' in the "Western" slot. This should properly set your version of English as the default language for all new documents.+
-If you have already installed NeoOffice/J 1.1, and the language settings are defaulted to English (US) and won't change to, e.g., English (UK) using the steps above, you can fix this by re-installing NeoOffice/J after you have set the System Language to, e.g., British English. You will also need to reset the NeoOffice/J preferences to their defaults prior to launch, so remove your <tt>~/Library/NeoOfficeJ-1.1</tt> folder as well.+For details on using an interface language other than the one specified in the System Preferences, consult [[Changing the Language of the User Interface]].
 +{{botlangbarEN|[[Fr:Installer_des_Dictionnaires|Français]] [[It:Attivare_i_dizionari_e_configurare_il_controllo_ortografico|Italiano]]}}
[[Category:Tips and Hints]][[Category:NeoOffice]] [[Category:Tips and Hints]][[Category:NeoOffice]]

Current revision

Spellcheck and Writing Tools in NeoOffice

NeoOffice will correctly configure your preferences to use the language tools (spellcheck, thesaurus, etc.) for the language and region that are set as the defaults in the International pane of the System Preferences when you first launch NeoOffice, provided you have the appropriate writing tools installed.

NeoOffice 3.x will automatically use the native Mac OS X spelling dictionaries if they match the language of the text to be checked. See Issues with Locale Variants of Languages for more details.

However, if you add a word to the dictionary in NeoOffice, it will be added to your NeoOffice user dictionary, ~/Library/Preferences/NeoOffice-3.0/user/wordbook/standard.dic (where ~ represents your home folder), not your Mac OS X user dictionary. See Exporting the Word List from a User Dictionary for information on syncing the contents of standard.dic to your Mac OS X user dictionary.

NeoOffice also ships with a very limited number of OpenOffice.org writing tools (spelling dictionary, thesaurus, hyphenation), with many of the dictionaries and thesauri formerly found in NeoOffice 2.x omitted; if your language is not supported by the Mac OS X spelling system nor by the OpenOffice.org dictionaries shipped in NeoOffice, see Adding Additional Dictionaries for information on installing writing tools for your language. (If you want to disable unnecessary writing tools, see Disabling Writing Tools for Unnecessary Languages.)

On Mac OS X 10.5 and above, NeoOffice also includes support for the Mac OS X grammar checker (which on 10.5 supports only US English and only a limited subset of English grammar, at that); this can be activated by opening the Tools menu, selecting the Add-Ons sub-menu, and choosing one of the options from the Check Grammar sub-menu.

Additional Information about Spellcheck and Writing Tools

Changing the language of the NeoOffice user interface

NeoOffice uses the topmost language in the list in the International pane of the System Preferences to determine the interface language. If you want the NeoOffice user interface (and in some cases the Help) to be in your native language, you must install the appropriate language pack separately.

For details on using an interface language other than the one specified in the System Preferences, consult Changing the Language of the User Interface.


This article in other languages: Français Italiano
Personal tools