/**************************************************************************** ** ** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/legal ** ** 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 Digia. For licensing terms and ** conditions see http://qt.digia.com/licensing. For further information ** use the contact form at http://qt.digia.com/contact-us. ** ** GNU Lesser General Public License Usage ** Alternatively, this file may be used under the terms of the GNU Lesser ** General Public License version 2.1 as published by the Free Software ** Foundation and appearing in the file LICENSE.LGPL included in the ** packaging of this file. Please review the following information to ** ensure the GNU Lesser General Public License version 2.1 requirements ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Digia gives you certain additional ** rights. These rights are described in the Digia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ****************************************************************************/ #include "localhelpmanager.h" #include "bookmarkmanager.h" #include "helpconstants.h" #include "helpviewer.h" #include #include #include #include using namespace Help::Internal; static LocalHelpManager *m_instance = 0; QMutex LocalHelpManager::m_guiMutex; QHelpEngine* LocalHelpManager::m_guiEngine = 0; QMutex LocalHelpManager::m_bkmarkMutex; BookmarkManager* LocalHelpManager::m_bookmarkManager = 0; LocalHelpManager::LocalHelpManager(QObject *parent) : QObject(parent) , m_guiNeedsSetup(true) , m_needsCollectionFile(true) { m_instance = this; qRegisterMetaType("Help::Internal::LocalHelpManager::HelpData"); } 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; } 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()); m_guiEngine->setAutoSaveFilter(false); } } return *m_guiEngine; } BookmarkManager& LocalHelpManager::bookmarkManager() { if (!m_bookmarkManager) { QMutexLocker _(&m_bkmarkMutex); if (!m_bookmarkManager) { m_bookmarkManager = new BookmarkManager; m_bookmarkManager->setupBookmarkModels(); 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); helpEngine().setCustomValue(QLatin1String("DefaultHomePage"), url); } } return *m_bookmarkManager; } QVariant LocalHelpManager::engineFontSettings() { return helpEngine().customValue(Constants::FontKey, QVariant()); } /*! * 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 == QLatin1String("qthelp") || scheme == QLatin1String("about") || scheme == QLatin1String("file") || scheme == QLatin1String("http") || scheme == QLatin1String("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 = QLatin1String("application/octet-stream"); } else { data.data = loadErrorMessage(url, QCoreApplication::translate( "Help", "The page could not be found")); data.mimeType = QLatin1String("text/html"); } return data; }