khelpclient.cpp

/*
    This file is part of the KDE libraries
    SPDX-FileCopyrightText: 2012 David Faure <[email protected]>
 
    SPDX-License-Identifier: LGPL-2.0-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
*/
 
#include "khelpclient.h"
 
#include <KDesktopFile>
 
#include <QCoreApplication>
#include <QDesktopServices>
#include <QDirIterator>
#include <QUrl>
 
void KHelpClient::invokeHelp(const QString &anchor, const QString &_appname)
{
    QString appname;
    if (_appname.isEmpty()) {
        appname = QCoreApplication::instance()->applicationName();
    } else {
        appname = _appname;
    }
 
    // Look for the .desktop file of the application
 
    // was:
    // KService::Ptr service(KService::serviceByDesktopName(appname));
    // if (service)
    //    docPath = service->docPath();
    // but we don't want to depend on KService here.
 
    QString docPath;
    const QStringList desktopDirs = QStandardPaths::standardLocations(QStandardPaths::ApplicationsLocation);
    for (const QString &dir : desktopDirs) {
        QDirIterator it(dir, QStringList() << appname + QLatin1String(".desktop"), QDir::NoFilter, QDirIterator::Subdirectories | QDirIterator::FollowSymlinks);
        while (it.hasNext()) {
            const QString desktopPath(it.next());
            KDesktopFile desktopFile(desktopPath);
            docPath = desktopFile.readDocPath();
            break;
        }
    }
 
    // docPath could be a path or a full URL, I think.
 
    QUrl url;
    if (!docPath.isEmpty()) {
        url = QUrl(QStringLiteral("help:/")).resolved(QUrl(docPath));
    } else {
        if (!anchor.isEmpty()) {
            if (anchor.contains(QLatin1Char('#'))) {
                url = QUrl(QStringLiteral("help:/%1/%2").arg(appname, anchor));
            } else {
                url = QUrl(QStringLiteral("help:/%1/%2.html").arg(appname, anchor));
            }
        } else {
            url = QUrl(QStringLiteral("help:/%1/index.html").arg(appname));
        }
    }
 
    // launch khelpcenter, or a browser for URIs not handled by khelpcenter
    QDesktopServices::openUrl(url);
}