diff options
| author | Dmitry Jemerov <intelliyole@gmail.com> | 2015-07-13 18:00:53 +0200 |
|---|---|---|
| committer | Dmitry Jemerov <intelliyole@gmail.com> | 2015-07-13 18:00:53 +0200 |
| commit | dfa23a3ff1b15570102d4431b7bfc709efa16a52 (patch) | |
| tree | 81311a3d7806aaa4f2533ee9f60f0486f63e67de /README.md | |
| parent | 6d1a526ae3cabd89565ff898f00f72f565efa36f (diff) | |
| parent | 513af27ac95939e659d337b02d94b096bad7d970 (diff) | |
| download | dokka-dfa23a3ff1b15570102d4431b7bfc709efa16a52.tar.gz dokka-dfa23a3ff1b15570102d4431b7bfc709efa16a52.tar.bz2 dokka-dfa23a3ff1b15570102d4431b7bfc709efa16a52.zip | |
Merge pull request #28 from cy6erGn0m/maven-plugin
Maven plugin
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 69 |
1 files changed, 69 insertions, 0 deletions
@@ -85,3 +85,72 @@ KDoc is a flavour of markdown with symbol processing extensions. * $name - link to `name` (Kotlin string interpolation style), or ${java.lang.String} for longer references * $name: - named section, optionally bound to symbol `name`, e.g. param doc * ${code reference} -- include content of a symbol denoted by reference, e.g. code example + +### Building + +Build only dokka + +```bash +ant fatjar +``` + +Build dokka and maven plugin + +```bash +ant install-fj +cd maven-plugin +mvn install +``` + +Build dokka and install maven plugin (do not require maven installed) +```bash +ant build-and-install +``` + +### Using Maven plugin + +Minimal maven configuration is + +```xml +<plugin> + <groupId>org.jetbrains.dokka</groupId> + <artifactId>dokka-maven-plugin</artifactId> + <version>${dokka.version}</version> + <executions> + <execution> + <phase>pre-site</phase> + <goals> + <goal>dokka</goal> + </goals> + </execution> + </executions> +</plugin> +``` + +by default files will be generated in `target/dokka` + +Configuring source links mapping + +```xml +<plugin> + <groupId>org.jetbrains.dokka</groupId> + <artifactId>dokka-maven-plugin</artifactId> + <version>${dokka.version}</version> + <executions> + <execution> + <phase>pre-site</phase> + <goals> + <goal>dokka</goal> + </goals> + </execution> + </executions> + <configuration> + <sourceLinks> + <link> + <dir>${project.basedir}/src/main/kotlin</dir> + <url>http://github.com/me/myrepo</url> + </link> + </sourceLinks> + </configuration> +</plugin> +```
\ No newline at end of file |