{Примечание редактора: несколько недель назад мы опубликовали сводку советов Хольгера Вурмана о Инфоцентре Eclipse . Теперь мы рады, что Хольгер является DZone MVB, и на этой неделе будем публиковать его полные статьи в Инфоцентре. Обязательно загляните в блог Хольгера » Затмение» .}
Eclipse Infocenter — это справочная система Eclipse, запущенная в виде веб-приложения. Две из пяти хорошо скрытых особенностей Инфоцентра уже были представлены здесь. После Basic и Bot Mode и Deep Linking здесь идет малоизвестная вещь номер три: Search Links.
Поисковые ссылки — это запросы, которые можно использовать для совместного использования или создания поля ввода поиска в Инфоцентре или за его пределами. Вы можете искать весь контент, одну книгу или одну главу. Для поиска по всему контенту необходимо добавить /index.jsp?tab=search&searchWord=… к базовому адресу Инфоцентра, как в этом примере поиска параметров времени выполнения затмения в онлайн-справке Eclipse Luna . Следующий фрагмент HTML-кода создает поле поиска для справки Luna:
<form action="http://help.eclipse.org/luna/index.jsp"
method="get" accept-charset="utf-8">
<input type="hidden" name="tab" value="search">
<input name="searchWord">
<input type="submit" value="Search">
</form>
Для поиска в книге необходимо использовать параметр toc в дополнение к параметрам tab и searchWord, а также quickSearch = true и
quickSearchType = QuickSearchToc : /index.jsp?tab=search & quickSearch = true & quickSearchType = QuickSearchToc & toc =… & searchWord = … Для того, чтобы получить значение для ТОС параметра, откройте /basic/searchView.jsp?searchWord=-&scopedSearch=true , выберите одну книгу, нажмите Go кнопку и получить значение из области видимости параметра нового URL.
Глава может быть указана с помощью параметра пути: /index.jsp?tab=search&quickSearch=true&quickSearchType=QuickSearchToc&toc=… & path =… & searchWord =… Значение tab является кортежем индексов подглав, начинающихся с 0, разделенных подчеркиванием. Например, path = 0_2 относится к третьей подглаве первой главы верхнего уровня книги, указанной параметром toc .
В дополнение к описанным выше параметрам вы можете использовать дополнительные параметры maxHits и showSearchCategories . Параметр maxHits указывает максимальное количество возвращаемых результатов, а его значения находятся в диапазоне от 1 до 500. Пользовательские настройки Группировать по категориям можно переопределить с помощью showSearchCategories = true или с помощью showSearchCategories = false .
Если вы не пройдете тест Тьюринга из-за того, что вы не человек, вас могут заинтересовать более машиночитаемые результаты поиска в формате XML. Документ XML доступен по адресу / search? Фраза =… и включает в себя также оценку. Фраза параметра равна параметру searchWord, описанному выше. Максимальное количество результатов ограничено 1000 ( maxHits не поддерживается). Результаты поиска XML могут быть легко использованы в сценариях. Например, этот маленький Ant-скрипт находит типичные орфографические ошибки , выполняя запросы для каждого элемента в списке общих орфографических ошибок Википедии . Он находит 131 опечаток в текущей помощи Luna только с очень низким уровнем ложных срабатываний.
Следующие малоизвестные вещи об Инфоцентре Eclipse в моем списке — это информация о переключении языков и отладке . Будьте на связи!