Maven-Site in Gradle

Question

Gibt es ein Plugin in Gradle, die Maven Site ähnliche Sache generieren kann? Es wäre großartig, wenn es mit der aktuellen Maven Site Apt Formatdatei kompatibel wäre.

Answer 1

Es scheint, dass es zwei Plugins gibt, this und this. Der erste war vor vier Jahren begangen worden, ich weiß nichts über den zweiten. Es scheint also, dass diese Plugins nicht hilfreich sein werden.

Answer 2

Ich schrieb nur einen Teil von Gradle Fury. Das primäre Plugin (es ist wirklich nur eine Sammlung von Skripten) für Gradle-Fury ist es, viele der großen Mängel beim Publishing, Android-Zeug, Pom-Zeug, etc. zu verbessern/zu beheben. Da gibt es so ziemlich keinen Standard Weg für die meisten In grandle stauen wir die meisten dieser Konfigurationen in der Datei gradle.properties. Das heißt, das Site-Plugin hängt von diesen Einstellungen ab, um die Site korrekt zu stilisieren.

Kurz gesagt, zu einem Projekt anwenden ... diese Datei in Ihrem Stamm build.gradle setzen apply from 'https://raw.githubusercontent.com/gradle-fury/gradle-fury/master/gradle/site.gradle'

Nächstes bearbeiten Sie Ihre gradle.properties Datei und verwenden Sie diesen Link als Vorlage für Ihre pom Einstellungen. ... https://github.com/gradle-fury/gradle-fury/blob/master/gradle.properties

Erstellen Sie ein Verzeichnis src/site/.

Machen Sie eine src/site/index.md Datei als Ihre Startseite

Copy/Klon folgenden Dateien/Ordner aus https://github.com/gradle-fury/gradle-fury/tree/master/src/site

• css
• Bilder
• img
• js
• template.html

Schließlich, bauen Sie die Website mit gradlew site. Standardausgabe ist rootDir/build/site

mag nicht die Art, wie es aussieht? (Es sieht wie das Apache-Fluido-Theme aus dem Maven-Site-Plugin aus). Bearbeiten Sie einfach template.html, um Ihre Anforderungen zu erfüllen.

Ich arbeite derzeit an einem Mechanismus, um das Site-Plugin zu bootstrappen, das einige dieser Schritte entfernt, aber das ist, was es gerade ist. Weitere Informationen und komplette Feature-Liste ist unter wiki

Eine letzte Notiz, sollte gradlew site nach all Ihren Aufgaben zu überprüfen, aber es ist nicht verkabelt, um davon abhängig zu sein. Grundsätzlich sollte alles, was Berichte für Ihre Module erzeugt, vor der Site ausgeführt werden, da sie in das Site-Paket aggregiert wird, einschließlich Javadocs und vielem mehr. Der Rest der Fury-Skripte helfen, einen Großteil der schmerzhaften Konfigurationsschritte zu automatisieren. Auschecken lohnt sich (siehe die Qualität und Maven-Support-Plugins)

Haftungsausschluss: Ich bin einer der Autoren.

Edit: Website Vorschau: http://gradle-fury.github.io/gradle-fury/

Edit: Wir haben gerade eine aktualisierte Version geschnitten, die manuelle Erstellung von src/site und alle Kopier-/Klon Aufgaben aus dem Master-Repo überflüssig macht.Führen Sie einfach gradlew site während Internet verbunden ist und es den Rest für Sie tun wird.