आर्टिफैक्ट के लिए बाहरी जावाडोक वेबसाइट को संलग्न करने के लिए m2e (ग्रहण के लिए मेवेन प्लगइन) को कैसे संकेत दें?

Question

मुझे आर्टिफैक्ट एक्स का उपयोग करने की आवश्यकता है जिसमें न तो स्रोत और न ही जावाडोक कलाकृतियों उपलब्ध हैं। हालांकि, मुझे पता है कि एक बाहरी वेब सर्वर जहां एक्स के लिए जावाडोक प्रचारित किया गया है।

में "सादे" ग्रहण मैं निर्माण रास्ते में एक जार के लिए जावाडोक स्थान के रूप में एक यूआरएल संलग्न कर सकते हैं, और फिर शिफ्ट - F2 कि URL पर कोई ब्राउज़र को खोलता है।

मैं एम 2 ई मैवेन सेंट्रल से कलाकृतियों को बदले बिना आर्टिफैक्ट एक्स के लिए स्वचालित रूप से ऐसा करना चाहता हूं।

नमूना यह दिखा pom.xml:

<?xml version="1.0" encoding="UTF-8"?> 
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 
    <modelVersion>4.0.0</modelVersion> 
    <groupId>foo</groupId> 
    <artifactId>m2e-javadoc</artifactId> 
    <version>0.0.1-SNAPSHOT</version> 

    <properties> 
     <project.build.sourceEncoding>ASCII</project.build.sourceEncoding> 
    </properties> 

    <dependencies> 
     <dependency> 
      <groupId>net.sf.jt400</groupId> 
      <artifactId>jt400-full</artifactId> 
      <version>5.0</version> 
     </dependency> 
    </dependencies> 

</project> 

मैं इस बात का संकेत मिलता है कैसे?

---

संपादित करें: कुछ स्थानीय भंडार में लापता कलाकृतियों को स्थापित करने और परियोजना होने पर देने प्रयोगों के बाद एक Maven रिलीज करते हैं, मैं: प्रश्न http://dev.eclipse.org/mhonarc/lists/m2e-users/msg02386.html

---

संपादित करें पर m2e मेलिंग सूची पर कहा गया है नवीनतम संस्करण (7.10) को मैवेन सेंट्रल में दोबारा बनाया गया।

Answer 1

दुर्भाग्य से यह काम नहीं करेगा अगर निर्माता ने विशेष कलाकृतियों के लिए उचित कलाकृतियों (स्रोतों और -जावाडोक) नहीं बनाए हैं। लेकिन आप किसी विशेष आर्टिफैक्ट के लिए मैन्युअल रूप से जावाडोक जोड़ सकते हैं। मैं एक अलग पैकेज (आर्टिफैक्ट-जावाडोक) बनाने का सुझाव दूंगा और इसे अपने रिपोजिटरी मैनेजर को स्वचालित रूप से काम करने की तुलना में तैनात करूँगा।

Answer 2

आप अपने पोम बढ़ाने से this scenario के लिए Maven Javadoc Plugin उपयोग कर सकते हैं:

आप मानकों का प्रयोग करके बाहरी परियोजनाओं के लिए पार संदर्भ लिंक जोड़ सकते हैं। उदाहरण के लिए:

<project> 
    ... 
    <reporting> (or <build>) 
    <plugins> 
     <plugin> 
     <groupId>org.apache.maven.plugins</groupId> 
     <artifactId>maven-javadoc-plugin</artifactId> 
     <version>2.8.1</version> 
     <configuration> 
      <links> 
      <link>http://commons.apache.org/dbcp/apidocs/</link> 
      <link>http://commons.apache.org/fileupload/apidocs/</link> 
      </links> 
      ... 
     </configuration> 
     </plugin> 
    </plugins> 
    </reporting> (or </build>) 
    ... 
</project> 

महत्वपूर्ण नोट: जावाडोक विनिर्देशों के अनुसार, सभी को देखते हुए लिंक एक fetchable/पैकेज-सूची फ़ाइल होनी चाहिए।

इस रणनीति आगे के रूप में वांछित एक ही प्रलेखन पेड़ में अपने दस्तावेज़ को मजबूत करने के <offlineLinks/> पैरामीटर और aggregate goal का उपयोग करके संवर्धित किया जा सकता।

documentation for Maven Javadoc Plugin वैकल्पिक जवाडोक सुविधाओं से जुड़े अतिरिक्त परिदृश्य और उदाहरण प्रदान करता है, क्या आप उन्हें भी आगे बढ़ाना चाहते हैं।