Using Spellcheck in NeoOffice

From NeoWiki

Revision as of 15:22, 25 July 2006 (edit) Sardisson (Talk | contribs) (complete the fork) ← 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)
(70 intermediate revisions not shown.)
Line 1:		Line 1:
-	'''''N.B.''' This article covers the steps required to activate writing tools in '''NeoOffice 2.0 Alpha and later'''; for the steps to use in '''NeoOffice 1.2.2 and earlier''', see [[Activating Dictionaries in NeoOffice 1.x]] instead.''	+	==Spellcheck and Writing Tools in NeoOffice==
-	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.	+	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.
-	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 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.
-	==Activating the Writing Tools for Your Preferred Language==	+	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.
-	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.	+	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]].)
-	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.	+	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.
-	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).	+	===Additional Information about Spellcheck and Writing Tools===
-	===Note for users of non-US or non-UK English (and possibly other languages with regional variants)===	+	* [[Adding Additional Dictionaries]]
		+	** Explains various methods of adding dictionaries that NeoOffice can use, as well as how to disable unused writing tools
		+	* [[Selecting the Dictionary to be Used in a Document or Section]]
		+	** 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]]
		+	** Explains how to get the contents out of the NeoOffice user dictionary
		+	* [[Troubleshooting Spellcheck]]
		+	** Lists solutions to common problems with spell-checking
		+	* [[Activating Dictionaries and Configuring Spellcheck in NeoOffice 2.x]]
		+	** Spellcheck-related instructions for NeoOffice 2.x
		+	* [[Activating Dictionaries in NeoOffice 1.x]]
		+	** Spellcheck-related instructions for NeoOffice 1.x
		+	<!-- do we want these descriptions, or just the article titles? -->
-	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.	+	==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 [http://www.neooffice.org/neojava/download.php#installlanguages language pack]''' separately.
-	===Installing Third-Party Dictionaries===	+	For details on using an interface language other than the one specified in the System Preferences, consult [[Changing the Language of the User Interface]].
-	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.	+
-		+
-	To install the downloaded dictionary (in .zip format),	+
-	# Quit NeoOffice if it is running	+
-	# Copy the zip file into NeoOffice's <tt>share/dict/ooo</tt> folder	+
-	#* <tt>cp ''foo.zip'' /Applications/NeoOffice.app/Contents/share/dict/ooo</tt>	+
-	# Unzip the dictionary	+
-	#* <tt>unzip /Applications/NeoOffice.app/Contents/share/dict/ooo/''foo.zip''</tt>	+
-	# Add the new dictionary to the master <tt>dictionary.lst</tt>	+
-	#* <tt>open -a TextEdit /Applications/NeoOffice.app/Contents/share/dict/ooo/dictionary.lst</tt>	+
-	## 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 (عربي) [early version, only 71,000 words]	+
-	* [http://www.ivrix.org.il/projects/arabic/ Ivrix Project]: Arabic (عربي) [very large list, based on Buckwalter but converted by a non-Arabic speaker; reported to be slow and consume 200 MB of RAM]	+
-	* [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ữ),	+
-		+
-	==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.	+
-		+
-	==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==	+
-	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]].	+
		+	{{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

• Adding Additional Dictionaries
  • Explains various methods of adding dictionaries that NeoOffice can use, as well as how to disable unused writing tools
• Selecting the Dictionary to be Used in a Document or Section
  • 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
  • Explains how to get the contents out of the NeoOffice user dictionary
• Troubleshooting Spellcheck
  • Lists solutions to common problems with spell-checking
• Activating Dictionaries and Configuring Spellcheck in NeoOffice 2.x
  • Spellcheck-related instructions for NeoOffice 2.x
• Activating Dictionaries in NeoOffice 1.x
  • Spellcheck-related instructions for NeoOffice 1.x

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.