[jira] [Commented] (MJAVADOC-699) mathjax based on dependency

[Michael Osipov (Jira)]

    [ 
https://issues.apache.org/jira/browse/MJAVADOC-699?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17446494#comment-17446494
 ] 

Michael Osipov commented on MJAVADOC-699:
-----------------------------------------

I do not really understand what you want from us. Please rephrase your request.

> mathjax based on dependency
> ---------------------------
>
>                 Key: MJAVADOC-699
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-699
>             Project: Maven Javadoc Plugin
>          Issue Type: New Feature
>          Components: javadoc
>    Affects Versions: next-release
>            Reporter: Ernst Reissner
>            Priority: Major
>
> For including math in api docs I use mathjax. 
> To that end i configure the javadoc plugin as follows: 
> {noformat}
>         <additionalOptions>
>           <additionalOption>-Xdoclint:all 
> -Xdoclint:-missing</additionalOption>
>           <additionalOption>--allow-script-in-comments</additionalOption>
>         </additionalOptions>
>         <header>
>           &lt;script type="text/javascript" 
>       
> src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML,https://www.simuline.eu/MathJax/config/myDefault.js"&gt;
>  &lt;/script&gt;
>         </header>
> {noformat}
> you can see that I download the config from 
> {noformat}
> https://www.simuline.eu/MathJax/config/myDefault.js
> {noformat}
> I think this is not what I want to do, because it is public and unversioned. 
> Have a look at 
> https://maven.apache.org/plugins/maven-javadoc-plugin/examples/help-configuration.html
>  describing javadoc plugins concept for helpfiles: 
> it is based on dependencies. 
> This is a quite general solution also other plugins make use of 
> as summarized in https://adangel.org/2016/02/22/sharing-pmd-rulesets/: 
> It is on 
>  -   Checkstyle configuration
>  -   PMD configuration
> -   FindBugs configuration
>  -   Code-Formatting configuration for IDEs
>  -   ...
> My suggestion is to use that also for mathjax config and maybe also for the 
> converter 
> which is http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML 
> in my case but I would also prefer a local solution with specified version 
> (in my case 'latest'). 



--
This message was sent by Atlassian Jira
(v8.20.1#820001)