From 8362bf63dea22bbf6736609b0f49c152f975eb63 Mon Sep 17 00:00:00 2001 From: tpearson Date: Wed, 20 Jan 2010 01:29:50 +0000 Subject: Added old abandoned KDE3 version of koffice git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/koffice@1077364 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/koshell/index.docbook | 507 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 507 insertions(+) create mode 100644 doc/koshell/index.docbook (limited to 'doc/koshell/index.docbook') diff --git a/doc/koshell/index.docbook b/doc/koshell/index.docbook new file mode 100644 index 00000000..dc43b5d9 --- /dev/null +++ b/doc/koshell/index.docbook @@ -0,0 +1,507 @@ + + + + + +]> + + + + +The &koshell; Handbook + + + +Anne-Marie +Mahfouf + +
annma@kde.org
+ + + + + + +2005-2006 +Anne-Marie Mahfouf + + +&FDLNotice; + + + +2006-01-30 +1.5.0 + + + + + +&koshell; is the &koffice; Workspace where you can work with each component of the &koffice; productivity suite at the same time. &koshell; helps you organize your work in a friendly environment. + + + + + +KDE +KOffice +workspace +KWord +KSpread +KPresenter +KChart +KPlato +Kexi +Krita +Kivio +Kugar +KFormula +Karbon14 + + + + + +Introduction + +&koshell; is a framework in which you can work with several &koffice; applications in the same window. Being based on a true component framework &koshell; provides exactly the +same functionality as the stand-alone applications, and adds more +features, by making available all components in the same window. + + +&koshell; is part of the &koffice; productivity suite for the K Desktop +Environment. Other applications in &koffice; include: + + +&kword; (A full featured WYSIWYG (What You See Is What You Get) +Word-processor/Desktop Publishing Program.) +&kspread; (A spreadsheet application.) +&kpresenter; (A presentation creator.) +Kexi (An integrated environment for databases.) +&kivio; (A flowchart creator.) +Karbon14 (A vector drawing program.) +&krita; (A pixel based drawing program.) +&kchart; (A chart and graph creator.) +&kformula; (A formula editor.) +&kugar; (A report generation tool.) + + +See the individual application manuals for details on how to use them. These manuals apply to +running the applications as components inside &koshell; just as well as running them stand-alone. + + + + + +The &koshell; Main Window + + +General + +&koshell; consists in a friendly workspace to allow you to work on several &koffice; applications at the same time. In the &koshell; main window you can see a side pane on the left showing the icons of the available &koffice; components and the main view on the right which contains the main window of the active component and the usual menubar and toolbar. + + +Here's a screenshot of &koshell; when you start it for the first time + + + + + + &koshell; screenshot + + + + + +Here you can see &koshell; as it is the first time you run it. &koshell; always starts empty. You can then choose different actions. You can use the side pane on the left to open the programs as if they are standalone applications. You can also open any supported document via the FileOpen + menu and the corresponding &koffice; application will open with the document loaded. + + + +You can also import any supported document using the FileImport + menu and as with the Open action, the adequate &koffice; application will be used to load your document. + + + + + +Side Pane + + +&koshell;'s Side Pane + + + +&koshell;'s Side Pane + + + +&koshell;'s Side Pane + + + + + +The side pane allows you to open a new &koffice; component as if it was the stand-alone application. In most components, you are asked what document you want to open, a template, an empty document or an existing document. The main window of the component is then shown and the menubar, toolbars and statusbar in &koshell; are +adapted to reflect the functionality of the active component. + + +You can change the size of the icons in the side pane. +Right-clicking on the side pane will give you the option to use Large, +Normal, or Small icons, as well as the option to use text only +instead of icons. + +If you dislike the sidebar, you can simply hide it by dragging the +splitter to the left. + + + + + +Main View + +The view on the right which takes up most of the area of the &koshell; +main window shows the active component. This exactly corresponds to the main +window the component uses when run as a stand-alone application. + + +&koshell;'s Main View + + + +&koshell;'s Main View + + + + &koshell;'s Main View + + + + +When a component is loaded, the component own menus are merged with the &koshell; menus and the component toolbars are added on the workspace. + +Each new component is opened in a new tab. Using the &RMB; on each tab title, you can save the document in that tab or close that tab. The small button on the right bottom with a red cross also allows you to close the current tab. + +A special action common to all components is the + FileNew action in &koshell; menubar. It opens the Insert Object dialog which starts the &koffice; component as if it was a stand-alone application. + + +&koshell; Insert Object dialog + + + +&koshell; Insert Object dialog + + + +&koshell; Insert Object dialog + + + + + + + + + +Command Reference + + +Menus and shortcut keys + + +The <guimenu>File</guimenu> Menu + + + + + +&Ctrl;N + +File +New + +Open the Insert Object dialog which lists all possible new documents you can open. + + + + + +&Ctrl;O + +File +Open... + +Open a supported document by choosing the corresponding &koffice; application. + + + + +File +Open Recent + +Display a selection of recently saved documents you can open. + + + + + +&Ctrl;S + +File +Save + +Save the current document. + + + + +File +Save As... + +Save the current document with a name you provide. + + + + +File +Reload + +Reload the current document. + + + + +File +Import... + +Import a supported document. + + + + +File +Export... + +Export the current document. + + + + +File +Mail... + +Invokes &kmail; so you can email the file. +The file is already attached to the email. + + + + +File +Save All + +Saves all open documents in &koffice; Workspace. + + + + + + +&Ctrl;P + +File +Print... + +Print the current document. + + + + +File +Print Preview... + +View the current document as it will be printed. + + + + + +File +Document Information + +View or enter information about the current document and +author. + + + + + + +&Ctrl;W + +File +Close + +Close the current document but leave &koshell; running. + + + + + + +&Ctrl;Q + +File +Quit + +Quits &koshell;. + + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + +Settings +Hide/Show Toolbar + +Toggle the Main Toolbar. + + + + + +Settings +Configure Shortcuts... + +Configure the shortcuts. + + + + + +Settings +Configure Toolbars... + +Configure the items you want to put in the toolbar. + + + + + + + + +The <guimenu>Help</guimenu> Menu +&help.menu.documentation; + + + + + +Under The Hood + +&koshell; makes extensive use of several &kde; key technologies, most +notably KParts and &DCOP;. + +The &GUI; integration of the components is done by plugins +providing KParts versions of the applications. This only needs a thin +additional layer on top of the already existing code of the +stand-alone applications. Because they are based on the KParts component model, &koffice; programs +are designed to work very well with each other. Any &koffice; component +can be embedded in another &koffice; document. + +For communication between the components &DCOP; is used. This +has the nice characteristic that it is completely transparent to +whether the application is run stand-alone or embedded as KPart into +&koshell;. + + + + + +Credits and License + + +&koshell; + + +Program copyright 2001-2005 The &koffice; Workspace Team + + +Original authors: + +Sven Lüppken +sven@kde.org +Torben Weis +weis@kde.org +David Faure +faure@kde.org + + + + +Documentation copyright 2005 Anne-Marie Mahfouf annma@kde.org + + + + +&underFDL; +&underGPL; + + + + +Installation + + +How to obtain &koshell; + +&install.intro.documentation; + + + + +Requirements + + +&koshell; is part of &koffice; +on The &koshell; home +page +You must have &koffice; installed. &koshell; will not work without the rest of +&koffice; + + + + + +Compilation and installation + +&install.compile.documentation; + + + + +&documentation.index; + + + + -- cgit v1.2.1