Копирайте javadocs от сайт за документи в локален zip файл

Чудя се дали има някакъв инструмент за "изтегляне" на javadocs от онлайн хост в локален файл.

Онлайн документите, които използвам, са склонни да отхвърлят клиенти като eclipse, което затруднява работата, така че трябва да ги изтегля на моята машина и да ги прикрепя към библиотечния буркан.


person Luke Dowell    schedule 06.07.2011    source източник


Отговори (3)


  1. Първо се уверете, че вече не предлагат изтегляне в zip форма или подобен.

  2. След това се уверете, че наистина ви е позволено да направите това (това може да зависи от това къде живеете и от всички условия, споменати на уеб сайта, откъдето искате да изтеглите това).

  3. След това разгледайте инструмента Wget. Той е част от системата GNU, поради което е включен в много дистрибуции на Linux, но също така е наличен за Windows и Mac, предполагам.

Нещо подобно работи за мен:

wget --no-parent --recursive --level inf --page-requisites --wait=1 \
   https://epaul.github.io/jsch-documentation/simple.javadoc/

(без прекъсването на реда; тук трябва да се екранира с обратната наклонена черта \).

Вижте какво прави всяка опция в ръководството, преди да опитате това.

Ако искате да правите това многократно, разгледайте опцията --mirror. За изтегляне на други уебсайтове --convert-links също може да бъде полезен, но открих, че не е необходим за Javadocs, които обикновено имат правилните абсолютни и относителни връзки.

Това изтегля много от едно и също копие на index.html файла с добавени ?... имена (за връзките РАМКИ на всяка страница). Можете да премахнете тези файлове след изтегляне, като добавите опцията --reject 'index.html\?*', но те пак ще бъдат изтеглени първи (и проверени за рекурсивни връзки). Все още не разбрах как изобщо да избегна изтеглянето им. (Вижте този свързан въпрос относно Serverfault.)

Може би добавянето на правилното ниво на рекурсия ще помогне тук (не опитах).

След изтеглянето може да искате да компресирате получената директория, за да заемете по-малко място на диска. Използвайте инструмента за цип по ваш избор за това.

person Paŭlo Ebermann    schedule 07.07.2011
comment
Благодаря ви много, това е страхотен инструмент. От известно време се оглеждам за нещо подобно. Благодаря отново. :) - person Luke Dowell; 10.07.2011
comment
Потвърдено за работа на Windows. Изтеглете тук: gnuwin32.sourceforge.net/packages/wget.htm - person Aleksandr Dubinsky; 25.01.2014
comment
За да изключите index.html?... дубликатите, вече можете да използвате --reject-regex, започвайки с wget 1.14: wget --reject-regex='index.html\?(.*)' ... - person Alexander Klimetschek; 11.02.2014

В този случай ... направете свои собствени javadocs!

Първо се нуждаете от източника. Към момента на писане Java 8 JDK идва с zip файл, наречен src.zip. Понякога по необясними причини Oracle не винаги включва източника. Така че за някои по-стари версии (и кой знае за бъдещето) трябва да се сдобиете с източника на Java по друг начин. Също така си струва да знаете, че в миналото Oracle понякога е включвал изходния код с версията на JDK за Linux, но не и с тази за Windows.

Току-що разархивирах този файл... горните директории са "com", "java", "javax", "launcher" и "org". Инструментът за стартиране на директории не съдържа файлове за документиране.

Можете да генерирате javadocs много много просто от всеки или всички от тях чрез компактдиск в командния ред/терминал в директорията ...\src. Тогава тръгвай

javadoc -d docs -Xmaxwarns 10 -Xmaxerrs 10 -Xdoclint:none -sourcepath. -подпакети java:javax:org:com

NB имайте предвид, че има "." след -sourcepath

Просто като това. Генерирането на ваши собствени javadocs също има огромното предимство, че знаете, че те са точно правилните javadocs за JDK, който използвате във вашата система.

Същото важи и за документирането на всички Java .jars (с изходния код), които използвате. Въпреки това, всички версии на повечето буркани ще бъдат намерени с тяхната документация, достъпна за изтегляне от Maven Central http://search.maven.org...

person mike rodent    schedule 31.08.2016
comment
Страхотно предложение. Благодаря! Ако някой прави това с JDK 7, опцията -Xdoclint трябва да бъде премахната. - person G. Stevens; 11.08.2017

За изтегляне на най-новата документация на Java (jdk-8u77) API

Отидете до http://www.oracle.com/technetwork/java/javase/downloads/index.html

Под Ресурси за добавяне и Под документация за Java SE 8
Щракнете върху бутона Изтегляне

Под Java SE Development Kit 8 Документация > Java SE Development Kit 8u77 Документация

Приемете лицензионното споразумение и щракнете върху zip файла за изтегляне

Разархивирайте изтегления файл Стартирайте API документите от jdk-8u77-docs-all\docs\api\index.html

За изтегляне на API за други версии на Java изпълнете следните стъпки.

Отидете до http://docs.oracle.com/javase/

От падащото меню Release изберете Java SE 7/6/5

В съответната страница на JAVA SE и в менюто отляво за изтегляния щракнете върху JDK 7/6/5 документация или Java SE документация

Сега на следващата страница изберете подходящата документация на Java SE Development Kit 7uXX.

Приемете лицензионното споразумение и щракнете върху Изтегляне на zip файл

Разархивирайте файла и стартирайте API документите от
jdk-7uXX-docs-all\docs\api\index.html

person vinsinraw    schedule 08.04.2016
comment
Не работи за Java SE 6 - просто препраща към страницата за изтегляне на Java SE 8 [:-( - person user85421; 13.04.2016