Kontaktní osoba:
Ing. Jiří Pinkas
Mobil: +420 774 912 047

Maven site plugin


publikováno: 8.8.2013

Určitě jste už u nějakého projektu viděli takový web:

Maven site plugin

Takové weby jsou vytvořené pomocí Maven site pluginu. Jak ho použít? Přidejte do pom.xml dovnitř tagu <plugins>:

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-site-plugin</artifactId>
  <version>3.3</version>
</plugin>

Dále spusťte Váš Maven projekt:

mvn site:site

Tímto vytvoříte v adresáři target/site Váš web.

Vzhled webu a informace na něm můžete opravdu hodně extenzivně změnit. Více na domovských stránkách pluginu: http://maven.apache.org/plugins/maven-site-plugin/

edit: Právě jsem dokončil jeden takový velice jednoduchý web: http://jsitemapgenerator.jiripinkas.cz/ Jak na to?

  1. Na stránce http://maven.apache.org/plugins/maven-site-plugin/examples/creating-content.html je popsáno, že v projektu by měl být soubor /src/site/site.xml, který má následující syntax: http://maven.apache.org/xsd/decoration-1.3.0.xsd a jeho ukázka je zde: http://maven.apache.org/doxia/doxia-sitetools/doxia-decoration-model/decoration.html (pozor! V současnosti verze 1.4.0 jako je na ukázce neexistuje, ale verze 1.3.0 funguje perfektně).
  2. Poté je třeba vytvořit vlastní stránky s vlastním obsahem jako je např. index.html. Ty se vytvářejí v jednom ze tří formátů: APT, FML, XDOC, mě nejvíc přirostl k srdci XDOC, který je popsán na této stránce: http://maven.apache.org/doxia/references/xdoc-format.html. Takový soubor se pak v projektu nachází na následujícím umístění: src/site/xdoc/index.html
  3. Další vlastní stránky kromě index.html se musí zapojit v site.xml. Toto a víc je popsáno zde: http://maven.apache.org/plugins/maven-site-plugin/examples/sitedescriptor.html
  4. Je možné do stránky přidat automaticky generované reporty jako je javadoc a kód pro Maven/Ivy/Gradle atd. Jak na to je popsáno zde: http://maven.apache.org/plugins/maven-site-plugin/examples/configuring-reports.html
  5. Maven site plugin toho umí daleko víc, vše je popsáno v dokumentaci, ale čtení dokumentace dá relativně dost práce než se v tom člověk zorientuje, pak je to ale velice jednoduché a logické.




comments powered by Disqus


Reference

" Co dodat? Byl to super kurz. Pěkné pochopitelné příklady k vybrané problematice. Rychlost školitele optimální, vše se dalo pěkně stíhat. Pokud účastníkk nevěděl nebo udělal chybu a nevěděl, tak školitel " podrobnosti ...

Michal

" S kurzem jsem byl maximálně spokojen. Na přednášejícím bylo vidět, že ví o čem mluví a dokázal zaujmout, i v případě neporozumění ochotně pomohl a danému člověku problém osvětlil. Rozhodně " podrobnosti ...

Josef

Embedit

" Java kurz byl pro mě velmi přínosný. Jiří je skvělý školitel, který dělá přesně to, co ho baví a na přístupu to bylo každý den velmi znát. Školení bych doporučil " podrobnosti ...

Filip


Novinky

Nové datum vydání Java 9: 21.9.2017

Mark Reinhold aktualizoval datum GA (General Availability) Java 9 na 21.9.2017. více ...

Juergen Hoeller v Brně (jeden z autorů Spring frameworku)! 15.3.2017

15.3.2017, 18:00, Brno, Smetanova 19. Nutná rezervace místa! více ...

Bilance Java školení 2016

Co se mi (ne)povedlo v roce 2016 a plány na rok 2017 více ...

Oracle se prý v roce 2017 zaměří na vynucení Java licencí a pokutování zákazníků

Jak nedostat od Oracle pokutu za komerční použití Javy? více ...

Java DB (Derby) a Visual VM nebudou součástí Java JDK 9

Změny v Java JDK 9 více ...

Java VisualVM (jvisualvm) je nyní na GitHubu

více ...