summaryrefslogtreecommitdiffstats
path: root/parts/documentation/plugins/kdevtoc
diff options
context:
space:
mode:
authorMichele Calgaro <michele.calgaro@yahoo.it>2014-05-25 15:37:31 +0900
committerMichele Calgaro <michele.calgaro@yahoo.it>2014-05-25 15:37:31 +0900
commit6392f5a9dfce2bf83617d49bb7f332181ec6004e (patch)
treeab69e390f7962b7e7dda1a3a64f035c61c751cf4 /parts/documentation/plugins/kdevtoc
parentaba2788b428dc53243407902e9ccbb20b97a69fd (diff)
downloadtdevelop-6392f5a9dfce2bf83617d49bb7f332181ec6004e.tar.gz
tdevelop-6392f5a9dfce2bf83617d49bb7f332181ec6004e.zip
Revert "Finish renaming tdevelop components"
This reverts commit 722ce1efbac31c61b1d4b13f7e075c9f311e3e73.
Diffstat (limited to 'parts/documentation/plugins/kdevtoc')
-rw-r--r--parts/documentation/plugins/kdevtoc/CMakeLists.txt39
-rw-r--r--parts/documentation/plugins/kdevtoc/Makefile.am10
-rw-r--r--parts/documentation/plugins/kdevtoc/dockdevtocplugin.cpp277
-rw-r--r--parts/documentation/plugins/kdevtoc/dockdevtocplugin.desktop43
-rw-r--r--parts/documentation/plugins/kdevtoc/dockdevtocplugin.h55
5 files changed, 424 insertions, 0 deletions
diff --git a/parts/documentation/plugins/kdevtoc/CMakeLists.txt b/parts/documentation/plugins/kdevtoc/CMakeLists.txt
new file mode 100644
index 00000000..c12c26e3
--- /dev/null
+++ b/parts/documentation/plugins/kdevtoc/CMakeLists.txt
@@ -0,0 +1,39 @@
+#################################################
+#
+# (C) 2010-2011 Serghei Amelian
+# serghei (DOT) amelian (AT) gmail.com
+#
+# Improvements and feedback are welcome
+#
+# This file is released under GPL >= 2
+#
+#################################################
+
+add_definitions( ${KDE_PLUGIN} )
+
+include_directories(
+ ${CMAKE_CURRENT_BINARY_DIR}
+ ${CMAKE_SOURCE_DIR}/lib/interfaces
+ ${CMAKE_SOURCE_DIR}/lib/util
+ ${CMAKE_SOURCE_DIR}/parts/documentation/interfaces
+ ${TDE_INCLUDE_DIR}
+ ${TQT_INCLUDE_DIRS}
+)
+
+link_directories(
+ ${TQT_LIBRARY_DIRS}
+)
+
+
+##### other data ################################
+
+install( FILES dockdevtocplugin.desktop DESTINATION ${SERVICES_INSTALL_DIR} )
+
+
+##### libdockdevtocplugin (module) ##############
+
+tde_add_kpart( libdockdevtocplugin AUTOMOC
+ SOURCES dockdevtocplugin.cpp
+ LINK documentation_interfaces-shared tdevelop-shared
+ DESTINATION ${PLUGIN_INSTALL_DIR}
+)
diff --git a/parts/documentation/plugins/kdevtoc/Makefile.am b/parts/documentation/plugins/kdevtoc/Makefile.am
new file mode 100644
index 00000000..22dab380
--- /dev/null
+++ b/parts/documentation/plugins/kdevtoc/Makefile.am
@@ -0,0 +1,10 @@
+INCLUDES = -I$(top_srcdir)/lib/interfaces -I$(top_srcdir)/lib/util \
+ -I$(top_srcdir)/parts/documentation/interfaces $(all_includes)
+METASOURCES = AUTO
+kde_module_LTLIBRARIES = libdockdevtocplugin.la
+libdockdevtocplugin_la_LDFLAGS = -module -avoid-version -no-undefined $(all_libraries)
+kde_services_DATA = dockdevtocplugin.desktop
+noinst_HEADERS = dockdevtocplugin.h
+libdockdevtocplugin_la_SOURCES = dockdevtocplugin.cpp
+libdockdevtocplugin_la_LIBADD = $(top_builddir)/lib/libtdevelop.la \
+ $(top_builddir)/parts/documentation/interfaces/libdocumentation_interfaces.la
diff --git a/parts/documentation/plugins/kdevtoc/dockdevtocplugin.cpp b/parts/documentation/plugins/kdevtoc/dockdevtocplugin.cpp
new file mode 100644
index 00000000..fa17549b
--- /dev/null
+++ b/parts/documentation/plugins/kdevtoc/dockdevtocplugin.cpp
@@ -0,0 +1,277 @@
+/***************************************************************************
+ * Copyright (C) 2004 by Alexander Dymo *
+ * cloudtemple@mksat.net *
+ * *
+ * This program is free software; you can redistribute it and/or modify *
+ * it under the terms of the GNU General Public License as published by *
+ * the Free Software Foundation; either version 2 of the License, or *
+ * (at your option) any later version. *
+ * *
+ * This program is distributed in the hope that it will be useful, *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
+ * GNU General Public License for more details. *
+ * *
+ * You should have received a copy of the GNU General Public License *
+ * along with this program; if not, write to the *
+ * Free Software Foundation, Inc., *
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
+ ***************************************************************************/
+#include "dockdevtocplugin.h"
+
+#include <unistd.h>
+
+#include <tqdom.h>
+#include <tqfile.h>
+#include <tqfileinfo.h>
+#include <tqdialog.h>
+
+#include <kurl.h>
+#include <tdeaboutdata.h>
+#include <tdeconfig.h>
+#include <tdelocale.h>
+#include <tdelistview.h>
+#include <kstandarddirs.h>
+
+#include <urlutil.h>
+#include <kdevgenericfactory.h>
+#include <kdevplugininfo.h>
+
+#include "../../../../config.h"
+
+class TOCDocumentationCatalogItem: public DocumentationCatalogItem
+{
+public:
+ TOCDocumentationCatalogItem(const TQString &tocFile, DocumentationPlugin* plugin,
+ TDEListView *parent, const TQString &name)
+ :DocumentationCatalogItem(plugin, parent, name), m_tocFile(tocFile)
+ {
+ }
+ TOCDocumentationCatalogItem(const TQString &tocFile, DocumentationPlugin* plugin,
+ DocumentationItem *parent, const TQString &name)
+ :DocumentationCatalogItem(plugin, parent, name), m_tocFile(tocFile)
+ {
+ }
+ TQString tocFile() const { return m_tocFile; }
+
+private:
+ TQString m_tocFile;
+};
+
+
+static const KDevPluginInfo data("dockdevtocplugin");
+typedef KDevGenericFactory<DocKDevTOCPlugin> DocKDevTOCPluginFactory;
+K_EXPORT_COMPONENT_FACTORY( libdockdevtocplugin, DocKDevTOCPluginFactory(data) )
+
+DocKDevTOCPlugin::DocKDevTOCPlugin(TQObject* parent, const char* name,
+ const TQStringList /*args*/)
+ :DocumentationPlugin(DocKDevTOCPluginFactory::instance()->config(), parent, name)
+{
+ setCapabilities(Index);
+ autoSetup();
+}
+
+DocKDevTOCPlugin::~DocKDevTOCPlugin()
+{
+}
+
+TQString DocKDevTOCPlugin::pluginName() const
+{
+ return i18n("TDevelopTOC Documentation Collection");
+}
+
+DocumentationCatalogItem* DocKDevTOCPlugin::createCatalog(TDEListView* contents, const TQString& title, const TQString& url)
+{
+ return new TOCDocumentationCatalogItem(url, this, contents, title);
+}
+
+TQPair<KFile::Mode, TQString> DocKDevTOCPlugin::catalogLocatorProps()
+{
+ return TQPair<KFile::Mode, TQString>(KFile::File, "*.toc");
+}
+
+TQString DocKDevTOCPlugin::catalogTitle(const TQString& url)
+{
+ TQFileInfo fi(url);
+ if (!fi.exists())
+ return TQString();
+
+ TQFile f(url);
+ if (!f.open(IO_ReadOnly))
+ return TQString();
+
+ TQDomDocument doc;
+ if (!doc.setContent(&f) || (doc.doctype().name() != "tdeveloptoc"))
+ return TQString();
+ f.close();
+
+ TQDomElement titleEl = doc.documentElement().namedItem("title").toElement();
+
+ return titleEl.firstChild().toText().data();
+}
+
+
+TQStringList DocKDevTOCPlugin::fullTextSearchLocations()
+{
+ return TQStringList();
+}
+
+bool DocKDevTOCPlugin::needRefreshIndex(DocumentationCatalogItem* /*item*/)
+{
+ return false;
+}
+
+void DocKDevTOCPlugin::autoSetupPlugin()
+{
+ TQStringList tocsDir = DocKDevTOCPluginFactory::instance()->dirs()->findAllResources("data", "kdevdocumentation/tocs/*.toc");
+
+ for (TQStringList::const_iterator it = tocsDir.begin(); it != tocsDir.end(); ++it)
+ {
+ config->setGroup("Locations");
+ config->writePathEntry(catalogTitle(*it), *it);
+ }
+}
+
+void DocKDevTOCPlugin::createIndex(IndexBox* index, DocumentationCatalogItem* item)
+{
+ TOCDocumentationCatalogItem *tocItem = dynamic_cast<TOCDocumentationCatalogItem *>(item);
+ if (!tocItem)
+ return;
+
+ TQFileInfo fi(tocItem->tocFile());
+
+ TQFile f(tocItem->tocFile());
+ if (!f.open(IO_ReadOnly))
+ {
+ kdDebug(9002) << "Could not read" << tocItem->tocFile() << endl;
+ return;
+ }
+ TQDomDocument doc;
+ if (!doc.setContent(&f) || doc.doctype().name() != "tdeveloptoc")
+ {
+ kdDebug(9002) << "Not a valid tdeveloptoc file: " << tocItem->tocFile() << endl;
+ return;
+ }
+ f.close();
+
+ TQDomElement docEl = doc.documentElement();
+ TQDomElement baseEl = docEl.namedItem("base").toElement();
+
+ TQString base;
+ if (!baseEl.isNull())
+ base = baseEl.attribute("href", TQString());
+
+ TQDomElement indexEl = docEl.namedItem("index").toElement();
+ TQDomElement childEl = indexEl.firstChild().toElement();
+ while (!childEl.isNull())
+ {
+ if (childEl.tagName() == "entry")
+ {
+ TQString name = childEl.attribute("name");
+ TQString url = childEl.attribute("url");
+
+ IndexItemProto *ii = new IndexItemProto(this, item, index, name, item->text(0));
+ ii->addURL(KURL(constructURL(base, url)));
+ }
+ childEl = childEl.nextSibling().toElement();
+ }
+}
+
+void DocKDevTOCPlugin::createTOC(DocumentationCatalogItem* item)
+{
+ TOCDocumentationCatalogItem *tocItem = dynamic_cast<TOCDocumentationCatalogItem *>(item);
+ if (!tocItem)
+ return;
+
+ TQFileInfo fi(tocItem->tocFile());
+
+ TQFile f(tocItem->tocFile());
+ if (!f.open(IO_ReadOnly))
+ {
+ kdDebug(9002) << "Could not read" << tocItem->tocFile() << endl;
+ return;
+ }
+ TQDomDocument doc;
+ if (!doc.setContent(&f) || doc.doctype().name() != "tdeveloptoc")
+ {
+ kdDebug(9002) << "Not a valid tdeveloptoc file: " << tocItem->tocFile() << endl;
+ return;
+ }
+ f.close();
+
+ TQDomElement docEl = doc.documentElement();
+ TQDomElement baseEl = docEl.namedItem("base").toElement();
+
+ TQString base;
+ if (!baseEl.isNull())
+ base = baseEl.attribute("href", TQString());
+
+ TQDomElement childEl = docEl.lastChild().toElement();
+ addTocSect(tocItem, childEl, base, 1);
+}
+
+void DocKDevTOCPlugin::addTocSect(DocumentationItem *parent, TQDomElement childEl, const TQString &base, uint level)
+{
+ while (!childEl.isNull())
+ {
+ if (childEl.tagName() == TQString("tocsect%1").arg(level))
+ {
+ TQString name = childEl.attribute("name");
+ TQString url = childEl.attribute("url");
+
+ DocumentationItem *item = new DocumentationItem(level == 1 ? DocumentationItem::Book : DocumentationItem::Document, parent, name);
+ item->setURL(KURL(constructURL(base, url)));
+
+ TQDomElement grandchildEl = childEl.lastChild().toElement();
+ addTocSect(item, grandchildEl, base, level+1);
+ }
+ childEl = childEl.previousSibling().toElement();
+ }
+}
+
+void DocKDevTOCPlugin::setCatalogURL(DocumentationCatalogItem* item)
+{
+ TOCDocumentationCatalogItem *tocItem = dynamic_cast<TOCDocumentationCatalogItem *>(item);
+ if (!tocItem)
+ return;
+
+ TQFileInfo fi(tocItem->tocFile());
+
+ TQFile f(tocItem->tocFile());
+ if (!f.open(IO_ReadOnly))
+ {
+ kdDebug(9002) << "Could not read" << tocItem->tocFile() << endl;
+ return;
+ }
+ TQDomDocument doc;
+ if (!doc.setContent(&f) || doc.doctype().name() != "tdeveloptoc")
+ {
+ kdDebug(9002) << "Not a valid tdeveloptoc file: " << tocItem->tocFile() << endl;
+ return;
+ }
+ f.close();
+
+ TQDomElement docEl = doc.documentElement();
+ TQDomElement baseEl = docEl.namedItem("base").toElement();
+
+ if (item->url().isEmpty())
+ {
+ if (baseEl.isNull())
+ item->setURL(KURL());
+ else
+ item->setURL(KURL(constructURL(baseEl.attribute("href", TQString()),
+ baseEl.attribute("url", TQString()))));
+ }
+}
+
+TQString DocKDevTOCPlugin::constructURL(const TQString &base, const TQString &url)
+{
+ if (base.isEmpty() && !url.isEmpty())
+ return url;
+ if (!url.isEmpty())
+ return base.endsWith("/") ? base + url : base + "/" + url;
+ else
+ return base;
+}
+
+#include "dockdevtocplugin.moc"
diff --git a/parts/documentation/plugins/kdevtoc/dockdevtocplugin.desktop b/parts/documentation/plugins/kdevtoc/dockdevtocplugin.desktop
new file mode 100644
index 00000000..1cae3582
--- /dev/null
+++ b/parts/documentation/plugins/kdevtoc/dockdevtocplugin.desktop
@@ -0,0 +1,43 @@
+[Desktop Entry]
+Type=Service
+Name=DocKDevTOCPlugin
+Name[da]=DocKDevTOC-plugin
+Name[sk]=Doc KDevTOC modul
+Name[sv]=TDevelop innehållsförteckning-dokumentationsinsticksmodul
+Name[ta]=DocKDevTOC சொருகு
+Name[zh_TW]=TDevelop 目錄文件外掛程式
+Exec=blubb
+Comment=Documentation plugin for TDevelopTOC documentation
+Comment[ca]=Connector de documentació per a documentació TDevelopTOC
+Comment[da]=Dokumentations-plugin for TDevelopTOC-dokumentation
+Comment[de]=Komponente für TDevelopTOC-Dokumentation
+Comment[el]=Πρόσθετο τεκμηρίωσης για τεκμηρίωση τύπου TDevelopTOC
+Comment[es]=Complemento de documentación para TDevelopTOC
+Comment[et]=TDevelopTOC dokumentatsiooni plugin
+Comment[eu]=TDevelopTOC dokumentaziorako dokumentazio plugin-a
+Comment[fa]=وصلۀ مستندسازی برای مستندات TDevelopTOC
+Comment[fr]=Module externe de documentation pour la documentation TDevelopTOC
+Comment[gl]=Extensión de documentación para documentación TDevelopTOC
+Comment[hu]=Dokumentációmodul TDevelopTOC-dokumentációhoz
+Comment[it]=Plugin di documentazione per file di TDevelopTOC
+Comment[ja]=TDevelopTOC ドキュメンテーションのためのドキュメンテーションプラグイン
+Comment[ms]=Plugin dokumentasi untuk dokumentasi TDevelopTOC
+Comment[nds]=Dokmentatschoon-Moduul för TDevelopTOC-Dokmentatschoon
+Comment[ne]=TDevelopTOC मिसिलीकरणका लागि मिसिलीकरण प्लगइन
+Comment[nl]=Documentatie plugin for TDevelopTOC documentatie
+Comment[pl]=Wtyczka dokumentacji dla dokumentacji w formacie TDevelopTOC
+Comment[pt]='Plugin' para documentação TDevelopTOC
+Comment[pt_BR]=Plug-in de documentação para document TOC do TDevelop
+Comment[ru]=Модуль для просмотра TDevelopTOC
+Comment[sk]=Dokumentačný modul pre TDevelopTOC dokumentáciu
+Comment[sr]=Документациони прикључак за TDevelopTOC документацију
+Comment[sr@Latn]=Dokumentacioni priključak za TDevelopTOC dokumentaciju
+Comment[sv]=Dokumentationsinsticksmodul för TDevelop innehållsförteckningsdokumentation
+Comment[ta]= TDevelopTOC ஆவணத்திற்கான ஆவணச் சொருகு
+Comment[tg]=Модул барои наоиши TDevelopTOC
+Comment[tr]=TDevelopTOC belgelendirmesi için belgelendirme eklentisi
+Comment[zh_CN]=TDevelopTOC 文档的文档插件
+Comment[zh_TW]=TDevelop 目錄文件外掛程式
+ServiceTypes=TDevelop/DocumentationPlugins
+X-TDevelop-Version=5
+X-TDE-Library=libdockdevtocplugin
diff --git a/parts/documentation/plugins/kdevtoc/dockdevtocplugin.h b/parts/documentation/plugins/kdevtoc/dockdevtocplugin.h
new file mode 100644
index 00000000..7205cc4c
--- /dev/null
+++ b/parts/documentation/plugins/kdevtoc/dockdevtocplugin.h
@@ -0,0 +1,55 @@
+/***************************************************************************
+ * Copyright (C) 2004 by Alexander Dymo *
+ * cloudtemple@mksat.net *
+ * *
+ * This program is free software; you can redistribute it and/or modify *
+ * it under the terms of the GNU General Public License as published by *
+ * the Free Software Foundation; either version 2 of the License, or *
+ * (at your option) any later version. *
+ * *
+ * This program is distributed in the hope that it will be useful, *
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of *
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
+ * GNU General Public License for more details. *
+ * *
+ * You should have received a copy of the GNU General Public License *
+ * along with this program; if not, write to the *
+ * Free Software Foundation, Inc., *
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. *
+ ***************************************************************************/
+#ifndef DOCKDEVTOCPLUGIN_H
+#define DOCKDEVTOCPLUGIN_H
+
+#include <tqdom.h>
+
+#include <kdevdocumentationplugin.h>
+
+class DocKDevTOCPlugin : public DocumentationPlugin
+{
+ Q_OBJECT
+
+public:
+ DocKDevTOCPlugin(TQObject* parent, const char* name, const TQStringList args = TQStringList());
+ ~DocKDevTOCPlugin();
+
+ virtual TQString pluginName() const;
+
+ virtual TQString catalogTitle(const TQString& url);
+ virtual DocumentationCatalogItem* createCatalog(TDEListView* contents, const TQString& title, const TQString& url);
+ virtual void createTOC(DocumentationCatalogItem* item);
+ virtual void setCatalogURL(DocumentationCatalogItem* item);
+
+ virtual bool needRefreshIndex(DocumentationCatalogItem* item);
+ virtual void createIndex(IndexBox* index, DocumentationCatalogItem* item);
+
+ virtual TQStringList fullTextSearchLocations();
+
+ virtual TQPair<KFile::Mode, TQString > catalogLocatorProps();
+ virtual void autoSetupPlugin();
+
+protected:
+ void addTocSect(DocumentationItem *parent, TQDomElement childEl, const TQString &base, uint level);
+ static TQString constructURL(const TQString &base, const TQString &url) ;
+};
+
+#endif