Диагностика индексации ключевых слов справки Mac?

Мне трудно заставить функцию «Справка → Поиск» моего приложения отображать темы, связанные с полезными (и уникальными) ключевыми словами в моем приложении. Появляется только одно ключевое слово.

Предыстория: я создал несколько страниц справки в формате HTML (примеры: index, точность, convert) в подкаталоге моей программы. Если я вызываю основную справку, файл index.html отображается нормально. Оттуда я могу перейти на любую из других тематических страниц.

Проблема. Если я попытаюсь использовать функцию поиска по ключевым словам, появится только "Точность" и пустой индикатор (открывающий index.html). У меня есть другие ключевые слова, такие как «координаты», которые должны указывать на определенную страницу, но не отображаются.

Что я сделал на данный момент: в дополнение к повторному просмотру documentation (что в настоящее время у меня немного затуманено), я прогнал каждую страницу через средство проверки синтаксиса BBEdit. Я также искал в StackOverflow информацию, связанную с проблемой. Поскольку ключевые слова довольно распространены, это было первичный тематический матч, но я далеко за этим.

В журнале индексатора справки отмечается, что он проиндексировал все html-файлы, обнаружив метатеги KEYWORDS и DESCRIPTION в каждом (согласно рекомендациям Справочная книга):

droot.html -- File has KEYWORDS meta tag content being indexed.
gc.html -- File has KEYWORDS meta tag content being indexed.
index.html -- File has KEYWORDS meta tag content being indexed.
droot.html -- File has DESCRIPTION meta tag used for abstract.
gc.html -- File has DESCRIPTION meta tag used for abstract.
index.html -- Finished parsing
droot.html -- Finished parsing
gc.html -- Finished parsing
(etc)

Файл *.helpindex в пакете Release (каталог ?/Contents/Resources/MacFizzyCalcHelp/) имеет размер ~25 КБ. Однако я не знаю, как проверить его содержимое.

Есть мысли о том, что я упустил?


person jim_carson    schedule 15.08.2011    source источник


Ответы (3)


Я нашел следующий пост на сайте поддержки Apple полезным, когда столкнулся с аналогичной проблемой, когда разделы справки в моей справочной книге не отображались с помощью функций поиска:

https://discussions.apple.com/thread/3442044

person Jadent    schedule 25.05.2012
comment
(с опозданием) спасибо за ссылку - кажется, проблема решена. Большое спасибо! - person jim_carson; 09.06.2012

Причин проблем много. Однажды я обнаружил, что в документации для разработчиков Apple есть ошибка (в описании анкоров). Вы зарегистрировали справочную книгу в приложении Info.plist? Содержит ли справочная книга собственный файл информационного списка? Вы можете проверить файл helpindex, используя hiutil< /а>. Я надеюсь, что это поможет вам.

person toohtik    schedule 03.01.2012
comment
Привет, спасибо за предложения. Справочная книга зарегистрирована в файле info.plist приложения, но не содержит собственного отдельного файла info.plist. Создание одного, похоже, не повлияло на основное поведение. Help Indexer/hiutil возвращает те же диагностические данные, что и выше. Еще раз спасибо. - person jim_carson; 19.01.2012

У меня только что возникла проблема с пустой записью в справке Apple, и после нескольких дней попыток все, что я мог придумать, наконец нашел решение. Добавьте META NAME="ROBOTS" CONTENT="NOINDEX" на пустую страницу записи (в моем случае это был index.html, также известный как целевая страница или страница доступа). Затем я повторно проиндексировал HTML-страницы, и вот, пустых записей больше нет. Нет необходимости даже удалять кеш программы просмотра справки.

[Отредактировано, так как теги скрыли содержимое :-]

person Trev    schedule 28.05.2019