Files
RedBear-OS/local/recipes/kde/kf6-kconfigwidgets/source/src/khelpclient.cpp
T
2026-04-14 10:51:06 +01:00

66 lines
2.0 KiB
C++

/*
This file is part of the KDE libraries
SPDX-FileCopyrightText: 2012 David Faure <faure@kde.org>
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);
}