/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt Creator. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ****************************************************************************/ #include "localhelpmanager.h" #include "bookmarkmanager.h" #include "helpconstants.h" #include "helpviewer.h" #include #include #include #include #include #include #include #include using namespace Help::Internal; static LocalHelpManager *m_instance = 0; bool LocalHelpManager::m_guiNeedsSetup = true; bool LocalHelpManager::m_needsCollectionFile = true; QMutex LocalHelpManager::m_guiMutex; QHelpEngine* LocalHelpManager::m_guiEngine = 0; QMutex LocalHelpManager::m_bkmarkMutex; BookmarkManager* LocalHelpManager::m_bookmarkManager = 0; QStandardItemModel *LocalHelpManager::m_filterModel = 0; QString LocalHelpManager::m_currentFilter = QString(); int LocalHelpManager::m_currentFilterIndex = -1; static const char kHelpHomePageKey[] = "Help/HomePage"; static const char kFontFamilyKey[] = "Help/FallbackFontFamily"; static const char kFontStyleNameKey[] = "Help/FallbackFontStyleName"; static const char kFontSizeKey[] = "Help/FallbackFontSize"; static const char kStartOptionKey[] = "Help/StartOption"; static const char kContextHelpOptionKey[] = "Help/ContextHelpOption"; static const char kReturnOnCloseKey[] = "Help/ReturnOnClose"; static const char kLastShownPagesKey[] = "Help/LastShownPages"; static const char kLastShownPagesZoomKey[] = "Help/LastShownPagesZoom"; static const char kLastSelectedTabKey[] = "Help/LastSelectedTab"; // TODO remove some time after 4.1 static const char kFontStyleKey[] = "Help/FallbackFontStyle"; static const char kFontWeightKey[] = "Help/FallbackFontWeight"; static const QFont::Style kDefaultFallbackFontStyle = QFont::StyleNormal; static const int kDefaultFallbackFontWeight = QFont::Normal; static const int kDefaultFallbackFontSize = 14; static QString defaultFallbackFontFamily() { if (Utils::HostOsInfo::isMacHost()) return QString("Helvetica"); if (Utils::HostOsInfo::isAnyUnixHost()) return QString("Sans Serif"); return QString("Arial"); } static QString defaultFallbackFontStyleName(const QString &fontFamily) { const QStringList styles = QFontDatabase().styles(fontFamily); QTC_ASSERT(!styles.isEmpty(), return QString("Regular")); return styles.first(); } template static void setOrRemoveSetting(const char *key, const T &value, const T &defaultValue) { QSettings *settings = Core::ICore::settings(); if (value == defaultValue) settings->remove(QLatin1String(key)); else settings->setValue(QLatin1String(key), value); } LocalHelpManager::LocalHelpManager(QObject *parent) : QObject(parent) { m_instance = this; qRegisterMetaType("Help::Internal::LocalHelpManager::HelpData"); m_filterModel = new QStandardItemModel(this); } LocalHelpManager::~LocalHelpManager() { if (m_bookmarkManager) { m_bookmarkManager->saveBookmarks(); delete m_bookmarkManager; m_bookmarkManager = 0; } delete m_guiEngine; m_guiEngine = 0; } LocalHelpManager *LocalHelpManager::instance() { return m_instance; } QString LocalHelpManager::defaultHomePage() { static const QString url = QString::fromLatin1("qthelp://org.qt-project.qtcreator." "%1%2%3/doc/index.html").arg(IDE_VERSION_MAJOR).arg(IDE_VERSION_MINOR) .arg(IDE_VERSION_RELEASE); return url; } QString LocalHelpManager::homePage() { return Core::ICore::settings()->value(kHelpHomePageKey, defaultHomePage()).toString(); } void LocalHelpManager::setHomePage(const QString &page) { Core::ICore::settings()->setValue(kHelpHomePageKey, page); } QFont LocalHelpManager::fallbackFont() { QSettings *settings = Core::ICore::settings(); const QString family = settings->value(kFontFamilyKey, defaultFallbackFontFamily()).toString(); const int size = settings->value(kFontSizeKey, kDefaultFallbackFontSize).toInt(); QFont font(family, size); // TODO remove reading of old settings some time after 4.1 if (settings->contains(kFontStyleKey) && settings->contains(kFontWeightKey)) { const QFont::Style style = QFont::Style(settings->value(kFontStyleKey, kDefaultFallbackFontStyle).toInt()); const int weight = settings->value(kFontWeightKey, kDefaultFallbackFontWeight).toInt(); font.setStyle(style); font.setWeight(weight); } else { const QString styleName = settings->value(kFontStyleNameKey, defaultFallbackFontStyleName(font.family())).toString(); font.setStyleName(styleName); } return font; } void LocalHelpManager::setFallbackFont(const QFont &font) { { // TODO remove removal of old settings some time after 4.1 QSettings *settings = Core::ICore::settings(); settings->remove(kFontStyleKey); settings->remove(kFontWeightKey); } setOrRemoveSetting(kFontFamilyKey, font.family(), defaultFallbackFontFamily()); setOrRemoveSetting(kFontStyleNameKey, font.styleName(), defaultFallbackFontStyleName(font.family())); setOrRemoveSetting(kFontSizeKey, font.pointSize(), kDefaultFallbackFontSize); emit m_instance->fallbackFontChanged(font); } LocalHelpManager::StartOption LocalHelpManager::startOption() { const QVariant value = Core::ICore::settings()->value(kStartOptionKey, ShowLastPages); bool ok; int optionValue = value.toInt(&ok); if (!ok) optionValue = ShowLastPages; switch (optionValue) { case ShowHomePage: return ShowHomePage; case ShowBlankPage: return ShowBlankPage; case ShowLastPages: return ShowLastPages; default: break; } return ShowLastPages; } void LocalHelpManager::setStartOption(LocalHelpManager::StartOption option) { Core::ICore::settings()->setValue(kStartOptionKey, option); } Core::HelpManager::HelpViewerLocation LocalHelpManager::contextHelpOption() { const QVariant value = Core::ICore::settings()->value(kContextHelpOptionKey, Core::HelpManager::SideBySideIfPossible); bool ok; int optionValue = value.toInt(&ok); if (!ok) optionValue = Core::HelpManager::SideBySideIfPossible; switch (optionValue) { case Core::HelpManager::SideBySideIfPossible: return Core::HelpManager::SideBySideIfPossible; case Core::HelpManager::SideBySideAlways: return Core::HelpManager::SideBySideAlways; case Core::HelpManager::HelpModeAlways: return Core::HelpManager::HelpModeAlways; case Core::HelpManager::ExternalHelpAlways: return Core::HelpManager::ExternalHelpAlways; default: break; } return Core::HelpManager::SideBySideIfPossible; } void LocalHelpManager::setContextHelpOption(Core::HelpManager::HelpViewerLocation location) { Core::ICore::settings()->setValue(kContextHelpOptionKey, location); } bool LocalHelpManager::returnOnClose() { const QVariant value = Core::ICore::settings()->value(kReturnOnCloseKey, false); return value.toBool(); } void LocalHelpManager::setReturnOnClose(bool returnOnClose) { Core::ICore::settings()->setValue(kReturnOnCloseKey, returnOnClose); emit m_instance->returnOnCloseChanged(); } QStringList LocalHelpManager::lastShownPages() { const QVariant value = Core::ICore::settings()->value(kLastShownPagesKey, QVariant()); return value.toString().split(Constants::ListSeparator, QString::SkipEmptyParts); } void LocalHelpManager::setLastShownPages(const QStringList &pages) { Core::ICore::settings()->setValue(kLastShownPagesKey, pages.join(Constants::ListSeparator)); } QList LocalHelpManager::lastShownPagesZoom() { const QVariant value = Core::ICore::settings()->value(kLastShownPagesZoomKey, QVariant()); const QStringList stringValues = value.toString().split(Constants::ListSeparator, QString::SkipEmptyParts); return Utils::transform(stringValues, [](const QString &str) { return str.toFloat(); }); } void LocalHelpManager::setLastShownPagesZoom(const QList &zoom) { const QStringList stringValues = Utils::transform(zoom, [](qreal z) { return QString::number(z); }); Core::ICore::settings()->setValue(kLastShownPagesZoomKey, stringValues.join(Constants::ListSeparator)); } int LocalHelpManager::lastSelectedTab() { const QVariant value = Core::ICore::settings()->value(kLastSelectedTabKey, 0); return value.toInt(); } void LocalHelpManager::setLastSelectedTab(int index) { Core::ICore::settings()->setValue(kLastSelectedTabKey, index); } void LocalHelpManager::setupGuiHelpEngine() { if (m_needsCollectionFile) { m_needsCollectionFile = false; helpEngine().setCollectionFile(Core::HelpManager::collectionFilePath()); } if (m_guiNeedsSetup) { m_guiNeedsSetup = false; helpEngine().setupData(); } } void LocalHelpManager::setEngineNeedsUpdate() { m_guiNeedsSetup = true; } QHelpEngine &LocalHelpManager::helpEngine() { if (!m_guiEngine) { QMutexLocker _(&m_guiMutex); if (!m_guiEngine) m_guiEngine = new QHelpEngine(QString()); } return *m_guiEngine; } BookmarkManager& LocalHelpManager::bookmarkManager() { if (!m_bookmarkManager) { QMutexLocker _(&m_bkmarkMutex); if (!m_bookmarkManager) m_bookmarkManager = new BookmarkManager; } return *m_bookmarkManager; } /*! * Checks if the string does contain a scheme, and if that scheme is a "sensible" scheme for * opening in a internal or external browser (qthelp, about, file, http, https). * This is necessary to avoid trying to open e.g. "Foo::bar" in a external browser. */ bool LocalHelpManager::isValidUrl(const QString &link) { QUrl url(link); if (!url.isValid()) return false; const QString scheme = url.scheme(); return (scheme == "qthelp" || scheme == "about" || scheme == "file" || scheme == "http" || scheme == "https"); } QByteArray LocalHelpManager::loadErrorMessage(const QUrl &url, const QString &errorString) { const char g_htmlPage[] = "" "" "" "%1" "" "" "" "
" "" "

%2

" "

%3

" "%4" "
" "" ""; // some of the values we will replace %1...6 inside the former html const QString g_percent1 = QCoreApplication::translate("Help", "Error loading page"); // percent2 will be the error details // percent3 will be the url of the page we got the error from const QString g_percent4 = QCoreApplication::translate("Help", "

Check that you have the corresponding " "documentation set installed.

"); return QString::fromLatin1(g_htmlPage).arg(g_percent1, errorString, QCoreApplication::translate("Help", "Error loading: %1").arg(url.toString()), g_percent4).toUtf8(); } LocalHelpManager::HelpData LocalHelpManager::helpData(const QUrl &url) { HelpData data; const QHelpEngineCore &engine = helpEngine(); data.resolvedUrl = engine.findFile(url); if (data.resolvedUrl.isValid()) { data.data = engine.fileData(data.resolvedUrl); data.mimeType = HelpViewer::mimeFromUrl(data.resolvedUrl); if (data.mimeType.isEmpty()) data.mimeType = "application/octet-stream"; } else { data.data = loadErrorMessage(url, QCoreApplication::translate( "Help", "The page could not be found")); data.mimeType = "text/html"; } return data; } QAbstractItemModel *LocalHelpManager::filterModel() { return m_filterModel; } void LocalHelpManager::setFilterIndex(int index) { if (index == m_currentFilterIndex) return; m_currentFilterIndex = index; QStandardItem *item = m_filterModel->item(index); if (!item) { helpEngine().setCurrentFilter(QString()); return; } helpEngine().setCurrentFilter(item->text()); emit m_instance->filterIndexChanged(m_currentFilterIndex); } int LocalHelpManager::filterIndex() { return m_currentFilterIndex; } void LocalHelpManager::updateFilterModel() { const QHelpEngine &engine = helpEngine(); if (m_currentFilter.isEmpty()) m_currentFilter = engine.currentFilter(); m_filterModel->clear(); m_currentFilterIndex = -1; int count = 0; const QStringList &filters = engine.customFilters(); foreach (const QString &filterString, filters) { m_filterModel->appendRow(new QStandardItem(filterString)); if (filterString == m_currentFilter) m_currentFilterIndex = count; count++; } if (filters.size() < 1) return; if (m_currentFilterIndex < 0) { m_currentFilterIndex = 0; m_currentFilter = filters.at(0); } emit m_instance->filterIndexChanged(m_currentFilterIndex); }