The KHelpCenter is the central place to access the KDE program handbooks. It also offers an option to index all these data to quickly search through them. However, currently this is done on a per-user base and is offered as a dialog once the KHelpCenter is started the first time.
In larger deployments with several users per machine/server or where you have central login servers you might not want your central server to do the same task again and again, for each new user. Therefore it makes sense to a) pre-compile the data and b) configure all your KDE users to access a central directory.
The first task can be accomplished by starting the index process manually and let it write to a system-directory:
khc_docbookdig.pl --indexdir=$SYSTEMDIR --docpath=khelpcenter:kde_application_manuals --identifier=kde_application_manuals
$SYSTEMDIR must be replaced with your preferred system directory which is for example on a NFS/Samba server.
Now the user-KDE configuration need to know about the new index files. Since it might even be that some users have already created an index and some not, so the best is to overwrite their configuration without actually modifying anything in their configuration files – which is not a problem with KDE’s Kiosk. Depending on your distribution, your KDE system configuration is somewhere in
/etc/kde/ or similar. There the file
khelpcenterrc must be created/modified with the following content:
[Search][$i] IndexDirectory=$SYSTEMDIR IndexExists=true ScopeSelection=0
From now on all users will automatically access the index of the system repository – even if they already have created their own KHelpCenter index.
The KHelpCenter is a ncie program – but needs quite some love. Recently apacheLog identified several problems and was only able to fix some of them. Some slightly larger tasks are an integration with Nepomuk/Strigi and the inclusion of the online documentation: Userbase and Techbase. Last but not least it might be worth a look if KHelpCenter could take advantage of QtAssistant.
Finally a last word about the command mentioned above: it only include the KDE handbooks, the man pages might not be included.