Modified: maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/encoding.html ============================================================================== --- maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/encoding.html (original) +++ maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/encoding.html Wed Aug 5 15:33:50 2020 @@ -1,163 +1,166 @@ -<!DOCTYPE html> -<!-- - | Generated by Apache Maven Doxia Site Renderer 1.8 from src/site/apt/examples/encoding.apt.vm at 2018-04-23 - | Rendered using Apache Maven Fluido Skin 1.7 ---> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> - <head> - <meta charset="UTF-8" /> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="author" content="Franz Allan See -Karl Heinz Marbaise" /> - <meta name="Date-Creation-yyyymmdd" content="20160513" /> - <meta name="Date-Revision-yyyymmdd" content="20180423" /> - <meta http-equiv="Content-Language" content="en" /> - <title>Apache Maven Resources Plugin – Specifying a character encoding scheme</title> - <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> - <link rel="stylesheet" href="../css/site.css" /> - <link rel="stylesheet" href="../css/print.css" media="print" /> - <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> - <!-- Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-140879-1']); - _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - </head> - <body class="topBarDisabled"> - <div class="container-fluid"> - <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../../../images/apache-maven-project.png" alt="Apache Maven Resources Plugin"/></a></div> - <div class="pull-right"><a href="../../../" id="bannerRight"><img src="../../../images/maven-logo-black-on-white.png" alt=""/></a></div> - <div class="clear"><hr/></div> - </div> - - <div id="breadcrumbs"> - <ul class="breadcrumb"> - <li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> - <li class=""><a href="../../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class=""><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> - <li class=""><a href="../index.html" title="Apache Maven Resources Plugin">Apache Maven Resources Plugin</a><span class="divider">/</span></li> - <li class="active ">Specifying a character encoding scheme</li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2018-04-23</li> - <li id="projectVersion" class="pull-right">Version: 3.1.0</li> - </ul> - </div> - <div class="row-fluid"> - <div id="leftColumn" class="span2"> - <div class="well sidebar-nav"> - <ul class="nav nav-list"> - <li class="nav-header">Overview</li> - <li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li> - <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> - <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li> - <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> - <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li> - <li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li> - <li class="nav-header">Examples</li> - <li class="active"><a href="#"><span class="none"></span>Specifying a character encoding scheme</a></li> - <li><a href="../examples/resource-directory.html" title="Specifying resource directories"><span class="none"></span>Specifying resource directories</a></li> - <li><a href="../examples/filter.html" title="Filtering"><span class="none"></span>Filtering</a></li> - <li><a href="../examples/include-exclude.html" title="Including and excluding files and directories"><span class="none"></span>Including and excluding files and directories</a></li> - <li><a href="../examples/escape-filtering.html" title="Escape Filtering"><span class="none"></span>Escape Filtering</a></li> - <li><a href="../examples/copy-resources.html" title="Copy Resources"><span class="none"></span>Copy Resources</a></li> - <li><a href="../examples/binaries-filtering.html" title="Binaries Filtering"><span class="none"></span>Binaries Filtering</a></li> - <li><a href="../examples/custom-resource-filters.html" title="Custom Resources Filters"><span class="none"></span>Custom Resources Filters</a></li> - <li class="nav-header">Project Documentation</li> - <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> - <li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> - <li class="nav-header">Maven Projects</li> - <li><a href="../../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> - <li><a href="../../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> - <li><a href="../../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> - <li><a href="../../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> - <li><a href="../../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> - <li><a href="../../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> - <li><a href="../../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> - <li><a href="../../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> - <li><a href="../../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> - <li><a href="../../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> - <li><a href="../../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> - <li><a href="../../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> - <li><a href="../../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> - <li><a href="../../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> - <li><a href="../../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> - <li class="nav-header">ASF</li> - <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> - <li><a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> - <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> - <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> -</ul> -<form id="search-form" action="https://www.google.com/search" method="get" > - <input value="$sitesearchValue" name="sitesearch" type="hidden"/> - <input class="search-query" name="q" id="query" type="text" /> -</form> -<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> - <hr /> - <div id="poweredBy"> - <div class="clear"></div> - <div class="clear"></div> - <div id="twitter"> - <a href="https://twitter.com/ASFMavenProject" class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> - <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> - </div> - <div class="clear"></div> - <div class="clear"></div> -<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> - </div> - </div> - </div> - <div id="bodyColumn" class="span10" > -<div class="section"> -<h2><a name="Specifying_a_character_encoding_scheme"></a>Specifying a character encoding scheme</h2> -<p>A character encoding scheme such as <tt>ASCII</tt>, <tt>UTF-8</tt> or <tt>UTF-16</tt> can be chosen to be used for the reading and writing of files.</p> -<p>The best practice is to <a class="externalLink" href="https://maven.apache.org/general.html#encoding-warning">define encoding</a> for copying filtered resources via the property <tt>${project.build.sourceEncoding}</tt> which should be defined in the pom properties section like this:</p> -<div class="source"><pre class="prettyprint linenums"><project ...> - ... - <properties> - <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> - ... - </properties> - .. -</project></pre></div> -<p>By using the above property <tt>maven-resources-plugin</tt> will automatically use this <a href="../resources-mojo.html#encoding">encoding</a>.</p> -<p>Occasionally you need to change the encoding explicitly for different purposes. This can be done by defining the encoding via the configuration like this: </p> -<div class="source"><pre class="prettyprint linenums"><project> - ... - <build> - <plugins> - <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-resources-plugin</artifactId> - <version>3.1.0</version> - <configuration> - ... - <encoding>UTF-8</encoding> - ... - </configuration> - </plugin> - </plugins> - ... - </build> - ... -</project></pre></div></div> - </div> - </div> - </div> - <hr/> - <footer> - <div class="container-fluid"> - <div class="row-fluid"> - <p>Copyright ©2001–2018 -<a href="https://www.apache.org/">The Apache Software Foundation</a>. -All rights reserved.</p> - </div> - </div> - </footer> - </body> +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8.1 from src\site\apt/examples\encoding.apt.vm at 2020-08-05 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="Franz Allan See +Karl Heinz Marbaise" /> + <meta name="Date-Creation-yyyymmdd" content="20160513" /> + <meta name="Date-Revision-yyyymmdd" content="20200805" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Apache Maven Resources Plugin – Specifying a character encoding scheme</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../../../images/apache-maven-project.png" alt="Apache Maven Resources Plugin"/></a></div> + <div class="pull-right"><a href="../../../" id="bannerRight"><img src="../../../images/maven-logo-black-on-white.png" alt=""/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> + <li class=""><a href="../index.html" title="Apache Maven Resources Plugin">Apache Maven Resources Plugin</a><span class="divider">/</span></li> + <li class="active ">Specifying a character encoding scheme <a href="https://github.com/apache/maven-resources-plugin/tree/maven-resources-plugin-3.2.0/src\site\apt/examples\encoding.apt.vm"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2020-08-05</li> + <li id="projectVersion" class="pull-right">Version: 3.2.0</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Overview</li> + <li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li> + <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> + <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li> + <li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li> + <li class="nav-header">Examples</li> + <li class="active"><a href="#"><span class="none"></span>Specifying a character encoding scheme</a></li> + <li><a href="../examples/resource-directory.html" title="Specifying resource directories"><span class="none"></span>Specifying resource directories</a></li> + <li><a href="../examples/filter.html" title="Filtering"><span class="none"></span>Filtering</a></li> + <li><a href="../examples/filtering-properties-files.html" title="Filtering properties files"><span class="none"></span>Filtering properties files</a></li> + <li><a href="../examples/include-exclude.html" title="Including and excluding files and directories"><span class="none"></span>Including and excluding files and directories</a></li> + <li><a href="../examples/escape-filtering.html" title="Escape Filtering"><span class="none"></span>Escape Filtering</a></li> + <li><a href="../examples/copy-resources.html" title="Copy Resources"><span class="none"></span>Copy Resources</a></li> + <li><a href="../examples/binaries-filtering.html" title="Binaries Filtering"><span class="none"></span>Binaries Filtering</a></li> + <li><a href="../examples/custom-resource-filters.html" title="Custom Resources Filters"><span class="none"></span>Custom Resources Filters</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search" method="get" > + <input value="maven.apache.org/plugins/maven-resources-plugin/" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject" class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2><a name="Specifying_a_character_encoding_scheme"></a>Specifying a character encoding scheme</h2> +<p>A character encoding scheme such as <tt>ASCII</tt>, <tt>UTF-8</tt> or <tt>UTF-16</tt> can be chosen to be used for the reading and writing of files.</p> +<p>The best practice is to <a class="externalLink" href="https://maven.apache.org/general.html#encoding-warning">define encoding</a> for copying filtered resources via the property <tt>${project.build.sourceEncoding}</tt> which should be defined in the pom properties section like this:</p> +<div class="source"><pre class="prettyprint linenums"><project ...> + ... + <properties> + <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> + ... + </properties> + .. +</project> +</pre></div> +<p>By using the above property <tt>maven-resources-plugin</tt> will automatically use this <a href="../resources-mojo.html#encoding">encoding</a>.</p> +<p>Occasionally you need to change the encoding explicitly for different purposes. This can be done by defining the encoding via the configuration like this: </p> +<div class="source"><pre class="prettyprint linenums"><project> + ... + <build> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-resources-plugin</artifactId> + <version>3.2.0</version> + <configuration> + ... + <encoding>UTF-8</encoding> + ... + </configuration> + </plugin> + </plugins> + ... + </build> + ... +</project> +</pre></div></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2001–2020 +<a href="https://www.apache.org/">The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> </html> \ No newline at end of file
Modified: maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/escape-filtering.html ============================================================================== --- maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/escape-filtering.html (original) +++ maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/escape-filtering.html Wed Aug 5 15:33:50 2020 @@ -1,153 +1,155 @@ -<!DOCTYPE html> -<!-- - | Generated by Apache Maven Doxia Site Renderer 1.8 from src/site/apt/examples/escape-filtering.apt.vm at 2018-04-23 - | Rendered using Apache Maven Fluido Skin 1.7 ---> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> - <head> - <meta charset="UTF-8" /> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="author" content="Olivier Lamy" /> - <meta name="Date-Creation-yyyymmdd" content="20080905" /> - <meta name="Date-Revision-yyyymmdd" content="20180423" /> - <meta http-equiv="Content-Language" content="en" /> - <title>Apache Maven Resources Plugin – Escape Filtering</title> - <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> - <link rel="stylesheet" href="../css/site.css" /> - <link rel="stylesheet" href="../css/print.css" media="print" /> - <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> - <!-- Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-140879-1']); - _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - </head> - <body class="topBarDisabled"> - <div class="container-fluid"> - <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../../../images/apache-maven-project.png" alt="Apache Maven Resources Plugin"/></a></div> - <div class="pull-right"><a href="../../../" id="bannerRight"><img src="../../../images/maven-logo-black-on-white.png" alt=""/></a></div> - <div class="clear"><hr/></div> - </div> - - <div id="breadcrumbs"> - <ul class="breadcrumb"> - <li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> - <li class=""><a href="../../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class=""><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> - <li class=""><a href="../index.html" title="Apache Maven Resources Plugin">Apache Maven Resources Plugin</a><span class="divider">/</span></li> - <li class="active ">Escape Filtering</li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2018-04-23</li> - <li id="projectVersion" class="pull-right">Version: 3.1.0</li> - </ul> - </div> - <div class="row-fluid"> - <div id="leftColumn" class="span2"> - <div class="well sidebar-nav"> - <ul class="nav nav-list"> - <li class="nav-header">Overview</li> - <li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li> - <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> - <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li> - <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> - <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li> - <li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li> - <li class="nav-header">Examples</li> - <li><a href="../examples/encoding.html" title="Specifying a character encoding scheme"><span class="none"></span>Specifying a character encoding scheme</a></li> - <li><a href="../examples/resource-directory.html" title="Specifying resource directories"><span class="none"></span>Specifying resource directories</a></li> - <li><a href="../examples/filter.html" title="Filtering"><span class="none"></span>Filtering</a></li> - <li><a href="../examples/include-exclude.html" title="Including and excluding files and directories"><span class="none"></span>Including and excluding files and directories</a></li> - <li class="active"><a href="#"><span class="none"></span>Escape Filtering</a></li> - <li><a href="../examples/copy-resources.html" title="Copy Resources"><span class="none"></span>Copy Resources</a></li> - <li><a href="../examples/binaries-filtering.html" title="Binaries Filtering"><span class="none"></span>Binaries Filtering</a></li> - <li><a href="../examples/custom-resource-filters.html" title="Custom Resources Filters"><span class="none"></span>Custom Resources Filters</a></li> - <li class="nav-header">Project Documentation</li> - <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> - <li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> - <li class="nav-header">Maven Projects</li> - <li><a href="../../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> - <li><a href="../../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> - <li><a href="../../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> - <li><a href="../../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> - <li><a href="../../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> - <li><a href="../../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> - <li><a href="../../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> - <li><a href="../../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> - <li><a href="../../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> - <li><a href="../../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> - <li><a href="../../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> - <li><a href="../../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> - <li><a href="../../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> - <li><a href="../../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> - <li><a href="../../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> - <li class="nav-header">ASF</li> - <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> - <li><a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> - <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> - <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> -</ul> -<form id="search-form" action="https://www.google.com/search" method="get" > - <input value="$sitesearchValue" name="sitesearch" type="hidden"/> - <input class="search-query" name="q" id="query" type="text" /> -</form> -<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> - <hr /> - <div id="poweredBy"> - <div class="clear"></div> - <div class="clear"></div> - <div id="twitter"> - <a href="https://twitter.com/ASFMavenProject" class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> - <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> - </div> - <div class="clear"></div> - <div class="clear"></div> -<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> - </div> - </div> - </div> - <div id="bodyColumn" class="span10" > -<div class="section"> -<h2><a name="Escape_filtering"></a>Escape filtering</h2> -<p>You can escape filtering with configurable String.</p> -<p>This means expression ${ } and @ @ preceded will replace by the expression : \${java.home} -> ${java.home}.</p> -<p><b>The escapeString will be removed</b></p> -<div class="source"><pre class="prettyprint linenums"><project> - ... - <build> - <plugins> - <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-resources-plugin</artifactId> - <version>3.1.0</version> - <configuration> - ... - <escapeString>\</escapeString> - ... - </configuration> - </plugin> - </plugins> - ... - </build> - ... -</project></pre></div></div> - </div> - </div> - </div> - <hr/> - <footer> - <div class="container-fluid"> - <div class="row-fluid"> - <p>Copyright ©2001–2018 -<a href="https://www.apache.org/">The Apache Software Foundation</a>. -All rights reserved.</p> - </div> - </div> - </footer> - </body> +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8.1 from src\site\apt/examples\escape-filtering.apt.vm at 2020-08-05 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="Olivier Lamy" /> + <meta name="Date-Creation-yyyymmdd" content="20080905" /> + <meta name="Date-Revision-yyyymmdd" content="20200805" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Apache Maven Resources Plugin – Escape Filtering</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../../../images/apache-maven-project.png" alt="Apache Maven Resources Plugin"/></a></div> + <div class="pull-right"><a href="../../../" id="bannerRight"><img src="../../../images/maven-logo-black-on-white.png" alt=""/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> + <li class=""><a href="../index.html" title="Apache Maven Resources Plugin">Apache Maven Resources Plugin</a><span class="divider">/</span></li> + <li class="active ">Escape Filtering <a href="https://github.com/apache/maven-resources-plugin/tree/maven-resources-plugin-3.2.0/src\site\apt/examples\escape-filtering.apt.vm"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2020-08-05</li> + <li id="projectVersion" class="pull-right">Version: 3.2.0</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Overview</li> + <li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li> + <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> + <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li> + <li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li> + <li class="nav-header">Examples</li> + <li><a href="../examples/encoding.html" title="Specifying a character encoding scheme"><span class="none"></span>Specifying a character encoding scheme</a></li> + <li><a href="../examples/resource-directory.html" title="Specifying resource directories"><span class="none"></span>Specifying resource directories</a></li> + <li><a href="../examples/filter.html" title="Filtering"><span class="none"></span>Filtering</a></li> + <li><a href="../examples/filtering-properties-files.html" title="Filtering properties files"><span class="none"></span>Filtering properties files</a></li> + <li><a href="../examples/include-exclude.html" title="Including and excluding files and directories"><span class="none"></span>Including and excluding files and directories</a></li> + <li class="active"><a href="#"><span class="none"></span>Escape Filtering</a></li> + <li><a href="../examples/copy-resources.html" title="Copy Resources"><span class="none"></span>Copy Resources</a></li> + <li><a href="../examples/binaries-filtering.html" title="Binaries Filtering"><span class="none"></span>Binaries Filtering</a></li> + <li><a href="../examples/custom-resource-filters.html" title="Custom Resources Filters"><span class="none"></span>Custom Resources Filters</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search" method="get" > + <input value="maven.apache.org/plugins/maven-resources-plugin/" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject" class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2><a name="Escape_filtering"></a>Escape filtering</h2> +<p>You can escape filtering with configurable String.</p> +<p>This means expression ${ } and @ @ preceded will replace by the expression : \${java.home} -> ${java.home}.</p> +<p><b>The escapeString will be removed</b></p> +<div class="source"><pre class="prettyprint linenums"><project> + ... + <build> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-resources-plugin</artifactId> + <version>3.2.0</version> + <configuration> + ... + <escapeString>\</escapeString> + ... + </configuration> + </plugin> + </plugins> + ... + </build> + ... +</project> +</pre></div></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2001–2020 +<a href="https://www.apache.org/">The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> </html> \ No newline at end of file Modified: maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/filter.html ============================================================================== --- maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/filter.html (original) +++ maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/filter.html Wed Aug 5 15:33:50 2020 @@ -1,220 +1,235 @@ -<!DOCTYPE html> -<!-- - | Generated by Apache Maven Doxia Site Renderer 1.8 from src/site/apt/examples/filter.apt at 2018-04-23 - | Rendered using Apache Maven Fluido Skin 1.7 ---> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> - <head> - <meta charset="UTF-8" /> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="author" content="Franz Allan See" /> - <meta name="Date-Creation-yyyymmdd" content="20080905" /> - <meta name="Date-Revision-yyyymmdd" content="20180423" /> - <meta http-equiv="Content-Language" content="en" /> - <title>Apache Maven Resources Plugin – Filtering</title> - <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> - <link rel="stylesheet" href="../css/site.css" /> - <link rel="stylesheet" href="../css/print.css" media="print" /> - <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> - <!-- Google Analytics --> - <script type="text/javascript"> - var _gaq = _gaq || []; - _gaq.push(['_setAccount', 'UA-140879-1']); - _gaq.push(['_trackPageview']); - (function() { - var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; - ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; - var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); - })(); - </script> - </head> - <body class="topBarDisabled"> - <div class="container-fluid"> - <div id="banner"> - <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../../../images/apache-maven-project.png" alt="Apache Maven Resources Plugin"/></a></div> - <div class="pull-right"><a href="../../../" id="bannerRight"><img src="../../../images/maven-logo-black-on-white.png" alt=""/></a></div> - <div class="clear"><hr/></div> - </div> - - <div id="breadcrumbs"> - <ul class="breadcrumb"> - <li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> - <li class=""><a href="../../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> - <li class=""><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> - <li class=""><a href="../index.html" title="Apache Maven Resources Plugin">Apache Maven Resources Plugin</a><span class="divider">/</span></li> - <li class="active ">Filtering</li> - <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2018-04-23</li> - <li id="projectVersion" class="pull-right">Version: 3.1.0</li> - </ul> - </div> - <div class="row-fluid"> - <div id="leftColumn" class="span2"> - <div class="well sidebar-nav"> - <ul class="nav nav-list"> - <li class="nav-header">Overview</li> - <li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li> - <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> - <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li> - <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> - <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li> - <li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li> - <li class="nav-header">Examples</li> - <li><a href="../examples/encoding.html" title="Specifying a character encoding scheme"><span class="none"></span>Specifying a character encoding scheme</a></li> - <li><a href="../examples/resource-directory.html" title="Specifying resource directories"><span class="none"></span>Specifying resource directories</a></li> - <li class="active"><a href="#"><span class="none"></span>Filtering</a></li> - <li><a href="../examples/include-exclude.html" title="Including and excluding files and directories"><span class="none"></span>Including and excluding files and directories</a></li> - <li><a href="../examples/escape-filtering.html" title="Escape Filtering"><span class="none"></span>Escape Filtering</a></li> - <li><a href="../examples/copy-resources.html" title="Copy Resources"><span class="none"></span>Copy Resources</a></li> - <li><a href="../examples/binaries-filtering.html" title="Binaries Filtering"><span class="none"></span>Binaries Filtering</a></li> - <li><a href="../examples/custom-resource-filters.html" title="Custom Resources Filters"><span class="none"></span>Custom Resources Filters</a></li> - <li class="nav-header">Project Documentation</li> - <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> - <li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> - <li class="nav-header">Maven Projects</li> - <li><a href="../../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> - <li><a href="../../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> - <li><a href="../../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> - <li><a href="../../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> - <li><a href="../../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> - <li><a href="../../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> - <li><a href="../../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> - <li><a href="../../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> - <li><a href="../../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> - <li><a href="../../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> - <li><a href="../../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> - <li><a href="../../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> - <li><a href="../../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> - <li><a href="../../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> - <li><a href="../../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> - <li class="nav-header">ASF</li> - <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> - <li><a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> - <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> - <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> -</ul> -<form id="search-form" action="https://www.google.com/search" method="get" > - <input value="$sitesearchValue" name="sitesearch" type="hidden"/> - <input class="search-query" name="q" id="query" type="text" /> -</form> -<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> - <hr /> - <div id="poweredBy"> - <div class="clear"></div> - <div class="clear"></div> - <div id="twitter"> - <a href="https://twitter.com/ASFMavenProject" class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> - <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> - </div> - <div class="clear"></div> - <div class="clear"></div> -<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> - </div> - </div> - </div> - <div id="bodyColumn" class="span10" > -<div class="section"> -<h2><a name="Filtering"></a>Filtering</h2> -<p>Variables can be included in your resources. These variables, denoted by the <tt>${...}</tt> delimiters, can come from the system properties, your project properties, from your filter resources and from the command line.</p> -<p>For example, if we have a resource <tt>src/main/resources/hello.txt</tt> containing</p> -<div class="source"><pre class="prettyprint linenums">Hello ${name}</pre></div> -<p>And a POM like this</p> -<div class="source"><pre class="prettyprint linenums"><project> - ... - <name>My Resources Plugin Practice Project</name> - ... - <build> - ... - <resources> - <resource> - <directory>src/main/resources</directory> - </resource> - ... - </resources> - ... - </build> - ... -</project></pre></div> -<p>Upon calling</p> -<div class="source"><pre class="prettyprint linenums">mvn resources:resources</pre></div> -<p>This will create a resource output in <tt>target/classes/hello.txt</tt> which contains exactly the same text.</p> -<div class="source"><pre class="prettyprint linenums">Hello ${name}</pre></div> -<p>However, if we add a <tt><filtering></tt> tag to our POM and set it to <tt>true</tt> like this:</p> -<div class="source"><pre class="prettyprint linenums"> ... - <resource> - <directory>src/main/resources</directory> - <filtering>true</filtering> - </resource> - ...</pre></div> -<p>Our <tt>target/classes/hello.txt</tt> after calling</p> -<div class="source"><pre class="prettyprint linenums">mvn resources:resources</pre></div> -<p>would be</p> -<div class="source"><pre class="prettyprint linenums">Hello My Resources Plugin Practice Project</pre></div> -<p>That's because the name variable was replaced by the value of the project's name (which was specified in the POM).</p> -<p>Moreover, we can also assign values through the command line using the "-D" option. For example, to change the value for the variable <tt>name</tt> to "world", we can simply invoke this command:</p> -<div class="source"><pre class="prettyprint linenums">mvn resources:resources -Dname="world"</pre></div> -<p>And the output in <tt>target/classes/hello.txt</tt> would be</p> -<div class="source"><pre class="prettyprint linenums">Hello world</pre></div> -<p>Furthermore, we are not limited to use pre-defined project variables. We can specify our own variables and their values in the <tt><properties></tt> element. For example, if we want to change the variable from "name" to "your.name", we can do so by adding a <tt><your.name></tt> element within the <tt><properties></tt> element.</p> -<div class="source"><pre class="prettyprint linenums"><project> - ... - <properties> - <your.name>world</your.name> - </properties> - ... -</project></pre></div> -<p>But to organize your project, you may want to put all your variables and their values in a separate file so that you will not have to rewrite your POM, or set their values all the time with every build. This can be done by adding a filter.</p> -<div class="source"><pre class="prettyprint linenums"><project> - ... - <name>My Resources Plugin Practice Project</name> - ... - <build> - ... - <filters> - <filter>[a filter property]</filter> - </filters> - ... - </build> - ... -</project></pre></div> -<p>For example, we can separate "your.name" from the POM by specifying a filter file <tt>my-filter-values.properties</tt> containing:</p> -<div class="source"><pre class="prettyprint linenums">your.name = world</pre></div> -<p>and adding that to our POM</p> -<div class="source"><pre class="prettyprint linenums"> ... - <filters> - <filter>my-filter-values.properties</filter> - </filters> - ...</pre></div> -<p><b>Warning:</b> Do not filter files with binary content like images! This will most likely result in corrupt output. </p> -<p>If you have both text files and binary files as resources it is recommended to have two separated folders. One folder <tt>src/main/resources</tt> (default) for the resources which are not filtered and another folder <tt>src/main/resources-filtered</tt> for the resources which are filtered.</p> -<div class="source"><pre class="prettyprint linenums"><project> - ... - <build> - ... - <resources> - <resource> - <directory>src/main/resources-filtered</directory> - <filtering>true</filtering> - </resource> - ... - </resources> - ... - </build> - ... -</project></pre></div> -<p>Now you can put those files into <tt>src/main/resources</tt> which should not filtered and the other files into <tt>src/main/resources-filtered</tt>.</p> -<p>As already mentioned filtering binary files like images,pdf`s etc. could result in corrupted output. To prevent such problems you can <a href="./binaries-filtering.html">configure file extensions</a> which will not being filtered. </p></div> - </div> - </div> - </div> - <hr/> - <footer> - <div class="container-fluid"> - <div class="row-fluid"> - <p>Copyright ©2001–2018 -<a href="https://www.apache.org/">The Apache Software Foundation</a>. -All rights reserved.</p> - </div> - </div> - </footer> - </body> +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8.1 from src\site\apt/examples\filter.apt at 2020-08-05 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="Franz Allan See" /> + <meta name="Date-Creation-yyyymmdd" content="20080905" /> + <meta name="Date-Revision-yyyymmdd" content="20200805" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Apache Maven Resources Plugin – Filtering</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../../../images/apache-maven-project.png" alt="Apache Maven Resources Plugin"/></a></div> + <div class="pull-right"><a href="../../../" id="bannerRight"><img src="../../../images/maven-logo-black-on-white.png" alt=""/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> + <li class=""><a href="../index.html" title="Apache Maven Resources Plugin">Apache Maven Resources Plugin</a><span class="divider">/</span></li> + <li class="active ">Filtering <a href="https://github.com/apache/maven-resources-plugin/tree/maven-resources-plugin-3.2.0/src\site\apt/examples\filter.apt"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2020-08-05</li> + <li id="projectVersion" class="pull-right">Version: 3.2.0</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Overview</li> + <li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li> + <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> + <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li> + <li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li> + <li class="nav-header">Examples</li> + <li><a href="../examples/encoding.html" title="Specifying a character encoding scheme"><span class="none"></span>Specifying a character encoding scheme</a></li> + <li><a href="../examples/resource-directory.html" title="Specifying resource directories"><span class="none"></span>Specifying resource directories</a></li> + <li class="active"><a href="#"><span class="none"></span>Filtering</a></li> + <li><a href="../examples/filtering-properties-files.html" title="Filtering properties files"><span class="none"></span>Filtering properties files</a></li> + <li><a href="../examples/include-exclude.html" title="Including and excluding files and directories"><span class="none"></span>Including and excluding files and directories</a></li> + <li><a href="../examples/escape-filtering.html" title="Escape Filtering"><span class="none"></span>Escape Filtering</a></li> + <li><a href="../examples/copy-resources.html" title="Copy Resources"><span class="none"></span>Copy Resources</a></li> + <li><a href="../examples/binaries-filtering.html" title="Binaries Filtering"><span class="none"></span>Binaries Filtering</a></li> + <li><a href="../examples/custom-resource-filters.html" title="Custom Resources Filters"><span class="none"></span>Custom Resources Filters</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search" method="get" > + <input value="maven.apache.org/plugins/maven-resources-plugin/" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject" class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2><a name="Filtering"></a>Filtering</h2> +<p>Variables can be included in your resources. These variables, denoted by the <tt>${...}</tt> delimiters, can come from the system properties, your project properties, from your filter resources and from the command line.</p> +<p>For example, if we have a resource <tt>src/main/resources/hello.txt</tt> containing</p> +<div class="source"><pre class="prettyprint linenums">Hello ${name} +</pre></div> +<p>And a POM like this</p> +<div class="source"><pre class="prettyprint linenums"><project> + ... + <name>My Resources Plugin Practice Project</name> + ... + <build> + ... + <resources> + <resource> + <directory>src/main/resources</directory> + </resource> + ... + </resources> + ... + </build> + ... +</project> +</pre></div> +<p>Upon calling</p> +<div class="source"><pre class="prettyprint linenums">mvn resources:resources +</pre></div> +<p>This will create a resource output in <tt>target/classes/hello.txt</tt> which contains exactly the same text.</p> +<div class="source"><pre class="prettyprint linenums">Hello ${name} +</pre></div> +<p>However, if we add a <tt><filtering></tt> tag to our POM and set it to <tt>true</tt> like this:</p> +<div class="source"><pre class="prettyprint linenums"> ... + <resource> + <directory>src/main/resources</directory> + <filtering>true</filtering> + </resource> + ... +</pre></div> +<p>Our <tt>target/classes/hello.txt</tt> after calling</p> +<div class="source"><pre class="prettyprint linenums">mvn resources:resources +</pre></div> +<p>would be</p> +<div class="source"><pre class="prettyprint linenums">Hello My Resources Plugin Practice Project +</pre></div> +<p>That's because the name variable was replaced by the value of the project's name (which was specified in the POM).</p> +<p>Moreover, we can also assign values through the command line using the "-D" option. For example, to change the value for the variable <tt>name</tt> to "world", we can simply invoke this command:</p> +<div class="source"><pre class="prettyprint linenums">mvn resources:resources -Dname="world" +</pre></div> +<p>And the output in <tt>target/classes/hello.txt</tt> would be</p> +<div class="source"><pre class="prettyprint linenums">Hello world +</pre></div> +<p>Furthermore, we are not limited to use pre-defined project variables. We can specify our own variables and their values in the <tt><properties></tt> element. For example, if we want to change the variable from "name" to "your.name", we can do so by adding a <tt><your.name></tt> element within the <tt><properties></tt> element.</p> +<div class="source"><pre class="prettyprint linenums"><project> + ... + <properties> + <your.name>world</your.name> + </properties> + ... +</project> +</pre></div> +<p>But to organize your project, you may want to put all your variables and their values in a separate file so that you will not have to rewrite your POM, or set their values all the time with every build. This can be done by adding a filter.</p> +<div class="source"><pre class="prettyprint linenums"><project> + ... + <name>My Resources Plugin Practice Project</name> + ... + <build> + ... + <filters> + <filter>[a filter property]</filter> + </filters> + ... + </build> + ... +</project> +</pre></div> +<p>For example, we can separate "your.name" from the POM by specifying a filter file <tt>my-filter-values.properties</tt> containing:</p> +<div class="source"><pre class="prettyprint linenums">your.name = world +</pre></div> +<p>and adding that to our POM</p> +<div class="source"><pre class="prettyprint linenums"> ... + <filters> + <filter>my-filter-values.properties</filter> + </filters> + ... +</pre></div> +<p><b>Warning:</b> Do not filter files with binary content like images! This will most likely result in corrupt output. </p> +<p>If you have both text files and binary files as resources it is recommended to have two separated folders. One folder <tt>src/main/resources</tt> (default) for the resources which are not filtered and another folder <tt>src/main/resources-filtered</tt> for the resources which are filtered.</p> +<div class="source"><pre class="prettyprint linenums"><project> + ... + <build> + ... + <resources> + <resource> + <directory>src/main/resources-filtered</directory> + <filtering>true</filtering> + </resource> + ... + </resources> + ... + </build> + ... +</project> +</pre></div> +<p>Now you can put those files into <tt>src/main/resources</tt> which should not filtered and the other files into <tt>src/main/resources-filtered</tt>.</p> +<p>As already mentioned filtering binary files like images,pdf`s etc. could result in corrupted output. To prevent such problems you can <a href="./binaries-filtering.html">configure file extensions</a> which will not being filtered. </p></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2001–2020 +<a href="https://www.apache.org/">The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> </html> \ No newline at end of file Added: maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/filtering-properties-files.html ============================================================================== --- maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/filtering-properties-files.html (added) +++ maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/filtering-properties-files.html Wed Aug 5 15:33:50 2020 @@ -0,0 +1,169 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.8.1 from src\site\apt/examples\filtering-properties-files.apt.vm at 2020-08-05 + | Rendered using Apache Maven Fluido Skin 1.7 +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta name="author" content="Dennis Lundberg" /> + <meta name="Date-Creation-yyyymmdd" content="20200716" /> + <meta name="Date-Revision-yyyymmdd" content="20200805" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Apache Maven Resources Plugin – Filtering Properties Files</title> + <link rel="stylesheet" href="../css/apache-maven-fluido-1.7.min.css" /> + <link rel="stylesheet" href="../css/site.css" /> + <link rel="stylesheet" href="../css/print.css" media="print" /> + <script type="text/javascript" src="../js/apache-maven-fluido-1.7.min.js"></script> + <!-- Google Analytics --> + <script type="text/javascript"> + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-140879-1']); + _gaq.push(['_trackPageview']); + (function() { + var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; + ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; + var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); + })(); + </script> + </head> + <body class="topBarDisabled"> + <div class="container-fluid"> + <div id="banner"> + <div class="pull-left"><a href="https://www.apache.org/" id="bannerLeft"><img src="../../../images/apache-maven-project.png" alt="Apache Maven Resources Plugin"/></a></div> + <div class="pull-right"><a href="../../../" id="bannerRight"><img src="../../../images/maven-logo-black-on-white.png" alt=""/></a></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li class=""><a href="https://www.apache.org/" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li> + <li class=""><a href="../../../index.html" title="Maven">Maven</a><span class="divider">/</span></li> + <li class=""><a href="../../index.html" title="Plugins">Plugins</a><span class="divider">/</span></li> + <li class=""><a href="../index.html" title="Apache Maven Resources Plugin">Apache Maven Resources Plugin</a><span class="divider">/</span></li> + <li class="active ">Filtering Properties Files <a href="https://github.com/apache/maven-resources-plugin/tree/maven-resources-plugin-3.2.0/src\site\apt/examples\filtering-properties-files.apt.vm"><img src="../images/accessories-text-editor.png" title="Edit" /></a></li> + <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2020-08-05</li> + <li id="projectVersion" class="pull-right">Version: 3.2.0</li> + </ul> + </div> + <div class="row-fluid"> + <div id="leftColumn" class="span2"> + <div class="well sidebar-nav"> + <ul class="nav nav-list"> + <li class="nav-header">Overview</li> + <li><a href="../index.html" title="Introduction"><span class="none"></span>Introduction</a></li> + <li><a href="../plugin-info.html" title="Goals"><span class="none"></span>Goals</a></li> + <li><a href="../usage.html" title="Usage"><span class="none"></span>Usage</a></li> + <li><a href="../faq.html" title="FAQ"><span class="none"></span>FAQ</a></li> + <li><a href="http://www.apache.org/licenses/" class="externalLink" title="License"><span class="none"></span>License</a></li> + <li><a href="../download.html" title="Download"><span class="none"></span>Download</a></li> + <li class="nav-header">Examples</li> + <li><a href="../examples/encoding.html" title="Specifying a character encoding scheme"><span class="none"></span>Specifying a character encoding scheme</a></li> + <li><a href="../examples/resource-directory.html" title="Specifying resource directories"><span class="none"></span>Specifying resource directories</a></li> + <li><a href="../examples/filter.html" title="Filtering"><span class="none"></span>Filtering</a></li> + <li class="active"><a href="#"><span class="none"></span>Filtering properties files</a></li> + <li><a href="../examples/include-exclude.html" title="Including and excluding files and directories"><span class="none"></span>Including and excluding files and directories</a></li> + <li><a href="../examples/escape-filtering.html" title="Escape Filtering"><span class="none"></span>Escape Filtering</a></li> + <li><a href="../examples/copy-resources.html" title="Copy Resources"><span class="none"></span>Copy Resources</a></li> + <li><a href="../examples/binaries-filtering.html" title="Binaries Filtering"><span class="none"></span>Binaries Filtering</a></li> + <li><a href="../examples/custom-resource-filters.html" title="Custom Resources Filters"><span class="none"></span>Custom Resources Filters</a></li> + <li class="nav-header">Project Documentation</li> + <li><a href="../project-info.html" title="Project Information"><span class="icon-chevron-right"></span>Project Information</a></li> + <li><a href="../project-reports.html" title="Project Reports"><span class="icon-chevron-right"></span>Project Reports</a></li> + <li class="nav-header">Maven Projects</li> + <li><a href="../../../archetype/index.html" title="Archetype"><span class="none"></span>Archetype</a></li> + <li><a href="../../../resolver/index.html" title="Artifact Resolver"><span class="none"></span>Artifact Resolver</a></li> + <li><a href="../../../doxia/index.html" title="Doxia"><span class="none"></span>Doxia</a></li> + <li><a href="../../../jxr/index.html" title="JXR"><span class="none"></span>JXR</a></li> + <li><a href="../../../ref/current" title="Maven"><span class="none"></span>Maven</a></li> + <li><a href="../../../pom/index.html" title="Parent POMs"><span class="none"></span>Parent POMs</a></li> + <li><a href="../../index.html" title="Plugins"><span class="none"></span>Plugins</a></li> + <li><a href="../../../plugin-testing/index.html" title="Plugin Testing"><span class="none"></span>Plugin Testing</a></li> + <li><a href="../../../plugin-tools/index.html" title="Plugin Tools"><span class="none"></span>Plugin Tools</a></li> + <li><a href="../../../apache-resource-bundles/index.html" title="Resource Bundles"><span class="none"></span>Resource Bundles</a></li> + <li><a href="../../../scm/index.html" title="SCM"><span class="none"></span>SCM</a></li> + <li><a href="../../../shared/index.html" title="Shared Components"><span class="none"></span>Shared Components</a></li> + <li><a href="../../../skins/index.html" title="Skins"><span class="none"></span>Skins</a></li> + <li><a href="../../../surefire/index.html" title="Surefire"><span class="none"></span>Surefire</a></li> + <li><a href="../../../wagon/index.html" title="Wagon"><span class="none"></span>Wagon</a></li> + <li class="nav-header">ASF</li> + <li><a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works"><span class="none"></span>How Apache Works</a></li> + <li><a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation"><span class="none"></span>Foundation</a></li> + <li><a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache"><span class="none"></span>Sponsoring Apache</a></li> + <li><a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks"><span class="none"></span>Thanks</a></li> +</ul> +<form id="search-form" action="https://www.google.com/search" method="get" > + <input value="maven.apache.org/plugins/maven-resources-plugin/" name="sitesearch" type="hidden"/> + <input class="search-query" name="q" id="query" type="text" /> +</form> +<script type="text/javascript">asyncJs( 'https://cse.google.com/brand?form=search-form' )</script> + <hr /> + <div id="poweredBy"> + <div class="clear"></div> + <div class="clear"></div> + <div id="twitter"> + <a href="https://twitter.com/ASFMavenProject" class="twitter-follow-button" data-show-count="false" data-align="left" data-size="medium" data-show-screen-name="true" data-lang="en">Follow ASFMavenProject</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </div> + <div class="clear"></div> + <div class="clear"></div> +<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" /></a> + </div> + </div> + </div> + <div id="bodyColumn" class="span10" > +<div class="section"> +<h2><a name="Filtering_Properties_Files"></a>Filtering Properties Files</h2> +<p>When filtering resources, special care has to be taken if you are filtering properties files. If your filtered properties files include non-ascii characters and your <tt>project.build.sourceEncoding</tt> is set to anything other than ISO-8859-1 you might be affected and should continue reading.</p> +<div class="section"> +<h3><a name="What_has_project.build.sourceEncoding_got_to_do_with_resources.3F"></a>What has <tt>project.build.sourceEncoding</tt> got to do with resources?</h3> +<p>Maven Resources Plugin has, up until version 3.2.0, defaulted to use <tt>project.build.sourceEncoding</tt> as the encoding when filtering resources, unless you configure the <tt>encoding</tt> parameter of the plugin explicitly. So unless you have configured the <tt>encoding</tt> parameter in Maven Resources Plugin explicitly this is what you get.</p></div> +<div class="section"> +<h3><a name="Properties_files_handled_by_the_Properties_class"></a>Properties files handled by the <tt>Properties</tt> class</h3> +<p>When the Properties class is used to read and write properties files they require that the properties files use ISO-8859-1 encoding. This is still the case for Java 11, as can be seen in the <a class="externalLink" href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Properties.html">API documentation for the Properties class</a>. So, properties files that are used in this way needs to use ISO-8859-1 encoding.</p></div> +<div class="section"> +<h3><a name="Properties_files_used_as_ResourceBundle"></a>Properties files used as <tt>ResourceBundle</tt></h3> +<p>When properties files are used as <tt>ResourceBundle</tt>s the encoding required differs between versions of Java. Up to and including Java 8 these files are required to use ISO-8859-1 encoding.</p> +<p>Starting with Java 9 the preferred encoding is UTF-8 for property resource bundles. It might work with ISO-8859-1, but as you can see in the <a class="externalLink" href="https://docs.oracle.com/javase/9/intl/internationalization-enhancements-jdk-9.htm#JSINT-GUID-5ED91AA9-B2E3-4E05-8E99-6A009D2B36AF">Internationalization Enhancements in JDK 9</a> documentation you should consider converting your property resource bundles into UTF-8 encoding.</p></div> +<div class="section"> +<h3><a name="What_do_I_need_to_do.3F"></a>What do I need to do?</h3> +<p>You need to do 2 things:</p> +<ol style="list-style-type: decimal"> +<li>Decide which encoding to use for properties files, based on how you use them in your project.</li> +<li>Explicitly configure Maven Resource Plugin accordingly using the <tt>propertiesEncoding</tt> configuration parameter, that was introduced in version 3.2.0. In most cases it would look like this: +<div class="source"><pre class="prettyprint linenums"><project> + ... + <build> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-resources-plugin</artifactId> + <version>3.2.0</version> + <configuration> + ... + <propertiesEncoding>ISO-8859-1</propertiesEncoding> + ... + </configuration> + </plugin> + </plugins> + ... + </build> + ... +</project> +</pre></div></li></ol></div></div> + </div> + </div> + </div> + <hr/> + <footer> + <div class="container-fluid"> + <div class="row-fluid"> + <p>Copyright ©2001–2020 +<a href="https://www.apache.org/">The Apache Software Foundation</a>. +All rights reserved.</p> + </div> + </div> + </footer> + </body> +</html> \ No newline at end of file Propchange: maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/filtering-properties-files.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: maven/website/components/plugins-archives/maven-resources-plugin-LATEST/examples/filtering-properties-files.html ------------------------------------------------------------------------------ svn:keywords = Author Date Id Revision