Диагностика справки по ключевым словам Mac? - PullRequest
9 голосов
/ 15 августа 2011

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

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

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

Что я сделал до сих пор: В дополнение к пересмотру документации (которая в настоящее время яя немного туповат), я проверил каждую страницу через проверку синтаксиса 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 КБ.Я не знаю, как проверить его содержимое.

Есть мысли о том, что мне не хватает?

Ответы [ 3 ]

1 голос
/ 25 мая 2012

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

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

1 голос
/ 29 мая 2019

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

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

1 голос
/ 03 января 2012

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

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...