스칼라로 놀기 시작한 이래로 Java API와 관련하여 큰 질문이있었습니다. 오라클은 왜 same old HTML 페이지를 "프레임 세트"태그로 유지하고 검색 기능을 전혀 사용하지 않습니까? 그들은 웹 2.0에 그것을 만들지 않은 것처럼 보입니다 ...자바 API 인터페이스
Scala API documentation 반면 웹 기록에서 가장 좋은 웹 사이트는 아니지만 몇 가지 더 유용합니다.
어쨌든 더 중요한 인터페이스가있는 Java API 설명서가있는 이유를 알고있는 사람이 있으면 알려 주시기 바랍니다.
최근 Java 7의 경우 JavaDoc이 향상되어 사용자 지정 CSS를 사용할 수 있습니다. 첫 번째 결과는 http://download.java.net/jdk7/docs/api/입니다. 작업이 계속되고 새로운 업데이트가 나올 때마다 더 많은 것을 볼 수있을 것이라고 생각합니다. 나는 ScalaDoc이 더 뛰어나다는데 동의하지만 그들은 15 년의 유산을 다룰 필요가 없었다.
괜찮아요, 그래서 그들은 CSS를 추가했습니다. 위대한 것이지만 유용성을 향상시키지 못합니다. 내 관점에서 주요한 문제입니다. – seb
제가 말한 것처럼 - 그들에게 시간을주세요 :) –
항상 (최소한, 1.2 같은) 자바 독 대한 스타일 정의합니다 (['-stylesheetfile' 옵션]을 참조 (http://download.oracle.com/javase/6/docs/technotes/tools/solaris/javadoc.html를 사용하는 방법 보낸 #stylesheetfile)). 어쩌면 지금은 HTML 출력을 더 쉽게 스타일화할 수 있도록 변경했습니다. –
Javadocs는 해당 형식의 출력을 제공하며 그 주소에서 게시됩니다. 아무도 실제로 개선의 필요성을 알지 못했지만 이제는 재미있는 측면 프로젝트로 언급됩니다. 나는 "더 좋은"인터페이스가 있었지만 행운이 없었는지를 찾기 위해 인터넷 검색을했다.
javadoc을 다시 생성하려면 javadoc -h를 실행하여 추가 옵션을 사용할 수 있습니다. 흥미로운 것들 중 하나는 커스텀 헤더/푸터 (header/footer)를 제공하고 소스에 연결하는 것입니다.
HTML 페이지는 Javadoc 도구를 사용하여 작성되었습니다.이 도구는 Java로 문서를 작성하는 표준 방법입니다.
더 나은 형식의 API가있는 다른 웹 페이지가 있는지 모르겠지만 무엇이든지 도움이되고 IDE와 SDK를 사용하고 있다면 대부분의 소스 코드를 볼 수 있습니다. 거기에 파일.
의 JavaDoc은 최소 공통 분모로 설계 하였다. 사실상 모든 웹 브라우저는 JavaScript를 지원하지 않아도이를 표시 할 수 있습니다.
빠른 액세스 및 검색 기능을 원하는 경우 Eclipse와 같은 IDE 내에서 JavaDoc에 액세스 할 수 있습니다.
예, 간단히 말해서 ** 충분하다고 생각합니다 **.나는 정말로 검색 기능이 필요 없다. –
[Java 7 API Docs] (http://download.java.net/jdk7/docs/api/)는 약간 다르게 보입니다 ... 그러나 개선의 여지가 있다는 것에 동의합니다. Scaladoc 2의 첫 번째 버전의 강한 저항이 있었다 –
하는 것으로 -, 정직하게, 그것은 자바 독 같은 Scaladoc보다 열등하기 때문이다. 그것은 쓸모있어지기 전에 꽤 반복적이었고 최근에는보기 흉하지 않은 CSS를 얻었습니다. –
같은 종류의 질문이 여기에 질문 : http://stackoverflow.com/questions/1026553/are-there-some-good-and-modern-alternatives-to-javadoc – paradigmatic