Files
help/source/text/sdraw/guide/gradient.xhp
Christian Lohmaier 77cb682cd1 convert plain paragraphs with role="heading" → h<level>
i.e. without child elements and also drop the language that was changed
to implied in the dtd previously/defaults to en-US unless specified.

This change doesn't affect translations, only the content of the
paragraph/headings is extracted.

done with:
perl -CSD -pi -e 'BEGIN {$base = qr/role="heading"|level="(?<level>\d+)"|(?<id>id="[^"]+")/;} s#<paragraph(((\s+($base)){3})|(\s+($base|xml-lang="en-US")){4})>(?<body>[^<]+)</paragraph>#<h$+{level} $+{id}>$+{body}</h$+{level}>#g'

(all permutations re order of attributes, and xml-lang="en-US" being
optional / implied)

Change-Id: I365a2bb983a3969af9390753fce7b7f3597c7b8b
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/148795
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hallot@libreoffice.org>
2023-03-16 15:18:10 +00:00

100 lines
5.1 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!--
* 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 .
-->
<helpdocument version="1.0">
<meta>
<topic id="textsdrawguidegradientxml" indexer="include" status="PUBLISH">
<title xml-lang="en-US" id="tit">Creating Gradient Fills</title>
<filename>/text/sdraw/guide/gradient.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="index" id="bm_id3150792"><bookmark_value>gradients; applying and defining</bookmark_value>
<bookmark_value>editing;gradients</bookmark_value>
<bookmark_value>defining;gradients</bookmark_value>
<bookmark_value>custom gradients</bookmark_value>
<bookmark_value>transparency;adjusting</bookmark_value>
</bookmark>
<comment>mw deleted "applying;"</comment>
<paragraph xml-lang="en-US" id="hd_id3150792" role="heading" level="1"><variable id="gradient"><link href="text/sdraw/guide/gradient.xhp">Creating Gradient Fills</link>
</variable></paragraph>
<paragraph xml-lang="en-US" id="par_id3154012" role="paragraph">A gradient fill is an incremental blend of two different colors, or shades of the same color, that you can apply to a drawing object.</paragraph>
<h3 id="hd_id3147436">To apply a gradient:</h3>
<list type="ordered">
<listitem>
<paragraph xml-lang="en-US" id="par_id3146974" role="listitem">Select a drawing object.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_id3154491" role="listitem">Choose <emph>Format - Area</emph> and select <emph>Gradient</emph> as the <emph>Fill</emph> type.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_id3153415" role="listitem">Select a gradient style from the list and click <emph>OK</emph>.</paragraph>
</listitem>
</list>
<h2 id="hd_id3154702">Creating Custom Gradients</h2>
<paragraph xml-lang="en-US" id="par_id3145791" role="paragraph">You can define your own gradients and modify existing gradients, as well as save and load a list of gradient files.</paragraph>
<h3 id="hd_id3145384">To create a custom gradient:</h3>
<list type="ordered">
<listitem>
<paragraph xml-lang="en-US" id="par_id3151242" role="paragraph">Choose <emph>Format - Area</emph> and click the <emph>Gradients</emph> tab.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_id3150046" role="paragraph">Select a gradient from the list to use as the basis for your new gradient and click <emph>Add</emph>.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_id3145116" role="paragraph">Type a name for the gradient in the text box and click <emph>OK</emph>.</paragraph>
<paragraph xml-lang="en-US" id="par_id6535843" role="paragraph">The name appears at the end of the gradient list and is selected for editing.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_id3150391" role="paragraph">Set the gradient properties and click <emph>Modify</emph> to save the gradient.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_id3156396" role="paragraph">Click <emph>OK.</emph> </paragraph>
</listitem>
</list>
<h2 id="hd_id3149947">Using Gradients and Transparency</h2>
<paragraph xml-lang="en-US" id="par_id3157905" role="paragraph">You can adjust the properties of a gradient as well as the transparency of a drawing object with your mouse.</paragraph>
<h3 id="hd_id3150653">To adjust the gradient of a drawing object:</h3>
<list type="ordered">
<listitem>
<paragraph xml-lang="en-US" id="par_id3154844" role="paragraph">Select a drawing object with the gradient that you want to modify.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_id3145592" role="paragraph">Choose <emph>Format - Area</emph> and click the <emph>Gradients</emph> tab.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN107BE" role="paragraph">Adjust the values for the gradient to suit your needs and click <emph>OK</emph>.</paragraph>
</listitem>
</list>
<paragraph xml-lang="en-US" id="par_id3150659" role="tip">To adjust the transparency of an object, select the object, choose <emph>Format - Area</emph> and click the <emph>Transparency</emph> tab.</paragraph>
<section id="relatedtopics">
<embed href="text/sdraw/guide/color_define.xhp#color_define"/>
</section>
</body>
</helpdocument>