<?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/.
    *
    -->

    <meta>
        <topic id="textsharedguideusingthemes" indexer="include" status="PUBLISH">
        <title id="tit">Using Themes</title>
        <filename>/text/shared/guide/usingthemes.xhp</filename>
    </topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id21691114004763">
    <bookmark_value>using;document themes</bookmark_value>
    <bookmark_value>document themes;using</bookmark_value>
</bookmark>
<section id="usingthemesHead">
    <h1 id="hd_id911691103974397"><variable id="h1"><link href="text/shared/guide/usingthemes.xhp">Using Document Themes</link></variable></h1>
    </section>
    <paragraph role="paragraph" id="par_id451691109216603">Theme is the concept of bundling color, font and format settings. The colors, fonts and format settings names are hard coded in the document. When switching themes in the document, the elements containing the hardcoded names switch colors, fonts and format settings accordingly to the new theme.</paragraph>
    <h2 id="hd_id761691104702168">To Apply a Theme to the Document</h2>
    <list type="ordered">
        <listitem>
            <paragraph id="par_id251691104665472"  role="listitem">Choose <menuitem>Format - Themes</menuitem>.</paragraph>
        </listitem>
        <listitem>
            <paragraph id="par_id191691104673439"  role="listitem">Double-click on the theme desired or select the theme and click <widget>OK</widget></paragraph>
        </listitem>
    </list>
    <paragraph role="paragraph" id="par_id91691105048167">All document elements with the hardcoded theme attribute name set will change to the new theme attribute. For example, a heading with font color set as "Dark 2" changes to the new theme "Dark 2" color.</paragraph>
    <h2 id="hd_id61691109283045">To Add a New Theme</h2>
    <list type="ordered">
        <listitem>
            <paragraph id="par_id901691109354713"  role="listitem">Choose <menuitem>Format - Theme</menuitem> and click on <widget>Add</widget>.</paragraph>
        </listitem>
        <listitem>
            <paragraph id="par_id351691109420290"  role="listitem">Enter a name for the new theme in the <emph>Name</emph> text box.</paragraph>
        </listitem>
        <listitem>
            <paragraph id="par_id191691110090664"  role="listitem">On the color area, choose the main color for each of the 12 hard coded color name of the theme. <variable id="extracolors">%PRODUCTNAME creates 5 additional colors to the theme calculated from the main color. The calculations of the color variants are also hard coded in the theme and you cannot change them, only the main color.</variable> </paragraph>
        </listitem>
        <listitem>
            <paragraph id="par_id811691110231938"  role="listitem">Click <widget>OK</widget> to close the color dialog.</paragraph>
        </listitem>
        <listitem>
            <paragraph id="par_id971691110237308"  role="listitem">Click <widget>OK</widget> or double click the new theme to apply the theme to the document.</paragraph>
        </listitem>
    </list>
    <h2 id="hd_id141691110507439">To Use a Document Theme</h2>
    <list type="ordered">
        <listitem>
            <paragraph id="par_id511691113013612"  role="listitem">Format the document using the hardcoded theme attribute name such as colors, fonts and other format settings.</paragraph>
        </listitem>
        <listitem>
            <paragraph id="par_id671691113042212"  role="listitem">Apply the theme to the document.</paragraph>
        </listitem>
    </list>

    <section id="relatedtopics">
        <paragraph role="paragraph" id="par_id111691103542338" localize="false"><embedvar href="text/shared/01/themesdialog.xhp#h1" markup="ignore"/></paragraph>
        <paragraph role="paragraph" id="par_id611691100380708" localize="false"><embedvar href="text/shared/01/themescolordialog.xhp#h1" markup="ignore"/></paragraph>
    </section>
</body>
</helpdocument>
