From 1b6c123de102f0152d296fba8771d348329ba95c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Tue, 17 Nov 2020 19:52:37 +0100 Subject: Move the khelpcenter guides to the directory level in which they are installed. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Slávek Banko --- doc/quickstart/index.docbook | 1335 ------------------------------------------ 1 file changed, 1335 deletions(-) delete mode 100644 doc/quickstart/index.docbook (limited to 'doc/quickstart/index.docbook') diff --git a/doc/quickstart/index.docbook b/doc/quickstart/index.docbook deleted file mode 100644 index a70ab467c..000000000 --- a/doc/quickstart/index.docbook +++ /dev/null @@ -1,1335 +0,0 @@ - - - - - -]> - - - - - -Quickstart Guide to &tde; - - -&tde-authors; - - - -&tde-release-date; -&tde-release-version; - - -1999-2002 -The &kde; Team - - -&tde-copyright-date; -&tde-team; - - -&FDLNotice; - - -Quickstart Guide to &tde; -An introduction to the Trinity Desktop Environment - - - -KDE -TDE -quick start -introduction - - - - -Introduction - - -This guide provides a brief introduction to the Trinity Desktop Environment. It -will familiarize you with some of the basic features of &tde;. - - - -This guide does not cover all aspects of the Trinity Desktop or even most -of them. This guide only describes some of the most basic ways to accomplish a few -of the most common tasks. The &tde; User's Guide -provides detailed coverage of using Trinity. - - - -Use this guide with the presumption of being familiar with at least one graphical -user interface, such as CDE, -Geos, GEM, &NeXTSTEP;, -&Mac;, OS/2 or &Microsoft; &Windows;. Basic concepts, such as -using the mouse or keyboard are not explained in this guide. - - - - - -An Overview of &tde; - - -This section is for users who prefer to learn by exploring and want -only a brief orientation to get started. Later sections provide a more -thorough introduction to the environment, with helpful hints and -shortcuts. If you are impatient to get started, skim this section, go -play for a bit, then come back and peruse the other sections of this -guide as needed. - - - - -&tde; provides a highly configurable desktop environment. This -overview presumes that you are using the default environment. - - - - -The &tde; Desktop - -A typical Trinity desktop consists of several parts: - - - -A panel at the bottom of the screen, used -to start applications and switch between desktops. Among other things, it -contains the &kmenu;, with an &ticon; -that displays a menu of applications to start. - - - - - -A taskbar, by default embedded in the panel, used -to switch between and manage currently running applications. Click on an -application on the taskbar to switch to the application. - - - - - -The desktop itself, on which frequently used -files and folders might be placed. &tde; provides multiple desktops, -each of which has its own windows. Click on the numbered buttons on -the panel to switch between desktops. - - - - - - - -Ready, Set, Go! - -Here are a few quick tips to get you up and running. - - - - -To start an application, click on the &ticon; button on -the panel (called the &kmenu;) -and choose an item from the menu. - - - - -Click the icon that looks like a picture of a house on -the panel to access the files in your home folder using -&konqueror;, &tde;'s File Manager utility. - - - -Choose TDE menu -System -Konsole to get a &UNIX; -command prompt, or press &Alt; -F2 to get a mini command prompt window to -execute a single command. - - - - - -Choose the Control Center - item on the &kmenu; to configure &tde;. - - - - - -Press &Alt;Tab to -switch between applications and &Ctrl;Tab to switch between -desktops using the keyboard. - - - - - -Use the &RMB; mouse button to access context menus for the panel, -desktop, and most &tde; applications. - - - - - - - - -Launching Applications - - -Using the &kmenu; and the Panel - - -At the bottom of the screen you will find the desktop panel, which is called -&kicker;. Use the panel to launch applications. Have a look at the -button on the left with a large &ticon;. - - - -This button is called the &kmenu;. When the mouse pointer hovers over the icon, -a small arrow on the top indicates that it will pop up a menu if you -click on it. The popup offers you easy access to all &tde; -applications installed on your computer system. - - - -Customizing &kicker; - - - -If you use one application or tool very often, then you might want to have fast -access to it. In this case you can add a single application or an entire sub-menu of the -&kmenu; as a special quick-launch button on the panel. If you want to reach an application -directly via a launch button, click with the &RMB; either on a clear space on the panel or on the -&kmenu; icon. Select Panel Menu Add Application to Panel... - and then navigate to the application or menu you would like to add to -the panel. - - - -You can add an entire menu this way, or one of the &ticon; -button sub-menus. For example, if you have &koffice; installed and -want quick access to all the &koffice; applications, without having to -navigate through the &kmenu;, then instead of choosing an -application, click on the Add Menu to Main Panel menu -entry. Thereafter you will have instant access to all the &koffice; -applications, without having to put an icon for each on the panel. - - - - -You can move all items of the panel around with the -Move command of the context menu. Just click -with the third mouse button (the -third mouse button is normally the -right button, but if you have configured your -mouse differently, for example for left-handers, it might also be the -left one). A menu will pop up where you can -choose Move. Now move the mouse and see how -the icon follows while still staying on the panel. When you are done, -simply press the first mouse button (by default -the left one). As you might have noticed, -there is also a menu entry Remove in case you -are tired of a certain launch button on your desktop. - - - - - - -Using Context menus - - -This leads us to another interesting topic: in many places, you can -click the right mouse button to display a -context menu with choices that are applicable to -the item you clicked. It is therefore always a good idea to try out the -third mouse button on something, if you do -not know what to do with it. Even the background of the desktops has -such a menu! - - - - - -Other Panel features - - -There are other interesting things possible with the panel. One -might be important if you have a low resolution on your monitor: it is -the hide-and-show function, activated by clicking on the -small arrowed button, which is at one or both ends of the panel. - - - -Perhaps you just do not like the panel extending the full width of the -screen. That's easily changed! &RMB; on an empty space in the panel, -and choose Configure Panel.... In the &kcontrolcenter; -dialog that pops up, you can choose Length on -the Appearance tab, and use the slider there to set -the panel to less than 100% width. - - - -If you're following along, and have that dialog open anyway, then feel -free to play with all the options, and use the -Apply to see the effect they have. You can -easily reset everything to the default configuration, by simply pressing -the Use Defaults button. - - - -By the way, if you are not sure what a certain button does in &tde;, -just move the mouse pointer over it and wait for a short while: &tde; -has a built-in mini context help, called tool tips, which -explains the functionality of such controls in a few words. - - - - - - - -I want access to the command line! - - -There is nothing to fear. &tde; does not remove the -effective command line. You can move -your files with the desktop, but you can also use the &UNIX; commands you are -accustomed to. In fact,&tde; puts command line power at your fingertips, -in perhaps some surprising places. - - - -&tde; provides a very sophisticated command line window called -&konsole;. Choose TDE menu -System -Konsole to start it. This might -be something you want on your panel. - - - -Sometimes, you only want to enter one command on the command line. In -these cases, you do not need a full-blown terminal. Just press -&Alt;F2 and you get a -small command line where you can enter one command. The command line -window will disappear afterwards, but it remembers your command. - - - -When you pop up this window (that is called -minicli) and press the Up -arrow, you can browse through all the commands you have -previously entered. Also, you can enter &URL;s in -minicli to open a &konqueror; window with -the specified &URL;. - - - -&konqueror; and the text editor &kate; can both display terminal windows, -which behave just like &konsole;. In &konqueror;, you can turn this -on with the menu choice -WindowShow Terminal -Emulator. The embedded terminal will display -at the bottom of your &konqueror; window, and the really clever part -is that it will follow your clicks in the file manager view, changing -folder as you do. In &kate; you can display a terminal with the -menu choice SettingsShow -Console. - - - - -To display a &UNIX; man page, enter -man:command -in minicli, where command -is the name of a &UNIX; command. - - - - - -To search for a word or words on the Google search engine, you can try entering -gg:word or -words. There are a whole lot more of these -shortcut commands, and you can even add your own! Take a look in -&kcontrolcenter;, in the tab Web Browsing - Enhanced Browsing. - - - - -Finally, there's a way to have your command line always available, no -matter what you're doing - add one to your &kicker; panel! - - -Simply &RMB; click on an empty space in the panel and choose -Add Applet to Panel.... In the dialog that appears, -scroll down until you see the Run Command list item. Select -it with the &LMB; and click Add to Panel. This will embed a mini-cli -directly into your panel, complete with command history. - - -In conclusion, the command line is never far from view when using &tde;. - - - - - - -Working with Windows - - -If you have not already done so, start an application using the &kmenu;; for example, Find Files. - - - -A window! What now? - - -Usually people work inside windows, but -sometimes you might want to manipulate windows. Here's a quick overview -of some of the most common window related functions: - - - - -Move a window - - -Drag the window's title bar, or hold the &Alt; key down -and drag anywhere in the window. - - - - - -Resize a window: - - -Drag the window's border, or hold the &Alt; key down and drag with the -&RMB; anywhere in the window. - - - - - -Maximize a window - - -Click the maximize button in the titlebar (in the default decoration it -is the button with a square, next to the X, located on the far right side -of the titlebar) to make the window fill the screen. If the window is -already maximized, shrink the window using the same button, although the -image will be a double square. -Clicking with the &MMB; maximizes the window vertically, and with -the &RMB;, horizontally. - - - - - -Iconify a window - - -Click the Minimize button in the titlebar (next to Maximize) -to hide the window. Restore it by clicking on the window's icon in the -taskbar. - - - - - -Switch between windows - - -Aside from the usual mouse click to switch to another window, -you can use &Alt; -Tab to switch windows. See below for more -techniques. - - - - - - -Titlebar buttons - - -&tde; windows have some standard buttons on their titlebars that -provide fast access to some common operations. The default button -layout looks like this: - - - -On the left side: - - -A Menu button. This usually shows a mini icon for the application. Click -on it to get a window operations menu. Shortcut: &Alt;F3 opens the window -menu. - - - -A sticky button. This button will look like a tumb tack or pin. - - - - - - -On the right side: - - -A Minimize button. - - - - - -A Maximize button. - - - - - -A Close button. This closes the window. Shortcut: &Alt;F4. - - - - - - - -Switching between windows - - -Now that we know how to deal with windows, we encourage you to open -some other windows using the panel, since we will now discuss how to -switch between different windows. Since this is such a common -activity, &tde; offers several ways to do it; pick your favorite! - - - -Many graphical user interface systems require users to click the mouse in a window -to begin using it. This is &tde;'s default behavior, termed -Click To Focus focus policy. You can configure -your desktop in a way that moving the mouse pointer on to a window will -activate it. This is called Focus Follows Mouse. If you -select this policy using the &tde; Control -Center, the window under the mouse pointer is always the active -one. It does not necessarily come to the front automatically, but you -can still click on to the titlebar or the border of a window or, a -&tde; special, you can use the &Alt; key and click the &MMB; -anywhere on the window to raise it. - - - -Here are some other methods to switch windows: - - - - - -Pick a window from the window list menu. To open -the menu, click the &MMB; on -an empty area of the desktop, or click the icon with several windows -on the panel, or finally click the up arrow at the left hand end of -the taskbar in the panel. - - - - - -Hold down the &Alt; key and press Tab to cycle through -the windows. - - - - - -Use the taskbar (next section). - - - - - - - - -Using the Taskbar - - -The taskbar displays a list of small icons, one -for each window on the desktop. In the default &tde; setup the taskbar -is located inside the panel, but can also be located at the top or -the bottom of the screen. - - -The taskbar is powerful. In the default configuration, if you -have more than one window from the same application open, they will be -grouped, so that you see one icon per application in -the taskbar. - -A simple &LMB; -click on the taskbar button will pop up a list of the open windows for -that application and you can choose the window you want to -use. Choosing one of these entries with the -left will bring you to the selected -window immediately. Click on a taskbar entry with the -right and you will see a menu allowing you -to operate on all the windows grouped under that icon, or each window -individually. - - -You can choose to see all the windows on all the desktops in your -taskbar, regardless of which desktop you are currently viewing, or to only -see the icons for the desktop you are viewing. You can choose -to ungroup the icons, so each open window will have its own icon -in the taskbar. There are many more options available simply by -right clicking on the taskbar handle (the small textured bar at the -left hand side) and choosing Configure Taskbar.... - - - -The icons on the taskbar resize themselves to make room for -applications, so you can fit many more applications than you might -think. Making the panel wider will let the taskbar icons take on a row -and column layout, but they will still resize to fit more icons. - - - - - -Using Virtual Desktops - - -Now, what was that Sticky button? - - - -Perhaps you have more windows open than space on your -desktop. In this case you have three possibilities: - - - - - -Leave all windows open (cluttered desktop) - - - - - -Iconify those windows that you do not need at present and use -the taskbar or &Alt; -Tab to switch between them -(still a bit confusing and much work!) - - - - - -Recommended: Use virtual desktops. - - - - - -The third option is the way to go! &tde; can handle several different desktops, -each with its own set of application windows. The default configuration provides four -desktops. You can switch between the virtual desktops easily with a -click on one of the desktop buttons on the panel. Also &Ctrl;F1...F4 will send you -to the corresponding desktop immediately, or &Ctrl; Tab will cycle through -the desktops. - - - -Virtual desktops are nice. Yet sometimes you want a window to be -present on every desktop. This could be, for example, -a small chat window, an alarm clock or whatever. In this case you can -use the above mentioned sticky button that will pin the -window on the background so that it will appear on every virtual -desktop. - - - -The sticky button can also be used to move a window from one virtual -desktop to another one: push the sticky pin on the window, switch to a -different desktop, and release the pin by pushing it again. You can -achieve the same result by using the context popup menu of the -window's entry in the taskbar (menu item To Current -Desktop) or the To Desktop -option on the window operations menu. - - - - - - -Managing your files - - - - -A common metaphor of graphical desktops is the use of folders to -represent folders on your hard disk. Folders contain files and -other folders. A &tde; application called &konqueror;, the Trinity File -Manager, uses this metaphor to help you manage your files. - - - -Using &konqueror; - - -The first time you start &konqueror;, a window with lots of icons in it -appears. This is a &konqueror; window displaying the files in your -home folder (the area where your personal files are stored). The -pathname of the folder is displayed under the window's tool bar. If -you do not see such a window now, click the icon on the panel that -looks like a folder with a picture of a house. - - - -To open a file or folder, double-click it with the &LMB;. -You can also choose -WindowShow -Navigation Panel from the menu to display the folder -hierarchy for more direct navigation. Or you can edit the path -displayed under the toolbar to get to a specific folder quickly. - - - -Opening Files - - -&tde; comes with a set of applications to view and edit files of many -common types, and when you select a file containing, say, a document -or image, &konqueror; will start an appropriate application to -display the file. If it does not know what application to start to open -a file you selected, &konqueror; will prompt you for the name of the -application to run, and when you have chosen, &konqueror; will offer -to remember your choice for the next time you open a file of that type. - - - - -&konqueror; uses MIME types to associate -files with applications. - - - - - - -Dragging and Dropping Icons - - -To copy or move a file, simply drag its icon to the desktop, to -another &konqueror; window, or to a folder icon. When you release the -button, &konqueror; displays a menu to allow you to choose to copy, -move, or create a link to the file. - - - - -Note that if you choose to create a link, &tde; creates a &UNIX; -symbolic link (not a hard link), so if you move or delete the original -file, the link will be broken. - - - - -Most &tde; applications also support drag and drop operations: you can -drag an icon on to a window of a running application, or on to an icon of -an application that is not started, to have the application open the -file. Try it! - - - - - -Setting File Properties - - -To change file properties, such as its name and permissions, &RMB; -click the icon and choose Properties from -the menu. - - - - - - -Working with Archives and Networks - - -Once upon a time users needed special software to access files on the -Internet. Not any more! - - - -&tde; supports a technology called Network Transparent -Access (NTA), which allows you to work with -files on the other side of the world as easily as those on your local -hard disk. - - -For example, to access files on an &FTP; server, just choose -LocationOpen -Location from a &konqueror; menu, and enter -the URL of an &FTP; server. You can drag and drop -files to and from the folders on the server just as if they were on -your local disk. You'll even be able to open files on the &FTP; server -without having to manually copy them to your local disk (&tde; does it for you -when necessary). - - - - -Note that &konqueror; uses anonymous &FTP; access, which might restrict -your access to files on the &FTP; server. If you have an account on -the server, you can supply your user ID as part of -the URL, like this: -ftp://userid@server/folder - - - -&konqueror; will prompt you for your password, and if the login -succeeds, you will have full access to your files on the server. - - - - -If you are used to the -WinZip utility on -&Microsoft; &Windows;, then you will be happy to know that &tde; can -look into archive files too. It treats such archives just like a -normal folder, and you can browse into the archive, open files, &etc; In -general, accessing files on the Internet and in archives should look -and feel just like accessing files on your local disk, except for -delays imposed by the network and extracting the archive. - - - - -Using Templates to Access Applications and Devices - - -In &tde; it's easy to put icons on the panel or the desktop to access -your applications. It's just as easy to add icons to access other -items of interest. &tde; has templates for shortcuts to: - - - - - -Applications - - - - -Printers - - - - -Mountable Devices (⪚ floppy drives) - - - - -Internet resources (⪚ WWW documents, &FTP; -folders) - - - - -Documents for some of &tde;'s &koffice; applications. - - - - - -You can add any of these items to the desktop by &RMB; clicking where -you want the icon, and choosing Create New -and selecting the item you want to link to. - - - -Nearly every item in the &kmenu;, on the desktop, and on -the panel refers to a .desktop -file on disk. The .desktop file -specifies what icon to display, as well as specific information about -what the icon represents (an application, device, or -URL). You can drag any .desktop file to the panel to create a -quick-launch button. - - - - - -Mounting devices - - -&UNIX; systems provide access to storage devices other than the primary -hard disk through a process called -mounting. &tde; uses .desktop files to allow you to easily -mount, unmount, and access files on secondary storage devices such as -floppy drives and &cdrom; drives. - - - -As an example, here are the steps needed to create an icon to access -files on a floppy disk: - - - - -Many &UNIX; systems require you to be logged in as root to mount and unmount devices. - - - - - -Right click on the desktop and choose -Create -NewDevice -Floppy Device.... - - - - -On the General tab of the resulting dialog, change -the name to whatever you like, in the text box at the top. - - - - - -On the Device tab, enter /dev/fd0 (or the path to the floppy device -as it is named on your system) as the Device. - - - - -You can add a Mount Point here too. This should be -an existing folder, but empty. Common mount points are /mnt/floppy or /floppy, but you can just as easily have floppy -disks mounted on ~/mydisk if you -want. - - - - -Click the Unmounted Icon and select the picture -of a floppy disk without the green light. - - - - -Once you're happy with your choices, choose OK -and you are finished! - - - - - -Now, place a properly formatted floppy in the drive and click the -Floppy icon to have &tde; mount the floppy drive and display -the files on the disk. Before removing the disk from the drive, &RMB; -click the Floppy icon and choose -Unmount from the menu. - - - - - - - -Configuring your desktop - - -If you do not like something about the way the desktop looks or -operates, you can probably change it. &tde; is very configurable and you -can change almost every aspect of the appearance and the behavior of -your desktop. Unlike many other &UNIX; desktop environments, you do not -have to edit cryptic configuration files either (but you can if you -really want to!) You use the &kcontrolcenter;, a special program for -configuring your desktop. - - - -Using the <application>&tde; Control Center</application> - - -Launch the &kcontrolcenter; from the &kmenu;. -A window with two panes appears, displaying a list of -modules in the left pane. - - - -Open a module by clicking its name; a list of submodules will -appear. Then, click one of the submodule category names to edit its -configuration in the right pane. - - - -Changing the configuration is fairly straightforward. A help button is -available on each configuration panel to explain settings that are not -obvious. Each panel has buttons labeled Help, -Use Defaults, Apply, and -Reset, which work as follows: - - - - -Help - - -Displays a short help text in the left hand pane, including a link to a -longer manual for the module in question. - - - - - -Use Defaults - - -Sets all the options in the current module back to the default at the -time &tde; was installed. - - - - - -Apply - - -Applies the current settings in the currently open module. - - - - - -Reset - - -Resets the options to the state they were in when you opened the module. -If you have already used the Apply button, then -this button will reset the options to the state they were in when you -pressed Apply. - - - - - - - -If you make changes on one configuration panel and move to a different module -without clicking OK or Apply -first, &kcontrolcenter; will prompt you to ask whether your changes should be applied -first. - - - - - - - - -Logging out - - -We sincerely hope that using &tde; gives you so much fun and -pleasure that you never want to log out. But if you do, simply choose -TDE menu -Logout. - - - -There also is an applet logout button that can be added directly to the panel, which looks like a -small power button. Or you can press &Ctrl; -&Alt; Delete to log out. - - - -Session Management - - -When you log out, &tde; can remember which applications you had open, as -well as where all the windows were located, so that it can open them -for you the next time you log in. This feature is termed -Session Management. &tde;-aware applications will -restore themselves to the state they were in when you logged out. For -example, &kate; remembers which files you were editing. - - -Non-&tde; applications might not memorize their state on logout, and -&tde; will warn you to make sure that you have saved any important -data in them when you start to log out. - - - -To illustrate session management, choose -TDE menuEditors -Kate to start &kate;. Open -a text document to edit. Now log out and back in. You will observe -that &kate; will be restored to the exact same position on the screen, -including the correct virtual desktop, and the document we left open in -&kate; before we logged out is opened again automatically. &kate; -will even remember whether you had unsaved changes to your document -before you logged out and will save them to the file you were working -on if you choose Save from the -File menu. - - - - - - -&tde;, an exciting Journey - - -We hope you enjoyed this brief tour of the Trinity Desktop Environment and -that this unique desktop environment will help you get your work done -faster and more comfortably than ever. - - - -Please remember that the &tde; project is not a commercial venture, -but rather a project run by volunteers from around the world. We -would like to invite you to join the &tde; project and become part of -this unique network of people. If you are a programmer you might -consider helping us write or improve &tde; applications. If you are an artist or -have experience with graphic design, consider creating icons sets, -color schemes, sound schemes and logos for &tde;. If you enjoy -writing we would love for you to join our documentation team. - - - -As you can see there are many ways that you can help. You are -invited to join this world-wide network of people dedicated -to making &tde; the best desktop environment for any computer. Please -visit www.trinitydesktop.org for more -information. - - - -Welcome aboard on this exciting journey, - - -Your &tde; Team - - - - - -Credits - -Authors - - -Matthias Ettrich -ettrich@kde.org -Kalle Dahlheimer kalle@kde.org -Torben Weiss weis@kde.org -Bernd Wuebben wuebben@kde.org -Stephen Schaub sschaub@bju.edu - -Editor -Robert Williams rwilliams@kde.org - -Editor -Lauri Watts lauri@kde.org - - - - -&underFDL; - - - - -- cgit v1.2.1