問題タブ [doclet]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
java - javadoc doclavaドックレットをgradleで動作させる方法
Javaプラグインを使用してgradleでプロジェクトを構築していますが、 doclava docletを使用してjavadocも構築したいと考えています
モジュールのbuild.gradleの関連部分は次のとおりです
./gradlew javadoc を実行すると、このエラーが発生します
Gradleでdoclavaを動作させることができる人はいますか?
maven - maven-javadoc-plugin が中央リポジトリを上書きする
Maven Javadoc プラグインとカスタム ドックレットに問題があります。
私はmaven-javadoc-plugin v 2.10.1と、基本的にmaven jarプロジェクトであるカスタムドックレットを使用しています。
リポジトリをカスタム成果物にsettings.xml
定義するもあります。central
問題は、maven-javadoc-plugin を実行するたびに、カスタム ドックレットの依存関係を から解決しようとすることhttps://repo.maven.apache.org/maven2
です。ドックレット自体は、カスタム アーティファクトから解決されます。
デバッグ出力も非常に奇妙で、central
リポジトリは私のカスタム スナップショット アーティファクトであると表示されます。
maven-jar-plugin が のリポジトリを上書きするようにロックします。https://repo.maven.apache.org/maven2
snapshot
central
settings.xml
リポジトリmaven-jar-plugin
を上書きしないようにするにはどうすればよいですか。central
デバッグ ログは次のようになります。
30000 文字しかないため、いくつかのスタック トレースと、できれば不要なデバッグ ログをカットする必要があります。
これは、maven-javadoc-plugin の構成を持つ親 POM です。
更新:これが私のものですsettings.xml
この問題で私を助けてくれる人がいることを願っています。
よろしく
javadoc - クラス、パッケージのカスタマイズされたjavadocを生成するにはどうすればよいですか?
クラス、パッケージのカスタマイズされたjavadocを生成するにはどうすればよいですか?
maven-pdf-plugin と pdfdoclet を使用して多くの方法を試しましたが、失敗したか、間違った方法でやりましたか? アドバイスをいただけますか?またはいくつかのガイド、いくつかのチュートリアル?...
前もって感謝します
java - カスタム javadoc の生成に問題があります。「ドックレットが見つかりません」
を使用してカスタム Javadoc ジェネレーターを作成Doclet
しようとしていますが、いくつかの問題が発生しています。
私は公式ドキュメントに従っていますが、最初はプロジェクトにファイルを含めるのに問題がありましたtools.jar
が、なんとか修正しました。
私の問題は、このコマンドを実行した後...
...私はメッセージを受け取っています...
javadoc: エラー - ドックレット クラス ListClass が見つかりません
私が言ったように、私は主に公式ドキュメントのチュートリアルに従ってきましたが、参照用のコードは次のとおりです。
ListClass.java
:
そしてMyClass.java
:
だから私が求めているのは、なぜ私が上に投稿したエラーが発生するのかということです. 誰かがどのようにDoclet
機能するかのより包括的なガイドを提供できれば、それも素晴らしいでしょう.
注: プロジェクトに IntelliJ IDE を使用しています。これが私のディレクトリ構造です:
- 。考え
- ...
- アウト
- ...
- ソース
- ListClass.java
- MyClass.java
- JavadocGenerator.iml
jax-rs - Swagger UI が JAX-RS リソースの間違ったステータス コードを表示する
私は非常に単純な削除方法を持っています:
ご覧のとおり、JavaDoc タグを使用して、成功とエラーの応答コードを指定しました。メソッド内で、コンテンツなしの応答 (ステータス コード 204) を作成します。これは、swagger-doclet が生成するものです。
これまでのところ、うまくいっています。成功とエラーの応答コードを含む JavaDoc タグが必要です。また、メソッドのreturn文からとったと思われる「Response」型もあります。Swagger UI を開くと、次のビューが表示されます。
上部に「応答クラス (ステータス 200)」が表示されます。「応答クラス」は正しいですが、「ステータス 200」は間違っています。このメソッドのどこにもステータス コード 200 (OK) が返されません。この出力を修正する有効な解決策が見つかりませんでした。
私が使用するもの:
- Java 8
- Maven 3.3.9
- ドロップウィザード 0.9.2
- org.apache.maven.plugins.maven-javadoc-plugin 2.10.3
- com.tenxerconsulting.swagger-doclet 1.1.3
試してみたい場合は、完全なプロジェクトが GitHub にあります: https://github.com/McPringle/moodini
正しい Swagger API ドキュメントを入手できれば、本当に素晴らしいことです。どんな助けでも大歓迎です。
どうもありがとうございました!
maven - カスタム Javadoc ドックレットを Maven でパッケージ化する
独自の Java ドックレットを作成し、後で使用するために単一の jar ファイルにパッケージ化したいと考えています。
現在、これらの設定でmavenを使用して生成しています:
問題:
すべてが適切に jar にパッケージ化されていますが、ソースがありません。
簡単なmvn package
ことをしようとすると、sun パッケージが存在しないことがわかります。
エラー: パッケージ com.sun.javadoc が存在しません
最後の部分が、jar でソースを見つけることができない主な理由だと思います。したがって、私の質問は、maven にそれらのインポートを無視するように指示する方法です。