Group Abstract Group Abstract

Message Boards Message Boards

1
|
6.6K Views
|
4 Replies
|
6 Total Likes
View groups...
Share
Share this post:

[Resolved] Paclet's Custom Documentation Not Searchable

Posted 2 years ago
POSTED BY: Jeffery Henning
4 Replies

Hi Jeff,

This sounds like a known bug in the PacletDocumentationBuild incremental re-build logic; a fix is in the works, but for now a workaround is possible.

The issue is that when an incremental documentation build is done, search index data is only created for files that have changed since the last build. If no files have changed, then the search index will be empty. (You observed that the search index files exist, but it's likely that they're empty.) If you delete your build output directory, then call PacletBuild exactly once, a full rebuild will be done, and consequently the built paclet will have documentation search index data for all doc files. If you install that built .paclet file, documentation search and symbol lookup should work as expected.

I'll update this thread again once a fix has been released.

POSTED BY: Connor Gray

Hi again Jeff,

This bug is now fixed properly, and the fix was released as a dynamic paclet update yesterday, as PacletTools v13.2.1.1.

To ensure you have the latest version, evaluate:

PacletInstall["PacletTools"]

And verify that the resulting PacletObject says "Version: 13.2.1.1".

Note: You may need to restart your Kernel session for the new update to become visible.

Please let me know if you run into any issues with the update.

Thanks,

Connor

POSTED BY: Connor Gray

That did it. I also had a minor error in my Overview page that I was ignoring as inconsequential. That may have been derailing the indexing. I removed the Overview page and it's all indexing properly. Now to fix that issue.

Thanks for the tip.

Jeff

POSTED BY: Jeffery Henning

I'll give that a try. I was always using a two-step process to build the docs and then build the paclet. I'll try it all in one go. Thanks.

POSTED BY: Jeffery Henning
Reply to this discussion
Community posts can be styled and formatted using the Markdown syntax.
Reply Preview
Attachments
Remove
or Discard