Skip to content

Commit 098c984

Browse files
committed
Doc
1 parent 70b4951 commit 098c984

File tree

1 file changed

+52
-39
lines changed

1 file changed

+52
-39
lines changed

README.md

+52-39
Original file line numberDiff line numberDiff line change
@@ -10,51 +10,64 @@ There is a running example [here](https://github.com/tomasbjerre/git-changelog-m
1010

1111
Have a look at the [pom.xml](https://github.com/tomasbjerre/git-changelog-maven-plugin/blob/master/git-changelog-maven-plugin-example/pom.xml) where you will find some more examples.
1212

13-
Here is and example that will generate a CHANGELOG.md.
13+
Here is and example that will generate a CHANGELOG.md when running `mvn generate-resources`.
1414

1515
```xml
1616
<build>
1717
<plugins>
18-
<plugin>
19-
<groupId>se.bjurr.gitchangelog</groupId>
20-
<artifactId>git-changelog-maven-plugin</artifactId>
21-
<version>X</version>
22-
<executions>
23-
<execution>
24-
<id>GenerateGitChangelog</id>
25-
<phase>generate-sources</phase>
26-
<goals>
27-
<goal>git-changelog</goal>
28-
</goals>
29-
<configuration>
30-
<!-- A file on filesystem //-->
31-
<file>CHANGELOG.md</file>
32-
33-
<!-- Or post to MediaWiki //-->
34-
<mediaWikiUsername>tomas</mediaWikiUsername>
35-
<mediaWikiPassword>tomaskod</mediaWikiPassword>
36-
<mediaWikiUrl>http://localhost/mediawiki</mediaWikiUrl>
37-
<mediaWikiTitle>Tomas Title</mediaWikiTitle>
38-
</configuration>
39-
</execution>
40-
</executions>
41-
</plugin>
42-
</plugins>
43-
</build>
44-
```
18+
<plugin>
19+
<groupId>se.bjurr.gitchangelog</groupId>
20+
<artifactId>git-changelog-maven-plugin</artifactId>
21+
<version>${changelog}</version>
22+
<executions>
23+
<execution>
24+
<id>GenerateGitChangelog</id>
25+
<phase>generate-sources</phase>
26+
<goals>
27+
<goal>git-changelog</goal>
28+
</goals>
29+
<configuration>
30+
<templateContent>
31+
<![CDATA[
32+
# Changelog
33+
Changelog of My Project.
4534
46-
To generate changelog, just run:
47-
```
48-
mvn generate-sources
49-
```
35+
{{#tags}}
36+
## {{name}}
37+
{{#issues}}
38+
{{#hasIssue}}
39+
{{#hasLink}}
40+
### {{name}} [{{issue}}]({{link}}) {{title}} {{#hasIssueType}} *{{issueType}}* {{/hasIssueType}} {{#hasLabels}} {{#labels}} *{{.}}* {{/labels}} {{/hasLabels}}
41+
{{/hasLink}}
42+
{{^hasLink}}
43+
### {{name}} {{issue}} {{title}} {{#hasIssueType}} *{{issueType}}* {{/hasIssueType}} {{#hasLabels}} {{#labels}} *{{.}}* {{/labels}} {{/hasLabels}}
44+
{{/hasLink}}
45+
{{/hasIssue}}
46+
{{^hasIssue}}
47+
### {{name}}
48+
{{/hasIssue}}
5049
51-
More documentation can be found in the [Git Changelog Lib](https://github.com/tomasbjerre/git-changelog-lib).
50+
{{#commits}}
51+
**{{{messageTitle}}}**
5252
53-
## Developer instructions
53+
{{#messageBodyItems}}
54+
* {{.}}
55+
{{/messageBodyItems}}
5456
55-
To make a release, first run:
56-
```
57-
mvn release:prepare -DperformRelease=true
58-
mvn release:perform
57+
[{{hash}}](https://github.com/{{ownerName}}/{{repoName}}/commit/{{hash}}) {{authorName}} *{{commitTime}}*
58+
59+
{{/commits}}
60+
61+
{{/issues}}
62+
{{/tags}}
63+
]]>
64+
</templateContent>
65+
</configuration>
66+
</execution>
67+
</executions>
68+
</plugin>
69+
</plugins>
70+
</build>
5971
```
60-
Then release the artifact from [staging](https://oss.sonatype.org/#stagingRepositories). More information [here](http://central.sonatype.org/pages/releasing-the-deployment.html).
72+
73+
More documentation can be found in the [Git Changelog Lib](https://github.com/tomasbjerre/git-changelog-lib).

0 commit comments

Comments
 (0)