<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">

<!--
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 -->


<meta>
      <topic id="textswriterguideusing_hyphenxml" indexer="include" status="PUBLISH">
         <title xml-lang="en-US" id="tit">Using Hyphenation</title>
         <filename>/text/swriter/guide/using_hyphen.xhp</filename>
      </topic>
   </meta>
   <body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3149695"><bookmark_value>hyphenation;manual/automatic</bookmark_value>
      <bookmark_value>separation, see hyphenation</bookmark_value>
      <bookmark_value>automatic hyphenation in text</bookmark_value>
      <bookmark_value>manual hyphenation in text</bookmark_value>
</bookmark><comment>mw transferred 2 entries to hyphen_prevent.xhp</comment>
<paragraph xml-lang="en-US" id="hd_id3149695" role="heading" level="1"><variable id="using_hyphen"><link href="text/swriter/guide/using_hyphen.xhp">Using Hyphenation</link>
</variable></paragraph>
      <paragraph xml-lang="en-US" id="par_id3155918" role="paragraph">By default, $[officename] moves words that do not fit on a line to the next line. If you want, you can use automatic or manual hyphenation to avoid this behavior.</paragraph>
     <note id="par_id431690357645045">
       Hyphenation rules differ between languages. To automatically guess where a word can be hyphenated, you need to have the relevant extension installed. If the rules are missing, an error message or banner will be displayed.<br/>
       Hyphenation rules are often bundled with dictionaries and installed with $[officename] depending on the language you picked. If they are missing, you can find relevant extensions by searching for "hyphenation" on the <link href="https://extensions.libreoffice.org/">Extensions website</link>.<br/>
       Learn more about <link href="https://wiki.documentfoundation.org/Language/Support">language support</link> on our wiki.
     </note>
      <h2 id="hd_id3155864">Automatic Hyphenation</h2>
      <paragraph xml-lang="en-US" id="par_id3147414" role="paragraph">Automatic hyphenation inserts hyphens where they are needed in a paragraph. This option is only available for paragraph styles and individual paragraphs.</paragraph>
      <h3 id="hd_id3149832">To Automatically Hyphenate Text in a Paragraph</h3>
      <list type="ordered">
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3148850" role="listitem">Right-click in a paragraph, and choose <emph>Paragraph</emph>.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3156104" role="listitem">Click the <link href="text/swriter/01/05030200.xhp"><emph>Text Flow</emph></link> tab.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3150101" role="listitem">In the Hyphenation area, select the Automatically check box.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3153121" role="listitem">Click <emph>OK</emph>.</paragraph>
         </listitem>
      </list>
      <h3 id="hd_id3149629">To Automatically Hyphenate Text in Multiple Paragraphs</h3>
      <paragraph xml-lang="en-US" id="par_id3149644" role="paragraph">If you want to automatically hyphenate more than one paragraph, use a paragraph style.</paragraph>
      <paragraph xml-lang="en-US" id="par_id3149956" role="paragraph">For example, enable the automatic hyphenation option for the "Default" paragraph style, and then apply the style to the paragraphs that you want to hyphenate.</paragraph>
      <list type="ordered">
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149611" role="listitem">Choose <emph>View - Styles</emph>, and then click the <emph>Paragraph Styles</emph> icon.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149867" role="listitem">Right-click the paragraph style that you want to hyphenate, and then choose <emph>Modify</emph>.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3145106" role="listitem">Click the Text Flow tab.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3149582" role="listitem">In the <emph>Hyphenation</emph> area, select the <emph>Automatically</emph> check box.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3156250" role="listitem">Click <emph>OK</emph>.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3145400" role="listitem">Apply the style to the paragraphs that you want to hyphenate.</paragraph>
         </listitem>
      </list>
      <h2 id="hd_id3145417">Manual Hyphenation</h2>
      <paragraph xml-lang="en-US" id="par_id3154400" role="paragraph">You can insert a hyphen where you want on a line, or let $[officename] search for the words to hyphenate, and then offer a suggested hyphenation.</paragraph>
      <h3 id="hd_id6587651">To Manually Hyphenate Single Words</h3>
      <paragraph xml-lang="en-US" id="par_id3153363" role="paragraph">To quickly insert a hyphen, click in the word where you want to add the hyphen, and then press <switchinline select="sys"><caseinline select="MAC">Command
</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Hyphen(-).</paragraph>
      <paragraph xml-lang="en-US" id="par_id3154244" role="paragraph">If you insert a manual hyphen in a word, the word is only hyphenated at the manual hyphen. No additional automatic hyphenation is applied for this word. A word with a manual hyphen will be hyphenated without regard to the settings on the <emph>Text Flow</emph> tab page.</paragraph>
      <h3 id="hd_id3154847">To Manually Hyphenate Text in a Selection</h3>
      <list type="ordered">
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3154869" role="listitem">Select the text that you want to hyphenate.</paragraph>
         </listitem>
         <listitem>
            <paragraph xml-lang="en-US" id="par_id3155886" role="listitem">Choose <emph>Tools - Language - Hyphenation</emph>.</paragraph>
         </listitem>
      </list>

<section id="relatedtopics">
      <embed href="text/swriter/guide/spellcheck_dialog.xhp#spellcheck_dialog"/>
      <embed href="text/swriter/guide/using_thesaurus.xhp#using_thesaurus"/>
      <embed href="text/shared/guide/standard_template.xhp#standard_template"/>
      <embed href="text/swriter/guide/hyphen_prevent.xhp#hyphen_prevent"/>
      <paragraph xml-lang="en-US" id="par_id3154361" role="paragraph"><link href="text/swriter/01/05030200.xhp">Text Flow</link></paragraph>
      </section>
   </body>
</helpdocument>
