build-helper:site-index
Full name:
com.github.robtimus:build-helper-maven-plugin:1.1.1:site-index
Description:
Generate a Markdown site index based on another Markdown file. This goal will provide the following transformations:
- Add an HTML title.
- Make any link that starts with the project's URL relative to that URL.
- Remove any badges that match any of a set of provided patterns. Badges will be removed if:
- They are preceded by a space. In this case, the leading space is removed as well.
- They are on a line of their own. In this case, the entire line is removed.
Attributes:
- Requires a Maven project to be executed.
- The goal is thread-safe and supports parallel builds.
- Binds by default to the lifecycle phase:
pre-site
.
Required Parameters
Name | Type | Since | Description |
---|---|---|---|
<siteIndexTitle> |
String |
1.0 |
The HTML title to add. Default value is: Overview . |
<sourceFile> |
File |
- |
The source Markdown file. 1.0 Default value is: ${project.basedir}/README.md . |
<targetFile> |
File |
1.0 |
The Markdown site index to generate. Default value is: ${project.basedir}/src/site/markdown/index.md . |
Optional Parameters
Name | Type | Since | Description |
---|---|---|---|
<badgePatterns> |
String[] |
1.0 |
A set of patterns to use to recognize badges, based on the URL. |
<encoding> |
String |
1.0 |
The encoding to use for reading and writing the site index. Default value is: ${project.build.sourceEncoding} . |
<skipSiteIndex> |
boolean |
1.0 |
Set this to true to skip generating a Markdown site index.Default value is: false .User property is: robtimus.site-index.skip . |
Parameter Details
<badgePatterns>
A set of patterns to use to recognize badges, based on the URL.
- Type:
java.lang.String[]
- Since:
1.0
- Required:
No
<encoding>
The encoding to use for reading and writing the site index.
- Type:
java.lang.String
- Since:
1.0
- Required:
No
- Default:
${project.build.sourceEncoding}
<siteIndexTitle>
The HTML title to add.
- Type:
java.lang.String
- Since:
1.0
- Required:
Yes
- Default:
Overview
<skipSiteIndex>
Set this to
true
to skip generating a Markdown site index.- Type:
boolean
- Since:
1.0
- Required:
No
- User Property:
robtimus.site-index.skip
- Default:
false
<sourceFile>
The source Markdown file. 1.0
- Type:
java.io.File
- Required:
Yes
- Default:
${project.basedir}/README.md
<targetFile>
The Markdown site index to generate.
- Type:
java.io.File
- Since:
1.0
- Required:
Yes
- Default:
${project.basedir}/src/site/markdown/index.md