問題タブ [doxia]

アプリケーション開発の一環として、Maven サイト プラグインを使用してドキュメントを作成しています。apt ファイルは にありますsrc/site/apt。{{xxx}} 構文を使用して apt でリンクを作成できることは知っていますが、Java ファイルおよび/またはパッケージへのリンクを作成する簡単な方法があるかどうか疑問に思っていましたか?

相対パス (例: ../../main/java/com/pkg/MyFile.java) を使用する唯一の方法はありますか?

パッケージ名にリンクする方法はありますか?

(doxia-module-markdown)[http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-markdown] を使用して Maven サイトを作成し、.md ファイルにアンパサンド付きのリンクがあると、結果としてエラーメッセージで。例.md:

エラーメッセージ： [ERROR] Failed to execute goal org.apache.maven.plugins:maven-site-plugin:3.3:site (default-site) on project test: Error during page generation: Error parsing 'xxx\projects\test\src\site\markdown\not_working.md': line [3] Error parsing the model: entity reference name can not contain character =' (position: TEXT seen ...<a href="https://www.google.com/?gws_rd=cr&q=... @3:57) -> [Help 1]

アンパサンドを削除するとすぐにエラーが消えます。

私はプロジェクトサイトを生成しています

Linkcheck はレポート プラグインとして有効化されています

コードは Java です。

クラス ファイルのコメント ヘッダーには、StackOverflow の質問へのリンクが含まれています。

サイト生成のリンク チェック フェーズ中に、次のような警告が表示されます。

「Cookieが拒否されました：不正なドメイン属性」に関する他のSOの質問をすでに見ました。この aswerによると、問題は私の側にあるのではなく、送信が許可されていない Cookie を設定しているのは StackOverflow と GitHub であり、基になる http ライブラリがmaven-linkcheck-pluginそれを教えてくれます。この動作は、RFC 2109で指定されているとおりです。

リンクされた質問は回避策を提供します:httpclient基本的に、私は悪いクッキーを気にしない、ギミギミギミと言うクッキーポリシーを設定します。非準拠のサーバーを許容する必要があるため、Cookie ガイドに記載されているブラウザー互換 Cookie 仕様を使用する必要があります。

私の質問は次のとおりです。私は ではなく で作業してhttpclientいるため、これらの Cookie 警告を取り除くにはmaven何を入力すればよいですか? pom.xml私は何か有用なものを見つけました

• maven-linkcheck-plugin ドキュメント
• Doxia LinkCheck ドキュメント(Maven プラグインは Doxia を使用)
• この Doxia JIRA クエリは、背景情報として興味深い読み物ですが、Maven ソリューションはまだありません

マークダウン用の Doxia プラグインを使用しており、画像を追加したい

次に、リソースを追加します。

それから私の章で私は書きました：

しかし、何も起こりませんか？この画像はターゲット パスにあります。マークダウンでパスを指定するには?

Mavenで生成されたサイトでMarkdownを使用しています。魅力のように機能します。私の知る限り、プラグインは内部でFlexmarkを使用しており、 Admonition extensionsをサポートしています。

私たちもそれらを使用したいと考えています。インフォボックスはドキュメンテーションに非常に役立ちます。のサイト構成は次のpom.xmlようになります。

追加のマークダウンを認識するように構成するにはどうすればよいでしょうか?