JavaDoc Android-приложения открывает Android SDK Javadoc в 4 подкадрах вместо 1. Есть ли способ исправить это?

Question

Обновление: теперь я добавил скриншоты, так как я больше не считается спамботом.

Очевидно, я не могу публиковать скриншоты как часть "механизма предотвращения спама" в StackOverflow, поэтому вам придется бороться с описаниями ...

Когда вы генерируете JavaDoc с "-linkoffline <a href="http://java.sun.com/javase/6/docs/api/" rel="nofollow noreferrer">http://java.sun.com/javase/6/docs/api/</a> <a href="http://java.sun.com/javase/6/docs/api/" rel="nofollow noreferrer">http://java.sun.com/javase/6/docs/api/</a>", он создает красивые ссылки, которые открывают только описание класса внутри вашего правого фрейма - то же поведение, что и при нажатии ссылки на один из ваших собственных классов.

Все МОЙ Классы, перечисленные в левом фрейме, Подробная информация о выбранном классе в правом фрейме (т.е. java.lang.Object)

Когда вы генерируете JavaDoc с "-linkoffline <a href="http://d.android.com/reference" rel="nofollow noreferrer">http://d.android.com/reference</a> C:\Android\android-sdk\docs\reference", если щелкнуть ссылку, чтобы сказать «Объект», вместо того, чтобы просто открыть класс «Объект» в правом фрейме, он откроет страницу с 4 подкадрами внутри вашего правого фрейма.

Все MY Классы, перечисленные в левом фрейме, 4 субкадра в правом фрейме: заголовок для разработчиков Android (вверху), со списком пакетов (слева вверху), списком классов (слева внизу) и сведениями о выбранный класс, т.е. java.lang.Object (справа)

Есть ли способ связать JavaDoc вашего приложения с Android SDK JavaDoc, чтобы он действительно выглядел красиво и как один сплоченный JavaDoc? то есть синий и имеет стандартный 2-кадровый интерфейс (например, документацию Sun JDK и документацию, сгенерированную пользователем по умолчанию?

Answer 1

Я думаю, что проблема здесь в том, что то, что выглядит как глубокая ссылка на ссылку на Android, например http://developer.android.com/reference/android/content/res/XmlResourceParser.html (в качестве примера), на самом деле является не только документацией этого класса, но и фактически содержит то, что выглядит как разные кадры со ссылками на другие пакеты. На самом деле это списки в исходном коде HTML, стилизованные под CSS и JavaScript тоже выглядят как отдельные фреймы:

Вот конец списка пакетов и начало списка классов в одном пакете:

 ...
 <a href="/reference/org/xml/sax/helpers/package-summary.html">org.xml.sax.helpers</a></li>
    <li class="api apilevel-1">
  <a href="/reference/org/xmlpull/v1/package-summary.html">org.xmlpull.v1</a></li>
    <li class="api apilevel-1">
  <a href="/reference/org/xmlpull/v1/sax2/package-summary.html">org.xmlpull.v1.sax2</a></li>
              </ul><br/>
            </div> <!-- end packages -->
          </div> <!-- end resize-packages -->
          <div id="classes-nav">
            <ul>

    <li><h2>Interfaces</h2>
      <ul>
          <li class="selected api apilevel-1"><a href="/reference/android/content/res/XmlResourceParser.html">XmlResourceParser</a></li>
      </ul>
    </li>

    <li><h2>Classes</h2>
      <ul>
          <li class="api apilevel-1"><a href="/reference/android/content/res/AssetFileDescriptor.html">AssetFileDescriptor</a></li>
          <li class="api apilevel-3"><a href="/reference/android/content/res/AssetFileDescriptor.AutoCloseInputStream.html">AssetFileDescriptor.AutoCloseInputStream</a></li>
 ...

Действительно важная часть находится в <div class="g-unit" id="doc-content">, который идет после этих навигационных элементов.

Так что, я полагаю, вы могли бы использовать некоторый Javascript, чтобы скрыть все остальные элементы div и показать только этот. Или, наоборот, показать эти ссылки в верхнем фрейме вместо текущего.

Там может быть какая-то измененная версия Javadoc, которая выпускает документацию, аналогичную (и совместимую с) справочником по Android, но я не знаю, где.