diff options
author | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-02-22 18:58:28 +0000 |
---|---|---|
committer | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-02-22 18:58:28 +0000 |
commit | 83b9bf0e3bfb1d842b10b80bbe749095b2c661a1 (patch) | |
tree | b05b1793361693ae88106648c2a953bed988f423 /doc | |
download | krusader-83b9bf0e3bfb1d842b10b80bbe749095b2c661a1.tar.gz krusader-83b9bf0e3bfb1d842b10b80bbe749095b2c661a1.zip |
Added old KDE3 version of Krusader
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/krusader@1094427 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'doc')
84 files changed, 38077 insertions, 0 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog new file mode 100644 index 0000000..072e163 --- /dev/null +++ b/doc/ChangeLog @@ -0,0 +1,577 @@ +The Krusader Handbook ChangeLog +------------------------------- + +1.90.0 "Power Stone" +================================== +Date: 2008-03-15 scheduled release date + + ADDED: Useractions for the 1.90.0 release + ADDED: KDE4.0 installation instructions + ADDED: Howto executing jar files (and not enter the jar archive)? + ADDED: FAQ How don't add ".part" suffix when copying files via ftp? + ADDED: FAQ Where is Konfigurator? + + UPDATED: Howto diplay the complete filename in the Name column (by hiding ext column) + +FIXED: workaround for DBLATEX 0.2.5-1, it doesn't accept "&" to display "&" + in the <contrib> tag, so i changed it to "and" +FIXED: removed all <guimenu> tags inside <title>, no additional tags + needed inside <title>, it looks bad in HTML version (stylesheet) + +1.80.0 "Final 3rd Stone" +================================== +Date: 2007-07-05 scheduled release date + + + ADDED: Terminal Emulator, paste with SHIFT+INSERT and CTRL+V + ADDED: Vaclav's checksum patches (added sha* tools, fixed bugs etc...) + Nothing to add in the docs i guess for this feature. + ADDED: Synchronizer: ignore hidden files option + ADDED: Synchronizer-results: drag [left], SHIFT+drag [right], + Copy left/right selected items to clipboard + ADDED: Locate-results: dragging items, copy to clipboard (CTRL+C) + ADDED: Searcher-results: dragging items, copy to clipboard (CTRL+C) + + ADDED: Terminal Emulator keybindings in a separate section + + UPDATED: MacOS install instructions and fink repository, thanks to Catalin Hritcu + UPDATED: screenshots + UPDATED: make the Synchronizer chapter more readable and more undertandable + UPDATED: Command Line / Terminal Emulator chapter + UPDATED: FAQ, Sourceforge patch tracker tool + UPDATED: keybindings + UPDATED: old urls of old releases + + FIXED: removed all '_' signs in the entities for the openjade parser + +1.80.0-beta2 "Last Unstable Stone" +================================== +Date: 2007-03-31 + + ADDED: Support for useraction placeholders in Krusader's commandline + ADDED: New default user action "Backup current" + ADDED: ALT+C as default shortcut for compare directories + ADDED: GUI for configuring the atomic extensions in Konfigurator + ADDED: quotation mark handling at search (ex. "Program Files") + + ---------------------------------------------------- + Other todo items not related to Krusader's changelog: + TODO: complete Keyboard Usage + TODO: complete glossary + TODO: complete Mouse Usage + TODO: selection modes + http://krusader.sourceforge.net/phpBB/viewtopic.php?p=8255#8255 + ---------------------------------------------------- + + ADDED: Remote LAN Connections (zeroconf) + ADDED: NewsLetter Forum + ADDED: Quickstart Installation Tutorial + ADDED: FAQ: What todo if an extenal tool doesn't seem to work? + ADDED: FAQ: What todo if the KDEcrashhandler sends no usefull backtrace information? + ADDED: FAQ: How can i send good debug or crash reports? + ADDED: Brief view + + Documentation updates by the Technical Communication team of 2007, + University of Oulu, Finland http://www.oulu.fi/english/ + under the lead of Minna Hekanaho + + ADDED: FAQ: Does krusader supports the FXP protocol? + ADDED: webdav and nfs url + ADDED: FAQ: How can I set the look & Feel of 2 different users equal? + + REMOVED: Outdated and unused Italian handbook translation + +1.80.0-beta1 "The Last Krusade" +=============================== +Date: 2007-01-07 + + ADDED: full support for ACL permissions (properties, preserve attrs, synchronizer) + ADDED: actionman.png screenshot + ADDED: i18n scripts update_docbook, update_pot, update_po + They only should be used by the doc 18n coordinator + Wrong usage of this script might result in outdated documentation files + ADDED: Russian Handbook (translation is work in progress) thanks to Roman Batejkin + + ADDED: TerminalEmulator: Ctrl+F switches between full-widget TE, normal TE + (thanks to Vaclav Juza) + ADDED: Ctrl+Up from panel focuses the origin editbox, Ctrl+Down from origin + editbox focuses the panel (thanks to Vaclav Juza) + ADDED: TerminalEmulator: Ctrl+Shift+Up/Down always focus/unfocus TE + independently whether the command line is shown or not + ADDED: TerminalEmulator: if the command line is hidden, + TE receives Ctrl+Up / Ctrl+Down (thanks to Vaclav Juza) + ADDED: synchronizer: double click on a file calls the diff utility (kompare) + ADDED: atomic extensions (see CVSNEWS) + ADDED: renaming of just the filename, without extension + ADDED: full screen terminal window (mc-style) + ADDED: keeping the directory structures for virt folders at copy/move + ADDED: synchronizer, parallel threads for slow FTP servers + + ADDED: Better quick navigation: first move mouse over subdir, then + press ctrl + left mouse button (patch by Jiri Palecek) + + ------------- Docbook file splitting Design changes ------------------- +UPDATED: split up krusader-tools.docbook in smaller files +UPDATED: split up using-krusader.docbook in smaller files + ADDED: more.docbook (formerly part of using-krusader.docbook) + ADDED: diskusage.docbook (formerly part of krusader-tools.docbook) + ADDED: java.docbook (formerly part of krusader-tools.docbook) + ADDED: viewer-editor.docbook (formerly part of krusader-tools.docbook) + ADDED: locate.docbook (formerly part of krusader-tools.docbook) + ADDED: search.docbook (formerly part of krusader-tools.docbook) + ADDED: bookmarks.docbook (formerly part of krusader-tools.docbook) + ADDED: mount.docbook (formerly part of krusader-tools.docbook) + ADDED: remote-connections.docbook (formerly part of krusader-tools.docbook) + ADDED: archives.docbook (formerly part of using-krusader.docbook) + ADDED: checksum.docbook (formerly part of using-krusader.docbook) + ADDED: occupied-space.docbook (formerly part of using-krusader.docbook) + ADDED: compare.docbook (formerly part of using-krusader.docbook) + ADDED: splitter.docbook (formerly part of using-krusader.docbook) + ADDED: vfs.docbook (formerly part of using-krusader.docbook) + ADDED: profiles.docbook (formerly part of using-krusader.docbook) + ADDED: useractions.docbook (formerly part of krusader-tools.docbook) + ADDED: Mouse Commands, mouse.docbook (formerly part of using-krusader.docbook) + ADDED: Keyboard Commands, keyboard.docbook (formerly part of using-krusader.docbook) + ADDED: abc-index by using <indexterm> + ADDED: List of Figures (index) <screenshot> -> <figure> + ADDED: List of Tables (index) <informaltable> -> <table> + ADDED: release-overview.docbook (formerly part of installation.docbook) + ADDED: useraction-xml.docbook (formerly part of installation.docbook) + ADDED: configuration-files.docbook (formerly part of installation.docbook) + ADDED: help.docbook (formerly part of index.docbook) + ADDED: editorsnote.docbook (formerly part of index.docbook) + ADDED: features.docbook (formerly part of introduction.docbook) + ADDED: glossary.docbook + ---------------------------------------------------------- + + + ADDED: ActionMan for useraction configuration + ADDED: single instance mode (Konfigurator Startup) + ADDED: start to system tray (Konfigurator Startup) + ADDED: right click menu for bookmarks (context menu) + ADDED: enable/disable special bookmarks by right clicking on them + ADDED: an option for directories to be always sorted by name (Konfigurator L&F) + ADDED: FAQ: Why "save last location" doesn't work? + ADDED: Inactive panel color dimming + ADDED: FAQ: How can I send a patch? + ADDED: FAQ: Why does krusader-cvs shows an old version number in the about box? + ADDED: kioslaves: trash:/ and ipod:/ + ADDED: Subversion checkout + ADDED: Profiles chapter + ADDED: Media button, Ctrl+M, Ctrl+Shift+Left, Ctrl+Shift+Right + +UPDATED: Rename 'mark' to 'select' +UPDATED: checksum creation/verification mechanism +UPDATED: Command Reference -> Menu Commands +UPDATED: moved the "Foreword" from index.docbbook to introduction.docbook +UPDATED: Shortcut- and Toolbardialogs are removed from Konfigurator +UPDATED: Heavily extended and reordered menubar, + Updated commands.docbook (thanks to Dan Price) +UPDATED: UserActions examples in the documentation appendix +UPDATED: UserActions are now managed with ActionMan. In Konfigurator + you can change settings _about_ useractions. +UPDATED: Shortcuts are now exported in as plaintext, legacy import still works. +UPDATED: Konfigurator +UPDATED: Konfigurator: MouseMode got now it's own Tab in Look&Feel +UPDATED: Bookman and passwords +UPDATED: Copy/Move: preserve all attributes (time, owner, group) +UPDATED: New cvs checkout url + cvs.sourceforge -> krusader.cvs.sourceforge +UPDATED: FAQ +UPDATED: Command Reference +UPDATED: Marking (Selecting) files and directories +UPDATED: Virtual file systems (VFS) +UPDATED: Archives +UPDATED: Features list rewritten to make it more clear + + FIXED: KruSearcher 'ftp' group -> 'users', thanks to Roman Batejkin + +REMOVED: remoteman.png screenshot + +1.70.0 "Round Robin" +==================== +Date: 2006-01-23 + + ADDED: Help: Upload your extensions/plugins at kde.files.org + ADDED: Help: Spread the Word Krusader + ADDED: FAQ: Crashes in Krusader caused by Qt 3.3.5 + ADDED: Newsfeeds + ADDED: Krusader users mailinglist + ADDED: Mouse Gestures + ADDED: Ctrl+Alt+T to show/hide the terminal emulator + +UPDATED: F10 -> Ctrl+Q : Quit viewer/editor +UPDATED: Ctrl+D -> Ctrl+Shift+B : Detach Tab +UPDATED: Ctrl+E -> Ctrl+Shift+E : Text Viewer +UPDATED: Ctrl+H -> Ctrl+Shift+H : Hex Viewer +UPDATED: Ctrl+G -> Ctrl+Shift+G : Generic Viewer + +UPDATED: Ctrl+Alt+C -> Ctrl+W : Close Tab (panel) +UPDATED: Keybindings (major update and clean up) + + FIXED: Proofread and fixed spelling, etc. - Thanks to Richard Holt + +1.70.0-beta2 "Afterburner" +========================== +Date: 2005-11-05 + + ADDED: New logo, thanks to Andrew Neupokoev (nwmod) + ADDED: FAQ Why do i have some trouble with the media:// protocol? + ADDED: FAQ How can i close a remote connection (⪚ a FTP connection) ? + ADDED: Alt+Enter keybinding, File -> Properties + ADDED: you can turn off sending CDs to the terminal emulator (general tab) + ADDED: our own content category on kde-files.org + ADDED: useraction: View placeholder + ADDED: klik protocol + ADDED: useraction: ColSort placeholder + ADDED: FAQ Why krusader-1.60.0 does not compile with gcc4? + +screenshots: +import -depth 8 -dither -delay 2000 -colors 128 -resize 60% -frame filename.png +pngcrush --brute filename.png ./crush/filename.png + +1.70.0-beta1 "Hellfire" +======================= +Date: 2005-09-27 + + ADDED: JavaScript interface + ADDED: Quick Navigation in the Location Toolbar + ADDED: checksum creation/verification mechanism + ADDED: ctrl-alt-s creates a new symlink + ADDED: ctrl-h opens history on the active panel + ADDED: 1.70.0 (Hellfire) + ADDED: appendix: release overview + ADDED: FAQ, Why does the handbook not work? + ADDED: MacOS-X port installation instructions + ADDED: Column Headers can be changed and saved individually to each panel + ADDED: Commands -> Select Remote Charset + ADDED: credit for Matej Urbancic, Marketing & Product Research + ADDED: Accept URL's from clipboard through middle click + ADDED: permissions column as octal numbers + ADDED: clear-location-bar button, konfigurator->look'n'feel + ADDED: calculate space on remote filesystems + ADDED: when custom filter is set, the Totals label will show the filter. example: [*.cpp] + ADDED: Open the current folder in a new tab + ctrl-alt-enter keybinding + ADDED: Bookmarks as action buttons on the Toolbar, thanks Googie and Shie + ADDED: FAQ, Is there a Windows version? + ADDED: FAQ, Is there a MacOS X version? + ADDED: preserve date for local targets at copy / move + ADDED: new ./configure-switches: --without-konqueror and --without-javascript + ADDED: Keyboard Usage + ADDED: PopUp Panel (3rd Hand) -> Viewer Panel -> is a "Thumbnail viewer" on a folder + ADDED: credits for Brazilian Portuguese translation for Doutor Zero + ADDED: credits for Krusader packagers + ADDED: A Safari-like Jump-Back feature (Ctrl-J and in the bookmark-menu) + This feature is inspired by the Snap-Back feature of Apple's webbrowser Safari + ADDED: i18n help (Help Krusader) + +UPDATED: Distro's who include distro urls +UPDATED: Remote connections +UPDATED: Bookman: in kde 3.4, devices:/ is now media:/ +UPDATED: new i18n page url +UPDATED: mailing lists +UPDATED: installation $ find /usr /opt -name qtconfig -type f 2>/dev/null + $ find /usr /opt -name kdeinit -type f 2>/dev/null + thanks Dirk +UPDATED: Commands, Settings -> Save Position +UPDATED: kgstartup.png used $ import ... -resize 60% and $ pngcrush +UPDATED: Konfigurator startup page +UPDATED: FAQ, Why have i trouble with my FTP connection? + thanks to Peter J. [ pecko {*} pecko {.} sk] at http://www.pecko.sk +UPDATED: How to obtain Krusader +UPDATED: changed locate-gui shortcut from ctrl-l to ctrl+shift+l + +FIXED: Some manpage issues, thanks S�ke Dibbern + +REMOVED: RemoteMan, the FTP/SMB connection manager + RemoteMan has been replaced by our new bookmark manager since Krusader 1.25-beta1 + RemoteMan is disabled since Krusader-1.60.0 +REMOVED: remoteman.png (NOT YET DONE IN CVS, TODO) +REMOVED: Ctrl+C: Commands -> Net Connections (RemoteMan) +REMOVED: Ctrl+C+N Disconnect From Net (RemoteMan) + +1.60.0 +====================== +Date: 2005-04-15 +Final handbook revision for "Krusader 1.60.0 stable" + + ADDED: credit for Sven Opitz, for the first donation + ADDED: credit for http://usefularts.org/ + ADDED: FAQ Why mimetype magic isn't sometimes working inside archives? + ADDED: credit for Gabor Lehel (illissius) + ADDED: FAQ Why does &krusader; freezes on a dead mountpoint? + ADDED: Help Krusader: Maintainer for porting Krusader to Windows + ADDED: Help Krusader: Maintainer for porting Krusader to MacOS X + ADDED: Help Krusader: UserActions + ADDED: Version scheme (installation.docbook) + ADDED: ACE archive note (konfigurator.docbook) + ADDED: Custom Selection Mode + ADDED: useraction: new placeholder: %_ListFile()% + ADDED: Ctrl+z (popular url's) + ADDED: useraction placeholder %_Script(path/to/script.js)% + ADDED: kguseractions.png and kgprotocols.png for the HTML/RTF/PDF version + ADDED: Useractions menu entry + ADDED: credit for Terry "Fudoki" Wilkinson, documentation + ADDED: JavaScript console (incomplete description) + ADDED: Remote-man FAQ, url Bookmark transfer procedure + ADDED: Remote Connections + ADDED: Bookmarks Password handling + ADDED: Bookmarks can be placed into the Main Toolbar and the Actions Toolbars + ADDED: Popular urls in Folder History + ADDED: Ctrl+Alt+j keybinding for the JavaScript console + ADDED: Help Krusader + ADDED: Actions Toolbar + ADDED: color scheme export/import + ADDED: searcher, feed to listbox (with virtual folders) + ADDED: useraction placeholder %_ask(..)% + ADDED: PanelSize placeholder %_PanelSize% %aPanelSize("80")% + ADDED: show/hide listpanel Columns by right clicking the Column Header + ADDED: Disk Usage, Alt+D + ADDED: Useraction placeholders %_Each% and %_Move(src, dest)% + ADDED: PopUp Panel has now a Full Viewer + ADDED: Shift+DEL will delete a file permanently + ADDED: inport/export keybindings (konfigurator, look & feel) + ADDED: kio_krarc.* "Protocol not supported by Krusader" (FAQ) + ADDED: krusader-devel-ro mailing list + ADDED: Ctrl+O keybinding + ADDED: This handbook is available in several formats (HTML, TXT, RTF, PDF) + ADDED: resize to a small size even with Fn keys showing (FAQ) + ADDED: vertical-horizontal list panel, Alt+Ctrl+v + ADDED: Ctrl+Up Arrow (from the panel) goes up to the Location Toolbar + ADDED: New commandline option: --profile <panel-profile> + ADDED: UserAction Forum (faq.docbook), thanks Dirk + ADDED: 64 bit FAQ (faq.docbook), thanks Marc on our forum + http://krusader.sourceforge.net/phpBB/viewtopic.php?t=951 + +UPDATED: Krusader KDE version Requirements +UPDATED: DTD DocBook XML V4.2-Based Variant V1.1 (V4.1.2 was the previous version) +UPDATED: Synchronizer, Thanks Csaba +UPDATED: UserMenu usage +UPDATED: UserActions description +UPDATED: krusader1.png, kgstartup.png, mountman.png, search_general.png, + search_advanced.png, syncdir.png, bookmanadd.png, bookmanedit.png + all screenshots in "plastic' theme (the default kde 3.4 theme), made with Imagemagic + $ import -depth 8 -dither -delay 2000 -colors 128 -resize 70% -frame search_advanced.png + except bookmanadd.png with KSnapshot +UPDATED: first Krusader-Tools and then Konfigurator (reversed the order) +UPDATED: mark (obsolete) -> select +UPDATED: date format mm/dd/yyyy -> yyyy/mm/dd +UPDATED: Introduction and features separated into a new chapter +UPDATED: Foreword, thanks to Terry "Fudoki" Wilkinson +UPDATED: Toolbar -> Main Toolbar (due to the Actions Toolbar) +UPDATED: remoteman was disabled. from now on, Bookmark Manager only +UPDATED: Commands - New Net Connection: FTP, SMB, FISH or SFTP connection +UPDATED: mouse selection mode +UPDATED: Function (FN) Keys Bar - keybindings are now configurable +UPDATED: Amarok useraction, thanks Dirk (installation.docbook) + + FIXED: Proofread and fixed spelling, etc. - Thanks to Terry "Fudoki" Wilkinson + +1.51.00 +====================== +Date: 2004-11-28 + +Richard Holt is now an official member of the documentation team. +Welcome aboard Richard! + FIXED: many typos fixed - Thanks to Richard Holt + +1.50.04 +====================== +Date: 2004-11-19 + + FIXED: Proofread and fixed spelling etc. - Thanks to Richard Holt + FIXED: uncommented <?xml version="1.0" ?> in index.docbook + FIXED: removed some acronym elements, the jade parser does not like them + FIXED: <imagedata fileref="foo.eps" ...> -> foo.png +REMOVED: bookmanuse.png not used anymore since hanbook 1.00.02 + ADDED: useraction: Parameter-description for the placeholder + +1.50.03 +====================== +Date: 2004-11-04 + + FIXED: doc/pics/Makefile.am did not remove krusader_title.png & + tabbed_browsing.png when running 'make uninstall' + ADDED: syncdir.png +REMOVED: kglookfeel.png kggeneral.png kgadvanced.png kgarchives.png + in cvs but not in the html documentation + ADDED: FAQ: Does Krusader need KDE? +UPDATED: required KDElib versions +UPDATED: User Actions, thanks for the feedback Jonas Bähr + FIXED: Proofread and fixed spelling, etc. - Thanks to Mark Eatough +UPDATED-FIXED: many small issues + +1.50.02 +====================== +Date: 2004-10-25 + +ADDED: useraction.xml +ADDED: FAQ Nvdia/libGLcore.so.1 compile problem, Thanks Falo and Rafi +UPDATED-FIXED: many small issues + +1.50.01 CVS +====================== +Date: 2004-10-08 + + ADDED: MacOS-X port, Thanks Jonas + ADDED: Compare Directories, Thanks Csaba + ADDED: Konfigurator: arj, lha, kget + ADDED: Konfigurator: protocols, Thanks Csaba + ADDED: Faster navigation in bookmarks, Thanks Shie + ADDED: FAQ How can i disable the default sounds, Thanks thepieman +UPDATED: Synchronizer, Thanks Csaba +UPDATED: Usermenu - Useractions, Thanks Jonas +UPDATED: New TODO forum and NEWS forum +UPDATED-FIXED: many small issues + +1.50.00 CVS +====================== +Date: 2004-08-15 + + ADDED: Synchronizer: multiple include/exclude filter example + ADDED: Dropping URL's onto the status bar / totals line, Thanks Csaba + ADDED: FAQ IRC channel + ADDED: FAQ Debian Qt issue, Thanks Eugen Albiker + ADDED: Sync-browse mode, Thanks Jonas + ADDED: Usermenu, Thanks Jonas + ADDED: 3rd hand of krusader, Thanks Shie +REMOVED: Tree Panel, Quick View Panel -> is now "3rd hand of krusader" +REMOVED: <informalexample> docbook entity in installation.sgml + (gives a double console rectangle in cobination with <screen> under KDE3.2) +UPDATED-FIXED: many small issues + +1.40.02 +====================== +Date: 2004-07-21 +Final handbook revision for "Krusader 1.40 stable" + + ADDED: Krusader Handbook logo for the HTML version +UPDATED: Konfigurator +UPDATED: Credits +UPDATED: KIOSlave +UPDATED: Screenshots +UPDATED: some obsolete issues +UPDATED: Origin Button -> Location Toolbar +UPDATED: usage of more default KDE Docbook entities, often located in + /usr/share/apps/ksgmltools2/customization/en/ + /usr/share/apps/ksgmltools2/customization/entities/ +UPDATED-FIXED: many small issues + +1.40.01 +Date: 2004-05-17 +UPDATED: RPM FAQ + ADDED: FAQ How can i translate Krusader to my native language? +UPDATED-FIXED: many small issues + +1.40.00 +====================== +Date: 2004-04-22 +FIXED: Proof read and fixed spelling etc. - Thanks to Mark Eatough + +1.40.00-beta1 Date: 2004-03-29 + ADDED: configuring the colors of the panel - Thanks to Heiner Eichmann + ADDED: Quickmode for MountMan - Thanks to Shie Erlich +UPDATED: Konfigurator screenschots + +1.31.01 Date: 2004-03-04 + ADDED: locate (using-krusader.sgml) - Thanks to Karai Csaba + ADDED: Right click menu (using-krusader.sgml) +UPDATED: FAQ's "krusaderui.rc" file issue, - Thanks to Karai Csaba +UPDATED-FIXED: many small issues + +1.31.00 +====================== +Date: 2004-02-12 +From now on the <releaseinfo> tag always matches the Krusader version number that is +described in the documentation, e.g., "Krusader Handbook version 1.31.xx" +describes "Krusader version 1.31" + + ADDED: New Quicksearch (using-krusader.sgml) - Thanks to Heiner Eichmann + ADDED: Folder history (using-krusader.sgml) - Thanks to Hans Loffler + ADDED: appendix: configuration files (installation.sgml) +UPDATED: New Konfigurator (konfigurator.sgml) - Thanks to Karai Csaba +UPDATED: I try to follow the guidelines in "The KDE DocBook Authors guide" + but sometimes I don't do it. ;-) +UPDATED: FAQ's (faq.sgml) +UPDATED: Calculate occupied space (using-krusader.sgml) - Thanks to Heiner Eichmann +UPDATED: Krviewer (krusader-tools.sgml) +UPDATED: new package description - Thanks to Jonas Bähr +UPDATED-FIXED: many small issues +Date: 01.02.2004 + FIXED: Proofread and fixed spelling, etc. - Thanks to Mark Eatough +Date: 06.01.2004 + ADDED: User Menu (commands.sgml) - Thanks to Shie Erlich +UPDATED: manpage (krusader.1) +UPDATED: directory synchronisation (moved to krusader-tools.sgml) - Thanks to Karai Csaba +UPDATED: From: DocBook XML V4.1-Based Variant V1.0//EN + To: DocBook XML V4.1.2-Based Variant V1.1//EN + +1.00.05 +====================== +Date: 2003-12-21 + FIXED: added package entity for compilation under KDE3.2-beta2 (index.docbook) + ADDED: file splitter (using-krusader.sgml) + ADDED: directory synchronisation (using-krusader.sgml) +UPDATED: Commands Reference (commands.sgml) +UPDATED: install procedure (installation.sgml) +UPDATED: Questions and Answers (faq.sgml) +UPDATED: many small issues + FIXED: many small issues + FIXED: spelling mistakes/typos corrections + proofreading, thanks to Mark Eatough + +1.00.04 +====================== +Date: 2003-11-26 +UPDATED: Konfigurator (konfigurator.sgml) +UPDATED: KruSearcher (krusader-tools.sgml) +UPDATED: Questions and Answers (faq.sgml) krarc slave issue + Thanks to Karai Csaba + ADDED: Key Bindings (using-krusader.sgml) + ADDED: Starting Krusader (installation.sgml) + ADDED: Note from the Editors (installation.sgml) + FIXED: spelling mistakes/typos corrections + proofreading, thanks to Mark Eatough + +1.00.03 +====================== +Date: 2003-11-15 +ADDED: Krviewer (krusader-tools.sgml), thanks to Rafi Yanai + +1.00.02 +====================== +Date: 2003-10-23 +KRUSADER MANPAGE: ADDED: ~/.kde/share/apps/krusader/krbookmarks.xml + +UPDATED: cmdline.png, fnkeys.png, krusader1.png, listpanel.png + mainwindow.png, terminalEmu.png, toolbar.png (using-krusader.sgml) +UPDATED: BookMan, bookmanadd.png, bookmanedit.png (krusader-tools.sgml) +REMOVED: bookmanuse.png (using-krusader.sgml) [actually, not till 1.50.04 :] +UPDATED: Note: RemoteMan wil be removed (krusader-tools.sgml) + ADDED: tabbed browsing, tabbed_browsing.png (using-krusader.sgml) +UPDATED: Tree Panel, Quick View Panel, + Note: temporarily disabled since Krusader 1.12-beta1 --will be rewritten, sorry. + small issues, Compare mode (using-krusader.sgml) +UPDATED: Chapter 3. Command Reference (commands.sgml) + ADDED: Questions and Answers (faq.sgml) Samba codepage issue + Thanks to Karai Csaba + ADDED: krusader_title.png (introduction.sgml) +UPDATED: Introduction (introduction.sgml) + Krename, Bookmark, Tabbed Browsing, Root mode, screenshot krusader1.png + +1.00.01 +====================== +Date: 2003-10-05 +UPDATED: installation (installation.sgml) +UPDATED: Frequently Asked Questions and Answers (faq.sgml) +UPDATED: Credits and License (credits.sgml) + ADDED: NOTE: We are busy with updating the The Krusader Handbook. (index.docbook) +UPDATED: small issues, eg., KDE2.x -> 3.x (index.docbook) +The Krusader Handbook is now continued and maintained by Frank Schoolmeesters. + +1.00.00 +================== +Date: 2002-01-01 +Initial version +Written by Shie Erlich and Rafi Yanai. + diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 0000000..4d78d65 --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,15 @@ +####### kdevelop will overwrite this part!!! (begin)########## + +SUBDIRS = en ru pics + +EXTRA_DIST = krusader.1 + +install-data-local: + $(mkinstalldirs) $(DESTDIR)$(mandir)/man1/ + $(INSTALL_DATA) $(srcdir)/krusader.1 $(DESTDIR)$(mandir)/man1/krusader.1 + +uninstall-local: + -rm -f $(DESTDIR)$(mandir)/man1/krusader.1 + +####### kdevelop will overwrite this part!!! (end)############ + diff --git a/doc/actions_tutorial.txt b/doc/actions_tutorial.txt new file mode 100644 index 0000000..257def5 --- /dev/null +++ b/doc/actions_tutorial.txt @@ -0,0 +1,70 @@ +A Short Tutorial for the User Actions System +============================================ +Go to the Konfigurator and choose "Useractions". There you manage all your +actions. If you add an new action, you get an empty input-mask where you can +enter all the properties. The action will be added as soon as you press "ok". +Now it's shown in the list on the left. + +You can choose it if you want to edit the properties (the changes will take +effect if you press OK), remove it (per default you will be asked again if +you realy want to delete it but you can disable it by checking "don't ask me again"). + +If you export a useraction you have to give a file where to store it. If it +does not exists it will be created. If it contains already some useractions, +the action you're exporting will be added to that file. + +If you import some actions they will be added automaticly to your list. If +there are name-conflicts (the names have to be unique because these are the +ID for KDE's action-system) you're asked to resolve them. For this, the list on +the left will only show the actions where conflicts exists. You now can give +them new names or remove them. + +All actions you've defined are now shown in the usermenu and in KDE's dialogs +for changing shortcuts and managing the toolbar. In addition all actions +which are available for the current item will also show up in the rightclick +menu. + +The fields of the properties are (* are required): +name*: a unique name of the action, used to identiy it for KDE's action-system +title*: the title displayed in the menus/dialogs +icon: the icon for you action +tooltip: a tooltip for your action - i.e. displayed in the toolbar on mouseover +desctiption: a description of what the action is doing. +command*: that is the command which is finaly executed. you can add + placeholder using a GUI with the 'add'-button +startpath: the working-directory for your command execution-mode should be clear +command eccepts: tells if the placeholder should return local addesses or URLs +Default shortcut: the action will be init with this shortcut + +On the advanced-tab you can say where your command should be visible (for the +rightclick-menu). In addition it's possibe to change the command executed and +confirm it separately. You can also set a user under which the command should +be executed. + +There are basicly two kinds of placeholders: +1) those who access internal functions of Krusader +2) those who are are replaced by a string. + +it's important to know that the first category is performed at expansion-time, +meaning that the extra confirmation has only effect on programms which are +executed, not on internal functions (which aree called earlyer) + +The list of placeholders is accessable via the 'add' button. +Some Placeholders can get parameters, for those is also a GUI provided. +The following list is already implemented: + Path replaced by the panels path + Count replaced by the number of <first parameter> + Filter replaced by the panels filter-mask + Current replaced by the current item + List replaced by a list of all <first paremeter> + Select manipulates the selection in a panel + Goto changes the panels's path to <first parameter> + Ask asks the user for a some text and is replaced by the answer + Clipboard manipulates the clipboard + Copy copies a file, useful for quick, local, backups + Sync opens the Synchronizer with a given profile + NewSearch opens the search-windows with a given profile + Profile loads a given panel-profile + +Enjoy, + diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am new file mode 100644 index 0000000..dc8b999 --- /dev/null +++ b/doc/en/Makefile.am @@ -0,0 +1,11 @@ +####### kdevelop will overwrite this part!!! (begin)########## + + +EXTRA_DIST = archives.docbook editors-note.docbook java.docbook profiles.docbook user-interface.docbook bookmarks.docbook more.docbook faq.docbook keyboard.docbook release-overview.docbook using-krusader.docbook checksum.docbook features.docbook konfigurator.docbook remote-connections.docbook vfs.docbook commands.docbook glossary.docbook krusader-tools.docbook search.docbook viewer-editor.docbook compare.docbook help.docbook locate.docbook splitter.docbook configuration-files.docbook index.docbook mount.docbook synchronizer.docbook credits.docbook installation.docbook mouse.docbook useractions.docbook diskusage.docbook introduction.docbook occupied-space.docbook useraction-xml.docbook + +####### kdevelop will overwrite this part!!! (end)############ + +KDE_LANG = en +KDE_DOCS = krusader + + diff --git a/doc/en/archives.docbook b/doc/en/archives.docbook new file mode 100644 index 0000000..a94afe1 --- /dev/null +++ b/doc/en/archives.docbook @@ -0,0 +1,125 @@ +<sect1 id="archives"> + <title>Archive Handling</title> + <indexterm> + <primary>Archives</primary> + </indexterm> + <sect2 id="browsing-archives"> + <title>Browsing Archives</title> + <para>The &vfs-lnk; allows you to browse archives as + if it was a directory. Currently &krusader; supports + the following archives types: ace, arj, bzip2, deb, gzip, iso, + lha, rar, rpm, tar, zip and 7-zip and supports the following + passworded archives: arj, ace, rar and zip. Passwords can be + stored in &kwallet;. Please note that the archive + support first needs to be properly + <link linkend="konfig-archives">configured</link> in + Konfigurator. To open the archive, use &Enter;, + (double-)click or the + <keycap>Right Arrow</keycap>. &krusader; supports + also + <emphasis role="bold">hidden archives</emphasis>, these are + renamed archives with a *wrong* extension, ⪚ + &openoffice; uses zip archives with the following + extensions: odt, sxw and odw. &Enter; will open the + &openoffice; document and the + <keycap>Right Arrow</keycap> will open the archive. Another + example is J2EE, where the rar extension means a zip archive. + Since &krusader; auto-detects the supported archive + types, it will open with + <keycap>Right Arrow</keycap> even if it has another mime type. + Please note that browsing archives has a few limitations: + <itemizedlist> + <listitem> + <para>Not all functions are supported by all archive types. + (&ie;: you can not delete files in ace or rar + archives)</para> + </listitem> + <listitem> + <para>The permissions you have inside the archive are the + same as the permissions you have for the archive.</para> + </listitem> + <listitem> + <para>The command line (if visible) will not follow you + inside the archive but will point to the archive + directory.</para> + </listitem> + <listitem> + <para>Before any action is performed on files/directories + inside the archive, they must be extracted. The archive + will be repacked when you leave it or when + &krusader; detects that extracted files have + changed.</para> + </listitem> + <listitem> + <para>Packing and un-packing are "blocking operations" that + display a progress dialog. However, this might change in + the future since we are planning to create more background + operations.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="unpacking-archives"> + <title>Unpack Files</title> + <para>There are 2 ways to extract files from archives:</para> + <para>If you want to unpack a whole archive(s), browse to the + archive location, select the archive(s) and select + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Unpack</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Alt; + <keycap>U</keycap></keycombo>. &krusader; will ask + you where to put the extracted files. The default location is + the inactive panel directory. If you don't cancel the + operation, &krusader; will try to unpack all the + selected files in the inactive panel.</para> + <para>If you only want to extract a part of the archive, then + <link linkend="browsing-archives">browse</link> the archive and + copy the files you want to extract to their new location just + as you would copy "normal" files. Note that unpacking from a + browsed archive takes more time (file by file unpack) compared + to unpacking a whole archive with the first method.</para> + </sect2> + <sect2 id="pack-archive"> + <title>Packing Files</title> + <para>If you want to create a new archive, begin by selecting + the elements you want to pack in the active panel and select + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Pack</guimenuitem> + </menuchoice> + </emphasis> or + <keycombo action="simul">&Alt; + <keycap>P</keycap></keycombo>. A dialog will pop-up prompting + you to select the archive name and location. Select the packer + from one of the + <link linkend="konfig-archives">supported file name + extensions</link>.</para> + <para>To add files to an existing archive(s), open the archive + in one panel and the files to be copied in the other panel, + then simply copy the files into the archive in exactly the same + way you copy files into a "normal" directory.</para> + </sect2> + <sect2 id="test-archive"> + <title>Testing Archives</title> + <para>Krusader will not handle corrupted archives since it may + result in data loss. If you receive an error message when + opening an archive, or if you suspect that there is something + wrong with the archive, you should test it before use. To test + an archive, browse (navigate) to the archive location and + select the archive. Next select + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Test Archive</guimenuitem> + </menuchoice> + </emphasis> or + <keycombo action="simul">&Alt; + <keycap>E</keycap></keycombo>. &krusader; will test + the archive file and inform you whether the archive passed or + failed the file integrity test.</para> + </sect2> +</sect1> diff --git a/doc/en/bookmarks.docbook b/doc/en/bookmarks.docbook new file mode 100644 index 0000000..9817d77 --- /dev/null +++ b/doc/en/bookmarks.docbook @@ -0,0 +1,289 @@ +<sect1 id="bookman"> + <title>BookMan: Organize your Bookmarks</title> + <indexterm> + <primary>Bookmarks</primary> + </indexterm> + <para>BookMan is &krusader;'s Bookmark tool for + bookmarking folders, local- and + <link linkend="remote-connections">remote URL's</link>, and later + returning to them in a click of a button. The Bookman menu is + divided into four sections: + <itemizedlist> + <listitem> + <para>Your personal bookmarks</para> + </listitem> + <listitem> + <para>Popular &URL;'s</para> + </listitem> + <listitem> + <para>Permanent bookmarks</para> + </listitem> + <listitem> + <para>Manage bookmarks</para> + </listitem> + </itemizedlist></para> + <note> + <para>You can bookmark inside a remote file system + (&FTP; or SAMBA) and later use the bookmark to + quickly connect to the remote machine, but you cannot bookmark + inside an archive.</para> + </note> + <!-- OLD +<screenshot> + <screeninfo>Bookmark menu</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="bookmanadd.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="bookmanadd.png" format="EPS"/></imageobject> + <textobject><phrase>BookMan: the Bookmark menu</phrase></textobject> + <caption><para>Bookmark menu</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-bookmanadd" float="1"> + <title>Bookmark menu</title> + <mediaobject> + <imageobject> + <imagedata fileref="bookmanadd.png"></imagedata> + </imageobject> + <textobject> + <phrase>Bookmark menu</phrase> + </textobject> + </mediaobject> + </figure> + <sect2 id="using_bookmarks"> + <title>Using Bookmarks</title> + <para>Usually, you click on the + <guibutton>Bookmark</guibutton> button when you are in the target + folder. For example, to bookmark + <filename class="directory">/usr/tmp</filename>, navigate + &krusader; there and click the + <guibutton>Bookmark</guibutton> button and select + <guimenuitem>Bookmark Current</guimenuitem>. When the + <guilabel>Bookmark Current</guilabel> dialog box appears, the + &URL; line will say + <filename class="directory">/usr/tmp</filename>. + <guilabel>Name</guilabel> is for the name you would like to give + to the bookmark (e.g.: temporary folder). Hotkeys are supported + by adding + <literal>&</literal> to the bookmark name + ⪚ + <literal>&sourceforge, &home, + down&loads</literal> &etc;, so you can + quickly call the bookmark name with + <keycombo action="simul">&Alt; + <keycap>foo</keycap></keycombo>. If you add the bookmark + without entering a name, the bookmarks name will be the same as + its target. + <guilabel>URL</guilabel> + <!-- Openjade does not like an acronym element for "URL" here --> + is where the bookmark points to. + <guilabel>Create in</guilabel> creates bookmark folders for + organizing your bookmarks.</para> + <para>To use your bookmarks, click the + <guibutton>Bookmark</guibutton> button and choose a bookmark. + You may also use the &keybindigs-lnk; : + <keycombo action="simul">&Ctrl;&Shift; + <keycap>d</keycap></keycombo> to bookmark the current item, + <keycombo action="simul">&Alt; + <keycap>right/left arrow</keycap></keycombo> to + <keycap>open right/left panel bookmarks list</keycap> and + <keycombo action="simul">&Ctrl; + <keycap>d</keycap></keycombo> to open the bookmarks of the + active panel. A &MMB; click on bookmarks opens them + in a new + <link linkend="folder-tabs">Folder tab</link>.</para> + <para>Navigation in bookmarks: + <orderedlist> + <listitem> + <para>Start typing letters</para> + </listitem> + <listitem> + <para>⪚ when you type + <literal>'h'</literal> and only one bookmark starts with + <literal>'h'</literal>, it is executed immediately - no + enter needed</para> + </listitem> + <listitem> + <para>If more than one bookmarks begins with + <literal>'h'</literal>, you will have to continue adding + letters, until you have specified enough and again, the + bookmark is executed.</para> + </listitem> + </orderedlist></para> + </sect2> + <sect2 id="password_handling"> + <title>Password handling</title> + <para>One of the benefits of the + <link linkend="bookman">bookmark manager</link> is that the + passwords are saved using &kde;'s services - where + ⪚ your &konqueror;/&kmail; + password are saved. If you have a wallet, &kde; will + save the passwords there. By clicking the bookmarks, a dialog + will open and ask for your username and password. Supply them + and click 'save password'. The passwords and usernames will be + saved securely by &kde;'s wallet (make sure it is + enabled by your distro). The downside here is that if you + reinstall and do not backup your passwords from the wallet as + well as &krusader;'s bookmark file, something will + be lost.</para> + </sect2> + <sect2 id="popular-urls"> + <title>Popular URL's</title> + <indexterm> + <primary>Popular URL's</primary> + </indexterm> + <para>The submenu + <guilabel>Popular URL's</guilabel> + <!-- Openjade does not like an acronym element for "URL" here --> + holds persistent the most popular visited &URL;'s + (local or remote). This submenu displays the top 15 popular + URLs, sorted by ranking, so that the top &URL; is + the most popular. This is easy for when you need to visit + &URL;s often, but do not want to create + &bookmarks-lnk;, it serves as a temporary bookmark + list for the most visited links. + <guilabel>Quicksearch Popular URL's</guilabel> is a fast way to + browse/select the popular &URL;s: + <itemizedlist> + <listitem> + <para>Open the + <guilabel>Popular URL's</guilabel> + <!-- Openjade does not like an acronym element for "URL" here --> + or use + <keycombo action="simul">&Ctrl; + <keycap>z</keycap></keycombo></para> + </listitem> + <listitem> + <para>Type a few letters to narrow the search</para> + </listitem> + <listitem> + <para>Press enter (you will go to the &URL; + list)</para> + </listitem> + <listitem> + <para>Press enter again and the panel is refreshed</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="permanent_bookmarks"> + <title>Permanent bookmarks</title> + <para>These are hardcoded bookmarks to the top bookmark menu; + there is no need for them to be saved to the file. With the + &context-menu-lnk; you can enable/disable these + permanent bookmarks. The following permanent bookmarks are + available: + <itemizedlist> + <listitem> + <para> + <guilabel>Media</guilabel> uses &kde;'s + <link linkend="konfig-advanced">Media protocol</link> + <filename>media:/</filename></para> + </listitem> + <listitem> + <para> + <guilabel>Local Network</guilabel> uses &kde;'s + <filename>lan:/</filename> protocol.</para> + </listitem> + <listitem> + <para> + <guilabel>Virtual Filesystem</guilabel> &vfs-lnk; + + <filename>virt:/</filename> is not a virtual folder, but a + container for &URL;'s from different file + systems. It is used for ⪚ the + <guilabel>Feed to Listbox</guilabel> feature of the search + module and the synchronizer. The location toolbar will + display ⪚ + <filename>virt:/Search results 1</filename> or + <filename>virt:/Synchronise results 1</filename>.</para> + </listitem> + <listitem id="jump_back"> + <para> + <guilabel>Jump back</guilabel> or + <keycombo action="simul">&Ctrl; + <keycap>J</keycap></keycombo> brings you back to your + starting position when you did create a new tab in the + panel window. This feature is very handy if you go deep + into a directory tree, than you can return with one action + to the starting point. With + <guilabel>Set jump back point here</guilabel> or + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>J</keycap></keycombo> sets the current directory as + a jump back point.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="manage_bookmarks"> + <title>Manage bookmarks</title> + <para>To edit and organize your bookmarks, by clicking the + <guibutton>Bookmark</guibutton> button and selecting the + <guimenuitem>Manage Bookmarks</guimenuitem>, + &keditbookmarks; will be displayed. This is where + you can edit/remove and rearrange the bookmarks. + &keditbookmarks; (part of the kdebase package) is a + bookmark editor for &konqueror;, + &krusader; and other applications, which use the + &xbel-url; standard for the bookmark format. The + bookmarks are stored in + <filename> + ~/.kde/share/apps/krusader/krbookmarks.xml.</filename></para> + <para>You can import bookmarks from + <application>IE</application>, + <application>Opera</application>, + <application>Galeon</application>, &kde;, + <application>Mozilla</application>, &Netscape;. + &keditbookmarks; is easy to use, however, if you + need more information, please read the + &keditbookmarks; or the &konqueror; + handbook.</para> + <!-- OLD +<screenshot> + <screeninfo>&keditbookmarks; Bookmark Manager</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="bookmanedit.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="bookmanedit.png" format="EPS"/></imageobject> + <textobject><phrase>&keditbookmarks; edit and organize your Bookmarks</phrase></textobject> + <caption><para>&keditbookmarks;: Bookmark Manager.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-bookmanedit" float="1"> + <title>&keditbookmarks; Bookmark Manager</title> + <mediaobject> + <imageobject> + <imagedata fileref="bookmanedit.png"></imagedata> + </imageobject> + <textobject> + <phrase>&keditbookmarks; Bookmark + Manager</phrase> + </textobject> + </mediaobject> + </figure> + </sect2> + <sect2 id="bookmark_buttons"> + <title>Bookmarks as action buttons on the Toolbar</title> + <para>Bookmarks can be placed as buttons on the + &main-toolbar-lnk; or the + &actions-toolbar-lnk;. You can even make a + key-binding for them: + <itemizedlist> + <listitem> + <para>Create your &bookmarks-lnk;.</para> + </listitem> + <listitem> + <para>If you want, create keybindings for the bookmarks in + the + <guilabel>Key-bindings</guilabel> section of the + &konfiglookandfeel-lnk;.</para> + </listitem> + <listitem> + <para>Add your bookmarks as action buttons on the + &main-toolbar-lnk; or the + &actions-toolbar-lnk; with the + <guilabel>Toolbar</guilabel> section of the + &konfiglookandfeel-lnk;.</para> + </listitem> + </itemizedlist></para> + </sect2> +</sect1> diff --git a/doc/en/checksum.docbook b/doc/en/checksum.docbook new file mode 100644 index 0000000..e6a3c0b --- /dev/null +++ b/doc/en/checksum.docbook @@ -0,0 +1,34 @@ +<sect1 id="checksum"> + <title>Checksum creation-verification</title> + <indexterm> + <primary>Checksum</primary> + </indexterm> + <para> + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Create Checksum</guimenuitem> + </menuchoice> + </emphasis>: &krusader; checks which tools you have + and if those tools allow recursive operation (in case you + selected folders), you can generate a checksum by choosing a + checksum type from the list (md5, sha...). You can then save the + checksum to a file, usually called checksum.md5 or + checksum.sha1.</para> + <para> + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Verify Checksum</guimenuitem> + </menuchoice> + </emphasis>: &krusader; checks if you have a tool that + supports the type of checksum you need (from your specified + checksum file) and displays the files that failed the checksum + (if any).</para> + <para>The system abstracts over different checksum mechanisms and + Checksum Utilities. At the moment, the following checksums are + supported: md5, sha1, sha256, sha224, sha256, sha384, sha512, + tiger, whirlpool, cfv and crc. Please check your + <link linkend="konfig-dependencies">Checksum Utilities + settings</link> before using this function.</para> +</sect1> diff --git a/doc/en/commands.docbook b/doc/en/commands.docbook new file mode 100644 index 0000000..54b6336 --- /dev/null +++ b/doc/en/commands.docbook @@ -0,0 +1,2129 @@ +<chapter id="menu-commands"> + <!-- ********************************************************************** + commands.docbook + ++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Menu Commands</title> + <indexterm> + <primary>Commands</primary> + <secondary>Menu</secondary> + </indexterm> + <sect1 id="file-menu"> + <title>File Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F4</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>New Text File</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a new text file in the current directory, + unless another directory is specified. The new file is + opened for editing after it is created.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F7</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>New Directory</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a new directory in the current + directory.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>S</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>New Symlink</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a symbolic link to the currently selected + file.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F3</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>View File</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the currently selected file for + <link linkend="kredit">viewing</link>.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F4</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Edit File</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the currently selected file for + <link linkend="kredit">editing</link>.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F5</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Copy</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a dialog to + <link linkend="copying">copy</link> the currently selected + files or directories to a specified location.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F6</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Move</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a dialog to + <link linkend="copying">move</link> the currently selected + files or directories to a specified location.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>P</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Pack</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a + <link linkend="pack-archive">new archive</link> of all the + selected files and directories in the active + panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Unpack</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="unpacking-archives">Unpacks</link> all the + selected files in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>E</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Test Archive</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="test-archive">Tests archive</link> for + corruption.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Compare by content</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Compares two current files by content - one from + each panel via an external graphical diff utility. By + default &kompare; (part of the kdebase + package) is used, but you can also use ⪚ + &xxdiff-url; or &kdiff3-url; , + change it in the + &konfigdependencie-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry id="multi_rename"> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F9</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Multi Rename</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>This menu option starts &krename-url; a + very powerful external batch renamer for &kde; + 3.x.</para> + <itemizedlist> + <title>Krename Features</title> + <listitem> + <para>Renaming a list of files based on a set of + expressions</para> + </listitem> + <listitem> + <para>Copying/moving a list of files to another + directory</para> + </listitem> + <listitem> + <para>Convert filenames to upper/lower case</para> + </listitem> + <listitem> + <para>Adding numbers to filenames</para> + </listitem> + <listitem> + <para>Finding and replacing parts of the + filename</para> + </listitem> + <listitem> + <para>Renaming MP3/OGG Vorbis files based on their + ID3 tags</para> + </listitem> + <listitem> + <para>Setting access and modification dates</para> + </listitem> + <listitem> + <para>Changing permissions and file ownership</para> + </listitem> + <listitem> + <para>A plug-in API which allows you to extend + Krename's features</para> + </listitem> + <listitem> + <para>Renaming directories recursively</para> + </listitem> + <listitem> + <para>Support for KFilePlugins</para> + </listitem> + <listitem> + <para>Create undo file</para> + </listitem> + <listitem> + <para>And many more....</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Create Checksum</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="checksum">Checksum creation</link> on + file(s) and/or folder(s).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Verify Checksum</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="checksum">Verify Checksum</link> + </para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>P</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Split file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The &splitfile-lnk; function splits a + file up into multiple smaller files so that it can be + stored on several smaller media (like + <hardware>diskettes, zip-drives, ...</hardware>) or sent by + e-mail.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>B</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Combine files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The &combinefiles-lnk; function combines + multiple files into one file after the + &splitfile-lnk; function was used.</para> + </listitem> + </varlistentry> + <!--vertical bar --> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Q</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Quit</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Closes &krusader; and cleans up the + temporary directory, the same as pressing + <keycap>F10</keycap> key.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="edit-menu"> + <title>Edit Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>X</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Cut to Clipboard</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="copying">Cuts</link> the selected file(s) + to the clipboard to be moved to another location.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>C</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Copy to Clipboard</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="copying">Copies</link> the selected file(s) + to the clipboard to be moved to another location.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>V</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Paste from Clipboard</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="copying">Pastes</link> previously cut or + copied items from the clipboard to the current + directory.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F9</keycap> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Rename</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="renaming">Renames</link> the currently + selected file.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F8</keycap> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Delete</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="deleting">Deletes</link> the currently + selected file(s).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>+</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Select Group</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a dialog which allows you to select files in + the active panel. In the + <guilabel>Search for</guilabel> dialog place the main + search criteria. Enter a filename, a wildcard ( + <literal role="extension">*.o.*</literal>, + <literal role="extension">*.c</literal> &etc;) + or both - separated by a space. When using + <literal>'text'</literal>, the results are the same as + <literal>'*text*'</literal>. You can exclude files from + the search with '|' (⪚ + <literal role="extension">'*.cpp *.h | + *.moc.cpp'</literal>). With the + <link linkend="profiles">profile handler</link> you can + manage your selections for future usage. A double-click + on a profile is the same as entering the selection and + pressing the + <guibutton>OK</guibutton> button. More options for + <guilabel>Select Group</guilabel> dialog are explained in + the + <link linkend="krusearcher">Search dialog</link>, which + are basically almost the same dialogs.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>-</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Unselect Group</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The opposite of + <guimenuitem>Select Group</guimenuitem>. The files that + match the pattern in the active panel will be + deselected.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>+</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Select All</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Selects all files in the active panel. You can also + select all directories by activating the + <guilabel>Automark directories</guilabel> option in the + &konfiglookandfeel-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>-</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Unselect All</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unselects all the files in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>*</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Invert Selection</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Inverts the selection status of all the files in + the active panel (&ie; selected files will + become unselected and deselected files will become + selected).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>C</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Compare Directories</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggles &krusader; + &comparedir-lnk; function.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Edit</guimenu> + <guimenuitem>Compare setup</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Configures the + <guimenuitem>Compare Directories</guimenuitem> function.</para> + <itemizedlist> + <listitem> + <para> + <guimenuitem>Select Newer and Single</guimenuitem> (default)</para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Newer</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Different and Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Different</guimenuitem> + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Edit</guimenu> + <guimenuitem>Calculate Occupied Space</guimenuitem> + </menuchoice> + </term> + <listitem> + <para> + <link linkend="calculate">Calculates occupied + space</link> of files and folders, archives and remote + filesystems.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>KP_Enter</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Properties</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the properties dialog for the currently + selected file. (KP refers to Key Pad.)</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="view-menu"> + <title>View Menu</title> + <para>The action in this submenu usually affects the current + &krusader; session. If you want to make permanent + changes use &konfigstartpg-lnk;.</para> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Shift; + <keycap>D</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Detailed View</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the file names, file size, creation date and time and their attributes.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Shift; + <keycap>B</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Brief View</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows only the file names.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>.</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Show Hidden Files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggles the option to display the hidden files in + the &krusader; panels.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F10</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>All Files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Turns off all filters and display all files.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F12</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Custom</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Allows you to install a custom filter on the + &krusader; panel. Only files that match the + filter pattern(s) and directories will be displayed. Do + not forget to deactivate the custom filter after use, or + some files may not be visible.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Select Remote Charset</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Selects the remote charset for + &remote-connections-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>R</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Reload</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Refreshes the contents of the active panel.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="go-menu"> + <title>Go Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>Go</guimenu> + <guimenuitem>Back</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the previously viewed directory in the + active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>PageUp</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Up</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the parent directory of the active + panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Backspace</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Root</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the root directory of the + system.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Home</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Home</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the home directory of the current + user.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Z</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Popular URLs</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Displays a listing of frequently viewed directories + from which you may navigate to one by double-clicking on + it.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>J</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Set Jump Back Point</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Sets the current directory as a "jump back" point. + To navigate to this directory quickly, select the "Jump + Back" command from the Go Menu.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>J</keycap></keycombo> + </shortcut> + <guimenu>Go</guimenu> + <guimenuitem>Jump Back</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Returns to a previous "jump back" point.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="useractions-menu"> + <title>Useractions Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Manage useractions</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the &useractions-lnk; + manager.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Your own Useractions</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the default user actions and those + created by the user.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Equal panel-size</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Sets the ratio between the two panels to + 50/50.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>1</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Sort By Name</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>When this action is turned on, the main sorting key + in the &krusader; panel becomes the file + name.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>2</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Sort By Extension</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>When this action is turned on, the main sorting key + in the &krusader; panel becomes the file + extension (the part of the filename after the last '.'). + This is useful for grouping files of the same type closer + together.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>3</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Sort By Size</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>When this action is turned on, the main sorting key + in the &krusader; panel becomes the file size. + This is useful for determining the largest files in a + particular directory.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>4</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Sort By Modified</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>When this action is turned on, the main sorting key + in the &krusader; panel becomes the last + modified date for each file. This is useful for finding + files you recently worked on.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Edit as root</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Allows you to edit a file with kwrite using root + permissions.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Mount</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Mounts a new filesystem.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Enqueue in Amarok</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Appends selected item(s) to Amarok playlist.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Copy current item to + clipboard</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Copies selected item(s) to the clipboard.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Shift;<keycap>F5</keycap> + </keycombo> + </shortcut> + <guimenu>Useractions</guimenu> + <guimenuitem>Backup current</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Backups current file in current directory and asks the user for a new filename. + By default <filename>.old</filename> is appended to the original filename.</para> + </listitem> + </varlistentry> + </variablelist> + + +<para></para> <!-- empty line--> +<para><emphasis role="bold">&krusader;-1.90.0 "Power Stone" additional Useractions</emphasis></para> + <variablelist> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Copy as root</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Copy selected files & directories with root privileges, also inside archives! + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Copy+as+root?content=36902">Andrew Svet and MaxiPunkt</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Search and Replace in file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>This Useraction uses the &UNIX; standard-tool <command>sed</command> (the stream-editor) so perform + search and replace operations in all selected files + It is possible to give a regular expression for both strings. + Please note: The sed-command is "s/search/repleace/", so you have to escape the slash when you need it! + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Search+and+Replace?content=36310">Jonas Bähr</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unmount</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Umount selected directory. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/unmount+filesystem?content=68056">Stefan Endrullis</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Eject cd/dvd</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unmounts and ejects current cdrom/dvd.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>gzip current</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Gzip current file with maximum (9) compression, preserving original file. In case of directory, it is first tarred. + Useraction contributed by + <ulink url="http://qa.debian.org/[email protected]">Fathi Boudra</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>7zip current file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Make a 7zip archive containing current file to other panel. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/7zip+current+file?content=32523">Václav Jůza</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Lzma current file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Lzma current file and keep input files to other panel.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>tar.gz current</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>tar.gz current file/directory. + <ulink url="http://www.kde-files.org/content/show.php/Gzip%2Btar.gz+current+file?content=32522">Václav Jůza</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>tar.lzma selected files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>tar.lzma selected files to other panel.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Pack/Unpack ar archive (.a, .deb, ...)</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Make an archive or extract from it using the <command>ar</command> utility, which is + used for static libraries <filename>*.a</filename> or &debian; packages + You can extract &debian; packages this way without having <command>dpkg</command> installed. + Like <command>tar</command>, <command>ar</command> does not use any compression. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/ar++archive+pack%2Bunpack+with+dialog?content=33333">Václav Jůza</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>tar.7z selected files</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>tar.7z selected files to other panel.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack archive to dir</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Creates a directory with the current archive name in the other panel before unpacking + the files into it. It uses <command>ark</command> and tries to guess the directory name (archive name + without file extension). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Archive+to+Dir?content=29760">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack current tar.7z</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack current tar.7z to other panel.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack current tar.lzma</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack current tar.lzma to other panel and keep original input file.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack current lzma</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack current lzma to other panel and keep original input file.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack current lzma</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack current lzma to other panel and keep original input file.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Unpack multiple zip archives</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Unpack all selected zip archives into seperate directories. + Useraction contributed by + <ulink url="http://krusader.org/phpBB/viewtopic.php?t=2059">Ernest Beinrohr (OERNii), + and Jonas Bähr</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Split large mp3</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Splits large mp3's using <command>mp3splt</command>. + Useraction contributed by + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1010">Andrew Svet</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Encrypt with kgpg</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Encrypts the current file with kpgp (which has to be in your $PATH). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Encrypt+with+kgpg?content=32505">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Decrypt with kgpg</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Decrypts the current file with kpgp (which has to be in your $PATH). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Decrypt+with+kgpg?content=32506">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Sign with kgpg</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Signs the current file with kpgp (which has to be in your $PATH). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Sign+with+kgpg?content=32508">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Verify signature with kgpg</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Tries to verify the signature of the current file with kpgp (which has to be in your $PATH). + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Verify+signature+with+kgpg?content=32509">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Decode current file created with uuencode.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Decode a file created with uuencode. Requirements: Sharutils. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Uuencode?content=75488">Andrew Svet</ulink>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Uuencode current file.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Uuencode creates an encoded ASCII copy of a file. Requirements: Sharutils. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Uuencode?content=75488">Andrew Svet</ulink>. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Select from file</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>A javascript useraction, TC-like "load selection from file". + Use this action on a text file which contains a list of filenames and these files will be selected. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Select+from+file?content=54518">Dirk Eschler</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Recode files using GNU recode or iconv</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>A javascript useraction, which converts either file names or their content or both from one + to another character encoding. It processes all selected files and directories in the active panel + (for the directories, recurse their content). You can select, whether a recoded copy is created or + if the file is moved (there is no warranty, so don't test move on any important data) + Requirements: You need krusader compiled with javascript support and GNU recode installed. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/recode+files+with+dialog?content=48289">Václav Jůza</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Mount as root</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>A javascript useraction, Mounts a device with root-privileges. + Requirements: You need krusader compiled with javascript support. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Root+Mount?content=29744">Jonas Bähr</ulink>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <guimenu>Useractions</guimenu> + <guimenuitem>Calculator</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>A javascript useraction, a simple calculator. + Requirements: You need krusader compiled with javascript support. + Useraction contributed by + <ulink url="http://www.kde-files.org/content/show.php/Demo+Calc?content=29743">Jonas Bähr</ulink>.</para> + </listitem> + </varlistentry> + + </variablelist> + + + </sect1> + <sect1 id="tools-menu"> + <title>Tools Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>S</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Search</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens + <link linkend="krusearcher">KruSearcher</link> - the + Krusader search module.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>L</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Locate</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the &locate-lnk; for fast file + searching.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Y</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Synchronize Directories</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The &syncdirs-lnk; function compares the + left and right panels and shows the differences between + them. After the compare function, you can move + files/directories so that they can be + synchronized.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>/</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>MountMan</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens + <link linkend="mount-man">MountMan</link> - the + Mount-Manager.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>D</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Disk Usage</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens &diskusage-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>N</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>New Net Connection</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the + <link linkend="remote-connections">New Network + Connection</link>dialog to start a &FTP;, SMB, + FISH or SFTP connection to a remote host. If you leave + the user name and password fields empty, you will login as + anonymous. You can + <link linkend="bookman">Bookmark</link> these remote + sessions.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Shift;&Ctrl; + <keycap>F</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Disconnect From Net</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Ends the + <link linkend="remote-connections">remote + connection</link> in the active panel and returns to the + start-up path.</para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Start Terminal</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a terminal window in the default directory + (usually your home directory). You can choose your + favorite terminal application in the + &konfiggereral-lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>F2</keycap> + </keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Start Terminal Here</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a terminal window in the currently browsed + directory of the active panel. You can choose your + favorite terminal application in the + &konfiggereral-lnk;.</para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry id="root-mode"> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>K</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Start Root Mode Krusader</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Starts &krusader; in + &rootmode-lnk; at the same location.</para> + <caution> + <para>Be careful when using &krusader; with + ROOT PRIVILEGES.</para> + </caution> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>J</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Javascript Console</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the + <link linkend="javascript_console">Javascript + Console</link>.</para> + </listitem> + </varlistentry> + <!--<varlistentry>--> + <!--<term>--> + <!--<menuchoice>--> + <!--<shortcut>--> + <!--<keycombo action="simul">&Ctrl;<keycap>`</keycap></keycombo>--> + <!--</shortcut>--> + <!--<guimenu>Tools</guimenu>--> + <!--<guimenuitem>User Menu</guimenuitem>--> + <!--</menuchoice>--> + <!--</term>--> + <!--<listitem>--> + <!--<para>--> + <!--Please use at this moment the <link linkend="useractions-menu">Useractions menu</link> instead.--> + <!--Our plans for the Usermenu are to make user-configurable KActionMenus.--> + <!--With this one could make a UserMenu containing ⪚ all music-related actions and place--> + <!--this in the button-bar.... (or anywhere else).--> + <!--</para>--> + <!--</listitem>--> + <!--</varlistentry>--> + </variablelist> + </sect1> + <sect1 id="settings-menu"> + <title>Settings Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Toolbar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the &main-toolbar-lnk; if + checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Actions Toolbar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the &actions-toolbar-lnk; if + checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Statusbar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the + <link linkend="mainwindow">Statusbar</link> if + chosen.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Hide Statusbar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Hides the + <link linkend="mainwindow">Statusbar</link> if + chosen.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show FN Keys bar</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the &fnkeybar-lnk; if + checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Command Line</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the + <link linkend="cmdline">Command Line</link> if + checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>T</keycap></keycombo> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Show Terminal Emulator</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Show the + <link linkend="cmdline">Terminal Emulator</link> if + checked.</para> + </listitem> + </varlistentry> + <varlistentry id="configure-shortcuts"> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Shortcuts</guimenuitem> + </menuchoice> + </term> + <listitem> + <indexterm> + <primary>Configure</primary> + <secondary>Shortcuts</secondary> + </indexterm> + <para>Opens a dialog which allows you to configure the + &krusader; key bindings.</para> + <para>With the + <guibutton>Import shortcuts</guibutton> and + <guibutton>Export shortcuts</guibutton> buttons you can + load and save a Key-binding profile. This allows + &krusader; to have the &tcmd;, + &mc;, foo-commander, or your custom + Key-bindings. The only limitation is that global + &kde; key-bindings and some + &krusader; key-bindings can not be changed yet, + as well as some features in foo-commander that we either + do not have or need. The Key-bindings are stored in + <filename>$KDEDIR/share/apps/krusader</filename>, + <filename>foo.keymap.info</filename> contains a + description, + <filename>foo.keymap</filename> is an ini file that holds + the Key-bindings. Until &krusader;-1.70.1 this + was a binary file, &krusader; is backwards + compatible for importing this legacy binary format. If a + <filename>*.keymap.info</filename> text file exists, + &krusader; will display it, showing additional + information regarding the loaded Key-bindings file. Here + you have a chance to exit without importing the proposed + Key-bindings file.</para> + <tip> + <para>A &tcmd; Key-bindings file is + provided. Please + <link linkend="help_krusader"> upload your favorite + Key-bindings schemes</link> so that they become + available for the &krusader; community. + Thanks!</para> + </tip> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Toolbars</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a dialog which allows you to configure the + &main-toolbar-lnk; or the + &actions-toolbar-lnk;. You can add action + buttons of your favourite &useractions-lnk; to + the desired toolbar.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure + &krusader;</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens + <link linkend="konfigurator">Konfigurator</link> - the + &krusader; configuration center.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="window-menu"> + <title>Window Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>N</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>New Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a new tab in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl;&Shift; + <keycap>N</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Duplicate Current Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a new tab that is a duplicate of the active + tab in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>W</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Close Current Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Closes the current tab in the active panel. This + command is only available if there is more than one tab + in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>Right</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Next Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the next tab in the active panel. This + command is only available if there is more than one tab + in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>Left</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Previous Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Navigates to the previous tab in the active panel. + This command is only available if there is more than one + tab in the active panel.</para> + </listitem> + </varlistentry> + <varlistentry id="c_panel_profiles"> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>L</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Profiles</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens a menu where + <link linkend="panel_profiles">Panel profiles</link> can + be saved and restored.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Swap Panels</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The left panel will become the right panel and vice + versa, only the current tabs will be swapped.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Swap Sides</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The complete left panel will become the right panel + and vice versa, and all tabs will be swapped.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>r</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Vertical Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggles the &list-panel-lnk; between + horizontal and vertical mode.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>F</keycap></keycombo> + </shortcut> + <guimenu>Window</guimenu> + <guimenuitem>Toggle Fullwidget Terminal + Emulator</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggles full screen mode of the terminal editor. + This option is only available when "Show Terminal + Emulator" is activated.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Window</guimenu> + <guimenuitem>Save Position</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Saves the current size and position of the + &krusader; main window. This action can be + automated with + <guilabel>"Save settings on exit"</guilabel> in + &konfigstartpg-lnk;</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="help-menu"> + <title>Help Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>Krusader Handbook</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the &kde; Help system starting at + the &krusader; help pages (this + document).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F1</keycap></keycombo> + </shortcut> + <guimenu>Help</guimenu> + <guimenuitem>What's This?</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>The &whatsthis-url; help function + changes the mouse cursor to a combination arrow and + question mark. Clicking on items within + &krusader; will open a help window (if one + exists for that particular item) explaining the item + function. Use this feature if you want to know more about + a specific item. A right-click on an item will also open + the &whatsthis-url; help.</para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>Report Bug</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Opens the bug report dialog for sending bug reports + via mail.</para> + <note> + <para> + <remark>If you have bugs to report please do not + use &kde;'s bugzilla http://bugs.kde.org/, + &kde;'s Bug Tracking System. We use + Sourceforge.net for reporting and managing our + &faqbugreports-lnk;.</remark> + </para> + </note> + <para>Wishes, patches, and comments are always + <link linkend="faqg_wish">welcome</link>.</para> + </listitem> + </varlistentry> + <!-- vertical bar --> + <varlistentry> + <term> + <menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>About Krusader</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Displays version, author, and license + information.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Help</guimenu> + <guimenuitem>About KDE</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Displays the &kde; version and basic + information.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> +</chapter> diff --git a/doc/en/compare.docbook b/doc/en/compare.docbook new file mode 100644 index 0000000..7b9774c --- /dev/null +++ b/doc/en/compare.docbook @@ -0,0 +1,89 @@ +<sect1 id="compare"> + <title>Compare</title> + <para>&krusader; contains several compare functions: + <guimenuitem>Compare by content</guimenuitem>, + <guimenuitem>Compare Directories</guimenuitem> and the + <link linkend="synchronizer">Synchronizer</link> compare + function.</para> + <sect2 id="compare-content"> + <title>Compare by Content</title> + <indexterm> + <primary>Compare</primary> + <secondary>Content</secondary> + </indexterm> + <para>Select one file in each panel and use + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Compare by content</guimenuitem> + </menuchoice> + </emphasis>. &krusader; will open an external + graphical difference tool that is + <link linkend="konfig-dependencies">configured</link>. + &kompare;, &kdiff3-url; and + &xxdiff-url; are supported.</para> + </sect2> + <sect2 id="compare-dir"> + <title>Compare Directories</title> + <indexterm> + <primary>Compare</primary> + <secondary>Directories</secondary> + </indexterm> + <para>Compare the files of each panel by using + <emphasis role="bold"> + <menuchoice> + <guimenu>Edit</guimenu> + <guimenuitem>Compare Directories</guimenuitem> + </menuchoice> + </emphasis>. By default newer and single files will be selected + in each panel, this behaviour can be changed in the + <guimenuitem>Compare Setup</guimenuitem> menu. + <note> + <para>The files are not compared by content but by their + names and dates only.</para> + </note></para> + <variablelist> + <varlistentry> + <term> + <menuchoice> + <guimenu>Edit</guimenu> + <guimenuitem>Compare Setup</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Configures the + <guimenuitem>Compare + Directories</guimenuitem> function.</para> + <itemizedlist> + <listitem> + <para> + <guimenuitem>Select Newer and + Single</guimenuitem> (default)</para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Newer</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Different and + Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem>Select Different</guimenuitem> + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + </sect2> +</sect1> diff --git a/doc/en/configuration-files.docbook b/doc/en/configuration-files.docbook new file mode 100644 index 0000000..9b94149 --- /dev/null +++ b/doc/en/configuration-files.docbook @@ -0,0 +1,165 @@ +<appendix id="config_files"> + <!-- ********************************************************************** + configuration-files.docbook + +++++++++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Configuration files</title> + <indexterm> + <primary>Configuration files</primary> + </indexterm> + <para>This appendix gives an overview of the configuration files + used by &krusader;.</para> + <para> + <emphasis role="bold">krusaderui.rc</emphasis> + </para> + <para>This file stores the users toolbar settings and the menu + structure. Tip: read also the + <link linkend="faqi_krusaderui_rc">krusaderui.rc + &FAQ;</link>.</para> + <para>Location: + <filename>$KDEDIR/share/apps/krusader/krusaderui.rc</filename> or + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename></para> + <para> + <emphasis role="bold">krusaderrc</emphasis> + </para> + <para>This file stores the &krusader; + configuration.</para> + <para>Location: + <filename>~/.kde/share/config/krusaderrc</filename></para> + <para>The following settings are ⪚ stored:</para> + <itemizedlist> + <listitem> + <para>Actions Toolbar</para> + </listitem> + <listitem> + <para>Archives</para> + </listitem> + <listitem> + <para>Colors</para> + </listitem> + <listitem> + <para>Dependencies</para> + </listitem> + <listitem> + <para>DiskUsage</para> + </listitem> + <listitem> + <para>DiskUsageViewer</para> + </listitem> + <listitem> + <para>General</para> + </listitem> + <listitem> + <para>HTML Settings</para> + </listitem> + <listitem> + <para>KFileDialog</para> + </listitem> + <listitem> + <para>KFileDialog Speedbar</para> + </listitem> + <listitem> + <para>KrDetailedViewLeft</para> + </listitem> + <listitem> + <para>KrDetailedViewRight</para> + </listitem> + <listitem> + <para>KrViewerWindow</para> + </listitem> + <listitem> + <para>KrViewerWindow Toolbar extraToolBar</para> + </listitem> + <listitem> + <para>Look&Feel</para> + </listitem> + <listitem> + <para>Notification Messages</para> + </listitem> + <listitem> + <para>Panel Profiles</para> + </listitem> + <listitem> + <para>Private</para> + </listitem> + <listitem> + <para>Protocols</para> + </listitem> + <listitem> + <para>Search</para> + </listitem> + <listitem> + <para>Startup</para> + </listitem> + <listitem> + <para>Synchronize</para> + </listitem> + <listitem> + <para>Locate</para> + </listitem> + <listitem> + <para>SynchronizerProfile - 1</para> + </listitem> + </itemizedlist> + <para> + <emphasis role="bold">krbookmarks.xml</emphasis> + </para> + <para>This file stores the &krusader; bookmarks and + uses the &xbel-url; standard.</para> + <para>Location: + <filename> + ~/.kde/share/apps/krusader/krbookmarks.xml</filename></para> + <para> + <emphasis role="bold">useractions.xml</emphasis> + </para> + <para>This file stores the &useractions-lnk; + configuration. The file structure is documented in + doxygen-headers of UserActionXML.</para> + <para>Location: + <filename> + ~/.kde/share/apps/krusader/useractions.xml</filename></para> + <para> + <emphasis role="bold">useraction-examples.xml</emphasis> + </para> + <para>This is the default User-Actions provided by us. The + file-structure is documented in doxygen-headers of + UserActionXML.</para> + <para>Location: + <filename> + $KDEDIR/share/apps/krusader/useraction-examples.xml</filename></para> + <para> + <emphasis role="bold">foo.keymap</emphasis> + </para> + <para>Is an ini file that holds a + <link linkend="configure-shortcuts">Key-binding profile</link>. + Until &krusader;-1.70.0 this was a binary file. + &krusader; is backwards compatible for importing this + legacy binary format.</para> + <para>Location: + <filename> + $KDEDIR/share/apps/krusader/foo.keymap</filename></para> + <para> + <emphasis role="bold">foo.color</emphasis> + </para> + <para>This is a binary file that holds the + <link linkend="konfig-color">Color Scheme</link>.</para> + <para>Location: + <filename>$KDEDIR/share/apps/krusader/foo.color</filename></para> +</appendix> diff --git a/doc/en/credits.docbook b/doc/en/credits.docbook new file mode 100644 index 0000000..6cd627a --- /dev/null +++ b/doc/en/credits.docbook @@ -0,0 +1,310 @@ +<chapter id="credits"> + <!-- ********************************************************************** + credits.docbook + +++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Credits and License</title> + <indexterm> + <primary>Credits</primary> + </indexterm> + <indexterm> + <primary>License</primary> + </indexterm> + <para> + <emphasis role="bold">&krusader;</emphasis> + </para> + <para>Program copyright 2000-2003 Shie Erlich and Rafi Yanai, + 2004-2008 &krusader; Krew + <email>[email protected]</email></para> + <para>&krusader; is developed by a dedicated team of + individuals, known as the &krusader; Krew. + <itemizedlist> + <listitem> + <para>Shie Erlich, author + <email>[email protected]</email></para> + </listitem> + <listitem> + <para>Rafi Yanai, author + <email>[email protected]</email></para> + </listitem> + <listitem> + <para>Dirk Eschler, webmaster & i18n + coordinator + <email>[email protected]</email></para> + </listitem> + <listitem> + <para>Csaba Karai, developer + <email>[email protected]</email></para> + </listitem> + <listitem> + <para>Heiner Eichmann, developer + <email>[email protected]</email></para> + </listitem> + <listitem> + <para>Jonas Bähr, developer + <email>[email protected]</email></para> + </listitem> + <listitem> + <para>Frank Schoolmeesters, Documentation & + Marketing coordinator + <email>[email protected]</email></para> + </listitem> + <listitem> + <para>Richard Holt, Documentation & Proofing + <email>[email protected]</email></para> + </listitem> + <listitem> + <para>Matej Urbančič, + Marketing & Product Research + <email>[email protected]</email></para> + </listitem> + </itemizedlist>The project is written using + <application>KDevelop</application>and + <application>&Qt; Designer</application>.</para> + <para>We would especially like to thank Dirk Eschler the + &krusader; web master. If you visit the + &kruwebsite-url; you'll appreciate the hard work and + effort that Dirk has put into the site as much as we do.</para> + <para>Contributors: We would like to thank all the + &krusader; users who submitted bugs, wishes and + patches. Sorry we can't mention all of you.</para> + <para>Donations: We would like to thank the following + organisations and individuals for their recent financial + <ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488"> + support</ulink>. In addition we would to thank those who have + contributed + <ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488"> + anonymously</ulink>. Your support is very much appreciated. + <itemizedlist> + <listitem> + <para> + <ulink url="http://Distrowatch.com"> + distroWatch.com</ulink> (donation)</para> + </listitem> + <listitem> + <para>Sven Opitz (the first donation ever !)</para> + </listitem> + <listitem> + <para>Christian Bock (webspace)</para> + </listitem> + </itemizedlist></para> + <para>Special thanks to: + <itemizedlist> + <listitem> + <para>&sourceforge-net-url;, webhosting + services</para> + </listitem> + <listitem> + <para>Jiri Klement, &kde;4 porting help</para> + </listitem> + <listitem> + <para>&kde-files-url; & + &kde-apps-url; creator Frank Karlitschek</para> + </listitem> + <listitem> + <para>&openusability-url;</para> + </listitem> + <listitem> + <para>Google.com</para> + </listitem> + <listitem> + <para>&krusader; &MacOS;-X port with the &fink-url;-project: Jonas Bähr, &bodo-tasche-url;, + <ulink url="http://pdb.finkproject.org/pdb/maintainer.php?maintainer=Alexander%20K.%20Hansen">Alexander K. Hansen</ulink> + <ulink url="http://hritcu.wordpress.com/2006/08/10/krusader-on-intel-mac/">Catalin Hritcu</ulink></para> + </listitem> + <listitem> + <para>Technical Communication team of 2007, University of Oulu, Finland; + Documentation for &krusader; 1.80.0</para> + </listitem> + <listitem> + <para>Václav Jůza, QA, + bug-hunting, patches and general help</para> + </listitem> + <listitem> + <para>Jiří + Paleček, QA, bug-hunting, patches and + general help</para> + </listitem> + <listitem> + <para>Andrew Neupokoev (nwmod) &krusader; Logo and + Icons, art contest winner.</para> + </listitem> + <listitem> + <para>Angel Ramos, &debian; package + maintainer</para> + </listitem> + <listitem> + <para>Terry "Fudoki" Wilkinson, handbook proofreader</para> + </listitem> + <listitem> + <para>Gábor Lehel (illissius), Viewer + module for the 3rd Hand Panel</para> + </listitem> + <listitem> + <para>Szombathelyi György, ISO KIO + slave</para> + </listitem> + <listitem> + <para>David Harel, panel toolbar buttons</para> + </listitem> + <listitem> + <para>Jan Willem van de Meent (Adios), &krusader; + icons</para> + </listitem> + <listitem> + <para> + <ulink url="http://usefularts.org/">usefularts.org</ulink>, + &krusader; icons</para> + </listitem> + <listitem> + <para>Hans Loffler, directory history list</para> + </listitem> + <listitem> + <para>Jan Halasa, new bookmark module</para> + </listitem> + <listitem> + <para>Mikolaj Machowski, Usability and QA</para> + </listitem> + <listitem> + <para>Cristi Dumitrescu, QA, bug-hunting, patches and general + help</para> + </listitem> + <listitem> + <para>Aurelien Gateau, patch for KViewer</para> + </listitem> + <listitem> + <para>Milan Brabec, the first patch ever !</para> + </listitem> + </itemizedlist></para> + <para>Thanks to the Documentation translators: + <itemizedlist> + <listitem> + <para>Russian: Roman Batejkin</para> + </listitem> + </itemizedlist></para> + <para>Thanks to the GUI translators: + <itemizedlist> + <listitem> + <para>Bosnian: Asim Husanovic</para> + </listitem> + <listitem> + <para>Brazilian Portuguese: Doutor Zero</para> + </listitem> + <listitem> + <para>Bulgarian: Milen Ivanov</para> + </listitem> + <listitem> + <para>Catalan: Rafael Munoz Rodriguez, Quim Perez + Noguer</para> + </listitem> + <listitem> + <para>Chinese: Jinghua Luo</para> + </listitem> + <listitem> + <para>Czech: Martin Sixta, Václav + Jůza</para> + </listitem> + <listitem> + <para>Danish: Anders Bruun Olsen, Christian Sonne, Peter + H.S.</para> + </listitem> + <listitem> + <para>Dutch: Frank Schoolmeesters</para> + </listitem> + <listitem> + <para>French: René-Pierre Lehmann, David + Guillerm</para> + </listitem> + <listitem> + <para>German: Christoph Thielecke, Dirk Eschler</para> + </listitem> + <listitem> + <para>Greek: Spiros Georgaras</para> + </listitem> + <listitem> + <para>Hungarian: Kukk Zoltan, Arpad Biro, Karai Csaba</para> + </listitem> + <listitem> + <para>Italian: Giuseppe Bordoni</para> + </listitem> + <listitem> + <para>Japanese: UTUMI Hirosi, Hideki Kimura</para> + </listitem> + <listitem> + <para>Lithuanian: Dovydas Sankauskas</para> + </listitem> + <listitem> + <para>Polish: Marcin Szafran, Lukasz Janyst, Marcin Garski, + Pawel Salawa, Tomek Grzejszczyk</para> + </listitem> + <listitem> + <para>Portuguese: Bruno Queirós</para> + </listitem> + <listitem> + <para>Russian: Dmitry V. Chernyak, Denis Koryavov, Nick + Shaforostoff, Dmitry A. Bugay</para> + </listitem> + <listitem> + <para>Serbian: Sasa Tomic</para> + </listitem> + <listitem> + <para>Slovak: Zdenko Podobný</para> + </listitem> + <listitem> + <para>Slovenian: Matej + Urbančič</para> + </listitem> + <listitem> + <para>Spanish: Rafael Munoz Rodriguez, Alejandro Araiza + Alvarado, Alex Araiza</para> + </listitem> + <listitem> + <para>Swedish: Erik Johansson, Anders + Lindén, Peter Landgren</para> + </listitem> + <listitem> + <para>Turkish: Bekir Sonat</para> + </listitem> + <listitem> + <para>Ukrainian: Ivan Petrouchtchak</para> + </listitem> + </itemizedlist>And to all the other translators, we're sorry we + can't list all of your names here. Please take a look in the + headers of the + <filename>foo.po</filename> files to see + &i18n-credits-url;.</para> + <para>If your native language is not listed above and you would + like to translate &krusader; into your language, + please read the &i18n-page-url;.</para> + <para>For more credits, read the &changelog-url; file + online or in the Krusader sources.</para> + <para>Documentation Copyright 2000-2003 Shie Erlich and Rafi + Yanai. Copyright 2004-2008 &krusader; Krew + <email>[email protected]</email>.</para> + <!-- &underGPL; --> + <!-- GPL License, do not remove --> + <para>This program is licensed under the terms of the + <ulink url="http://www.gnu.org/copyleft/gpl.html">GNU General + Public License</ulink> Version 2, June 1991.</para> + <!-- &underFDL; --> + <!-- FDL License, do not remove --> + <para>This documentation is licensed under the terms of the + <ulink url="http://www.gnu.org/copyleft/fdl.html">GNU Free + Documentation License</ulink>.</para> +</chapter> diff --git a/doc/en/diskusage.docbook b/doc/en/diskusage.docbook new file mode 100644 index 0000000..a8868c4 --- /dev/null +++ b/doc/en/diskusage.docbook @@ -0,0 +1,120 @@ +<sect1 id="diskusage"> + <title>Disk Usage</title> + <indexterm> + <primary>Disk Usage</primary> + </indexterm> + <para>The Disk Usage is based on the code of + &filelight;. The Disk Usage shows you how your disk + space is being used by a graphical representation of your + file system. The following presentations are possible: + <itemizedlist> + <listitem> + <para>Line view</para> + </listitem> + <listitem> + <para>Detailed view</para> + </listitem> + <listitem> + <para>&filelight; view: as a set of concentric + segmented-rings</para> + </listitem> + </itemizedlist>Choose + <emphasis role="bold"> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Disk Usage</guimenuitem> + </menuchoice> + </emphasis> or + <keycombo action="simul">&Alt; + <keycap>d</keycap></keycombo> to start this feature in a separate + window, or open it inside the + &popup-panel-lnk;.</para> + <para>Disk Usage Keybindings, right click menu. + <itemizedlist> + <listitem> + <para> + <keycap>Del</keycap>: Delete</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>e</keycap></keycombo>: Exclude</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Arrow Up</keycap></keycombo>: parent dir</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>n</keycap></keycombo>: new search</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>r</keycap></keycombo>: refresh</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>i</keycap></keycombo>: include all</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Arrow Down</keycap></keycombo>: step into</para> + </listitem> + <listitem> + <para>View menu: + <itemizedlist> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>l</keycap></keycombo>: Line view</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>d</keycap></keycombo>: Detailed view</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo>: Filelight view</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Arrow Right</keycap></keycombo>: Next view</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Arrow Left</keycap></keycombo>: Previous + view</para> + </listitem> + </itemizedlist></para> + </listitem> + </itemizedlist></para> + <!-- OLD +<screenshot> + <screeninfo>Disk Usage</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="diskusage.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="diskusage.png" format="EPS"/></imageobject> + <textobject><phrase>Konfigurator Look & Feel page</phrase></textobject> + <caption><para>Disk Usage</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-diskusage" float="1"> +<title>Disk Usage</title> +<mediaobject> +<imageobject><imagedata fileref="diskusage.png"/></imageobject> +<textobject><phrase>Disk Usage</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> +</sect1> diff --git a/doc/en/editors-note.docbook b/doc/en/editors-note.docbook new file mode 100644 index 0000000..cf550b9 --- /dev/null +++ b/doc/en/editors-note.docbook @@ -0,0 +1,73 @@ +<!-- ********************************************************************** + editors-note.docbook + ++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> +<preface id="editors_note"> + <title>Note from the Editors</title> + + <para>As you may notice, this handbook is written by various authors. + The draft explanation of new features is done by the developers on the + krusader-devel mailinglist, the editors add this information in this handbook. + We have taken much care in ensuring technical and vocabulary consistency. + The authors write in English even though it is not their native language; + therefore, you may notice strange sentence constructions. + Do not hesitate to let us know, if something is not clear to you.</para> + + <para>An open source project's greatest strength is derived from getting user + feedback. That's why we would love to hear what you have to say. + <emphasis>Documentation contributors are always welcome!</emphasis>, + since this is a time consuming task. + If you have ideas on how to improve the content, + if you would like to write about an undocumented &krusader; feature, or + if you have comments or suggestions about the &krusader; Handbook, please let us know. + You can contact us even if you find typos!</para> + + <para>The Handbook "revision" matches the &krusader; version number. + ⪚ "&krusader; Handbook revision 1.80.x" describes "&krusader; 1.80.x"</para> + + <para>Please read the &docchangelog-url; file online or in the &krusader; sources to find + out the latest changes in the &krusader; Handbook.</para> + + <para>For information about the &krusader; documentation project, + please contact the &krusader; documentation coordinator, Frank Schoolmeesters + <email>[email protected]</email>.</para> + + +<para>This handbook is available in several formats. +<itemizedlist> + <listitem> + <para>via the <ulink url="help-menu.html">Help Menu</ulink> when using &krusader;</para> + </listitem> + <listitem> + <para>the &onlinehandbook-url;</para> + </listitem> + <listitem> + <para>As documentation tarballs (HTML, TXT, RTF, PDF, XML-SOURCE), + download them from the &sfmirrors-url;</para> + </listitem> +</itemizedlist> +The most recent version of this handbook is available when using &krusader; from cvs +or the &onlinehandbook-url;. +</para> + +&dev-cvs-note; + +<para>All mentioned Trademarks and Copyrights in this handbook belong to their respective owners.</para> + +</preface> diff --git a/doc/en/faq.docbook b/doc/en/faq.docbook new file mode 100644 index 0000000..4051f9c --- /dev/null +++ b/doc/en/faq.docbook @@ -0,0 +1,1848 @@ +<chapter id="faq"> + <!-- ********************************************************************** + faq.docbook + ++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Frequently Asked Questions (&FAQ;)</title> + <indexterm> + <primary>FAQ</primary> + </indexterm> + <!-- &reporting.bugs; + &updating.documentation; --> + <para>If you have problems with &krusader; please + check the &install-proc-lnk;, as your problem may be + caused by a bad installation.</para> + <para>The &FAQ; is divided into three sections: + <itemizedlist> + <listitem> + <para> + <link linkend="faq_installation">Installation + &FAQ;</link> (this page)</para> + </listitem> + <listitem> + <para> + <link linkend="faq_usage">Usage + &FAQ;</link> (issues with running/using + &krusader;)</para> + </listitem> + <listitem> + <para> + <link linkend="faq_general">General + &FAQ;</link> (bug reports, forum, mailing list, + ...)</para> + </listitem> + </itemizedlist>If you feel that a &FAQ; is missing or + if something is not clear to you, please + <link linkend="editors_note">let us know</link>.</para> + <sect1 id="faq_installation"> + <title>Installation &FAQ;</title> + <qandaset> + <qandaentry> + <question id="faqi_kdelibs"> + <para>Does &krusader; need &kde; to + run?</para> + </question> + <answer> + <para> + <emphasis>No, &krusader; does not need the + &kde; window manager</emphasis> to run on your + computer but &krusader;'s natural environment + is &kde;, because it relies on services + provided by the &kde; base libraries. Only + some shared libraries are needed ⪚ + &kde; libraries, &Qt; libraries, + &etc; This means that &krusader; + runs on &gnome-url;, + &afterstep-url;, &xfce-url; and + other window managers provided the approriate libraries + are installed on your computer. All this is not a problem + since the apt-get world can resolve these dependencies + instantly.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para>You do not need to switch to the &kde; + window manager to use &krusader;; you can + still use &gnome-url;, + &afterstep-url;, &xfce-url; or + another window manager. However, the configuration of the + &krusader; fonts and some behavior is done by + running + <command>kcontrol</command>.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para>A lot depends on what you want to do with + &krusader;. You should know that + &krusader; uses the &kde; + &kioslaves1-url; to access remote file + systems, and support for only a limited number of file + system types are shipped with &kdelibs-url;, + most of the &kioslaves2-url; are bundled with + &kdebase-url; (including fish, sftp and tar). + However, if you want the property-dialog to show + EXIF-data for .jpeg's, you need &kde;graphics. + If you want ID3-infos, you need + &kde;multimedia, and so on.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para>To summarize, if you want a working + &krusader; - install &kde;libs. If + you want a functional &krusader; then you need + &kde;libs + &kde;base. For maximum + functionality, &krusader; needs all of the + &kde; package libraries, but the + &kde; window manager is optional.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_libs"> + <para>Which libraries does &krusader; need to + run?</para> + </question> + <answer> + <para>For running &krusader; (⪚ + when you have installed &krusader; with a + binary RPM) you need less libraries than if you compile + &krusader; from source. ⪚ you + only need the C-compliler &gcc; when you + compile &krusader; from source (see the next + question).</para> + <para>Here is a list of the required shared libraries + when you run &krusader;:</para> + <para> + <itemizedlist> + <listitem> + <para>kdelibs (for the required &kde; + version see the &install-proc-lnk;)</para> + </listitem> + <listitem> + <para>libacl1 libart-2.0 libattr1 libaudio2 libc6 + libfam0 libfontconfig1</para> + </listitem> + <listitem> + <para>libfreetype6 libgcc1 libgcc2 libice6 libidn11 + libjpeg62 libkjsembed1</para> + </listitem> + <listitem> + <para>libkonq4 libpcre3 libpng12 libqt3-mt libsm6 + libstdc++6 libunwind7 libx11-6</para> + </listitem> + <listitem> + <para>libxcursor1 libxext6 libxft2 libxi6 + libxinerama1 libxrandr2 libxrender1 libxt6 + zlib1g</para> + </listitem> + </itemizedlist>If you need more info please take a look + at the &deb-requirements-url; .</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_missing_libs"> + <para>I have followed all the steps but + <command>configure</command>complains about missing libs + or headers. What do I need to do?</para> + </question> + <answer> + <para>Install the missing packages.</para> + <para>Here is a list of the required packages to compile + &krusader; from source:</para> + <para> + <itemizedlist> + <listitem> + <para>gcc-cpp gcc-c++ glibc libgcc1 (other + compilers may work but haven't been tested)</para> + </listitem> + <listitem> + <para>autoconf automake XFree</para> + </listitem> + <listitem> + <para>libqt3 libqt-devel</para> + </listitem> + <listitem> + <para>kdelibs kdelibs-devel</para> + </listitem> + <listitem> + <para>libjpeg62 libjpeg-devel libpng3 + libmng1</para> + </listitem> + <listitem> + <para>fam libfam-devel</para> + </listitem> + <listitem> + <para>zlib1 arts libart_lgpl2 libstdc++5 + libpcre0</para> + </listitem> + <listitem> + <para>libkjsembed, if you use the + &javascript-console-lnk;, often found in + a package called KDEbindings(-devel) and + libkonq-dev for the &konqueror; + right-click menu entries.</para> + </listitem> + </itemizedlist> + </para> + <para>Most RPM-based distributions separate the headers + from the libs. The headers are needed to compile + &krusader;. Look for packages in the form + foo-devel-*.rpm (⪚ + <filename>kdelibs-devel-foo.i586.rpm</filename>) or + foo-dev-*.deb for &debian; based + distributions. These are usually included with your + distribution. + <tip> + <para>If you ca not find the needed package, use + &rpmfind-url; and click 'missing lib or + header' in the search line. Or use + <command>apt-cache search + <replaceable>foo</replaceable></command> to find the + corresponding package for &debian; based + distributions.</para> + </tip></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_64bit"> + <para>How do I compile &krusader; when I'm + using a 64 bit processor ?</para> + </question> + <answer> + <para>As far as we know, there are no issues. + &krusader; is also available on + <ulink url="http://packages.debian.org/unstable/utils/krusader"> + many other architectures</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_rpm-source"> + <para>I have downloaded the Source RPM + <filename>krusader-x.xx.dist.src.rpm</filename>, what to + do now?</para> + </question> + <answer> + <para> + <orderedlist> + <listitem> + <para>Check the ownership and the permissions on + <filename class="directory"> + /usr/src/RPM/</filename> and all recursive + directories that your normal user can + read-write-execute in these directories.</para> + </listitem> + <listitem> + <para>To produce the binary RPM for your computer, + do this: + <screen><prompt>$</prompt> <userinput><command>rpm</command> <option>--rebuild</option> <replaceable></path/to/rpmfile/> krusader-x.xx.dist.src.rpm</replaceable></userinput></screen> + </para> + </listitem> + <listitem> + <para>If all + <link linkend="faqi_missing_libs"> + dependencies</link> are OK, a binary RPM + <filename>krusader-x.xx.dist.rpm</filename> will be + created at + <filename class="directory"> + /usr/src/RPM/RPMS/i586</filename> (replace i586 with + your architecture).</para> + </listitem> + <listitem> + <para>Test the binary RPM for errors before + installing: + <screen><prompt>$</prompt> <userinput><command>rpm</command> <option>-i --test</option> <replaceable></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable></userinput></screen> + If the prompt returns without any message, + then everything is OK.</para> + </listitem> + <listitem> + <para>Install the binary RPM as usual, for example: + <screen><prompt>$</prompt> <userinput><command>su -c 'rpm</command> <option>-Uvh</option> <replaceable></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable>'</userinput></screen> + You will be asked to enter your root + password.</para> + </listitem> + <listitem> + <para>Now you can + <link linkend="starting-krusader"> + start</link> &krusader;.</para> + </listitem> + </orderedlist> + </para> + <para></para> + <!-- Empty line to make it more readable --> + <tip> + <para>For more information about RPM, visit + &rpm-org-url; and read the + &rpm-guide-url; by Eric + Foster-Johnson.</para> + </tip> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_rpm-fails"> + <para>I'm trying to install binary foo (RPM or DEB + package), but it fails. What's wrong?</para> + </question> + <answer> + <para>Since we only prepare (and use) the source, we have + no way of knowing this. Did you test the binary RPM + before installing? + <screen><prompt>$</prompt> <userinput><command>rpm</command> <option>-i --test</option> <replaceable></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable></userinput></screen> + If the prompt returns without any message, then + everything is OK. RPM's downloaded from our website are + usually provided by &krusader; users. Visit + your distro website and search for an updated RPM.</para> + <para>If the RPM is not OK, try to find another package + at &Linux; software archives such as + &freshmeat-url; or &kde-apps-url;. + If you still can't find the appropriate package for your + &Linux; distribution, we recommend searching + for it with &rpmfind-url; or + &rpmpbone-url;.</para> + <para>In general, a package for an older version of your + distrubution or even for another distribution might work + on your computer (⪚ FC RPM's often work on + Mdk and RH, and vice versa), but it is always the best + that you install only RPM's that exactly match your + distribution. If you can't find a package that matches + your distribution version, architecture or distribution, + then use a source RPM. When you use a source RPM, the + Krusader sources will be built, on your computer, + guaranteeing a suitable binary RPM for your specific + distribution and architecture. In addition, this method + results in maximum system speed, since the resulting + binary is customized for your computer. Please read the + previous question, it explains how to install a source + RPM. The best solution is explained in the next + question.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_rpm-notfound"> + <para>I can't find an RPM or DEB package for + &krusader;, what to do?</para> + </question> + <answer> + <para>Check if your distribution provides + &krusader;, if it doesn't then contact your + distribution creator and ask them to include + &krusader;!</para> + <para>Did you take a look at the &URL;'s on + the &install-proc-lnk; page? If you have and + found nothing, you can always compile + &krusader; from source. Even if you feel you + haven't got the necessary skills, you will probably + succeed in compiling &krusader;: we provide a + very detailed installation procedure. This HowTo enables + newcomers to compile &krusader; from source, + even if they have never done a compilation from source + before, just follow the instructions carefully. Feel free + to post a &help-request-lnk; if you encounter + problems.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_krusaderui_rc"> + <para>I've installed &krusader;, but when I + start, only the + <guimenu>"Help"</guimenu> menu appears. Why?</para> + </question> + <answer> + <para>In this case only the + <guimenu>Help</guimenu> menu is visible and all other menu + items like ⪚ + <guimenu>File</guimenu> and + <guimenu>Select</guimenu> are missing. This is because + some distributions put the + <filename>krusaderui.rc</filename> file in the wrong + directory. To solve the problem, just copy the + <filename>krusaderui.rc</filename> file from the package + <filename> + krusader_kde3/krusader/krusaderui.rc</filename> to + <filename> + $KDEDIR/share/apps/krusader/krusaderui.rc</filename> and + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename> and + re-run &krusader;. If you have compiled + &krusader; from sources this is often caused + if the &kdeqtdir-lnk; environment variables + are not correctly set. The result is that the + <filename>krusaderui.rc</filename> file is installed in + the wrong directory. Please read the following question, + as well.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_missing_menus"> + <para>Some new menu items are missing after updating + &krusader;, what's wrong?</para> + </question> + <answer> + <para>The + <filename>krusaderui.rc</filename> file is stored in + <filename> + $KDEDIR/share/apps/krusader/krusaderui.rc</filename>. + When you change the + <guilabel>"Toolbar"</guilabel>, &kde; makes a + copy of that file in the home directory at + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename>. If + Krusader was previously installed on your computer, and + you install a newer &krusader; version the + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename> file + must be replaced with the newer version. Note: this will + also reset all your changes on toolbars and + shortcuts!</para> + <para>The first line of + <filename>krusaderui.rc</filename> contains the version + number. After installing a newer &krusader; + version, &kde; will automatically replace the + old + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename> with + the newer version when starting the new + &krusader; for the first time + (&kde; will detect the newer version number in + the first line).</para> + <para>If you install a CVS or beta version and + &krusader; was already installed on your + computer then you should delete the + <filename>krusaderui.rc</filename> file from your home + directory to activate the new menu entries + <prompt>$</prompt> + <userinput> + <command>rm</command> + <option> + ~/.kde/share/apps/krusader/krusaderui.rc</option> + </userinput></para> + <para>If the + <filename> + ~/.kde/share/apps/krusader/krusaderui.rc</filename> file + is older, then the new menu elements will not be shown. + Read the previous question for information on how to + update the + <filename>krusaderui.rc</filename> file. If + <filename>krusaderui.rc</filename> is missing or in a + wrong directory, only the + <guimenu>"Help"</guimenu> menu appears, please read the + previous question.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_libfam_la"> + <para>When I run + <command>make</command>, it complains about + <filename>libfam.la</filename>, what's wrong?</para> + </question> + <answer> + <para>The + <command>./configure</command> script does not check for + the presence of + <filename>libfam.la</filename>, and + <command>make</command> needs + <filename>libfam.la</filename> to compile + &krusader;. If you know how this can be + solved, please let us know. Install + <filename>libfam0-devel-foo.rpm</filename>. Note: when + you install &Mandrake;-&Linux; 9.2 + with the default settings, this package is not installed. + If you need more information take a look at + &missing-libs-lnk;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_deb-qt"> + <para>&debian; complains about &Qt; + when running + <command>./configure</command>, what's wrong?</para> + </question> + <answer> + <para>This problem occurs when you use &gcc; + 2.95, you need to install &gcc; 3.2 (or + higher). You also need to set the enviroment variables + "CC, CPP and CXX" before running the + <command>./configure</command> script. + <screen><prompt>$</prompt> <userinput><command>export</command> CC=<replaceable>/usr/bin/gcc-3.2</replaceable></userinput> + <prompt>$</prompt> <userinput><command>export</command> CXX=<replaceable>/usr/bin/g++-3.2</replaceable></userinput> + <prompt>$</prompt> <userinput><command>export</command> CPP=<replaceable>/usr/bin/cpp-3.2</replaceable></userinput> + </screen> + For more information please take a look + &debian-qt-a-url; and at the + &debian-qt-b-url; on how to build a + &Qt;/&kde;3 application on + &debian;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_nvidia"> + <para>I have a + <filename>libGLcore.so.1</filename> compile error after + using the &nvidia; installer, what to + do?</para> + </question> + <answer> + <para>This problem occurs when you use the + &nvidia; installer and not the official + &nvidia; packages of your distribution. + &krusader; is based on &Qt; which + can be linked against the X OpenGL libraries. As a result + &krusader; may look for OpenGL as well. The + problem is that the &nvidia; installer (prior + to version 7xxx) doesn't perform it's task properly: it + replaces the OpenGL header files (which get included into + &krusader;) but doesn't set the libGL links + correctly. The best solution is to use the + &nvidia; packages provided by your distributor + or a new &nvidia; installer, the current + version at the moment of writing is 7114. If, for some + reason, you must use an old &nvidia; driver, + one solution is the following hack, the exact commands + depend on the distribution used and the version of the + &nvidia; driver (6111 in this example), but it + should read something like this: + <screen><prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.1.0.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.0.0.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.0.0.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.1</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.1.0.0</replaceable></userinput> + <prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>/usr/lib/libGLU.la /usr/X11R6/lib/libGLU.la</replaceable></userinput> + </screen></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_gcc4"> + <para>Why &krusader;-1.60.x does not compile + with gcc4?</para> + </question> + <answer> + <para>Because &krusader;-1.60.x was not gcc4 + compatible, it first needs some patches: + <itemizedlist> + <listitem> + <para>add 'class ListPanelFunc;' in + krusader/Panel/listpanel.h</para> + </listitem> + <listitem> + <para>add 'class KMountManGUI;' in + krusader/MountMan/kmountman.h</para> + </listitem> + <listitem> + <para>add 'class KrDetailedViewItem;' in + krusader/Panel/krdetailedview.h</para> + </listitem> + </itemizedlist>More information can be found in our + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1328"> + forum</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_help_request"> + <para>I am having trouble compiling and installing + &krusader;, how do I send a help + request?</para> + </question> + <answer> + <para>Please read our detailed + <link linkend="compilation">installation + procedure</link> and the &faq-lnk;. If you + can't find a solution to your problem then feel free to + post a + <emphasis role="bold">help request</emphasis> at our + &krusader; forum or use the + &kruusers-url; mailing list. But before + posting a help request, please try the following: + <orderedlist> + <listitem> + <para>Use the &kruforumsearch-url; + function on the &forum-lnk;, your problem + might be solved or discussed already.</para> + </listitem> + <listitem> + <para>If you can't find a solution, please make a + note of the following issues: + <itemizedlist> + <listitem> + <para>the &krusader; version + used</para> + </listitem> + <listitem> + <para>the &Linux; distribution + + version used</para> + </listitem> + <listitem> + <para>a good description of the problem</para> + </listitem> + </itemizedlist>Without this information, it is very + difficult for us to help you. + <note> + <para>If you give us the error messages + (⪚ + <command>make</command> error messages) please start + with the FIRST error message, all the error + messages which follow the first error message are + consequences and not the cause of your + problem.</para> + </note></para> + </listitem> + <listitem> + <para>Send out your help request.</para> + </listitem> + </orderedlist></para> + <para>Thank you for your co-operation!</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_rpm-build"> + <para>How can I build an RPM package for + &krusader;?</para> + </question> + <answer> + <para>If you have experience with compiling from source, + you will probably be able to build a + &krusader; RPM too. Information about RPM can + be found at &rpm-org-url; and in the + &rpm-guide-url; by Eric Foster-Johnson. The + following is the short procedure howto on building an + RPM.</para> + <warning> + <para>NEVER build RPMs when logged in as root. Mistakes + in building packages (⪚ a bad + <filename>krusader.spec</filename> file) can do serious + damage to your system when logged in as root.</para> + </warning> + <para> + <orderedlist> + <listitem> + <para>Compile &krusader; from source to + check that the compilation works fine.</para> + </listitem> + <listitem> + <para>Check the ownership and the permissions on + <filename class="directory"> + /usr/src/RPM/</filename> and all recursive + directories that your normal user can + read-write-execute in these directories.</para> + </listitem> + <listitem> + <para>Copy + <filename>kusader-1.xx.tar.gz</filename> to + <filename class="directory"> + /usr/scr/RPM/SOURCE</filename></para> + </listitem> + <listitem> + <para>Copy + <filename>kusader.spec</filename> to + <filename class="directory"> + /usr/scr/RPM/SPECS</filename> Tip: the latest + <filename>kusader.spec</filename> can be found in + CVS.</para> + </listitem> + <listitem> + <para>Edit + <filename>kusader.spec</filename> and add your name, + your e-mail address, the rpm name, ... Other + changes may be needed if + <command>rpmbuild</command> fails.</para> + </listitem> + <listitem> + <para>Build the binary and the source RPM with: + <screen><prompt>$</prompt> <userinput><command>rpmbuild</command> <option>-ba</option> <replaceable>/usr/scr/RPM/SPECS/krusader.spec</replaceable></userinput></screen> + If everything went OK you will have a + binary RPM in + <filename class="directory"> + /usr/src/RPM/RPMS/i586</filename> (depending on your + architecture) and a source RPM in + <filename class="directory"> + /usr/src/RPM/SRPMS/</filename> ⪚ + <filename> + krusader-1.70-beta1.suse10.i586.rpm</filename> and + <filename> + krusader-1.70-beta1.suse10.src.rpm</filename></para> + </listitem> + <listitem> + <para>If the build is not OK you will receive an + error message during the rpmbuild process, try to + fix it and run + <command>rpmbuild</command> again.</para> + </listitem> + <listitem> + <para>And finally: + <link linkend="faqi_rpm-source">test</link> the RPM + before sending it in.</para> + </listitem> + </orderedlist> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqi_cvs_verion"> + <para>Why does &krusader;-cvs show an old + version number in the about box?</para> + </question> + <answer> + <para>Because we only change the version number just + before we do a new release. &krusader;-cvs + will show an older version number, so ignore the version + number and check the download date. We simply haven't yet + decided what the next version number will be.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + </qandaset> + </sect1> + <sect1 id="faq_usage"> + <title>Usage &FAQ;</title> + <qandaset> + <qandaentry> + <question id="faqu_qt355"> + <para>&krusader; keeps crashing, why?</para> + </question> + <answer> + <para>We've been receiving a lot of emails and bug + reports (December 2005) regarding random crashes, + especially during file operations such as copy, move, + etc. + <emphasis role="bold">These crashes are related to + &Qt; 3.3.5 and NOT + &krusader;.</emphasis> It seems that + &Qt; 3.3.5 introduced a serious bug which is + currently (December 2005) causing random crashes in many + &kde; applications including + &konqueror;. You can use Google to find out + more. As far as we know, &debian;-Sid and + &SuSE; already posted new &Qt; + binaries that fix the problem, and &gentoo; + has masked &Qt; 3.3.5 completely. As for now, + you either need &Qt; 3.3.4 or a fixed + &Qt; 3.3.5 or a higer version, depending on + your distribution. More information is available on our + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1407"> + website</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_supermount"> + <para>When I try to mount/unmount my cdrom/floppy, + &krusader; reports something about a + supermount, what's this about?</para> + </question> + <answer> + <para>Supermount is a daemon which handles the + mounting/unmounting of removable filesystems for you. + Just insert a floppy, and do + <userinput> + <command>cd</command> + <option> + <replaceable>/mnt/floppy</replaceable> + </option> + </userinput>supermount will do the mount for you + automatically and transparently. Usually this works fine. + However, supermount misleads the system into thinking + that the + <hardware>floppy/cdrom</hardware> is mounted at all times! + This creates some problems for &krusader;, as + it cannot really know when the floppy or CD has been + removed because the system information is not correctly + updated by supermount - is there really a + <hardware>floppy</hardware> in the + <hardware>drive</hardware>? Of course, this can be + solved, but as for now, we don't consider it a + priority.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_dead_mountpoint"> + <para>Why does &krusader; freeze or hang on a + dead mountpoint?</para> + </question> + <answer> + <para>When &krusader; is ⪚ + browsing an NFS share and the NFS server goes down, + &krusader; will freeze. This + &krusader; (and all other open internal + viewers/editors) freeze is fatal, and can only be + corrected with the + <command>kill -9</command>. We have no solution for this. + This is an issue not confined to file managers, or even + the &Linux; OS! The problem is that you "hang" + on the first access to the dead share - so there is no + way around it, no check to avoid it, even + <command>ls</command> will freeze. Just trying to read + something - anything - is enough to get you stuck. The + one and only way around this architectural problem is + using a multi-threaded design - this way if we get stuck, + we don't hang the entire application event loop, but we + don't think that the time is right for adding threads, we + are not sure that *all* the &kde; systems out + there are using &Qt;-mt (the multi threaded + version of the &Qt; library), and the Krusader + Krew may not be the right people to address this major + issue in any case; so currently this is just a bug we + have to learn to live with.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_resize"> + <para>When I try to resize &krusader; to make + it smaller, I discover that I can't resize it below a + certain size. Why?</para> + </question> + <answer> + <para>See the + <guibutton>F1, F2</guibutton> (&etc;) buttons? + They are not allowing &krusader; to downsize + as they have a minimum size. Just disable them + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show FN Keys Bar</guimenuitem> + </menuchoice> + and you'll be able to resize + &krusader; to your liking. Since version 1.51 + we have improved this greatly: when downsizing the + buttons will look like 'F5 ..py'. When the button faces + are too small to read a tooltip will give the complete + text. The minimum width is 45 pixels for each + button.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_refresh"> + <para>When I perform some file operations, + &krusader;'s panel doesn't refresh / I'm using + &krusader; with fam installed, but updates to + the panel are not shown. Why?</para> + </question> + <answer> + <para>The bad news is that we're not sure why, but it + seems that + <command>fam</command> (file alteration monitor) sometimes + refuses to work. We are looking into this problem to make + sure it is not + <emphasis>our</emphasis> problem. We've tried the same + source code on two different Gentoo installations: one + worked, the other did not. The good news is that if you + disable + <application>fam</application>, &krusader; + will automatically revert to its internal update + mechanism (which is less efficient, but works) without + needing to recompile. You can disable + <application>fam</application> with: + <screen><prompt>$</prompt> <userinput><command>su -c 'fam -l'</command></userinput></screen> + Look at the manpages for more information about + <application>fam</application>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_samba_codepage"> + <para> + <application>Samba</application> ISO 8859-x codepage / + What to do if &krusader; does not read shared + directories containing special international + characters?</para> + </question> + <answer> + <para>&krusader; does not handle (yet) + <application>Samba</application> ISO 8859-x codepages, if + you use a codepage different than 8859-1 you will have to + do a manual configuration. Create or modify the file: + <filename>~/.smb/smb.conf</filename> + <programlisting>[global] + workgroup = MyWorkGroup (ex. WORKGROUP) + client code page = MyCodePage (ex. 852) + character set = MyCharSet (ex. ISO8859-2) + </programlisting> + Unfortunately + <application>kcontrol</application> (&kde; + 3.1.1) fails to configure smb.conf properly, so this must + be done manually with a text editor.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_krarc_protocol"> + <para>&krusader; reports "krarc:... protocol + not supported" error at opening an archive file, what to + do?</para> + </question> + <answer> + <para>Install the krarc slave properly:</para> + <para>Copy the + <filename>kio_krarc.so</filename>, + <filename>kio_krarc.la</filename> files into + <filename class="directory"> + $KDEDIR/lib/kde3</filename></para> + <para>Copy the + <filename>krarc.protocol</filename> file into + <filename class="directory"> + $KDEDIR/share/services</filename></para> + <para>or the directory where the KIO slaves are placed in + your &Linux; distribution.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_krarc_support"> + <para>I get the error message "Protocol not supported by + Krusader: "krarc:/path/to/foo-archive", when I try to + open foo-Archive, what to do?</para> + </question> + <answer> + <para>The icons, kio_slaves and documentation must be + installed in the correct places in the &kde; + directory tree. The + <filename>kio_krarc.*</filename> files must be in the same + directory with the other KIO slaves. Try this: locate + <filename>kio_tar.*</filename> and copy/link the + <filename>kio_krarc.*</filename> files to the same + location. Don't forget to run + <command># ldconfig</command> on this directory when + you're done. For more information click + <ulink url="www.krusader.org/phpBB/viewtopic.php?t=991"> + here</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + +<qandaentry> + <question id="faqu_external_tool"> + <para>What todo if an extenal tool doesn't seem to work?</para> + </question> + <answer> + <para>Krusader uses several programs as <link linkend="konfig-dependencies">external tools</link>, + and sometimes they appear not to work. + + Open a terminal and check if tool foo is installed. + <screen><prompt>$</prompt> <userinput><command>foo</command></userinput></screen> + + Check if tool foo is properly configured in the &konfigdependencie-lnk;. + + For Archiving tools: autodetect the archives again with the <guibutton>Auto Configure</guibutton> button + in the <link linkend="konfig-archives">Konfigurator archive page</link>. + + Check the &konfigprotocol-lnk; + + If it doesn't work, backup your <filename>~/.kde/share/config/krusaderrc</filename> configuration file and remove it from this location, + Restart Krusader, Krusader will now start the first start configuration wizard, follow these guidelines. + + </para> + <para> </para> <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqu_jar"> + <para>Howto executing jar files (and not enter the jar archive)?</para> + </question> + <answer> + <para>Go to the &konfigprotocol-lnk; and remove <guilabel>application/x-jar</guilabel> + from the krarc node, &krusader; should no longer enter the archive. + Global file associations are handled by &kde; and not by &krusader;. + To assosiate the jar extension: + <itemizedlist> + <listitem> + <para>Open &kde;s control center: <application>kcontrol</application> + </para> + </listitem> + <listitem> + <para> + <menuchoice> + <guimenu>KDE Components</guimenu> + <guimenuitem>File Associations</guimenuitem> + </menuchoice> + </para> + </listitem> + <listitem> + <para>Enter <filename>jar</filename> as filename pattern + </para> + </listitem> + <listitem> + <para>Add <filename>java</filename> as application + </para> + </listitem> + </itemizedlist> + </para> + <para> </para> <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + <!-- Thanks to Dirk Eschler --> + <qandaentry> + <question id="faqu_ftp_firewall"> + <para>Why do I have trouble with my &FTP; + connection?</para> + </question> + <answer> + <para>This problem often occurs when you are behind a + firewall or proxy. Open + <menuchoice> + <guimenu>KDE Control Center</guimenu> + <guimenuitem>Network</guimenuitem> + <guimenuitem>Preferences</guimenuitem> + </menuchoice>, + <guilabel>"Enable Passive Mode (PASV)"</guilabel> has to + be turned on or off, depending on it's current setting. + Now try your &FTP; session again to see if it + works. Also, make sure you have no other &FTP; + sessions open (using web browsers, etc.), they can cause + complications. More information can be found in + &active-passive-ftp-url;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_ftp_http_proxy"> + <para>I get + <errorcode>"FTP protocol not supported by + &krusader;"</errorcode> error when trying to + open a remote &FTP; directory, what to + do?</para> + </question> + <answer> + <para>The reason for this error is that '&FTP; + via &HTTP; proxy' feature is not yet supported + by &krusader;. This error may be caused by a + misconfiguration of the proxy settings in + &kcontrolcenter;. Modify the proxy settings to + not use &HTTP; proxy and &FTP; will + work.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_no_part"> + <para>How don't add ".part" suffix when copying files via ftp?</para> + </question> + <answer> + <para>When uploading files a <filename>.part</filename> suffix is added to the filename, + once the upload is complete the filename is renamed automagically + to remove the <filename>.part</filename> suffix. + This works great but sometimes some ftp-servers don't allow a rename operation. + You can solve this by unchecking the checkbox + <guilabel>Mark partially uploaded files</guilabel> in &kde;'s control center. + The checkbox is located at + <menuchoice> + <guimenu>Internet and Network</guimenu> + <guimenuitem>Connection Preferences</guimenuitem> + </menuchoice>.</para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_close_connection"> + <para>How can I close a remote connection + (⪚ a FTP connection)?</para> + </question> + <answer> + <para>It's explained in the + <link linkend="remote-connections">remote connections + chapter</link>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_media_protocol"> + <para>I am experiencing problems with the media:// + protocol, why?</para> + </question> + <answer> + <para>At the moment of writing the media:// protocol is + instable, we need to wait until the &kde; team + corrects it, every other protocol works properly with + &krusader;, only media fails. More information + regarding this issue is available in + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1357"> + our forum</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <!-- Thanks to thepieman at the Krusader Forum --> + <qandaentry> + <question id="faqu_sound"> + <para>How can I disable the default sounds, + ⪚ when I do a delete action ?</para> + </question> + <answer> + <para>Those are the default &kde; System + sounds, and not related to &krusader;. If you + want to disable them globally open your &kde; + &kcontrolcenter; ( + <application>kcontrol</application>): + <menuchoice> + <guimenu>KDE Control Center</guimenu> + <guimenuitem>Sound & + Multimedia</guimenuitem> + <guimenuitem>System Notifications</guimenuitem> + </menuchoice>, + <guilabel>Event Source: "KDE System + Notifications"</guilabel> and uncheck sound items you + don't like.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_remoteMan"> + <para>Where is RemoteMan, the remote connection manager + ?</para> + </question> + <answer> + <para>RemoteMan has been replaced by our Bookmark Manager + since Krusader 1.25-beta1. The Bookmark Manager handles + local files and + <link linkend="remote-connections">remote + &URL;'s</link> the same way. RemoteMan was left + as a selection until &krusader;-1.51 to allow + an easier transition and give you a chance to move your + &bookmarks-lnk;. RemoteMan was disabled, as + announced, in &krusader;-1.60.</para> + <para>&URL; transition procedure: + <orderedlist numeration="arabic"> + <listitem> + <para>install &krusader;-1.51</para> + </listitem> + <listitem> + <para>open the RemoteMan and connect to an + &FTP;</para> + </listitem> + <listitem> + <para>once inside, bookmark the current location, + select a name and save.</para> + </listitem> + <listitem> + <para>do this for all your connections, all the + &bookmarks-lnk; are now stored in + <filename>krbookmarks.xml</filename></para> + </listitem> + <listitem> + <para>install &krusader;-1.60, it will use + <filename>krbookmarks.xml</filename> or import it if + needed.</para> + </listitem> + </orderedlist></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqu_mimetypemagic_archives"> + <para>Why doesn't mimetype magic sometimes work inside + archives?</para> + </question> + <answer> + <para>When you enter an archive and press + <keycap>F3</keycap> to view a file that has no known + extension, ⪚ + <filename>README, INSTALL</filename> &etc;. And + if the viewer opens in hex-mode instead of the usual + mode, than you need to configure: + <menuchoice> + <guimenu>KDE Control Center</guimenu> + <guimenuitem>KDE components</guimenuitem> + <guimenuitem>File Associations</guimenuitem> + <guimenuitem>Application</guimenuitem> + <guimenuitem>octet-stream</guimenuitem> + </menuchoice>, + <guilabel>binary viewer</guilabel> needs to be + removed.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_konfigurator"> + <para>Where is Konfigurator, do i need to install the &kde; Desktop Enviroment to use it?</para> + </question> + <answer> + <para><link linkend="konfigurator">Konfigurator</link> is &krusader;s configuration module, + when you have installed &krusader; than you have also Konfigurator. + For some reason some people think it's an other &kde; application, but it is not, so + you don't need to install the &kde; Desktop Enviroment to use Konfigurator. + When runnig &krusader;, use + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure &krusader;</guimenuitem> + </menuchoice>, and it will start + <link linkend="konfigurator">Konfigurator</link>. + Please read the manual, &krusader; has many many configuration options, + a lot of things can be customized to your needs with <link linkend="konfigurator">Konfigurator</link>. + </para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_equal_lookandfeel"> + <para>How can I set the look & feel of 2 + different users to be the same?</para> + </question> + <answer> + <para>Presuming that the current setup is the good + configuration, you can copy the configuration to the + other user. + <screen><prompt>#</prompt> <userinput><command>cp ~/.kde/share/config/krusaderrc /home/foo_user/.kde/share/config</command></userinput></screen> + And when the other user is Root use: + <screen><prompt>#</prompt> <userinput><command>cp ~/.kde/share/config/krusaderrc /root/.kde/share/config</command></userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_save_last_location"> + <para>Why doesn't "save last location" work?</para> + </question> + <answer> + <para>Unfortunately the 1.70.x version contains a bug. + The tabs are not saved if a "Panels Save Settings=Tabs" + item is present in the configuration files. The fix is + easy: + <itemizedlist> + <listitem> + <para>open and edit + <filename> + ~/.kde/share/config/krusaderrc</filename></para> + </listitem> + <listitem> + <para>remove the "Panels Save Settings" item</para> + </listitem> + </itemizedlist>and it'll work with the + <Last Session> feature in + Konfigurator. More info can be found in + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1357"> + our forum</ulink>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_handbook"> + <para>Why doesn't the handbook work?</para> + </question> + <answer> + <para>This error will happen on &debian; (or + &debian; based) distro with the + krusader_1.51-1_i386.deb package. You will see the next + error message if you try to open the handbook: "The + requested help file could not be found. Check that you + have installed the documentation." To fix it go to + <filename> + /usr/share/doc/kde/HTML/en/krusader/</filename>, you will + see the + <filename>foo.docbook.gz</filename> files. Now, you need + to extract all these files with root privileges + ("File->Unpack" with &krusader;) + to create + <filename>foo.docbook</filename> files. Now the handbook + will work. This error is fixed in the + krusader_1.60.0-1_i386.deb package and higher + versions.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + </qandaset> + </sect1> + <sect1 id="faq_general"> + <title>General &FAQ;</title> + <qandaset> + <qandaentry> + <question id="faqg_wish"> + <para>How can I report a wish, a suggestion, or a + comment?</para> + </question> + <answer> + <para>An open source project's greatest strength is + derived from getting user feedback. That is why we love + to hear what you have to say. Your "gripes" are our + instructions. After about 6 months, programmers can no + longer see their own mistakes. It's natural. We want the + ideas, qritiques, and feedback because we all want to + make &krusader; the best and most useful file + manager available anywhere.</para> + <para>The most convenient way to contact us is to use the + &forum-lnk;, or the krusader-users + &mailing-lists-url;. For information on what + remains to be done look at the + &todoforum-url;. Adding ToDo items into the + &todoforum-url; is for developers only, but + feel free to post to the &featureforum-url; + for things that aren't on the &todoforum-url;, + but should be. If you have a nice feature request, the + &krusader; Krew will add your request to the + &todoforum-url;. We review and discuss every + submission. For more information how the forum works + click + <link linkend="faqg_kru-forum">here</link>.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_patch"> + <para>How can I send a patch?</para> + </question> + <answer> + <para>It's not easy to write patch guidelines, but here + are some. + <orderedlist numeration="arabic"> + <listitem> + <para>Patches, new code or new features are always + welcome!</para> + </listitem> + <listitem> + <para>Focus only on one problem at a time, so the + developers can easily understand you, and commit your patch + it works.</para> + </listitem> + <listitem> + <para>Preferrably, you can start a discussion + with the developers on the krusader-devel + &mailing-lists-url; or on the + &forum-lnk;. Unfortunatly, we can't apply + a patch if the patch is in conflict with the "general + design" of the &krusader; code (read for more + instructions in this FAQ). + Please send only one change request per mail, so + that the discussion is easier to follow. The + modifications should be committed step by step, + checking each line. + </para> + </listitem> + <listitem> + <para>Submit your patch files into our &patch-tracker-url;, + so that all patch proposals stay organised and don't get lost, + tar.gz archives or diffs are usually ok. + Do not copy changes into a mail. Most mailers will change the + white spaces, so that the diff will not apply or the + code snipped does not diff. In the past, patch mails went lost or disorganized in many many mails, + so please use the &patch-tracker-url;, thanks! + </para> + </listitem> + <listitem> + <para>Use portable solutions, &krusader; + should run on: + <itemizedlist> + <listitem> + <para>All POSIX + (&Linux;/BSD/&UNIX;-like + OSes), &Solaris;.</para> + </listitem> + <listitem> + <para>All BSD Platforms + (&freebsd;/&netbsd;/&openbsd;/&MacOS;).</para> + </listitem> + <listitem> + <para>&kde; 3.3- &kde; + 3.5 and even on GNOME with + &kde;libs (for krusader-2.x &kde; 4) .</para> + </listitem> + <listitem> + <para>GCC 2.95 - GCC 4.1</para> + </listitem> + </itemizedlist>Architecture changes are made by the + team only.</para> + </listitem> + <listitem> + <para>A final note: always keep in mind a patch might + be rejected. Either it has side effects, which we + could not fix or it contradicts with the idea behind + the patched module. In this sense, a software project + differs from, let's say a wiki: a software project + has to have someone to make all the final decisions. + Otherwise the software will not work. Furthermore: + keep in mind that the examination of patches might + take time, as we all have private lives.</para> + </listitem> + </orderedlist></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_bug_report"> + <para>How can I report a bug?</para> + </question> + <answer> + <para>Bugs?!?!? Well, ok.... We have an online Bug + Tracking System.</para> + <para>Using the online bug-tracker helps us have a clear + and orderly way to know how many bugs are open, bug + priority and follow-ups. It saves us from browsing + through the entire &krusader; forum, searching + for yesterdays bug. Please use this system.</para> + <para>Before reporting a bug, please read the following: + <orderedlist> + <listitem> + <para>Use the &forum-lnk;'s + &kruforumsearch-url; function , your bug + might be already solved . Please DO NOT post new bugs + to the &bugforum-url; (except if you are + not sure that you have found a bug). We use it for + bug discussions.</para> + </listitem> + <listitem> + <para> + <emphasis role="bold">Check</emphasis> if the bug is + already posted in the &online-buglist-url; + of the Bug Tracking System.</para> + </listitem> + <listitem> + <para>If you can't find this bug mentioned, please + <emphasis role="bold">submit</emphasis> it into the + bug tracker by clicking the + <guibutton>Submit New</guibutton> button in the + bug-tracker window. Please submit the following + issues: the &krusader; version used, the + &Linux; distribution + version used, + processor type, and as good a description of the + problem as you can manage.</para> + </listitem> + </orderedlist></para> + <para>Thank you for your co-operation!</para> + <note> + <para>If possible, try to do the same operation with + &konqueror; or another &kde; + application. If you encounter the same problem then it + is possibly a &kioslaves1-url; or + &kde; (kdelibs) bug, and not a + &krusader; bug. &krusader; uses + the &kde; libraries and the + &kioslaves2-url; for many operations. In + some cases you can encounter problems if your + distribution is incorrectly configured, please test it + first as explained above.</para> + </note> + <para></para> + <!-- Empty line to make it more readable --> + <note> + <para> + <remark>If you've got bugs to report please do not + use &kde;'s bugzilla http://bugs.kde.org/, + &kde;'s Bug Tracking System. Report + &krusader; bugs directly to us.</remark> + </para> + </note> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + +<qandaentry> + <question id="faqg_valgrint"> + <para>How can i send good debug or crash reports?</para> + </question> + <answer> + <para>Usually binary packages that are been used by your distribution do not contain debug information. + Since we usually only develop and fix &krusader;-cvs, compile &krusader;-cvs in debugmode and install it, than check if the bug still exist. + <screen><prompt>$</prompt> <userinput><command>./configure</command> <option>--enable-debug=full</option></userinput></screen> + + Install <ulink url="http://valgrind.org">valgrind</ulink>, a suite of tools for debugging and profiling &Linux; programs. + + Run Valgrind/&krusader; + <screen><prompt>$</prompt> <userinput><command>valgrind</command> <option>--tool=memcheck</option> <replaceable>{foo_path}/krusader</replaceable></userinput></screen> + + The valgrind tool will write to stdout, what really happens. + If you could send these informations before the crash, it's almost sure, that we may fix or tell you what to do. + </para> + <para> </para> <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqg_crashhandler"> + <para>What todo if the KDEcrashhandler sends no usefull backtrace information?</para> + </question> + <answer> + <para>Usually binary packages that are been used by your distribution do not contain debug information. + Since we usually only develop and fix &krusader;-cvs, compile &krusader;-cvs in debugmode and install it, than check if the bug still exist. + <screen><prompt>$</prompt> <userinput><command>./configure</command> <option>--enable-debug=full</option></userinput></screen> + + If the KDEKrashhandler still doesn't provide usefull backtrace information, than sometimes a coredump will give better information. + Run Krusader, with disabled crashhandler. + <screen><prompt>$</prompt> <userinput><command>krusader</command> <option>--nocrashhandler</option></userinput></screen> + + On a crash you will get a <filename>.core</filename> file, usually in your home directory. + + Run <ulink url="http://sourceware.org/gdb/">gdb</ulink>, the GNU Project Debugger + + <screen><prompt>$</prompt> <userinput><command>gdb</command> <option>-c</option> <replaceable>corefile krusader</replaceable></userinput></screen> + + Now type <command>bt</command> to get the backtrace and type <command>q</command> to quit gdb. + + Often the best debug results will be given when using the valgrint tool. + </para> + <para> </para> <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqg_mail_list"> + <para>Does &krusader; have a mailing + list?</para> + </question> + <answer> + <para>Yes, currently we have 6 + &mailing-lists-url;. No spam, no bother, just + &krusader;. Feel free to subscribe and + unsubscribe.</para> + <para>Tip. our mailing lists can be browsed online or + read with a newsreader, so that you don't even need to + subscribe to follow the action on the mailing lists. + <itemizedlist> + <listitem> + <para>&krunews-url; is a very low volume + list, used for newsletters and announcements of new + versions or critical bugfixes. The news can also be + read online at &krulatestnews-url; and in + the &newsforum-url; which are basically + the same but displayed in another format.</para> + </listitem> + <listitem> + <para>&krudevel-url; is the developer + mailing list (read-only). If you want to follow the + development of &krusader; on the cutting + edge, this is the list to follow.</para> + </listitem> + <listitem> + <para>&kruusers-url; is the + &krusader; users mailing list. Here you + can ask for help and talk with the + &krusader; users and developers.</para> + </listitem> + <listitem> + <para>&krui18n-url; is the translations + mailing list.</para> + </listitem> + <listitem> + <para>&krudoc-url; is the documentation + mailing list.</para> + </listitem> + <listitem> + <para>&krucommits-url; (read-only): when + the &krusader; Krew commits code into CVS, + it will be reported in this mailing list. Want to + keep track? Waiting for a certain feature/bugfix? + Follow &krusader;'s development + here.</para> + </listitem> + </itemizedlist></para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_newsfeeds"> + <para>Does &krusader; provide + newsfeeds?</para> + </question> + <answer> + <para>Yes, we do. Several newsfeeds in various formats + are available. &filereleasefeed-url;, + &forumfeed-url;, &krunewsfeed-url;, + &krudevelfeed-url; and even + <ulink url="http://dir.gmane.org/gmane.comp.kde.krusader.devel"> + additional feeds</ulink> by gmane.org. + &kruusersfeed-url;, + &krui18nfeed-url;, + &krudocfeed-url;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_irc"> + <para>Does &krusader; have an IRC + channel?</para> + </question> + <answer> + <para>Yes, we do. Feel free to talk to the + &krusader; Krew and fellow-users via + &freenode-url; servers. The server is + <emphasis>irc.freenode.org</emphasis>, the channel is + <emphasis>#krusader</emphasis>. Everyone is + welcome.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_kru-forum"> + <para>How does the &krusader; forum + work?</para> + </question> + <answer> + <para>In the spirit of freedom of speech, everything that + is &krusader; related can be discussed in our + forum. It does not matter if you are a newcomer or an + advanced user, everyone is welcome. An open source + project's greatest strength is derived from getting user + feedback. That is why we love to hear what you have to + say. With your feedback we can make &krusader; + better and better; otherwise, we are not aware of issues + and ideas you may have. But please remember the + following, so that we can maintain some order in the + chaos.</para> + <para>If the + <link linkend="index">Documentation</link>, + &faq-lnk;, &kruforum-url; and + &krudevel-url; (please use the search function + ) can't help you, do not hesitate to post on our forum. + The &krusader; Krew or the + &krusader; community is always available to + help you.</para> + <para>Please use the &kruforumsearch-url; + function of the &kruforum-url;, your issue may + have been previously discussed (this allows us to + minimize the double/triple/... postings). If your issue + has already been discussed in the past there is a great + chance that you will have an instant solution to your + problem. If the issue is currently being discussed, you + can join in the discussion. Some questions are asked over + and over again, that's why we have created this + &faq-lnk;. This allows us to spend more time + developing &krusader;.</para> + <para>The &kruforum-url; is split into seven + sections: + <itemizedlist> + <listitem> + <para>&newsforum-url;: all the latest + news.</para> + </listitem> + <listitem> + <para>&newsletterforum-url;: all newsletters.</para> + </listitem> + <listitem> + <para>&bugforum-url;: discussions about + bugs, please DO NOT use the forum for + &faqbugreports-lnk; (except if you are + unsure if you have found a bug).</para> + </listitem> + <listitem> + <para>&featureforum-url;: discussions + about new features for future &krusader; + versions.</para> + </listitem> + <listitem> + <para>&todoforum-url; here you will find + the list of the planned features. Registered users + will be able to VOTE and COMMENT on the TODO items. + Here you get the chance to push your favourite + features (+3) and still prefer certain features over + others (+1), if you don't care about a feature just + simply don't vote on that feature. Unregistered users + may only browse the &todoforum-url;. The + &todoranking-url; contains the results + based on the votes. + <link linkend="faqg_patch">Adding ToDo items</link> or + removing ToDo items which have been implemented will + be done by the &krusader; Krew.</para> + </listitem> + <listitem> + <para>&useractionsforum-url;: discussions + about &useractions-lnk;. Posting your own + User Actions is greatly appreciated. We plan to + include the best ones in the next + &krusader; releases.</para> + </listitem> + <listitem> + <para>&krugenforum-url;: everything that + is &krusader; related and doesn't belong + in the other forums.</para> + </listitem> + </itemizedlist></para> + <para>Thank you for your co-operation!</para> + <para>We provide RSS feeds for our forums. You don't have + to check for new posts all the time, instead the news + will come to you! To make use of them, simply point your + RSS aggregator to &rss-url;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_i18n"> + <para>How can I translate &krusader; into my + native language?</para> + </question> + <answer> + <para>Please read the &i18n-page-url;. It's + not difficult to translate! Most anyone can do it, it + just takes some time.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_support"> + <para>How can I support &krusader;?</para> + </question> + <answer> + <para>You can + <link linkend="help_krusader"> + support</link> &krusader; in many different + ways. Please send us + <link linkend="faqg_wish">feedback</link>, + &faqbugreports-lnk;, patches, + <link linkend="help_krusader">donations</link>, + translations, ...</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_mac"> + <para>Is there a &MacOS; X port?</para> + </question> + <answer> + <para>Yes, there is &MacOS; X port, but you + will not have the all the power you would have on + &Linux;. Please read the + <link linkend="mac-port">&MacOS; X port + section</link> for more information. A recommended native + file manager for &MacOS; is + &disk-order-url; (shareware).</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_win"> + <para>Is there a &Windows; port?</para> + </question> + <answer> + <para>No, but this might change in the future. Please + <link linkend="help_krusader">help us</link> with this + project, contributions are greatly appreciated. A + recommended native file manager for &Windows; + is &tcmd-url; (shareware).</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_mcstyle"> + <para>Why is &konqueror; in "midnight + commander style" not an + <link linkend="gloss-ofm">OFM</link>?</para> + </question> + <answer> + <para>The two panels and a commandline are available, all + the other stuff like + <link linkend="features">OFM features</link> and the + <link linkend="gloss-ofm">OFM</link> interaction with the + user is missing from this profile.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + <qandaentry> + <question id="faqg_why_ofm"> + <para>Why should I use an + <link linkend="gloss-ofm">OFM</link>?</para> + </question> + <answer> + <para>An &ofm-url; is much faster than a one + panel filemanager and faster than the command line. If + you would like to know + <ulink url="http://www.softpedia.com/reviews/linux/Krusader-Review-18193.shtml"> + how &krusader; feels</ulink>, there is only + one way to discover: install it on your computer and use + it for a while. If you prefer to waste time and lose + productivity, continue to use one panel filemanagers + which are based on &Windows; Explorer. Matej + Urbančič has written + a + <ulink url="http://murban.blogspot.com/2006/01/krusader-and-konqueror-twin-versus-one.html"> + blog</ulink>on why + <link linkend="gloss-ofm">OFM</link> is better than a one + panel filemanager.</para> + <para></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + </qandaset> + </sect1> + <!-- + <qandaentry> + <question><para> </para></question> + <answer> + <para> </para> + <para> </para> // Empty line to make it more readable + </answer> + </qandaentry> +--> +</chapter> diff --git a/doc/en/features.docbook b/doc/en/features.docbook new file mode 100644 index 0000000..6170c87 --- /dev/null +++ b/doc/en/features.docbook @@ -0,0 +1,515 @@ +<chapter id="features"> +<title>Features</title> +<indexterm> + <primary>Features</primary> +</indexterm> +<note> + <para>The most important features and improvements are + highlighted here, it would make this list too long if we were to + include + <emphasis>all</emphasis> the features and improvements. You will + discover even more features in this documentation and in the + &changelog-url; file.</para> +</note> +<para> + <itemizedlist> + <listitem> + <para> + <itemizedlist> + <title>&ofm-url; features</title> + <listitem> + <para>Two powerful and easy to use + <link linkend="panels">OFM panels</link>.</para> + </listitem> + <listitem> + <para>&cmdline-lnk; and optional + &termemu-lnk; below.</para> + </listitem> + <listitem> + <para>Strong + <link linkend="keyboard-commands"> + keyboard</link>orientation and the ability to perform + all functions without the mouse.</para> + </listitem> + <listitem> + <para>Context-dependent invocation of scripts and + programs ⪚ mouseclick/enter (execute or + open with the associated application), F3 (view) and F4 + (edit).</para> + </listitem> + <listitem> + <para>&usermenu-lnk;, create your own + customized menu.</para> + </listitem> + <listitem> + <para>History ⪚ + <link linkend="folderhistory">Folder History</link>, + <link linkend="popular-urls">Popular + &URL;s</link>, ...</para> + </listitem> + <listitem> + <para>&vfs-lnk; for ⪚ + &remote-connections-lnk;, + &archives-lnk;, search results, + synchronizer.</para> + </listitem> + <listitem> + <para>Powerful internal + <link linkend="krviewer">viewer and editor</link> via + kparts supporting almost every file format.</para> + </listitem> + <listitem> + <para>&advanced-search-module-lnk; : + searching in archives and search content on remote + file systems.</para> + </listitem> + <listitem> + <para>Several Panel view modes via the + &popup-panel-lnk;.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + <itemizedlist> + <title>&krusader; tools</title> + <listitem> + <para>&remote-connections-lnk; : + &FTP;/SAMBA with SFTP/SCP support via + &kioslaves1-url;</para> + </listitem> + <listitem> + <para>&locate-lnk;</para> + </listitem> + <listitem> + <para>&syncdirs-lnk;</para> + </listitem> + <listitem> + <para> + <link linkend="mount-man">Mount-Manager</link> + </para> + </listitem> + <listitem> + <para>&diskusage-lnk;</para> + </listitem> + <listitem> + <para>&rootmode-lnk;</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + <itemizedlist> + <title>&krusader; features</title> + <listitem> + <para>Archive Handling: browsing, unpack, pack, + testing. Supported &archives-lnk; : ace, + arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and + 7-zip.</para> + </listitem> + <listitem> + <para> + <link linkend="checksum">Checksum + creation-verification</link> mechanism that supports + md5, sha1, sha256, sha224, sha256, sha384, sha512, + tiger, whirlpool, cfv and crc.</para> + </listitem> + <listitem> + <para> + <link linkend="calculate">Calculate occupied + space</link> of files and folders, archives and remote + filesystems.</para> + </listitem> + <listitem> + <para> + <link linkend="compare-dir">Directory + comparison</link> and + <link linkend="view-menu">filtering</link>.</para> + </listitem> + <listitem> + <para> + <link linkend="compare-content">Compare files by + content</link> via external diff programs like + &kompare;, &kdiff3-url; or + &xxdiff-url;.</para> + </listitem> + <listitem> + <para> + <link linkend="multi_rename">Rename</link> files and + folders via &krename-url;</para> + </listitem> + <listitem> + <para>Completely supports drag'n'drop: drag from + &konqueror; straight into a .tar.gz file, + from &krusader;'s panel into the trash-bin, + the desktop or into &konqueror;</para> + </listitem> + <listitem> + <para> + <link linkend="konfig-advanced">Preserve date</link> for + local targets at copy/move operations.</para> + </listitem> + <listitem> + <para>F2 opens a + <link linkend="tools-menu">Terminal Window</link> in the + default directory.</para> + </listitem> + <listitem> + <para>Easy editing of + <link linkend="file-menu">file permissions</link> and + ownership and + <link linkend="konfig-looknfeel-operation">Numeric + permissions</link>.</para> + </listitem> + <listitem> + <para> + <link linkend="krusearcher">Selection + filters</link> used in ⪚ Synchronizer and + KruSearcher.</para> + </listitem> + <listitem> + <para> + <link linkend="jump_back">Jump-Back</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="konfig-general"> + mimetype-aware</link>.</para> + </listitem> + <listitem> + <para> + <link linkend="folder-tabs">Tabbed panels</link> and + <link linkend="krviewer">Tabbed + Editor/Viewer</link>.</para> + </listitem> + <listitem> + <para>&quick-search-lnk;</para> + </listitem> + <listitem> + <para> + <link linkend="splitter">File splitter</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="mouse_gestures">Mouse Gestures</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="list_panel">Quick Navigation</link> in + the Location Toolbar.</para> + </listitem> + <listitem> + <para>&whatsthis-url; Help function in favour + of tooltips where reasonable.</para> + </listitem> + <listitem> + <para>&sync-browsing-lnk;</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + <itemizedlist> + <title>Customize &krusader; to your own + needs</title> + <listitem> + <para> + <link linkend="konfig-startup"> + Konfigurator</link> &krusader;'s + configuration center.</para> + </listitem> + <listitem> + <para>&main-toolbar-lnk;, + <link linkend="actions_toolbar">Actions + Toolbar</link> for user actions and bookmarks.</para> + </listitem> + <listitem> + <para> + <link linkend="key_bindings">Key-bindings</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="konfig-color">Colors</link> + </para> + </listitem> + <listitem> + <para>&panel-profiles-lnk;</para> + </listitem> + <listitem> + <para>&bookmark-manager-lnk;</para> + </listitem> + <listitem> + <para>&mouse-selection-modes-lnk;</para> + </listitem> + <listitem> + <para>Many more features can be + <link linkend="konfig-startup">configured</link> the way you + like.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + <itemizedlist> + <title>&krusader; Extensions</title> + <listitem> + <para>&useractions-lnk;</para> + </listitem> + <listitem> + <para>&javascript-console-lnk;</para> + </listitem> + <listitem> + <para>&color-profiles-lnk;</para> + </listitem> + <listitem> + <para>&keybindigs-profiles-lnk;</para> + </listitem> + </itemizedlist>Download and upload your favourite + &krusader; extensions at + &kde-files-url;.</para> + </listitem> + </itemizedlist> +</para> +<para> + <itemizedlist> + <title>New features in the &krusader;-1.80.0 "Final 3rd Stone" + release</title> + <listitem> + <para>Archive improvements + <itemizedlist> + <listitem> + <para> + <link linkend="archives">Password support</link> for: arj, + ace, rar and zip. Passwords can be stored in + &kwallet;</para> + </listitem> + <listitem> + <para> + <link linkend="archives">7-zip support</link>, by + external applications 7z and 7za.</para> + </listitem> + <listitem> + <para> + <link linkend="archives">Auto-detection support</link>, + allowing you to open "hidden archives" (⪚ + &openoffice; documents).</para> + </listitem> + <listitem> + <para>Packing/unpacking is now in the background.</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para><link linkend="list_panel">Brief View</link></para> + </listitem> + <listitem> + <para>Many improvements of the UserAction &useractions-lnk; system.</para> + </listitem> + <listitem> + <para>Countless usability enhancements, especially in Konfigurator and the heavily reordered menubar.</para> + </listitem> + <listitem> + <para> + <link linkend="konfig-advanced">Media button</link> + </para> + </listitem> + <listitem> + <para>Copy/Move: + <link linkend="copying">preserve all attributes</link> (time, + owner, group).</para> + </listitem> + <listitem> + <para> + <link linkend="konfig-color">Dim the colors of the inactive + panel</link>.</para> + </listitem> + <listitem> + <para>Renaming a filename without extension, single instance + mode, start to system tray, check this out in + <link linkend="konfigurator">Konfigurator</link></para> + </listitem> + <listitem> + <para>Configurable + <link linkend="list_panel">Atomic extensions</link>, + so that extensions like <filename>tar.gz</filename> are shown as one part in the <guilabel>Ext Column</guilabel>. + </para> + </listitem> + <listitem> + <para>Context menu for bookmarks and enable/disable special + bookmarks.</para> + </listitem> + <listitem> + <para>Restyled + <link linkend="menu-commands">MenuBar</link></para> + </listitem> + <listitem> + <para>&termemu-lnk; enhancements bringing new functions, new usages and new look.</para> + </listitem> + <listitem> + <para>&synchronizer-lnk; enhancements and parallel threads for slow + FTP servers.</para> + </listitem> + <listitem> + <para> + <link linkend="konfig-startup">Single instance mode</link>, + <link linkend="konfig-startup">start to system + tray</link></para> + </listitem> + <listitem> + <para> + <link linkend="context-menu">Context menu for permanent + bookmarks.</link> + </para> + </listitem> + <listitem> + <para>Full support for + <link linkend="acl">ACL permissions</link> permissions, like properties, preserve attributes, synchronizer and other.</para> + </listitem> + <listitem> + <para>Searcher-results, Locate-results, Synchronizer-results: support for dragging items and copy to clipboard (CTRL+C).</para> + </listitem> + <listitem> + <para>Many bug fixes.</para> + </listitem> + </itemizedlist> +</para> + +<para> + <itemizedlist> + <title>New features in the &krusader;-1.90.0 "Power Stone" + (The final version for KDE3.x)</title> +<para>Basically &krusader;-1.90.0 = &krusader;-1.80.0 + bugfixes + + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1989">Krusader Extensions</ulink> sended in by our users.</para> + + <listitem> + <para> + <itemizedlist> + <para>Improvements:</para> + <listitem> + <para>GCC 4.3 compatibility.</para> + </listitem> + <listitem> + <para>&kde; 3.2 - &kde; 3.5 compatibility.</para> + </listitem> + <listitem> + <para>bugfixes.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para> + <itemizedlist> + <para>Many &krusader; Extensions:</para> + <listitem> + <para>Keymaps, use keybindings of other commanders or customized keybindings!</para> + </listitem> + <listitem> + <para>Colormaps, use colors of other commanders or customized colors !</para> + </listitem> + <listitem> + <para>Useractions, create actions for your own needs ! <link linkend="useractions-menu">Click here</link> for and overview.</para> + </listitem> + <listitem> + <para>Javascript useractions, create actions with additional javascript power for your own needs !</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para>Krusader Extensions highlights: + <itemizedlist> + <para>Color schemes:</para> + <listitem> + <para>&tcmd;</para> + </listitem> + <listitem> + <para><trademark class="copyright">Dos Navigator</trademark></para> + </listitem> + <listitem> + <para>Midnight Commander</para> + </listitem> + <listitem> + <para>bash</para> + </listitem> + </itemizedlist> + + <itemizedlist> + <para>Keymap:</para> + <listitem> + <para>Midnight Commander</para> + </listitem> + </itemizedlist> + + <itemizedlist> + <para>Useractions:</para> + <listitem> + <para>Search and Replace in file</para> + </listitem> + <listitem> + <para>Split large mp3 files</para> + </listitem> + <listitem> + <para>Archive foo to dir</para> + </listitem> + <listitem> + <para>lzma and tar.lzma archive support</para> + </listitem> + <listitem> + <para>tar.7z archive support</para> + </listitem> + <listitem> + <para>ar (.a, .deb,...) archive support</para> + </listitem> + <listitem> + <para>Unpack multiple zip archives</para> + </listitem> + <listitem> + <para>kgpg: encrypt, decrypt, sign, verify signature</para> + </listitem> + <listitem> + <para>.uue file support (uuencode and uudecode)</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para> + <itemizedlist> + <para>Javascript useractions:</para> + <listitem> + <para>Recode files using iconv or GNU recode.</para> + </listitem> + <listitem> + <para>Mount as root.</para> + </listitem> + <listitem> + <para>Select from file.</para> + </listitem> + <listitem> + <para>Calculator.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para>Check the &changelog-url; for a complete overview of changes.</para> + </listitem> + </itemizedlist> +</para> + + + +&dev-cvs-note;</chapter> diff --git a/doc/en/glossary.docbook b/doc/en/glossary.docbook new file mode 100644 index 0000000..70b889f --- /dev/null +++ b/doc/en/glossary.docbook @@ -0,0 +1,355 @@ +<glossary id="glossary"> + <!-- ********************************************************************** + glossary.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <indexterm> + <primary>Glossary</primary> + </indexterm> + <para>This chapter is intended to explain the various words which + have been used throughout the &krusader; + documentation. If you believe some acronyms or terms are missing, + please do not hesitate to contact the &krusader; + documentation team.</para> + <para>Thanks to + <ulink url="http://en.wikipedia.org/">wikipedia.org</ulink> the + free encyclopedia that anyone can edit.</para> + <glossentry id="gloss-acl"> + <glossterm> + <acronym>ACL</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Access_control_list"> + Access Control List</ulink>; a concept in computer security + used to enforce privilege separation. It is a means of + determining the appropriate access rights to a given object + depending on certain aspects of the process that is making + the request.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-bsd"> + <glossterm> + <acronym>BSD</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Bsd">Berkeley + Software Distribution</ulink>; refers to any of several free + &UNIX;-compatible operating systems, derived from + <acronym>BSD</acronym>&UNIX;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-cvs"> + <glossterm> + <acronym>CVS</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Concurrent_Versions_System"> + Concurrent Versions System</ulink>; an important component of + Source Configuration Management (SCM). By using it, + developers can record the history of source files and + documents.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-deb"> + <glossterm> + <acronym>DEB</acronym> + </glossterm> + <glossdef> + <para>This is a binary file format that is used by + <ulink url="http://en.wikipedia.org/wiki/Debian"> + &debian;</ulink> and &debian;-based + distributions. It is a suffix of a installation file + specifically built for these distributions; e.g. + <filename>krusader_1.70.1-1_amd64.deb</filename>. Simply + described it is a special archive containing all the + program files and their proposed location on the + system.</para> + </glossdef> + </glossentry> + <glossentry id="glos-dcop"> + <glossterm> + <acronym>DCOP</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Dcop">Desktop + Communication Protocol</ulink>; the interprocess + communication protocol used by &kde; desktop + environment. It enables various &kde; applications + to communicate with each other.</para> + </glossdef> + </glossentry> + <glossentry id="glos-faq"> + <glossterm> + <acronym>FAQ</acronym> + </glossterm> + <glossdef> + <para> + <link linkend="faq">Frequently Asked Questions</link>; a + document where questions that arise many times are answered. + If you have a question to the developers of + &krusader;, you should always have a look at the + &faq-lnk; first.</para> + </glossdef> + </glossentry> + <glossentry id="glos-ftp"> + <glossterm>&FTP;</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/File_Transfer_Protocol"> + File Transfer Protocol</ulink>; it is an Internet protocol + that allows you to retrieve files from so-called + &FTP; servers.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-gpl"> + <glossterm> + <acronym>GPL</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Gpl">GNU General + Public License</ulink>; a software license created by the + <ulink url="http://www.fsf.org/">Free Software + Foundation</ulink> defining the terms for releasing free + software.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-gui"> + <glossterm>&GUI;</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Graphical_user_interface"> + Graphical User Interface</ulink>.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-iso"> + <glossterm> + <acronym>ISO</acronym> + </glossterm> + <glossdef> + <para>An + <ulink url="http://en.wikipedia.org/wiki/ISO_image">ISO + image</ulink> (.iso) is an informal term for a disk image of + an ISO 9660 file system. More loosely, it refers to any + optical disk image, even a UDF image.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-kde"> + <glossterm>&kde;</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Kde">K Desktop + Environment</ulink>; a project to develop a free graphical + desktop environment for &UNIX; compatible + systems.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-keybinding"> + <glossterm>Key Binding</glossterm> + <glossdef> + <para>All features of &krusader; are available + through the menubar, but you can also bind (link) a certain + key combination to that function. You will find, however, + that using the + <link linkend="keyboard-commands">keyboard</link> is remakably + faster than using the menubar or + <link linkend="gloss-gui">GUI</link>. + <link linkend="keyboard-commands">Keyboard usage</link> is an + important tool for + <link linkend="gloss-ofm">Orthodox File Managers</link>. + &krusader; comes with several predefined + &keybindigs-lnk;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-kpart"> + <glossterm>Kpart</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/KPart"> + Kpart</ulink>; KParts is the name of the component framework + for the &kde; desktop environment. KParts are + analogous to Bonobo components in &gnome-url;, + both of which are based on the same concepts as + &Microsoft;'s Object Linking and Embedding. e.g. + if you use &krusader;'s viewer to view a PDF file, + KPDF wil be launched inside &krusader;'s + viewer.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-kio"> + <glossterm> + <acronym>KIO</acronym> or kioslave</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Kioslave">KDE + Input/Output</ulink>; also known as + &kioslaves1-url; is part of the &kde; + architecture. It provides access to files, web sites and + other resources through a single consistent API.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-mount"> + <glossterm>mount</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Mount_%28computing%29"> + Mouting</ulink>; in computer science, is the process of + making a file system ready for use by the operating system, + typically by reading certain index data structures from + storage into memory ahead of time. The term recalls a period + in the history of computing when an operator had to mount a + magnetic tape or hard disk on a spindle before using + it.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-ofm"> + <glossterm> + <acronym>OFM</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://www.softpanorama.org/OFM/index.shtml"> + Orthodox File Manager</ulink>; also known as "Commanders". + Members of this family of file managers use simple yet very + powerful interface that is a direct derivative of the + <ulink url="http://en.wikipedia.org/wiki/Norton_Commander"> + Norton Commander</ulink> (NC) interface.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-rpm"> + <glossterm>RPM</glossterm> + <glossdef> + <para>This is the binary file format for distributions based + on the + <ulink url="http://www.rpm.org/">RPM Package Manager</ulink>, + a widely used packaging tool for the &Linux; + operating system. If you still have to get + &krusader; and your system supports RPM packages, + you should get &krusader; packages ending in + .rpm.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-ssh"> + <glossterm> + <acronym>SSH</acronym>, Secure Shell</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/SSH">SSH</ulink>; + is a set of standards and an associated network protocol that allows + establishing a secure channel between a local and a remote computer.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-svn"> + <glossterm> + <acronym>SVN</acronym>, Subversion</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Subversion"> + Subversion</ulink>; a version control system that is a + compelling replacement for + <link linkend="gloss-cvs">CVS</link>. It is used by many + software projects including &kde; and + &krusader;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-termemu"> + <glossterm>Terminal emulator</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Terminal_emulator"> + Terminal emulator</ulink>; simply a windowed shell; this is + known as command line window in some other environments. If + you want to use the shell and type the commands, you should + know at least a few of the system-level commands for your + operating system.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-posix"> + <glossterm> + <acronym>POSIX</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Posix">"Portable + Operating System Interface for uniX"</ulink>; a collective + name of a family of related standards specified by the IEEE + to define the application programming interface (API) for + software compatible with variants of the &UNIX; + operating system.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-url"> + <glossterm> + <acronym>&URL;</acronym> + </glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/URL">Universal + Resource Locater</ulink>; a universal resource locater is the + technical term for what is commonly referred to as a websites + address. Examples of URLs include + <ulink url="http://krusader.sourceforge.net"> + http://krusader.sourceforge.net</ulink> and + &remote-connections-lnk;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-vfs"> + <glossterm> + <acronym>VFS</acronym> + </glossterm> + <glossdef> + <para>&vfs-lnk; is a basic + <link linkend="features">OFM feature</link>, this an + abstracted layer over all kinds of archived information (ZIP + files, FTP servers, TAR archives, NFS filesystems, SAMBA + shares, ISO cd/dvd images, RPM catalogs, etc.), which allows + the user to access all the information in these divergent + types of file systems transparently - just like entering an + ordinary sub-directory! &krusader; supports + several &vfs-lnk;.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-xml"> + <glossterm>XML</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Xml">Extensible + Markup Language</ulink>; a very flexible text format derived + from SGML (ISO 8879). Originally designed to meet the + challenges of large-scale electronic publishing, XML is also + playing an increasingly important role in the exchange of a + wide variety of data on the Web and elsewhere.</para> + </glossdef> + </glossentry> + <glossentry id="gloss-zeroconf"> + <glossterm>Zeroconf</glossterm> + <glossdef> + <para> + <ulink url="http://en.wikipedia.org/wiki/Zeroconf">Zeroconf</ulink>; + or Zero Configuration Networking is a set of techniques that automatically + create a usable IP network without configuration or special servers. + This allows inexpert users to connect computers, networked printers, + and other items together and expect them to work automatically.</para> + </glossdef> + </glossentry> +</glossary> diff --git a/doc/en/help.docbook b/doc/en/help.docbook new file mode 100644 index 0000000..a3b6ee4 --- /dev/null +++ b/doc/en/help.docbook @@ -0,0 +1,158 @@ +<!-- ********************************************************************** + help.docbook + +++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> +<preface id="help_krusader"> + <title>Help &krusader;</title> + <indexterm> + <primary>Help</primary> + </indexterm> + <para>Here is your opportunity to &contribute-url; to + the &krusader; project. There are things that need to + be done, but can't be done by us. If you feel you can help, do not + hesitate to contact us; every OpenSource can use some help. + Please also check the &contribute-url; page on our + website for more recent information. Thanks!</para> + <para> + <emphasis role="bold">Documentation</emphasis> + </para> + <para>Help is needed (we are looking for documentation writers) + for keeping the &krusader; documentation up to date. + The draft explanation of new features is done by the developers + on the krusader-devel mailing list, but we need editors to add + this information in the handbook. By playing with the new + features these editors can give valuable information to the + developers for making the new features even better!</para> + <para> + <emphasis role="bold">&krusader; + Extensions</emphasis> + </para> + <para>Please upload your favourite extensions at + &kde-files-url;, so that they become available for the + &krusader; community. Maybe they will be shipped by + default with &krusader; at the next release :-)) It + features + <ulink url="http://www.kde-files.org/index.php?xcontentmode=660"> + Keymaps</ulink>, + <ulink url="http://www.kde-files.org/index.php?xcontentmode=661"> + Colormaps</ulink>, + <ulink url="http://www.kde-files.org/index.php?xcontentmode=662"> + User Actions</ulink>, + <ulink url="http://www.kde-files.org/index.php?xcontentmode=663"> + JavaScript Extensions</ulink>.</para> + <para>User Actions can be discussed in our + &useractionsforum-url;, please join!</para> + <para> + <emphasis role="bold">Spread the Word + &krusader;</emphasis> + </para> + <para>If you like &krusader;, + <ulink url="http://krusader.sourceforge.net/spread.php">let + people know!</ulink> Write articles and reviews for internet or + print publications. Encourage your friends to give + &krusader; a try. Participate in forums to help others + in the community.</para> + <para> + <emphasis role="bold">GUI Translations</emphasis> + </para> + <para>&krusader; is available in many languages, but + usually several translations do need an update and translations + to new languages are always welcome, please read the + &i18n-page-url; . Even when there is already a + translator for your native language, it is always helpful to have + a second or third translator ⪚ for proofreading. + Sometimes the regular translator is not available when a + translation update is needed (studies, holiday...). Please + contact the translator/s for your native language; your help will + be appreciated. Any translation (even partial translations) are + accepted by the &krusader;-Krew at any time (feature + freeze or not).</para> + <para> + <emphasis role="bold">Documentation Translations</emphasis> + </para> + <para>This documentation is translatable, if you are interested + in translating this documentation please contact Frank.</para> + <para> + <emphasis role="bold">OpenUsability</emphasis> + </para> + <para>Using a program, understanding its interface and getting + information out of it, is something that should always be clear + in every application - no matter how advanced your understanding + of operating systems is or how deep your computer literacy is. + For that reason &krusader; asked to be included in the + &openusability-url; project.</para> + <para>This project joins the software developers and usability + experts in an attempt to check all parts of a user interface for + the inappropriate entries. Its main goal is making user + interfaces and dialogs understandable and friendly to every user. + We need our users comments, your comments, to make things better. + In case you find a part of the program's interface to be too + complicated, please do help us correct it and make it + better.</para> + <para> + <emphasis role="bold">Donations</emphasis> + </para> + <para>Actually, we hadn't considered donations, until users asked + us for a way to &donate-url; to the project. + &krusader; is, and always will be free, in all the + terms of the GNU Public License.</para> + <para> + <emphasis role="bold">Packagers</emphasis> + </para> + <para>We are always in need of packagers for different distro + rpm's, deb's, etc. All help is welcome.</para> + <para> + <emphasis role="bold">Users' feedback for the + &krusader; &MacOS; X port</emphasis> + </para> + <para>There is a &macosx-port-url; + with the help of &fink-url; , the port is + maintained by + <ulink url="http://hritcu.wordpress.com/about/">Catalin Hritcu</ulink>, + all feedback is welcome.</para> + <para> + <emphasis role="bold">Porting &krusader; to + &Windows;</emphasis> + </para> + <para>&krusader; is written using &Qt; as + well as &kde;libs. As long as &kde;libs + does not run on &Windows;, porting + &krusader; is not an option. However, we do believe + that once &Qt;4-GPL is released, efforts will be made + to port &kde;libs to &Windows;, and if that + happens, we're in business and then we need a maintainer for + porting &krusader; to &Windows;.</para> + <para> + <emphasis role="bold">FAQ</emphasis> + </para> + <para>If you have a question that is missing in the + &faq-lnk;, we would like to hear it.</para> + <para> + <emphasis role="bold">Others</emphasis> + </para> + <para> + <link linkend="faqg_wish">Feedback</link>, + <link linkend="faqg_bug_report">Bug reports</link>, patches, + &etc; are always welcome! An open source project's + greatest strength is derived from getting user feedback.</para> + <para>On some websites like &freshmeat-url; or + &kde-apps-url; you can give a rate, if you like + &krusader; go to one of these sites and rate + &krusader;, thanks.</para> +</preface> diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..146f1ba --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,594 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- <?xml version="1.0" ?> --> +<!DOCTYPE +book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" +"dtd/kdex.dtd" +[ + +<!-- +Previous used Docbook +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ +--> + +<!-- ********************************************************************** + index.docbook + +++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<!ENTITY krusader 'Krusader'> +<!ENTITY kapp "&krusader;"> +<!ENTITY kappname "&krusader;"> +<!-- <!ENTITY % addindex "IGNORE"> --> +<!ENTITY % addindex "INCLUDE"> + +<!-- ONLY If you are writing non-English original documentation, change the language here --> +<!ENTITY % English "INCLUDE"> +<!ENTITY Backspace "<keycap>Backspace</keycap>"> +<!-- +Added <!ENTITY Backspace "<keycap>Backspace</keycap>"> in index.docbook +since the Entity Backspace is not defined in +/usr/share/apps/ksgmltools2/customization/ru/user.entities on KDE: 3.5.4 +This is a workaround, until Backspace is translated in all +/usr/share/apps/ksgmltools2/customization/ru/user.entities +files +http://groups.google.com/group/krusader-devel/browse_thread/thread/d102adec2edcfb47/e3ca0489310cc12e#e3ca0489310cc12e +--> + +<!-- kdebase, kdeadmin, etc. Leave this unchanged if your application is not maintained in KDE CVS --> +<!ENTITY package "kde-module"> + +<!-- internet links, Krusader --> +<!ENTITY onlinehandbook-url '<ulink url="http://www.krusader.org/handbook/">Online Handbook</ulink>'> +<!ENTITY kru-screenshots-url '<ulink url="http://www.krusader.org/scr.php">&krusader; Screenshots</ulink>'> +<!ENTITY mail-url '<ulink url="mailto:krusader * users.sourceforge net">mail</ulink>'> + +<!ENTITY kruwebsite-url '<ulink url="http://www.krusader.org">Krusader website</ulink>'> +<!ENTITY kruproject-url '<ulink url="http://sourceforge.net/projects/krusader">here</ulink>'> +<!ENTITY contribute-url '<ulink url="http://www.krusader.org/help.php">contribute</ulink>'> +<!ENTITY donate-url '<ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488">Donate</ulink>'> + +<!ENTITY kruforum-url '<ulink url="http://www.krusader.org/phpBB/index.php">&krusader; Forum</ulink>'> +<!ENTITY kruforumsearch-url '<ulink url="http://www.krusader.org/phpBB/search.php">Search</ulink>'> +<!ENTITY krugenforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=1">General Discussion Forum</ulink>'> +<!ENTITY newsforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=7">News and Announcements Forum</ulink>'> +<!ENTITY newsletterforum-url '<ulink url="http://krusader.sourceforge.net/phpBB/viewforum.php?f=12">NewsLetter Forum</ulink>'> +<!ENTITY bugforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=3">Bug Discussion Forum</ulink>'> +<!ENTITY featureforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=6">New Features Discussion/Requests Forum</ulink>'> +<!ENTITY todoforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=10">ToDo Forum</ulink>'> +<!ENTITY todoranking-url '<ulink url="http://www.krusader.org/todo.php">ToDo ranking system</ulink>'> +<!ENTITY useractionsforum-url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=11">UserActions Forum</ulink>'> +<!ENTITY rss-url '<ulink url="http://krusader.sf.net/phpBB/rss.php">here</ulink>'> +<!ENTITY krucutedge-url '<ulink url="http://www.krusader.org/cvs.php">&krusader;'s Cutting Edge page</ulink>'> +<!ENTITY active-passive-ftp-url '<ulink url="http://slacksite.com/other/ftp.html">Active &FTP; vs. Passive &FTP;, a Definitive Explanation</ulink>'> + +<!ENTITY viewcvs-url '<ulink url="http://krusader.cvs.sourceforge.net/krusader/">ViewCVS</ulink>'> +<!ENTITY sfmirrors-url '<ulink url="http://sourceforge.net/project/showfiles.php?group_id=6488">Sourceforge mirrors</ulink>'> +<!ENTITY changelog-url +'<ulink url="http://www.krusader.org/text.php?t=cvs.changelog"><filename>ChangeLog</filename></ulink>'> +<!ENTITY cvsnews-url +'<ulink url="http://www.krusader.org/text.php?t=cvs.news"><filename>CVSNEWS</filename></ulink>'> +<!ENTITY docchangelog-url '<ulink url="http://cvs.sourceforge.net/viewcvs.py/krusader/krusader_kde3/doc/ChangeLog?view=markup">Documentation ChangeLog</ulink>'> +<!ENTITY i18n-page-url '<ulink url="http://www.krusader.org/i18n.php">i18n page</ulink>'> + +<!ENTITY deb-requirements-url '<ulink url="http://packages.debian.org/unstable/utils/krusader">requirements on &debian;</ulink>'> +<!ENTITY mailing-lists-url '<ulink url="http://www.krusader.org/lists.php">mailing lists</ulink>'> +<!ENTITY krunews-url '<ulink url="http://groups-beta.google.com/group/krusader-news">&krusader;-news</ulink>'> +<!ENTITY krulatestnews-url '<ulink url="http://www.krusader.org/news.php">latest news</ulink>'> + +<!ENTITY krucommits-url '<ulink url="http://sourceforge.net/mailarchive/forum.php?forum_id=34772">&krusader;-commits</ulink>'> +<!ENTITY krudevel-url '<ulink url="http://groups-beta.google.com/group/krusader-devel">&krusader;-devel</ulink>'> +<!ENTITY kruusers-url '<ulink url="http://groups-beta.google.com/group/krusader-users">&krusader;-users</ulink>'> +<!ENTITY krudoc-url '<ulink url="http://groups-beta.google.com/group/krusader-doc">&krusader;-doc</ulink>'> +<!ENTITY krui18n-url '<ulink url="http://groups-beta.google.com/group/krusader-i18n">&krusader;-i18n</ulink>'> + +<!ENTITY forumfeed-url '<ulink url="http://www.krusader.org/phpBB/rss.php">rss-forumfeed</ulink>'> +<!ENTITY filereleasefeed-url '<ulink url="http://sourceforge.net/export/rss2_projfiles.php?group_id=6488">rss-filerelease feed</ulink>'> +<!ENTITY krunewsfeed-url '<ulink url="http://groups.google.com/group/krusader-news/feeds">krusader-news feed</ulink>'> +<!ENTITY krudevelfeed-url '<ulink url="http://groups.google.com/group/krusader-devel/feeds">krusader-devel feed</ulink>'> +<!ENTITY kruusersfeed-url '<ulink url="http://groups.google.com/group/krusader-users/feeds">krusader-users feed</ulink>'> +<!ENTITY krui18nfeed-url '<ulink url="http://groups.google.com/group/krusader-i18n/feeds">krusader-i18n feed</ulink>'> +<!ENTITY krudocfeed-url '<ulink url="http://groups.google.com/group/krusader-doc/feeds">krusader-doc feed</ulink>'> + +<!ENTITY online-buglist-url '<ulink url="http://sourceforge.net/tracker/?atid=106488&group_id=6488&func=browse">online bug list</ulink>'> +<!ENTITY patch-tracker-url '<ulink url="http://sourceforge.net/tracker/?group_id=6488&atid=306488">Patch Tracker</ulink>'> +<!ENTITY i18n-credits-url '<ulink url="http://krusader.cvs.sourceforge.net/krusader/krusader_kde3/po/">more translator credits</ulink>'> + + +<!ENTITY subversion-url '<ulink url="http://sourceforge.net/svn/?group_id=6488">Subversion</ulink>'> +<!ENTITY browse-svn-repo-url '<ulink url="http://svn.sourceforge.net/krusader">Browse the Subversion Repository</ulink>'> + +<!ENTITY fhs-url '<ulink url="http://www.pathname.com/fhs/">Filesystem Hierarchy Standard (FHS)</ulink>'> + +<!-- internet links, Krusader binaries --> +<!ENTITY krudownload-url '<ulink url="http://www.krusader.org/down.php">&krusader; downloadpage</ulink>'> +<!ENTITY gentoo-life-ebuild-url '<ulink url="http://www.krusader.org/data/krusader-cvs-1.ebuild">&gentoo; Live Ebuild</ulink>'> + +<!ENTITY gentoo-download-url '<ulink url="http://packages.gentoo.org/search/?sstring=krusader">&gentoo;</ulink>'> +<!ENTITY suse-download-url '<ulink url="http://search.novell.com/qfsearch/SearchServlet?bbshow=true&query0=krusader&operator0=0&collection=Novell&date=&numhits=10&template=ResultListTemplate.html&submit+search=Search">&SuSE;</ulink>'> +<!ENTITY mandriva-download-url '<ulink url="http://search.belnet.be/packages/mandrake/current/i586/media/contrib/">&mandriva;</ulink>'> +<!ENTITY freebsd-download-url '<ulink url="http://www.freebsd.org/cgi/ports.cgi?query=krusader&stype=all">&freebsd;</ulink>'> +<!ENTITY debian-download-url '<ulink url="http://packages.debian.org/krusader">&debian;</ulink>'> +<!ENTITY netbsd-download-url '<ulink url="http://pkgsrc.se/sysutils/krusader">&netbsd;</ulink>'> +<!ENTITY yoper-download-url '<ulink url="http://ftp.belnet.be/linux/yoper/devel/yoper-3.0/RPMS.chris/">&yoper;</ulink>'> +<!ENTITY macosx-port-url '<ulink url="http://pdb.finkproject.org/pdb/package.php/krusader">&MacOS;-X port</ulink>'> +<!ENTITY ubuntu-kubuntu-download-url '<ulink url="http://packages.ubuntu.com/krusader">&ubuntu;/&kubuntu;</ulink>'> +<!ENTITY linspire-download-url '<ulink url="http://www.linspire.com/lindows_products_details.php?product_id=3160&pg=specs">&linspire;</ulink>'> +<!ENTITY archlinux-download-url '<ulink url="http://www.archlinux.org/packages.php?id=793">&archlinux;</ulink>'> +<!ENTITY frugalware-linux-download-url '<ulink url="http://frugalware.org/packages.php?id=280">&frugalware-linux;</ulink>'> +<!ENTITY pclinuxos-download-url '<ulink url="http://www.pclinuxonline.com/pclos/html/package_list.html">&pclinuxos;</ulink>'> +<!ENTITY altlinux-download-url '<ulink url="http://www.altlinux.com/index.php?module=sisyphus&package=krusader">&altlinux;</ulink>'> +<!ENTITY ccuxlinux-download-url '<ulink url="http://packages.ccux-linux.de/index.php?pdetail=154">&ccuxlinux;</ulink>'> +<!ENTITY lunarlinux-download-url '<ulink url="http://modules.lunar-linux.org/index.php?option=module&module=krusader">&lunarlinux;</ulink>'> +<!ENTITY qilinux-download-url '<ulink url="http://www.qilinux.org/modules.php?op=modload&name=distromatic&file=index&tag=devel&pkg=krusader.source">&qilinux;</ulink>'> +<!ENTITY rocklinux-download-url '<ulink url="http://www.rocklinux.net/packages/krusader.html">&rocklinux;</ulink>'> + +<!ENTITY klik-protocol-url '<ulink url="http://klik.atekon.de/">klik protocol</ulink>'> +<!ENTITY klik-krusader-url '<ulink url="klik://krusader">klik://krusader</ulink>'> +<!ENTITY klik-krusader-latest-url '<ulink url="klik://krusader-latest">klik://krusader-latest</ulink>'> +<!ENTITY klik-krusader-cvs-url '<ulink url="klik://krusader-cvs">klik://krusader-cvs</ulink>'> +<!ENTITY klik-available-url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader">available</ulink>'> +<!ENTITY klik-stable-krusader-url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader-latest">stable &krusader;</ulink>'> +<!ENTITY klik-cvs-krusader-url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader-cvs">cvs snapshot of &krusader;</ulink>'> + + +<!ENTITY fedora-extras-url '<ulink url="http://fedoraproject.org/wiki/Extras/UsingExtras ">&fedora; Extras</ulink>'> +<!ENTITY distrowatch-com-url '<ulink url="http://distrowatch.com/search.php?pkg=krusader&pkgver=1.70.0">Distrowatch.com</ulink>'> + +<!ENTITY dag-wiers-download-url '<ulink url="http://dag.wieers.com/packages/krusader/">dag.wieers.com</ulink>'> +<!ENTITY dries-verachtert-download-url '<ulink url="http://dries.ulyssis.org/rpm/packages/krusader/info.html">Dries Verachtert RPM Repository</ulink>'> +<!ENTITY portpkg-url '<ulink url="http://portpkg.berlios.de/">Portpkg</ulink>'> +<!ENTITY kru-slackbuild-url '<ulink url="http://cvs.berlios.de/cgi-bin/viewcvs.cgi/portpkg/ports/open/krusader/Attic/">&krusader; SlackBuild</ulink>'> + +<!ENTITY freshmeat-url '<ulink url="http://freshmeat.net/projects/krusader/">freshmeat.net</ulink>'> +<!ENTITY rpmfind-url '<ulink url="http://rpmfind.net/linux/rpm2html/search.php?query=krusader&submit=Search+...">rpmfind</ulink>'> +<!ENTITY rpmpbone-url '<ulink url="http://rpm.pbone.net/index.php3/stat/3/search/krusader">rpmpbone</ulink>'> +<!ENTITY rpmseek-url '<ulink url="http://rpmseek.com/rpm-pl/krusader.html?hl=com&cx=2155:K:0">rpmseek</ulink>'> + +<!ENTITY kde-files-url '<ulink url="http://www.kde-files.org/index.php?xcontentmode=660x661x662x663">kde-files.org</ulink>'> + +<!-- internet links, others --> +<!ENTITY xxdiff-url '<ulink url="http://furius.ca/xxdiff/"><application>xxdiff</application></ulink>'> +<!ENTITY kdiff3-url '<ulink url="http://kdiff3.sourceforge.net"><application>Kdiff3</application></ulink>'> +<!ENTITY krename-url '<ulink url="http://www.krename.net"><application>Krename</application></ulink>'> +<!ENTITY kasablanca-url '<ulink url="http://kasablanca.berlios.de/">Kasablanca</ulink>'> +<!ENTITY kftpgrabber-url '<ulink url="http://kftpgrabber.sourceforge.net/"><application>Kftpgrabber</application></ulink>'> +<!ENTITY xbel-url '<ulink url="http://grail.sourceforge.net/info/xbel.html">XBEL standard</ulink>'> +<!ENTITY kde-apps-url '<ulink url="http://www.kde-apps.org/content/show.php?content=10214">KDE-APPS.org</ulink>'> +<!ENTITY rpm-org-url '<ulink url="http://www.rpm.org/">rpm.org</ulink>'> +<!ENTITY rpm-guide-url '<ulink url="http://fedora.redhat.com/docs/drafts/rpm-guide-en/">RPM Guide</ulink>'> +<!ENTITY kioslaves1-url '<ulink url="http://docs.kde.org/development/en/kdebase/kioslave/index.html">KIOSlaves</ulink>'> +<!ENTITY kioslaves2-url '<ulink url="http://developer.kde.org/documentation/library/3.4-api/kio/html/index.html">KIOSlaves</ulink>'> +<!ENTITY kio-ipodslave-url '<ulink url="http://sourceforge.net/projects/kpod">KIOipod-slave</ulink>'> +<!ENTITY kdelibs-url '<ulink url="http://lxr.kde.org/source/kdelibs/kioslave">&kde;libs</ulink>'> +<!ENTITY kdebase-url '<ulink url="http://lxr.kde.org/source/kdebase/kioslave">&kde;base</ulink>'> +<!ENTITY gnome-url '<ulink url="http://www.gnome.org"><application>GNOME</application></ulink>'> +<!ENTITY afterstep-url '<ulink url="http://www.afterstep.org/"><application>AfterStep</application></ulink>'> +<!ENTITY xfce-url '<ulink url="http://www.xfce.org/"><application>XFce</application></ulink>'> + +<!ENTITY debian-qt-a-url '<ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=710">in our forum</ulink>'> +<!ENTITY debian-qt-b-url '<ulink url="http://opendoorsoftware.com/cgi/http.pl?p=DebianQTChecklist">instructions</ulink>'> +<!ENTITY freenode-url '<ulink url="http://freenode.net">freenode.org</ulink>'> +<!ENTITY fink-url '<ulink url="http://www.finkproject.org/">fink</ulink>'> +<!ENTITY kjsembed-url '<ulink url="http://xmelegance.org/kjsembed/">KJSEmbed</ulink>'> + +<!ENTITY ofm-url '<ulink url="http://www.softpanorama.org/OFM/index.shtml">Orthodox File Manager (OFM)</ulink>'> +<!ENTITY disk-order-url '<ulink url="http://www.likemac.ru/english/"><trademark class="copyright">Disk Order</trademark></ulink>'> +<!ENTITY apple-x11-url '<ulink url="http://www.apple.com/downloads/macosx/apple/x11formacosx.html">&apple; X11</ulink>'> +<!ENTITY apple-x11-sdk-url '<ulink url="http://developer.apple.com/darwin/runningX11.html">&apple; X11 SDK</ulink>'> +<!ENTITY bodo-tasche-url '<ulink url="http://blog.wannawork.de/about.php">Bodo Tasche</ulink>'> + +<!ENTITY sourceforge-net-url '<ulink url="http://sourceforge.net/">Sourceforge.net</ulink>'> +<!ENTITY openusability-url '<ulink url="http://openusability.org/projects/krusader/">OpenUsability.org</ulink>'> + +<!ENTITY whatsthis-url '<ulink url="http://urbanlizard.com/~aseigo/whatsthis_tutorial/">WhatsThis</ulink>'> + + + +<!-- documentation links --> +<!ENTITY context-menu-lnk '<link linkend="context-menu">Context Menu</link>'> +<!ENTITY vfs-lnk '<link linkend="vfs">Virtual file systems (VFS)</link>'> +<!ENTITY mouse-selection-modes-lnk '<link linkend="mouse_selection_modes">Mouse Selection Modes</link>'> +<!ENTITY konfigstartpg-lnk '<link linkend="konfigurator">Konfigurator Startup page</link>'> +<!ENTITY konfiglookandfeel-lnk '<link linkend="konfig-looknfeel">Konfigurator Look & Feel page</link>'> +<!ENTITY konfiggereral-lnk '<link linkend="konfig-general">Konfigurator General page</link>'> +<!ENTITY konfigdependencie-lnk '<link linkend="konfig-dependencies">Konfigurator Dependencies page</link>'> +<!ENTITY konfigprotocol-lnk '<link linkend="konfig-protocols">Konfigurator Protocol page</link>'> +<!ENTITY viewmenu-lnk '<link linkend="view-menu">View menu</link>'> +<!ENTITY editmenu-lnk '<link linkend="edit-menu">Edit menu</link>'> +<!ENTITY comparedir-lnk '<link linkend="compare-dir">Compare Directories</link>'> +<!ENTITY fnkeybar-lnk '<link linkend="fnkeys">FN Keys Bar</link>'> +<!ENTITY main-toolbar-lnk '<link linkend="mainwindow">Main Toolbar</link>'> +<!ENTITY actions-toolbar-lnk '<link linkend="actions_toolbar">Actions Toolbar</link>'> +<!ENTITY statusbar-lnk '<link linkend="mainwindow">Statusbar</link>'> +<!ENTITY location-toolbar-lnk '<link linkend="list_panel">Location Toolbar</link>'> +<!ENTITY rootmode-lnk '<link linkend="root-mode">Root mode</link>'> +<!ENTITY settingsmenu-lnk '<link linkend="settings-menu">Settings menu</link>'> +<!ENTITY keybindigs-lnk '<link linkend="key_bindings">Key-Bindings</link>'> +<!ENTITY keybindigs-profiles-lnk '<link linkend="configure-shortcuts">Key-binding Profiles</link>'> +<!ENTITY color-profiles-lnk '<link linkend="konfig-color">Color Profiles</link>'> +<!ENTITY synchronizer-lnk '<link linkend="synchronizer">Synchronizer</link>'> +<!ENTITY syncdirs-lnk '<link linkend="synchronizer">Synchronize Directories</link>'> +<!ENTITY splitfile-lnk '<link linkend="splitter">Split file</link>'> +<!ENTITY combinefiles-lnk '<link linkend="splitter">Combine files</link>'> +<!ENTITY kdeqtdir-lnk '<link linkend="kde_qt_dir"><envar>KDEDIR</envar> - <envar>QTDIR</envar></link>'> +<!ENTITY useractions-lnk '<link linkend="useractions">UserActions</link>'> +<!ENTITY usermenu-lnk '<link linkend="useractions">User Menu</link>'> +<!ENTITY faq-lnk '<link linkend="faq">FAQ</link>'> +<!ENTITY forum-lnk '<link linkend="faqg_kru-forum">&krusader; Forum</link>'> +<!ENTITY help-request-lnk '<link linkend="faqi_help_request">help request</link>'> +<!ENTITY list-panel-lnk '<link linkend="list_panel">List Panel</link>'> +<!ENTITY popup-panel-lnk '<link linkend="popup_panel">PopUp Panel</link>'> +<!ENTITY quick-search-lnk '<link linkend="quicksearch">Quick search</link>'> +<!ENTITY locate-lnk '<link linkend="locate">Locate</link> &GUI; frontend'> +<!ENTITY foldertabs-lnk '<link linkend="folder-tabs">Folder tabs</link>'> +<!ENTITY mountman-lnk '<link linkend="mount-man">MountMan</link>'> +<!ENTITY cmdline-lnk '<link linkend="cmdline">Command Line</link>'> +<!ENTITY termemu-lnk '<link linkend="termemu">Terminal emulator</link>'> +<!ENTITY missing-libs-lnk '<link linkend="faqi_missing_libs">&FAQ; missing libs or headers</link>'> +<!ENTITY panel-profiles-lnk '<link linkend="panel_profiles">Panel profiles</link>'> +<!ENTITY sync-browsing-lnk '<link linkend="panel_toolbar">Sync-browsing</link>'> +<!ENTITY diskusage-lnk '<link linkend="diskusage">Disk Usage</link>'> +<!ENTITY bookmarks-lnk '<link linkend="bookman">Bookmarks</link>'> +<!ENTITY bookmark-manager-lnk '<link linkend="bookman">Bookmark-Manager</link>'> +<!ENTITY advanced-search-module-lnk '<link linkend="krusearcher">Advanced Search module</link>'> +<!ENTITY javascript-console-lnk '<link linkend="javascript_console">JavaScript console</link>'> +<!ENTITY archives-lnk '<link linkend="archives">archives</link>'> +<!ENTITY remote-connections-lnk '<link linkend="remote-connections">Remote Connections</link>'> +<!ENTITY krusaderrc-lnk '<link linkend="config_files">krusaderrc</link>'> + +<!ENTITY install-proc-lnk '<link linkend="installation">Installation procedure</link>'> +<!ENTITY disablenote '<note><para>This feature is temporarily disabled and will be rewritten, sorry.</para></note>'> +<!ENTITY faqbugreports-lnk '<link linkend="faqg_bug_report">bug reports</link>'> +<!ENTITY hesbugreport-lnk 'Don't hesitate to send <link linkend="faqg_bug_report">Bug reports</link>.'> +<!ENTITY betafeaturenote '<note><para>This is a new feature that can be considered as "beta". &hesbugreport-lnk; + <link linkend="faqg_wish">User feedback</link> is always welcome!</para></note>'> +<!ENTITY newfeaturenote '<note><para>This is a new feature under development. Some descriptions may become obsolete if functionality changes during development. &hesbugreport-lnk; + <link linkend="faqg_wish">User feedback</link> is always welcome!</para></note>'> +<!ENTITY rwfeaturenote '<note><para>This module was rewritten. Some descriptions may become obsolete if + functionality changes during development. &hesbugreport-lnk; + <link linkend="faqg_wish">User feedback</link> is always welcome!</para></note>'> +<!ENTITY krusaderui-rc-text '<para>If you install a CVS or beta version and if &krusader; was previously + installed on your computer, then you should delete the <filename>krusaderui.rc</filename> file + in your home directory to activate the new menu entries + <prompt>$</prompt> <userinput><command>rm</command> <option>~/.kde/share/apps/krusader/krusaderui.rc</option></userinput> + , click <link linkend="faqi_krusaderui_rc">here</link> for more info.</para>'> + +<!ENTITY gpl-lnk '<link linkend="credits">&GNU; General Public License (GPL)</link>'> + +<!ENTITY dev-cvs-note '<note><para> + If you are using a <link linkend="krusader_devel">development</link> or + <link linkend="krusader_cvs">CVS</link> version, it is possible that the latest + new features are not yet in the "The Krusader Handbook". + Please read the &changelog-url; file online or in the &krusader; + sources to find out more about the new features. + For a brief description, please read the &cvsnews-url; file online + or in the &krusader; sources. + <link linkend="faqg_wish">User feedback</link> and + <link linkend="faqg_bug_report">Bug reports</link> are always welcome! + </para></note>'> + + +<!-- markup ENTITIES --> +<!ENTITY folder-tabs '<guibutton>Folder Tabs</guibutton>'> +<!ENTITY right-click '<keycap>Right-click</keycap>'> + + +<!-- application ENTITIES --> +<!ENTITY mc '<application>Midnight Commander</application>'> +<!ENTITY xxdiff '<application>xxdiff</application>'> +<!ENTITY krename '<application>Krename</application>'> +<!ENTITY kget '<application>kget</application>'> +<!ENTITY filelight '<application>Filelight</application>'> +<!ENTITY kdevelop '<application>Kdevelop</application>'> +<!ENTITY keditbookmarks '<application>KeditBookmarks</application>'> +<!ENTITY kwallet "<application>Kwallet</application>"> + +<!-- (TM) Trademark ENTITIES --> +<!ENTITY fedora '<trademark>Fedora</trademark>'> +<!ENTITY yoper '<trademark>Yoper</trademark>'> +<!ENTITY openlx '<trademark>OpenLX</trademark>'> +<!ENTITY appleipod '<trademark>Apple ipod</trademark>'> + +<!-- (R) Registered ENTITIES --> +<!ENTITY freebsd '<trademark class="registered">FreeBSD</trademark>'> +<!ENTITY debian '<trademark class="registered">Debian</trademark>'> +<!ENTITY mandriva '<trademark class="registered">Mandriva</trademark>'> +<!ENTITY gentoo '<trademark class="registered">Gentoo</trademark>'> +<!ENTITY mepis '<trademark class="registered">Mepis</trademark>'> +<!ENTITY ubuntu '<trademark class="registered">Ubuntu</trademark>'> +<!ENTITY kubuntu '<trademark class="registered">Kubuntu</trademark>'> +<!ENTITY linspire '<trademark class="registered">Linspire</trademark>'> +<!ENTITY xandros '<trademark class="registered">Xandros</trademark>'> +<!ENTITY slackware '<trademark class="registered">Slackware</trademark>'> +<!ENTITY arklinux '<trademark class="registered">Ark Linux</trademark>'> +<!ENTITY archlinux '<trademark class="registered">Arch Linux</trademark>'> +<!ENTITY netbsd '<trademark class="registered">NetBSD</trademark>'> +<!ENTITY openbsd '<trademark class="registered">OpenBSD</trademark>'> +<!ENTITY knoppix '<trademark class="registered">Knoppix</trademark>'> +<!ENTITY frugalware-linux '<trademark class="registered">Frugalware Linux</trademark>'> +<!ENTITY pclinuxos '<trademark class="registered">PCLinuxOS</trademark>'> +<!ENTITY altlinux '<trademark class="registered">altlinux</trademark>'> +<!ENTITY sourcemage '<trademark class="registered">Source Mage</trademark>'> +<!ENTITY kanotix '<trademark class="registered">Kanotix</trademark>'> +<!ENTITY lunarlinux '<trademark class="registered">Lunar Linux</trademark>'> +<!ENTITY ccuxlinux '<trademark class="registered">CCux Linux</trademark>'> +<!ENTITY qilinux '<trademark class="registered">QiLinux</trademark>'> +<!ENTITY rocklinux '<trademark class="registered">ROCK Linux</trademark>'> + +<!ENTITY nvidia '<trademark class="registered">NVIDIA</trademark>'> +<!ENTITY nc '<trademark class="registered">Norton Commander</trademark>'> +<!ENTITY openoffice '<trademark class="registered">OpenOffice</trademark>'> +<!ENTITY firefox '<trademark class="registered">Firefox</trademark>'> +<!ENTITY safari '<trademark class="registered">Safari</trademark>'> +<!ENTITY apple '<trademark class="registered">Apple</trademark>'> + +<!-- (C) Copyright ENTITIES --> +<!ENTITY freebsd '<trademark class="copyright">FreeBSD</trademark>'> +<!ENTITY tcmd '<trademark class="copyright">Total Commander</trademark>'> +<!ENTITY tcmd-url '<ulink url="http://www.ghisler.com/">&tcmd;</ulink>'> + +<!-- useraction ENTITIES --> +<!ENTITY useraction-parameter 'Parameter:'> +<!ENTITY useraction-optional-parameter 'Parameter (optional):'> +<!ENTITY useraction-default 'Default:'> + +<!-- chapters in separate docbook files --> + <!ENTITY help SYSTEM "help.docbook"> + <!ENTITY editors-note SYSTEM "editors-note.docbook"> + <!ENTITY introduction SYSTEM "introduction.docbook"> + <!ENTITY features SYSTEM "features.docbook"> + <!ENTITY user-interface SYSTEM "user-interface.docbook"> + <!ENTITY using-krusader SYSTEM "using-krusader.docbook"> + <!ENTITY more SYSTEM "more.docbook"> + <!ENTITY commands SYSTEM "commands.docbook"> + <!ENTITY keyboard SYSTEM "keyboard.docbook"> + <!ENTITY mouse SYSTEM "mouse.docbook"> + <!ENTITY konfigurator SYSTEM "konfigurator.docbook"> + <!ENTITY krusader-tools SYSTEM "krusader-tools.docbook"> + <!ENTITY faq SYSTEM "faq.docbook"> + <!ENTITY credits SYSTEM "credits.docbook"> + <!ENTITY glossary SYSTEM "glossary.docbook"> + +<!-- some using-krusader content in separate docbook files --> + <!ENTITY splitter SYSTEM "splitter.docbook"> + <!ENTITY profiles SYSTEM "profiles.docbook"> + <!ENTITY vfs SYSTEM "vfs.docbook"> + <!ENTITY compare SYSTEM "compare.docbook"> + <!ENTITY occupied-space SYSTEM "occupied-space.docbook"> + <!ENTITY checksum SYSTEM "checksum.docbook"> + <!ENTITY archives SYSTEM "archives.docbook"> + +<!-- some krusader-tools content in separate docbook files --> + <!ENTITY bookmarks SYSTEM "bookmarks.docbook"> + <!ENTITY diskusage SYSTEM "diskusage.docbook"> + <!ENTITY java SYSTEM "java.docbook"> + <!ENTITY search SYSTEM "search.docbook"> + <!ENTITY viewer-editor SYSTEM "viewer-editor.docbook"> + <!ENTITY locate SYSTEM "locate.docbook"> + <!ENTITY mount SYSTEM "mount.docbook"> + <!ENTITY remote-connections SYSTEM "remote-connections.docbook"> + <!ENTITY synchronizer SYSTEM "synchronizer.docbook"> + <!ENTITY krusader-useractions SYSTEM "useractions.docbook"> + +<!-- <!ENTITY remote-connections SYSTEM "remote-connections.docbook"> + <!ENTITY mount SYSTEM "mount.docbook"> + <!ENTITY bookmarks SYSTEM "bookmarks.docbook"> + <!ENTITY search SYSTEM "search.docbook"> + <!ENTITY locate SYSTEM "locate.docbook"> + <!ENTITY viewer-editor SYSTEM "viewer-editor.docbook"> + <!ENTITY synchronizer SYSTEM "synchronizer.docbook"> + <!ENTITY java SYSTEM "java.docbook"> + <!ENTITY diskusage SYSTEM "diskusage.docbook"> +--> + +<!-- appendices in separate docbook files --> + <!ENTITY installation SYSTEM "installation.docbook"> + <!ENTITY configuration-files SYSTEM "configuration-files.docbook"> + <!ENTITY useraction-xml SYSTEM "useraction-xml.docbook"> + <!ENTITY release-overview SYSTEM "release-overview.docbook"> + +]> +<book lang="&language;"> + <bookinfo id="index"> + <title>The Krusader Handbook</title> + <authorgroup> + <!-- +Changed the <author> tag in favor for <othercredit role="developer"> for Frank since +the <author><contrib> tag is not shown for the documentation author on the index page +This is a workaround, i have no idea why the <author> tag doesn't show the <contrib> tag (= the title) +on the index page. +Frank. +--> + +<!-- NOTE: DBLATEX doesn't accept "&" to display "&" in the <contrib> tag, so i changed it to "and" --> + + <othercredit role="developer"> + <firstname>Frank</firstname> + <surname>Schoolmeesters</surname> + <contrib>Documentation and Marketing + coordinator</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + <othercredit role="reviewer"> + <firstname>Richard</firstname> + <surname>Holt</surname> + <contrib>Documentation and Proofing</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + <othercredit role="reviewer"> + <firstname>Matej</firstname> + <surname> + Urbančič</surname> + <contrib>Marketing and Product + Research</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Shie</firstname> + <surname>Erlich</surname> + <contrib>Author and initial Handbook author</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Rafi</firstname> + <surname>Yanai</surname> + <contrib>Author and initial Handbook author</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Dirk</firstname> + <surname>Eschler</surname> + <contrib>Webmaster and i18n + coordinator</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Csaba</firstname> + <surname>Karai</surname> + <contrib>Developer</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Heiner</firstname> + <surname>Eichmann</surname> + <contrib>Developer</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + <othercredit role="developer"> + <firstname>Jonas</firstname> + <surname>Bähr</surname> + <contrib>Developer</contrib> + <affiliation> + <address> + <email>[email protected]</email> + </address> + </affiliation> + </othercredit> + </authorgroup> + <copyright> + <year>2000</year> + <year>2001</year> + <year>2002</year> + <year>2003</year> + <holder>Rafi Yanai</holder> + <holder>Shie Erlich</holder> + </copyright> + <copyright> + <year>2004</year> + <year>2005</year> + <year>2006</year> + <year>2007</year> + <year>2008</year> + <holder>Krusader Krew</holder> + </copyright> + <legalnotice> + <para>Permission is granted to copy, distribute and/or modify + this document under the terms of the + <ulink url="http://www.gnu.org/copyleft/fdl.html">GNU Free + Documentation License</ulink>, Version 1.1 or any later + version published by the Free Software Foundation; with no + Invariant Sections, with no Front-Cover Texts, and with no + Back-Cover Texts. A copy of the license is included in the + &krusader; sources.</para> + </legalnotice> + <date>2008-03-06</date> + <releaseinfo>1.90.0 "Power Stone"</releaseinfo> + <abstract> + <para>&krusader; is an advanced, twin-panel + (commander-style) file-manager for KDE, and other desktops in + the *nix world</para> + </abstract> + <keywordset> + <keyword>KDE</keyword> + <keyword>krusader</keyword> + <keyword>commander</keyword> + <keyword>filemanager</keyword> + <keyword>twinpanel</keyword> + <keyword>linux</keyword> + <keyword>file</keyword> + <keyword>manager</keyword> + <keyword>dual pane</keyword> + <keyword>linux-commander</keyword> + <keyword>kde-commander</keyword> + </keywordset> + </bookinfo> +<!-- preface --> + &help; + &editors-note; + +<!-- chapters --> + &introduction; + &features; + &installation; + &user-interface; + <!-- &basic-functions; TODO "using-krusader" has become "basic-functions" --> &using-krusader; + <!-- &advanced-functions; TODO "more" has become "advanced-functions" --> &more; + <!-- &menu-commands; TODO "commands" has become "menu-commands" --> &commands; + <!-- &keyboard-commands; TODO "keyboard" has become "keyboard-commands" --> &keyboard; + <!-- &mouse-commands; TODO "mouse" has become "mouse-commands" --> &mouse; + &krusader-tools; + + + &konfigurator; + &faq; + <!-- &credits-and-license; TODO "credits" has become "credits-and-license" --> &credits; + +<!-- appendices --> + &configuration-files; + &useraction-xml; + &release-overview; + +<!-- glossary --> + &glossary; + +<!-- index (automagically generated) --> + &documentation.index; +</book> diff --git a/doc/en/installation.docbook b/doc/en/installation.docbook new file mode 100644 index 0000000..4bd186b --- /dev/null +++ b/doc/en/installation.docbook @@ -0,0 +1,1250 @@ +<chapter id="installation"> + <!-- ********************************************************************** + installation.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Installation on KDE3.x</title> + <indexterm> + <primary>Installation</primary> + </indexterm> + <sect1 id="requirements"> + <title>Requirements</title> + <para>In order to successfully use the most recent + &krusader;, you need &kde;libs + >= 3.4</para> + <para>Required &kde; version: + <itemizedlist> + <listitem> + <para>&krusader; v1.01: &kde; + 2</para> + </listitem> + <listitem> + <para>&krusader; v1.02 - 1.40: &kde; + 3.0 - &kde; 3.2</para> + </listitem> + <listitem> + <para>&krusader; 1.40: prefers &kde; + 3.2 (otherwise all features will not be available)</para> + </listitem> + <listitem> + <para>&krusader; v1.50 - v1.51: &kde; + 3.2 - &kde; 3.3 (Konfigurator crash on + &kde; 3.4)</para> + </listitem> + <listitem> + <para>&krusader; v1.60.0 - v1.70.0: + &kde; 3.3 - &kde; 3.5</para> + </listitem> + <listitem> + <para>&krusader; 1.70.x: prefers + &kde; >= 3.4 (otherwise all + features will not be available)</para> + </listitem> + <listitem> + <para>&krusader; 1.80.0: &kde; 3.4 - + &kde; 3.5</para> + </listitem> + <listitem> + <para>&krusader; v2.xx.x: &kde; 4 - + &Qt; 4 The big challenge, a first release in + 2008</para> + </listitem> + </itemizedlist> + NOTE: there are no installation instructions for &kde;4 yet available since at moment of writing &krusader; + was not ported yet to &kde;4.</para> + <para>Platforms: + <itemizedlist> + <listitem> + <para>All POSIX + (&Linux;/BSD/&UNIX;-like OSes), + &Solaris;</para> + </listitem> + <listitem> + <para>All BSD Platforms + (&freebsd;/&netbsd;/&openbsd;/&MacOS;)</para> + </listitem> + </itemizedlist></para> + <para>&krusader; uses about 3-4 Mbyte of memory to + run and about 15 Mbyte of shared memory, which is also used by + other processes, but this may vary depending on your platform + and configuration. In order to handle archives the archivers + must be configured + <link linkend="konfig-dependencies">here</link>.</para> + <para>A package of popular (un)packers, &krusader; + itself and add-ons can be found on the + &krudownload-url;.</para> + <para>For more requirements, see below. Have a look at the + &faq-lnk; section as well.</para> + </sect1> + <sect1 id="getting-krusader"> + <title>Obtaining &krusader;</title> + <para>The latest information about &krusader; can be + found on the &kruwebsite-url; .</para> + <sect2 id="krusader-download"> + <title>&krusader; Downloads</title> + <para>it is recommended to use the &krusader; package + that is provided by your distribution. + &distrowatch-com-url; is a great resource to check + the availability. If your distribution does not offer + &krusader;, please contact the creators of your + distribution and ask them to provide a &krusader; + package</para> + <para>The latest version, as well as the older versions, can + be found on the &krudownload-url; and on the + &sfmirrors-url;. It contains the source tarballs, + RPM and DEB packages to whatever distro the + &krusader;-Krew is using and packages build by + &krusader; users and third parties.</para> + <para>Distributions who provide &krusader;: + <itemizedlist> + <listitem> + <para>&suse-download-url; >= + 9.3, Note: please use &krusader;-1.60.0 + instead of &krusader;-1.51 (might be unstable + on &SuSE;9.3-&kde;3.4).</para> + </listitem> + <listitem> + <para>&fedora; via + &fedora-extras-url; + <command># yum install krusader</command> will do the job, + thanks to Marcin Garski. &RedHat; RPM packages + can usually found on the &krudownload-url; or + at &dag-wiers-download-url; and + &dries-verachtert-download-url; .</para> + </listitem> + <listitem> + <para>&debian-download-url;, on our + &krudownload-url; you might find more recent + DEB packages. Note: usually &debian; packages + work also on distributions that are "based on + &debian;", and some of these provide their own + (incompatible) packages. + &ubuntu-kubuntu-download-url;, + &linspire-download-url;, &knoppix; + 4.x DVD, &kanotix;, etc.</para> + </listitem> + <listitem> + <para>&mandriva-download-url; via the contrib + repository + <command># urpmi krusader</command> will do the job, + &gentoo-download-url;, + &yoper-download-url;.</para> + </listitem> + <listitem> + <para>&archlinux-download-url;, + &frugalware-linux-download-url;, + &pclinuxos-download-url;, + &altlinux-download-url;.</para> + </listitem> + <listitem> + <para>&freebsd-download-url;, the port is + maintained by + <link linkend="credits">Heiner Eichmann</link>.</para> + </listitem> + <listitem> + <para>&netbsd-download-url;, + &lunarlinux-download-url; + ,&arklinux;, &openlx;, + &sourcemage;.</para> + </listitem> + <listitem> + <para>Even more distributions can be found with + &distrowatch-com-url;.</para> + </listitem> + </itemizedlist>Use the installation tools included in your + distro to install the &krusader; package. You + might need an internet connection if &krusader; is + not included on the &CD; or DVD. There are + probably other distributions which include + &krusader;. If you know of one, please send + feedback so that we can include it on the distrolist.</para> + <para>Others + <itemizedlist> + <listitem> + <para>&slackware; tgz binaries can usually be + found on the &krudownload-url;. You can also + use &portpkg-url; that contains a + &kru-slackbuild-url;, + <command># portpkg krusader</command> will do the + job.</para> + </listitem> + <listitem> + <para>There is a &macosx-port-url; + with the help of &fink-url; , the port is + maintained by <ulink url="http://hritcu.wordpress.com/about/">Catalin Hritcu</ulink>.</para> + </listitem> + </itemizedlist></para> + <para>Installation via the &klik-protocol-url; + <itemizedlist> + <listitem> + <para>&klik-krusader-url; downloads + &krusader; provided by &debian; + stable, more information is + &klik-available-url; .</para> + </listitem> + <listitem> + <para>&klik-krusader-latest-url; downloads the + latest &klik-stable-krusader-url; provided by + the &krusader; Krew.</para> + </listitem> + <listitem> + <para>&klik-krusader-cvs-url; downloads a + &klik-cvs-krusader-url; provided by the + &krusader; Krew.</para> + </listitem> + </itemizedlist></para> + <para>Search engines + <itemizedlist> + <listitem> + <para>You can also find packages on &Linux; + software archives such as &freshmeat-url; or + &kde-apps-url; .</para> + </listitem> + <listitem> + <para>If you can notfind a package for your distribution, + we recommend searching for it with + &rpmfind-url;, &rpmpbone-url; or + &rpmseek-url;.</para> + </listitem> + </itemizedlist>If you enjoy using &krusader;, we + would appreciate it if you went to one of these sites and + rated it.</para> + <para>If you still can not find a package, follow the + installation procedure on how to compile + &krusader; from source. This very thorough HowTo + describes the process in such detail that even newcomers + should not have any problems.</para> + </sect2> + <sect2 id="version_scheme"> + <title>Version Scheme</title> + <para>A new version scheme has been used since + &krusader;-1.60.0 + <itemizedlist> + <listitem> + <para>First digit - the major version</para> + </listitem> + <listitem> + <para>Second digit(s) - percentage of features completed + for this major version</para> + </listitem> + <listitem> + <para>Third digit(s) - bugfixes.</para> + </listitem> + </itemizedlist>In essence, releasing + &krusader;-1.60.0 means that we believe that + &krusader; is about 60% done with all the features + we had scheduled for the 1.x.x series. Series 2.x.x will be + &kde; 4.x releases. Hopefully, it is easy to + understand.</para> + </sect2> + <sect2 id="krusader_stable"> + <title>Stable Version</title> + <para> + <filename>krusader-x.xx.tar.gz</filename> + </para> + <note> + <para>&krusader; is released under the + &gpl-lnk;. This means that THE PROGRAM IS + PROVIDED "AS IS" WITH NO WARRANTY OF ANY KIND, even when it + is marked as a stable release.</para> + </note> + </sect2> + <sect2 id="krusader_devel"> + <title>Development Version (beta release)</title> + <para> + <filename>krusader-x.xx-betax.tar.gz</filename> + </para> + <para>Before every stable release we release at least one + development version in order to hunt down the bugs.</para> + <warning> + <para>These releases are beta releases and will probably + contain some bugs.</para> + </warning>&dev-cvs-note; + <para>The beta release has 3 goals: + <itemizedlist> + <listitem> + <para>Apply a feature-freeze until the stable is released, + only bugs will be fixed. New features have to wait until + the stable is released.</para> + </listitem> + <listitem> + <para>Obtain feedback from &krusader; users so + that we can fix the bugs.</para> + </listitem> + <listitem> + <para>Give translators time to update the translations for + the coming stable. Please read the + &i18n-page-url;.</para> + </listitem> + </itemizedlist></para></sect2> + <sect2 id="krusader_cvs"> + <title>CVS Builds</title> + <para> + <filename>krusader-cvs-yyyymmdd.tar.gz</filename> + </para> + <warning> + <para>These builds are untested and come without any + warranty. They may contain bugfixes, new features, or even + new bugs.</para> + </warning> + <para>We provide daily snapshots of &krusader;'s + CVS version. For those who are interested, the + <emphasis role="bold">nightly tarball</emphasis> can be found + on the &krucutedge-url;. Depending on the stage of + development, this version will either be stable or unstable. + Just before a stable release, the CVS version is almost + stable. After a stable release new features will be committed + into CVS, which might lead to the appearance of bugs. In some + rare cases, the build will not even compile if we make a + mistake. In that case we try to fix the error as soon as + possible.</para> + <para>&krusader; provides 2 nightly snapshots: + <orderedlist numeration="arabic"> + <listitem> + <para> + <filename>krusader-cvs-yyyymmdd.tar.gz</filename>: + <command>make -f Makefile.cvs</command> must be run before + the + <command>./configure</command> script is available.</para> + </listitem> + <listitem> + <para> + <filename>krusader-cvs2-yyyymmdd.tar.gz</filename>: for + users who have problems with the + <command>make -f Makefile.cvs</command> command, we have + already done this for you and the + <command>./configure</command> script is included in the + tarball. This tarball is a bit bigger than the first + one.</para> + </listitem> + </orderedlist></para> + <para> + <emphasis role="bold">check out from CVS</emphasis>. + &krusader; can be checked out through anonymous + (pserver) CVS with the following instruction set. The module + you wish to check out must be specified as the module name. + When prompted for a password for anonymous, press the + &Enter; key.</para> + <para>Currently, there are two module options: + <itemizedlist> + <listitem> + <para>krusader_kde2: the &kde;2 branch, stable + but it is basically v1.01 and there are no planned + changes</para> + </listitem> + <listitem> + <para>krusader_kde3: the &kde;3 branch that we + currently use</para> + </listitem> + </itemizedlist></para> + <para>To check out &krusader; from CVS: + <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-d:pserver:[email protected]:/cvsroot/krusader login</option></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[email protected]:/cvsroot/krusader co krusader_kde3</option></userinput></screen> + (note: updates from within the modules directory do + not need the -d parameter)</para> + <para>If you want to check out a specific version of + &krusader; from CVS (⪚ + &krusader;-1.60.0) : + <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[email protected]:/cvsroot/krusader co -rversion_1_60_0 krusader_kde3</option></userinput></screen> + </para> + <para>If you want to check out a specific date of + &krusader; from CVS (⪚ + &krusader;-2006-10-29) : + <screen><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[email protected]:/cvsroot/krusader co -D2006-10-29 krusader_kde3</option></userinput></screen> + </para> + <para>Mostly being &gentoo; users, we provide a + &gentoo-life-ebuild-url; for all those who want to + stay on the bleeding edge of file management and do not want + to miss the advantages of portage. Please take a look at our + &krucutedge-url; for more installation + details.</para> + <para>We also provide &viewcvs-url; to browse the + CVS repository.</para> + </sect2> + <sect2 id="krusader_svn"> + <title>Subversion</title> + <para>&subversion-url; is used for + the &krusader; 2.x series for &kde;4. + it is also possible to + &browse-svn-repo-url;.</para> + <para>To check out the latest &krusader; 1.x for + &kde; 3 from SVN: (NOTE: at moment of writing use CVS for krusader_kde3, since krusader_kde3 + is developed in CVS and NOT in SVN, currently you will get an old version in SVN) + <screen><prompt>$</prompt> <userinput><command>svn</command> <option>co https://krusader.svn.sourceforge.net/svnroot/krusader/trunk/krusader_kde3</option></userinput></screen> + To check out the latest &krusader; 2.x + for &kde; 4 from SVN: + <screen><prompt>$</prompt> <userinput><command>svn</command> <option>co https://krusader.svn.sourceforge.net/svnroot/krusader/trunk/krusader_kde4</option></userinput></screen> + </para> + </sect2> + <sect2 id="krusader_old"> + <title>Older Releases</title> + <para>If you are looking for older releases we recommend the + &sfmirrors-url;, available from our project + page.</para> + </sect2> + </sect1> + <sect1 id="compilation"> + <title>Compiling and Installing</title> + <sect2 id="sourcedownload"> + <title>Compiling &krusader;. What now?</title> + <para>Check the environment variables + &kdeqtdir-lnk;.</para> + <para>To compile and install &krusader; on your + system, type the following in the base directory of the + &krusader; package:</para> + <screen> + <prompt>$</prompt> <userinput><command>./configure</command></userinput> + <prompt>$</prompt> <userinput><command>make</command></userinput> + <prompt>$</prompt> <userinput><command>su -c 'make</command> <option>install'</option></userinput></screen> + &krusaderui-rc-text; + <para>Since &krusader; uses + <command>autoconf</command> and + <command>automake</command> you should have no trouble compiling + it. If you run into problems, read the detailed installation + instructions below.</para></sect2> + + +<sect2 id="install_quickstart"> +<title>Quickstart Installation Tutorial</title> + +<sect3 id="install_quickstart_debian"> +<title>Debian</title> +<para>These instructions should work as well on &debian; based distributions like: +&ubuntu;, &kubuntu;, &linspire;, &kanotix;, ...</para> + +<para>Add the next lines in the <filename>~/.bashrc</filename> configuration file +<screen> +<userinput><command>export</command> <option>QTDIR=/usr</option></userinput> +<userinput><command>export</command> <option>KDEDIR=/usr</option></userinput> +<userinput><command>export</command> <option>export KDEDIRS=/opt/krusader:/usr</option></userinput> +</screen> +</para> + +<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader; +<screen> +<prompt>#</prompt> <userinput><command>apt-get</command> <option>build-dep krusader</option></userinput> +</screen> +</para> + +<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and +enter the <filename>krusader_kde3</filename> directory.</para> + +<para> +The next command will create <command>./configure</command> +<screen> +<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput> +</screen> +NOTE: you might need to upgrade <filename>automake</filename> and/or <filename>autoconf</filename>, if an error message appears. +</para> + +<para>Install &krusader; in the <filename>/opt</filename> directory to not overwrite the official &debian; binary <filename>/usr/bin/krusader</filename>, +so that <command>krusader</command> will run the official &debian; package and <command>/opt/bin/krusader</command> runs the compiled version. +It's recommended to use enable the full debug, so that you can possible problems at us. Run configure. +<screen> +<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/opt/krusader --enable-debug=full</option></userinput> +</screen> +</para> + +<para>Compile &krusader; +<screen> +<prompt>$</prompt> <userinput><command>make</command></userinput> +</screen> +</para> + +<para>Install Krusader +<screen> +<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput> +</screen> +</para> + +<para><command>/opt/bin/krusader</command> runs the compiled &krusader; version.</para> +</sect3> + +<sect3 id="install_quickstart_suse"> +<title>SuSE</title> +<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader;</para> +<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and +enter the <filename>krusader_kde3</filename> directory. Now you can compile and install &krusader; +<screen> +<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput> +<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/opt/krusader --enable-debug=full</option></userinput> +<prompt>$</prompt> <userinput><command>make</command></userinput> +<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput> +</screen> +</para> +</sect3> + +<sect3 id="install_quickstart_others"> +<title>For other Linuxes</title> +<para>Ofcource it's impossible to cover all Linuxes, but here are the general installation instructions.</para> + +<para>Usually <command>./configure --prefix=/usr</command> should be used, though options like +<filename>/opt/krusader</filename> are usually better so that you don't overwrite files that +are installed by your package managment system. +Please don't use the <filename>/usr/local</filename> directory as it simply won't work.</para> +<para>Install the <link linkend="faqi_missing_libs">build dependencies</link> for &krusader;</para> +<para><link linkend="version_scheme">Download</link> the &krusader; sourcecode, unpack and enter the <filename>krusader_kde3</filename> directory. Now you can compile and install &krusader; +<screen> +<prompt>$</prompt> <userinput><command>make -f</command> <option>Makefile.cvs</option></userinput> +<prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/usr</option></userinput> +<prompt>$</prompt> <userinput><command>make</command></userinput> +<prompt>$</prompt> <userinput><command>su -c</command> <option>"make install"</option></userinput> +</screen> +</para> +</sect3> + +</sect2> + + <sect2 id="install_tutorial"> + <title>Detailed Installation Tutorial</title> + <para>The next section will explain how to install + &krusader; step by step. Questions about the + installation process have been asked many times and + especially users new to &Linux; often have + problems compiling software from source. Therefore, we are + trying to keep the explanations as detailed as possible even + if they are mostly not &krusader; specific. + Experienced users may easily skip most of the steps.</para> + <para>Unfortunately, because not all &Linux; + distributions follow the &fhs-url; it is impossible + to write a tutorial that would cover all circumstances. + However, these guidelines will help you in the right + direction.</para> + <note> + <para>If you encountered problems, please read first this + installation procedure and the &faq-lnk;. If the + problem persists, use the &help-request-lnk; to + ask for help.</para> + </note> + <orderedlist> + <listitem> + <para>Install all packages and libraries that are needed + for the compilation, please read the + &faq-lnk;. + <tip> + <para>If you install &kdevelop;, (almost) + everything that you need to compile + &krusader; will be installed on your + computer. However, if you are not a developer, please + follow the instructions and do not use + &kdevelop; to compile + &krusader;.</para> + </tip></para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Open your favourite terminal emulator + (⪚ &konsole;).</para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>We recommend you create a separate directory to + keep all the sources you compile in. This way you will + have a better overview of the installed programs and it + will be easier to uninstall them later. + <screen><prompt>$</prompt> <userinput><command>mkdir</command> ~/source</userinput></screen> + The chosen directory is just an example, any + other will work.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem> + <para>Copy the sources to the + <filename>~/source</filename> directory and unpack them. + <screen><prompt>$</prompt> <userinput><command>cp</command> /<replaceable>"your_dir"</replaceable> /krusader-x.xx.tar.gz ~/source</userinput></screen> + <screen><prompt>$</prompt> <userinput><command>cd</command> ~/source</userinput></screen> + <screen><prompt>$</prompt> <userinput><command>tar</command> <option>-xzvf</option> krusader-x.xx.tar.gz</userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Optional step: if you wish you can delete the + tarball at this point as it is no longer needed. + <screen><prompt>$</prompt> <userinput><command>rm</command> krusader-x.xx.tar.gz</userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Change to the directory containing the sources. + <screen><prompt>$</prompt> <userinput><command>cd</command> krusader-x.xx</userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem id="kde_qt_dir"> + <para>Check the environment variables + <envar>QTDIR</envar>and + <envar>KDEDIR</envar>. &krusader;'s + <command>./configure</command> script needs to know where + the &Qt; and &kde; directories + are.</para> + <para> + <envar>QTDIR</envar>: + <replaceable><path to your Qt + installation></replaceable> ⪚ + <filename>/usr/lib/qt3</filename> or + <filename>/usr/qt3</filename></para> + <para> + <envar>KDEDIR</envar>: + <replaceable><path to your KDE + installation></replaceable> ⪚ + <filename>/usr</filename> or + <filename>/opt/kde3</filename></para> + <para>Normally your distribution will set them for you, + but experience has shown that some do not. You can easily + check the values with the + <command>echo</command> command. + <screen><prompt>$</prompt> <userinput><command>echo</command> $QTDIR</userinput>/usr/lib/qt3 + <prompt>$</prompt> <userinput><command>echo</command> $KDEDIR</userinput>/usr</screen> + + If both commands give an output, the enviroment variables + are set (the above example are the settings of + &mandriva;-&Linux;). In case you + receive empty lines, the variables are not set and you + have to set them manually. If you do not know what to set + the variables to, or if you want to check if the + variables are correctly set, ask your distributor or use + the + <command>find</command> command. +<screen><prompt>$</prompt> <userinput><command>find</command> <option>/usr /opt -name</option> qtconfig <option>-type f 2>/dev/null</option></userinput> +/usr/lib/qt3/bin/qtconfig +<prompt>$</prompt> <userinput><command>find</command> <option>/usr /opt -name</option> kdeinit <option>-type f 2>/dev/null</option></userinput> +/usr/bin/kdeinit</screen> + In this case + <filename>/usr/lib/qt3</filename> is your + <envar>QTDIR</envar> and + <filename>/usr</filename> is your + <envar>KDEDIR</envar>. The installed binaries will go to + <filename>/usr/bin</filename>. Now we will set the + enviroment variables with the + <command>export</command> command. + <screen><prompt>$</prompt> <userinput><command>export</command> QTDIR=<replaceable><replace with your QTDIR></replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>export</command> KDEDIR=<replaceable><replace with your KDEDIR></replaceable></userinput></screen> + </para> + <note> + <para>These enviroment variables are only set for the + lifetime of your current shell. When you close your + terminal and open a new one they will be gone. Assuming + &krusader; is not the only + &Qt;/&kde; program you want to + compile, we recommend to make these settings permanent + (⪚ append both export commands to your + <filename class="directory">/etc/profile</filename>) + file.</para> + </note> + <para>If you can notdetermine your KDEDIR, + <command>kde-config --prefix</command> might help + you.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem> + <para>If you have downloaded a stable version + <filename>"krusader-x.xx.tar.gz"</filename> or a beta + version + <filename>"krusader-x.xx-betax.tar.gz"</filename>, you + can skip this step. In this case the + <filename>./configure</filename> script is + provided.</para> + <para>If you have downloaded a CVS build or nightly + tarball + <filename>"krusader-cvs-yyyy-mm-dd.tar.gz"</filename>", + you will have to run the following command to create the + <filename>./configure</filename> script: + <screen><prompt>$</prompt> <userinput><command>make</command> <option>-f</option>Makefile.cvs</userinput></screen> + </para> + <para>If everything is OK you will see the following + output on your screen: +<screen><prompt>$</prompt> <userinput><command>make</command> <option>-f</option> Makefile.cvs</userinput> +This Makefile is only for the CVS repository +This will be deleted before making the distribution +*** Creating acinclude.m4 +*** Creating list of subdirectories +*** Creating configure.in +*** Creating aclocal.m4 +*** Creating configure +*** Creating config.h template +*** Creating Makefile templates +*** Postprocessing Makefile templates +*** Creating date/time stamp +*** Finished +Don't forget to run ./configure +If you haven't done so in a while, run ./configure --help +<prompt>$</prompt></screen> + </para> + <note> + <para>You will need to have + <application>autoconf 2.52, 2.53 or + 2.54</application> and + <application>automake 1.6</application> (or higher) to + run the + <command>make -f Makefile.cvs</command> command</para> + </note> + <tip> + <para>If you encounter problems with this command click + <link linkend="krusader_cvs">here</link>. + &krusader; provides two nightly builds + (snapshots) one with a + <filename>./configure</filename> script and one + without.</para> + </tip> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem> + <para>Your &Linux; distro + &krusader; RPM or DEB package will normally + install &krusader; in the + <filename>KDEDIR/bin</filename> directory. According to + the &fhs-url;, any user installed files go to + the + <filename>/usr/local</filename> directory. If you wish + &krusader; to be installed in another + directory, it can be determed with the prefix option. If + you do not have root access, + <filename>/home/YOUR_USERNAME/.kde</filename> is probably + a good choice. +<screen> +foo + +Krusader Project: +----------------- +Source code location: . +C Compiler: gcc +C Compiler flags: -ansi -W -Wall -pedantic -Wchar-subscripts -Wshadow -Wpointer-arith +-Wmissing-prototypes -Wwrite-strings -D_XOPEN_SOURCE=500 -D_BSD_SOURCE -O2 +-Wformat-security -Wmissing-format-attribute +C++ Compiler: g++ +prefix: /usr/local +kde_libraries: /usr/include +kde_includes: /usr/lib +kde_locale: /usr/share/locale +qt_libraries: /usr/lib/qt3/lib +qt_includes: /usr/lib/qt3/include +KDEDIR: /usr +QTDIR: /usr/lib/qt3 +Install path: /usr/local/bin +krusader version: 1.80.0 +krusader binary: /usr/local/bin/krusader (after 'make install') +Thank you for using Krusader + +Good - your configure finished. Start make now +<prompt>bash$</prompt> +</screen> + </para> + <para>This is the output for + &Mandrake;-&Linux; 10, other + distributions may give a different output.</para> + <tip> + <para>At the end of the + <command>./configure</command> script you will find a + summary of the most important settings, ⪚ + where the &krusader; binary will be + installed (after the 'make install' command). This part + will also display a warning if the environment + variables &kdeqtdir-lnk; are empty.</para> + </tip> + <para></para> + <!-- Empty line to make it more readable --> + <para>Since &krusader;-1.70.0 + <command>./configure</command> has two specific + &krusader; options: + <itemizedlist> + <listitem> + <para> + <userinput> + <command>./configure</command> + <option>--without-konqueror</option> + </userinput>: build &krusader; without support + &konqueror;'s servicemenus, default=with. + This means that &konqueror;'s right-click + menu entries will not be available.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>./configure</command> + <option>--without-javascript</option> + </userinput>: build &krusader; without JavaScript + support, default=with. This means that the + &javascript-console-lnk; will not be + available.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>./configure</command> + <option>--without-acl</option> + </userinput>: build &krusader; without ACL support default=with. + Sometimes this option is needed if you get a ACL compile error when running <command>make</command>.</para> + </listitem> + </itemizedlist>In the past the support was always + compiled in when the headers where found, now you have + the choice.</para> + <para>Use + <userinput> + <command>./configure</command> + <option>--help</option> + </userinput>to see more options or read the + <filename>INSTALL</filename> file in the + &krusader; sources.</para> + <para>If you used another --prefix= than + <filename>$KDEDIR or /usr/local</filename>, it is + recommended to do an extra check: +<screen><prompt>$</prompt> <userinput><command>kde-config</command> <option>--path exe</option></userinput> +/home/frank/.kde/bin/:/usr/bin/:/usr/local/bin/ +<prompt>$</prompt></screen> + If the + <prefix_dir/bin> directory is + not shown, you need to use e.g. + <command>export KDEDIRS=/usr/local:/usr</command>. To + make these settings permanent you can ⪚ + append this export command to your + <filename>/etc/profile</filename> file. After that you + need to restart &kde;.</para> + <note> + <para>If + <command>./configure</command> fails, take a look at + &missing-libs-lnk;.</para> + </note> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Start the compilation process with the + <command>make</command> command. + <screen><prompt>$</prompt> <userinput><command>make</command></userinput></screen> + This will take about 3 - 40 minutes depending on how fast your computer runs. If + everything goes well, it will ⪚ end with + the following messages: +<screen> +foo +make[2]: Leaving directory `/home/source/krusader_kde3/tar' +make[2]: Entering directory `/home/source/krusader_kde3' +make[2]: Leaving directory `/home/source/krusader_kde3' +make[1]: Leaving directory `/home/source/krusader_kde3' +<prompt>bash$</prompt> +</screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + <para>If + <command>./configure</command> was successful and + <command>make</command> failed for some reason, continue + to read this page. If you can not find a solution to your + problem, feel free to post a help request at our + &forum-lnk;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>If everything is correct, you can now install + &krusader;. + <screen><prompt>$</prompt> <userinput><command>su -c 'make</command> <option>install'</option></userinput></screen> + You will be asked to enter your root + password.</para> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem>&krusaderui-rc-text; + <para></para> + <!-- Empty line to make it more readable --></listitem> + <listitem> + <para>Now you can + <link linkend="starting-krusader"> + start</link> &krusader;.</para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + <listitem> + <para>Optional step: Cleaning up to save disk space. + Note: All compiled files created with the + <command>make</command>command will be deleted. + <screen><prompt>$</prompt> <userinput><command>make</command> <option>clean</option></userinput></screen> + </para> + <para></para> + <!-- Empty line to make it more readable --> + <para></para> + <!-- Empty line to make it more readable (second line is needed) --> + </listitem> + <listitem> + <para>If you ever want to uninstall + &krusader;, use + <screen><prompt>$</prompt> <userinput><command>su -c 'make</command> <option>uninstall'</option></userinput></screen> + You will be asked to enter your root + password.</para> + <para></para> + <!-- Empty line to make it more readable --> + </listitem> + </orderedlist> + <para>If you followed the installation procedure and still + encountered problems installing &krusader;, refer + to &faq-lnk;. If the problem persists, use the + &help-request-lnk; to ask for help.</para> + </sect2> + </sect1> + <sect1 id="mac-port"> + <title>Installing on &MacOS;-X</title> + <indexterm> + <primary>&MacOS;-X port</primary> + </indexterm> + +<note><para>Since June 2006 &krusader; is added into the + <ulink url="http://pdb.finkproject.org/pdb/package.php/krusader">&krusader; finkproject.org repository</ulink> + Please check this url for the latest information about the &MacOS;-X port, + please read the &fink-url; documentation for more information, + all information below could be outdated, though they should still work :) + From now on the port is maintained by + <ulink url="http://hritcu.wordpress.com/about/">Catalin Hritcu</ulink>. +</para></note> + <para>Krusader is ported to &MacOS; thanks the &fink-url;-project and Jonas + Bähr and &bodo-tasche-url; . + Unfortunately the only *stable* kdelib-binaries which + &fink-url; has to offer is currenly 3.1.4 which + means you need to use &krusader;-1.40 . + Unfortunately the &MacOS; X &krusader; + port does not have the same power as in a native + &Linux;-&kde; environment. To run + &krusader; you need also X11, which doesn't interact + with the rest of the &MacOS; desktop. We hope that + &Qt;4/&kde;4 will solve most of these + problems. If you want a more recent Krusader version you need + to compile &kde;. With &fink-url; it is + rather easy but it takes some CPU cycles.</para> + <para>Installation Instructions for &krusader;-1.40 + <orderedlist> + <listitem> + <para>Download and install &fink-url; with the + &kde;3.1 binaries provided by fink and read the + documentation.</para> + </listitem> + <listitem> + <para>Extract the + <filename> + krusader-1.40.fink.darwin-ppc.tar.bz2</filename> package to + <filename>/sw/fink/dist/local/main/</filename> Only root can + write here. You may have to create 'local' and + 'main'.</para> + </listitem> + <listitem> + <para>Run as root: + <command>fink install krusader</command></para> + </listitem> + </orderedlist></para> + <para>Follow these instructions if you wish to compile more + source code or use a more recent version of + &krusader;: + <orderedlist> + <listitem> + <para>Install &apple-x11-url;</para> + </listitem> + <listitem> + <para>Install the &apple-x11-sdk-url; + developer-tools with X11 headers (gcc is included)</para> + </listitem> + <listitem> + <para>Install the fink-base</para> + </listitem> + <listitem> + <para>Compile kdelibs 3.4.1 or higher (fink provides the + necessary + <filename>.info</filename> files)</para> + </listitem> + <listitem> + <para>Compile the &krusader;-tarball or follow + steps 2 and 3 of the previous section if a recent + &krusader;-package ⪚ + <filename> + krusader-1.70.0.fink.darwin-ppc.tar.bz2</filename> is + available</para> + </listitem> + </orderedlist></para> + +<para>Follow these instructions if you wish to compile &krusader;-1.80.0 : + <orderedlist> + <listitem> + <para>Install &apple-x11-url;</para> + </listitem> + <listitem> + <para>nstall fink and + <ulink url="http://fink.sourceforge.net/faq/usage-fink.php#unstable">enable fink unstable</ulink>.</para> + </listitem> + <listitem> + <para>Compile and install the &kde; bundle in fink: fink install bundle-kde-ssl + (if you get “no package found” the previous step did not succeed).</para> + </listitem> + <listitem> + <para>Use <filename>krusader.info</filename> (provided in the &krusader;-sourcecode) and then copy to + <filename>/sw/fink/dists/local/main/finkinfo</filename> .</para> + </listitem> + <listitem> + <para>Compile and install &krusader; in fink: <command>fink install krusader</command> + </para> + </listitem> + <listitem> + <para>Start X11 (startx) and in xterm run &krusader; + </para> + </listitem> + </orderedlist> + Thanks to <ulink url="http://hritcu.wordpress.com/2006/08/10/krusader-on-intel-mac/">Catalin Hritcu </ulink> for these install instructions. +</para> + + + </sect1> + <sect1 id="starting-krusader"> + <title>Starting &krusader;</title> + <para>Type + <userinput> + <command>krusader</command> + </userinput> (lower case) at a command prompt. You can create + shortcut on your desktop or create an entry in the + (&kde;) menu. Read the previous page and the + &faq-lnk; if &krusader; doesn't + start.</para> + <para>When &krusader; is started from the + command line, various options can be specified to modify its + behavior.</para> + <screen> + <prompt>$</prompt> <userinput><command>krusader</command></userinput> + WARNING: Mt.Man: Born, looking around to get familiar. foo</screen> + <note> + <para>Do not worry about the messages you get in the + &konsole;. These messages are log messages that + can be used for debugging &krusader;.</para> + </note> + <para>You can also use + <keycombo action="simul">&Alt; + <keycap>F2</keycap></keycombo> to open the Run Command dialog + box, type + <userinput> + <command>krusader</command> + </userinput> (lower case) and press &Enter; or click + on the + <guibutton>Run</guibutton> button.</para> + <para>If &krusader; is installed by an RPM or DEB + package then usually &krusader; can be started from + the &kmenu;. ⪚ on + &Mandrake;-&Linux; 10.0 click on the + &kicon; button and choose + <emphasis role="bold"> + <menuchoice> + <guimenuitem>Applications</guimenuitem> + <guimenuitem>File tools</guimenuitem> + <guimenuitem>&krusader;</guimenuitem> + </menuchoice> + </emphasis>.</para> + <variablelist> + <title>Command-line options:</title> + <varlistentry> + <term> + <option>--left</option> + <replaceable> + <path></replaceable> + </term> + <listitem> + <para> + <action>start left panel at + <path></action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--right</option> + <replaceable> + <path></replaceable> + </term> + <listitem> + <para> + <action>start right panel at + <path></action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--left</option> + <replaceable> + <path1>,<path2>,<path3></replaceable> + </term> + <listitem> + <para> + <action>start left panel at + <path1>,<path2>,<path3>, + with tabs.</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--profile</option> + <replaceable> + <panel-profile></replaceable> + </term> + <listitem> + <para> + <action>load a + <link linkend="panel_profiles">panel-profile</link> on + startup (this overrides the + <link linkend="konfig-startup">default startup + profile</link>).</action> + </para> + </listitem> + </varlistentry> + </variablelist> + <para>Examples: + <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=<path> --right=<path></replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=/mnt/cdrom --right=ftp://[email protected]</replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=<path1>,<path2> --right=<path1>,<path2>,<path3></replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>krusader</command><replaceable>--profile <panel-profile></replaceable></userinput></screen> + <screen><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--profile ftp-managment</replaceable></userinput></screen> + </para> + <para>The standard &Qt; and &kde; + command-line options are available, and can be listed by + entering + <userinput> + <command>krusader</command> + <option>--help</option> + </userinput>.</para> + <variablelist> + <title>Other command-line options:</title> + <varlistentry> + <term> + <option>--help-qt</option> + </term> + <listitem> + <para> + <action>List Qt-specific options</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--help-kde</option> + </term> + <listitem> + <para> + <action>List KDE-specific options</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--help-all</option> + </term> + <listitem> + <para> + <action>List all options</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--author</option> + </term> + <listitem> + <para> + <action>Show the authors names</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>-v,--version</option> + </term> + <listitem> + <para> + <action>Show the version number</action> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <option>--license</option> + </term> + <listitem> + <para> + <action>Show license information</action> + </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="configuration"> + <title>Configuring &krusader;</title> + <para>When you run &krusader; for the first time, + the &krusader; configuration module + <link linkend="konfigurator">Konfigurator</link> will show up + and allow you to configure &krusader; as well as + detect installed packers and tools. You can always run + Konfigurator again from the + &settingsmenu-lnk;.</para> + </sect1> + <sect1 id="default-file-manager"> + <title>Making &krusader; the default file + manager</title> + <para>To make &krusader; the default file manager in + Gnome, <ulink url="http://psychocats.net/ubuntu/nonautilusplease">click here</ulink> for more information. + </para> + <para>To make &krusader; the default file manager in + &kde;, <ulink url="http://groups.google.com/group/krusader-devel/browse_thread/thread/8209d785d3ba0ac6">click here</ulink> for more information. + </para> + </sect1> +</chapter> + +<chapter id="krusader_kde4_install"> +<title>Installation on KDE4.x</title> +<sect1 id="kde4_install"> + <title>Krusader installation instructions on KDE4.0</title> + <note> + <para>From version &krusader;-2.0.0 and higher is &kde;-4 only.</para> + </note> + <note> + <para>At moment of writing &krusader;-2.0.0 is still under development, though it works :)</para> + </note> + +<para>"krusader_kde4.tar.gz" is the supposed name of the krusader tarball (it will be probably a different one ;)</para> + +<para>You can download the latest available krusader-2.x <link linkend="krusader_svn">from SVN</link>.</para> + +<para><command>DCMAKE_INSTALL_PREFIX</command> is the location of the KDE DQT_INCLUDES</para> +<para> + <screen> + <prompt>$</prompt> <userinput><command>tar -xzvf</command> <option>krusader_kde4.tar.gz</option></userinput> + <prompt>$</prompt> <userinput><command>cd </command> <option>krusader_kde4</option></userinput> + <prompt>$</prompt> <userinput><command>cmake </command> <option>-DCMAKE_INSTALL_PREFIX=/usr/ -DQT_INCLUDES=/usr/share/qt4/include</option></userinput> + <prompt>$</prompt> <userinput><command>make</command></userinput> + <prompt>$</prompt> <userinput><command>su -c </command> <option>"make install"</option></userinput> + </screen> +</para> + + </sect1> +</chapter>
\ No newline at end of file diff --git a/doc/en/introduction.docbook b/doc/en/introduction.docbook new file mode 100644 index 0000000..9ff6078 --- /dev/null +++ b/doc/en/introduction.docbook @@ -0,0 +1,145 @@ +<chapter id="introduction"> + +<title>Introduction</title> +<indexterm><primary>Introduction</primary></indexterm> + <sect1 id="package-description"> + <title>Package description</title> + <para>&krusader; is a simple, easy, powerful, + twin-panel file manager (commander-style) for &kde; + and other *nix desktops, similar to &mc; or + &tcmd;. It provides all the file management features + you could possibly want.</para> + <para>Krusader also includes extensive archive handling, + mounted file system support, &FTP;, advanced search + module, viewer/editor, directory synchronization, file content + comparisons, powerful batch renaming and much, much more. + &krusader; supports archive formats: ace, arj, bzip2, deb, gzip, iso, lha, + rar, rpm, tar, zip and 7-zip and handles other + &kioslaves1-url; such as smb:// or fish://.</para> + <para>&krusader; is almost completely customizable and therefore + very user-friendly.</para> + <para>Try &krusader;.</para> + <!-- OLD +<screenshot> + <screeninfo>&krusader; screenshot</screeninfo> + <mediaobject id="krusader_screenshot"> + <imageobject><imagedata fileref="krusader1.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="krusader1.png" format="EPS"/></imageobject> + <textobject><phrase>&krusader; screenshot</phrase></textobject> + <caption><para>&krusader; screenshot</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-krusader" float="1"> + <title>&krusader; screenshot</title> + <mediaobject> + <imageobject> + <imagedata fileref="krusader1.png"></imagedata> + </imageobject> + <textobject> + <phrase>&krusader; screen shot</phrase> + </textobject> + </mediaobject> + </figure> + <para>More &kru-screenshots-url; can be viewed on + our website.</para> + </sect1> + + <sect1 id="welcome"> + <title>Welcome to &krusader;!</title> + <para>Our aim is to give you a simple, intuitive tool that + easily handles the most important tasks you perform on your + computer each and every day: manage and process your files the + way you want.</para> + <para>Whether you are a &Linux; expert or a novice, + &krusader; makes routine file management tasks quick + and accurate, allowing you to focus on the big picture, not + command line syntax. This is especially helpful if you are new + to xxNIX operating systems. To do just that, + &krusader; uses a good-looking &GUI; and + supports drag and drop as well as mime types, making it easy to + use.</para> + <para>&krusader; has many useful features. It is fast, and + handles &archives-lnk; transparently. In addition, + &krusader; streamlines many complex file management + tasks, reducing fatigue, errors, and distraction. Basically, + &krusader; provides all the helpful features you have + come to expect from other quality file management tools like + &mc; and &tcmd;. &krusader; is + designed to integrate seamlessly with the &kde; + Desktop, the desktop of choice for many programmers, network + engineers, and other power users of &Linux;. With + &krusader; even novice users can quickly access the + power, convenience, and feature rich capabilities of the + &kde; Desktop. &krusader; is a free + open-source project, and it is released under the + &gpl-lnk;, although the developers still retain the + copyright for the project and its name, and manage the + project's continuing evolution.</para> + <para>The &krusader; Project mission is to create + an "all-in-one" file manager, which will do all the ordinary + things you would expect of it, and more. Since the principle + behind &krusader; is based on the + &ofm-url;, dual-pane filemanagers (&mc;, + &nc;, &etc;), it is certain that + &krusader; is able to handle all the standard Copy, + Move, Delete, &etc; file operations.</para> + <para>From the start, virtual file systems became the main + focus. &vfs-lnk; are an abstracted layer over all + kinds of archived information (ZIP files, &FTP; + servers, TAR archives, NFS filesystems, SAMBA shares, ISO + cd/dvd images, RPM catalogs, &etc;), which allow the + user to access all the information in these divergent types of + file systems transparently - just like entering an ordinary + sub-directory. Files can then be copied or moved around (except + ISO,rpm,tar.gz) between these data sources/containers + effortlessly. &krusader; currently supports VFSs for + all popular and some specialized types of archives (ace, arj, + bzip2, gzip, iso, lha, rar, tar, zip and 7-zip), configuration + packages (rpm, deb), and traditional remote file system types + (&FTP;, NFS, Samba, FISH, SFTP).</para> + <para>&krusader; also includes a built-in + Mount-Manager &mountman-lnk;, which enables you to + mount or unmount file systems of all types with a click of a + mouse. The user is able to obtain usage and other property + information easily, in a consistent and understandable format + in seconds. Ease and consistency is the goal.</para> + <para>A &bookmark-manager-lnk; for local + files/remote &URL;s and an + &advanced-search-module-lnk; is also included to + speed the locating of needed files. &krusader; also + allows the user to configure Toolbars in order to provide a + wide variety of additional functionality, such as File + Comparison (several user selectable methods available), + Multiple File Rename, and standard Terminal windows.</para> + <para>Advanced users benefit greatly from being able to carry + out clerical tasks effortlessly, without distraction from the + real task at hand. Convenient shortcut keys enable the user to + navigate directory trees with ease, create multiple tabbed + directory views simultaneously, and access fully functional + history lists. Due to efficient programming and low system + overhead, &krusader; is perhaps the most responsive + all around system management tool used to access the full + potential of a computer using &kde;, or any other + standards compliant X Windows window manager. Although designed + specifically for, and tightly integrated with, + &kde;; &krusader; works equally well with + Gnome, Enlightenment, WindowMaker, IceWM, BlackBox, Wiamea, + XFCE, etc.as soon as the KDE libraries are installed.</para> + <para>New extensibility is provided by the flexible + &useractions-lnk;, a &krusader; + innovation that allows unlimited additional custom + functionality to be added to suit the specific needs of users. We + are planning to develop more modules in the near future, + thereby enhancing &krusader;. Information on what is + proposed, approved, or remains to be completed can be found in + the &todoforum-url;.</para> + <para>No other program we know of, offers so many useful, + easily accessible features in such an intuitive and simple + format. Best of all, we listen, and implement good suggestions + that are consonant with the &krusader; Project's + goal: making &krusader; the very best File Manager + available.</para> + <para>We hope you'll enjoy it - we do!</para> + </sect1> +</chapter> diff --git a/doc/en/java.docbook b/doc/en/java.docbook new file mode 100644 index 0000000..dcaa287 --- /dev/null +++ b/doc/en/java.docbook @@ -0,0 +1,88 @@ +<sect1 id="javascript_console"> + <title>JavaScript Console</title> + <indexterm> + <primary>JavaScript Console</primary> + </indexterm> + <para> + <keycombo action="simul">&Alt;&Ctrl; + <keycap>j</keycap></keycombo> opens the JavaScript console. + (only available if libkjsembed is present at compile- and + runtime)</para> + <para>The JavaScript console is an interface to the embedded + JS-Interpreter which can be used for amusement or + testing.</para> + </sect1> + + <sect1 id="javascript_interface"> + <title>JavaScript interface</title> + <indexterm> + <primary>JavaScript interface</primary> + </indexterm> + <para> + <emphasis role="bold">Warning:</emphasis> The JS-Support is + quite stable, and you can not lose any data by using it. However, + your scripts may not work with future versions of + &krusader;, as the JS-Support is changing.</para> + <tip> + <para>Please + <link linkend="help_krusader">upload your favorite JavaScript + Extensions</link> so that they become available for the + &krusader; community. Thanks!</para> + </tip> + <para>JavaScript applications usually have 2 files + <filename>foo.js</filename>and + <filename>foo.ui</filename>. They will be installed in + <filename>~/.kde/share/apps/krusader/js/</filename>, a + user action with a "%_Script" action will start the + Javascripting. Currently we have 2 JS demos + <filename>root-mount-extension.tar.bz2</filename> and + <filename>js-demo-calc.tar.bz2</filename> that will be more + explanatory.</para> + <para>When a script is executed, the script doesn't know its + origin (or maybe there is a way to do so that we do not know of) + and all relative paths are relative to the current working-dir. + But this dir is (normally) not the one where the script is + located but the current dir of the active Panel of Krusader. + This needs to stay like this. However, for referencing + additional files like .ui (Userinterface, exported by + &Qt;'s Designer) one needs the path of the script. + The alternative where absolute paths are used is more than + unhandy. For this reason the Variable "scriptDir" was + introduced. If a Script wants to load a &GUI; from a + .ui-file this can be done this way: + <emphasis>var ui = Factory.loadui( scriptDir + 'filename.ui' + );</emphasis> I recommend using Dialog as a base when designing + &GUI;s to be used with JS. Execute the dialog with: + <emphasis>ui.exec();</emphasis> The elements of the + &GUI; may be accessed in the following way: + <emphasis>ui.child('widgetName')</emphasis></para> + <para>Currently only the objects 'Krusader' and + 'PanelManager' are exposed C++ objects without a logic + behind them. They can be inspected using the JS-Console and the + functions 'properties()', 'children()' and 'slots()'. The + children can be accessed with the function + 'child("nameOfChild")' with returns an object itself. Currently, the Variable scriptDir is more useful. Following the root-mount + extension it is already possible to create advanced + &GUI;s for command line tools</para> + <para>You can play around with 'Krusader.setCaption("Hey Ho, + Let's go!");', 'Krusader.children();', + 'Krusader.child("help").slots();', + 'alert(Krusader.properties())' or + 'Krusader.child("help").show();'.... In addition, a new + placeholder for the &useractions-lnk;, %_Script()%, + will execute an external file.</para> + <para>NOTE: The object 'Krusader' will change. We have not made + decisions about the JS-interface yet (at the time of the + 1.70.0-release). Any ideas are welcome. Plase use our + &kruforum-url; for feedback.</para> + <para>The JavaScript-support is based on + &kjsembed-url;. Some examples which show the power + of this library can be found + <ulink url="http://xmelegance.org/kjsembed/examples/index.html"> + here</ulink>. Support for all of KDE's ground-laying technologies + such as DCOP or KParts is provided. You can even load whole + GUIs from .ui-files, created with &Qt;'s Designer. + An example extension making use of this can be found + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?p=4832#4832"> + here</ulink>.</para> +</sect1> diff --git a/doc/en/keyboard.docbook b/doc/en/keyboard.docbook new file mode 100644 index 0000000..5e16c3d --- /dev/null +++ b/doc/en/keyboard.docbook @@ -0,0 +1,1864 @@ +<chapter id="keyboard-commands"> + <!-- ********************************************************************** + keyboard.docbook + +++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Keyboard Commands</title> + <indexterm> + <primary>Commands</primary> + <secondary>Keyboard</secondary> + </indexterm> + <sect1 id="keyboard-usage"> + <title>Keyboard Usage</title> + <para>In this chapter you will learn how to use the keyboard + effectively, because most operations can be done more quickly + by keyboard than with the mouse. It will take some time to learn + the &keybindigs-lnk;, but mastering them saves you a + lot of time. Please note that &krusader; can use + &keybindigs-profiles-lnk; to swap easily to other + Key-binding setups, e.g. of other commanders, or you can create + your own key-bindings.</para> + <para>After + <link linkend="starting-krusader"> + starting</link> &krusader;, the keyboard action can + begin. Use <keycombo action="simul">&Ctrl;<keycap>l</keycap></keycombo> to jump to the + &location-toolbar-lnk; where you can type the + desired directory. After <keycombo action="simul">&Ctrl;<keycap>Down arrow</keycap></keycombo> + you are in the + &termemu-lnk; and you can type any command you + desire. Use <keycombo action="simul">&Ctrl;<keycap>Up arrow</keycap></keycombo> + to jump back to the active panel. If + you want to jump to a file or directory that starts with "f", + then simply press "f" on the keyboard to use the + &quick-search-lnk; . Use the Enter key to execute + the file or to open a directory that has the focus. Be sure to + remember the Function Keys - <keycap>F3</keycap> to View, <keycap>F4</keycap> to Edit, + <keycap>F5</keycap> to Copy, <keycombo action="simul">&Alt;<keycap>u</keycap></keycombo> to Unpack, etc.</para> + <para>You can also perform several operations with the + &foldertabs-lnk;, including several + <link linkend="edit-menu">selection</link> operations. And at + the end you can close &krusader; with <keycap>F10</keycap>.</para> + </sect1> + <sect1 id="key_bindings"> + <title>Key-Bindings</title> + <indexterm> + <primary>Key-Bindings</primary> + </indexterm> + <indexterm> + <primary>Commands</primary> + <secondary>Keyboard</secondary> + </indexterm> + <para>Most of the key-bindings (shortcuts) are configurable in + the <emphasis role="bold"> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Shortcuts</guimenuitem> + </menuchoice> + </emphasis> menu, if you like to use other key-bindings then the + default ones. You can even configure + more actions to a Key-Binding (for the actions that don't have a key-binding set by default). + Please note that some key-bindings are not &krusader; key-bindings ⪚ + &kde; key-bindings). The key-bindings that + &krusader; uses by default are listed below.</para> + + <!-- FN keys --> + <para> + <emphasis role="bold">Function (FN) Keys</emphasis> + </para> + <para>These are the Key-Bindings of the + &fnkeybar-lnk;. These Key-Bindings are configurable + since version 1.51.</para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycap>F1</keycap> + </para> + </entry> + <entry> + <para>Help</para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F2</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="tools-menu">Terminal.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F3</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="krviewer">View files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F4</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="krviewer">Edit files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F5</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Copy files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F6</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Move files</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F7</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Create a new + directory.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F8</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Delete (or move to Trash) + files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F9</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Rename files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>F10</keycap> + </para> + </entry> + <entry> + <para>Quit &krusader;</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- SHIFT keys --> + <para> + <emphasis role="bold">SHIFT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F1</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="help-menu">What's this?</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F3</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="krviewer">Enter an &URL; + to view.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F4</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="file-menu">Edit new file.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F5</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="useractions-menu">Backup current file (Default Useraction).</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F9</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="multi_rename">Multi-rename + (&krename;).</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F10</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">View all files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>F12</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">Custom view files.</link> + </para> + </entry> + </row> + <!-- This keybinding is disabled in the "krusader.cpp" source file +<row> +<entry><para><keycombo action="simul">&Shift;<keycap>F11</keycap></keycombo></para></entry> +<entry><para><link linkend="view-menu">Executables</link></para></entry></row> +--> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>Left Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">Change to left folder + tab.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>Right Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">Change to right folder + tab.</link> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- ALT keys --> + <para> + <emphasis role="bold">ALT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>c</keycap></keycombo> + </para> + </entry> + <entry> + <para>&comparedir-lnk;</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>d</keycap></keycombo> + </para> + </entry> + <entry> + <para>&diskusage-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>e</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="test-archive">Test Archive.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>k</keycap></keycombo> + </para> + </entry> + <entry> + <para>Start &rootmode-lnk; + &krusader;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>l</keycap></keycombo> + </para> + </entry> + <entry> + <para>&panel-profiles-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>o</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="panel_toolbar">Sync panels aka "Equals Button (=)".</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>p</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="pack-archive">Pack files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>u</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="unpacking-archives">Unpack + files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>y</keycap></keycombo> + </para> + </entry> + <entry> + <para><link linkend="synchronizer">Synchronize Directory changes</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>+</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Select All.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>-</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Unselect All.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>*</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Invert Selection.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>/</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="mount-man">MountMan.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>`</keycap></keycombo> + </para> + </entry> + <entry> + <para>&usermenu-lnk;</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>KP_Enter</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="file-menu">Properties.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>Left Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Left bookmarks.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>Right Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Right bookmarks.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>Down Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>&popup-panel-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Alt; + <keycap>F1..F12</keycap></keycombo> + </para> + </entry> + <entry> + <para>Standard (&kde;) + key-bindings.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <!-- ALT+SHIFT --> + <para> + <emphasis role="bold">ALT+SHIFT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul"> + &Alt;&Shift; + <keycap>b</keycap></keycombo> + </para> + </entry> + <entry> + <para><link linkend="view-menu">Brief View</link></para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Alt;&Shift; + <keycap>d</keycap></keycombo> + </para> + </entry> + <entry> + <para><link linkend="view-menu">Detailed View</link></para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + + + <!-- CTRL --> + <para> + <emphasis role="bold">CTRL keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>b</keycap></keycombo> + </para> + </entry> + <entry> + <para>&combinefiles-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>d</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Open Bookmarks</link>in the + active panel.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>e</keycap></keycombo> + </para> + </entry> + <entry> + <para>Edit file as root (Default Useraction).</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo> + </para> + </entry> + <entry> + <para>Toggle between normal and full screen + &termemu-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>h</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folderhistory">Open History + list.</link>in the active panel.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>j</keycap></keycombo> + </para> + </entry> + <entry> + <para>A &safari;-like + <link linkend="jump_back">Jump-Back</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>l</keycap></keycombo> + </para> + </entry> + <entry> + <para>Go to the &location-toolbar-lnk; + (origin) as in &firefox; and + &konqueror;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>m</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="list_panel">Open media + list.</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>n</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="tools-menu">New Network + Connection.</link>dialog.</para> + </entry> + </row> + <!-- TODO: Is this entry gone ???? +<row> +<entry><para><keycombo action="simul">&Ctrl;<keycap>o</keycap></keycombo></para></entry> +<entry><para>the inactive panel gets the same path as the active panel</para></entry></row> +--> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>o</keycap></keycombo> + </para> + </entry> + <entry> + <para>Select directory dialog to open this directory + in the panel.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>p</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="splitter">Split file.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>u</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">Swap panels (don't swap all folder tabs)</link>. + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>r</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="panels">Reload (Refresh) + panel.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo> + <keycap>Ctrl</keycap> + <keycap>s</keycap> + </keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="krusearcher">Search.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>q</keycap></keycombo> + </para> + </entry> + <entry> + <para>Quit &krusader;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>w</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">Close Current tab.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>y</keycap></keycombo> + </para> + </entry> + <entry> + <para>&syncdirs-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>z</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Popular URL's.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>+</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Select group.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>-</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="edit-menu">Unselect group.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>=</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">Compare + directories.</link>(Compare Mode)</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>.</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="view-menu">Show/Hide hidden (dot) + files.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>/</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="cmdline">Open command line history + list.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="cmdline">Go from the active panel to + the command line/terminal emulator</link>. + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="cmdline">Go from the command + line/terminal emulator to the active panel.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Go from the active panel to the + &location-toolbar-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Home</keycap></keycombo> + </para> + </entry> + <entry> + <para>Jump to the Home directory.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Left</keycap></keycombo>or + <keycombo> + <keycap>Right arrow</keycap> + </keycombo></para> + </entry> + <entry> + <para>Focus a file or directory on the left panel, + press + <keycombo action="simul">&Ctrl; + <keycap>Left arrow</keycap></keycombo> and the right + <link linkend="panels">panel</link> changes: + <itemizedlist> + <listitem> + <para>on a file: the right panel gets the same + path as the left + <link linkend="panels">panel</link>.</para> + </listitem> + <listitem> + <para>on a directory: refreshes the right panel + with the contents of the directory.</para> + </listitem> + </itemizedlist>For the right panel: press + <keycombo action="simul">&Ctrl; + <keycap>Right arrow</keycap></keycombo> and the left + panel will change.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Backspace;</keycombo> + </para> + </entry> + <entry> + <para>Jump to the Root directory.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>PageUp</keycap></keycombo> + </para> + </entry> + <entry> + <para>Up one directory.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- CTRL+SHIFT --> + <para> + <emphasis role="bold">CTRL+SHIFT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>d</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="bookman">Bookmark current + item.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>f</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="remote-connections">Disconnect + remote connection.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>j</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="jump_back">Set jump back + point.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>l</keycap></keycombo> + </para> + </entry> + <entry> + <para>&locate-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>u</keycap></keycombo> + </para> + </entry> + <entry> + <para><link linkend="view-menu">Swap Sides (also swap all folder tabs)</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Left arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="list_panel">Open left media + list</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Right arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="list_panel">Open right media + list.</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Open + <link linkend="cmdline">terminal emulator</link>, + independently, whether the command line is shown or + not.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Close + <link linkend="cmdline">terminal emulator</link>, + independently, whether the command line is shown or + not.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- CTRL+ALT --> + <para> + <emphasis role="bold">CTRL+ALT keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>j</keycap></keycombo> + </para> + </entry> + <entry> + <para>&javascript-console-lnk;</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>m</keycap></keycombo> + </para> + </entry> + <entry> + <para>Mount (Default Useraction).</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>n</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">New tab.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>r</keycap></keycombo> + </para> + </entry> + <entry> + <para>Toggle the &list-panel-lnk; between + horizontal and vertical mode.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>s</keycap></keycombo> + </para> + </entry> + <entry> + <para>Create a new symlink.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>t</keycap></keycombo> + </para> + </entry> + <entry> + <para>Show/hide the + <link linkend="cmdline">terminal + emulator</link>.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>Left Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folderhistory">Left History + list.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>Right Arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folderhistory">Right History + list.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>=</keycap></keycombo> + </para> + </entry> + <entry> + <para>Equal Panel Size (Default Useraction).</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt;&Shift; + <keycap>n</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="folder-tabs">Duplicate a tab.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt;&Enter;</keycombo> + </para> + </entry> + <entry> + <para>Open current folder in a + <link linkend="folder-tabs">new tab.</link></para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- GENERAL CTRL --> + <para> + <emphasis role="bold">General CTRL keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>a</keycap></keycombo> + </para> + </entry> + <entry> + <para>Select all.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>PageDown</keycap></keycombo> + </para> + </entry> + <entry> + <para>Move to the lower part in the current + directory.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>F1..F12</keycap></keycombo> + </para> + </entry> + <entry> + <para>Standard (&kde;) + key-bindings.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>F1..F12</keycap></keycombo> + </para> + </entry> + <entry> + <para>Standard (&kde;) + key-bindings.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- OTHER KEYS --> + <para> + <emphasis role="bold">Other keys</emphasis> + </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycap>foo</keycap> + </para> + </entry> + <entry> + <para>&quick-search-lnk;</para> + </entry> + </row> + <row> + <entry> + <para>	</para> + </entry> + <entry> + <para> + <link linkend="panels">Switch between the + panels</link> + </para> + </entry> + </row> + <row> + <entry> + <para>&Enter;</para> + </entry> + <entry> + <para> + <link linkend="executing_files">On a + file:</link> open/execute that file</para> + <para> + <link linkend="browsing-archives">On an archive + file:</link> browse the archive as if it was a + directory.</para> + </entry> + </row> + <row> + <entry> + <para>&Esc;</para> + </entry> + <entry> + <para> + <link linkend="moving-around">Will make the menu + bar lose the focus if it has it.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>Delete</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Delete (or move to + Trash).</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>Delete</keycap></keycombo> + </para> + </entry> + <entry> + <para> + <link linkend="basic">Delete permanently.</link> + </para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>SPACE</keycap> + </para> + </entry> + <entry> + <para> + <link linkend="selecting-files">On a + file:</link> toggle the selection of the file down one + position without affecting the selection of other + files/directories.</para> + <para> + <link linkend="calculate">On a + directory:</link> calculate the size, without + affecting the selection of other + files/directories.</para> + </entry> + </row> + <row> + <entry> + <para>&Backspace;</para> + </entry> + <entry> + <para>One directory up.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>INSERT</keycap> + </para> + </entry> + <entry> + <para>Does the same as the SPACE key + <link linkend="selecting-files">and goes down one + position to toggle the next file.</link></para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>MENU</keycap> + </para> + </entry> + <entry> + <para>Right-click menu.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>Home</keycap> + </para> + </entry> + <entry> + <para>Cursor jumps to the top of the list.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycap>End</keycap> + </para> + </entry> + <entry> + <para>Cursor jumps to the last file in the + list.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + + <!-- COMMANDLINE --> + <para id="cmdline_keybindings"> + <emphasis role="bold">Command Line</emphasis> + </para> + <para>&cmdline-lnk; keybindings.</para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycap>Up arrow</keycap> and + <keycap>Down arrow</keycap></para> + </entry> + <entry> + <para>scroll through previously typed + commands.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>/</keycap></keycombo> + </para> + </entry> + <entry> + <para>open the command line history list.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>jump from the command line to the active + panel.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>jump from the active panel to the command + line.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Enter;</keycombo> + </para> + </entry> + <entry> + <para>insert current file / directory name without + path to current command line position.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Shift;&Enter;</keycombo> + </para> + </entry> + <entry> + <para>insert current file / directory with full path + name to current command line position.</para> + </entry> + </row> + <!-- "Backspace" key in terminal, /* Shortcut disabled because of the Terminal Emulator bug. */ krusader.cpp --> + </tbody> + </tgroup> + </informaltable> + + <!-- TERMINAL EMULATOR --> + <para id="termemu_keybindings"> + <emphasis role="bold">Terminal emulator</emphasis> + </para> + <para>&termemu-lnk; keybindings.</para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo> + </para> + </entry> + <entry> + <para>Toggle between normal and full screen + &termemu-lnk;.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>v</keycap></keycombo> + </para> + </entry> + <entry> + <para>Insert from clipboard.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Up arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Jump from the Terminal Emulator to the active + panel if the Command line is hidden.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Jump from the active panel to the Terminal Emulator + if the Command line is hidden.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl;&Shift; + <keycap>Up/Down arrow</keycap></keycombo> + </para> + </entry> + <entry> + <para>Always focus/unfocus the Terminal Emulator independently + whether the Command Line is shown or not. </para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul">&Shift; + <keycap>Insert</keycap></keycombo> + </para> + </entry> + <entry> + <para>Insert from clipboard.</para> + </entry> + </row> + + <!-- "Backspace" key in terminal, /* Shortcut disabled because of the Terminal Emulator bug. */ krusader.cpp --> + </tbody> + </tgroup> + </informaltable> + + + <!-- DEFAULT USERACTIONS --> + <para> + <emphasis role="bold">Default Useractions</emphasis> + </para> + <para>Default &useractions-lnk; keybindings provided + by &krusader;.</para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <keycombo action="simul">&Ctrl; + <keycap>e</keycap></keycombo> + </para> + </entry> + <entry> + <para>Edit a file as root.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>c</keycap></keycombo> + </para> + </entry> + <entry> + <para>Copy current item to clipboard.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>m</keycap></keycombo> + </para> + </entry> + <entry> + <para>Mount a new file system.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + &Ctrl;&Alt; + <keycap>=</keycap></keycombo> + </para> + </entry> + <entry> + <para>Equal panel-size.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>a</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Enqueue in Amarok.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>1</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Sort by Name.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>2</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Sort by extension.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>3</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Sort the active panel by size.</para> + </entry> + </row> + <row> + <entry> + <para> + <keycombo action="simul"> + <keycap>Win</keycap> + <keycap>4</keycap> + </keycombo> + </para> + </entry> + <entry> + <para>Sort by modified.</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + <!-- OTHER KEYS URL'S --> + <itemizedlist> + <title>Other Key-bindings</title> + <listitem> + <para> + <link linkend="selecting-files">Selecting files</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="krviewer">KrViewer</link> + </para> + </listitem> + <listitem> + <para>&diskusage-lnk;</para> + </listitem> + <listitem> + <para>&locate-lnk;</para> + </listitem> + <listitem> + <para>&kcontrolcenter; -> + Accessibility -> Keyboard Shortcuts</para> + </listitem> + <listitem> + <para>&useractions-lnk; configurable + key-bindings</para> + </listitem> + </itemizedlist> + </sect1> +</chapter> diff --git a/doc/en/konfigurator.docbook b/doc/en/konfigurator.docbook new file mode 100644 index 0000000..e3658e5 --- /dev/null +++ b/doc/en/konfigurator.docbook @@ -0,0 +1,1907 @@ +<chapter id="konfigurator"> + <!-- ********************************************************************** + konfigurator.docbook + ++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Konfigurator: &krusader;'s Configuration + Center</title> + <indexterm> + <primary>Configure</primary> + <secondary>Krusader</secondary> + </indexterm> + <para>Konfigurator is &krusader;s configuration + center. When runnig &krusader;, use + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure &krusader;</guimenuitem> + </menuchoice>, and it will start Konfigurator. + There you can modify the way &krusader; works + and customize it to your own needs. At any time, pressing the + <guibutton>Apply</guibutton> button applies the changes, pressing + <guibutton>Close</guibutton> closes Konfigurator, and pressing + <guibutton>Defaults</guibutton> re-applies &krusader;'s + "factory" settings. Konfigurator is divided into pages, each + containing items related to that page. For some changes to the + &GUI;, you have to close and restart + &krusader;.</para> + +<note> + <para>Since &krusader;-1.80.0 the &keybindigs-lnk; and &main-toolbar-lnk;-&actions-toolbar-lnk; + have reiceived their own configuration windows and so they are not a part anymore of Konfigurator, + you can configure them now via the &settingsmenu-lnk;.</para> +</note> + + <sect1 id="konfig-startup"> + <title>Startup</title> + <!-- OLD +<screenshot> + <screeninfo>Startup configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgstartup.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgstartup.png" format="EPS"/></imageobject> + <textobject><phrase>Startup configuration</phrase></textobject> + <caption><para>Configure Startup</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-kgstartup" float="1"> + <title>Startup configuration</title> + <mediaobject> + <imageobject> + <imagedata fileref="kgstartup.png"></imagedata> + </imageobject> + <textobject> + <phrase>Startup configuration</phrase> + </textobject> + </mediaobject> + </figure> + <para>The startup page determines the way that + &krusader; looks (and works) when it is launched. It + is divided into two main parts:</para> + <variablelist> + <varlistentry> + <term> + <guilabel>General</guilabel> + </term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Startup Profile</guilabel>: Starts the + selected + <link linkend="panel_profiles">Panel profile</link> at + startup. + <guilabel><Last + session></guilabel> is a special Panel + Profile, it is saved automatically when closing + &krusader;.</para> + </listitem> + <listitem> + <para> + <guilabel>Show splashscreen</guilabel>: Displays a + splash screen when starting + &krusader;.</para> + </listitem> + <listitem> + <para> + <guilabel>Single Instance Mode</guilabel>: Allows + only one &krusader; instance to run.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>User Interface</guilabel> + </term> + <listitem> + <para>Determines which parts of the user interface are + visible after start-up. + <itemizedlist> + <listitem> + <para> + <guilabel>Save settings on exit</guilabel>: If + checked, restores the user interface components to + their condition when last shut-down.</para> + </listitem> + <listitem> + <para> + <guilabel>Show toolbar</guilabel>: If checked, + &main-toolbar-lnk; is visible after + startup.</para> + </listitem> + <listitem> + <para> + <guilabel>Show statusbar</guilabel>: If checked, the + &statusbar-lnk; is visible after + start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Show function keys</guilabel>: If checked, + the &fnkeybar-lnk; is visible after + start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Show command line</guilabel>: If checked, + the &cmdline-lnk; is visible after + start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Show terminal emulator</guilabel>: If + checked, the &termemu-lnk; is visible + after start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Save last position, size and panel + settings</guilabel>: When launched, + &krusader; resizes itself to the size it + was when last shut-down. &krusader; also + appears in the same location on the screen, having + panels sorted and aligned as they were. If this + option is unchecked, you can use the menu + <emphasis role="bold"> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Save Position</guimenuitem> + </menuchoice> + </emphasis> option to manually set + &krusader; size and position at + start-up.</para> + </listitem> + <listitem> + <para> + <guilabel>Start to tray</guilabel>: if checked, + &krusader; starts to tray (if minimize to + tray is set), without showing the main window.</para> + </listitem> + </itemizedlist></para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="konfig-looknfeel"> + <title>Look and Feel</title> + <para>Here you can determine the look and feel of things - + which means finetuning the application to your needs. The page + is divided into four tabs: + <guilabel>Operation</guilabel>, + <guilabel>Panel</guilabel>, + <guilabel>Panel Toolbar</guilabel> and + <guilabel>Selection Mode</guilabel>:</para> + <!-- OLD +<screenshot> + <screeninfo>Look & Feel configurtarion</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kglookfeel.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kglookfeel.png" format="EPS"/></imageobject> + <textobject><phrase>Look & Feel configurtarion</phrase></textobject> + <caption><para>Configure Look & Feel</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kglookfeel" float="1"> +<title>Look & Feel configurtarion</title> +<mediaobject> +<imageobject><imagedata fileref="kglookfeel.png"/></imageobject> +<textobject><phrase>Look & Feel configurtarion</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <sect2 id="konfig-looknfeel-operation"> + <title>Operation</title> + <itemizedlist> + <title> + <guilabel>Look & Feel</guilabel> + </title> + <listitem> + <para> + <guilabel>Warn on exit</guilabel>: If checked, + &krusader; displays an "Are you sure?" warning + when you try to shut it down; otherwise, it exits without + protest.</para> + </listitem> + <listitem> + <para> + <guilabel>Minimize to tray</guilabel>: If checked, when + you minimize &krusader;, its icon will appear + in the system tray instead of the taskbar.</para> + </listitem> + <listitem> + <para> + <guilabel>Autoselect Directories</guilabel>: When + <link linkend="edit-menu">you select a group of + files</link> (either by using Select Group or by using + Select All), &krusader; checks this option. If + checked, the directories matching the select criteria are + also selected. Otherwise, only files are selected.</para> + </listitem> + <listitem> + <para> + <guilabel>Rename selects extension</guilabel>: When + <link linkend="renaming">you rename a file</link>, the + whole text is selected. If you want total commanderlike + renaming of just the name, without extension, deselect + this item.</para> + </listitem> + <listitem> + <para> + <guilabel>Use fullpath tab names</guilabel>: If checked, + display the full path in the &foldertabs-lnk;; + otherwise only the last part of the path is + displayed.</para> + </listitem> + <listitem> + <para> + <guilabel>Fullscreen terminal (mc-style)</guilabel>: + Terminal appears instead of the &krusader; + window (full screen).</para> + </listitem> + <!-- + <listitem><para><guilabel>HTML viewers minimal font size</guilabel>: when viewing an HTML file + (usually using <keycap>F3</keycap>), &krusader; invokes &kde;'s built-in HTML parser. This option + sets the minimal font size for the viewer, and aligns other font sizes accordingly. + </para></listitem> --> + </itemizedlist> + <itemizedlist> + <title> + <guilabel>Quicksearch</guilabel> + </title> + <listitem> + <para> + <guilabel>New style Quicksearch</guilabel>: The new + <link linkend="quicksearch">Quicksearch</link>feature is + used.</para> + </listitem> + <listitem> + <para> + <guilabel>Case Sensitive Quicksearch</guilabel>: When you + use the + <link linkend="quicksearch">Quicksearch</link>feature: If + checked (the &UNIX; default), all files + beginning with capital letters appear before files + beginning with lower case letters; otherwise, all files + beginning with a specified letter (capital or otherwise) + will be displayed together.</para> + </listitem> + </itemizedlist> + </sect2> + <sect2 id="konfig-looknfeel-panel"> + <title>Panel</title> + <itemizedlist> + <listitem> + <para> + <guilabel>Panel font</guilabel>: Allows you to change the + font used inside the file lists.</para> + </listitem> + <listitem> + <para> + <guilabel>Filelist icon size</guilabel>: Allows you to + change the size of the icons in the file lists. The + available sizes are 16x16, 22x22, 32x32 and 48x48 + pixels.</para> + </listitem> + <listitem> + <para> + <guilabel>Use icons in filenames</guilabel>: If checked, + show the icons in file names and folders.</para> + </listitem> + <listitem> + <para> + <guilabel>Human readable file size</guilabel>: If + checked, the file size appears in kB, Mb + &etc;, and not in bytes (default).</para> + </listitem> + <listitem> + <para>Since &krusader;-1.70.0 you need to + configure the columns with the right click menu in the + panel, not in Konfigurator. The left and right panel use + their own columns independently. The following columns + are available: + <itemizedlist> + <listitem> + <para> + <guilabel>Name</guilabel>: Shows the filename without the part after the last dot, + this latter part is displayed in the Ext column. When the Ext column is made hidden, + the complete filename is shown in the Name column like e.g. &konqueror; does. + </para> + </listitem> + <listitem> + <para> + <guilabel>Ext</guilabel>: Shows the last part of the + filename (the part after the last dot) in the ext + column, and not as a complete filename in the name column + like e.g. &konqueror; does. + </para> + </listitem> + <listitem> + <para> + <guilabel>Type</guilabel>: Shows the mime type + field.</para> + </listitem> + <listitem> + <para> + <guilabel>Size</guilabel>: Shows the size + field.</para> + </listitem> + <listitem> + <para> + <guilabel>Modified</guilabel>: Shows the modified + date and time field.</para> + </listitem> + <listitem> + <para> + <guilabel>Perms</guilabel>: Shows the full permissions + ⪚ "rwxr-xr-x" or as octal numbers + '0755' instead with enable/disable + <guilabel>Numeric Permissions</guilabel> in Look + & Feel + <guilabel>Operation</guilabel> Tab.</para> + </listitem> + <listitem> + <para> + <guilabel>rwx</guilabel>: Shows only the rights of + the current user ⪚ "-rw".</para> + </listitem> + <listitem> + <para> + <guilabel>Owner</guilabel>: Shows the owner + field.</para> + </listitem> + <listitem> + <para> + <guilabel>Group</guilabel>: Shows the group + field.</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para> + <guilabel>Show Hidden files</guilabel>: If checked, + &krusader; displays the "dot-files" which are + otherwise hidden.</para> + </listitem> + <listitem> + <para> + <guilabel>Case Sensitive Sorting</guilabel>: If checked + (the &UNIX; default), all files beginning with + capital letters appear before files beginning with + non-capital letters; otherwise, all files beginning with + a specified letter (capital or otherwise) appear + together.</para> + </listitem> + <listitem> + <para> + <guilabel>Always sort dirs by name</guilabel>: Sorts + directories by name, regardless of the sort + column.</para> + </listitem> + <listitem> + <para> + <guilabel>Numeric permissions</guilabel>: Permission + column (Look & Feel + <guilabel>Panel</guilabel>Tab) shows octal numbers '0755' + instead of 'rwxr-xr-x'.</para> + </listitem> + </itemizedlist> + <tip> + <para>Uncheck the columns not in use. This allows more + space for columns in use.</para> + </tip> + </sect2> + <sect2 id="konfig-looknfeel-ptoolbar"> + <title>Panel Toolbar</title> + <para> + <guilabel>Panel Toolbar visible</guilabel>: If checked, + &krusader; displays the Panel Toolbar.</para> + <para>You can make the buttons on the + <guilabel>Panel Toolbar</guilabel> visible or hidden: + <itemizedlist> + <listitem> + <para> + <guilabel>Clear Location Toolbar</guilabel> button: Clears + the &location-toolbar-lnk;</para> + </listitem> + <listitem> + <para> + <guilabel>Open</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Equal (=)</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Up (..)</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Home (~)</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Root (/)</guilabel> button</para> + </listitem> + <listitem> + <para> + <guilabel>Toggle-button for sync-browsing</guilabel>: If + checked, shows the &sync-browsing-lnk; + button.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="konfig-selection_modes"> + <title>Selection Mode</title> + <para>Here you can configure the selection modes. + <itemizedlist id="mouse_selection_modes"> + <title> + <guilabel>General</guilabel> + </title> + <listitem> + <para> + <guilabel>&krusader; Mode</guilabel>: The way + &krusader; has worked from day one. Both mouse + keys allow selecting files. To select more than one file, + hold the &Ctrl; key and click the + &LMB;. Right-click menu appears with a short + click on the &RMB;.</para> + </listitem> + <listitem> + <para> + <guilabel>Konqueror Mode</guilabel>: pressing the + &LMB; selects files -- + <!-- Openjade does not like an application element for "Konqueror" here --> + you can click and select multiple files. Right-click menu + appears with a short click on the + &RMB;.</para> + </listitem> + <listitem> + <para> + <guilabel>Total commander Mode</guilabel>: Pressing the + &RMB; selects multiple files + <!-- Openjade does not like an trademark element for "Total commander" here --> + and the right-click menu appears with + <guilabel>pressing and holding</guilabel> the + &RMB; The &LMB; does not select, + but sets the current file without affecting the current + selection.</para> + </listitem> + <listitem> + <para> + <guilabel>Custom Selection Mode</guilabel>: Create your + own selection style!</para> + </listitem> + </itemizedlist> + <itemizedlist> + <title> + <guilabel>Details</guilabel> + </title> + <listitem> + <para> + <guilabel>Double-click selects (classic)</guilabel>: A + single click on a file will select and focus, a double + click opens the file or steps into the directory.</para> + </listitem> + <listitem> + <para> + <guilabel>Obey KDE global selection policy</guilabel>: + Pressing the &LMB; selects files -- Use + &kde;'s global setting: &kde; + Control Center -> Peripherals + -> Mouse.</para> + </listitem> + <listitem> + <para>Custom Selection Mode items: + <itemizedlist> + <listitem> + <para> + <guilabel>Based on KDE's selection mode</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Left mouse button selects</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Left mouse button preserves + selection</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Shift/Ctrl-Left mouse button + selects</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Right mouse button selects</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Right mouse button preserves + selection</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Shift/Ctrl-Right mouse button + selects</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Space bar moves down</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Space bar calculates diskspace</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Insert moves down</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Right-clicking shows the context menu + immediately</guilabel> + </para> + </listitem> + </itemizedlist></para> + </listitem> + </itemizedlist></para> + </sect2> + </sect1> + <sect1 id="konfig-color"> + <title>Colors</title> + <para>This page configures the colors of the + &list-panel-lnk; and the + &synchronizer-lnk;. The + <guilabel>KDE default colors</guilabel> is the default color + configuration.</para> + <!-- OLD +<screenshot> + <screeninfo>Colors configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgcolor.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgcolor.png" format="EPS"/></imageobject> + <textobject><phrase>Colors configuration</phrase></textobject> + <caption><para>Colors configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kgcolor" float="1"> +<title>Colors configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kgcolor.png"/></imageobject> +<textobject><phrase>Colors configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <variablelist> + <varlistentry> + <term> + <guilabel>General</guilabel> + </term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Use the default KDE colors</guilabel>: this + is the default, it uses &kde; color + settings of + <command>kcontrol</command>.</para> + </listitem> + <listitem> + <para> + <guilabel>Use Alternate Background color</guilabel>: + If checked, the + <guilabel>Background</guilabel> color and the + <guilabel>Alternate background</guilabel> color + alternates line by line. When you do not use the + &kde; default colors, you can configure + the alternate colors in the + <guilabel>Colors</guilabel> box.</para> + </listitem> + <listitem> + <para> + <guilabel>Show current item even if not + focused</guilabel>: If checked, shows the last cursor + position in the non active list panel. This option is + only available when you do not use the + &kde; default colors.</para> + </listitem> + <listitem> + <para> + <guilabel>Dim the colors of the inactive + panel</guilabel>: If checked, the colors of the + inactive panel are dimmed. These settings can be + configured in the + <guilabel>Inactive</guilabel> tab of the + <guilabel>Colors</guilabel> box. This option is only + available when you do not use the &kde; + default colors.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Colors</guilabel> + </term> + <listitem> + <para>Configure the colors the way you like, you can see + the result in the + <guilabel>Preview</guilabel> section. The following items + of the active and inactive panel can be + configured:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Directory foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Executable foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Symbolic link foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Invalid symlink foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Alternate background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Selected foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Selected background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Alternate selected background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Current foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Selected current foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Current background</guilabel> + </para> + </listitem> + </itemizedlist> + <para>The following items of the + &synchronizer-lnk; can be configured:</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Equals foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Equals background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Differing foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Differing background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Copy to left foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Copy to left background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Copy to right foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Copy to left background</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Delete foreground</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Delete background</guilabel> + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Preview</guilabel> + </term> + <listitem> + <para>Here you see a preview of the configured + colors.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Color schemes</guilabel> + </term> + <listitem> + <para>With the + <guibutton>Import Color Scheme</guibutton> and + <guibutton>Export Color Scheme</guibutton> buttons you can + load and save a Color Scheme profile. This allows + &krusader; to use &tcmd;, + &mc;, foo-commander or your own custom color + profile. The Color Schemes are stored in + <filename>$KDEDIR/share/apps/krusader</filename>, the + <filename>foo.color</filename> is a binary file that holds + the color scheme.</para> + <tip> + <para>&mc; and &tcmd; Color + scheme files are provided. Please + <link linkend="help_krusader">upload your favorite + Color schemes</link> so that they become available for + the &krusader; community. Thanks!</para> + </tip> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="konfig-general"> + <title>General</title> + <para>Here you configure the basic operations.</para> + <!-- OLD +<screenshot> + <screeninfo>General configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kggeneral.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kggeneral.png" format="EPS"/></imageobject> + <textobject><phrase>General configuration</phrase></textobject> + <caption><para>General configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kggeneral" float="1"> +<title>General configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kggeneral.png"/></imageobject> +<textobject><phrase>General configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <para>The following options determine basic aspects of + operation: + <itemizedlist> + <listitem> + <para> + <guilabel>Delete files/Move to trash</guilabel>: when + &krusader; deletes files it can either 'really' + delete them or move them to the trash folder, thereby + making them available via &kde;'s trash.</para> + </listitem> + <listitem> + <para> + <guilabel>Use mimetype magic</guilabel>: mime type magic is + a mechanism which allows &krusader; to inspect + the files in the panels and determine their type even if + the file has no identifying extension. For example, if you + take an image file - 'image1.jpg' - and rename it to + 'image1', &krusader; will still know it's an + image file and work with it accordingly. However, this mode + of operation is slower (while refreshing the panel, or + changing directories), so try &krusader; with + and without mime type magic and decide what is best for + you.</para> + </listitem> + <listitem> + <para> + <guilabel>Editor</guilabel>: choose what editor will be + used when editing a file (via F4).</para> + </listitem> + <listitem> + <para> + <guilabel>Default viewer mode</guilabel>: either generic, + text or hex mode.</para> + </listitem> + <listitem> + <para> + <guilabel>Viewer opens each file in a separate + window</guilabel>: you can use the browsing tabs for + navigation.</para> + </listitem> + <listitem> + <para> + <guilabel>Atomic extensions</guilabel>: predefined atomic extensions like <filename>tar.gz</filename> + are shown as one part in the <guilabel>Ext Column</guilabel> of the &list-panel-lnk;.</para> + </listitem> + <listitem> + <para> + <guilabel>Terminal</guilabel>: choose which terminal + emulator will be used when &krusader; opens a + console window (via F2, or Commands->Terminal + menu option).</para> + </listitem> + <listitem> + <para> + <guilabel>Terminal Emulator sends Chdir on a panel + change</guilabel>: if unchecked, there will be no + <command>cd</command> command sent to the Terminal Emulator + if the panel folder changes.</para> + </listitem> + <listitem> + <para> + <guilabel>Temp Directory</guilabel>: this option selects + the base directory for &krusader;'s temporary + files. The actual files will be created in separate + directories under the 'Temp directory', so that each user + running &krusader; will have their own temporary + subdirectories under the chosen directory. + <note> + <para>You must choose a temporary directory to which all + users running &krusader; have full + permissions!</para> + </note></para> + </listitem> + </itemizedlist></para> + </sect1> + <sect1 id="konfig-advanced"> + <title>Advanced</title> + <para>This page handles more advanced issues, so you should + double-check your actions here: modifying settings here + <remark>makes &krusader; a more powerful AND + dangerous tool.</remark></para> + <!-- OLD +<screenshot> + <screeninfo>Advanced configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgadvanced.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgadvanced.png" format="EPS"/></imageobject> + <textobject><phrase>Advanced configuration</phrase></textobject> + <caption><para>Advanced configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kgadvanced" float="1"> +<title>Advanced configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kgadvanced.png"/></imageobject> +<textobject><phrase>Advanced configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <para>The page is divided into three parts:</para> + <variablelist> + <varlistentry> + <term> + <guilabel>General</guilabel> + </term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Preserve attributes for local copy/move + (slower)</guilabel>: If checked, + &krusader; will try to preserve all + attributes (time, owner, group) of the local files + according to the source file depending on your + <link linkend="copying">permissions</link>.</para> + </listitem> + <listitem> + <para> + <guilabel>Automount filesystems</guilabel>: this + makes &krusader; try to mount a file system + before entering it. For example, if you click on + <filename class="directory">/mnt/cdrom</filename> (and + <filename class="directory"> + /mnt/cdrom</filename> appears in + <filename class="directory">/etc/fstab</filename> as a + mount point), &krusader; will check if it + is mounted. If not, it will try and mount it for you + and then enter, so that you would see the contents of + your cdrom. Note, however, that &krusader; + will NOT unmount when exiting + <filename class="directory"> + /mnt/cdrom</filename>.</para> + </listitem> + <listitem> + <para> + <guilabel>Do not use KDE media protocol for the + Media button (if it is buggy or missing)</guilabel>: + If checked, &krusader; will not use + &kde; media protocol for the + <link linkend="list_panel">Media button</link>. + Choose this when the media protocol is buggy (in some + older &kde; versions) or if you have no + kdebase package installed on your system.</para> + </listitem> + <listitem> + <para> + <guilabel>MountMan will not (un)mount the following + mount points</guilabel>: If you have file systems that + you do not want to accidentally unmount (or mount) + then enter a list of mount points separated by commas + (⪚ + <literal>/, /boot, /tmp</literal>) and + &mountman-lnk; will not try to (un)mount + them.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Confirmations</guilabel> + </term> + <listitem> + <para>By checking the options in this section, + &krusader; will ask for confirmation before + doing a specific action; otherwise, the following actions + will be done without warning:</para> + <itemizedlist> + <listitem> + <para>deleting non empty directorie(s)</para> + </listitem> + <listitem> + <para>deleting file(s)</para> + </listitem> + <listitem> + <para>copying file(s)</para> + </listitem> + <listitem> + <para>moving file(s)</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <guilabel>Fine-Tuning</guilabel> + </term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Icon Cache Size</guilabel>: + &krusader; uses an icon cache, so it will not + have to reload icons that have been used before. Of + course, as the cache grows bigger, it can store more + icons and further speed operations, but the memory + footprint of &krusader; will become + bigger.</para> + </listitem> + <listitem> + <para> + <guilabel>Arguments of updatedb</guilabel>: sets + additional arguments for + <command>updatedb</command>, please read the manpages + for more information.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="konfig-archives"> + <title>Archives</title> + <para>This page handles the way &krusader; works + with archives. In the + <guilabel>General</guilabel> section you will see a list of + archive formats. Some are checked and some are grayed-out. The + ones that are available (not grayed-out) are supported by + &krusader;. If you check them, &krusader; + will handle the archives transparently and let you open them as + folders; otherwise, &krusader; will attempt to + invoke an application which opens archives of that type. If a + certain archive is grayed-out, it means that + &krusader; could not find the appropriate executables + in the configured path. The next archives are supported: ace, + arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and + 7-zip.</para> + <!-- OLD +<screenshot> + <screeninfo>Archives configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgarchives.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgarchives.png" format="EPS"/></imageobject> + <textobject><phrase>Archives configuration</phrase></textobject> + <caption><para>Archives configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kgarchives" float="1"> +<title>Archives configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kgarchives.png"/></imageobject> +<textobject><phrase>Archives configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <para>If you have installed a certain archive application (let's + say + <command>arj</command>) and want &krusader; to know + about it, just click the + <guibutton>Auto Configure</guibutton> button. + &krusader; will search for all supported executables + and print a report listing the archive formats that can be + handled. If the operation was successful the new archive should + be available and checked.</para> + <note> + <para>Please install new packagers to your + <envar>PATH</envar> (&ie;: + <filename>/usr/bin</filename> or + <filename>/usr/local/bin</filename> &etc;)</para> + </note> + <para>The full path of the packagers is stored in the + &konfigdependencie-lnk; (⪚ to handle + ZIP archives, &krusader; needs the + <command>unzip</command> and + <command>zip</command> executables). It is possible that you need + to manually configure the mimes to the protocols in the + &konfigprotocol-lnk;.</para> + <para> + <guilabel>Fine-Tuning</guilabel> + <itemizedlist> + <listitem> + <para> + <guilabel>Allow moving into archives</guilabel>: this + option allows you to move files into an archive (as + opposed to just copying into the archive). The down side + is that if a power failure occurs during the process, the + files that were moved might already be deleted, but not + yet packed into the archive. + <note> + <para>If such a thing happens, the file(s) are NOT + LOST. They were actually moved into a subfolder in + &krusader;'s + <link linkend="konfig-general">temp directory</link>. + You can search the directory and recover your + files.</para> + </note></para> + </listitem> + <listitem> + <para> + <guilabel>Test archives when finished packing</guilabel>: + this option automatically runs a test on a newly packed + archive. It is safer, but takes longer.</para> + </listitem> + </itemizedlist> + </para> + </sect1> + <sect1 id="konfig-dependencies"> + <title>Dependencies page</title> + <para>This page configures the full path of the external + applications. It is even possible to configure the full path of + &krusader;!</para> + <para> + <emphasis role="bold">General tab</emphasis> + </para> + <para>Here you can configure the full path of the following + external applications: + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>application</entry> + <entry>configurable full path</entry> + </row> + <row> + <entry> + <para> + <command>df</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/df</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>eject</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/eject</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>kdesu</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/kdesu</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>kget</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/kget</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>kmail</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/kmail</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para>diff utility</para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/kompare</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <command>krename</command> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/krename</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>krusader</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/krusader</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>locate</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/locate</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>mount</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/mount</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>umount</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/umount</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>updatedb</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/updatedb</replaceable> + </filename> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable></para> + <tip> + <para>By default &kompare; (part of the kdebase + package) is used as external diff utility but you can also + use your favorite diff utility ⪚ + &xxdiff-url; or &kdiff3-url;, just fill + in the full path and enjoy.</para> + </tip> + <para> + <emphasis role="bold">Packers tab</emphasis> + </para> + <para>Here you can configure the full path of the following + external packers. &krusader; also offers an + <link linkend="konfig-archives">auto configure tool</link> for + packagers. + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry>packer</entry> + <entry>configurable full path</entry> + </row> + <row> + <entry> + <para> + <command>7z</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>usr/bin/7z</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>arj</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>usr/bin/arj</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>bzip2</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>usr/bin/bzip2</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>cpio</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/cpio</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>dpkg</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/dpkg</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>gzip</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/gzip</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>lha</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/lha</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>rar</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/rar</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>tar</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/bin/tar</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>unace</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/unace</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>unarj</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/unarj</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>unrar</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/unrar</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>unzip</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/unzip</replaceable> + </filename> + </para> + </entry> + </row> + <row> + <entry> + <para> + <command>zip</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/zip</replaceable> + </filename> + </para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable></para> + <note> + <para>&krusader; may not be compatible with ACE despite our + best efforts. Unace uses closed source and contains + additional lines that make Unace get into infinite loop if + the stdin is redirected to somewhere else. It works in the + same manner as 'su', where you cannot enter the password only + from the stdin. &krusader; >= 1-51 + emulates the command line environment to enable co-operation + with Unace, but we have noticed that Unace always changes its + output format from release to release, making co-operation + almost impossible.</para> + </note> + <para> + <emphasis role="bold">Checksum Utilities tab</emphasis> + </para> + <para>Here you can configure the full path of the following + external + <link linkend="checksum">Checksum Utilities</link>: + <informaltable> + <tgroup cols="3"> + <tbody> + <row> + <entry>Checksum Utilities</entry> + <entry>configurable full path</entry> + <entry>supported checksums</entry> + </row> + <row> + <entry> + <para> + <command>md5sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/md5sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>md5</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha1sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha1sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha1</para> + </entry> + </row> + <row> + <entry> + <para> + <command>md5deep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/md5deep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>md5</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha1deep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha1deep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha1</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha224sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha224sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha224</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha256sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha256sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha256</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha256deep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha256deep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha256</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha384sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha384sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha384</para> + </entry> + </row> + <row> + <entry> + <para> + <command>sha512sum</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/sha512sum</replaceable> + </filename> + </para> + </entry> + <entry> + <para>sha512</para> + </entry> + </row> + <row> + <entry> + <para> + <command>tigerdeep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/tigerdeep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>tiger</para> + </entry> + </row> + <row> + <entry> + <para> + <command>whirlpooldeep</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/whirlpooldeep</replaceable> + </filename> + </para> + </entry> + <entry> + <para>whirlpool</para> + </entry> + </row> + <row> + <entry> + <para> + <command>cfv</command> + </para> + </entry> + <entry> + <para> + <filename class="directory"> + <replaceable>/usr/bin/cfv</replaceable> + </filename> + </para> + </entry> + <entry> + <para>md5, sha1, sfv, crc</para> + </entry> + </row> + </tbody> + </tgroup> + </informaltable></para> + </sect1> + <sect1 id="konfig-useractions"> + <title>UserActions</title> + <para>Here you can configure the terminal for UserActions and + the font for the output-collection. The default terminal is + <filename>konsole --noclose -e</filename>. To set up, configure + and manage your UserActions use ActionMan + (&useractions-lnk; url).</para> + <!-- OLD +<screenshot> + <screeninfo>Useractions configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kguseractions.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kguseractions.png" format="EPS"/></imageobject> + <textobject><phrase>Useractions configuration</phrase></textobject> + <caption><para>Useractions configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kguseractions" float="1"> +<title>Useractions configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kguseractions.png"/></imageobject> +<textobject><phrase>Useractions configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + </sect1> + <sect1 id="konfig-protocols"> + <title>Protocols</title> + <para>This page links the mimes to protocols. ⪚ + protocol "tar" is linked to mime "application/x-tar".</para> + <!-- OLD +<screenshot> + <screeninfo>Protocols configuration</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="kgprotocols.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="kgprotocols.png" format="EPS"/></imageobject> + <textobject><phrase>Protocols configuration</phrase></textobject> + <caption><para>Protocols configuration</para></caption> + </mediaobject> +</screenshot> +--> + <!--HTML_PARSING +<figure id="screenshot-kgprotocols" float="1"> +<title>Protocols configuration</title> +<mediaobject> +<imageobject><imagedata fileref="kgprotocols.png"/></imageobject> +<textobject><phrase>Protocols configuration</phrase></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + <para>In the + <guilabel>Defined Links</guilabel>you will see ⪚ + <itemizedlist> + <listitem> + <para>Iso</para> + <itemizedlist> + <listitem> + <para>application/x-iso</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>krarc</para> + <itemizedlist> + <listitem> + <para>application/x-ace</para> + </listitem> + <listitem> + <para>application/x-arj</para> + </listitem> + <listitem> + <para>application/x-bzip2</para> + </listitem> + <listitem> + <para>application/x-cpio</para> + </listitem> + <listitem> + <para>application/x-deb</para> + </listitem> + <listitem> + <para>application/x-debian-package</para> + </listitem> + <listitem> + <para>application/x-gzip</para> + </listitem> + <listitem> + <para>application/x-jar</para> + </listitem> + <listitem> + <para>application/x-lha</para> + </listitem> + <listitem> + <para>application/x-rar</para> + </listitem> + <listitem> + <para>application/x-rpm</para> + </listitem> + <listitem> + <para>application/x-zip</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>tar</para> + <itemizedlist> + <listitem> + <para>application/x-tar</para> + </listitem> + <listitem> + <para>application/x-tarz</para> + </listitem> + <listitem> + <para>application/x-tbz</para> + </listitem> + <listitem> + <para>application/x-tgz</para> + </listitem> + </itemizedlist> + </listitem> + </itemizedlist></para> + </sect1> +</chapter> diff --git a/doc/en/krusader-tools.docbook b/doc/en/krusader-tools.docbook new file mode 100644 index 0000000..70103b0 --- /dev/null +++ b/doc/en/krusader-tools.docbook @@ -0,0 +1,35 @@ +<chapter id="krusader-tools"> +<!-- ********************************************************************** + krusader-tools.docbook + ++++++++++++++++++++++++++ + (C)opyright : (C) 2000 - 2008 + All Rights Reserved Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> +<title>&krusader; Tools</title> + +<!-- call the bookmarks sect1 section --> &bookmarks; +<!-- call the diskusage sect1 section --> &diskusage; +<!-- call the java sect1 section --> &java; +<!-- call the search sect1 section --> &search; +<!-- call the viewer-editor sect1 section --> &viewer-editor; +<!-- call the locate sect1 section --> &locate; +<!-- call the mountman sect1 section --> &mount; +<!-- call the remote-connections sect1 section --> &remote-connections; +<!-- call the synchronizer sect1 section --> &synchronizer; +<!-- call the useractions sect1 section --> &krusader-useractions; + +</chapter> diff --git a/doc/en/locate.docbook b/doc/en/locate.docbook new file mode 100644 index 0000000..f920707 --- /dev/null +++ b/doc/en/locate.docbook @@ -0,0 +1,114 @@ +<sect1 id="locate"> + <title>Locate &GUI; Frontend</title> + <indexterm> + <primary>Locate</primary> + </indexterm> + <para>&krusader; has a &GUI; front end for + the + <command>locate</command> command (findutils). Locate is used for + fast file searching not from a directory but a database. The + package contains two files, + <command>locate</command> and + <command>updatedb</command>. Updatedb goes through the local + file system and stores the file entries in the database. + <command>cron</command> often calls + <command>updatedb</command> every night (set with Kcron). Choose + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>Locate</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Ctrl; + <keycap>L</keycap></keycombo> to start this feature. + <link linkend="konfig-advanced">Konfigurator</link> can set + additional arguments for + <command>updatedb</command>.</para> + <para>Checkbox Options + <itemizedlist> + <listitem> + <para> + <guilabel>Show only the existing files</guilabel>: if the + database contains entries which no longer exist any more + (deleted, moved since the last + <command>updatedb</command>), + <command>locate</command> does not list them. It checks the + existence of each file before the listing in the results + window (slow).</para> + </listitem> + <listitem> + <para> + <guilabel>Case Sensitive</guilabel>: unchecking it allows + lower and upper case search.</para> + </listitem> + </itemizedlist></para> + <para>Action buttons + <itemizedlist> + <listitem> + <para> + <guibutton>Locate</guibutton>: executes + <command>locate + <replaceable>foo foo</replaceable></command> and places its + output into the results window.</para> + </listitem> + <listitem> + <para> + <guibutton>Stop</guibutton>: stops the locating + process.</para> + </listitem> + <listitem> + <para> + <guibutton>UpdateDB</guibutton>: starts + <command>updatedb</command> for updating the locate database + after entering the root password.</para> + </listitem> + <listitem> + <para> + <guibutton>Close</guibutton>: closes the locate + window.</para> + </listitem> + </itemizedlist></para> + <para>Results window + <itemizedlist> + <listitem> + <para>Double-click on an item: steps to its directory, makes + the item visible and closes the locate dialog.</para> + </listitem> + <listitem> + <para>Right click: edits/views/finds the menu. + <itemizedlist> + <listitem> + <para> + <keycap>F3</keycap>: views the current item.</para> + </listitem> + <listitem> + <para> + <keycap>F4</keycap>: edits the current item.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo>: finds files in the results + window.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>n</keycap></keycombo>: shows the next search + result.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>p</keycap></keycombo>: shows the previous search + result.</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para> + The results window supports dragging items to other windows + and copy to clipboard (<keycombo action="simul">&Ctrl;<keycap>c</keycap></keycombo>).</para> + </listitem> + </itemizedlist></para> +</sect1> diff --git a/doc/en/more.docbook b/doc/en/more.docbook new file mode 100644 index 0000000..a5d097c --- /dev/null +++ b/doc/en/more.docbook @@ -0,0 +1,65 @@ +<chapter id="more-features"> +<!-- ********************************************************************** + 4 more.docbook + 5 +++++++++++++++++++++++++++ + 6 copyright : (C) 2000 - 2008 + 7 Rafi Yanai, Shie Erlich, Frank Schoolmeesters + 8 & the Krusader Krew + 9 e-mail : [email protected] + 10 web site : http://www.krusader.org + 11 description : a Krusader Documentation File + 12 + 13 *************************************************************************** + 14 * Permission is granted to copy, distribute and/or modify this * + 15 * document under the terms of the GNU Free Documentation License, * + 16 * Version 1.1 or any later version published by the Free Software * + 17 * Foundation; with no Invariant Sections, no Front-Cover Texts and * + 18 * no Back-Cover Texts. A copy of the license is available on the * + 19 * GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * + 20 * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * + 21 * MA 02110-1301, USA. * + 22 *********************************************************************** --> +<title>Advanced functions</title> +<!-- call the vfs sect1 section --> +&vfs; +<!-- call the compare sect1 section --> +&compare; +<!-- call the occupied space sect1 section --> +&occupied-space; +<!-- call the splitter sect1 section --> +&splitter; +<!-- call the checksum sect1 section --> +&checksum; +<sect1 id="send-email"> + <title>Send Files by e-mail</title> + <para>Select a file and use + <emphasis role="bold"> + <menuchoice> + <guimenu>Right-Click menu</guimenu> + <guimenuitem>Send by Email</guimenuitem> + </menuchoice> + </emphasis>. Selecting this option will open a new + &kmail; window with the file already attached. Just + fill in the subject and recipient(s) and send it. Of course, + &kmail; must be properly configured.</para> +</sect1> +<!-- call the profiles sect1 section --> +&profiles; +<sect1 id="acl"> + <title>ACL permissions</title> + <para> + <link linkend="gloss-acl">ACL permissions</link> are fully + supported when using properties, preserve attributes and the + synchronizer. To view/modify the ACL permissions, select a file + and use the &context-menu-lnk;: + <emphasis role="bold"> + <menuchoice> + <guimenu>Properties</guimenu> + <guimenuitem>Permissions</guimenuitem> + <guimenuitem>Advanced permissions</guimenuitem> + </menuchoice> + </emphasis>. At Copy/Move if + <guilabel>preserve attributes</guilabel> are selected, the ACL + permissions are also copied. The synchronizer keeps the ACL + permissions as well.</para> +</sect1></chapter> diff --git a/doc/en/mount.docbook b/doc/en/mount.docbook new file mode 100644 index 0000000..72b505d --- /dev/null +++ b/doc/en/mount.docbook @@ -0,0 +1,80 @@ +<sect1 id="mount-man"> + <title>MountMan: work with your mounted file systems</title> + <indexterm> + <primary>Mount</primary> + </indexterm> + <para>MountMan is a tool which helps you manage your mounted + file systems. Once invoked, it displays a list of every mounted + file system. For each file system, MountMan displays its name + (which is the actual device name - &ie; + <filename class="directory">/dev/fd0</filename> for a + <hardware>floppy</hardware>), its type (vfat, ext3, ReiserFS ...) + and its mount point on your system (the directory on which the + file system is mounted).</para> + <!-- OLD +<screenshot> + <screeninfo>MountMan</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="mountman.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="mountman.png" format="EPS"/></imageobject> + <textobject><phrase>MountMan</phrase></textobject> + <caption><para>MountMan</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-mountman" float="1"> + <title>MountMan</title> + <mediaobject> + <imageobject> + <imagedata fileref="mountman.png"></imagedata> + </imageobject> + <textobject> + <phrase>MountMan</phrase> + </textobject> + </mediaobject> + </figure> + <para>MountMan also displays usage information using total size, + free size, and percentage of available space free. If those + numbers say + <guilabel>N/A</guilabel>, that usually means that the file system + is not mounted. Left clicking on a file system displays a pie chart + on the left of the window, graphically displaying the usage + information for the file system. Clicking on a non-mounted + file system will display + <guilabel>not mounted</guilabel> instead of the graph.</para> + <itemizedlist> + <listitem> + <para> + <keycap>Double-clicking</keycap> on a file system will close + MountMan and open that file system inside + &krusader;'s active panel.</para> + </listitem> + <listitem> + <para> + <keycap>Right-clicking</keycap> on a file system will open a + small menu which displays what actions can be performed on + that file system. At the moment, you can only mount, unmount + and eject (if clicking on a removable file system, e.g., a + <hardware>cdrom</hardware>).</para> + </listitem> + </itemizedlist> + <note> + <para>We plan to expand MountMan in the next evolution of + &krusader;. It will be able to format floppies, edit + <filename class="directory">/etc/fstab</filename>, create new + file systems and more.... By the way, we have started working on + it, see "Quickmode for MountMan"</para> + </note> + <para> + <emphasis role="bold">Quickmode for MountMan</emphasis> + </para> + <para>To activate Quickmode for MountMan, click and hold the + MountMan button on the &main-toolbar-lnk;</para> + <para>General idea: display a list of all possible mount points. + Each time the menu is displayed, it determines if a mount point is + mounted or not and associates the correct action (mount or + umount). This offers a quick interface to MountMan. It is + working, and currently uses KMountMan::mount and unmount. It uses + the new &kde; services for fstab-reading and this will + enable us to remove a lot of code from the "old" MountMan.</para> +</sect1> diff --git a/doc/en/mouse.docbook b/doc/en/mouse.docbook new file mode 100644 index 0000000..9cfb6fb --- /dev/null +++ b/doc/en/mouse.docbook @@ -0,0 +1,45 @@ +<chapter id="mouse-commands"> + <!-- ********************************************************************** + mouse.docbook + ++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Mouse Commands</title> + <indexterm> + <primary>Commands</primary> + <secondary>Mouse</secondary> + </indexterm> + <sect1 id="mouse-usage"> + <title>Mouse Usage</title> + <para>In this chapter you will be guided in using + &krusader; effectively with a mouse and to configure + mouse gestures through KHotKeys. By simply clicking the mouse + you can select different sections of &krusader;. + Another chapter describes the selection modes, and how you can + configure them: + <link linkend="konfig-selection_modes">Selection Mode</link> +</para> + </sect1> + <sect1 id="mouse_gestures"> + <title>Mouse Gestures</title> + <para>We provide online a + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1392"> + Mouse Gestures howto</ulink> that explains how to use KHotKeys + mouse gestures with &krusader;.</para> + </sect1> +</chapter> diff --git a/doc/en/occupied-space.docbook b/doc/en/occupied-space.docbook new file mode 100644 index 0000000..6d80921 --- /dev/null +++ b/doc/en/occupied-space.docbook @@ -0,0 +1,45 @@ +<sect1 id="calculate"> + <title>Calculate Occupied Space</title> + <indexterm> + <primary>Occupied Space</primary> + </indexterm> + <!-- Thanks to Heiner Eichmann --> + <para>There are two ways to calculate the occupied space of + files/directories. + <itemizedlist> + <listitem> + <para>Pressing the + <keycap>SPACE</keycap> on a directory under the cursor + instantly calculates the occupied size. Pressing + <keycap>SPACE</keycap> a second time will toggle the selection + of the directory without affecting the selection status of + other files/directories.</para> + </listitem> + <listitem> + <para>To calculate how much disk space is occupied by the + selected files and directories in the active panel select + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Calculate Occupied Space</guimenuitem> + </menuchoice> + </emphasis>. After a small delay, a dialog box will be + displayed with total occupied space and the number of files + and directories you selected. The space occupied by every + selected directory will be shown as if the user just pressed + <keycap>SPACE</keycap> on those directories. If the active + panel is browsing an archive, the numbers will apply to the + unpacked size of the selected files and directories, not + their compressed size. After the calculation the selection + state will be toggled and the cursor will move one step + downwards.</para> + </listitem> + </itemizedlist>Calculating the occupied space on remote + file systems is supported. + <note> + <para>Performing this operation on a very large file system + (thousands of files) may be time-consuming. You can cancel the + calculation process at any time by clicking the + <guibutton>Cancel</guibutton> button.</para> + </note></para> +</sect1> diff --git a/doc/en/profiles.docbook b/doc/en/profiles.docbook new file mode 100644 index 0000000..253502b --- /dev/null +++ b/doc/en/profiles.docbook @@ -0,0 +1,57 @@ +<sect1 id="profiles"> + <title>Profiles</title> + <indexterm> + <primary>Profiles</primary> + </indexterm> + <para>With profiles you can save and restore your favorite + settings. Several features support profiles, you can have + ⪚ different panel profiles (work, home, remote + connections, &etc;), search profiles, synchroniser + profiles, &etc;</para> + <sect2 id="panel_profiles"> + <title>Panel Profiles</title> + <para>A panel profile contains the following: all the tab + paths (left or right), the current tab (left of right) and the + active panel (left or right). All this information is stored in + the &krusaderrc-lnk; file. You can have several + panel profiles, ⪚ file management, FTP + management, home, work, &etc; The panel profile can + be + <link linkend="c_panel_profiles">saved and restored</link> in + the + <guimenu>Commands menu</guimenu>. The + <link linkend="konfig-startup">default startup + profile</link> will be used when starting &krusader;, but you can + override it with a + <link linkend="starting-krusader">command-line + option</link>.</para> + </sect2> + <sect2 id="color_profiles"> + <title>Color Profiles</title> + <para>Colormaps can be saved and restored with + <link linkend="konfig-color">Color Profiles</link>. + &krusader; Color maps are available at + &kde-files-url;.</para> + </sect2> + <sect2 id="key_profiles"> + <title>Key-binding Profiles</title> + <para>Keymaps can be saved and restored with + <link linkend="configure-shortcuts">Key-binding + Profiles</link>. &krusader; Keymaps are available at + &kde-files-url;.</para> + </sect2> + <sect2 id="search_profiles"> + <title>Search Profiles</title> + <para>If you regularly perform the same search operation, + you can save the search settings (⪚ include + files, exclude files, &etc;) in a + <link linkend="krusearcher">Search Profile</link>.</para> + </sect2> + <sect2 id="synchronizer_profiles"> + <title>Synchronizer Profiles</title> + <para>If you regularly perform the same synchronize + operation, you can save the synchronize settings in a + <link linkend="synchronizer">Synchronizer + Profile</link>.</para> + </sect2> +</sect1> diff --git a/doc/en/release-overview.docbook b/doc/en/release-overview.docbook new file mode 100644 index 0000000..2ffd4de --- /dev/null +++ b/doc/en/release-overview.docbook @@ -0,0 +1,647 @@ +<appendix id="release_overview"> + <!-- ********************************************************************** + release-overview.docbook + ++++++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Release overview</title> + <indexterm> + <primary>Release overview</primary> + </indexterm> + <para>This appendix gives an overview of the + &krusader; releases.</para> + <table id="release_overview_table" pgwide="1" frame="all"> + <title>Release overview</title> + <tgroup cols="3" colsep="1" rowsep="1"> + <thead> + <row> + <entry> + <para>&krusader; version</para> + </entry> + <entry> + <para>release date</para> + </entry> + <entry> + <para>&kde; version</para> + </entry> + </row> + </thead> + <tbody> + <row> + <entry> + <para>2.00.0-beta1 "Phoenix"</para> + </entry> + <entry> + <para>2008-??-?? under construction</para> + </entry> + <entry> + <para>&kde; 4</para> + </entry> + </row> + <row> + <entry> + <para>1.90.0 "Power Stone"</para> + </entry> + <entry> + <para>2008-03-?? under construction</para> + </entry> + <entry> + <para>&kde; 3.2 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1968"> + 1.80.0 "Final 3rd Stone"</ulink></para> + </entry> + <entry> + <para>2007-07-21</para> + </entry> + <entry> + <para>&kde; 3.4 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1928"> + 1.80.0-beta2 "Last Unstable Stone"</ulink> + </para> + </entry> + <entry> + <para>2007-03-31</para> + </entry> + <entry> + <para>&kde; 3.4 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1862"> + 1.80.0-beta1 "The Last Krusade"</ulink> + </para> + </entry> + <entry> + <para>2007-01-07</para> + </entry> + <entry> + <para>&kde; 3.4 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1665"> + 1.70.1 "Round Robin"</ulink> + </para> + </entry> + <entry> + <para>2006-07-17</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1465"> + 1.70.0 "Round Robin"</ulink> + </para> + </entry> + <entry> + <para>2006-02-12</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1378"> + 1.70.0-beta2 "Afterburner"</ulink> + </para> + </entry> + <entry> + <para>2005-11-05</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1323"> + 1.70.0-beta1 "Hellfire"</ulink> + </para> + </entry> + <entry> + <para>2005-10-02</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.5</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1368"> + 1.60.1</ulink> + </para> + </entry> + <entry> + <para>2005-10-30</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.4</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1158"> + 1.60.0</ulink> + </para> + </entry> + <entry> + <para>2005-04-10</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.4</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1142"> + 1.60.0-beta2</ulink> + </para> + </entry> + <entry> + <para>2005-03-21</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.4</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1123"> + 1.60.0-beta1</ulink> + </para> + </entry> + <entry> + <para>2005-03-03</para> + </entry> + <entry> + <para>&kde; 3.3 - 3.4</para> + </entry> + </row> + <row> + <entry> + <para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=989"> + 1.51</ulink> + </para> + </entry> + <entry> + <para>2004-12-14</para> + </entry> + <entry> + <para>&kde; 3.2 - 3.3</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20050104203627/krusader.sourceforge.net/news.php"> + 1.50</ulink></para> + </entry> + <entry> + <para>2004-10-31</para> + </entry> + <entry> + <para>&kde; 3.2 - 3.3</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20050104203627/krusader.sourceforge.net/news.php"> + 1.50-beta1</ulink></para> + </entry> + <entry> + <para>2004-10-17</para> + </entry> + <entry> + <para>&kde; 3.2 - 3.3</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20050104203627/krusader.sourceforge.net/news.php"> + 1.40</ulink></para> + </entry> + <entry> + <para>2004-07-20</para> + </entry> + <entry> + <para>&kde; 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20050104203627/krusader.sourceforge.net/news.php"> + 1.40-beta2</ulink></para> + </entry> + <entry> + <para>2004-06-22</para> + </entry> + <entry> + <para>&kde; 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.40-beta1</ulink></para> + </entry> + <entry> + <para>2004-04-11</para> + </entry> + <entry> + <para>&kde; 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.30</ulink></para> + </entry> + <entry> + <para>2003-11-14</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.29-beta1</ulink></para> + </entry> + <entry> + <para>2003-10-02</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.25-beta1</ulink></para> + </entry> + <entry> + <para>2003-08-15</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.21-beta1</ulink></para> + </entry> + <entry> + <para>2003-07-18</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.20</ulink></para> + </entry> + <entry> + <para>2003-05-31</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.12-beta2</ulink></para> + </entry> + <entry> + <para>2003-05-09</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry><para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.12-beta1</ulink></para> + </entry> + <entry> + <para>2002-12-23</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20030417031038/krusader.sourceforge.net/index.php?nav=news.php"> + 1.11</ulink></para> + </entry> + <entry> + <para>2002-10-17</para> + </entry> + <entry> + <para>&kde; 3.0 - 3.2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 1.10</ulink></para> + </entry> + <entry> + <para>2002-08-15</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 1.02 (first KDE3 version)</ulink></para> + </entry> + <entry> + <para>2002-04-16</para> + </entry> + <entry> + <para>&kde; 3</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 1.01</ulink></para> + </entry> + <entry> + <para>2002-04-01</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 1.00</ulink></para> + </entry> + <entry> + <para>2002-01-01</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.99</ulink></para> + </entry> + <entry> + <para>2001-12-01</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.98</ulink></para> + </entry> + <entry> + <para>2001-10-27</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.97</ulink></para> + </entry> + <entry> + <para>2001-10-08</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.95</ulink></para> + </entry> + <entry> + <para>2001-07-22</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.93</ulink></para> + </entry> + <entry> + <para>2001-05-31</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.92</ulink></para> + </entry> + <entry> + <para>2001-05-17</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.91</ulink></para> + </entry> + <entry> + <para>2001-05-10</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.90</ulink></para> + </entry> + <entry> + <para>2001-04-30</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.79</ulink></para> + </entry> + <entry> + <para>2001-02-25</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.75</ulink></para> + </entry> + <entry> + <para>2000-01-12</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.70 (milestone 3)</ulink> + </para> + </entry> + <entry> + <para>2000-11-07</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.69</ulink> + </para> + </entry> + <entry> + <para>2000-10-28</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20020126214102/http://krusader.sourceforge.net/"> + 0.65</ulink> + </para> + </entry> + <entry> + <para>2000-08-19</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20000822030717/krusader.sourceforge.net/news.htm"> + 0.60</ulink></para> + </entry> + <entry> + <para>2000-07-19</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20000822030717/krusader.sourceforge.net/news.htm"> + M2 (milestone 2)</ulink> + </para> + </entry> + <entry> + <para>2000-07-11</para> + </entry> + <entry> + <para>&kde; 2</para> + </entry> + </row> + <row> + <entry> + <para>M1 (milestone 1)</para> + </entry> + <entry> + <para>2000-05-??</para> + </entry> + <entry> + <para>&kde; 2 (Kleopatra 1.91)</para> + </entry> + </row> + <row> + <entry> + <para><ulink url="http://web.archive.org/web/20000822030717/krusader.sourceforge.net/news.htm"> + Project began</ulink></para> + </entry> + <entry> + <para>2000-04-30</para> + </entry> + <entry> + <para>Kleopatra 1.91</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + <para>Note: older 0.x beta releases are not included in this + table.</para> +</appendix> diff --git a/doc/en/remote-connections.docbook b/doc/en/remote-connections.docbook new file mode 100644 index 0000000..5feb168 --- /dev/null +++ b/doc/en/remote-connections.docbook @@ -0,0 +1,267 @@ +<sect1 id="remote-connections"> + <title>Remote Connections</title> + <indexterm> + <primary>Remote Connections</primary> + </indexterm> + <para>Remote connections are easily made by typing the + &URL; in the + <link linkend="list_panel">Location Toolbar</link>; these are + actually &kioslaves1-url;. Please note that the + &krusader; panel does not support all + &kioslaves2-url; ⪚ + <command>http://</command> will not work in the panel, but will + work in the + <link linkend="krviewer">viewer</link>. Some examples:</para> + <itemizedlist> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>public.ftpserver.org/directory/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>fish://</command><replaceable>username@hostname/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>sftp://</command><replaceable>username:[email protected]/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>[email protected]:21/directory/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>smb://</command><replaceable>username:password@server/share</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>ftp://</command><replaceable>username@proxyusername:password@proxipassword@hostname/directory</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>nfs://</command><replaceable><host>:<port><url-path></replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>webdav://</command><replaceable>www.server.com/path/</replaceable> + </userinput> + </para> + </listitem> + </itemizedlist> + <para>You can bookmark these &URL;'s, however, please + read the + <link linkend="bookman">Bookman</link> section regarding + <emphasis>securely save passwords</emphasis>. For connecting to + multiple locations, bookmark these &URL;'s and open + them one by one, or open them all together by using + &panel-profiles-lnk;. To switch from one to another + location, just open a &foldertabs-lnk; for + each.</para> + <para>There are three ways to start a remote connection: + <itemizedlist> + <listitem> + <para>Type the &URL; in the + <link linkend="list_panel">Location Toolbar</link></para> + </listitem> + <listitem> + <para>Select + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>New Net Connection</guimenuitem> + </menuchoice> + </emphasis>which will pop-up a dialog that will ask for the + remote site details. This dialog is handy if you are not used + to type remote &URL;'s in the Location Toolbar. + Leaving the password and user name fields empty will log you + in as anonymous. NOTE: we are planning to rewrite this dialog + window.</para> + </listitem> + <listitem> + <para>You can bookmark a directory on a remote host and + return to this directory from the bookmark button on the top + corner of your panel just like in a web browser.</para> + </listitem> + </itemizedlist></para> + <para>After you log on to a remote server you can browse it just + like your local hard drive with the following exceptions: + <itemizedlist> + <listitem> + <para>You cannot execute files on remote servers.</para> + </listitem> + <listitem> + <para>Permissions cannot always be calculated on remote + servers (depends on server and access method) so you might + get a "?" on the permissions columns for some files.</para> + </listitem> + <listitem> + <para>Disk usage information is not available for most remote + filesystems.</para> + </listitem> + </itemizedlist></para> + <para>To change the charset of the remote host use + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>Select Remote Charset</guimenuitem> + </menuchoice> + </emphasis>.</para> + <para>You can + <emphasis role="bold">close the current Active Remote + Connection</emphasis> by two separate methods: + <itemizedlist> + <!-- + <listitem> + <para>Manually: <emphasis role="bold"><menuchoice><guimenu>Commands</guimenu> + <guimenuitem>Disconnect From Net</guimenuitem></menuchoice></emphasis></para> + </listitem> + --> + <listitem> + <para>Manually: Add the disconnect button to the + &main-toolbar-lnk; and click on it.</para> + </listitem> + <listitem> + <para>Automatically: Change the &URL; in the + &location-toolbar-lnk; .</para> + </listitem> + </itemizedlist></para> + <note> + <para>&krusader; is a file manager that supports + remote connections via &kioslaves1-url;, but if you + are looking for even more advanced remote connections features, + ⪚ an advanced &FTP;-client we + recommend you to use ⪚ + &kasablanca-url; or + &kftpgrabber-url;.</para> + </note> + +<sect2 id="remote-connections-lan-fish"> + <title>LAN connections via fish:/ protocol (zeroconf)</title> + <indexterm> + <primary>Remote LAN Connections (zeroconf)</primary> + </indexterm> + +<para>This section is contributed by + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1912">Andrew Svet (z-vet)</ulink>, + feedback about this chapter is appriciated. Thanks!</para> + + <note> + <para>This works on a &debian; system, so it will work on &debian; and derivatives (&kubuntu; &etc;), though + it should work on other Linuxes as well. + We assume that you have <link linkend="gloss-ssh">SSH</link> installed, configured and working on + every machine on LAN you want to connect to/from. + There are plenty of very good tutorials about <link linkend="gloss-ssh">SSH</link> on the net, ⪚ + at <ulink url="http://www.linuxhomenetworking.com/wiki/index.php/Quick_HOWTO_:_Ch17_:_Secure_Remote_Logins_and_File_Copying">linuxhomenetworking.com</ulink> + or just google for it. We use the default <link linkend="gloss-ssh">SSH</link> port (22) for this chapter. + Remember to change it if you use different one. All modifications, editing &etc; must be done as root. + </para> + </note> + +<para> +Let's start with installing all the packages we need: +<screen> +<prompt>#</prompt> <userinput><command>apt-get install</command> <option>avahi-daemon libnss-mdns kdnssd</option></userinput> +</screen> + +Everything is installed, now let's do some configuration. First, we need our services to be announced on LAN. +That's why we installed avahi-daemon: it represents your machine on local network and allows other applications +to publish services they provide. Avahi-daemon comes with example <filename>ssh.service</filename> configuration +file found in <filename>/usr/share/doc/avahi-daemon/examples</filename> . In order to get the service to be +announced on LAN we need to copy this file to <filename>/etc/avahi/services</filename> directory: +<screen> +<prompt>#</prompt> <userinput><command>cp</command> <option>/usr/share/doc/avahi-daemon/examples/ssh.service /etc/avahi/services</option></userinput> +</screen> + +Now we need fish:/ protocol to be announced too, so we use an ssh.service file as a template for fish.service: +<screen> +<prompt>#</prompt> <userinput><command>cp</command> <option>/etc/avahi/services/ssh.service /etc/avahi/services/fish.service</option></userinput> +</screen> + +This file is just a copy of ssh.service, Edit the <filename>fish.service</filename> file and replace +"Remote Terminal on %h" with "Fish to %h" and "_ssh._tcp" with "_fish._tcp". + +Here's how it looks after edit: +<programlisting> +<?xml version="1.0" standalone='no'?><!--*-nxml-*--> +<!DOCTYPE service-group SYSTEM "avahi-service.dtd"> + +<!-- $Id: remote-connections.docbook,v 1.6 2007/05/02 18:07:28 codeknight Exp $ --> + +<!-- + This file is part of avahi. + + avahi is free software; you can redistribute it and/or modify it + under the terms of the GNU Lesser General Public License as + published by the Free Software Foundation; either version 2 of the + License, or (at your option) any later version. + + avahi is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR + +<!-- See avahi.service(5) for more information about this configuration file --> + +<service-group> + + <name replace-wildcards="yes">FISH to %h</name> + + <service> + <type>_fish._tcp</type> + <port>22</port> + </service> + +</service-group> +</programlisting> +Save the modified file. + +Now we need to create a new file <filename>_fish._tcp</filename>, open a text editor and add the next lines: +<programlisting> +Name=FISH Protocol (ssh) +Type=_fish._tcp +UserEntry=u +PathEntry=path +PasswordEntry=p +</programlisting> +And save the file <filename>/usr/share/apps/zeroconf/_fish._tcp</filename> + +Do the same on each machine on your LAN, then restart avahi-daemon: +<screen> +<prompt># /etc/init.d/</prompt> <userinput><command>avahi-daemon</command> <option>restart</option></userinput> +</screen> + +Than open &krusader; and type in location-toolbar-lnk: <filename>zeroconf:/</filename> to open the +<link linkend="gloss-zeroconf">zeroconf</link> connection. +Enter the <guilabel>Fish Protocol</guilabel> directory. Inside you'll find the links to each machine that +announced <filename>fish:/</filename> on your LAN, the location-toolbar-lnk: will point to +<filename>zeroconf:/_fish._tcp</filename> Double clicking on any of these machines, +them will bring up the password prompt, asking you for yor ssh key passphrase (if password was set). +Enter your passphrase. Congratulations: you connected to remote machine using &krusader;! +</para> + +</sect2> + +</sect1> + + diff --git a/doc/en/search.docbook b/doc/en/search.docbook new file mode 100644 index 0000000..8a9d087 --- /dev/null +++ b/doc/en/search.docbook @@ -0,0 +1,328 @@ +<sect1 id="krusearcher"> + <title>KruSearcher: find what you are looking for</title> + <indexterm> + <primary>Search</primary> + </indexterm> + <para>Welcome to &krusader;'s powerful search module - + nicknamed KruSearcher. It is the most able tool (that we know of) + for &Linux;, since it allows so many different ways to + quickly find the file you are looking for. The search function is + also available on remote file systems. It is divided into two + levels, the general and the advanced. Let's take a look at the + general page.</para> + <!-- OLD +<screenshot> + <screeninfo>Krusearcher General</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="search_general.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="search_general.png" format="EPS"/></imageobject> + <textobject><phrase>Krusearcher General</phrase></textobject> + <caption><para>Krusearcher General.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-search-general" float="1"> + <title>General Search</title> + <mediaobject> + <imageobject> + <imagedata fileref="search_general.png"></imagedata> + </imageobject> + <textobject> + <phrase>General Search</phrase> + </textobject> + </mediaobject> + </figure> + <para>The page is divided into four parts: top (search for) part, + bottom part - titled 'containing text', left part - titled + 'search in' and right part which is called 'don't search in'. + Obviously, each part handles different aspects of the search. + Let's look at them closely.</para> + <itemizedlist> + <title>Top Part:</title> + <listitem> + <para> + <guilabel>Search for</guilabel>: here you enter the main + search criteria. You can enter a file name, a wildcard ( + <literal role="extension">*.o.*</literal>, + <literal role="extension">*.c</literal> &etc;) or + both - separated by a space. If you type + <literal>'text'</literal> the results is the same as + <literal>'*text*'</literal>. You can exclude files from the + search with '|' (⪚ + <literal role="extension">'*.cpp *.h | + *.moc.cpp'</literal>) . You can use quotation marks for names + that contain spaces. Filter "Program Files" searches + out those files/directories the name of which is <filename>Program + Files</filename>.</para> + </listitem> + <listitem> + <para> + <guilabel>Case sensitive</guilabel>: unchecking it will allow + lower and upper case search (&ie;: + <literal role="extension">*.c</literal> interprets as + <literal role="extension">*.c</literal> AND + <literal role="extension">*.C</literal>).</para> + </listitem> + <listitem> + <para> + <guilabel>Of type</guilabel>: this box lets you search for a + file not only by its name, but also by its mime type. For + example, you can search for all the audio files whose name + begins with B. Usually this option defaults to 'all files', + but you can choose to search for archives, directories, + images, text files, videos and audio files.</para> + </listitem> + </itemizedlist> + <itemizedlist> + <title>Left and Right Part:</title> + <listitem> + <para> + <guilabel>Search in</guilabel> and + <guilabel>Don't search in</guilabel>: Using those two parts, + you can specify a search exactly the way you want it. For + example, you might want to search for a file in the whole + file system (beginning with + <filename>/</filename>), but do not want to search inside + <filename>/mnt</filename>. All you need to do is write + <filename>/</filename> in the + <guilabel>search in</guilabel> box, and write + <filename>/mnt</filename> in the + <guilabel>dont search in</guilabel> box. If you want to enter + more than one directory in one of the boxes, just type the + first name and press &Enter;. The directory name + will be copied to the bigger box and youwill be able to enter + another name. + <note> + <para>The input line has an auto-completion feature, + corresponding to &kde; global settings. If you + wish, you can click on the + <guiicon>folder icon</guiicon>, and browse to the directory + you wish to add.</para> + </note></para> + </listitem> + </itemizedlist> + <itemizedlist> + <title>Bottom Part:</title> + <listitem> + <para> + <guilabel>Text</guilabel>: entering text here makes + &krusader; search for it inside the files ( + <command>grep</command>). This way you can search for all + header files ( + <literal role="extension">*.h</literal>) which include the + word + <literal>'testing 123'</literal>.</para> + </listitem> + <listitem> + <para> + <guilabel>Match whole word only</guilabel> + </para> + </listitem> + <listitem> + <para> + <guilabel>Case sensitive</guilabel>: refers to your text + being searched for in upper and lower case or the exact + phrase you entered.</para> + </listitem> + <listitem> + <para> + <guilabel>Search in subdirectories</guilabel>: perform a + recursive search and dive into every directory on the + way.</para> + </listitem> + <listitem> + <para> + <guilabel>Search in archives</guilabel>: + &krusader; will search for your files inside every + supported archive. This, however, takes longer to perform. + <note> + <para>If you check this checkbox, youwill notice you cannot + <command>grep</command> inside files anymore. This is done, + since looking inside archived files forces + &krusader; to extract them, which results in an + extremely time-consuming search.</para> + </note></para> + </listitem> + <listitem> + <para> + <guilabel>Follow links</guilabel>: if checked, + &krusader; will follow soft-links during the + search.</para> + </listitem> + <listitem> + <para> + <guilabel>Profiles</guilabel>: if you have to regularly + perform the same search operation, you can save the search + settings ⪚ include files, exclude files, + etc.... Press the 'profile' button, and you can + add/load/save/remove search profiles.</para> + </listitem> + </itemizedlist> + <para>The above screen shot shows a search for all the files which + end with + <literal role="extension">c, cpp</literal> or + <literal role="extension">h</literal> and include the string + <literal>'testing 123'</literal>. &krusader; will + search in + <filename class="directory">/root, /opt, /bin</filename> and + <filename class="directory">/usr</filename>, but not in + <filename class="directory">/usr/lib</filename> and + <filename class="directory">/usr/share</filename>.</para> + <para>Clicking the + <guibutton>Search</guibutton> button starts the search and + displays the results page. During the search, you may press the + <guibutton>Stop</guibutton> button to stop the search. The + <guibutton>Close</guibutton> button is not operational during a + search, so you must first stop the search and then + <guibutton>Close</guibutton> the window. When a result is found, + double-clicking on it will take &krusader;'s active + panel point to the found files - but will not close the search + window, so you will be able to click on a different result.</para> + <para>Sometimes, you need to narrow your search even more. + Krusearcher allows a much finer search, and for that, let's look + at the + <guilabel>Advanced Page</guilabel>...</para> + <!-- OLD +<screenshot> + <screeninfo>Krusearcher Advanced</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="search_advanced.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="search_advanced.png" format="EPS"/></imageobject> + <textobject><phrase>Krusearcher Advanced</phrase></textobject> + <caption><para>Krusearcher Advanced.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-search-advanced" float="1"> + <title>Advanced Search</title> + <mediaobject> + <imageobject> + <imagedata fileref="search_advanced.png"></imagedata> + </imageobject> + <textobject> + <phrase>Advanced Search</phrase> + </textobject> + </mediaobject> + </figure> + <para>This screen shot shows a search for files whose size is + between 10KB and 150KB, which were modified between October 10th + and November 1st, which belong to any user in the 'users' group, + and are readable and writable by anyone in the 'users' group, but + only readable to the rest of the world.</para> + <para>The advanced page is divided into three parts: size, date + and ownership.</para> + <para> + <emphasis role="bold">Size</emphasis> + </para> + <para>Allows you to choose the size range of the file you are + looking for. By checking the check boxes, you can search for a + file which is bigger than XXX bytes (or KB, MB), smaller than XXX + bytes or, by checking both search for a file which size is bigger + than XXX but smaller than YYY.</para> + <para> + <emphasis role="bold">Date</emphasis> + </para> + <para>This part offers three different ways of defining a date + criteria: + <itemizedlist> + <listitem> + <para> + <guilabel>Modified between</guilabel>: allows you to enter + two dates. &krusader; will search for files with a + modification date between the first date and the second one, + inclusive. If you only enter a date in the left box, you will + be searching for files older than that date. If you only + enter a date in the right box, you will be searching for files + newer than that date. + <note> + <para>You can click on the date icon (near the input boxes) + to open a standard date window - which allows you to easily + browse through the calendar and search for the desired + date. Clicking on a date will close the window and the date + will appear in the input box.</para> + </note></para> + </listitem> + <listitem> + <para> + <guilabel>Not modified after</guilabel>: choosing this option + makes &krusader; search for files that were NOT + modified after a given date, which is the same as searching + for files older than that date.</para> + </listitem> + <listitem> + <para> + <guilabel>Modified in the last/not modified in the + last</guilabel>: in these input boxes, you do not enter a date + but a number. This number represents days/weeks/months (as + chosen in the near drop box). Entering the number 5 in the + upper input box, makes &krusader; search for files + that were modified in the last 5 days. Entering the number 2 + in the lower input box makes &krusader; search for + files that did NOT change in the last 2 days. The combination + of both results in a search for files that were changed in + the last 5 days, but NOT in the last 2 days.</para> + </listitem> + </itemizedlist></para> + <para> + <emphasis role="bold">Ownership</emphasis> + </para> + <itemizedlist> + <listitem> + <para> + <guilabel>Belongs to user/group</guilabel>: by checking each + of the corresponding check boxes, you can search for files + which belong to a certain user and/or group. The drop box + lists all the user names and group names in the system, just + choose one and go ahead.</para> + </listitem> + <listitem> + <para> + <guilabel>Permissions</guilabel>: divided into owner, group + and all - it allows you to choose certain permissions for the + file. You can choose to specify permissions for the owner, + group, all or any combination. The question mark (?) is a + wildcard - which means that any permission is valid.</para> + </listitem> + </itemizedlist> + <note> + <para>To clarify, the screen shot above (the permissions part) + describes a search for files that belong to any user in group + 'users', are readable, writable but not executable to any user + in the group, are readable but not writable or executable to + the rest of the world and have unknown permissions to its + owner.</para> + </note> + <para> + <emphasis role="bold">Results</emphasis> + </para> + <para>Clicking on the + <guibutton>Search</guibutton> button to start the search and open + the Results window. Here you can see the progress and the the + results of the search action. If you want you can stop the + current search action with the + <guibutton>Stop</guibutton>button. In the result list select the + file and use + <keycap>F3</keycap>/ + <keycap>F4</keycap> to view/edit or use the right-click menu. When + you click on a found item, the directory of the active panel will + change if the selected item is not in the current panel + directory. The results window supports dragging items to other windows + and copy to clipboard (<keycombo action="simul">&Ctrl;<keycap>c</keycap></keycombo>). + When you close the Krusearcher window, the selected + item is selected in the active panel.</para> + <para> + <emphasis role="bold">Feed to listbox</emphasis> + </para> + <para>When you click the + <guibutton>Feed to listbox</guibutton> button after the results + are displayed, then &krusader; ask for a Query Name, + this name will be used in the Results-Tab in the List Panel that + holds the search results. You can do whatever you want on the + files in the new tab. The location toolbar will display + ⪚ + <filename>virt:/Search results 1</filename>.</para> + <warning> + <para>The files in the Results-Tab are actually the original + files. if you delete a file - it is removed!</para> + </warning> +</sect1> diff --git a/doc/en/splitter.docbook b/doc/en/splitter.docbook new file mode 100644 index 0000000..d554230 --- /dev/null +++ b/doc/en/splitter.docbook @@ -0,0 +1,61 @@ +<sect1 id="splitter"> + <title>File Splitter</title> + <indexterm> + <primary>File Splitter</primary> + </indexterm> + <para>This function splits one (large) file up into multiple + smaller files so that they can be placed on smaller media + (⪚ zip-drives, ...) or sent by e-mail. The multiple + files can be combined again to recreate the original file. + &krusader; and &tcmd; split/combine + functions are compatible. To split a file choose + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Split</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Ctrl; + <keycap>P</keycap></keycombo> A Split dialog will open to confirm + the operation.</para> + <para>If the name of the original file is + <filename>foo</filename>, then the name of the smaller files will + be + <filename>foo.000 foo.001 foo.002</filename> &etc; + There is no theoretical limit in the number of smaller files, but + it is recommended to limit the number to a maximum of 1023 files. + &krusader; creates a + <filename>foo.crc</filename> file. This file contains the name, + size and the crc checksum of the original file. It is possible to + combine the file without the + <filename>foo.crc</filename> file but in this case + &krusader; cannot check if the the original file was + recreated correctly.</para> + <para>An example of a + <filename>foo.crc</filename> file: + <programlisting>filename=foo size=432998467868 crc32=21EB719A</programlisting></para> + <para>To combine the multiple files choose, select a partial file + + <filename>foo.xxx</filename> and choose + <emphasis role="bold"> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Combine files</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Ctrl; + <keycap>B</keycap></keycombo>. The target directory is the + unactive panel and can be changed. The file names must be + numbered in ascending order: + <filename>foo.001, foo.002, foo.003</filename> &etc; or + have letters in ascending order: (" + <userinput> + <command>split</command> + <option>-b</option> + </userinput>letter method") + <filename>fileaa, fileab, fileac</filename> &etc; If + the file + <filename>foo.crc</filename> is found in the same directory as the + partial files, &krusader; will use this file to check + the combined file for errors.</para> +</sect1> diff --git a/doc/en/synchronizer.docbook b/doc/en/synchronizer.docbook new file mode 100644 index 0000000..c0f58f2 --- /dev/null +++ b/doc/en/synchronizer.docbook @@ -0,0 +1,730 @@ +<sect1 id="synchronizer"> + <title>Synchronizer</title> + <indexterm> + <primary>Synchronizer</primary> + </indexterm> + +<sect2 id="synchronizer_introduction"> + <title>Introduction</title> + <para>This function compares two directories with all subdirectories and shows the differences between them. + After selecting some options and the + <guilabel>Compare</guilabel> function you can synchronize the + files and directories. One panel could be an &FTP; + server. Do not forget the + <guilabel>Compare by content</guilabel> option if the file size + stays equal. Choose + <emphasis role="bold"> + <menuchoice> + <guimenu>Commands</guimenu> + <guimenuitem>Synchronize Directories</guimenuitem> + </menuchoice> + </emphasis>or + <keycombo action="simul">&Ctrl; + <keycap>Y</keycap></keycombo> to start this feature. The + <link linkend="konfig-color">colors</link> are + configurable.</para> + <note> + <para>For local files: The synchronizer changes the date + information to the original dates.</para> + </note> + <!-- OLD +<screenshot> + <screeninfo>Synchronizer</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="syncdir.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="syncdir.png" format="EPS"/></imageobject> + <textobject><phrase>Synchronizer: Synchronize files and directories.</phrase></textobject> + <caption><para>Synchronizer: Synchronize files and directories.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-syncdir" float="1"> + <title>Synchronizer</title> + <mediaobject> + <imageobject> + <imagedata fileref="syncdir.png"></imagedata> + </imageobject> + <textobject> + <phrase>Synchronizer</phrase> + </textobject> + </mediaobject> + </figure> + <para> + <orderedlist> + <title>Procedure:</title> + <listitem> + <para>Set the + <guilabel>Left directory</guilabel> and the + <guilabel>Right directory</guilabel> that you want to compare.</para> + </listitem> + <listitem> + <para>Configure the optional + <guilabel>File Filter</guilabel>, + <guilabel>General Filters</guilabel> and + <guilabel>Advanced filters</guilabel>. The + <guilabel>General Filters</guilabel> includes a + <guilabel>don't search in</guilabel> option which lets you + exclude directories from comparision.</para> + </listitem> + <listitem> + <para>Set the + <link linkend="synccomp_checkb_options">Checkbox + options</link>: + <guilabel>Recurse subdirectories</guilabel>, + <guilabel>Follow symlinks</guilabel>, + <guilabel>Compare by content</guilabel>, + <guilabel>Ignore Date</guilabel>, + <guilabel>Asymmetric</guilabel>, + <guilabel>Ignore Case</guilabel> and + <guilabel>Hidden hidden files</guilabel>. + </para> + </listitem> + <listitem> + <para>Click on the + <guibutton>Compare</guibutton> button to compare the + directories.</para> + </listitem> + <listitem> + <para>By using + <link linkend="synccomp_show_options">Show options</link>, + you can include/exclude particular file types. The files that + are not on the list will be untouched by + synchronization.</para> + </listitem> + <listitem> + <para>If needed, you can change the + <guilabel>Task</guilabel> operations determined by the + Comparator with the + <link linkend="synccomp_right-click">right click + menu</link>.</para> + </listitem> + <listitem> + <para>When you agree with the + <guibutton>Compare</guibutton> results, click on the + <guibutton>Synchronize</guibutton> button to show the + synchronize dialog.</para> + </listitem> + <listitem> + <para>After selecting the options of the + <link linkend="synchronizer">Synchronizer</link>, click on + the + <guibutton>Start</guibutton> button to start the + synchronization process.</para> + </listitem> + </orderedlist>A detailed explanation of all the functions and + buttons is described in the following text.</para> + +</sect2> + +<sect2 id="synchronizer_comparator"> + <title>Comparator</title> + + <variablelist> + <varlistentry> + <term>Panel elements</term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Left Directory</guilabel>: The left side base + directory.</para> + </listitem> + <listitem> + <para> + <guilabel>Right Directory</guilabel>: The right side + base directory.</para> + </listitem> + <listitem> + <para> + <guilabel>File Filter</guilabel>: Filters the filenames + at synchronizing. ⪚ + <literal role="extension">*.png</literal> selects only + files the names of which end with + <literal role="extension">.png</literal> Directories are + listed if the directory name ends with + <literal role="extension">.png</literal> or if the + directory contains files which end with + <literal role="extension">.png</literal> Multiple + include/exclude example: + <literal role="extension">'*.cpp *.h | + *.moc.cpp'</literal>includes + <literal role="extension">*.cpp *.h</literal> and + exclude + <literal role="extension">*.moc.cpp</literal></para> + </listitem> + <listitem> + <para> + <guilabel>General filters</guilabel>: Search for, + containing text</para> + </listitem> + <listitem> + <para> + <guilabel>Advanced filters</guilabel>: Size, date, + ownership</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term>Filename filtering criteria</term> + <listitem> + <itemizedlist> + <listitem> + <para>You can make use of wild cards. Multiple patterns + are separated by space (means logical OR) and patterns + are excluded from the search using the pipe symbol. If + the pattern is ended with a slash (*pattern*/), it + means that pattern relates to recursive search of + directories.</para> + </listitem> + <listitem> + <para>pattern - means to search those files/directories + whose name is a pattern, recursive search goes through + all subdirectories independently of the value of the + pattern.</para> + </listitem> + <listitem> + <para>pattern/ - means to search all files/directories, + but recursive search goes through/excludes the + directories whose name is a pattern.</para> + </listitem> + <listitem> + <para>You can use quotation marks for names + that contain spaces. Filter "Program Files" searches + out those files/directories the name of which is <filename>Program + Files</filename>.</para> + </listitem> + <listitem> + <para>Examples:</para> + </listitem> + <listitem> + <para> + <literal role="extension">*.o</literal> + </para> + </listitem> + <listitem> + <para> + <literal role="extension">*.h *.c??</literal> + </para> + </listitem> + <listitem> + <para> + <literal role="extension">*.cpp *.h | + *.moc.cpp</literal> + </para> + </listitem> + <listitem> + <para> + <literal role="extension">* | CVS/ .svn/</literal> + </para> + </listitem> + <listitem> + <para>Note: the search term 'text' is equivalent to + '*text*'.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry id="synccomp_checkb_options"> + <term>Checkbox options</term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Recurse subdirectories</guilabel>: The + Synchronizer walks through subdirectories when + comparing.</para> + </listitem> + <listitem> + <para> + <guilabel>Follow symlinks</guilabel>: The Synchronizer + follows the symbolic links to directories (not the + files!).</para> + </listitem> + <listitem> + <para> + <guilabel>Compare by content</guilabel>: The files + the sizes of which are equal will be compared by content as + well.</para> + </listitem> + <listitem> + <para> + <guilabel>Ignore Date</guilabel>: Ignores the date + information (useful for &FTP;, smb, archive, + ... ) the date information is relevant *only* in the + local file system.</para> + </listitem> + <listitem> + <para> + <guilabel>Asymmetric</guilabel>: The + <guilabel>Left Directory</guilabel> is the target + directory, the + <guilabel>Right Directory</guilabel> is the source + directory. This functions synchronizes the content of + the left directory to the right directory. + <itemizedlist> + <listitem> + <para>The files that exist only on the left side + will be deleted.</para> + </listitem> + <listitem> + <para>The files that exist only on the right side + will be copied to left.</para> + </listitem> + <listitem> + <para>The files considered to be equal will be + untouched.</para> + </listitem> + <listitem> + <para>Those files considered to be different will + be copied to left. Use this feature with + care!</para> + </listitem> + </itemizedlist>This function is useful if the date + information is unusable, or to synchronize the left + directory to the content of a file server (like a + download). Alternatively, it is useful to make a backup + from the right directory to the left directory. NOTE: + Do NOT use this option to synchronize a desktop and a + notebook (⪚ files that exist only on the + left side will be deleted!).</para> + </listitem> + <listitem> + <para> + <guilabel>Automatic Scrolling</guilabel>: This is for + slow &FTP; servers, ... When the + Synchronizer has finished comparing a file, it puts the + file into the end of the list at once and scrolls the + window, if necessary. It is important, if you want to + know what the Synchronizer is doing. If the + &FTP; server is slow, the comparison of a + directory may take a lot of time. By turning this + option on, you can see that the comparator is "alive", + but slow. For fast file systems, it can reduce the + speed of comparing slightly.</para> + </listitem> + <listitem> + <para> + <guilabel>Ignore Case</guilabel>: Case insensitive filename compare, + this is useful when synchronizing &Windows; filesystems.</para> + </listitem> + <listitem> + <para> + <guilabel>Ignore hidden files</guilabel>: Ignores files that start with a dot.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + <para>When everything mentioned above is done, click on the + <guibutton>Compare</guibutton> button to compare the directories, + the results are displayed in the <guilabel>File List</guilabel>.</para> + <variablelist> + <varlistentry> + <term>File List</term> + <listitem> + <para>The + <guilabel>File List</guilabel> has the following columns: + "Left name | Left size | Left time | Task | Right time | + Right size | Right name". + Here you can check the compare results and modify the synchronisation actions if desired. + The text color defines the default copy direction determined by the comparator. + <itemizedlist> + <listitem> + <para>Green: Copy from left to right.</para> + </listitem> + <listitem> + <para>Blue: Copy from right to left or delete on the right side in asymmetric mode.</para> + </listitem> + <listitem> + <para>Red: Files which are different by the given criteria (no copy direction).</para> + </listitem> + <listitem> + <para>Black: Files which are identical (no copy direction).</para> + </listitem> + </itemizedlist> + A double click on a file calls the &krusader;s <guilabel>Compare by content</guilabel> function. + The Tasks (<=>) column defines the default copy direction, which can be modified by the user if needed. + The results window supports dragging items to other windows ( drag [left], SHIFT+drag [right] ) + and copy left/right selected items to clipboard (<keycombo action="simul">&Ctrl;<keycap>c</keycap></keycombo>). + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><guilabel>File List</guilabel>: Tasks (<=>) column</term> + <listitem> + <para>This column displays the task that is planned for the + Synchronizer, this task can be modified with the + <link linkend="synccomp_right-click">right click menu</link>.</para> + <itemizedlist> + <listitem> + <para> + <guibutton>-></guibutton>: Copy from the + left side to the right side. For directories: + <command>mkdir</command> in the right side.</para> + </listitem> + <listitem> + <para> + <guibutton>=</guibutton>: The files are the same, do not + do anything.</para> + </listitem> + <listitem> + <para> + <guibutton>!=</guibutton>: The file is excluded, or the + Synchronizer does not know what to do.</para> + </listitem> + <listitem> + <para> + <guibutton><-</guibutton>: copy from the + right side to the left side. For directories: + <command>mkdir</command> in the left side</para> + </listitem> + <listitem> + <para> + <guibutton>DEL</guibutton>: delete files from the right + side.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry id="synccomp_show_options"> + <term>Show options</term> + <listitem> + <para>Here you can include/exclude particular file types. + Those files, that are not in the list, will be untouched at + synchronization.</para> + <itemizedlist> + <listitem> + <para> + <guibutton>-></guibutton>: Enable/Disable + the copy task from left to right.</para> + </listitem> + <listitem> + <para> + <guibutton>=</guibutton>: Enable/Disable listing the + equal files.</para> + </listitem> + <listitem> + <para> + <guibutton>!=</guibutton>: Enable/Disable listing the + excluded / "don't know what to do" files.</para> + </listitem> + <listitem> + <para> + <guibutton><-</guibutton>: Enable/Disable + the copy task from right to left.</para> + </listitem> + <listitem> + <para> + <guibutton>Trash</guibutton>: Enable/Disable the file + deleting from the left side task.</para> + </listitem> + <listitem> + <para> + <guibutton>Duplicates</guibutton>: Enable/Disable those + files that exist on both sides.</para> + </listitem> + <listitem> + <para> + <guibutton>Singles</guibutton>: Enable/Disable those + files that exist only on one side.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>Action buttons</term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guibutton>Compare</guibutton>: Compares the + directories, the results are displayed on the + <guilabel>File List</guilabel>.</para> + </listitem> + <listitem> + <para> + <guibutton>Stop</guibutton>: Stops comparing.</para> + </listitem> + <listitem> + <para> + <guibutton>Synchronize</guibutton>: Shows the + synchronize dialog.</para> + </listitem> + <listitem> + <para> + <guibutton>Close</guibutton>: Closes the Synchronizer + window.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>The Status line may contain</term> + <listitem> + <itemizedlist> + <listitem> + <para>The number of scanned directories while + comparing.</para> + </listitem> + <listitem> + <para>The filename when comparing by content (for big + files).</para> + </listitem> + <listitem> + <para>The number of files on the list.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry id="synccomp_right-click"> + <term>Right click menu on the + <guilabel>File List</guilabel></term> + <listitem> + <para>The right click menu is split up in three + sections:</para> + <para>1. change the + <guilabel>Task</guilabel> operations determined by the + Comparator. Select one or multiple files. The change will + be applied on the selection and not only on the right + clicked item. If the selected item is a directory, the + change will be applied on its files/subdirectories as + well.</para> + <itemizedlist> + <listitem> + <para> + <guibutton>Synchronize Directories</guibutton>: Starts + synchronization.</para> + </listitem> + <listitem> + <para> + <guibutton>Exclude</guibutton>: Excludes a file/dir + from synchronization ( task change to != ).</para> + </listitem> + <listitem> + <para> + <guibutton>Restore original operation</guibutton>: Task + change to the original result of comparison.</para> + </listitem> + <listitem> + <para> + <guibutton>Reverse direction</guibutton>: Task change ( + -> to <-, and + <- to -> ).</para> + </listitem> + <listitem> + <para> + <guibutton>Copy from right to left</guibutton>: Task + change to <-.</para> + </listitem> + <listitem> + <para> + <guibutton>Copy from left to right</guibutton>: Task + change to ->.</para> + </listitem> + <listitem> + <para> + <guibutton>Delete ( left single )</guibutton>: Task + change to DEL.</para> + </listitem> + </itemizedlist> + <para>2. change the selections</para> + <itemizedlist> + <listitem> + <para> + <guibutton>Select items</guibutton>: Opens a dialog + which allows you to select items. This is the + <guimenuitem>Select Group</guimenuitem> dialog from the + &editmenu-lnk;.</para> + </listitem> + <listitem> + <para> + <guibutton>Unselect items</guibutton>: Opens a dialog + which allows you to deselect items. This is the + <guimenuitem>Unselect Group</guimenuitem> dialog from + the &editmenu-lnk;.</para> + </listitem> + <listitem> + <para> + <guibutton>Invert selection</guibutton>: Invert the + selection status of all items.</para> + </listitem> + </itemizedlist> + <para>3. others (note that the following operations work on the + right-clicked file and not on the selection).</para> + <itemizedlist> + <listitem> + <para> + <guibutton>View left file</guibutton>: Starts viewer on + the left file.</para> + </listitem> + <listitem> + <para> + <guibutton>View right file</guibutton>: Starts viewer + on the right file.</para> + </listitem> + <listitem> + <para> + <guibutton>Compare Files</guibutton>: Starts the diff + utility (⪚ &kompare;) on the + files.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>Other buttons</term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guibutton>Profiles</guibutton>: If you have to + synchronize the same directories often, you can save the + settings ⪚ include files, exclude files, + ... Press the + <guibutton>Profile</guibutton> button, and you will be + able to add / load / save / remove synchronizer + profiles.</para> + </listitem> + <listitem> + <para> + <guibutton>Swap sides</guibutton>: Swaps the + <guilabel>File List</guilabel>.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>Synchronize with &kget;</term> + <listitem> + <para>If you want to synchronize a local directory with an + unstable ftp server, &kget; is a much better + solution than simple file copying. After comparing you may + right click on the result list and select + <guimenuitem>Synchronize with kget</guimenuitem> to execute + the synchronization, after that the listed files will be + downloaded with kget instead of krusader. Of course + <application>kget</application> needs to be installed on + your computer; otherwise, it will not be available.</para> + </listitem> + </varlistentry> + </variablelist> + +</sect2> +<sect2 id="synchronizer_sychronisation"> + <title>Sychronisation</title> + + <para>After pressing the + <guibutton>Synchronize</guibutton> button the synchronization + dialog appears.</para> + <variablelist> + <varlistentry> + <term>Check boxes</term> + <listitem> + <para>Here you confirm the copy and delete operations of + the Synchronizer</para> + <itemizedlist> + <listitem> + <para> + <guilabel>Right to left</guilabel>: copy X1 files ( Y1 + bytes ) enable / disable the copy from right to + left.</para> + </listitem> + <listitem> + <para> + <guilabel>Left to right</guilabel>: copy X2 files ( Y2 + bytes ) enable / disable the copy from left to + right.</para> + </listitem> + <listitem> + <para> + <guilabel>Left</guilabel>: delete X3 files ( Y3 bytes ) + enable / disable the left side deleting.</para> + </listitem> + <listitem> + <para> + <guilabel>Confirm overwrites</guilabel>: By switching + this option on, Krusader will show the + <guibutton>rename, skip, overwrite, skip all, overwrite + all</guibutton> dialog box, before overwriting the + file.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>Status labels</term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guilabel>Ready</guilabel>: A1/A2 files, B1/B2. This + line is changed at synchronizing, showing that + synchronizer finished with A1 files from A2 ( B1 bytes + from B2 ).</para> + </listitem> + <listitem> + <para> + <guilabel>Progress bar</guilabel>: Shows the progress + on the synchronization (based on bytes).</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>Action buttons</term> + <listitem> + <itemizedlist> + <listitem> + <para> + <guibutton>Start</guibutton>: Starts + synchronization.</para> + </listitem> + <listitem> + <para> + <guibutton>Pause / Resume</guibutton>: Pauses/resumes + the synchronization process.</para> + </listitem> + <listitem> + <para> + <guibutton>Close</guibutton>: Closes the + synchronization dialog (and stops + synchronization).</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term>Parallel synchronization</term> + <listitem> + <itemizedlist> + <listitem> + <para>One can give the number of the 'quasy' + threads.</para> + </listitem> + <listitem> + <para>Can drastically increase the speed when + synchronized with slow FTP servers.</para> + </listitem> + <listitem> + <para>Does not affect the speed of local + synchronization.</para> + </listitem> + <listitem> + <para>Remote "compare by content" and "directory + compare" is done in parallel.</para> + </listitem> + <listitem> + <para>Remote synchronization is also done in parallel, + except the mkdir tasks (mkdir must be before + copy).</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + </variablelist> + +</sect2> +</sect1> diff --git a/doc/en/user-interface.docbook b/doc/en/user-interface.docbook new file mode 100644 index 0000000..c2eccab --- /dev/null +++ b/doc/en/user-interface.docbook @@ -0,0 +1,863 @@ +<chapter id="user-interface"> + <title>User Interface</title> + <indexterm> + <primary>User Interface</primary> + </indexterm> + <sect1 id="ofm-userinterface"> + <title>OFM User Interface</title> + <para>The OFM file manager concept contains + <link linkend="features">many features</link> that make them + powerful enough to belong among the best file managers today. + The interface is simple: left panel, right panel and a command + line below. Because of interaction between these three items + the file managing will become more efficient.</para> + <para>If you would like to know + <ulink url="http://www.softpedia.com/reviews/linux/Krusader-Review-18193.shtml"> + how &krusader; works</ulink> you can try it yourself, + just install it on your computer. To accept an + &ofm-url; like &krusader;, the user needs + to get used to + <emphasis>new ideas</emphasis> that are actually already 20 + years old. If you prefer to waste time and lose a lot of + productivity, you can always continue to use one panel file + managers that are based on &Windows; + Explorer.</para> + </sect1> + <sect1 id="mainwindow"> + <title>&krusader; Main Window</title> + <!-- OLD +<screenshot> + <screeninfo>&krusader; Main Window</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="mainwindow.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="mainwindow.png" format="EPS"/></imageobject> + <textobject><phrase>&krusader; Main Window</phrase></textobject> + <caption><para>&krusader; is main window with all the different parts named on the screen.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-mainwindow" float="1"> + <title>&krusader; Main Window</title> + <mediaobject> + <imageobject> + <imagedata fileref="mainwindow.png"></imagedata> + </imageobject> + <textobject> + <phrase>&krusader; Main Window</phrase> + </textobject> + </mediaobject> + </figure> + <para>The User Interface is based on &ofm-url; + paradigm, a 20- year old principle that has proven its bones. + It is known as simple, easy and powerful. In the following + sections we will cover the basic functions of each part with the + exception of:</para> + <itemizedlist> + <listitem> + <para>The + <link linkend="menu-commands">Menu Bar</link> which has a + chapter of its own.</para> + </listitem> + <listitem> + <para>The + <link linkend="bookman">Bookmarks</link> which has a chapter + of its own.</para> + </listitem> + <listitem> + <para>The + <emphasis role="bold">Status Bar</emphasis> shows the + properties of the current file (that is being) in focus. + You can use "drag and drop" to drop a &URL; + "into" the Status Bar.</para> + </listitem> + </itemizedlist> + </sect1> + <sect1 id="toolbars"> + <title>Toolbars</title> + <para>&krusader; comes with several Toolbars.</para> + <sect2 id="main_toolbar"> + <title>Main Toolbar</title> + <indexterm> + <primary>Toolbar</primary> + <secondary>Main Toolbar</secondary> + </indexterm> + <!-- OLD +<screenshot> + <screeninfo>Main Toolbar</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="toolbar.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="toolbar.png" format="EPS"/></imageobject> + <textobject><phrase>Main Toolbar</phrase></textobject> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-maintoolbar" float="1"> + <title>Main Toolbar</title> + <mediaobject> + <imageobject> + <imagedata fileref="toolbar.png"></imagedata> + </imageobject> + <textobject> + <phrase>Main Toolbar</phrase> + </textobject> + </mediaobject> + </figure> + <para>The &krusader; Main Toolbar, is a standard + &kde; toolbar that can be dragged around the + application or configured via a + <keycap>Right-Click</keycap> menu. You can decide whether or + not you want to display it each time you start + &krusader; in the &konfigstartpg-lnk;, + and you can toggle its use in the current session in the + &viewmenu-lnk;. The Main Toolbar contents can be + configured from the + <guimenuitem>Configure Toolbars</guimenuitem> in the + &settingsmenu-lnk; or the + <guilabel>Toolbar</guilabel> tab in the + &konfiglookandfeel-lnk;. Since various commands + and options in &krusader; are context-dependent, + some commands are not always available. The icon of an + inappropriate or inactive action will be deactivated + (grayed-out) disabling its use. &bookmarks-lnk; + can be placed into the Main Toolbar and the Actions Toolbar + with the mouse using "drag and drop".</para> + </sect2> + <sect2 id="actions_toolbar"> + <title>Actions Toolbar</title> + <indexterm> + <primary>Toolbar</primary> + <secondary>Actions Toolbar</secondary> + </indexterm> + <para>&useractions-lnk; and + &bookmarks-lnk; can be "plugged" into the + <guilabel>Actions Toolbar</guilabel>. To show it, use + <emphasis role="bold"> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Actions Toolbar</guimenuitem> + </menuchoice> + </emphasis>. To add user actions, use + <emphasis role="bold"> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Toolbars</guimenuitem> + </menuchoice> + </emphasis> and select Actions Toolbar. You can, for example, + drag the Actions Toolbar to the right side using the + mouse.</para> + </sect2> + <sect2 id="location_toolbar"> + <title>Location Toolbar</title> + <indexterm> + <primary>Toolbar</primary> + <secondary>Location Toolbar</secondary> + </indexterm> + <para>Below the + <guibutton>Main Toolbar</guibutton> there is a + <guibutton>Location Toolbar</guibutton> for each panel. It + shows the path the panel is currently pointing to. If the + selected path is too long, it will be automatically shortened + and an ellipsis "..." will replace the omitted part of the + path name. When entering archives the path will be displayed + in the following format: "archive + name:/directory/archive_filename/the directory inside the + archive". This format makes the paths uniform and easy to + read. The + <guibutton>Location Toolbar</guibutton> supports also + &kioslaves1-url; but not all of them, some can + only be used with the + <link linkend="krviewer">viewer</link> and some can not be + used. The user can enter a desired path by clicking on it. + <itemizedlist> + <listitem> + <para> + <userinput> + <replaceable>/mnt/cdrom/</replaceable> + </userinput> + </para> + </listitem> + <listitem> + <para> + <userinput> + <command>settings:/</command> + </userinput>will browse and open entries of the + <application>KDE control center.</application></para> + </listitem> + <listitem> + <para> + <userinput> + <command>devices:/</command> + </userinput>gives an overview of the devices + ⪚ + <hardware>floppy</hardware> or + <hardware>CD-ROM</hardware> drives.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>trash:/</command> + </userinput>opens &kde; is trash.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>ipod:/</command> + </userinput>uses the &kio-ipodslave-url; to + access, upload and organize the music stored on + &appleipod;.</para> + </listitem> + <listitem> + <para>And last but not least + &remote-connections-lnk; .</para> + </listitem> + </itemizedlist>You can copy-paste a &URL; in the + <guibutton>Location Toolbar</guibutton> or use a middle click. + With the Right-Click menu you can configure the auto-complete + function. An optional + <guilabel>Clear Location Toolbar</guilabel> button is also + available.</para> + <para>Quick Navigation: + <keycap>&Ctrl;</keycap>point with mouse in the + middle of &URL; of the + <guibutton>Location Toolbar</guibutton>. A pop-up window shows + the next &URL; location. Pressing + <keycap>&Ctrl;</keycap>+ &LMB; shows + the location where the mouse was pointing to. This feature + allows faster navigation in a big directory tree.</para> + </sect2> + <sect2 id="panel_toolbar"> + <title>Panel Toolbar</title> + <indexterm> + <primary>Toolbar</primary> + <secondary>Panel Toolbar</secondary> + </indexterm> + <para>Each panel has a + <link linkend="konfig-looknfeel-ptoolbar">configurable Panel + Toolbar</link>. The complete Panel Toolbar or specific + buttons can be made visible or be hidden. + <itemizedlist> + <listitem> + <para> + <guibutton>OpenDir Button</guibutton>: opens the + directory browser.</para> + </listitem> + <listitem> + <para> + <guibutton>Equals Button (=)</guibutton>: changes the + panel directory to the other panel directory.</para> + </listitem> + <listitem> + <para> + <guibutton>Up Button (..)</guibutton>: changes the panel + directory to the parent directory.</para> + </listitem> + <listitem> + <para> + <guibutton>Home Button (~)</guibutton>: changes the panel + directory to the home directory.</para> + </listitem> + <listitem> + <para> + <guibutton>Root Button (/)</guibutton>: changes the panel + directory to the root directory.</para> + </listitem> + <listitem> + <para> + <guibutton>Sync-browsing Button</guibutton>: when active, + each directory change in the specific panel is performed + in the other panel as well.</para> + </listitem> + </itemizedlist></para> + </sect2> + </sect1> + <sect1 id="panels"> + <title>Panels</title> + <para>The &krusader; panels are where most of the + action takes place. Currently, there are two types of panels: + <itemizedlist> + <listitem> + <para>&list-panel-lnk;: shows the files and + directories.</para> + </listitem> + <listitem> + <para>&popup-panel-lnk;: has several display + modes: Preview, Tree, Quickselect, View and Disk Usage for + the file or directory that has the focus. The PopUp Panel + may be left open or closed, as desired.</para> + </listitem> + </itemizedlist>&krusader; is a "twin-panel" file + manager so there are two panels: the "Left" panel and the + "Right" panel, or a more important logical distinction, the + *Active* panel and the *Inactive* panel. The active panel is + the one that will accept your mouse and keyboard input. If you + choose a command from the + <guilabel>Menu-Bar</guilabel> or + <guilabel>Toolbar</guilabel> the command will act upon the + selected files/directories in the active panel. You can switch + between panels using the 	 key or by clicking on + the + <guilabel>Information or Totals labels</guilabel>, or by + selecting any file in a panel with the mouse. As always, + default startup settings can be modified with the + &konfigstartpg-lnk;, and you control the current + session with the &viewmenu-lnk;.</para> + <!-- OLD +<screenshot> + <screeninfo>List Panel</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="listpanel.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="listpanel.png" format="EPS"/></imageobject> + <textobject><phrase>List Panel</phrase></textobject> + <caption><para>The List Panel with all the different parts indicated.</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-listpanel" float="1"> + <title>List Panel</title> + <mediaobject> + <imageobject> + <imagedata fileref="listpanel.png"></imagedata> + </imageobject> + <textobject> + <phrase>List Panel</phrase> + </textobject> + </mediaobject> + </figure> + <sect2 id="list_panel"> + <title>List Panel</title> + <indexterm> + <primary>Panel</primary> + <secondary>List Panel</secondary> + </indexterm> + <para>This is the default panel and the one you will probably + use most of the time. This panel shows the contents of one + directory which can be local (part of your mounted file + systems, either a native file or the files inside an archive) + or remote files (accessed via &FTP; or Samba). + There are two modes: <link linkend="view-menu">Detailed View</link> that shows the file names, + file size, creation date and time and their attributes. + And <link linkend="view-menu">Brief View</link> that shows only the file names, + the number of brief columns can be changed, by right clicking on the <guilabel>Name</guilabel> header. + File copy/paste/cut via clipboard between + &konqueror; and &krusader; + <keycombo action="simul">&Ctrl; + <keycap>c</keycap></keycombo>, + <keycombo action="simul">&Ctrl; + <keycap>v</keycap></keycombo>, + <keycombo action="simul">&Ctrl; + <keycap>x</keycap></keycombo> is supported. + <keycombo action="simul">&Alt;&Ctrl; + <keycap>r</keycap></keycombo> toggles the + <guilabel>List Panel</guilabel> between horizontal and + vertical mode.</para> + <para>The following items are available: + <itemizedlist> + <listitem> + <para> + <emphasis> + <guilabel>Information Label</guilabel> + </emphasis>: shows how much free space is physically + available on the file system, the file system capacity + and where the path is mounted. If the information is not + available (most often in the case of remote file system) + a message will be displayed with the reason for + unavailablity instead of the information.</para> + <para>The + <guibutton>Media button</guibutton> on the left of the + <guilabel>Information Label</guilabel> displays a list of + all available media, where you can select the desired + media (hdd partition, dvd, usb-stick, &etc;). + The context menu gives several options like + <guilabel>Mount</guilabel>, + <guilabel>Open in a new tab</guilabel>, &etc; + The + <guibutton>Media button</guibutton> is + <link linkend="konfig-advanced"> + configurable</link>.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Column Headers</guilabel> + </emphasis>: here you can change the sort order of the + files and directories as desired. The default sort order + is by + <guilabel>Name</guilabel>. The sort order can be + instantly changed by clicking on one of the + <guilabel>Column Headers</guilabel>. To reverse the sort + order, click a second time on the Column Header. An arrow + will appear on the right of the Column Header text, + showing the sort direction (Up arrow = A to Z sorting, + Down arrow = Z to A sorting). Default + &useractions-lnk; set a keybinding for the + Column Headers. The default + <guilabel>Column Headers</guilabel> are: + <guilabel>Name, Ext, Size, Modified, rwx</guilabel>. + Predefined <link linkend="konfig-general">Atomic extensions</link> like + <filename>tar.gz</filename> are shown as one part in the + <guilabel>Ext</guilabel> Column. More + <link linkend="konfig-looknfeel-panel">optional Column + Headers</link> are available with the &RMB;. + The width + <guilabel>Column Headers</guilabel> can be changed with + the mouse by single clicking and moving the divider line + to the desired width (keep the mouse button pressed). + Both + <guilabel>List Panels</guilabel> remember the sort order + and column width. The + <guilabel>Column Headers</guilabel> can be changed and + saved individually to each panel.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>File List</guilabel> + </emphasis>: displays the files and directories in the + browsed directory. The &quick-search-lnk; + allows you to search for files by typing their names, or + the first few characters of a file name. Pressing + &Enter; or double clicking on a file will + open/execute that file. You can select/unselect files + using the mouse with the + <keycap>Insert</keycap> key or the + &editmenu-lnk;.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Totals Label</guilabel> + </emphasis>: selecting or deselecting files will change + the + <emphasis> + <guilabel>Totals Label</guilabel> + </emphasis>at the bottom of the panel, which displays how + many files you have selected (and how much total disk space + they use) as well as the total file and disk usage of the + current directory (as opposed to the information label + that displays information for the whole file system). If + a directory contains a lot of subdirectories, it may not + be possible to drop the &URL; onto the panel (on + which only directories are visible), but the + &URL; can be dropped onto the "Status Bar" or + "Totals Label" instead. When a + <link linkend="view-menu">custom filter</link> is set, it + will show the setting, example: [*.cpp].</para> + </listitem> + </itemizedlist>When using the "&kde; default + <link linkend="konfig-color">colors</link>", then the + selected files are shown in blue and the current file is + surrounded by a fine-lined rectangle. By default an icon is + shown according to the file type. Use + &konfiglookandfeel-lnk; to change the default + configuration to meet your individual needs.</para> + <para>Some useful + <guilabel>List panel</guilabel>&keybindigs-lnk;: + <itemizedlist> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>r</keycap></keycombo> will refresh the + panel.</para> + </listitem> + <listitem> + <para>Focus a file or directory on the left panel, press + <keycombo action="simul">&Ctrl; + <keycap>Left arrow</keycap></keycombo> and the right panel + changes: + <itemizedlist> + <listitem> + <para>On a file: the right panel gets the same path + as the left panel.</para> + </listitem> + <listitem> + <para>On a directory: refreshes the right panel with + the contents of the directory.</para> + </listitem> + </itemizedlist></para> + </listitem> + <listitem> + <para>For the right panel: press + <keycombo action="simul">&Ctrl; + <keycap>Right arrow</keycap></keycombo> and the left panel + will change.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="popup_panel"> + <title>PopUp Panel</title> + <indexterm> + <primary>Panel</primary> + <secondary>PopUp Panel (3rd Panel)</secondary> + </indexterm> + <para>This is "&krusader; is 3rd Hand" or the 3rd + Panel, click on the arrow-up button on the left of the + <guilabel>Totals Label</guilabel> or + <keycombo action="simul">&Alt; + <keycap>Down-Arrow</keycap></keycombo> to open the + <guilabel>PopUp Panel</guilabel>. This panel has several + display modes which can be activated by clicking on the + appropriate button. + <itemizedlist> + <listitem> + <para> + <emphasis> + <guilabel>Preview Panel</guilabel> + </emphasis>: gives a preview of the file that has the + focus (currently selected file).</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Tree Panel</guilabel> + </emphasis>: is used to quickly browse the local + directory tree. This panel behaves like the list panel + but only one directory may be selected at a time and + double clicking or pressing &Enter; on a + directory will open that directory in the active panel. + The panels fully support drag and drop (copy, move, link) + mouse actions.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Quickselect Panel</guilabel> + </emphasis>: is used to quickly select files, + ⪚ + <literal role="extension">*.png</literal>and click on the + + <guibutton>"Go"</guibutton> button. The "floppy" button + stores the current selection. The "select group dialog" + is also available.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Viewer Panel</guilabel> + </emphasis>: views a text file, views an image, + &etc; A thumbnail view is generated whenever + you open the + <guilabel>Viewer Panel</guilabel> and click on a name of a + folder that contains pictures.</para> + </listitem> + <listitem> + <para> + <emphasis> + <guilabel>Disk Usage Panel</guilabel> + </emphasis>: views the &diskusage-lnk; of a + directory.</para> + </listitem> + </itemizedlist>If needed you can resize the window + ⪚ to better display a picture or view a file is + contents. Click on the arrow down button to close the + <guilabel>3rd Hand Panel</guilabel>.</para> + </sect2> + <sect2 id="folderhistory"> + <title>Folder History</title> + <para>Both panels remember recently visited folders. Click on + the + <guibutton>"Folder history"</guibutton> button ("watch" + symbol) to open the folder history list. Here you can quickly + change to previously visited folders. The currently focused + folder is checked. On every new start of &krusader;, the + history list is empty.</para> + </sect2> + </sect1> + <sect1 id="cmdline_termemu"> + <title>Command Line / Terminal Emulator</title> + <para>This part of the <link linkend="gloss-gui">GUI</link> + can have four modes: Command Line, Terminal Emulator, show both and show none. + You can choose your mode of operation either on start-up with the + &konfigstartpg-lnk;, or for the current session with the &viewmenu-lnk; . + </para> + + <sect2 id="cmdline"> + <title>Command Line</title> + + <!-- OLD +<screenshot> + <screeninfo>Command line</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="cmdline.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="cmdline.png" format="EPS"/></imageobject> + <textobject><phrase>Command Line</phrase></textobject> + <caption><para>Command Line</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-commandline" float="1"> + <title>Command Line</title> + <mediaobject> + <imageobject> + <imagedata fileref="cmdline.png"></imagedata> + </imageobject> + <textobject> + <phrase>Command line</phrase> + </textobject> + </mediaobject> + </figure> + <para>The traditional command line mode offers a single line of + input to enter commands, it also features three buttons: + <itemizedlist> + <listitem> + <para><guibutton>"command history"</guibutton> (down arrow) to quick open previous used commands + </para> + </listitem> + + <listitem> + <para><guibutton>"Useraction expander"</guibutton> (green plus button) to add easy + <link linkend="useractions">Useraction placeholders</link> + </para> + </listitem> + + <listitem> + <para><guibutton>"run in terminal mode"</guibutton> (console icon) button with the next options: + <itemizedlist> + <listitem><para>Start and Forget</para> + </listitem> + + <listitem><para>Display Separated Standard and Error Output</para> + </listitem> + + <listitem><para>Display Mixed Standard and Error Output</para> + </listitem> + + <listitem><para>Start in New Terminal</para> + </listitem> + + <listitem><para>Send to Embedded Terminal Emulator</para> + </listitem> + + </itemizedlist> + </para> + + </listitem> + + + </itemizedlist> + When you start typing your commands, + the command line auto-completion feature will make its offers + according to what you choose in the + &kcontrolcenter;. If you want to change the way + auto-complete behaves in the current &krusader; + session, + <keycap>right click</keycap> on the command line and change it. + To the left of the input line you can find the local path that + the active panel is currently pointing to. This path is where + your command will be executed. Typing + <userinput> + <command>cd</command> + <replaceable> + <directory></replaceable> + </userinput> in the command line will also cause the active + panel to point to this directory. + + Click + <link linkend="cmdline_keybindings">here</link> to view the + command line keybindings.</para> +</sect2> + + <sect2 id="termemu"> + <title>Terminal Emulator</title> + + <!-- +<screenshot> + <screeninfo>Terminal emulator</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="terminalEmu.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="terminalEmu.png" format="EPS"/></imageobject> + <textobject><phrase>Terminal emulator</phrase></textobject> + <caption><para>Terminal emulator</para></caption> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-terminalemulator" float="1"> + <title>Terminal Emulator</title> + <mediaobject> + <imageobject> + <imagedata fileref="terminalEmu.png"></imagedata> + </imageobject> + <textobject> + <phrase>Terminal emulator</phrase> + </textobject> + </mediaobject> + </figure> + <para>The terminal emulator mode is in fact a small console and + acts like one. You can change the active directory in the + terminal by using the + <userinput> + <command>cd</command> + </userinput> command. The terminal emulator will follow the + active panel directory. When you drag a file from the + <interface>"List Panel"</interface>, you will get to choose + between: "Paste", + <command>cd</command>, + <command>mv</command> and + <command>ln</command>. If you drag multiple files, then + <command>cd</command> will not be available. A full-screen + terminal emulator can be used when + <link linkend="konfig-looknfeel-operation">configured</link> or + <keycombo action="simul">&Ctrl; + <keycap>f</keycap></keycombo> toggles between normal and full + screen mode. If the command line is hidden, press + <keycombo action="simul">&Ctrl; + <keycap>up</keycap></keycombo> to focus the terminal emulator. + <keycombo action="simul">&Ctrl; + <keycap>down</keycap></keycombo> brings you back down. + <keycombo action="simul">&Ctrl; + <keycap>Enter</keycap></keycombo> and + <keycombo action="simul">&Ctrl; + <keycap>Shift</keycap> + <keycap>Enter</keycap></keycombo> paste the filename. You can + close the emulator by typing + <userinput> + <command>exit</command> + </userinput>.</para> + <para> + Click + <link linkend="termemu_keybindings">here</link> to view the + Terminal emulator keybindings..</para> + </sect2> + + </sect1> + <sect1 id="fnkeys"> + <title>Function (FN) Keys Bar</title> + <!-- OLD +<screenshot> + <screeninfo>Function (FN) Keys Bar</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="fnkeys.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="fnkeys.png" format="EPS"/></imageobject> + <textobject><phrase>Function (FN) Keys Bar</phrase></textobject> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-fnkeys" float="1"> + <title>Function (FN) Keys Bar</title> + <mediaobject> + <imageobject> + <imagedata fileref="fnkeys.png"></imagedata> + </imageobject> + <textobject> + <phrase>Function (FN) Keys Bar</phrase> + </textobject> + </mediaobject> + </figure> + <para>This bar gets its name from the function (FN) keys it + represents. For each button on this bar there is a + corresponding function key that performs the same action. This + bar is derived from the design of the first twin-panel file + managers and the FN keys usually act the same way with two + changes: the + <keycap>F2</keycap> key will open a terminal at the last local + path that the active panel pointed to, and the + <keycap>F9</keycap> key is used to rename files. + <guilabel>Mkdir</guilabel> + <keycap>F7</keycap> can create whole directory trees on the fly + ⪚ + <literal>foo/bar/test</literal>. You can choose to display + <link linkend="faqu_resize">or not</link> the + <guilabel>FN keys bar</guilabel> when starting up + &krusader; via the &konfigstartpg-lnk;, + and you can toggle its use in the current session with the + &viewmenu-lnk;. The actions and + &keybindigs-lnk; performed by the function keys are + configurable since version 1.51, they will remain active with + or without the + <guilabel>FN keys bar</guilabel> displayed.</para> + </sect1> + <sect1 id="folder-tabs"> + <title>Folder Tabs</title> + <!-- OLD +<screenshot> + <screeninfo>Tabbed browsing</screeninfo> + <mediaobject> + <imageobject><imagedata fileref="tabbed_browsing.png" format="PNG"/></imageobject> + <imageobject><imagedata fileref="tabbed_browsing.png" format="EPS"/></imageobject> + <textobject><phrase>Tabbed browsing</phrase></textobject> + </mediaobject> +</screenshot> +--> + <figure id="screenshot-tabbedbrowsing" float="1"> + <title>Folder Tabs</title> + <mediaobject> + <imageobject> + <imagedata fileref="tabbed_browsing.png"></imagedata> + </imageobject> + <textobject> + <phrase>Folder Tabs</phrase> + </textobject> + </mediaobject> + </figure> + <para>With &folder-tabs; you can quickly change to + multiple folders; each panel has its own + &folder-tabs;. The &folder-tabs; + positions are saved when closing &krusader;. To + switch between &folder-tabs;, click them with the + mouse. Squeezed &folder-tabs; have tooltips to + display the full path. The following &folder-tabs; + operations are available: + <itemizedlist> + <listitem> + <para>To + <keycap>open a new tab</keycap> and keep the current + directory: &right-click; on a directory and + select + <keycap>open in a new tab</keycap>, or use the + &MMB;, or use + <keycombo action="simul">&Alt;&Ctrl; + <keycap>n</keycap></keycombo>.</para> + </listitem> + <listitem> + <para>To + <keycap>duplicate a tab</keycap>: &right-click; + on the Folder Tab and select + <keycap>duplicate tab</keycap>, or use + <keycombo action="simul"> + &Alt;&Ctrl;&Shift; + <keycap>n</keycap></keycombo>.</para> + </listitem> + <listitem> + <para>To + <keycap>close a tab</keycap> (except the left tab): + &right-click; on the tab and select + <keycap>close tab</keycap>, or use the &MMB;, or + use the Folder tab + <guibutton>"red cross"</guibutton> button, or use + <keycombo action="simul">&Alt;&Ctrl; + <keycap>c</keycap></keycombo>.</para> + </listitem> + <listitem> + <para>To create a + <keycap>"home" tab</keycap>: click on the + <guibutton>Folder Tab Bookmark</guibutton> button.</para> + </listitem> + <listitem> + <para>To + <keycap>change tabs</keycap>: + <keycombo action="simul">&Shift; + <keycap>Left Arrow</keycap></keycombo> or + <keycombo action="simul">&Shift; + <keycap>Right Arrow</keycap></keycombo>.</para> + </listitem> + <listitem> + <para>To open the current folder in a new tab: use + <keycombo action="simul"> + &Ctrl;&Alt;&Enter;</keycombo>.</para> + </listitem> + </itemizedlist></para> + </sect1> + <sect1 id="ui_buttons"> + <title>Buttons</title> + <para>Several buttons for fast operations are available: + <link linkend="main_toolbar">Main Toolbar</link>, + <link linkend="actions_toolbar">Actions Toolbar</link>, + <link linkend="panel_toolbar">Panel Toolbar</link>, + <link linkend="location_toolbar">Location Toolbar</link>, + <link linkend="list_panel">Media</link>, + <link linkend="folderhistory">Folder history</link>, + <link linkend="bookman">Bookmarks</link>, + <link linkend="folder-tabs">Tab</link>, + <link linkend="cmdline">Commandline</link>, + <link linkend="fnkeys">Function keys</link>.</para> + </sect1> +</chapter> diff --git a/doc/en/useraction-xml.docbook b/doc/en/useraction-xml.docbook new file mode 100644 index 0000000..c2676a1 --- /dev/null +++ b/doc/en/useraction-xml.docbook @@ -0,0 +1,217 @@ +<appendix id="useraction-xml"> + <!-- ********************************************************************** + installation.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>useraction.xml</title> + <para>This appendix gives several examples of + <filename>useraction.xml</filename> files. With this you can begin + to discover the power of the &useractions-lnk; and + start learning how to use them. Once you understand how to write + UserActions you will find that &krusader; is an even + more powerful, customizable tool.</para> + <para>Please consider uploading your UserActions at + &kde-files-url; as we are collecting them. If your + UserAction is selected by us it will be shipped with + &krusader; at the next release. We provide also an + &useractionsforum-url;.</para> + +<itemizedlist> + <listitem><para>Runs <command>uptime</command> + <programlisting> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="uptime" > + <title>Up-time</title> + <tooltip>tells how long since the computer has been booted</tooltip> + <icon>clock</icon> + <category>information</category> + <description same_as="tooltip" /> + <command executionmode="collect_output" >uptime</command> + <defaultshortcut>Alt+Ctrl+U</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Runs <command>ls -l</command> + <programlisting> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="ls -l" > + <title>ls -l in curremt dir</title> + <description same_as="tooltip" /> + <command executionmode="collect_output" >ls -l %aPath% %oPath%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Echo Placeholder + <programlisting> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="test_placeholder" > + <title>Echo Placeholder</title> + <tooltip>Echo's the placeholder values</tooltip> + <category>Testing</category> + <description same_as="tooltip" /> + <command executionmode="collect_output" onmultiplefiles="call_each" >echo -e "aPath %aPath()% \naCurrent: %aCurrent()%"</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>This useraction copies current path and filename to clipboard: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="clipboard current" > + <title>Copy to Clipboard</title> + <tooltip>Copy to clipboard</tooltip> + <icon>klipper</icon> + <category>System</category> + <description>Copy current path and filename to clipboard</description> + <command>%_Clipboard("%aCurrent%")%</command> + <defaultshortcut>Win+C</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Selects <literal role="extension">.diff</literal> and <literal role="extension">*.h</literal> in the active panel: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="test_select" > + <title>Add selection *.diff and *.h</title> + <category>Selection</category> + <command>%aSelect("*.diff", "add")% %aSelect("*.h", "add")%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Active panel changes to <filename>mnt/floppy</filename> (bookmark): + <programlisting> +<!DOCTYPE KrusaderUserActions> +<action name="mnt/floppy bookmark" > + <title>Jump to /mnt/floppy</title> + <category>Bookmarks</category> + <command>%aGoto("/mnt/floppy", "yes")%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Select in the non-active panel, all filenames that are highlighted in the active panel: + <programlisting> +<!DOCTYPE KrusaderUserActions> + <action name="asdfasdf" > + <title>Select in Other Panel</title> + <category>Selection</category> + <description>Select all filenames that are selected in the active panel, also in the non-active panel</description> + <command>%oSelect("%aList("selected", " ", "Yes")%")%</command> + </action> +</KrusaderUserActions</programlisting> + </para></listitem> + + <listitem><para>Make a backup of the current file/folder to <filename>foo.bak</filename> into the current directory: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="backup current" > + <title>Backup in Current Directory</title> + <tooltip>Backup in current directory</tooltip> + <icon>filesaveas</icon> + <category>System</category> + <description same_as="tooltip" /> + <command>%_Copy("%aCurrent%", "%_Ask("new name", "%aCurrent%.bak")")%</command> + <defaultshortcut>Shift+F5</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Opens <link linkend="krusearcher">KruSearcher</link>: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="search" > + <title>Search Test</title> + <command>%_NewSearch("Search 2")%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Sets the selected picture as wallpaper: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="set wallpaper" > + <title>Set as Wallpaper</title> + <tooltip>Set as wallpaper</tooltip> + <icon>image</icon> + <category>Service Menu</category> + <description>Set as wallpaper (scaled)</description> + <command>dcop kdesktop KBackgroundIface setWallpaper "%aCurrent%" 6</command> + <defaultshortcut>Win+W</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>This useraction edits a file with root permissions using <command>kdesu</command>: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="edit as root" > + <title>Edit as Root</title> + <tooltip>Edit as root</tooltip> + <icon>kwrite</icon> + <category>System</category> + <description>Edit a file with root permissions using kdesu</description> + <command>kdesu kedit %aCurrent%</command> + <defaultshortcut>Win+F4</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>This useraction Add item(s) to Amarok playlist: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="amarok enqueue" > + <title>Enqueue in Amarok</title> + <tooltip>Append selected item(s) to Amarok playlist</tooltip> + <icon>amarok</icon> + <category>Multimedia</category> + <description same_as="tooltip" /> + <command>amarok --append %aList("Selected")%</command> + <defaultshortcut>Win+A</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + + <listitem><para>Opens <link linkend="synchronizer">Synchronizer</link>: + <programlisting> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="synchronizer" > + <title>Synchronizer</title> + <command>%_Sync("Sync 2")%</command> + </action> +</KrusaderUserActions></programlisting> + </para></listitem> + +</itemizedlist> + +</appendix> diff --git a/doc/en/useractions.docbook b/doc/en/useractions.docbook new file mode 100644 index 0000000..2c3b5fd --- /dev/null +++ b/doc/en/useractions.docbook @@ -0,0 +1,644 @@ +<sect1 id="useractions"> + <!-- ********************************************************************** + useractions.docbook + ++++++++++++++++++++++++++ + (C)opyright : (C) 2000 - 2008 + All Rights Reserved Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>UserActions</title> + <indexterm> + <primary>UserActions</primary> + </indexterm> + <!-- Thanks to Jonas Bar --> + <para>With ActionMan you can set up, configure and manage + UserActions. Some general settings are configured with + <link linkend="konfig-useractions">Konfigurator</link>. With + UserActions you can perform actions on files in the panel or to + access &krusader; internal functions with parameters + directly using placeholders. The actions integrate seamlessly + into &kde;'s action system, which means that the + standard Edit Toolbar and Edit Shortcut dialogs will show + UserActions, too. The UserActions are stored in + <filename> + ~/.kde/share/apps/krusader/useraction.xml</filename> (the file + structure is documentated in doxygen headers of UserActionXML). + Several + <link linkend="useraction-xml">examples</link> are included in the + documentation. UserActions can be edited / added / imported / + exported by using ActionMan. The default UserActions are stored + in + <filename> + ~/.kde/share/apps/krusader/useraction-examples.xml</filename>. + UserActions can appear nearly everywhere where "normal" KActions + can be placed. The actions integrate seamlessly into + &kde; action system, which means that the standard + Edit Toolbar and Edit Shortcut dialogs will show UserActions, + too. They can even be placed in the menu bar, but for that the + <filename>krusaderui.rc</filename> file must be edited. A few + examples: + <itemizedlist> + <listitem> + <para> + <link linkend="useractions-menu">Useractions Menu</link> + </para> + </listitem> + <listitem> + <para>&usermenu-lnk;</para> + </listitem> + <listitem> + <para>&actions-toolbar-lnk;</para> + </listitem> + <listitem> + <para>right click menus</para> + </listitem> + <listitem> + <para>&etc;</para> + </listitem> + </itemizedlist>&krusader;'s UserActions tool is very + powerful and customizable if you are familiar with writing + UserActions in general.</para> + <tip> + <para>Several UserActions are provided by default. Please + <link linkend="help_krusader">upload your favorite + UserActions</link> so that they become available for the + &krusader; community. Thanks! We provide also an + &useractionsforum-url;.</para> + </tip> + <figure id="screenshot-actionman" float="1"> + <title>ActionMan</title> + <mediaobject> + <imageobject> + <imagedata fileref="actionman.png"></imagedata> + </imageobject> + <textobject> + <phrase>ActionMan</phrase> + </textobject> + </mediaobject> + </figure> + <para>Basically, UserActions are a method to call external + programs with variable parameters. For example, you could have a + UserAction with the following + <command>xmms + <option>--enqueue %aList("Selected")%</option></command> to + enqueue all selected items of the active panel to the current + instance of xmms. Additionally, there is limited access to + &krusader; internal functions requiring parameters. + For example, + <command>%aPanelSize("80")%</command> will set the width of the + active panel to 80% of the &krusader; mainwindow. + Since the parameter of placeholders can contain other + placeholders, few scripts are possible. However, scripting can be + done with the &javascript-console-lnk;.</para> + <para> + <emphasis role="bold">Managing UserActions</emphasis> + </para> + <para>Open Konfigurator and choose "UserActions -> + ActionMan", in which you can add, edit, remove, import and export + UserActions. + <itemizedlist> + <listitem> + <para> + <guimenuitem>Add Action</guimenuitem>: If you add an new + action, you get an empty input mask where you can enter all + the properties you desire. The action will be added as soon + as you press + <guimenuitem>Ok</guimenuitem>. Afterwards, the name is shown + in the list on the left.</para> + </listitem> + <listitem> + <para>To edit a UserAction: Select the UserAction on the + left. Then choose it if you want to edit its properties. The + changes will only take effect when you press + <guimenuitem>OK</guimenuitem>.</para> + </listitem> + <listitem> + <para> + <guimenuitem>To remove a UserAction</guimenuitem>: Select the + UserAction on the left and click the remove button.</para> + </listitem> + <listitem> + <para> + <guimenuitem>To import a UserAction</guimenuitem>: If you + import some actions, they will be automatically added to your + list. If there are name conflicts (the names have to be + unique because these are the ID for &kde;'s action + system), you are asked to resolve them. For this, the list on + the left will only show the actions where conflicts exist. + You can now give them new names or remove them.</para> + </listitem> + <listitem> + <para> + <guimenuitem>Export Action</guimenuitem>: If you export a + UserAction you have to give a filename in which to store it. + If it does not exist, it will be created. If the file already + contains UserActions, the action you are exporting will be + added to that file.</para> + </listitem> + </itemizedlist>All actions you have defined are now shown in the + user menu and in &kde; dialogs for changing shortcuts + and managing the toolbar. In addition, all actions available for + the current item will also show up in the right click + menu.</para> + <para> + <emphasis role="bold"> + <guimenuitem>Basic Properties</guimenuitem> + </emphasis> + </para> + <para> + <guimenuitem>"Distinct Name", "Title" and "Command + line"</guimenuitem>are always required, all the other properties + are optional. + <itemizedlist> + <listitem> + <para> + <guimenuitem>"Distinct Name"</guimenuitem>: A unique name of + the UserAction, used to identify it for &kde;'s + action system.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Icon button"</guimenuitem>: The icon for your + UserAction.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Category"</guimenuitem>: Adds a category for a + better overview. NOTE: This property is not used yet. It is + planned to be used, but has not implemented yet.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Title"</guimenuitem>: The title displayed in + the menus or dialogs.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Tooltip"</guimenuitem>: A tooltip for your + UserAction, ⪚ displayed in the toolbar on + mouseover.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Description"</guimenuitem>: A description of + what the UserAction does. This is also displayed as + <guimenuitem>"What's This"</guimenuitem> if you + <keycombo action="simul">&Shift; + <keycap>F1</keycap></keycombo> click on your + UserAction.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Use Tooltip checkbox"</guimenuitem>: Uses the + tooltip as description.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Command line"</guimenuitem>: The command which + will be executed. You can add placeholder using a GUI with + the + <guibutton>add</guibutton> button.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Startpath"</guimenuitem>: The working directory + for the command which will be executed.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Execution mode"</guimenuitem>:</para> + <itemizedlist> + <listitem> + <para> + <guimenuitem>"Normal"</guimenuitem>: Normal execution + mode.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Run in terminal"</guimenuitem>: Runs the + command in the terminal.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Collect output"</guimenuitem>: Collects the + output of the executed program in a &GUI; + window.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"Separate standard error"</guimenuitem>: + When "Collect output" is used the stdout and stderr are + separately collected.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para> + <guimenuitem>"Command accepts"</guimenuitem>:</para> + <itemizedlist> + <listitem> + <para> + <guimenuitem>"Local files (no URLs)"</guimenuitem>: Tells + the placeholder it should return local addresses.</para> + </listitem> + <listitem> + <para> + <guimenuitem>"URLs (local and remote)"</guimenuitem>: + Tells the placeholder it should return + &URL;s.</para> + </listitem> + </itemizedlist> + </listitem> + <!-- Not yet implemented, but will be after 1.50 stable is released + <listitem><para><guimenuitem>"On multiple selection"</guimenuitem>: </para> + <itemizedlist> + <listitem><para><guimenuitem>"separate call for each file"</guimenuitem>: executes the command for each selected file. + </para></listitem> + </itemizedlist> + </listitem> --> + <listitem> + <para> + <guimenuitem>"Shortcut button"</guimenuitem>: Configures a + shortcut for the UserAction.</para> + </listitem> + </itemizedlist></para> + <para> + <emphasis role="bold">Command-line syntax:</emphasis> + </para> + <para>Basically, everything you type in the command line will get + executed (if you type "ls -l", "ls -l" gets executed). You have + the possiblity to get a character string from + &krusader; which represents the current state of the + panel. This is done using placeholders. A placeholder begins with + a percent-sign ('%') and is followed by a panel indicator ('a' + for the active, 'o' for the other, 'l' for the left and 'r' for + the right panel. If the placeholder doesn't need a panel to + operate on, you have to indicate this by an underscore ('_')). + Then comes the name of the placeholder (see the list below), + which may get some parameters enclosed in quotes. Finally, again + the percent sign.</para> + <para>This sounds very complicated, so let's make an example: + '%aList("Selected")%' is replaced by a list of all selected items + in the active panel. So a command like 'xmms --enqueue + %aList("All", " ", "", "*.mp3")%' will execute xmms with a list + of all .mp3s in the current panel, separated by a single + blank.</para> + <para>Currently, these placeholders are implemented: + <itemizedlist> + <listitem> + <para> + <userinput>Path</userinput> - replaced by the panels + path</para> + <orderedlist> + <listitem> + <para>&useraction-optional-parameter; + Automatic escape spaces. &useraction-default; + yes</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Count</userinput> - replaced by the number of + <first parameter></para> + <orderedlist> + <listitem> + <para>&useraction-parameter; Which items; + either "All", "Selected", "Files" or "Dirs"</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Filter</userinput> - replaced by the panel's filter + mask</para> + </listitem> + <listitem> + <para> + <userinput>Current</userinput> - replaced by the current + item</para> + <orderedlist> + <listitem> + <para>&useraction-optional-parameter; Omit the + current path. &useraction-default; no</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + Automatic escape spaces. &useraction-default; + yes</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>List</userinput> - replaced by a list of all + <first parameter></para> + <orderedlist> + <listitem> + <para>&useraction-parameter; Which items; + either "All", "Selected", "Files" or "Dirs"</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + Separator between the items. + &useraction-default; + " "</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; Omit the + current path. &useraction-default; no</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + Filtermask (for all but "Selected"). + &useraction-default; *</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + Automatic escape spaces. &useraction-default; + yes</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Select</userinput> - manipulates the selection in a + panel</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; Filtermask</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; + manipulate in which way; either "Set", "Add" or "Remove". + &useraction-default; "Set"</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Goto</userinput> - changes the panels' path to + <first parameter></para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A relative or + absolute path, or an URL</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; Open the + location in a new tab. &useraction-default; + no</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Ask</userinput> - asks the user for some text and + is replaced by the answer</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; The + Question</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; A + default answer</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; A + caption for the question box</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Clipboard</userinput> - manipulates the + clipboard</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; The text that + should go to the clipboard (you may want to use + "%aCurrent%" here)</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; Append + the text to the current content of the clipboard with + this separator</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Copy</userinput> - copies a file, useful for quick, + local backups</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; What should be + copied</para> + </listitem> + <listitem> + <para>&useraction-parameter; Where it should + be copied</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Sync</userinput> - opens the Synchronizer with a + given profile</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A profile for the + Synchronizer</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>NewSearch</userinput> - opens the search windows + with a given profile</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A profile for the + search module</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Profile</userinput> - loads a given panel + profile</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A panel + profile</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Each</userinput> - splits the commandline into a + list. These commands are executed one after another.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A list item (all, + all files, all dirs, all selected).</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Move</userinput> - move from source to + destination.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; A source</para> + </listitem> + <listitem> + <para>&useraction-parameter; A + destination</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>PanelSize</userinput> - change the ratio between + the two panels.</para> + <orderedlist> + <listitem> + <para>&useraction-optional-parameter; A + integer value, e.g., 80 makes the active panel use 80% of + &krusader;'s width (height in vertical mode), + omitting the parameter means 50%.</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Ask</userinput> - cancel the execution.</para> + <orderedlist> + <listitem> + <para>&useraction-optional-parameter; A string + for the cancel question.</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>Script</userinput> - executes an external + <link linkend="javascript_console"> + Javascript</link> file.</para> + <para>NOTE: This is still experimental and the interface may + change, feedback is always welcome.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; path to the + external foo.js file, absolute path or relative to + <filename> + <kde-app-data>/krusader/js/</filename>. + <kde-app-data> is + <filename>$(kde-config + --localprefix)/share/apps/</filename> or + <filename>$(kde-config --prefix)/share/apps/</filename>, + for those who don't know where to copy the + scripts/extensions. If all the needed files (normally + <filename>.js</filename> and maybe + <filename>.ui</filename>) are in one of these dirs it's + sufficient to give the file name only as 1. + parameter.</para> + </listitem> + <listitem> + <para>&useraction-optional-parameter; a list + of variables which should be set, like "return=cmd; + a=lalala; b='%_Ask(..)'" so that the placeholder is + replaced be the content of the variable cmd and the other + two have already these values when the script + starts.</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>ListFile</userinput> - is replaced by path/file name + of a temporary file containing a list of items</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; + path/filename</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>ColSort</userinput> - set the sorting on a column + of a specific panel.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; Column: Either + "Name", "Ext", "Type", "Size", "Modified", "Perms", + "rwx", "Owner" and "Group"</para> + </listitem> + <listitem> + <para>&useraction-parameter; Sort sequence: + Either "Toggle", "Asc", "Desc"</para> + </listitem> + </orderedlist> + </listitem> + <listitem> + <para> + <userinput>View</userinput> - set the view mode.</para> + <orderedlist> + <listitem> + <para>&useraction-parameter; View mode: Either + "generic", "text", "hex"</para> + </listitem> + <listitem> + <para>&useraction-parameter; Window Mode: + Either "tab", "window"</para> + </listitem> + </orderedlist> + </listitem> + </itemizedlist>A GUI-based helper for placeholder adding is + provided. Spaces In Path, Current and List are by default, + automatically escaped. There is one more important thing to know: + All placeholders that interact with &krusader; + internal functions are called at expand time (meaning directly + when the placeholders are replaced). External programs are + called at execution time (meaning after all placeholders are + replaced).</para> + <para> + <emphasis role="bold"> + <guimenuitem>Advanced Properties</guimenuitem> + </emphasis> + </para> + <para>Here you can configure where your command should be visible + (for the right click menu) In addition, it is possible to change + the command executed and confirm it separately. You can also set + a user under which the command should be executed. + <itemizedlist> + <listitem> + <para>Configures if the action is valid for a Protocol, Path, + Mime type or File name.</para> + </listitem> + <listitem> + <para>Tweaking the command line before being executed.</para> + </listitem> + <listitem> + <para>Set a different user for the execution (this has no + effect in &krusader; internal functions)</para> + </listitem> + </itemizedlist></para> +</sect1> diff --git a/doc/en/using-krusader.docbook b/doc/en/using-krusader.docbook new file mode 100644 index 0000000..f19d719 --- /dev/null +++ b/doc/en/using-krusader.docbook @@ -0,0 +1,426 @@ +<chapter id="basic-functions"> + <!-- ********************************************************************** + using-krusader.docbook + +++++++++++++++++++++++++++ + copyright : (C) 2000 - 2008 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + <title>Basic Functions</title> + <sect1 id="controls"> + <title>Controls</title> + <sect2 id="control-general"> + <title>General</title> + <para>This is a rather short but important section that will + go into the details of controlling &krusader;. + This section does not try to cover all the various key + combinations for two reasons: + <orderedlist numeration="arabic"> + <listitem> + <para>there are just too many of them</para> + </listitem> + <listitem> + <para>most of &krusader; actions are + configurable in the + &konfiglookandfeel-lnk;</para> + </listitem> + </orderedlist>We will only mention the most important + keyboard shortcuts with the default configuration, but keep + in mind that most of the &keybindigs-lnk; are + configurable. If you find that you use a certain command a + lot and want to know the shortcut for this command, or you + want to change this command shortcut, then check out the + &keybindigs-lnk; tab at the + &konfiglookandfeel-lnk;.</para> + </sect2> + <sect2 id="moving-around"> + <title>Moving Around</title> + <para>By Moving Around we mean the transfer of the keyboard + and mouse focus between the different parts of the + &krusader; + <link linkend="mainwindow">main window</link>. The focus can + be in one of five places: the Left or Right Panel, the Menu + Bar, the Command Line or the Terminal Emulator. The panel + that has the focus is called the Active Panel. An Active + Panel will remain active until the other panel receives the + focus (&ie;: if the Left Panel was active and you + clicked on the Command Line - then the Left Panel remains the + Active Panel). You must deliberately change which panel is + active.</para> + <para>The most common way to transfer the focus to a specific + panel is to use the mouse to click on that panel. But you + should be aware of the following: + <itemizedlist> + <listitem> + <para>Clicking on the Toolbar, the FN keys bar or the + Status Bar does *not* change the focus.</para> + </listitem> + <!-- + Quick View Panel: old Krusader feature , removed since krusader-1.12-beta1 + <listitem> + <para>The display part of the Quick View Panel does not accept clicks so you should click on the + Location Toolbar of this panel if you want it to have focus.</para> + </listitem> +--> + <listitem> + <para>Pushing the + <guibutton>"History"</guibutton> or the + <guibutton>"Run in Terminal"</guibutton> buttons in the + Command Line will not transfer the focus, so you have to + click inside the Input Line.</para> + </listitem> + <listitem> + <para>When you choose a menu, the Menu Bar will become + focused. It remains focused until you choose a command - + the focus returns to the previous owner.</para> + </listitem> + </itemizedlist></para> + <para>There are, of course, ways to use the keyboard to + change the focus: + <itemizedlist> + <listitem> + <para>The 	 Key will switch panels, if one + of the panels has the focus or rotate between all the + commands in a menu, if the Menu Bar is active.</para> + </listitem> + <listitem> + <para>The + <keycombo action="simul">&Ctrl; + <keycap>Down Arrow</keycap></keycombo> will take you from + the Active Panel to the Command Line or Terminal + Emulator, and the + <keycombo action="simul">&Ctrl; + <keycap>Up Arrow</keycap></keycombo> will take you back + from the Command Line to the Active Panel.</para> + </listitem> + <listitem> + <para>The &Esc; Key will make the Menu Bar + return the focus, if it has it, to the previous Active + Panel.</para> + </listitem> + <listitem> + <para>If you happen to be inside the Terminal Emulator, + you can use the 	 Key, or the mouse, to + navigate to an Active Panel.</para> + </listitem> + <listitem> + <para>Pressing + <keycombo action="simul">&Alt; + <keycap>"Underlined Letter"</keycap></keycombo> from the + Menu Bar will open that menu (unless this key combination + is a "Reserved Key", used by one of + &krusader;'s actions).</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="selecting-files"> + <title>Selecting</title> + <note> + <para>&krusader; offers 4 + &mouse-selection-modes-lnk;, only + &krusader;'s Mouse Selection Mode is explained + here.</para> + </note> + <para>Selecting is a skill you need to master in order to get + the most out of &krusader;. Since you can not select + files in the Quick View Panel, and the Tree Panel only lets + you select one directory at a time, this paragraph mainly + explains how to select files in the List Panel + filelist.</para> + <para>Moving the cursor is easy. Left-clicking on a file or + directory (referred to herein as "elements" meaning files AND + directories) will select it. Here are some useful pointers + that will make &krusader; even easier to use (assuming you are + using &krusader;'s Mouse Selection Mode): + <itemizedlist> + <listitem> + <para>The + <keycap>SPACE</keycap> and + <keycap>Insert</keycap> key will toggle the selection of + the file under the cursor without affecting the selection + of other files/directories, the cursor will go one + position down.</para> + </listitem> + <listitem> + <para>Pressing the + <keycap>SPACE</keycap> on a Directory under the cursor + will + <link linkend="calculate">calculate occupied + space</link> without affecting the selection of other + files/directories.</para> + </listitem> + <listitem> + <para> + <keycap>Left Clicking</keycap> on a file will select, or + unselect, all previously selected files.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Ctrl; + <keycap>Left Clicking</keycap></keycombo> will toggle the + selection of the file under the cursor without affecting + the selection of other files/directories.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Left Clicking</keycap></keycombo> will select all + the elements between the previous cursor location and the + new one.</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>Home</keycap></keycombo> selects everything above + the cursor (and deselects everything below the cursor, if + selected).</para> + </listitem> + <listitem> + <para> + <keycombo action="simul">&Shift; + <keycap>End</keycap></keycombo> selects everything below + the cursor (and unselects everything above the cursor, if + selected).</para> + </listitem> + <listitem> + <para>The ".." entry is not selectable.</para> + </listitem> + <listitem> + <para>The &editmenu-lnk; can offer more ways + to select your files.</para> + </listitem> + </itemizedlist></para> + </sect2> + <sect2 id="executing_commands"> + <title>Executing Commands</title> + <para>There is not a lot to say here, all you need to do is + select some files (if you do not, &krusader; will + operate on the file(s) or directory(s) that have the focus), + choose a + <link linkend="menu-commands">Command</link> from the Menu Bar + or use a Keyboard Shortcut (or the Right Click Menu) and the + selected Command executes. See also + <link linkend="executing_files">Executing + Files</link>.</para> + </sect2> + <sect2 id="quicksearch"> + <title>Quicksearch</title> + <!-- Thanks to Heiner Eichmann --> + <para>This feature will do a quick search for the file name + in the Active List Panel.</para> + <para>Type + <keycap>foo</keycap>(one character) to do a quick search in + the Active List Panel for a file beginning with "foo". A + small quick search dialog box will open below the Active List + Panel. Type the first few characters of the desired file name + (more than one character allowed), the cursor will jump to + that filename (if it exists), ⪚ type "ab" to + search for a file which begins with "ab". The + <keycap>Up/Down Arrow</keycap>will jump to the next or + previous match. &Esc; will close the quick search + line. The cursor will stay on the last file + found.</para> + <note> + <para>If you press + <keycombo action="simul">&Alt; + <keycap>foo</keycap></keycombo>, the key binding shortcut + will be executed. If there is no configured key binding, + the remaining letter + <keycap>foo</keycap>will be used for the quick + search.</para> + </note> + <para>Use &konfiglookandfeel-lnk; to change from + the default configuration.</para> + </sect2> + <sect2 id="context-menu"> + <title>Context Menu</title> + <para>&krusader; has many Context menus that allow + you to do fast operations with the mouse, usually a + right-click will open the Context menu (depending on your + &mouse-selection-modes-lnk; settings). This list + gives an overview of the most important context menus. Use + them to discover the available commands. + <itemizedlist> + <listitem> + <para>&main-toolbar-lnk; (orientation, text + position, icon size)</para> + </listitem> + <listitem> + <para>&list-panel-lnk; on a file or + directory</para> + </listitem> + <listitem> + <para>&cmdline-lnk; (undo, paste, text + completion...)</para> + </listitem> + <listitem> + <para>&termemu-lnk; (send signal, font, + history...)</para> + </listitem> + <listitem> + <para>&foldertabs-lnk; (new, duplicate, + close)</para> + </listitem> + <listitem> + <para> + <link linkend="krusearcher">KruSearcher</link> Search + results file list (F3 View, F4 Edit)</para> + </listitem> + <listitem> + <para>&mountman-lnk; (unmount, + format...)</para> + </listitem> + <listitem> + <para>&syncdirs-lnk; File List</para> + </listitem> + <listitem> + <para>&useractions-lnk;</para> + </listitem> + <listitem> + <para>&konqueror; Right-Click actions are + shown in &krusader;</para> + </listitem> + <listitem> + <para>Show/hide + <link linkend="list_panel">Column Headers</link></para> + </listitem> + <listitem> + <para>&bookmarks-lnk; enable/disable permanent + bookmarks</para> + </listitem> + <listitem> + <para>...</para> + </listitem> + </itemizedlist></para> + </sect2> + </sect1> + <sect1 id="basic"> + <title>Basic File Management</title> + <sect2 id="executing_files"> + <title>Executing Files</title> + <para>You can only execute files in the Active List Panel. To + <keycap>execute</keycap> a file just + <keycap>(double-)click on it or press Enter</keycap> when it + is under the list cursor. &krusader; will open it + in the default application for this file type (picture, + text file...) or the file will be executed (script, + binary...). If you want to use + <keycap>another application</keycap> to open the file, + <keycap>Right-Click</keycap> on the file and go to the "open + with" sub-menu which will offer more options. + &krusader; is compatible with &kde; + default file manager for all file types except archives that + are opened inside the &krusader; panel and not in + an external application. See + <link linkend="konfig-archives">the archives page in + Konfigurator</link>for details.</para> + </sect2> + <sect2 id="copying"> + <title>Copying and Moving</title> + <para>To copy or move files/directories just select them and + press + <keycap>F5</keycap>to + <keycap>copy</keycap>or + <keycap>F6</keycap>to + <keycap>move</keycap>them. If the + <guimenuitem>Preserve attributes (only on local + targets)</guimenuitem> option is checked, + &krusader; will try to preserve all attributes + (time, owner, group) of the local files according to the + source depending on your permissions: + <itemizedlist> + <listitem> + <para>User preserving if you are root</para> + </listitem> + <listitem> + <para>Group preserving if you are root or member of the + group</para> + </listitem> + <listitem> + <para>Preserving the timestamp</para> + </listitem> + </itemizedlist>Using this option may slow down the copy/move + process. A dialog will appear and allow you to choose the + operation destination. The default destination is the + other-panel browsed directory. If you enter a partial + &URL;, &krusader; will use the current + panel directory as the &URL; base.</para> + </sect2> + <sect2 id="deleting"> + <title>Deleting</title> + <para>Deleting files/directories is done by selecting them + and pressing + <keycap>F8</keycap> or + <keycap>Delete</keycap>. By + <link linkend="konfig-general">default</link>it will be moved + to &kde;'s Trash, + <keycombo action="simul">&Shift; + <keycap>Delete</keycap></keycombo> will delete the file + permanently. A dialog will ask for your confirmation and will + warn you when deleting non-empty directories. Of course only + operations that you are permitted to do by the Operating + System will be performed - you will be notified otherwise. If + you do not wish to see the confirmation dialogs, you can + disable them in the + <link linkend="konfig-advanced">Konfigurator advanced + tab</link>.</para> + </sect2> + <sect2 id="shred"> + <title>Shred Files</title> + <para>When you delete files in your local system, they are + not completely erased and the information stored in them can + be recovered using special software and hardware tools. If + you want to erase a file without recoverable traces, select + the file and use + <emphasis role="bold"> + <menuchoice> + <guimenu>Right-Click menu</guimenu> + <guimenuitem>Shred</guimenuitem> + </menuchoice> + </emphasis>.</para> + </sect2> + <sect2 id="renaming"> + <title>Renaming Files, Creating Directories and Link + Handling</title> + <para> + <keycap>Rename</keycap> the file under the cursor with the + <keycap>F9</keycap> key or with two single mouse clicks. If + only the file name needs to be renamed and not the extension, + you can configure this in the + &konfiglookandfeel-lnk;. + <keycap>Create a new directory</keycap> with the + <keycap>F7</keycap> key. + <keycap>Right-clicking on a regular file</keycap> will give + you the + <keycap>option "New Symlink"</keycap>. A dialog will prompt + you to enter a symlink name. That name will point to the + file/directory you Right-Clicked on. If the file you + Right-Clicked on is a symlink, you will also be presented + with the "redirect link" option that will allow you to change + the link target.</para> + </sect2> + <sect2 id="viewing"> + <title>Viewing and Editing files</title> + <para> + <link linkend="krviewer">KrViewer</link> has a chapter of its + own.</para> + </sect2> + </sect1> + +<!-- call the archives sect1 section --> +&archives; + +</chapter> diff --git a/doc/en/vfs.docbook b/doc/en/vfs.docbook new file mode 100644 index 0000000..8acb910 --- /dev/null +++ b/doc/en/vfs.docbook @@ -0,0 +1,83 @@ +<sect1 id="vfs"> + <title>Virtual file systems (VFS)</title> + <indexterm> + <primary>VFS</primary> + </indexterm> + <para>A basic + <link linkend="features">OFM feature</link> is VFS, this an + abstracted layer over all kinds of archived information (ZIP + files, FTP servers, TAR archives, NFS filesystems, SAMBA shares, + ISO cd/dvd images, RPM catalogs, etc.), which allows the user to + access all the information in these divergent types of + filesystems transparently - just like entering an ordinary + sub-directory. &krusader; supports several virtual + file systems: + <itemizedlist> + <listitem> + <para> + <link linkend="remote-connections">Remote connections + VFS</link>: provides the capability of working with a remote + connection session (FTP, NFS, Samba, FISH, SFTP) like with + local filesystems. It is perfect for complex remote operations + and almost as powerful as most standalone GUI remote + clients.</para> + </listitem> + <listitem> + <para> + <link linkend="archives">Archive VFS</link>: allows to browse + archives in VFS as it was a directory (ace, arj, bzip2, deb, + gzip, iso, lha, rar, rpm, tar, zip and 7-zip).</para> + </listitem> + <listitem> + <para> + <link linkend="archives">Search VFS</link>: + <guibutton>Feed to listbox</guibutton> places the search + results in VFS.</para> + </listitem> + <listitem> + <para> + <link linkend="synchronizer">Synchronizer VFS</link>: places + the synchronizer results in VFS.</para> + </listitem> + </itemizedlist>Actions you perform on the files in VFS are + performed on the 'real' files. You do not just delete files from + the VFS - you delete them from your hard drive. Limitations: you + ca not create directories inside a VFS.</para> + <para>It is possible to keep the directory structure when doing a + from copy from a virtual folder to a non virtual folder, by + selecting the "Keep virtual directory structure" check box of the + copy dialog. Imagine the following virtual folder: + <screen><prompt>$</prompt> <userinput>file:/home/myhome/mydir1/myfile1</userinput></screen> + <screen><prompt>$</prompt> <userinput>file:/home/myhome/mydir1/myfile2</userinput></screen> + <screen><prompt>$</prompt> <userinput>file:/home/myhome/mydir2/myfile3</userinput></screen> + Then do the following steps: + <itemizedlist> + <listitem> + <para>go to the virtual folder and select the files</para> + </listitem> + <listitem> + <para>select a destination folder (non virtual!)</para> + </listitem> + <listitem> + <para>press + <keycap>F5</keycap>-> copy dialog + appears</para> + </listitem> + <listitem> + <para>Check + <guilabel>Keep virtual directory structure</guilabel></para> + </listitem> + <listitem> + <para>Select + <filename>/home/myhome/</filename> for base + &URL;</para> + </listitem> + <listitem> + <para>Start copy by pressing OK</para> + </listitem> + </itemizedlist>The result will be: + <screen><prompt>$</prompt> <userinput>destinationdir/mydir1/myfile1</userinput></screen> + <screen><prompt>$</prompt> <userinput>destinationdir/mydir1/myfile2</userinput></screen> + <screen><prompt>$</prompt> <userinput>destinationdir/mydir2/myfile3</userinput></screen> + </para> +</sect1> diff --git a/doc/en/viewer-editor.docbook b/doc/en/viewer-editor.docbook new file mode 100644 index 0000000..b9a845a --- /dev/null +++ b/doc/en/viewer-editor.docbook @@ -0,0 +1,1127 @@ +<sect1 id="krviewer"> + <title>KrViewer: &krusader;'s internal + viewer-editor</title> + <indexterm> + <primary>Viewer</primary> + <seealso>Editor</seealso> + </indexterm> + <para>Pressing &Enter; on a selected file + <emphasis>opens the file with the associated + application</emphasis>. The editor-viewer is tabbed, configure it + on the &konfiggereral-lnk;</para> + <sect2 id="krview"> + <title>Viewer</title> + <para>To view a file as fast as possible according to its type, + just put it under the cursor and press + <keycap>F3</keycap>. &krusader;'s internal viewer is + actually a part of &konqueror;, which can basically + view every file type viewable by &konqueror; + (⪚ display pictures, play music, show the content + of an archive). This is called the 'Generic viewer', for which + you need to configure the mime types.</para> + <para>The viewer works as follows: + <itemizedlist> + <listitem> + <para>It tries to view the file with the + <emphasis>'Generic viewer'.</emphasis></para> + </listitem> + <listitem> + <para>When the file type (mime type) cannot be determined or + when a file (⪚ a binary) doesn't have an + associated action, it disables the 'generic viewer'. The + file is treated as a text file, which is the + <emphasis>'Text viewer'</emphasis>.</para> + </listitem> + <listitem> + <para>The user can change in the + <link linkend="kredit_krviewer_menu">KrViewer + menu</link> between: 'Generic viewer' (if available), 'Text + viewer' and + <emphasis>'Hex viewer'</emphasis>.</para> + </listitem> + </itemizedlist>You can configure the default viewer mode on the + &konfiggereral-lnk; .</para> + <para> + <keycombo action="simul">&Shift; + <keycap>F3</keycap></keycombo>views a &URL; on + demand, ⪚: + <itemizedlist> + <listitem> + <para> + <userinput> + <command>man:/</command> + </userinput>views the manpages.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>man:/</command> + <replaceable>krusader</replaceable> + </userinput>views a manpage.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>info:/</command> + </userinput>views the infopages.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>http://</command> + <replaceable>krusader.sourceforce.net/</replaceable> + </userinput>views a webpage.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>ftp://</command> + <replaceable>ftp.kde.org/pub/kde/</replaceable> + </userinput>views a ftp-server.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>sftp://</command> + <replaceable>sftp.foo/</replaceable> + </userinput>views a secure ftp-server.</para> + </listitem> + <listitem> + <para> + <userinput> + <command>file:/</command> + <replaceable>home/frank</replaceable> + </userinput>views the homedirectory of Frank.</para> + </listitem> + <listitem> + <para> + <userinput> + <replaceable>/home/frank/archive.tar.gz</replaceable> + </userinput>views a + <literal role="extension">tar.gz</literal> archive.</para> + </listitem> + </itemizedlist></para> + <para>KrViewer can have the following menus: + <link linkend="kredit_file_menu">File</link>, + <link linkend="kredit_edit_menu">Edit</link>, + <link linkend="kredit_view_menu">View</link>, + <link linkend="kredit_settings_menu">Settings</link> and + <link linkend="kredit_krviewer_menu">Krviewer</link>, depending + on which file type is viewed. They will be discussed in the + <link linkend="kredit">Editor section</link>. The internal + viewer can follow links on HTML pages. With + <keycombo action="simul">&Ctrl; + <keycap>E</keycap></keycombo> the viewer can start + &krusader;'s internal editor (which is basically the + same application).</para> + <note> + <para>The embedded viewer is not written by us, it is + supplied via &kde; (libs) and + &kioslaves1-url; We cannot and do not want to + change it, usings these libraries reduces the amount of + written code. So we do not have to reinvent the wheel + ;-)</para> + </note> + </sect2> + <sect2 id="kredit"> + <title>Editor</title> + <indexterm> + <primary>Editor</primary> + </indexterm> + <para>&krusader;'s internal editor has almost + everything that you can expect of an editor. Editing is similar + to viewing but with the + <keycap>F4</keycap> key. The default editor is + &krusader;'s internal editor. You can change the + default editor in the &konfiggereral-lnk;, if you + prefer to use an external editor.</para> + <tip> + <para>When you use &krusader;'s internal editor + for the first time, it is recommended to look at each section + of the + <link linkend="kredit_settings_menu">Settings</link>menu, and + configure it the way you want it.</para> + </tip> + </sect2> + <sect2 id="kredit_menus"> + <title>Menu overview</title> + <para>Most of the menus are quite self-explanatory. ;-)</para> + <!-- FILE menu --> + <variablelist id="kredit_file_menu"> + <title> + <guimenu>File</guimenu>menu</title> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>S</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Save</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Save file.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Save As</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Save file with another name.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F5</keycap> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Reload</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Reload file.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>File</guimenu> + <guimenuitem>Export</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Export the file to + <literal role="extension">HTML</literal> format.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>P</keycap></keycombo> + </shortcut> + <guimenu>File</guimenu> + <guimenuitem>Print</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Print the file.</para> + </listitem> + </varlistentry> + </variablelist> + <!-- EDIT menu --> + <variablelist id="kredit_edit_menu"> + <title> + <guimenu>Edit</guimenu> menu</title> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>Z</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Undo</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Undo last action.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>Z</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Redo</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Redo last action.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>X</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Cut</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Cut selected text to clipboard.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>C</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Copy</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Copy selected text to clipboard.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>V</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Paste</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Paste clipboard content to the document.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>A</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Select All</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Select whole document.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>A</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Deselect</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Deselect current selection.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>B</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Block Selection Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggle Block Selection, which will + activate/deactivate the block selection + possibility.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>Insert</keycap> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Overwrite Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Toggle Insert/Overwrite Mode.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>F</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Find</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Find text.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + <keycap>F3</keycap> + </keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Find Next</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Find next text.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Shift; + <keycap>F3</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Find Previous</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Find previous text.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>R</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Replace</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Replace text.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>G</keycap></keycombo> + </shortcut> + <guimenu>Edit</guimenu> + <guimenuitem>Go to line</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Go to given line number.</para> + </listitem> + </varlistentry> + </variablelist> + <!-- VIEW menu --> + <variablelist id="kredit_view_menu"> + <title> + <guimenu>View</guimenu>menu</title> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F7</keycap> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Switch to Command Line.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Display Command Line.</para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Schema.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Set Schema ⪚ &krusader; + Normal, &krusader; Printing, &kate; + Normal, &kwrite; Normal.</para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F10</keycap> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Dynamic Word Wrap</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Go to the next line at the maximum number of + characters per line (default 80).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Dynamic Word Wrap Indicators</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Off, Follow Line Numbers, Always On.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Shows Static Word Wrap + marker</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F6</keycap> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Show Icon Border</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows Icon Border.</para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F11</keycap> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Show Line Numbers</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shows the line numbers.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Show Scrollbar Marks.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycap>F9</keycap> + </shortcut> + <guimenu>View</guimenu> + <guimenuitem>Hide Folding Markers</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Code Folding.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO --> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>View</guimenu> + <guimenuitem>Set Encoding</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>⪚ ISO8859-1, utf8, utf16, tscii, ... + .</para> + </listitem> + </varlistentry> + </variablelist> + <!-- BOOKMARKS menu --> + <variablelist id="kredit_bookmarks_menu"> + <title> + <guimenu>Bookmarks</guimenu>menu</title> + <varlistentry> + <term> + <!-- TODO --> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>B</keycap></keycombo> + </shortcut> + <guimenu>Bookmark</guimenu> + <guimenuitem>Set Bookmark</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Bookmark</guimenu> + <guimenuitem>Clear All Bookmarks</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <!-- These entries are gone on my system with kde3.3.2 + +<varlistentry> + <term> + <menuchoice> + <shortcut><keycombo action="simul">&Alt;<keycap>PageDown</keycap></keycombo></shortcut> + <guimenu>Bookmark</guimenu> + <guimenuitem>Next Bookmark</guimenuitem></menuchoice></term> + <listitem> + <para>Go to the next Bookmark.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <shortcut><keycombo action="simul">&Alt;<keycap>PageUp</keycap></keycombo></shortcut> + <guimenu>Bookmark</guimenu> + <guimenuitem>Previous Bookmark</guimenuitem></menuchoice></term> + <listitem> + <para>Go to the previous Bookmark.</para> + </listitem> + </varlistentry> +--> + </variablelist> + <!-- TOOLS menu --> + <variablelist id="kredit_tools_menu"> + <title> + <guimenu>Tools</guimenu>menu</title> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Read Only Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Filetype Mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Highlight mode</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Highlight mode for scripts, programming languages, + markup file, &etc;: ⪚ + <literal role="extension">HTML, Bash, C++, XML, Makefile, + Diff, ...</literal>.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>End of Line</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Change the end of Line termination: + &UNIX;, &Windows;/DOS, + <trademark class="registered"> + Macintosh</trademark>.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>I</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Indent</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO--> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>I</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Unindent</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO--> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Clean Indentation</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO--> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>D</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Comment</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Add appropriate comment tags, if available.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>D</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Uncomment</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Removes the comment tags on the left.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Uppercase</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Lowercase</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Alt;&Ctrl; + <keycap>U</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Capitalize</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>J</keycap></keycombo> + </shortcut> + <guimenu>Tools</guimenu> + <guimenuitem>Join Lines</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Tools</guimenu> + <guimenuitem>Word Wrap Document</guimenuitem> + </menuchoice> + </term> + <listitem> + <para></para> + <!-- TODO--> + </listitem> + </varlistentry> + </variablelist> + <!-- SETTINGS -> CONFIGURE EDITOR menu --> + <variablelist id="kredit_settings_menu"> + <title> + <guimenu>Settings -> Configure + Editor</guimenu>menu</title> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>Colors</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Color configuration for the: Background, Selected + text, Current line and Bracket highlighting.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>Fonts</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Fonts configuration for display and printer: Font, + font Style and Size, with a preview window.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>Indentation</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Indentation configuration: Automatically indent, + use Spaces to indent, 	 Keys indent, + &Backspace; key unindents, keep indent + profile, keep extra spaces.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>Selection</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Selection configuration: Persistent selections, + Overwrite selected text.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>Editing</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Editing configuration: Word Wrap config., + Whitespace config, Auto brackets, Smart home, Wrap + cursor, Maximum undo steps.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>Shortcuts</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Shortcuts configuration.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>Highlighting</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Highlighting configuration: Default styles and + Highlight mode.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>View defaults</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>View defaults: Dynamic word wrap, show Line + numbers, show Icon border, show Folder markers if + available, sort Bookmarks menu method.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Configure Editor</guimenuitem> + <guimenuitem>Plugins</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Plugins configuration: ⪚ kTexteditor + incremental search plugin, kTexteditor insert file + plugin, kTexteditor kdatatoolplugin...</para> + </listitem> + </varlistentry> + </variablelist> + <!-- KRVIEWER menu --> + <variablelist id="kredit_krviewer_menu"> + <title> + <guimenu>KrViewer</guimenu>menu</title> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>G</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Generic viewer</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>&krusader;'s internal viewer is actually + part of Konqueror, which can basically view every file + type viewable by &konqueror; (⪚ + display pictures, play music, show the content of an + archive).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Ctrl; + <keycap>T</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Text viewer</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>View the file in text mode.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>H</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Hex viewer</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>View the file in hex mode.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>E</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Text editor</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Edit the file in text mode.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>Right</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Next Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Next browsing Tab.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul">&Alt; + <keycap>Left</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Previous Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Previous browsing Tab.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut> + <keycombo action="simul"> + &Ctrl;&Shift; + <keycap>D</keycap></keycombo> + </shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Detach Tab</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Detach browsing Tab and open in a new + window.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut>&Esc;</shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Close current Tab.</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Close current browsing Tab.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice> + <shortcut>&Ctrl; + <keycap>Q</keycap></shortcut> + <guimenu>KrViewer</guimenu> + <guimenuitem>Close</guimenuitem> + </menuchoice> + </term> + <listitem> + <para>Closes &krusader;'s viewer/editor + window.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> +</sect1> diff --git a/doc/fdl-license b/doc/fdl-license new file mode 100644 index 0000000..2f56ad4 --- /dev/null +++ b/doc/fdl-license @@ -0,0 +1,356 @@ + GNU Free Documentation License + Version 1.1, March 2000 + + Copyright (C) 2000 Free Software Foundation, Inc. + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + +0. PREAMBLE + +The purpose of this License is to make a manual, textbook, or other +written document "free" in the sense of freedom: to assure everyone +the effective freedom to copy and redistribute it, with or without +modifying it, either commercially or noncommercially. Secondarily, +this License preserves for the author and publisher a way to get +credit for their work, while not being considered responsible for +modifications made by others. + +This License is a kind of "copyleft", which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft +license designed for free software. + +We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; +it can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + + +1. APPLICABILITY AND DEFINITIONS + +This License applies to any manual or other work that contains a +notice placed by the copyright holder saying it can be distributed +under the terms of this License. The "Document", below, refers to any +such manual or work. Any member of the public is a licensee, and is +addressed as "you". + +A "Modified Version" of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + +A "Secondary Section" is a named appendix or a front-matter section of +the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall subject +(or to related matters) and contains nothing that could fall directly +within that overall subject. (For example, if the Document is in part a +textbook of mathematics, a Secondary Section may not explain any +mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding +them. + +The "Invariant Sections" are certain Secondary Sections whose titles +are designated, as being those of Invariant Sections, in the notice +that says that the Document is released under this License. + +The "Cover Texts" are certain short passages of text that are listed, +as Front-Cover Texts or Back-Cover Texts, in the notice that says that +the Document is released under this License. + +A "Transparent" copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, whose contents can be viewed and edited directly and +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input +to text formatters. A copy made in an otherwise Transparent file +format whose markup has been designed to thwart or discourage +subsequent modification by readers is not Transparent. A copy that is +not "Transparent" is called "Opaque". + +Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, LaTeX input format, SGML +or XML using a publicly available DTD, and standard-conforming simple +HTML designed for human modification. Opaque formats include +PostScript, PDF, proprietary formats that can be read and edited only +by proprietary word processors, SGML or XML for which the DTD and/or +processing tools are not generally available, and the +machine-generated HTML produced by some word processors for output +purposes only. + +The "Title Page" means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the material +this License requires to appear in the title page. For works in +formats which do not have any title page as such, "Title Page" means +the text near the most prominent appearance of the work's title, +preceding the beginning of the body of the text. + + +2. VERBATIM COPYING + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies +to the Document are reproduced in all copies, and that you add no other +conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further +copying of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + + +3. COPYING IN QUANTITY + +If you publish printed copies of the Document numbering more than 100, +and the Document's license notice requires Cover Texts, you must enclose +the copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on +the back cover. Both covers must also clearly and legibly identify +you as the publisher of these copies. The front cover must present +the full title with all words of the title equally prominent and +visible. You may add other material on the covers in addition. +Copying with changes limited to the covers, as long as they preserve +the title of the Document and satisfy these conditions, can be treated +as verbatim copying in other respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy +a publicly-accessible computer-network location containing a complete +Transparent copy of the Document, free of added material, which the +general network-using public has access to download anonymously at no +charge using public-standard network protocols. If you use the latter +option, you must take reasonably prudent steps, when you begin +distribution of Opaque copies in quantity, to ensure that this +Transparent copy will remain thus accessible at the stated location +until at least one year after the last time you distribute an Opaque +copy (directly or through your agents or retailers) of that edition to +the public. + +It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to give +them a chance to provide you with an updated version of the Document. + + +4. MODIFICATIONS + +You may copy and distribute a Modified Version of the Document under +the conditions of sections 2 and 3 above, provided that you release +the Modified Version under precisely this License, with the Modified +Version filling the role of the Document, thus licensing distribution +and modification of the Modified Version to whoever possesses a copy +of it. In addition, you must do these things in the Modified Version: + +A. Use in the Title Page (and on the covers, if any) a title distinct + from that of the Document, and from those of previous versions + (which should, if there were any, be listed in the History section + of the Document). You may use the same title as a previous version + if the original publisher of that version gives permission. +B. List on the Title Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the Modified + Version, together with at least five of the principal authors of the + Document (all of its principal authors, if it has less than five). +C. State on the Title page the name of the publisher of the + Modified Version, as the publisher. +D. Preserve all the copyright notices of the Document. +E. Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. +F. Include, immediately after the copyright notices, a license notice + giving the public permission to use the Modified Version under the + terms of this License, in the form shown in the Addendum below. +G. Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice. +H. Include an unaltered copy of this License. +I. Preserve the section entitled "History", and its title, and add to + it an item stating at least the title, year, new authors, and + publisher of the Modified Version as given on the Title Page. If + there is no section entitled "History" in the Document, create one + stating the title, year, authors, and publisher of the Document as + given on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence. +J. Preserve the network location, if any, given in the Document for + public access to a Transparent copy of the Document, and likewise + the network locations given in the Document for previous versions + it was based on. These may be placed in the "History" section. + You may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission. +K. In any section entitled "Acknowledgements" or "Dedications", + preserve the section's title, and preserve in the section all the + substance and tone of each of the contributor acknowledgements + and/or dedications given therein. +L. Preserve all the Invariant Sections of the Document, + unaltered in their text and in their titles. Section numbers + or the equivalent are not considered part of the section titles. +M. Delete any section entitled "Endorsements". Such a section + may not be included in the Modified Version. +N. Do not retitle any existing section as "Endorsements" + or to conflict in title with any Invariant Section. + +If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + +You may add a section entitled "Endorsements", provided it contains +nothing but endorsements of your Modified Version by various +parties--for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + +You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + + +5. COMBINING DOCUMENTS + +You may combine the Document with other documents released under this +License, under the terms defined in section 4 above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its +license notice. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by +adding at the end of it, in parentheses, the name of the original +author or publisher of that section if known, or else a unique number. +Make the same adjustment to the section titles in the list of +Invariant Sections in the license notice of the combined work. + +In the combination, you must combine any sections entitled "History" +in the various original documents, forming one section entitled +"History"; likewise combine any sections entitled "Acknowledgements", +and any sections entitled "Dedications". You must delete all sections +entitled "Endorsements." + + +6. COLLECTIONS OF DOCUMENTS + +You may make a collection consisting of the Document and other documents +released under this License, and replace the individual copies of this +License in the various documents with a single copy that is included in +the collection, provided that you follow the rules of this License for +verbatim copying of each of the documents in all other respects. + +You may extract a single document from such a collection, and distribute +it individually under this License, provided you insert a copy of this +License into the extracted document, and follow this License in all +other respects regarding verbatim copying of that document. + + + +7. AGGREGATION WITH INDEPENDENT WORKS + +A compilation of the Document or its derivatives with other separate +and independent documents or works, in or on a volume of a storage or +distribution medium, does not as a whole count as a Modified Version +of the Document, provided no compilation copyright is claimed for the +compilation. Such a compilation is called an "aggregate", and this +License does not apply to the other self-contained works thus compiled +with the Document, on account of their being thus compiled, if they +are not themselves derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one quarter +of the entire aggregate, the Document's Cover Texts may be placed on +covers that surround only the Document within the aggregate. +Otherwise they must appear on covers around the whole aggregate. + + +8. TRANSLATION + +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section 4. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License provided that you also include the +original English version of this License. In case of a disagreement +between the translation and the original English version of this +License, the original English version will prevail. + + +9. TERMINATION + +You may not copy, modify, sublicense, or distribute the Document except +as expressly provided for under this License. Any other attempt to +copy, modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, +parties who have received copies, or rights, from you under this +License will not have their licenses terminated so long as such +parties remain in full compliance. + + +10. FUTURE REVISIONS OF THIS LICENSE + +The Free Software Foundation may publish new, revised versions +of the GNU Free Documentation License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See +http:///www.gnu.org/copyleft/. + +Each version of the License is given a distinguishing version number. +If the Document specifies that a particular numbered version of this +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. + + +ADDENDUM: How to use this License for your documents + +To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and +license notices just after the title page: + + Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.1 + or any later version published by the Free Software Foundation; + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + A copy of the license is included in the section entitled "GNU + Free Documentation License". + +If you have no Invariant Sections, write "with no Invariant Sections" +instead of saying which ones are invariant. If you have no +Front-Cover Texts, write "no Front-Cover Texts" instead of +"Front-Cover Texts being LIST"; likewise for Back-Cover Texts. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, +to permit their use in free software. diff --git a/doc/krusader.1 b/doc/krusader.1 new file mode 100644 index 0000000..4f9945b --- /dev/null +++ b/doc/krusader.1 @@ -0,0 +1,185 @@ +.TH krusader 1 "08 May 2006" Linux "Krusader Manpage" +.SH "NAME" +krusader \- advanced twin-panel file manager and ftp client for KDE +.SH "USAGE" +.B krusader [Qt-options] [KDE-options] [options] +.SH "DESCRIPTION" +Krusader is an advanced twin panel (commander style) +file manager for KDE and other desktops in the *nix world, +similar to Midnight or Total Commander. +It provides all the file management features you could possibly want. +Plus: extensive archive handling, +mounted filesystem support, FTP, advanced search module, +viewer/editor, directory synchronisation, file content comparisons, +powerful batch renaming and much much more. +It supports the following archive formats: ace, arj, bzip2, deb, +gzip, iso, lha, rar, rpm, tar, zip and 7-zip +and can handle other KIOSlaves such as smb:// or fish:// +It is (almost) completely customizable, very user friendly, +fast and looks great on your desktop! :-) +You should give it a try. + +.SH "OPTIONS" +.TP +.B --left <\fIpath\fR> +start left panel at <path> +.TP +.B --right <\fIpath\fR> +start right panel at <path> +.TP +.B --profile <\fIpanel-profile\fR> +Load <panel-profile> on startup +.TP +.B --help +show the general options +.TP +.B --help-all +show the all the options +.TP +.B --author +show the authors +.TP +.B -v, --version +show the version +.TP +.B --license +show the license +.SH "[Qt-options]" +"$ krusader --help-qt" shows the all the Qt-options +.SH "[KDE-options]" +"$ krusader --help-kde" shows the all the KDE-options +.SH "EXAMPLE" +.B $ krusader --left=/mnt/cdrom --right=ftp://[email protected] +.TP +.B $ krusader --left=/home,/usr,smb://workgroup.net --right=fish://myserver.net +.TP +.B $ krusader --profile=ftp_managment +.SH "FILES" +Configuration files: + +.I ~/.kde/share/config/krusaderrc + +.I ~/.kde/share/apps/krusader/krbookmarks.xml + +.I $KDEDIR/share/apps/krusader/krusaderui.rc or + +.I ~/.kde/share/apps/krusader/krusaderui.rc + +.SH "PLATFORMS" +All POSIX: Linux, Solaris, All BSD Platforms: FreeBSD, MacOS-X + +.I KDE 2.x + +krusader v1.01 stable but there are no planned changes. + +.I KDE 3.x + +The latest version of Krusader can be found at the Krusader website. + +Note: + +Krusader v1.01 needs KDElibs 2 + +Krusader v1.02 - 1.40 needs KDElibs 3 + +Krusader 1.40 prefers >= KDE 3.2 + +Krusader v1.50 - v1.51: KDE 3.2 - KDE 3.3 + +Krusader v1.60.0- v1.70.0: KDE 3.3 - KDE 3.4 + +Krusader 1.70.x-1.80.x: KDE 3.4 - KDE 3.5 + +Krusader 2.xx.x: KDE 4 the future Krusader + +.SH "FEATURES" + +OFM filemanager features. + +Strong keyboard orientation. + +Powerful internal viewer and editor. + +Advanced search module that can search in archives. + +Supports: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip. + +Directory comparison and filtering. + +Ftp/Samba client with a connection manager with SFTP/SCP support. + +Synchronizer, UserActions, Embedded console. Javascript console. + +Compare files by content. Easy editing of file permissions. + +Diskusage, Calculate occupied space. Checksum creation-verification. + +Fully mimetype-aware (with or without magic!). + +Mountmanager, Locate, Krename support. + +Root mode, Tabbed panels, PopUp Panel. Mouse selection modes. + +Profiles for: Panels, Key-bindings, Colors. + +For more features read http://krusader.sourceforge.net/handbook/features.html + +.SH "LICENSE" +Krusader is distributed under the terms of the GNU General Public + +License version 2 as published by the Free Software Foundation. + +See the built-in help for details on the License and the lack of warranty. + +The copyright for the project and its name are still held by Shie Erlich and Rafi Yanai. +.SH "i18n" +Krusader is translated into many languages. + +http://krusader.sourceforge.net/i18n.php + +Read the Krusader translation howto if you want translate Krusader in your native language. +.SH "FAQ" +The latest version of the KRUSADER FAQ can be found at the Krusader website. +.SH "SEE ALSO" +The Krusader Handbook, at the krusader help menu. + +The Krusader homepage on the World Wide Web: + +http://krusader.sourceforge.net +.fi +.SH "AUTHORS" + +Krusader is developed by a dedicated team of individuals, known as the Krusader Krew. + +Shie Erlich, author [erlich {*} users {.} sourceforge {.} net] + +Rafi Yanai, author [yanai {*} users {.} sourceforge {.} net] + +Dirk Eschler, Webmaster and i18n coordinator [deschler {*} users {.} sourceforge {.} net] + +Csaba Karai, Developer [ckarai {*} users {.} sourceforge {.} net] + +Heiner Eichmann, Developer [h {.} eichmann {*} gmx.de] + +Jonas Baehr, Developer [jonas.baehr {*} web.de] + +Frank Schoolmeesters, Documentation & Marketing Coordinator [frank_schoolmeesters {*} yahoo {.} com] + +Richard Holt, Documentation & Proofing [richard {.} holt {*} gmail {.} com] + +Matej Urbancic, Marketing & Product Research [matej {*} amis {.} net] + +The project is written using KDevelop and QT Designer. + +.SH "BUGS" +See the TODO file in the distribution for information on what remains to be done. + +.B Notice: if you've got bugs to report, please use the krusader website, and + +.B not KDE's bugzilla (bugs.kde.org). + +For fixes, patches and comments use the krusader forum or mail to + +[krusader {*} users {.} sourceforge {.} net]. + +Krusader Krew diff --git a/doc/pics/Makefile.am b/doc/pics/Makefile.am new file mode 100644 index 0000000..c5bd706 --- /dev/null +++ b/doc/pics/Makefile.am @@ -0,0 +1,60 @@ +####### kdevelop will overwrite this part!!! (begin)########## + + +EXTRA_DIST = bookmanadd.png bookmanedit.png cmdline.png fnkeys.png kgstartup.png krusader1.png listpanel.png mainwindow.png mountman.png actionman.png search_advanced.png search_general.png terminalEmu.png toolbar.png tabbed_browsing.png krusader_title.png syncdir.png + +install-data-local: + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/bookmanadd.png $(DESTDIR)$(kde_htmldir)/en/krusader/bookmanadd.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/bookmanedit.png $(DESTDIR)$(kde_htmldir)/en/krusader/bookmanedit.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/cmdline.png $(DESTDIR)$(kde_htmldir)/en/krusader/cmdline.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/fnkeys.png $(DESTDIR)$(kde_htmldir)/en/krusader/fnkeys.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/kgstartup.png $(DESTDIR)$(kde_htmldir)/en/krusader/kgstartup.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/krusader1.png $(DESTDIR)$(kde_htmldir)/en/krusader/krusader1.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/listpanel.png $(DESTDIR)$(kde_htmldir)/en/krusader/listpanel.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/mainwindow.png $(DESTDIR)$(kde_htmldir)/en/krusader/mainwindow.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/mountman.png $(DESTDIR)$(kde_htmldir)/en/krusader/mountman.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/actionman.png $(DESTDIR)$(kde_htmldir)/en/krusader/actionman.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/search_advanced.png $(DESTDIR)$(kde_htmldir)/en/krusader/search_advanced.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/search_general.png $(DESTDIR)$(kde_htmldir)/en/krusader/search_general.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/terminalEmu.png $(DESTDIR)$(kde_htmldir)/en/krusader/terminalEmu.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/toolbar.png $(DESTDIR)$(kde_htmldir)/en/krusader/toolbar.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/tabbed_browsing.png $(DESTDIR)$(kde_htmldir)/en/krusader/tabbed_browsing.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/krusader_title.png $(DESTDIR)$(kde_htmldir)/en/krusader/krusader_title.png + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/krusader/ + $(INSTALL_DATA) $(srcdir)/syncdir.png $(DESTDIR)$(kde_htmldir)/en/krusader/syncdir.png + +uninstall-local: + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/bookmanadd.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/bookmanedit.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/cmdline.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/fnkeys.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/kgstartup.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/krusader1.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/listpanel.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/mainwindow.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/mountman.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/actionman.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/search_advanced.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/search_general.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/terminalEmu.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/toolbar.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/tabbed_browsing.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/krusader_title.png + -rm -f $(DESTDIR)$(kde_htmldir)/en/krusader/syncdir.png +####### kdevelop will overwrite this part!!! (end)############ diff --git a/doc/pics/actionman.png b/doc/pics/actionman.png Binary files differnew file mode 100644 index 0000000..243a108 --- /dev/null +++ b/doc/pics/actionman.png diff --git a/doc/pics/bookmanadd.png b/doc/pics/bookmanadd.png Binary files differnew file mode 100644 index 0000000..fd5504e --- /dev/null +++ b/doc/pics/bookmanadd.png diff --git a/doc/pics/bookmanedit.png b/doc/pics/bookmanedit.png Binary files differnew file mode 100644 index 0000000..dacd39f --- /dev/null +++ b/doc/pics/bookmanedit.png diff --git a/doc/pics/cmdline.png b/doc/pics/cmdline.png Binary files differnew file mode 100644 index 0000000..23b0f18 --- /dev/null +++ b/doc/pics/cmdline.png diff --git a/doc/pics/fnkeys.png b/doc/pics/fnkeys.png Binary files differnew file mode 100644 index 0000000..3162cef --- /dev/null +++ b/doc/pics/fnkeys.png diff --git a/doc/pics/kgstartup.png b/doc/pics/kgstartup.png Binary files differnew file mode 100644 index 0000000..d48ec82 --- /dev/null +++ b/doc/pics/kgstartup.png diff --git a/doc/pics/krusader1.png b/doc/pics/krusader1.png Binary files differnew file mode 100644 index 0000000..b989dca --- /dev/null +++ b/doc/pics/krusader1.png diff --git a/doc/pics/krusader_title.png b/doc/pics/krusader_title.png Binary files differnew file mode 100644 index 0000000..4ed2458 --- /dev/null +++ b/doc/pics/krusader_title.png diff --git a/doc/pics/listpanel.png b/doc/pics/listpanel.png Binary files differnew file mode 100644 index 0000000..356465e --- /dev/null +++ b/doc/pics/listpanel.png diff --git a/doc/pics/mainwindow.png b/doc/pics/mainwindow.png Binary files differnew file mode 100644 index 0000000..b2c29d0 --- /dev/null +++ b/doc/pics/mainwindow.png diff --git a/doc/pics/mountman.png b/doc/pics/mountman.png Binary files differnew file mode 100644 index 0000000..0967f48 --- /dev/null +++ b/doc/pics/mountman.png diff --git a/doc/pics/search_advanced.png b/doc/pics/search_advanced.png Binary files differnew file mode 100644 index 0000000..07010f2 --- /dev/null +++ b/doc/pics/search_advanced.png diff --git a/doc/pics/search_general.png b/doc/pics/search_general.png Binary files differnew file mode 100644 index 0000000..d73529a --- /dev/null +++ b/doc/pics/search_general.png diff --git a/doc/pics/syncdir.png b/doc/pics/syncdir.png Binary files differnew file mode 100644 index 0000000..6384043 --- /dev/null +++ b/doc/pics/syncdir.png diff --git a/doc/pics/tabbed_browsing.png b/doc/pics/tabbed_browsing.png Binary files differnew file mode 100644 index 0000000..59bd6b7 --- /dev/null +++ b/doc/pics/tabbed_browsing.png diff --git a/doc/pics/terminalEmu.png b/doc/pics/terminalEmu.png Binary files differnew file mode 100644 index 0000000..9df8ba1 --- /dev/null +++ b/doc/pics/terminalEmu.png diff --git a/doc/pics/toolbar.png b/doc/pics/toolbar.png Binary files differnew file mode 100644 index 0000000..d796f76 --- /dev/null +++ b/doc/pics/toolbar.png diff --git a/doc/ru/Makefile.am b/doc/ru/Makefile.am new file mode 100644 index 0000000..70fdf35 --- /dev/null +++ b/doc/ru/Makefile.am @@ -0,0 +1,11 @@ +####### kdevelop will overwrite this part!!! (begin)########## + + +EXTRA_DIST = index.docbook help.docbook editors-note.docbook introduction.docbook features.docbook user-interface.docbook using-krusader.docbook commands.docbook keyboard.docbook mouse.docbook krusader-tools.docbook konfigurator.docbook faq.docbook credits.docbook installation.docbook configuration-files.docbook useraction-xml.docbook release-overview.docbook glossary.docbook + +####### kdevelop will overwrite this part!!! (end)############ + +KDE_LANG = ru +KDE_DOCS = krusader + + diff --git a/doc/ru/commands.docbook b/doc/ru/commands.docbook new file mode 100644 index 0000000..f28af95 --- /dev/null +++ b/doc/ru/commands.docbook @@ -0,0 +1,1892 @@ + +<chapter id="menu-commands"> +<!-- ********************************************************************** + commands.docbook + ++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Menu Commands</title> +<indexterm +><primary +>Commands</primary +><secondary +>Menu</secondary +></indexterm> + + <sect1 id="file-menu"> + <title +><guimenu +>File</guimenu +> Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Shift;<keycap +>F4</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>New Text File</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Creates a new text file in the current directory, unless another directory is specified. The new file is opened for editing after it is created. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycap +>F7</keycap +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>New Directory</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Creates a new directory in the current directory. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>S</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>New Symlink</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Creates a symbolic link to the currently selected file. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycap +>F3</keycap +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>View File</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the currently selected file for <link linkend="kredit" +>viewing</link +>. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycap +>F4</keycap +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Edit File</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the currently selected file for <link linkend="kredit" +>editing</link +>. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycap +>F5</keycap +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Copy</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a dialog to <link linkend="copying" +>copy</link +> the currently selected files or directories to a specified location. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycap +>F6</keycap +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Move</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a dialog to <link linkend="copying" +>move</link +> the currently selected files or directories to a specified location. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>P</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Pack</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Creates a <link linkend="pack-archive" +>new archive</link +> of all the selected files and directories in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Unpack</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +><link linkend="unpacking-archives" +>Unpack</link +> all the selected files in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>E</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Test Archive</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +><link linkend="test-archive" +>Test archive</link +> for corruption. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Compare by content</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Compares two current files by content - one from each panel via an external graphical diff utility. By default &kompare; (part of the kdebase package) is used, but you can also use ⪚ &xxdiff_url; or &kdiff3_url; , change it in the &konfigdependencie_lnk;. </para> + </listitem> + </varlistentry> + <varlistentry id="multi_rename"> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Shift;<keycap +>F9</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Multi Rename</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>This menu option starts &krename_url; a very powerful external batch renamer for &kde; 3.x. </para> + <itemizedlist> + <title +>Krename Features</title> + <listitem> + <para +>Renaming a list of files based on a set of expressions</para> + </listitem> + <listitem> + <para +>Copying/moving a list of files to another directory</para> + </listitem> + <listitem> + <para +>Convert filenames to upper/lower case</para> + </listitem> + <listitem> + <para +>Adding numbers to filenames</para> + </listitem> + <listitem> + <para +>Finding and replacing parts of the filename</para> + </listitem> + <listitem> + <para +>Rename MP3/OGG Vorbis files based on their ID3 tags</para> + </listitem> + <listitem> + <para +>Setting access and modification dates</para> + </listitem> + <listitem> + <para +>Changing permissions and file ownership</para> + </listitem> + <listitem> + <para +>A plug-in API which allows you to extend Krename's features</para> + </listitem> + <listitem> + <para +>Rename directories recursively</para> + </listitem> + <listitem> + <para +>Support for KFilePlugins</para> + </listitem> + <listitem> + <para +>Create undo file</para> + </listitem> + <listitem> + <para +>And many more....</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Create Checksum</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +><link linkend="checksum" +>Checksum creation</link +> on file(s) and/or folder(s). </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Verify Checksum</guimenuitem +> </menuchoice> + </term> + <listitem> + <para> + <link linkend="checksum" +>Verify Checksum</link> + </para> + </listitem> + </varlistentry> +<!-- vertical bar --> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Split file</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>The &splitfile_lnk; function splits a file up into multiple smaller files so that it can be stored on several smaller media (like <hardware +>diskettes, zip-drives...</hardware +>) or sent by e-mail. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Combine files</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>The &combinefiles_lnk; function combines multiple files into one file after the &splitfile_lnk; function was used. </para> + </listitem> + </varlistentry> +<!--vertical bar --> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>Q</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Quit</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Closes &krusader; and cleans up the temporary directory, the same as pressing <keycap +>F10</keycap +> key. </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="edit-menu"> + <title +><guimenu +>Edit</guimenu +> Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Cut to Clipboard</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +><link linkend="copying" +>Cuts</link +> the selected file(s) to the clipboard to be moved to another location. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Copy to Clipboard</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +><link linkend="copying" +>Copies</link +> the selected file(s) to the clipboard to be moved to another location. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Paste from Clipboard</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +><link linkend="copying" +>Pastes</link +> previously cut or copied items from the clipboard to the current directory. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycap +>F9</keycap +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Rename</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +><link linkend="renaming" +>Renames</link +> the currently selected file. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycap +>F8</keycap +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Delete</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +><link linkend="deleting" +>Deletes</link +> the currently selected file(s). </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>+</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Select Group</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a dialog which allows you to select files in the active panel. In the <guilabel +>Search for</guilabel +> dialog place the main search criteria. Enter a filename, a wildcard (<literal role="extension" +>*.o.*</literal +>, <literal role="extension" +>*.c</literal +> &etc;) or both - separated by a space. When using <literal +>'text'</literal +> the results is the same as <literal +>'*text*'</literal +>. You can exclude files from the search with '|' (⪚ <literal role="extension" +>'*.cpp *.h | *.moc.cpp'</literal +> ). With the <link linkend="profiles" +>profile handler</link +> you can manage your selections for future usage. A double-click on a Profile is the same as entering the selection and pressing the <guibutton +>OK</guibutton +> button. More options for <guilabel +>Select Group</guilabel +> dialog are explained in the <link linkend="krusearcher" +>Search dialog</link +>, who are basicly almost the same dialogs. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>-</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Unselect Group</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>The opposite of <guimenuitem +>Select Group</guimenuitem +>, the files that match the pattern in the active panel will be unselected. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>+</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Select All</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Selects all files in the active panel, if you want that all directories are also selected than activate the <guilabel +>Automark directories</guilabel +> option in the &konfiglookandfeel_lnk;. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>-</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Unselect All</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Unselects all the files in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>*</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Invert Selection</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Invert the selection status of all the files in the active panel (&ie;: selected files will become unselected and unselected files will become selected). </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>Edit</guimenu +> <guimenuitem +>Compare Directories</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Toggles &krusader; &comparedir_lnk; function.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>Edit</guimenu +> <guimenuitem +>Compare setup</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Configures the <guimenuitem +>Compare Directories</guimenuitem +> function.</para> + <itemizedlist> + <listitem> + <para +><guimenuitem +>Select Newer and Single</guimenuitem +> (default) </para> + </listitem> + <listitem> + <para> + <guimenuitem +>Select Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem +>Select Newer</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem +>Select Different and Single</guimenuitem> + </para> + </listitem> + <listitem> + <para> + <guimenuitem +>Select Different</guimenuitem> + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>*</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Properties</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the properties dialog for the currently selected file. </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="view-menu"> + <title +><guimenu +>View</guimenu +> menu</title> + <para +>The action in this sub menu usually affects the current &krusader; session. If you want to make permanent changes use &konfigstartpg_lnk;. </para> + <variablelist> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>.</keycap +></keycombo +> </shortcut +> <guimenu +>View</guimenu +> <guimenuitem +>Show Hidden Files</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Toggles the option to display or not the hidden files in the &krusader; panels. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Shift;<keycap +>F10</keycap +></keycombo +> </shortcut +> <guimenu +>View</guimenu +> <guimenuitem +>All Files</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Turn off all filters and display all files. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Shift;<keycap +>F12</keycap +></keycombo +> </shortcut +> <guimenu +>View</guimenu +> <guimenuitem +>Custom</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Allows you to install a custom filter on the &krusader; panel. Only files that match the filter pattern(s) and directories will be displayed. Don't forget to deactivate the custom filter after use, or some files may not be visible. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +> </shortcut +> <guimenu +>View</guimenu +> <guimenuitem +>Reload</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Refreshes the contents of the active panel. </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="go-menu"> + <title +><guimenu +>Go</guimenu +> Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice +><guimenu +>Go</guimenu +> <guimenuitem +>Back</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Navigates to the previously viewed directory in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>PageUp</keycap +></keycombo +> </shortcut +> <guimenu +>Go</guimenu +> <guimenuitem +>Up</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Navigates to the parent directory of the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>Backspace</keycap +></keycombo +> </shortcut +> <guimenu +>Go</guimenu +> <guimenuitem +>Root</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Navigates to the root directory of the system. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>Home</keycap +></keycombo +> </shortcut +> <guimenu +>Go</guimenu +> <guimenuitem +>Home</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Navigates to the home directory of the current user. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +> </shortcut +> <guimenu +>Go</guimenu +> <guimenuitem +>Popular URLs</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Displays a listing of frequently viewed directories from which you may navigate to one by double-clicking on it. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>J</keycap +></keycombo +> </shortcut +> <guimenu +>Go</guimenu +> <guimenuitem +>Set Jump Back Point</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Sets the current directory as a "jump back" point. To navigate to this directory quickly, select the "Jump Back" command from the go menu. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>J</keycap +></keycombo +> </shortcut +> <guimenu +>Go</guimenu +> <guimenuitem +>Jump Back</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Returns to a previous "jump back" point. </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="useractions-menu"> + <title +><guimenu +>Useractions</guimenu +> menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice +><guimenu +>Useractions</guimenu +> <guimenuitem +>Manage useractions</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the &useractions_lnk; manager.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>Useractions</guimenu +> <guimenuitem +>Your foo Useractions</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the default Useractions and Useractions created by the user.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>1</keycap +></keycombo +></shortcut +> <guimenu +>Useractions</guimenu +> <guimenuitem +>Sort By Name</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>When this action is turned on, the main sorting key in the &krusader; panel becomes the file name. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>2</keycap +></keycombo +></shortcut +> <guimenu +>Useractions</guimenu +> <guimenuitem +>Sort By Extention</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>When this action is turned on, the main sorting key in the &krusader; panel becomes the file extention (the part of the filename after the last '.'). This is useful for grouping files of the same type closer together. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>3</keycap +></keycombo +></shortcut +> <guimenu +>Useractions</guimenu +> <guimenuitem +>Sort By Size</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>When this action is turned on, the main sorting key in the &krusader; panel becomes the file size. This is useful for determining the largest files in a particular directory. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>4</keycap +></keycombo +></shortcut +> <guimenu +>Useractions</guimenu +> <guimenuitem +>Sort By Modified</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>When this action is turned on, the main sorting key in the &krusader; panel becomes the last modified date for each file. This is useful for finding files you recently worked on. </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="tools-menu"> + <title +><guimenu +>Tools</guimenu +> menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Search</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the <link linkend="krusearcher" +>&krusader; search module</link +>. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>L</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Locate</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the &locate_lnk; for fast file searching. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>Y</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Synchronize Directories</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>The &syncdirs_lnk; function compares the left and right panels and show the differences between them. After the compare function, you can move files/directories so that they can be synchronized. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>/</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>MountMan</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens <link linkend="mount-man" +>MountMan</link +> - your Mount-Manager.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Disk Usage</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens &diskusage_lnk;.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>New Net Connection</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the <link linkend="remote-connections" +>New Network Connection</link +> dialog to start a &FTP;, SMB, FISH or SFTP connection to a remote host. If you leave the username and password fields empty you'll login as anonymous. You can <link linkend="bookman" +>Bookmark</link +> these remote sessions. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Shift;&Ctrl;<keycap +>F</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Disconnect From Net</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>End the <link linkend="remote-connections" +>remote connection</link +> in the active panel and return to the startup path. </para> + </listitem> + </varlistentry> +<!-- vertical bar --> + <varlistentry> + <term> + <menuchoice +><guimenu +>Tools</guimenu +> <guimenuitem +>Start Terminal</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a terminal window in the default directory (usually your home directory). You can choose your favorite terminal application in the &konfiggereral_lnk;. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +> <keycap +>F2</keycap +> </keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Start Terminal Here</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a terminal window in the currently browsed directory of the active panel. You can choose your favorite terminal application in the &konfiggereral_lnk;. </para> + </listitem> + </varlistentry> +<!-- vertical bar --> + <varlistentry id="root-mode"> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>K</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Start Root Mode Krusader</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Starts &krusader; in &rootmode_lnk; at the same location. </para> + <caution> + <para +>Be careful when using &krusader; with ROOT PRIVILEGES. </para> + </caution> + </listitem> + </varlistentry> +<!-- vertical bar --> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>J</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Javascript Console</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the Javascript Console for Javascript evaluation. TODO: describe me. </para> + <caution> + <para +>Be careful when using &krusader; with ROOT PRIVILEGES. </para> + </caution> + </listitem> + </varlistentry> +<!--<varlistentry +>--> +<!--<term +>--> +<!--<menuchoice +>--> +<!--<shortcut +>--> +<!--<keycombo action="simul" +>&Ctrl;<keycap +>`</keycap +></keycombo +>--> +<!--</shortcut +>--> +<!--<guimenu +>Tools</guimenu +>--> +<!--<guimenuitem +>User Menu</guimenuitem +>--> +<!--</menuchoice +>--> +<!--</term +>--> +<!--<listitem +>--> +<!--<para +>--> +<!--Please use at this moment the <link linkend="useractions-menu" +>Useractions menu</link +> instead.--> +<!--Our plans for the Usermenu are to make user-configurable KActionMenus.--> +<!--With this one could make a UserMenu containing ⪚ all music-related actions and place--> +<!--this in the button-bar.... (or anywhere else).--> +<!--</para +>--> +<!--</listitem +>--> +<!--</varlistentry +>--> + </variablelist> + </sect1> + + <sect1 id="settings-menu"> + <title +><guimenu +>Settings</guimenu +> menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice +><guimenu +>View</guimenu +> <guimenuitem +>Show Main Toolbar</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Shows the &main_toolbar_lnk; if checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>View</guimenu +> <guimenuitem +>Show Actions Toolbar</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Shows the &actions_toolbar_lnk; if checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>View</guimenu +> <guimenuitem +>Show Statusbar</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Shows the <link linkend="mainwindow" +>Statusbar</link +> if checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>View</guimenu +> <guimenuitem +>Show FN Keys bar</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Shows the &fnkeybar_lnk; if checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>View</guimenu +> <guimenuitem +>Show Command Line</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Shows the <link linkend="cmdline" +>Command Line</link +> if checked.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>T</keycap +></keycombo +> </shortcut +> <guimenu +>View</guimenu +> <guimenuitem +>Show Terminal Emulator</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Show the <link linkend="cmdline" +>Terminal Emulator</link +> if checked.</para> + </listitem> + </varlistentry> + <varlistentry id="configure-shortcuts"> + <term> + <menuchoice +><guimenu +>Settings</guimenu +> <guimenuitem +>Configure Shortcuts</guimenuitem +> </menuchoice> + </term> + <listitem> + <indexterm +><primary +>Configure</primary +><secondary +>Shortcuts</secondary +></indexterm> + <para +>Opens a dialog which allows you to configure the &krusader; key bindings. </para> + <para +>With the <guibutton +>Import shortcuts</guibutton +> <guibutton +>Export shortcuts</guibutton +> buttons you can load and save a Key-binding profile. This allows &krusader; to have the &tcmd;, &mc;, foo-commander, or your custom Key-bindings. The only limitation is that global &kde; key-bindings and some &krusader; key-bindings can't be changed yet, as well as some features in foo-commander that we either don't have or don't need. The Key-bindings are stored in <filename +>$KDEDIR/share/apps/krusader</filename +>, <filename +>foo.keymap.info</filename +> contains a description, <filename +>foo.keymap</filename +> is a ini file that holds the Key-bindings. Until &krusader;-1.70.1 this was a binary file, &krusader; is backwards compatible for importing this legacy binary format. If a <filename +>*.keymap.info</filename +> text file exists, &krusader; will display it, showing additional information regarding the loaded Key-bindings file. Here you have a chance to exit without importing the proposed Key-bindings file. </para> + <tip +><para +>A &tcmd; Key-bindings file is provided. Please <link linkend="help_krusader" +>upload your favorite Key-bindings schemes</link +> so that they become available for the &krusader; community. Thanks! </para +></tip +> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>Settings</guimenu +> <guimenuitem +>Configure Toolbars</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a dialog which allows you to configure the &main_toolbar_lnk; or the &actions_toolbar_lnk;. You can add action buttons of your favourite &useractions_lnk; to the desired Toolbar.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>Settings</guimenu +> <guimenuitem +>Configure &krusader;</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the &krusader; configuration center: <link linkend="konfigurator" +>Konfigurator</link +>.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="window-menu"> + <title +><guimenu +>Window</guimenu +> Menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>New Tab</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a new tab in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;&Shift;<keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Duplicate Current Tab</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a new tab that is a duplicate of the active tab in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>W</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Close Current Tab</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Closes the current tab in the active panel. This command is only available if there is more than one tab in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Shift;<keycap +>Right</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Next Tab</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Navigates to the next tab of the active panel. This command is only available if there is more than one tab in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Shift;<keycap +>Left</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Previous Tab</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Navigates to the previous tab of the active panel. This command is only available if there is more than one tab in the active panel. </para> + </listitem> + </varlistentry> + <varlistentry id="c_panel_profiles"> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;<keycap +>L</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Profiles</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens a menu where <link linkend="panel_profiles" +>Panel profiles</link +> can be saved and restored. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Swap Panels</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>The left panel wil become the right panel and vice versa, only the current tabs will be swapped. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Swap Sides</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>The complete left panel will become the right panel and vice versa, and all tabs will be swapped. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>r</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Vertical Mode</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Toggels the &list_panel_lnk; between horizontal and vertical mode.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +> </shortcut +> <guimenu +>Window</guimenu +> <guimenuitem +>Toggle Fullwidget Terminal Emulator</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Toggles fullscreen mode of the terminal editor. This option is only approriate when "Show Terminal Emulator" is activated. </para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>Window</guimenu +> <guimenuitem +>Save Position</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Saves the current size and position of the &krusader; main window. This action can be automated with <guilabel +>"Save settings on exit"</guilabel +> in &konfigstartpg_lnk; </para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + <sect1 id="help-menu"> + <title +><guimenu +>Help</guimenu +> menu</title> + <variablelist> + <varlistentry> + <term> + <menuchoice +><guimenu +>Help</guimenu +> <guimenuitem +>Krusader Handbook</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Invokes the &kde; Help system starting at the &krusader; help pages (this document).</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><shortcut +> <keycombo action="simul" +>&Shift;<keycap +>F1</keycap +></keycombo +> </shortcut +> <guimenu +>Help</guimenu +> <guimenuitem +>What's This?</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>The &whatsthis_url; help function changes the mouse cursor to a combination arrow and question mark. Clicking on items within &krusader; will open a help window (if one exists for that particular item) explaining the item's function. If you want to know more about a specific item than use this feature, a right-click on an item will also open the &whatsthis_url; help. </para> + </listitem> + </varlistentry> +<!-- vertical bar --> + <varlistentry> + <term> + <menuchoice +><guimenu +>Help</guimenu +> <guimenuitem +>Report Bug</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>Opens the bug report dialog for sending bug reports via mail.</para> + <note> + <para> + <remark +>If you've got bugs to report please do not use &kde;'s bugzilla http://bugs.kde.org/, &kde;'s Bug Tracking System. We use Sourceforge.net for reporting and managing our &faqbugreports_lnk;.</remark> + </para> + </note> + <para +>Wishes, patches, and comments are always <link linkend="faqg_wish" +>welcome</link +>.</para> + </listitem> + </varlistentry> +<!-- vertical bar --> + <varlistentry> + <term> + <menuchoice +><guimenu +>Help</guimenu +> <guimenuitem +>About Krusader</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>This will display version, author, and license information.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <menuchoice +><guimenu +>Help</guimenu +> <guimenuitem +>About KDE</guimenuitem +> </menuchoice> + </term> + <listitem> + <para +>This displays the &kde; version and basic information.</para> + </listitem> + </varlistentry> + </variablelist> + </sect1> + +</chapter> diff --git a/doc/ru/configuration-files.docbook b/doc/ru/configuration-files.docbook new file mode 100644 index 0000000..5e53d77 --- /dev/null +++ b/doc/ru/configuration-files.docbook @@ -0,0 +1,224 @@ +<appendix id = "config_files"> + +<!-- ********************************************************************** + configuration-files.docbook + +++++++++++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + + +<title +>Configuration files</title> +<para +>This appendix gives an overview of the configuration files used by &krusader;.</para> + + +<para +><emphasis role="bold" +>krusaderui.rc</emphasis +></para> +<para +>This file stores the users toolbar settings and the menu structure. Tip: please read also the <link linkend="faqi_krusaderui_rc" +>krusaderui.rc &FAQ;</link +>.</para> +<para +>Location: <filename +>$KDEDIR/share/apps/krusader/krusaderui.rc</filename +> or <filename +>~/.kde/share/apps/krusader/krusaderui.rc</filename +></para> + + + +<para +><emphasis role="bold" +>krusaderrc</emphasis +></para> +<para +>This file stores the &krusader; configuration.</para> +<para +>Location: <filename +>~/.kde/share/config/krusaderrc</filename +></para> + +<para +>The following settings are ⪚ stored:</para> +<itemizedlist> + <listitem +><para +>Actions Toolbar</para +></listitem> + <listitem +><para +>Archives</para +></listitem> + <listitem +><para +>Colors</para +></listitem> + <listitem +><para +>Dependencies</para +></listitem> + <listitem +><para +>DiskUsage</para +></listitem> + <listitem +><para +>DiskUsageViewer</para +></listitem> + <listitem +><para +>General</para +></listitem> + <listitem +><para +>HTML Settings</para +></listitem> + <listitem +><para +>KFileDialog</para +></listitem> + <listitem +><para +>KFileDialog Speedbar</para +></listitem> + <listitem +><para +>KrDetailedViewLeft</para +></listitem> + <listitem +><para +>KrDetailedViewRight</para +></listitem> + <listitem +><para +>KrViewerWindow</para +></listitem> + <listitem +><para +>KrViewerWindow Toolbar extraToolBar</para +></listitem> + <listitem +><para +>Look&Feel</para +></listitem> + <listitem +><para +>Notification Messages</para +></listitem> + <listitem +><para +>Panel Profiles</para +></listitem> + <listitem +><para +>Private</para +></listitem> + <listitem +><para +>Protocols</para +></listitem> + <listitem +><para +>Search</para +></listitem> + <listitem +><para +>Startup</para +></listitem> + <listitem +><para +>Synchronize</para +></listitem> + <listitem +><para +>Locate</para +></listitem> + <listitem +><para +>SynchronizerProfile - 1</para +></listitem> +</itemizedlist> + + +<para +><emphasis role="bold" +>krbookmarks.xml</emphasis +></para> +<para +>This file stores the &krusader; bookmarks and uses the &xbel_url; standard.</para> +<para +>Location: <filename +>~/.kde/share/apps/krusader/krbookmarks.xml</filename +></para> + + +<para +><emphasis role="bold" +>useractions.xml</emphasis +></para> +<para +>This file stores the &useractions_lnk; configuration. The file-structure is documented in doxygen-headers of UserActionXML.</para> +<para +>Location: <filename +>~/.kde/share/apps/krusader/useractions.xml</filename +></para> + +<para +><emphasis role="bold" +>useraction_examples.xml</emphasis +></para> +<para +>The default User-Actions provided by us. The file-structure is documented in doxygen-headers of UserActionXML.</para> +<para +>Location: <filename +>$KDEDIR/share/apps/krusader/useraction_examples.xml</filename +></para> + +<para +><emphasis role="bold" +>foo.keymap</emphasis +></para> +<para +>Is a ini file that holds a <link linkend="configure-shortcuts" +>Key-binding profile</link +>. Until &krusader;-1.70.0 this was a binary file, &krusader; is backwards compatible for importing this legacy binary format.</para> +<para +>Location: <filename +>$KDEDIR/share/apps/krusader/foo.keymap</filename +></para> + + +<para +><emphasis role="bold" +>foo.color</emphasis +></para> +<para +>Is a binary file that holds the <link linkend="konfig-color" +>Color Scheme</link +>.</para> +<para +>Location: <filename +>$KDEDIR/share/apps/krusader/foo.color</filename +></para> + + +</appendix> + diff --git a/doc/ru/credits.docbook b/doc/ru/credits.docbook new file mode 100644 index 0000000..649a53b --- /dev/null +++ b/doc/ru/credits.docbook @@ -0,0 +1,360 @@ +<chapter id="credits"> + +<!-- ********************************************************************** + credits.docbook + +++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Credits and License</title> +<indexterm +><primary +>Credits</primary +></indexterm> +<indexterm +><primary +>License</primary +></indexterm> +<para +><emphasis role="bold" +>&krusader;</emphasis +></para> + +<para +>Program copyright 2000-2003 Shie Erlich and Rafi Yanai, 2004-2006 &krusader; Krew <email +>[email protected]</email +></para> + +<para +>&krusader; is developed by a dedicated team of individuals, known as the &krusader; Krew. <itemizedlist +> <listitem +><para +>Shie Erlich, author <email +>[email protected]</email +></para +> </listitem +> <listitem +><para +>Rafi Yanai, author <email +>[email protected]</email +></para +> </listitem +> <listitem +><para +>Dirk Eschler, webmaster & i18n coordinator <email +>[email protected]</email +></para +> </listitem +> <listitem +><para +>Csaba Karai, developer <email +>[email protected]</email +></para +> </listitem +> <listitem +><para +>Heiner Eichmann, developer <email +>[email protected]</email +></para +> </listitem +> <listitem +><para +>Jonas Bähr, developer <email +>[email protected]</email +></para +> </listitem +> <listitem +><para +>Frank Schoolmeesters, Documentation & Marketing coordinator <email +>[email protected]</email +></para +> </listitem +> <listitem +><para +>Richard Holt, Documentation & Proofing <email +>[email protected]</email +></para +> </listitem +> <listitem +><para +>Matej Urbančič, Marketing & Product Research <email +>[email protected]</email +></para +> </listitem +> </itemizedlist +> The project is written using <application +>KDevelop</application +> and <application +>&Qt; Designer</application +>. </para> + +<para +>We would especially like to thank Dirk Eschler the &krusader; web master. If you visit the &kruwebsite_url; you'll appreciate, as much as we do, the hard work and effort that Dirk has put into the site.</para> + +<para +>Contributors: We would like to thank all the &krusader; users who submitted bugs, wishes and patches. Sorry we can't mention all of you.</para> + +<para +>Donations: We would like to thank the following organisations and individuals for their recent financial <ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488" +>contributions</ulink +>. In addition we would to thank those who have contributed <ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488" +>anonymously</ulink +>. Your support is very appreciated. <itemizedlist> + <listitem +><para +><ulink url="http://Distrowatch.com" +>distroWatch.com</ulink +> (donation)</para> + </listitem +> + <listitem +><para +>Sven Opitz (the first donation ever !)</para> + </listitem> + <listitem +><para +>Christian Bock (webspace)</para> + </listitem> + </itemizedlist +> +</para> + +<para +>Special thanks to: <itemizedlist> + <listitem +><para +>&sourceforge_net_url;, webhosting services</para> + </listitem +> + <listitem +><para +>&kde_files_url; & &kde_apps_url; creator Frank Karlitschek</para> + </listitem +> + <listitem +><para +>&openusability_url;</para> + </listitem> + <listitem +><para +>Google.com</para> + </listitem +> + <listitem +><para +>Václav Jůza, QA, bug-hunting, patches and general help</para> + </listitem> + <listitem +><para +>Jiří Paleček, QA, bug-hunting, patches and general help</para> + </listitem> + <listitem +><para +>Andrew Neupokoev (nwmod) &krusader; Logo and Icons, art contest winner.</para> + </listitem> + <listitem +><para +>Angel Ramos, &debian; package maintainer</para> + </listitem +> + <listitem +><para +>Terry "Fudoki" Wilkinson, handbook proofreader</para> + </listitem> + <listitem +><para +>Gábor Lehel (illissius), Viewer module for the 3rd Hand Panel</para> + </listitem> + <listitem +><para +>Szombathelyi György, ISO KIO slave</para> + </listitem> + <listitem +><para +>David Harel, panel toolbar buttons</para> + </listitem> + <listitem +><para +>Jan Willem van de Meent (Adios), &krusader; icons</para> + </listitem> + <listitem +><para +><ulink url="http://usefularts.org/" +>usefularts.org</ulink +> , &krusader; icons</para> + </listitem> + <listitem +><para +>Hans Loffler, directory history list</para> + </listitem> + <listitem +><para +>Jan Halasa, new bookmark module</para> + </listitem> + <listitem +><para +>Mikolaj Machowski, Usability and QA</para> + </listitem> + <listitem +><para +>Cristi Dumitrescu, QA, bug-hunting, patches and general help</para> + </listitem> + <listitem +><para +>Aurelien Gateau, patch for KViewer</para> + </listitem> + <listitem +><para +>Milan Brabec, the first patch ever !</para> + </listitem> + </itemizedlist> +</para> + +<para +>Thanks to the translators: <itemizedlist +> <listitem +><para +>Bosnian: Asim Husanovic</para +> </listitem +> <listitem +><para +>Brazilian Portuguese: Doutor Zero</para +> </listitem +> <listitem +><para +>Bulgarian: Milen Ivanov</para +> </listitem +> <listitem +><para +>Catalan: Rafael Munoz Rodriguez, Quim Perez Noguer</para +> </listitem +> <listitem +><para +>Chinese: Jinghua Luo</para +> </listitem +> <listitem +><para +>Czech: Martin Sixta, Václav Jůza</para +> </listitem +> <listitem +><para +>Danish: Anders Bruun Olsen, Christian Sonne, Peter H.S.</para +> </listitem +> <listitem +><para +>Dutch: Frank Schoolmeesters</para +> </listitem +> <listitem +><para +>French: René-Pierre Lehmann, David Guillerm</para +> </listitem +> <listitem +><para +>German: Christoph Thielecke, Dirk Eschler</para +> </listitem +> <listitem +><para +>Greek: Spiros Georgaras</para +> </listitem +> <listitem +><para +>Hungarian: Kukk Zoltan, Arpad Biro, Karai Csaba</para +> </listitem +> <listitem +><para +>Italian: Giuseppe Bordoni</para +> </listitem +> <listitem +><para +>Japanese: UTUMI Hirosi, Hideki Kimura</para +> </listitem +> <listitem +><para +>Lithuanian: Dovydas Sankauskas</para +> </listitem +> <listitem +><para +>Polish: Marcin Szafran, Lukasz Janyst, Marcin Garski, Pawel Salawa, Tomek Grzejszczyk</para +> </listitem +> <listitem +><para +>Portuguese: Bruno Queirós</para +> </listitem +> <listitem +><para +>Russian: Dmitry V. Chernyak, Denis Koryavov, Nick Shaforostoff, Dmitry A. Bugay</para +> </listitem +> <listitem +><para +>Serbian: Sasa Tomic</para +> </listitem +> <listitem +><para +>Slovak: Zdenko Podobný</para +> </listitem +> <listitem +><para +>Slovenian: Matej Urbančič</para +> </listitem +> <listitem +><para +>Spanish: Rafael Munoz Rodriguez, Alejandro Araiza Alvarado, Alex Araiza</para +> </listitem +> <listitem +><para +>Swedish: Erik Johansson, Anders Lindén, Peter Landgren</para +> </listitem +> <listitem +><para +>Turkish: Bekir Sonat</para +> </listitem +> <listitem +><para +>Ukrainian: Ivan Petrouchtchak</para +> </listitem +> </itemizedlist +> And to all the other translators, we're sorry we can't list all the names. Please take a look in the headers of the <filename +>foo.po</filename +> files to see &i18n_credits_url;. </para> + +<para +>If your native language is not listed above and you would like to translate &krusader; into your language, please read the &i18n_page_url;.</para> + +<para +>For more credits, read the &changelog_url; file online or in the Krusader sources.</para> + +<para +>Documentation Copyright 2000-2003 Shie Erlich and Rafi Yanai. Copyright 2004-2006 &krusader; Krew <email +>[email protected]</email +>.</para> + +<!-- &underGPL; --> <!-- GPL License, do not remove --> +<para +>This program is licensed under the terms of the <ulink url="http://www.gnu.org/copyleft/gpl.html" +>GNU General Public License</ulink +> Version 2, June 1991.</para> + +<!-- &underFDL; --> <!-- FDL License, do not remove --> +<para +>This documentation is licensed under the terms of the <ulink url="http://www.gnu.org/copyleft/fdl.html" +>GNU Free Documentation License</ulink +>.</para> + + +</chapter> diff --git a/doc/ru/editors-note.docbook b/doc/ru/editors-note.docbook new file mode 100644 index 0000000..d148809 --- /dev/null +++ b/doc/ru/editors-note.docbook @@ -0,0 +1,63 @@ +<!-- ********************************************************************** + editors-note.docbook + ++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<preface id="editors_note"> + <title +>Примечание для редакторов</title> + + <para +>Как вы можете видеть это руководство написано различными авторами. Черновик с пояснениями нововведений составляется разработчиками в списке рассылки , редакторы добавляют эту информацию в это руководство.Мы прикладывам много усилий для технической грамотности руководства.Авторы пишут на английском , хотя это не их родной язык , поэтому вы можете сообщать о странных для понимания конструкциях.Не стесняйтесь , если на ваш взгляд что то не правильно.</para> + + <para +>Большая польза в открытых проектах извлекается из возможности обратной связи с ользователями. Мы любим слушать , если вам есть что сказать.Помощь в документации всегда приветствуется ! Это сократит затраты. Если у вас есть идеи по улучшению содержания , если вы желаете написать о недокументированых возможностях &krusader; или имеете комментарии и советы для Руководства &krusader; пожалуйста свяжитесь с нами !</para> + + <para +>Руководство "ревизия" соответствует &krusader; номер версии . Например , "&krusader; Руководство ревизия 1.80.x" описывает "&krusader; 1.80.x"</para> + + <para +>Пожалуйста прочитайте файл &docchangelog_url; в сети или в исходных кодах &krusader; .там вы найдете список последних изменений в Руководстве &krusader;.</para> + + <para +>Для информации о проекте документации &krusader; свяжитесь с координатором документации Frank Schoolmeesters <email +>[email protected]</email +>.</para> + + +<para +>Это руководство доступно в нескольких форматах.<itemizedlist +> <listitem +> <para +>через меню Справка в &krusader;</para +> </listitem +> <listitem +> <para +>на &onlinehandbook_url;</para +> </listitem +> <listitem +> <para +>Как архив (HTML, TXT, RTF, PDF, XML-SOURCE), на &sfmirrors_url;</para +> </listitem +> </itemizedlist +> Самая последняя версия Руководства доступна на cvs или по адресу &onlinehandbook_url;. </para> +&dev_cvs_note; <para +>Все упоминаемые торговые марки и авторские права в этом руководстве являются собственостью их настоящих владельцев.</para> + +</preface> diff --git a/doc/ru/faq.docbook b/doc/ru/faq.docbook new file mode 100644 index 0000000..e08ac06 --- /dev/null +++ b/doc/ru/faq.docbook @@ -0,0 +1,1514 @@ +<chapter id="faq"> + +<!-- ********************************************************************** + faq.docbook + ++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> +<title +>Часто задаваемые вопросы (&FAQ;)</title> +<indexterm +><primary +>FAQ</primary +></indexterm> + +<!-- &reporting.bugs; + &updating.documentation; --> + +<para +>Если у вас возникли проблемы с &krusader; пожалуйста проверьте &install_proc_lnk; , возможно ваша проблема вызвана неправильной установкой.</para> + +<para +>&FAQ; разделен на три части: <itemizedlist +> <listitem +><para +><link linkend="faq_installation" +> &FAQ;Установка </link +> (this page)</para +></listitem +> <listitem +><para +><link linkend="faq_usage" +> &FAQ; Использование</link +> (issues when running/using &krusader;)</para +></listitem +> <listitem +><para +><link linkend="faq_general" +> &FAQ; Основной</link +> (bug reports, forum, mailing list, ...)</para +></listitem +> </itemizedlist +> If you have the feeling that a &FAQ; is missing or if something is not clear to you, please <link linkend="editors_note" +>let us know</link +>. </para> + + +<sect1 id="faq_installation"> +<title +>&FAQ; Установка</title> +<qandaset> + + <qandaentry> + <question id="faqi_kdelibs"> + <para +>Нуждается ли &krusader; в &kde; ?</para> + </question> + <answer> + <para +><emphasis +>Нет , &krusader; не нуждается в оконном менеджере &kde;</emphasis +> для запуска на вашем компьютере , потому что он пользуется службам⪚ &kde;и базовой библиотеки &kde;Необходимы только некоторые разделяемые библиотеки например &kde; &Qt; , &etc;Этот способ в &krusader; , запущеном в &gnome_url;, &afterstep_url;, &xfce_url; и других оконных менеджерах реализуется за счет связанных с ними библиотек .Это не проблема и решается правильным соблюдением зависимостей при установке. </para> + <!-- Empty line to make it more readable --> + <para +>Нет необходимости переключаться в &kde; для использования &krusader;; вы можете использовать &gnome_url;, &afterstep_url;, &xfce_url; или в других оконных менеджерах.Но настройка шрифтов и поведения &krusader; производится в <command +>Kcontrol</command +>.</para> + <!-- Empty line to make it more readable --> + <para +>Не волнуйтесь о судьбе зависимостей , если вы выберете &krusader;.Вы узнаете что &krusader; использует &kde; &kioslaves1_url; для получения доступа к удаленным файловым системам и поддерживает все файловые системы , которые доступны в &kdelibs_url; больше в &kioslaves2_url; или связаны с &kdebase_url;(включая fish, sftp и tar).Только... если диалог свойств показывает данные EXIF для .jpeg's, вы нуждаетесь в пакетах графики &kde; , если вы хотите видеть информацию ID3 - пакеты мультимедиа для &kde; и так далее и тому подобное....</para> + <!-- Empty line to make it more readable --> + <para +>Суммируя , если вы хотите работать в &krusader; - установите библиотеки &kde;.Если нужна полная функциональнось в &krusader; нужно установить дополнительные библиотеки и базовый пакет &kde;.Для полной функциональности необходимы все библиотеки и все пакеты &kde; , оконный менеджер остается опциональным. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqi_libs"> + <para +>Какие библиотеки необходимы для запуска &krusader; ?</para> + </question> + <answer> + <para +>Для запуска &krusader; (⪚ если вы установили &krusader; из бинарного RPM) вы наименее нуждаетесь в библиотеках чем если собираете его из исходного кода.Например , вы нуждаетесьтолько в компиляторе &gcc; затем компилируете &krusader; (смотрите следующий вопрос).</para> + <para +>Здесь (возможно неполный) список необходимых разделяемых библиотек для &krusader;:</para> + <para +><itemizedlist> + <listitem +><para +>библиотеки kde ( для определенной версии &kde; смотреть &install_proc_lnk;) </para> + </listitem> + <listitem +><para +>libacl1 libart-2.0 libattr1 libaudio2 libc6 libfam0 libfontconfig1 </para> + </listitem> + <listitem +><para +>libfreetype6 libgcc1 libgcc2 libice6 libidn11 libjpeg62 libkjsembed1 </para> + </listitem> + <listitem +><para +>libkonq4 libpcre3 libpng12 libqt3-mt libsm6 libstdc++6 libunwind7 libx11-6 </para> + </listitem> + <listitem +><para +>libxcursor1 libxext6 libxft2 libxi6 libxinerama1 libxrandr2 libxrender1 libxt6 zlib1g </para> + </listitem> +</itemizedlist> +Если вы нуждаетесь в более подробной информации пожалуйста посмотрите &deb_requirements_url; . </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqi_missing_libs"> + <para +>Я сделал все необходое , только <command +>configure</command +> ругается на отсутствие библиотек headers.Что я делаю не так ?</para> + </question> + <answer> + <para +>Пожалуйста установите их . ;-)</para> + <para +>Here is a (possibly incomplete) list of the required packages to compile &krusader; from source:</para> + <para +><itemizedlist> + <listitem +><para +>gcc-cpp gcc-c++ glibc libgcc1 (other compilers may work but haven't been tested) </para +></listitem> + <listitem +><para +>autoconf automake XFree </para +></listitem> + <listitem +><para +>libqt3 libqt-devel</para +></listitem> + <listitem +><para +>kdelibs kdelibs-devel</para +></listitem> + <listitem +><para +>libjpeg62 libjpeg-devel libpng3 libmng1</para +></listitem> + <listitem +><para +>fam libfam-devel</para +></listitem> + <listitem +><para +>zlib1 arts libart_lgpl2 libstdc++5 libpcre0</para +></listitem> + <listitem +><para +>libkjsembed,если вы используете &javascript_console_lnk;,обычно находится в пакете именуемом KDEbindings(-devel) и libkonq-dev для &konqueror; внутри меню по правому щелчку мыши.</para +></listitem> + </itemizedlist +></para> + <para +>Большинство дистрибутивов на основе RPM разделяют headers и сами библиотеки.Просто установите их , введя в поиске пакетов foo-devel-*.rpm(⪚ <filename +>kdelibs-devel-foo.i586.rpm</filename +>) или oo-dev-*.deb для основанных на &debian; дистрибутивов.Обычно они включены в стандартной поставке. <tip +><para +>Если вы не нашли необходимый пакет используйте &rpmfind_url; и попробуйте найти там недостающие пакеты.Или используйте <command +>apt&krusader;-cache search <replaceable +>foo</replaceable +></command +> для поиска в пакета в дистрибутивах на основе &debian;</para +></tip +></para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqi_64bit"> + <para +>Как мне скомпилировать &krusader; на 64 -х битном процессоре ?</para> + </question> + <answer> + <para +>Насколько нам известно в этом нет нужды .&krusader; доступен для многих платформ <ulink url="http://packages.debian.org/unstable/utils/krusader" +>много различных архитектур</ulink +>. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + +<qandaentry> +<question id="faqi_rpm_source"> + <para +>Я загрузил RPM с исходным кодом <filename +>krusader-x.xx.dist.src.rpm</filename +> Что делать дальше ?</para> + </question> + <answer> + <para +><orderedlist> + <listitem +><para +>Проверьте права доступа для <filename class="directory" +>/usr/src/RPM/</filename +> и всех вложенных директорий - ваша учетная запись пользователя должна иметь права на чтение-запись-выполнение во всех директориях. </para +></listitem> + <listitem +><para +>Для создания бинарного RPM выполните : <screen +><prompt + +>$</prompt + +> <userinput + +><command + +>rpm</command + +> <option + +>--rebuild</option + +> <replaceable + +></путь_к_файлу/> krusader-x.xx.dist.src.rpm</replaceable + +></userinput + +></screen> + </para +></listitem> + <listitem +><para +>Если все <link linkend="faqi_missing_libs" +> зависимости</link +>удовлетворены - RPM <filename +>krusader-x.xx.dist.rpm</filename +> будет создан в <filename class="directory" +>/usr/src/RPM/RPMS/i586</filename +>(если у вас архитектура i586). </para +></listitem> + <listitem +><para +>Проверьте собранный бинарный пакет перед установкой командой <screen +><prompt + +>$</prompt + +> <userinput + +><command + +>rpm</command + +> <option + +>-i --test</option + +> <replaceable + +></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable + +></userinput + +></screen +> .Если в ответ не будет никаких сообщений , значит все завершилось успешно. </para +></listitem> + <listitem +><para +>Установка пакета делается как обычно , например <screen +><prompt + +>$</prompt + +> <userinput + +><command + +>su -c 'rpm</command + +> <option + +>-Uvh</option + +> <replaceable + +></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable + +>'</userinput + +></screen +> .Вас спросят о пароле для суперпользователя. </para +></listitem> + <listitem +><para +>Теперь вы можете <link linkend="starting-krusader" +>запустить</link +> &krusader;. </para +></listitem> + </orderedlist +></para> + <!-- Empty line to make it more readable --> + <tip +><para +>Для получения более подробной информации по RPM посетите &rpm_org_url; и почитайте &rpm_guide_url; от Eric Foster-Johnson. </para +></tip> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + + <qandaentry> + <question id="faqi_rpm_fails"> + <para +>Я пытаюсь установить бинарный пакет (RPM или DEB ) , только ничего не получается .Что неправильно ?</para> + </question> + <answer> + <para +>Обычно мы только пишем (и используем) исходный код , мы не знаем об этом.Вы провели тестирование пакета перед установкой ?<screen +><prompt + +>$</prompt + +> <userinput + +><command + +>rpm</command + +> <option + +>-i --test</option + +> <replaceable + +></path/to/rpmfile> krusader-x.xx.dist.rpm</replaceable + +></userinput + +></screen +>.Если не было никаких сообщений после обработки команды , значит все в порядке.Пакеты , которые доступны на нашем сайте обычно предоставляются пользователями.Посетите сайт вашего дистрибутива и поищите там нужный пакет.</para> + <para +>Если пакета нет , попробуйте поискать другие пакеты для &Linux; в фаловых архивах , таких как &freshmeat_url; или &kde_apps_url;.Если вы так и не смогли найти пакет для вашего дистрибутива , мы рекомендуем поискать на &rpmfind_url; или &rpmpbone_url;.</para> + <para +>В основном , пакеты от старых версий вашего дистрибутива или других дистрибутивов могут заботать ( например будут работать под Mdk и RH, и им подобным) , хотя конечно же лучше всего будет если вы будете устанавливать пакеты , предназначенные для вашего дистрибутива.Если вы так и не смогли найти пакеты для вашей версии дистрибутива или вашей архитектуры используйте пакет с исходным кодом.Если вы будете собирать из пакета с исходным кодом , Крусадер будет гарантировано собран под ваши архитектуру и дистрибутив.В дополнение этот метод дает максимальные результаты в скорости дальнейшей работы , потому что пакет оптимизирован под особенности вашего компьютера.Пожалуйста прочитайте предыдущий вопрос , он обьясняет установку из пакета с исходным кодом.Лучшие решения описаны в следующем вопросе. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + +<qandaentry> + <question id="faqi_rpm_notfound"> + <para +>Я не могу найти пакеты RPM или DEB для &krusader; , что делать ?</para> + </question> + <answer> + <para +>Check if your distribution provides &krusader;, if it doesn't than contact your distribution creator and ask them to include &krusader;!</para> + + <para +>Вы видели &URL;' на &install_proc_lnk; странице ? И ничего не нашли ? Значит вы можете скомпилировать &krusader; из исходного кода.Если вы не уверены в своих возможностях , попробуйте собрать &krusader;!Мы предоставили очень подробную методику установки. Это руководство позволит новичкам собрать &krusader; из исходного кода даже если вы не собирали ранее ничего , просто внимательно следуйте инструкциям.Оставьте сообщение на &help_request_lnk; если столкнетесь с проблемами. </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + <qandaentry> + <question id="faqi_krusaderui_rc"> + <para +>Я установил &krusader;, только когда я запускаю его в меню видно только <guimenu +>"Help"</guimenu +>.Почему ?</para +></question> + <answer> + <para +>In this case only the <guimenu +>Help</guimenu +> menu is visible and all other menu items like ⪚ <guimenu +>File</guimenu +> and <guimenu +>Select</guimenu +> are missing. This is because some distributions put the <filename +>krusaderui.rc</filename +> file in the wrong directory. To solve the problem, just copy the <filename +>krusaderui.rc</filename +> file from the package <filename +>krusader_kde3/krusader/krusaderui.rc</filename +> to <filename +>$KDEDIR/share/apps/krusader/krusaderui.rc</filename +> and <filename +>~/.kde/share/apps/krusader/krusaderui.rc</filename +> and re-run &krusader;. If you have compiled &krusader; from sources this is often caused when the &kdeqtdir_lnk; environment variables are not correctly set. The result is that the <filename +>krusaderui.rc</filename +> file is installed in the wrong directory. Please also read the next question.</para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqi_missing_menus"> + <para +>Некоторые новые меню &krusader; недоступны после обновления , что поломалось?</para> + </question> + <answer> + <para +>Файл <filename +>krusaderui.rc</filename +> хранится в <filename +>$KDEDIR/share/apps/krusader/krusaderui.rc</filename +>. Если вы выбрали новую <guilabel +>"Панель"</guilabel +> ,&kde; создаст копию файла <filename +>~/.kde/share/apps/krusader/krusaderui.rc</filename +> в домашнем каталоге. Если Крусадер уже был установлен на вашем компьютере, и вы установили новую версию , файл <filename +>~/.kde/share/apps/krusader/krusaderui.rc</filename +> должен быть перезаписан новой версией. </para> + + <para +>Первая строка файла <filename +>krusaderui.rc</filename +> содержит номер версии. После установки новой версии &krusader; &kde; автоматически перепишет старый файл <filename +>~/.kde/share/apps/krusader/krusaderui.rc</filename +> новой версией при первом старте нового &krusader; (&kde; определит новую версию по первой строке). </para> + + <para +>Если вы устанавливает из CVS или бета версию и &krusader; уже был кстановлен вы должны удалить старый файл <filename +>krusaderui.rc</filename +> для вклучения новых меню <prompt +>$</prompt +> <userinput +><command +>rm</command +> <option +>~/.kde/share/apps/krusader/krusaderui.rc</option +></userinput +> </para> + + <para +>Если файл <filename +>~/.kde/share/apps/krusader/krusaderui.rc</filename +> старый , новые элементы меню не будут видны. Прочитайте предыдущий вопрос , в нем описано как обновить файл <filename +>krusaderui.rc</filename +>. Если файл <filename +>krusaderui.rc</filename +> утерян или находится не в том каталоге , видно только <guimenu +>"Справка"</guimenu +> , прочитайте предыдущий вопрос. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqi_libfam_la"> + <para +>Когда я запускаю <command +>make</command +> , он жалуется на <filename +>libfam.la</filename +></para> + </question> + <answer> + <para +>Скрипт <command +>./configure</command +> не проверяет наличие файла <filename +>libfam.la</filename +>, и <command +>make</command +> нуждается в <filename +>libfam.la</filename +> для сборки &krusader;.Если вы знаете как это устранить , помогите нам.Установите пакет <filename +>libfam0-devel-foo.rpm</filename +>.Примечание: если вы установили &Mandrake;-&Linux; 9.2 с настройками по умолчанию , этот пакет не установлен.Если вам нужно больше информации о зависимостях посмотрите на &missing_libs_lnk;. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqi_deb_qt"> + <para +>&debian; жалуется на &Qt; когда запускаю <command +>./configure</command +></para> + </question> + <answer> + <para +>Эта проблема возникает когда вы используете &gcc; 2.95, нужно установить &gcc; 3.2 (или выше). Вы также должны установить переменные окружения "CC, CPP and CXX" до запуска скрипта <command +>./configure</command +> .script. <screen +><prompt +>$</prompt +> <userinput +><command +>export</command +> CC=<replaceable +>/usr/bin/gcc-3.2</replaceable +></userinput> +<prompt +>$</prompt +> <userinput +><command +>export</command +> CXX=<replaceable +>/usr/bin/g++-3.2</replaceable +></userinput> +<prompt +>$</prompt +> <userinput +><command +>export</command +> CPP=<replaceable +>/usr/bin/cpp-3.2</replaceable +></userinput> +</screen +> Для получения дополнительной информации посетите &debian_qt_a_url; и &debian_qt_b_url; чтобы узнать как собирать приложения &Qt;/&kde;3 в &debian;. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqi_nvidia"> + <para +>У меня ошибка компиляции <filename +>libGLcore.so.1</filename +> после использования инсталлятора &nvidia;</para> + </question> + <answer> + <para +>Эта проблема связана с использованием установщика &nvidia;. &krusader; основан на &Qt; и связан с библиотеками X OpenGL . Проблема в том , что установщик &nvidia; ( до версии 7xxx) переписывает файлы заголовков OpenGL и не устанавливает правильные ссылки на библиотеки OpenGL. Лучшим решением будет использовать пакет с драйвером &nvidia; , который идет в дистрибутивной поставке.Если в некоторых случаях необходимо использовать старый драйвер единственное решение использовать нестандартное решение для старого драйвера(6111 в этом примере) , что-то вроде этого : <screen +><prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.0</replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so</replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.1.0.0</replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGLcore.so.0.0.0</replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so </replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.0</replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.0.0.0</replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.1</replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable>libGLcore.so.1.0.6111 libGL.so.1.0.0</replaceable></userinput> +<prompt>$</prompt> <userinput><command>ln</command> -s <replaceable> /usr/lib/libGLU.la /usr/X11R6/lib/libGLU.la</replaceable></userinput> +</screen> + </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + +<qandaentry> + <question id="faqi_gcc4"> + <para +>Почему &krusader;-1.60.x не собирается с gcc4?</para> + </question> + <answer> + <para +>Потому что &krusader;-1.60.x не совместим с gcc4 , он нуждается в заплатках : <itemizedlist +> <listitem +><para +>add 'class ListPanelFunc;' in krusader/Panel/listpanel.h</para +></listitem +> <listitem +><para +>add 'class KMountManGUI;' in krusader/MountMan/kmountman.h</para +></listitem +> <listitem +><para +>add 'class KrDetailedViewItem;' in krusader/Panel/krdetailedview.h </para +></listitem +> </itemizedlist +> Больше можно узнать на нашем <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1328" +>форуме</ulink +> . </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + + <qandaentry> + <question id="faqi_help_request"> + <para +>У меня возникли пролемы со сборкой и установкой &krusader;, где и как мне получить помощь ?</para> + </question> + <answer> + <para +>Пожалуйста прочитайте нашу подробную <link linkend="compilation" +>инструкцию по установке</link +> и &faq_lnk;. Если вы не нашли решение проблемы опишите все в <emphasis role="bold" +>просьбе о помощи</emphasis +> на нашем форуме &kruusers_url; или в списке рассылки.Перед этим попробуйте следующее: <orderedlist> + <listitem +><para +>Воспользуйтесь функцией &kruforumsearch_url; на &forum_lnk;, ваша проблема возможно уже решена или уже обсуждается .</para> + </listitem> + + <listitem +><para +>Если вы не нашли решения проблемы , создайте вопрос со следующими параметрами: <itemizedlist +> <listitem +><para +>используемая версия &krusader;</para +></listitem +> <listitem +><para +>дистрибутив &Linux; + версия</para +></listitem +> <listitem +><para +>полное описание проблемы</para +></listitem +> </itemizedlist +> Без этой информации будет очень трудно помочь вам. <note +><para +>Если у вас появляются ошибки в работе (например сообщения об ошибках <command +>make</command +> ) , пожалуйста начните с первой ошибки , все последующие - это следствие первой ошибки и не причина вашей проблемы. </para +></note +></para> + </listitem> + + <listitem +><para +>Пошлите ваш запрос о помощи ;)</para> + </listitem> + + </orderedlist> + </para> + <para +>Спасибо за ваше сотрудничество!</para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + +<qandaentry> + <question id="faqi_rpm_build"> + <para +>Как мне собрать пакет RPM для &krusader;?</para> + </question> + <answer> + <para +>Если у вас есть опыт сборки программ из исходного кода , можете попробовать также собрать и RPM.Информация о сборке на &rpm_org_url; и в &rpm_guide_url; от Eric Foster-Johnson.Далее короткое описание процедуры создания RPM. </para> + <warning +><para +>Никогда не создавайте пакеты RPM под учетной записью root.Ошибки в построении пакета (например неправильный файл <filename +>krusader.spec</filename +>) могут серьезно повредить вашу систему, когда вы работаете как root.</para +></warning> + <para +><orderedlist> + <listitem +><para +>Соберите &krusader; из исходного кода для проверки корректной компиляции. </para +></listitem> + <listitem +><para +>Проверьте права доступа для <filename class="directory" +>/usr/src/RPM/</filename +> и всех вложенных директорий - ваша учетная запись пользователя должна иметь права на чтение-запись-выполнение во всех директориях. </para +></listitem> + <listitem +><para +>Скопируйте <filename +>kusader-1.xx.tar.gz</filename +> в <filename class="directory" +>/usr/scr/RPM/SOURCE</filename +> </para +></listitem> + <listitem +><para +>Скопируйте <filename +>kusader.spec</filename +>в <filename class="directory" +>/usr/scr/RPM/SPECS</filename +> Совет: самый последний <filename +>kusader.spec</filename +> можно найти в CVS. </para +></listitem> + <listitem +><para +>Отредактируйте <filename +>kusader.spec</filename +> и добавьте свое имя , адрес эл. почты , имя пакета ,...Другие изменения необходимы , если <command +>rpmbuild</command +> не работает. </para +></listitem> + <listitem +><para +>Создайте бинарный пакет и пакет с исходным кодом с помощью <screen +><prompt +>$</prompt +> <userinput +><command +>rpmbuild</command +> <option +>-ba</option +> <replaceable +>/usr/scr/RPM/SPECS/krusader.spec</replaceable +></userinput +></screen +>Если будет удачно вы получите бинарный RPM в <filename class="directory" +>/usr/src/RPM/RPMS/i586</filename +>(в зависимости от вашей архитектуры) и пакет с исходным кодом в <filename class="directory" +>/usr/src/RPM/SRPMS/</filename +> . например <filename +>krusader-1.70-beta1.suse10.i586.rpm</filename +> и <filename +>krusader-1.70-beta1.suse10.src.rpm</filename +> </para +></listitem> + <listitem +><para +>Если возникнут ошибки , вы получите сообщения от rpmbuild , попытайтесь устранить их перезапустите <command +>rpmbuild</command +> снова. </para +></listitem> + <listitem +><para +>В конце: <link linkend="faqi_rpm_source" +>проверьте</link +> пакет перед тем , как послать его нам. </para +></listitem> + </orderedlist +></para> + + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + +<qandaentry> + <question id="faqi_cvs_verion"> + <para +>Why does &krusader;-cvs shows an old version number in the about box?</para> + </question> + <answer> + <para +>Because we only change the version number just before we do a new release. &krusader;-cvs will show an older version number, so ignore the version number and check the download date. We just haven't decided yet what will be the next version number :) </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + +</qandaset> +</sect1> + + +<sect1 id="faq_usage"> +<title +>&FAQ; Использование</title> +<qandaset> + + <qandaentry> + <question id="faqu_qt355"> + <para +>Почему &krusader; падает ?</para> + </question> + <answer> + <para +>Мы получили много писем-отчетов(декабрь 2005) относительно различных проблем в &krusader;,особенно во время некоторых операций с файлами(копирование/перемещение и др.)<emphasis role="bold" +>Эти проблемы связаны с &Qt; 3.3.5 и &krusader; тут не виноват.</emphasis +>Это , возможно серьезная ошибка в &Qt; 3.3.5 и причина многочисленных сбоев в различных приложениях &kde; включая &konqueror;.В Google вы можете найти множеств подобных вопросов.В дальнейшем , насколько нам известно в &debian;-Sid и &SuSE; уже включена новая версия &Qt; с устраненной проблемой. Дополнительная информация на нашем <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1407" +>сайте</ulink +>. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + + <qandaentry> + <question id="faqu_supermount"> + <para +>Когда я пробую монтировать/отмонтировать мои cdrom/floppy, &krusader; говорит о supermount, что это такое ?</para> + </question> + <answer> + <para +>Supermount это демон , который самостоятельно монтирует/отмонтирует файловые системы.Только вставьте флоппи и дайте команду <userinput +><command +>cd</command +> <option +><replaceable +>/mnt/floppy</replaceable +></option +></userinput +> и он смонтирует его автоматически без вашего участия.Это великолепно ,только supermount обманывает систему , говоря ей что <hardware +>floppy/cdrom</hardware +> смонтирован все время !Это создает проблему для &krusader;, не дает коррректно отмонтировать флоппи или СД диск , потому что supermount не дает корректной информации реально ли <hardware +>флоппи</hardware +> находится в <hardware +>приводе</hardware +>?Конечно , это будет разрешено , только сейчас это рассматривается нами как очень важное.Воможно кто-то напишет заплатку для этого ;-). </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_dead_mountpoint"> + <para +>Почему &krusader; зависает когда неверна точка монтирования ?</para> + </question> + <answer> + <para +>Когда &krusader; , например просматривает ресурсы NFS и сервер выключен , &krusader; зависнет.Это зависание фатально для &krusader; (и для всех открытых встроенных редакторов/просмотрщиков) и может быть исправлено только командой <command +>kill -9</command +>.Мы не имеем предложенных решений для решения проблемы.Эта проблема не связана с файловыми менеджерами или самой ОС &Linux;!Проблема этого вашего "зависания" в первом обращении к отключенному ресурсу - там нет возможности сделать проверку содержимого , осмотреть каталог и <command +>ls</command +> зависает.Это проблема многонитевой архитектуры и в самом приложении зависания нет.Мы не знаем где проблема , скорее всего это не &kde; он использует &Qt;-mt (многонитевая версия библиотеки) , и Krusader Krew не знает решения этой проблемы , в настоящее время мы просто смирились с этой проблемой. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_resize"> + <para +>Почему когда я пытаюсь уменьшить окно &krusader; нижняя часть не изменяет свои размеры.По-сущевству , не получается уменьшить окно.Почему ?</para> + </question> + <answer> + <para +>Смотрите на кнопки <guibutton +>F1, F2</guibutton +> (&etc;) ? &krusader; пока не позволяет уменьшить их размер.Пока просто запретите их <emphasis role="bold" +><menuchoice +><guimenu +>Вид</guimenu +> <guimenuitem +>Показывать FN панель</guimenuitem +></menuchoice +></emphasis +> и окно &krusader; можно будет уменьшить.Начиная с версии 1.51 мы введем это: когда размер будет уменьшен кнопки будут выглядеть примерно как 'F5..ровать'. Минимальная ширина для полного отображения текста каждой кнопки - 45 точек. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_refresh"> + <para +>Когда я произвожу некоторые операции над файлами панели &krusader; не обновляются / Я использую &krusader; с установленным fam , но обновление панелей не видно.</para> + </question> + <answer> + <para +>Плохие новости , <command +>fam</command +> корректно работает далеко не всегда.Мы проверяли и точно определили - это не <emphasis +>наша</emphasis +> проблема .Мы побовали два одинаковые пакеты на двух различных системах Gentoo: один работает , а другой нет.Хорошие новости - если вы запретите <application +>fam</application +>, &krusader; автоматически вернется на собственный механизм обновления ( с немного меньшей эффективностью работы) без необходимости пересборки. Вы можете запретить <application +>fam</application +> в <screen +><prompt +>$</prompt +> <userinput +><command +>su -c 'fam -l'</command +></userinput +></screen +> .Для более подробной информации посмотрите документацию . </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_samba_codepage"> + <para +><application +>Samba</application +> кодировка ISO 8859-x / что делать если &krusader; не может прочитать содержимое директорий в других локалях ?</para> + </question> + <answer> + <para +>&krusader; не управляет <application +>Samba</application +> .Если вам нужна другая кодировка вы должны вручную её настроить .Создайте или модифицируйте файл <filename +>~/.smb/smb.conf</filename +> <programlisting> + [global] + workgroup = MyWorkGroup (ex. WORKGROUP) + client code page = MyCodePage (ex. 852) + character set = MyCharSet (ex. ISO8859-2)</programlisting +> в вашем любимом текстовом редакторе. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_krarc_protocol"> + <para +>&krusader; говорит что "krarc:... протокол не поддерживается" при открытии файла архива.</para> + </question> + <answer> + <para +>Решение: установите правильно krarc slave:</para> + <para +>Скопируйте файлы <filename +>kio_krarc.so</filename +>, <filename +>kio_krarc.la</filename +> в <filename class="directory" +>$KDEDIR/lib/kde3</filename +></para> + <para +>Копируйте <filename +>krarc.protocol</filename +> в <filename class="directory" +>$KDEDIR/share/services</filename +></para> + <para +>или директорию , в которой находятся KIO slaves вашего дистрибутива &Linux;. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + +<qandaentry> + <question id="faqu_krarc_support"> + <para +>Я получаю сообщение об ошибке "протокол не поддерживается в крусадер: "krarc:/путь/некоторый архив" , когда пытаюсь открыть файл архива</para> + </question> + <answer> + <para +>Иконки, kio_slaves и документация должны быть правильно установлены в дереве каталогов &kde;. Файлы <filename +>kio_krarc.*</filename +> быть в той же директории , что и остальные KIO slaves.Попробуйте : locate <filename +>kio_tar.*</filename +> и копируйте/сделайте ссылки на файлы <filename +>kio_krarc.*</filename +> в соответствующей директории. Не забудьте после запустить команду <command +># ldconfig</command +> в соответствующей директории.Дополнительная информация <ulink url="www.krusader.org/phpBB/viewtopic.php?t=991" +>здесь</ulink +> . </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + + <!-- Thanks to Dirk Eschler --> + <qandaentry> + <question id="faqu_ftp_firewall"> + <para +>Почему у меня возникают проблемы с соединением по &FTP;?</para> + </question> + <answer> + <para +>Эта проблема часто возникает если вы защищены прокси или файрволлом.Откройте Open <emphasis role="bold" +><menuchoice +><guimenu +>Центр управления KDE</guimenu +> <guimenuitem +>Сеть</guimenuitem +><guimenuitem +>Настройки</guimenuitem +></menuchoice +></emphasis +> , <guilabel +>"Разрешить пассивный режим (PASV)"</guilabel +> должно быть включено или выключено в зависимости от текущих настроек. Теперь попробуйте снова сделать соединение с &FTP;Также проверьте чтобы не было других соединений с &FTP; и открытых сессий (браузеры и т.д.), они могут создать проблемы. Дополнительную информацию можно найти в &active_passive_ftp_url; . </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <!-- Thanks to Karai Csaba --> + <qandaentry> + <question id="faqu_ftp_http_proxy"> + <para +>Я получаю ошибку <errorcode +>"Протокол FTP не поддерживается в &krusader;"</errorcode +> когда пытаюсь открыть директорию на удаленном &FTP;.</para> + </question> + <answer> + <para +>Причина этой ошибки в том что работа &FTP; через &HTTP; прокси не включена в &krusader;.Эта ошибка вызвана неправильной настройкой прокси в &kcontrolcenter;.Выставьте в настройках не использовать прокси для &HTTP; и &FTP; и все будет работать. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + + <qandaentry> + <question id="faqu_close_connection"> + <para +>Как мне закрыть удаленное соединение (например соединение с FTP)?</para> + </question> + <answer> + <para +>Это объясняется в <link linkend="remote-connections" +>разделе удаленные соединения</link +> . </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqu_media_protocol"> + <para +>Почему у меня возникают проблемы с протоколом media:// ?</para> + </question> + <answer> + <para +>В настоящее время написание протокола the media:// находится в нестабильном состоянии , мы должны подождать пока команда &kde; устранит ошибки , все остальные протоколы в &krusader;, работают нормально , проблемы только с media. Допольнительная информация относительно этого вопроса доступна на <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1357" +>нашем форуме</ulink +> . </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <!-- Thanks to thepieman at the Krusader Forum --> + <qandaentry> + <question id="faqu_sound"> + <para +>Как мне запретить системные звуки , например звук , когда происходит удаление ?</para> + </question> + <answer> + <para +>Это настройки Системный звук в &kde; и они не имеют отношения к &krusader;.Если вы хотите глобально запретить их , откройте &kde; &kcontrolcenter; (<application +>kcontrol</application +>): <emphasis role="bold" +><menuchoice +><guimenu +>Центр управления KDE</guimenu +> <guimenuitem +>Sound & Мультимедиа</guimenuitem +><guimenuitem +>Системные уведомления</guimenuitem +></menuchoice +></emphasis +> , <guilabel +>Источник событий: "Системные уведомления KDE"</guilabel +> и снимите отметки с ненужных уведомлений.</para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + + +<qandaentry> + <question id="faqu_remoteMan"> + <para +>Что такое RemoteMan - это менеджер удаленных соединений ?</para> + </question> + <answer> + <para +>RemoteMan теперь заменен Менеждером закладок с Krusader 1.25-beta1.Менеджер закладок управляет локальными файлами и <link linkend="remote-connections" +>удаленными &URL;'s</link +> одинаково.RemoteMan будет удален в &krusader;-1.51 , есть возможность переноса ваших &bookmarks_lnk;.Он будет удален полностью в &krusader;-1.60. </para> + <para +>Процедура переноса &URL; <orderedlist numeration="arabic"> + <listitem> + <para +>установите &krusader;-1.51</para> + </listitem> + <listitem> + <para +>Откройте RemoteMan и соединитесь с &FTP;</para> + </listitem> + <listitem> + <para +>сделайте закладку для текущего положения , выберите имя и сохраните.</para> + </listitem> + <listitem> + <para +>сделайте это для всех ваших соединений , все ваши &bookmarks_lnk; будут сохранены в файле <filename +>krbookmarks.xml</filename +></para> + </listitem> + <listitem> + <para +>установите &krusader;-1.60, он использует файл <filename +>krbookmarks.xml</filename +> или импортируйте его если понадобится.</para> + </listitem +> </orderedlist> + </para +> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + <qandaentry> + <question id="faqu_mimetypemagic_archives"> + <para +>Почему привязки к типу файлов не работают внутри архивов?</para> + </question> + <answer> + <para +>Когда вы входите в архив и нажимаете клавишу <keycap +>F3</keycap +> для просмотра файла с неизвестным расширением , например файл <filename +>README, INSTALL</filename +> &etc; и если просмотрщик открывает его в режиме HEX просмотра вместо обычного , просто надо настроить :<emphasis role="bold" +><menuchoice +><guimenu +>Центр управления KDE</guimenu +> <guimenuitem +>Компоненты KDE</guimenuitem +><guimenuitem +>Привязки файлов</guimenuitem +> <guimenuitem +>Приложения</guimenuitem +><guimenuitem +>octet-stream</guimenuitem +></menuchoice +></emphasis +>, <guilabel +>binary viewer</guilabel +> нужно удалить. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + + <qandaentry> + <question id="faqu_handbook"> + <para +>Почему Руководство не работает ?</para> + </question> + <answer> + <para +>Эта ошибка случается в дистрибутивах &debian;(или на основе &debian;) с пакетом krusader_1.51-1_i386.deb.Вы видите следующее сообщение об ошибке , когда открываете Руководство "Запрашиваемый файл не найден. Проверьте правильность установки документации".Для устранения перейдите в <filename +>/usr/share/doc/kde/HTML/en/krusader/</filename +>, вы должны увидеть файлы <filename +>foo.docbook.gz</filename +>.Теперь распакуйте все эти файлы с привилегиями root в файлы <filename +>foo.docbook</filename +>.Теперь Руководство будет работать.Эта ошибка исправлена в пакете krusader_1.60.0-1_i386.deb и старших версиях. </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + + <qandaentry> + <question id="faqu_save_last_location"> + <para +>Why "save last location" doesn't work?</para> + </question> + <answer> + <para +>Unfortunately the 1.70.x version contains a bug. The tabs are not saved if a "Panels Save Settings=Tabs" item is present in the configuration files. The fix is easy: <itemizedlist +> <listitem +><para +>open and edit <filename +>~/.kde/share/config/krusaderrc</filename +></para +></listitem +> <listitem +><para +>remove the "Panels Save Settings" item</para +></listitem +> </itemizedlist +> and it'll work with the <Last Session> thing in Konfigurator. More info can be found in <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1357" +>our forum</ulink +> . </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + +</qandaset> +</sect1> + +<sect1 id="faq_general"> +<title +>Основной &FAQ;</title> +<qandaset> + + <qandaentry> + <question id="faqg_wish"> + <para +>Как мне отослать пожелания , предложения или комментарии ?</para> + </question> + <answer> + <para +>В открытых проектах есть великолепная возможность обратной связи с пользователями. Почему нам нравится слушать то что вы хотите сказать ? Ваши "Трудности" это наши инструкции.После 6 месяцев программирования программисты не увидели своих ошибок .Это естественно.Мы нуждается в идеях , критике и обратной связи , потому что хотим сделать &krusader; лучшим , наиболее удобным файловым менеджером.</para> + + <para +>Наиболее удобный способ для связи с нами - это использование &forum_lnk;, или списка рассылки пользователей &mailing_lists_url;.Что бы увидеть что сделано посмотрите &todoforum_url;.Дополнительные элементы в &todoforum_url; только для разработчиков .Свободное место для обсуждения &featureforum_url; форум &todoforum_url; не для этого.Если у вас есть новые идеи - &krusader; Krew добавит вашу просьбу в &todoforum_url;.Мы рассмотрим и обсудим каждое предложение.Дополнительная информация на форуме по ссылке <link linkend="faqg_kru_forum" +>here</link +> . </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqg_patch"> + <para +>Как мне прислать заплатку ?</para> + </question> + <answer> + <para +>It's not easy to write some patch guidlines, but here we give a try. <orderedlist numeration="arabic"> + <listitem> + <para +>Заплатки , новый код и предложения всегда приветствуются! </para> + </listitem> + + <listitem> + <para +>Если вам хочется , всегда можно начать обсуждение с разработчиками в списке рассылки пользователей &mailing_lists_url; или на &forum_lnk;.Несчастные , мы не сможем принять заплатку , если она расходится с "основным направлением" в коде &krusader;(читайте дальше). </para> + </listitem> + + <listitem> + <para +>Опишите проблему сразу , так разработчикам будет проще пронять и принять , если это заработает.Пожалуйста присылайте по одному предложению в письме , так будет проще продолжать обсуждение!Изменения будут приниматься шаг за шагом , с проверкой каждой строчки. </para> + </listitem> + + <listitem> + <para +>Присылайте все файлы или заплаты в письме.Большинство почтовиков изменяют пробелы , эти изменения не обрабатываются и код не работает.</para> + </listitem> + + <listitem> + <para +>Используйте машинно-независимые решения, &krusader; запускается в : <itemizedlist +> <listitem +><para +>All POSIX (&Linux;/BSD/&UNIX;-like OSes), &Solaris;.</para +> </listitem +> <listitem +><para +>All BSD Platforms (&freebsd;/&netbsd;/&openbsd;/&MacOS;).</para +> </listitem +> <listitem +><para +>&kde; 3.3- &kde; 3.5.3 and even on GNOME with &kde;libs.</para +> </listitem +> <listitem +><para +>GCC 2.95 - GCC 4.1</para +> </listitem +> </itemizedlist +>. Изменения в архитектуре делает только сама команда разработчиков.</para> + </listitem> + + <listitem> + <para +>A final thing to note is: Keep always in mind, a patch might be reject. Either it has side effects, which we could not fix or it does contradict the idea behind the patched module. Here a software project differs from lets say a wiki: in a software project there is someone, who makes the final decission. Otherwise software will not work. Furthermore: Keep in mind, that the examination of patches might take time, as we all have private lifes. </para> + </listitem> + + </orderedlist> + </para> + + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqg_bug_report"> + <para +>Как мне послать сообщение об ошибке?</para> + </question> + <answer> + <para +>Ошибки?!?!? Хорошо, у нас есть система отслеживания ошибок.</para> + <para +>Используйте помощь в системе отслеживания ошибок , так как много ошибок уже известно. Это избавит нас от продолжительного чтения форума &krusader; в поисках вчерашней ошибки.Пожалуйста используйте эту систему.</para> + <para +>Перед отправкой сообщения , прочтите следующее: <orderedlist> + <listitem +><para +>Используйте функцию поиска &kruforumsearch_url; на форуме &forum_lnk;, возможно ваша ошибка уже устранена.Пожалуйста НЕ ПИШИТЕ сообщения в &bugforum_url;( исключая случаи , когда вы уверены что нашли ошибку).Мы используем его для обсуждения ошибок.</para +></listitem> + <listitem +><para +><emphasis role="bold" +>Проверьте</emphasis +> если ошибка уже есть в &online_buglist_url; системе отслеживания ошибок.</para +></listitem> + <listitem +><para +>Если вы нашли упоминание о ней , пожалуйста <emphasis role="bold" +>подтвердите</emphasis +> её в системе нажатием кнопки <guibutton +>Submit New</guibutton +> в окне.Пожалуйста подтвердите следующие параметры: используемая версия &krusader;, дистрибутив+версия &Linux;, тип процессора , и полное описание проблемы , которую вы решаете. </para +></listitem> + </orderedlist +></para> + <para +>Спасибо за ваше сотрудничество!</para> + <note +><para +>Если возможно , попробуйте проделать те же операции в &konqueror; или других приложениях &kde;.Если вы встречаетесь с подобной проблемой , тогда , возможно они в &kioslaves1_url; или ошибках &kde;(библиотеках) и не являются проблемой &krusader;.&krusader; использует библиотеки &kde; и &kioslaves2_url; для многих операций .В некоторых случаях это проблемы конкретного дистрибутива , неправильная настройка , пожалуйста убедитесь в этом прежде всего! </para +></note> + <!-- Empty line to make it more readable --> + <note +><para +><remark +>Если вы нашли такую ошибку , пишите не в bugzilla http://bugs.kde.org/ &kde;.Напишите в &krusader; и отчет будет перенаправлен.</remark +></para +></note> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + <qandaentry> + <question id="faqg_mail_list"> + <para +>Имеет ли &krusader; список рассылки ?</para> + </question> + <answer> + <para +>Да , в настоящее время имеется 6 &mailing_lists_url;.Свободно можно подписаться и отписаться. </para> + + <para +>Совет.Наши списки можно просматривать прямо в браузере или просмотрщике новостей , так вам не надо подписываться. <itemizedlist> + <listitem +><para +>&krunews_url; - это очень небольшой по объему лист , используемый для новостей и анонсов новых версий или критических ошибок.Новости также можно прочитать на &krulatestnews_url; и на &newsforum_url; которые будут представлены в немного ином формате. </para +></listitem> + <listitem +><para +>&krudevel_url; - это лист рассылки для разработчиков(только для чтения).Если вы хотите присоединиться к разработке &krusader; и попасть на передовую - это место здесь! </para +></listitem +> + <listitem +><para +>&kruusers_url; - это рассылка для пользователей &krusader;.Здесь вы можете спросить совет , и поговорить о &krusader; с пользователями и разработчиками. </para +></listitem +> + <listitem +><para +>&krui18n_url; - это лист рассылки для переводчиков. </para +></listitem +> + <listitem +><para +>&krudoc_url; - рассылка документации. </para +></listitem +> + <listitem +><para +>&krucommits_url; (только для чтения) - когда &krusader; вносит изменения в код CVS , это сообщается в данном листе рассылки.Этот лист позволит вам быть в курсе состояния разработки &krusader;! Хотите быть всегда в курсе ? Ожидаете новых возможностей/исправлений ? </para +></listitem> + </itemizedlist> + </para> + <!-- Empty line to make it more readable --> + </answer> + </qandaentry> + + +<qandaentry> + <question id="faqg_newsfeeds"> + <para +>Есть ли в &krusader; ленты новостей?</para> + </question> + <answer> + <para +>Да , есть.Несколько лент доступны в различных форматах.&filereleasefeed_url;, &forumfeed_url;, &krunewsfeed_url;, &krudevelfeed_url; и также <ulink url="http://dir.gmane.org/gmane.comp.kde.krusader.devel" +>дополнительные ленты</ulink +> на gmane.org. &kruusersfeed_url;, &krui18nfeed_url;, &krudocfeed_url;. </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + +<qandaentry> + <question id="faqg_irc"> + <para +>Есть у &krusader; канал в IRC ?</para> + </question> + <answer> + <para +>Есть.Поговорить с &krusader; Krew, и пользователями можно через серверы &freenode_url;Сервер <emphasis +>irc.freenode.org</emphasis +>, канал <emphasis +>#krusader</emphasis +>.Всегда рады. </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + +<qandaentry> + <question id="faqg_kru_forum"> + <para +>Как работает форум &krusader;?</para> + </question> + <answer> + <para +>В духе свободы слова , все что связано с &krusader; можно обсудить на нашем форуме.И не важно новичок вы , или продвинутый пользователь , всегда добро пожаловать.В этом и сила открытых проектов, в обратной связи с пользователями.С вашей помощью мы сделаем &krusader; лучшим , иначе мы не узнаем о появлении новых идей , которые есть у вас.Только будьте последовательны, только так мы сможем удержаться от хаоса. ;-)</para> + + <para +>Если <link linkend="index" +>Документация</link +>, &faq_lnk;, &kruforum_url; и &krudevel_url;(пожалуйста пользуйтесь поиском) , не помогли вам, не стесняйтесь писать в форум. &krusader; Krew или сообщество , всегда сможет помочь вам.</para> + + <para +>Пожалуйста используйте функцию &kruforumsearch_url; на &kruforum_url;, возможно ваш вопрос уже обуждался(это сократит размножение сообщений).Если ваша тема уже обсуждалась в прошлом , есть большой шанс того , что решение уже найдено.Если же обсуждение ещё идет , вы можете присоединиться к нему.Некоторый вопросы регулярно повторяются.Для этого мы сделали &faq_lnk; ;-) Это позволит нам больше времени уделять разработке &krusader;.</para> + +<para +>Форум &kruforum_url; разделен на 6 частей: <itemizedlist> + <listitem +><para +>&newsforum_url; все последние новости</para +></listitem> + <listitem +><para +>&bugforum_url;:обсуждение ошибок , позалуйста НЕ ПИШИТЕ сюда (исключение , если вы не уверены что это ошибка).</para +></listitem> + <listitem +><para +>&featureforum_url;:обсуждение новых возможностей &krusader; в будущих версиях.</para +></listitem> + <listitem +><para +>&todoforum_url; here you will find the list of the planned features. Registered users will be able to VOTE and COMMENT on the TODO items. Here you get the chance to push your favourite features (+3) and still prefer certain features over others (+1), if you don't care about a feature just simply don't vote on that feature. Unregistered users may only browse the &todoforum_url;. The &todoranking_url; contains the results based on the votes. <link linkend="faqg_patch" +>Adding ToDo items</link +> or removing ToDo items which have been implemented will be done by the &krusader; Krew. </para +></listitem> + <listitem +><para +>&useractionsforum_url; обсуждение &useractions_lnk;.Пишите сюда ваши - это очень ценно.Мы планируем включить лучшие в следующие выпуски &krusader;.</para +></listitem> + <listitem +><para +>&krugenforum_url;:здесь все что не связано и не относится к другим форумам в &krusader;.</para +></listitem> + </itemizedlist> + </para> + <para +>Спасибо за ваше сотрудничество!</para> + + <para +>Ты также предоставляем ленты RSS для форумов. Вас не нужно будет постоянно проверять наличие новых сообщений , новости сами придут к вам!Просто добавьте &rss_url; в ваш клиент RSS.</para> + + <!-- Empty line to make it more readable --> +</answer> +</qandaentry> + +<qandaentry> + <question id="faqg_i18n"> + <para +>Как мне перевести &krusader; на мой родной язык?</para> + </question> + <answer> + <para +>Пожалуйста посетите &i18n_page_url;.Перевести не трудно!Многие уже сделали это , только это требует некоторого времени. </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqg_support"> + <para +>Как мне помочь &krusader;?</para> + </question> + <answer> + <para +>Вы можете <link linkend="help_krusader" +>поддержать</link +> &krusader; многими способами: присылайте нам заплатки <link linkend="faqg_wish" +>обратная связь</link +>, &faqbugreports_lnk;,<link linkend="help_krusader" +>пожертвования</link +>, переводы,... </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqg_mac"> + <para +>Есть ли порт для &MacOS; X ?</para> + </question> + <answer> + <para +>Есть , только в нем нет всех возможностей как в версии для &Linux;.Посетите <link linkend="mac-port" +>раздел &MacOS; X port </link +> для получения дополнительной информации.Рекомендованный , родной файловый менеджер для &MacOS; - это &disk_order_url;(условно бесплатный). </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + +<qandaentry> + <question id="faqg_win"> + <para +>Есть ли порт для &Windows;?</para> + </question> + <answer> + <para +>Нет, возможно в будущем.Пожалуйста <link linkend="help_krusader" +>помогите нам</link +>, спасибо.Рекомендуем для &Windows; - это &tcmd_url;(условно бесплатный). </para> + <!-- Empty line to make it more readable --> + </answer> +</qandaentry> + + +</qandaset> +</sect1> + +<!-- + <qandaentry> + + <answer> + + // Empty line to make it more readable + </answer> + </qandaentry> +--> + +</chapter> diff --git a/doc/ru/features.docbook b/doc/ru/features.docbook new file mode 100644 index 0000000..ed14c93 --- /dev/null +++ b/doc/ru/features.docbook @@ -0,0 +1,473 @@ +<chapter id="features"> + +<!-- ********************************************************************** + features.docbook + ++++++++++++++++++++++++ + (C)opyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + All Rights Reserved Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Возможности</title> +<indexterm +><primary +>Возможности</primary +></indexterm> + +<note +><para +>Наиболее важные возможности и улучшения освещены здесь, этот список будет слишком длинным, если включить <emphasis +>все</emphasis +>. Полное описание всех возможностей вы найдете в этом руководстве и в файле &changelog_url;. </para +></note> + + +<para> +<itemizedlist> + <listitem> + <para> + <itemizedlist> + <title +>Возможности &ofm_url;</title> + <listitem> + <para +>Две, легкие в использовании <link linkend="panels" +>панели</link +>.</para> + </listitem> + <listitem> + <para +>&cmdline_lnk; и опционально &termemu_lnk; внизу.</para> + </listitem> + <listitem> + <para +>Сильная ориентированность на <link linkend="keyboard-commands" +>клавиатуру</link +>, возможность работать со всеми функциями без использования мыши.</para> + </listitem> + <listitem> + <para +>Контекстно зависимое выполнение скриптов и программ, например щелчок мыши/открыть (выполнить или открыть в ассоциированном приложении), F3(просмотр и F4(редактирование).</para> + </listitem> + <listitem> + <para +>&usermenu_lnk;, - создайте ваше специальное меню!</para> + </listitem> + <listitem> + <para +>История для всего, например ⪚ <link linkend="folderhistory" +>История каталогов</link +>, <link linkend="popular_urls" +>Наиболее часто посещаемые &URL;ы</link +>, ...</para> + </listitem> + <listitem> + <para +>&vfs_lnk; для например &remote_connections_lnk;, &archives_lnk;, результатов поиска, синхронизатора, ...</para> + </listitem> + <listitem> + <para +>Мощный встроенный <link linkend="krviewer" +>просмотрщик и редактор</link +> через kparts поддерживает все доступные форматы файлов!</para> + </listitem> + <listitem> + <para +>&advanced_search_module_lnk; : поиск в архивах и удаленных файловых системах.</para> + </listitem> + <listitem> + <para +>Несколько режимов просмотра в панели через &popup_panel_lnk;.</para> + </listitem> + <listitem> + <para +>&remote_connections_lnk; : &FTP;/SAMBA с поддержкой SFTP/SCP через &kioslaves1_url;</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + + <listitem> + <para> + <itemizedlist> + <title +>Инструменты &krusader;</title> + <listitem> + <para +><link linkend="mount-man" +>Менеджер монтирования</link +></para> + </listitem> + <listitem> + <para +>&syncdirs_lnk;</para> + </listitem> + <listitem> + <para +>&diskusage_lnk;</para> + </listitem> + <listitem> + <para +>&locate_lnk;</para> + </listitem> + + + + + + + + </itemizedlist> + </para> + </listitem> + + + <listitem> + <para> + <itemizedlist> + <title +>Возможности &krusader;</title> + <listitem> + <para +>Работа с архивами: просмотр, распаковка, упаковка, тестирование.Поддкрживаются &archives_lnk; : ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip и 7-zip.</para> + </listitem> + <listitem> + <para +><link linkend="checksum" +>Проверка-создание контрольной суммы</link +> поддерживается md5, sha1, sha256, tiger, whirlpool.Поддерживаются внешние инструменты md5deep и cfv.</para> + </listitem> + <listitem> + <para +><link linkend="calculate" +>Подсчет занятого пространства</link +> для файлов, каталогов, архивов и удаленных файловых систем.</para> + </listitem> + <listitem> + <para +><link linkend="compare-dir" +>Сравнение каталогов</link +> и <link linkend="view-menu" +>фильтрация</link +>.</para> + </listitem> + <listitem> + <para +><link linkend="compare-content" +>Сравнение файлов по содержимому</link +> через внешную программу &kompare;, &kdiff3_url; или &xxdiff_url;.</para> + </listitem> + <listitem> + <para +><link linkend="multi_rename" +>Переименовывание</link +> файлов и каталогов через &krename_url;</para> + </listitem> + <listitem> + <para +>Полноценная поддержка перетаскивания: перетаскивайте из &konqueror; в a .tar.gz файл, из панели в Корзину, на рабочий стол или в &konqueror;!</para> + </listitem> + <listitem> + <para +><link linkend="konfig-advanced" +>Сохранение даты</link +> для локальных целей при копировании/перемещении.</para> + </listitem> + <listitem> + <para +>F2 откроет <link linkend="tools-menu" +>Окно терминала</link +> в текущем каталоге.</para> + </listitem> + <listitem> + <para +>Легкая правка <link linkend="file-menu" +>прав файлов</link +> и владельца файла, и <link linkend="konfig-looknfeel-operation" +>прав(цифровой вид)</link +>.</para> + </listitem> + <listitem> + <para +><link linkend="krusearcher" +>Выбор фильтров</link +> используемых в синхронизаторе и поиске. </para> + </listitem> + <listitem> + <para +><link linkend="jump_back" +>Возврат</link +></para> + </listitem> + <listitem> + <para +>Полная поддержка <link linkend="konfig-general" +>mimetype</link +> (с или без "magic"!).</para> + </listitem> + <listitem> + <para +><link linkend="folder_tabs" +>вкладки на панелях</link +> и <link linkend="krviewer" +>Вкладки в Редакторе/Просмотрщике</link +>.</para> + </listitem> + <listitem> + <para +>&rootmode_lnk;, &quick_search_lnk;</para> + </listitem> + <listitem> + <para +><link linkend="splitter" +>Разделитель файла</link +>.</para> + </listitem> + <listitem> + <para +><link linkend="mouse_gestures" +>Жесты мыши</link +>.</para> + </listitem> + <listitem> + <para +><link linkend="list_panel" +>Быстрая навигация</link +> в панели адреса.</para> + </listitem> + <listitem> + <para +>&whatsthis_url; функция помощи подсказками.</para> + </listitem> + <listitem> + <para +>&sync_browsing_lnk;</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + + <listitem> + <para> + <itemizedlist> + <title +>Настройте &krusader; под себя</title> + <listitem> + <para +><link linkend="konfig-startup" +>Конфигуратор</link +> - это центр настройки &krusader;.</para> + </listitem> + <listitem> + <para +>&main_toolbar_lnk;, <link linkend="actions_toolbar" +>Меню UserActions</link +> для пользовательских действий и закладок.</para> + </listitem> + <listitem> + <para +><link linkend="key_bindings" +>Комбинации клавиш</link +>.</para> + </listitem> + <listitem> + <para +><link linkend="konfig-color" +>Цвета</link +>.</para> + </listitem> + <listitem> + <para +>&panel_profiles_lnk;</para> + </listitem> + <listitem> + <para +>&bookmark-manager_lnk;</para> + </listitem> + <listitem> + <para +>&mouse_selection_modes_lnk;</para> + </listitem> + <listitem> + <para +>Многие возможности настраиваются в <link linkend="konfig-startup" +>вкладке запуск</link +>.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + + <listitem> + <para> + <itemizedlist> + <title +>Дополнения &krusader;</title> + <listitem> + <para +>&useractions_lnk;</para> + </listitem> + <listitem> + <para +>&javascript_console_lnk;</para> + </listitem> + <listitem> + <para +>&color_profiles_lnk;</para> + </listitem> + <listitem> + <para +>&keybindigs_profiles_lnk;</para> + </listitem> + </itemizedlist> +Отправьте/загрузите свои любимые настройки/расширения/модули на &kde_files_url;! </para> + </listitem> +</itemizedlist> +</para> + +<para> +<itemizedlist> + <title +>Новые возможности в CVS версии(будущий релиз 1.80.0)</title> + <listitem> + <para +>Усовершенствование работы с архивами <itemizedlist> + <listitem> + <para +><link linkend="archives" +>Поддержка паролей</link +> для: arj, ace, rar и zip. Пароли будут сохраняться в &kwallet;</para> + </listitem> + + <listitem> + <para +><link linkend="archives" +>поддержка 7-zip</link +>, через внешние приложения 7z и 7za.</para> + </listitem> + + <listitem> + <para +><link linkend="archives" +>Автоопределение</link +>, позволит вам открывать "скрытые архивы" (например, документы &openoffice; которые фактически являются архивами zip с другим расширением в имени файла)</para> + </listitem> + + <listitem> + <para +>Упаковка/распаковка в фоне.</para> + </listitem> + </itemizedlist> + </para> + </listitem> + + <listitem> + <para +>Улучшения в &useractions_lnk;.</para> + </listitem> + + <listitem> + <para +><link linkend="konfig-advanced" +>Кнопка Media</link +>.</para> + </listitem> + + <listitem> + <para +>Копирование/перемещение: <link linkend="copying" +>сохранение всех атрибутов</link +> (время, владелец, группа).</para> + </listitem> + + <listitem> + <para +><link linkend="konfig-color" +>Тусклые цвета для неактивной панели</link +>.</para> + </listitem> + + <listitem> + <para +>Переименовывание файла без смены расширения, одиночный режим, сворачивание в системный лоток, проверка выхода в <link linkend="konfigurator" +>конфигураторе</link +> </para> + </listitem> + + <listitem> + <para +>Элементарные расширения (ЕЩЁ НЕ ДОКУМЕНТИРОВАНО).</para> + </listitem> + + <listitem> + <para +>Контекстное меню для закладок и разрешение/запрещение специальных закладок в контекстном меню.</para> + </listitem> + + <listitem> + <para +>Изменение <link linkend="menu-commands" +>Меню</link +>.</para> + </listitem> + + <listitem> + <para +>Улучшения в &termemu_lnk; (ЕЩЁ НЕ ДОКУМЕНТИРОВАНО).</para> + </listitem> + + <listitem> + <para +>Улучшения в &synchronizer_lnk; (ЕЩЁ НЕ ДОКУМЕНТИРОВАНО).</para> + </listitem> + + <listitem> + <para +>Улучшения в быстрой навигации (ЕЩЁ НЕ ДОКУМЕНТИРОВАНО)</para> + </listitem> + + <listitem> + <para +>.</para> + </listitem> + + + <listitem> + <para +>Много исправлений.</para> + </listitem> + + <listitem> + <para +>TODO ...ЕЩЁ НЕ ВКЛЮЧЕНО В РУКОВОДСТВО ... </para> + </listitem> + + <listitem> + <para +>ПРИМЕЧАНИЕ: НЕ ВСЕ ВОЗМОЖНОСТИ ОПИСАНЫ В РУКОВОДСТВЕ</para> + </listitem> + + <listitem> + <para +>ЭТОТ СПИСОК НЕ ПОЛОН ...Если кто-то хочет помочь, посетите &contribute_url;, свяжитесь с Франком.Чтобы узнать больше прочитайте &changelog_url; и &cvsnews_url;.</para> + </listitem> + </itemizedlist> +</para +> &dev_cvs_note; </chapter> diff --git a/doc/ru/glossary.docbook b/doc/ru/glossary.docbook new file mode 100644 index 0000000..2d4b64e --- /dev/null +++ b/doc/ru/glossary.docbook @@ -0,0 +1,190 @@ +<glossary id="glossary"> + +<!-- ********************************************************************** + glossary.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<para +>This chapter is intended to explain the various words which have been used throughout the &krusader; documentation. If you feel any acronyms or terms are missing here, please don't hesitate to contact the &krusader; documentation team. Thank you! </para> + +<para +>NOTE: This page is work in progress, Matej Urbancic is working at the Glossary. </para> + + +<glossentry id="gloss-a"> +<glossterm +><acronym +>A</acronym +></glossterm> +<glossdef> +<para +>bla bla. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-b"> +<glossterm +>B</glossterm> +<glossdef> +<para +>bla bla. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-bsd"> +<glossterm +><acronym +>BSD</acronym +></glossterm> +<glossdef> +<para +>Berkeley Software Distribution; here refers to any of several free &UNIX;-compatible operating systems derived from <acronym +>BSD</acronym +> &UNIX;. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-cvs"> +<glossterm +><acronym +>CVS</acronym +></glossterm> +<glossdef> +<para +>Concurrent Versions System; a software configuration management system used by many software projects including &kde; and &krusader;. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-deb"> +<glossterm +><acronym +>DEB</acronym +></glossterm> +<glossdef> +<para +>This is a binary file format that is used by &debian; and &debian;-based distributions. This will be the suffix of a file specifically for these distributions. An example would be <filename +>krusader_1.70.1-1_amd64.deb</filename +> For more information on installing these files, refer to the <ulink url="http://www.debian.org/" +>Debian Web Site</ulink +>. </para> +</glossdef> +</glossentry> + +<glossentry id="glos-ftp"> +<glossterm +>&FTP;</glossterm> +<glossdef> +<para +>&FTP; is the File Transfer Protocol; it is an Internet protocol that allows you to retrieve files from so-called &FTP; servers. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-gpl"> +<glossterm +><acronym +>GPL</acronym +></glossterm> +<glossdef> +<para +><acronym +>GNU</acronym +> General Public License; a software license created by the Free Software Foundation defining the terms for releasing free software. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-gui"> +<glossterm +>&GUI;</glossterm> +<glossdef> +<para +>Graphical User Interface </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-h"> +<glossterm +>H</glossterm> +<glossdef> +<para +>bla bla. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-kde"> +<glossterm +>&kde;</glossterm> +<glossdef> +<para +>K Desktop Environment; a project to develop a free graphical desktop environment for &UNIX; compatible systems. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-rpm"> +<glossterm +>RPM</glossterm> +<glossdef> +<para +>This is the binary file format for distributions based on the Red Hat package manager, a widely used packaging tool for the &Linux; operating system. If you still have to get &krusader; and your system supports RPM packages, you should get &krusader; packages ending in .rpm. They are very easy to use. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-url"> +<glossterm +><acronym +>&URL;</acronym +></glossterm> +<glossdef> +<para +>&URL; is an abbreviation for Universal Resource Locater. A universal resource locater is the technical term for what is commonly referred to as a websites address. Examples of URLs include <ulink url="http://krusader.sourceforge.net" +>http://krusader.sourceforge.net</ulink +> and &remote_connections_lnk;. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-s"> +<glossterm +>S</glossterm> +<glossdef> +<para +>bla bla. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-y"> +<glossterm +>Y</glossterm> +<glossdef> +<para +>bla bla. </para> +</glossdef> +</glossentry> + +<glossentry id="gloss-z"> +<glossterm +><acronym +>Z</acronym +></glossterm> +<glossdef> +<para +>bla bla. </para> +</glossdef> +</glossentry> + +</glossary> diff --git a/doc/ru/help.docbook b/doc/ru/help.docbook new file mode 100644 index 0000000..80777e3 --- /dev/null +++ b/doc/ru/help.docbook @@ -0,0 +1,142 @@ +<!-- ********************************************************************** + help.docbook + +++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<preface id="help_krusader"> +<title +>Помощь &krusader;</title> + +<para +>Здесь вы можете присоединиться к &contribute_url; для &krusader; .Если вы чувсвуете , что сможете помочь , не стесняйтесь , свяжитесь с нами .Спасибо !</para> + + +<para +><emphasis role="bold" +>Документация</emphasis +></para> +<para +>Документация &krusader; нуждается в авторах для поддержания в актуальном состоянии(мы присматриваем новых авторов).Черновики с пояснениями нововведений доступны в списке рассылки разработчиков , мы нуждаемся в редакторах для внесения информации в Руководство.Играясь с новыми возможностями эти редакторы могли бы дать ценную информацию для разработчиков чтобы сделать нововведения как можно лучше !</para> + + +<para +><emphasis role="bold" +>&krusader; дополнения</emphasis +></para> +<para +>Пожалуйста загружайте ваши дополнительные расширения на &kde_files_url;, так они станут доступны сообществу пользователей &krusader;. Возможно они станут частью &krusader; в следующем выпуске :-)) Это возможности <ulink url="http://www.kde-files.org/index.php?xcontentmode=660" +>Keymaps</ulink +>, <ulink url="http://www.kde-files.org/index.php?xcontentmode=661" +>Цветовые схемы</ulink +>, <ulink url="http://www.kde-files.org/index.php?xcontentmode=662" +>User Actions</ulink +>, <ulink url="http://www.kde-files.org/index.php?xcontentmode=663" +>JavaScript Extensions</ulink +>. </para> +<para +>Пользовательские действия обсуждаются тут &useractionsforum_url; , пожалуйста присоединяйтесь!</para> + + +<para +><emphasis role="bold" +>Распространение слова &krusader;</emphasis +></para> +<para +>Если вам понравился &krusader;, <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1419" +>let people know!</ulink +> Пишите статьи и обзоры для публикации в Интернет.Предложите вашим друзьям попробовать &krusader;.Учавствуйте в форумах и помогайте сообществу.</para> + + +<para +><emphasis role="bold" +>Переводы</emphasis +></para> +<para +>&krusader; переведен на множество языков , обычно некоторые переводы нуждаются в обновлении и новые переводы всегда приветствуются , пожалуйста посетите &i18n_page_url; .Если для вашего родного языка уже есть переводчик , всегда будет полезно иметь второго или третьего ⪚ для корректировки перевода.Иногда текущий переводчик не может обновить перевод , когда это необходимо (учеба,праздники,...).Пожалуйста свяжитесь с переводчиком на ваш родной язык , он всегда будет рад предложенной помощи. Любой перевод (даже частичный) будет принят в &krusader;-Krew в любое время .</para> + + +<para +><emphasis role="bold" +>Открытое использование</emphasis +></para> +<para +>В настоящее время мы не имеем значимых пожертвований , заинтересованные пользователи могут спросить нас на &donate_url; проекта. &krusader; есть и будет свободным , во все времена под публичной лицензией GNU.</para> +<para +>Этот проект объединяет программистов и специалистов по эргономике в попытке улучшить качество работы пользователя.Наша цель сделать работу и диалог с компьютером дружественным и понятным для каждого.Мы нуждаемся в ваших комментариях , что сделать это как можно лучше.Если вы находите что какая-то часть программы слишком сложна , помогите нам сделать её проще. </para> + + +<para +><emphasis role="bold" +>Пожертвования</emphasis +></para> +<para +>В настоящее время мы не имеем значимых пожертвований , заинтересованные пользователи могут спросить нас на &donate_url; проекта. &krusader; есть и будет свободным , во все времена под публичной лицензией GNU. </para> + + +<para +><emphasis role="bold" +>Сборщики</emphasis +></para> +<para +>Мы всегда нуждаемся в сборщиках для различных дистрибутивных пакетов : rpm's, deb's, etc. Всякая помощь приветствуется.</para> + + +<para +><emphasis role="bold" +>Обратная связь с пользователями &krusader;порта &MacOS;</emphasis +></para> +<para +>Крусадер <link linkend="mac-port" +>портирован</link +> на &macosx_download_url; с &fink_url; и библиотеками libs, сопровождается &bodo_tasche_url;, и обратная связь приветствуется.</para> + + +<para +><emphasis role="bold" +>Портирование &krusader; для &Windows;</emphasis +></para> +<para +>&krusader; написан с использованием &Qt; и зависит от библиотек &kde;. Долгое время они были недоступны для портирования &krusader; под &Windows; - это не давало выбора. Однако , мы верим , с портированием библиотек &kde; на &Qt;4 под лицензией GPL попытки портирования завершатся успешно , мы будем в деле и нуждаемся в поддержке для портирования &krusader; под &Windows;.</para> + + +<para +><emphasis role="bold" +>Часто задаваемые вопросы</emphasis +></para> +<para +>Если у вас есть вопросы , которые отсутсвуют на &faq_lnk;, мы готовы выслушать их.</para> + + +<para +><emphasis role="bold" +>Другое</emphasis +></para> +<para +><link linkend="faqg_wish" +>Обратная связь</link +>, <link linkend="faqg_bug_report" +>Отчеты об ошибках</link +>, заплатки, &etc; всегда добро пожаловать! Огромная сила открытых проектов в помощи пользователей. </para> + + +<para +>На некоторых сайтах подобных &freshmeat_url; или &kde_apps_url; вы можете выставлять рейтинг , если вам понравился &krusader; посетите один из сайтов и добавьте рейтинг &krusader;, заранее спасибо.</para> + + +</preface> diff --git a/doc/ru/index.docbook b/doc/ru/index.docbook new file mode 100644 index 0000000..0dfaca9 --- /dev/null +++ b/doc/ru/index.docbook @@ -0,0 +1,1113 @@ +<!-- <?xml version="1.0" ?> --> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + +<!-- +Previous used Docbook +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ +--> + +<!-- ********************************************************************** + index.docbook + +++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<!ENTITY krusader 'Krusader'> +<!ENTITY kapp "&krusader;"> +<!ENTITY kappname "&krusader;"> +<!-- <!ENTITY % addindex "IGNORE" +> --> +<!ENTITY % addindex "INCLUDE"> + +<!-- ONLY If you are writing non-English original documentation, change the language here --> +<!ENTITY % Russian "INCLUDE"> +<!ENTITY Backspace "<keycap>Backspace</keycap>"> +<!-- +<!ENTITY % English "INCLUDE"> changed to Russian +and added <!ENTITY Backspace "<keycap>Backspace</keycap>"> in index.docbook +since the Entity Backspace is not defined in +/usr/share/apps/ksgmltools2/customization/ru/user.entities on KDE: 3.5.4 +--> + +<!-- kdebase, kdeadmin, etc. Leave this unchanged if your application is not maintained in KDE CVS --> +<!ENTITY package "kde-module"> + +<!-- internet links, Krusader --> +<!ENTITY onlinehandbook_url '<ulink url="http://www.krusader.org/handbook/" +>Online Handbook</ulink +>'> +<!ENTITY kru_screenshots_url '<ulink url="http://www.krusader.org/scr.php" +>&krusader; Screenshot</ulink +>'> +<!ENTITY mail_url '<ulink url="mailto:krusader * users.sourceforge net" +>mail</ulink +>'> + +<!ENTITY kruwebsite_url '<ulink url="http://www.krusader.org" +>Krusader website</ulink +>'> +<!ENTITY kruproject_url '<ulink url="http://sourceforge.net/projects/krusader" +>here</ulink +>'> +<!ENTITY contribute_url '<ulink url="http://www.krusader.org/help.php" +>contribute</ulink +>'> +<!ENTITY donate_url '<ulink url="http://sourceforge.net/project/project_donations.php?group_id=6488" +>Donate</ulink +>'> + +<!ENTITY kruforum_url '<ulink url="http://www.krusader.org/phpBB/index.php" +>&krusader; Forum</ulink +>'> +<!ENTITY kruforumsearch_url '<ulink url="http://www.krusader.org/phpBB/search.php" +>Search</ulink +>'> +<!ENTITY krugenforum_url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=1" +>General Discussion Forum</ulink +>'> +<!ENTITY newsforum_url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=7" +>News and Announcements Forum</ulink +>'> +<!ENTITY bugforum_url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=3" +>Bug Discussion Forum</ulink +>'> +<!ENTITY featureforum_url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=6" +>New Features Discussion/Requests Forum</ulink +>'> +<!ENTITY todoforum_url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=10" +>ToDo Forum</ulink +>'> +<!ENTITY todoranking_url '<ulink url="http://www.krusader.org/todo.php" +>ToDo ranking system</ulink +>'> +<!ENTITY useractionsforum_url '<ulink url="http://www.krusader.org/phpBB/viewforum.php?f=11" +>UserActions Forum</ulink +>'> +<!ENTITY rss_url '<ulink url="http://krusader.sf.net/phpBB/rss.php" +>here</ulink +>'> +<!ENTITY krucutedge_url '<ulink url="http://www.krusader.org/cvs.php" +>&krusader;'s Cutting Edge page</ulink +>'> +<!ENTITY active_passive_ftp_url '<ulink url="http://slacksite.com/other/ftp.html" +>Active &FTP; vs. Passive &FTP;, a Definitive Explanation</ulink +>'> + +<!ENTITY viewcvs_url '<ulink url="http://krusader.cvs.sourceforge.net/krusader/" +>ViewCVS</ulink +>'> +<!ENTITY sfmirrors_url '<ulink url="http://sourceforge.net/project/showfiles.php?group_id=6488" +>Sourceforge mirrors</ulink +>'> +<!ENTITY changelog_url +'<ulink url="http://www.krusader.org/text.php?t=cvs.changelog" +><filename +>ChangeLog</filename +></ulink +>'> +<!ENTITY cvsnews_url +'<ulink url="http://www.krusader.org/text.php?t=cvs.news" +><filename +>CVSNEWS</filename +></ulink +>'> +<!ENTITY docchangelog_url '<ulink url="http://cvs.sourceforge.net/viewcvs.py/krusader/krusader_kde3/doc/ChangeLog?view=markup" +>Documentation ChangeLog</ulink +>'> +<!ENTITY i18n_page_url '<ulink url="http://www.krusader.org/i18n.php" +>i18n page</ulink +>'> + +<!ENTITY deb_requirements_url '<ulink url="http://packages.debian.org/unstable/utils/krusader" +>requirements on &debian;</ulink +>'> +<!ENTITY mailing_lists_url '<ulink url="http://www.krusader.org/lists.php" +>mailing lists</ulink +>'> +<!ENTITY krunews_url '<ulink url="http://groups-beta.google.com/group/krusader-news" +>&krusader;-news</ulink +>'> +<!ENTITY krulatestnews_url '<ulink url="http://www.krusader.org/news.php" +>latest news</ulink +>'> + +<!ENTITY krucommits_url '<ulink url="http://sourceforge.net/mailarchive/forum.php?forum_id=34772" +>&krusader;-commits</ulink +>'> +<!ENTITY krudevel_url '<ulink url="http://groups-beta.google.com/group/krusader-devel" +>&krusader;-devel</ulink +>'> +<!ENTITY kruusers_url '<ulink url="http://groups-beta.google.com/group/krusader-users" +>&krusader;-users</ulink +>'> +<!ENTITY krudoc_url '<ulink url="http://groups-beta.google.com/group/krusader-doc" +>&krusader;-doc</ulink +>'> +<!ENTITY krui18n_url '<ulink url="http://groups-beta.google.com/group/krusader-i18n" +>&krusader;-i18n</ulink +>'> + +<!ENTITY forumfeed_url '<ulink url="http://www.krusader.org/phpBB/rss.php" +>rss-forumfeed</ulink +>'> +<!ENTITY filereleasefeed_url '<ulink url="http://sourceforge.net/export/rss2_projfiles.php?group_id=6488" +>rss-filerelease feed</ulink +>'> +<!ENTITY krunewsfeed_url '<ulink url="http://groups.google.com/group/krusader-news/feeds" +>krusader-news feed</ulink +>'> +<!ENTITY krudevelfeed_url '<ulink url="http://groups.google.com/group/krusader-devel/feeds" +>krusader-devel feed</ulink +>'> +<!ENTITY kruusersfeed_url '<ulink url="http://groups.google.com/group/krusader-users/feeds" +>krusader-users feed</ulink +>'> +<!ENTITY krui18nfeed_url '<ulink url="http://groups.google.com/group/krusader-i18n/feeds" +>krusader-i18n feed</ulink +>'> +<!ENTITY krudocfeed_url '<ulink url="http://groups.google.com/group/krusader-doc/feeds" +>krusader-doc feed</ulink +>'> + +<!ENTITY online_buglist_url '<ulink url="http://sourceforge.net/tracker/?atid=106488&group_id=6488&func=browse" +>online bug list</ulink +>'> +<!ENTITY i18n_credits_url '<ulink url="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/krusader/krusader_kde3/po/" +>more translator credits</ulink +>'> + + +<!ENTITY subversion_url '<ulink url="http://sourceforge.net/svn/?group_id=6488" +>Subversion</ulink +>'> +<!ENTITY browse_svn_repo_url '<ulink url="http://svn.sourceforge.net/krusader" +>Browse the Subversion Repository</ulink +>'> + +<!ENTITY fhs_url '<ulink url="http://www.pathname.com/fhs/" +>Filesystem Hierarchy Standard (FHS)</ulink +>'> + +<!-- internet links, Krusader binaries --> +<!ENTITY krudownload_url '<ulink url="http://www.krusader.org/down.php" +>&krusader; downloadpage</ulink +>'> +<!ENTITY gentoo_life_ebuild_url '<ulink url="http://www.krusader.org/data/krusader-cvs-1.ebuild" +>&gentoo; Live Ebuild</ulink +>'> + +<!ENTITY gentoo_download_url '<ulink url="http://packages.gentoo.org/search/?sstring=krusader" +>&gentoo;</ulink +>'> +<!ENTITY suse_download_url '<ulink url="http://search.novell.com/qfsearch/SearchServlet?bbshow=true&query0=krusader&operator0=0&collection=Novell&date=&numhits=10&template=ResultListTemplate.html&submit+search=Search" +>&SuSE;</ulink +>'> +<!ENTITY mandriva_download_url '<ulink url="http://search.belnet.be/packages/mandrake/current/i586/media/contrib/" +>&mandriva;</ulink +>'> +<!ENTITY freebsd_download_url '<ulink url="http://www.freebsd.org/cgi/ports.cgi?query=krusader&stype=all" +>&freebsd;</ulink +>'> +<!ENTITY debian_download_url '<ulink url="http://packages.debian.org/krusader" +>&debian;</ulink +>'> +<!ENTITY netbsd_download_url '<ulink url="http://pkgsrc.se/sysutils/krusader" +>&netbsd;</ulink +>'> +<!ENTITY yoper_download_url '<ulink url="http://ftp.belnet.be/linux/yoper/devel/yoper-3.0/RPMS.chris/" +>&yoper;</ulink +>'> +<!ENTITY macosx_download_url '<ulink url="http://www.krusader.org/down.php" +>&MacOS;-X</ulink +>'> +<!ENTITY ubuntu_kubuntu_download_url '<ulink url="http://packages.ubuntu.com/krusader" +>&ubuntu;/&kubuntu;</ulink +>'> +<!ENTITY linspire_download_url '<ulink url="http://www.linspire.com/lindows_products_details.php?product_id=3160&pg=specs" +>&linspire;</ulink +>'> +<!ENTITY archlinux_download_url '<ulink url="http://www.archlinux.org/packages.php?id=793" +>&archlinux;</ulink +>'> +<!ENTITY frugalware_linux_download_url '<ulink url="http://frugalware.org/packages.php?id=280" +>&frugalware_linux;</ulink +>'> +<!ENTITY pclinuxos_download_url '<ulink url="http://www.pclinuxonline.com/pclos/html/package_list.html" +>&pclinuxos;</ulink +>'> +<!ENTITY altlinux_download_url '<ulink url="http://www.altlinux.com/index.php?module=sisyphus&package=krusader" +>&altlinux;</ulink +>'> +<!ENTITY ccuxlinux_download_url '<ulink url="http://packages.ccux-linux.de/index.php?pdetail=154" +>&ccuxlinux;</ulink +>'> +<!ENTITY lunarlinux_download_url '<ulink url="http://modules.lunar-linux.org/index.php?option=module&module=krusader" +>&lunarlinux;</ulink +>'> +<!ENTITY qilinux_download_url '<ulink url="http://www.qilinux.org/modules.php?op=modload&name=distromatic&file=index&tag=devel&pkg=krusader.source" +>&qilinux;</ulink +>'> +<!ENTITY rocklinux_download_url '<ulink url="http://www.rocklinux.net/packages/krusader.html" +>&rocklinux;</ulink +>'> + +<!ENTITY klik_protocol_url '<ulink url="http://klik.atekon.de/" +>klik protocol</ulink +>'> +<!ENTITY klik_krusader_url '<ulink url="klik://krusader" +>klik://krusader</ulink +>'> +<!ENTITY klik_krusader_latest_url '<ulink url="klik://krusader-latest" +>klik://krusader-latest</ulink +>'> +<!ENTITY klik_krusader_cvs_url '<ulink url="klik://krusader-cvs" +>klik://krusader-cvs</ulink +>'> +<!ENTITY klik_available_url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader" +>available</ulink +>'> +<!ENTITY klik_stable_krusader_url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader-latest" +>stable &krusader;</ulink +>'> +<!ENTITY klik_cvs_krusader_url '<ulink url="http://klik.atekon.de/details.php?section=utils&package=krusader-cvs" +>cvs snapshot of &krusader;</ulink +>'> + + +<!ENTITY fedora_extras_url '<ulink url="http://fedoraproject.org/wiki/Extras/UsingExtras " +>&fedora; Extras</ulink +>'> +<!ENTITY distrowatch_com_url '<ulink url="http://distrowatch.com/search.php?pkg=krusader&pkgver=1.70.0" +>Distrowatch.com</ulink +>'> + +<!ENTITY dag_wiers_download_url '<ulink url="http://dag.wieers.com/packages/krusader/" +>dag.wieers.com</ulink +>'> +<!ENTITY dries_verachtert_download_url '<ulink url="http://dries.ulyssis.org/rpm/packages/krusader/info.html" +>Dries Verachtert RPM Repository</ulink +>'> +<!ENTITY portpkg_url '<ulink url="http://portpkg.berlios.de/" +>Portpkg</ulink +>'> +<!ENTITY kru_slackbuild_url '<ulink url="http://cvs.berlios.de/cgi-bin/viewcvs.cgi/portpkg/ports/open/krusader/Attic/" +>&krusader; SlackBuild</ulink +>'> + +<!ENTITY freshmeat_url '<ulink url="http://freshmeat.net/projects/krusader/" +>freshmeat.net</ulink +>'> +<!ENTITY rpmfind_url '<ulink url="http://rpmfind.net/linux/rpm2html/search.php?query=krusader&submit=Search+..." +>rpmfind</ulink +>'> +<!ENTITY rpmpbone_url '<ulink url="http://rpm.pbone.net/index.php3/stat/3/search/krusader" +>rpmpbone</ulink +>'> +<!ENTITY rpmseek_url '<ulink url="http://rpmseek.com/rpm-pl/krusader.html?hl=com&cx=2155:K:0" +>rpmseek</ulink +>'> + +<!ENTITY kde_files_url '<ulink url="http://www.kde-files.org/index.php?xcontentmode=660x661x662x663" +>kde-files.org</ulink +>'> + +<!-- internet links, others --> +<!ENTITY xxdiff_url '<ulink url="http://furius.ca/xxdiff/" +><application +>xxdiff</application +></ulink +>'> +<!ENTITY kdiff3_url '<ulink url="http://kdiff3.sourceforge.net" +><application +>Kdiff3</application +></ulink +>'> +<!ENTITY krename_url '<ulink url="http://www.krename.net" +><application +>Krename</application +></ulink +>'> +<!ENTITY kasablanca_url '<ulink url="http://kasablanca.berlios.de/" +>Kasablanca</ulink +>'> +<!ENTITY kftpgrabber_url '<ulink url="http://kftpgrabber.sourceforge.net/" +><application +>Kftpgrabber</application +></ulink +>'> +<!ENTITY xbel_url '<ulink url="http://grail.sourceforge.net/info/xbel.html" +>XBEL standard</ulink +>'> +<!ENTITY kde_apps_url '<ulink url="http://www.kde-apps.org/content/show.php?content=10214" +>KDE-APPS.org</ulink +>'> +<!ENTITY rpm_org_url '<ulink url="http://www.rpm.org/" +>rpm.org</ulink +>'> +<!ENTITY rpm_guide_url '<ulink url="http://fedora.redhat.com/docs/drafts/rpm-guide-en/" +>RPM Guide</ulink +>'> +<!ENTITY kioslaves1_url '<ulink url="http://docs.kde.org/development/en/kdebase/kioslave/index.html" +>KIOSlaves</ulink +>'> +<!ENTITY kioslaves2_url '<ulink url="http://developer.kde.org/documentation/library/3.4-api/kio/html/index.html" +>KIOSlaves</ulink +>'> +<!ENTITY kio_ipodslave_url '<ulink url="http://sourceforge.net/projects/kpod" +>KIOipod-slave</ulink +>'> +<!ENTITY kdelibs_url '<ulink url="http://lxr.kde.org/source/kdelibs/kioslave" +>&kde;libs</ulink +>'> +<!ENTITY kdebase_url '<ulink url="http://lxr.kde.org/source/kdebase/kioslave" +>&kde;base</ulink +>'> +<!ENTITY gnome_url '<ulink url="http://www.gnome.org" +><application +>GNOME</application +></ulink +>'> +<!ENTITY afterstep_url '<ulink url="http://www.afterstep.org/" +><application +>AfterStep</application +></ulink +>'> +<!ENTITY xfce_url '<ulink url="http://www.xfce.org/" +><application +>XFce</application +></ulink +>'> + +<!ENTITY debian_qt_a_url '<ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=710" +>in our forum</ulink +>'> +<!ENTITY debian_qt_b_url '<ulink url="http://opendoorsoftware.com/cgi/http.pl?p=DebianQTChecklist" +>instructions</ulink +>'> +<!ENTITY freenode_url '<ulink url="http://freenode.net" +>freenode.org</ulink +>'> +<!ENTITY fink_url '<ulink url="http://fink.sourceforge.net" +>fink</ulink +>'> +<!ENTITY kjsembed_url '<ulink url="http://xmelegance.org/kjsembed/" +>KJSEmbed</ulink +>'> + +<!ENTITY ofm_url '<ulink url="http://www.softpanorama.org/OFM/index.shtml" +>Orthodox File Manager (OFM)</ulink +>'> +<!ENTITY disk_order_url '<ulink url="http://www.likemac.ru/english/" +><trademark class="copyright" +>Disk Order</trademark +></ulink +>'> +<!ENTITY apple_x11_url '<ulink url="http://www.apple.com/downloads/macosx/apple/x11formacosx.html" +>&apple; X11</ulink +>'> +<!ENTITY apple_x11_sdk_url '<ulink url="http://developer.apple.com/darwin/runningX11.html" +>&apple; X11 SDK</ulink +>'> +<!ENTITY bodo_tasche_url '<ulink url="http://blog.wannawork.de/about.php" +>Bodo Tasche</ulink +>'> + +<!ENTITY sourceforge_net_url '<ulink url="http://sourceforge.net/" +>Sourceforge.net</ulink +>'> +<!ENTITY openusability_url '<ulink url="http://openusability.org/projects/krusader/" +>OpenUsability.org</ulink +>'> + +<!ENTITY whatsthis_url '<ulink url="http://urbanlizard.com/~aseigo/whatsthis_tutorial/" +>WhatsThis</ulink +>'> + + + +<!-- documentation links --> +<!ENTITY context_menu_lnk '<link linkend="context-menu" +>Context Menu</link +>'> +<!ENTITY vfs_lnk '<link linkend="vfs" +>Virtual file systems (VFS)</link +>'> +<!ENTITY mouse_selection_modes_lnk '<link linkend="mouse_selection_modes" +>Mouse Selection Modes</link +>'> +<!ENTITY konfigstartpg_lnk '<link linkend="konfigurator" +>Konfigurator Startup page</link +>'> +<!ENTITY konfiglookandfeel_lnk '<link linkend="konfig-looknfeel" +>Konfigurator Look & Feel page</link +>'> +<!ENTITY konfiggereral_lnk '<link linkend="konfig-general" +>Konfigurator General page</link +>'> +<!ENTITY konfigdependencie_lnk '<link linkend="konfig-dependencies" +>Konfigurator Dependencie page</link +>'> +<!ENTITY konfigprotocol_lnk '<link linkend="konfig-protocols" +>Konfigurator Protocol page</link +>'> +<!ENTITY viewmenu_lnk '<link linkend="view-menu" +>View menu</link +>'> +<!ENTITY editmenu_lnk '<link linkend="edit-menu" +>Edit menu</link +>'> +<!ENTITY comparedir_lnk '<link linkend="compare-dir" +>Compare Directories</link +>'> +<!ENTITY fnkeybar_lnk '<link linkend="fnkeys" +>FN Keys Bar</link +>'> +<!ENTITY main_toolbar_lnk '<link linkend="mainwindow" +>Main Toolbar</link +>'> +<!ENTITY actions_toolbar_lnk '<link linkend="actions_toolbar" +>Actions Toolbar</link +>'> +<!ENTITY statusbar_lnk '<link linkend="mainwindow" +>Statusbar</link +>'> +<!ENTITY location_toolbar_lnk '<link linkend="list_panel" +>Location Toolbar</link +>'> +<!ENTITY rootmode_lnk '<link linkend="root-mode" +>Root mode</link +>'> +<!ENTITY settingsmenu_lnk '<link linkend="settings-menu" +>Settings menu</link +>'> +<!ENTITY keybindigs_lnk '<link linkend="key_bindings" +>Key-Bindings</link +>'> +<!ENTITY keybindigs_profiles_lnk '<link linkend="configure-shortcuts" +>Key-binding Profiles</link +>'> +<!ENTITY color_profiles_lnk '<link linkend="konfig-color" +>Color Profiles</link +>'> +<!ENTITY synchronizer_lnk '<link linkend="synchronizer" +>Synchronizer</link +>'> +<!ENTITY syncdirs_lnk '<link linkend="synchronizer" +>Synchronize Directories</link +>'> +<!ENTITY splitfile_lnk '<link linkend="splitter" +>Split file</link +>'> +<!ENTITY combinefiles_lnk '<link linkend="splitter" +>Combine files</link +>'> +<!ENTITY kdeqtdir_lnk '<link linkend="kde_qt_dir" +><envar +>KDEDIR</envar +> - <envar +>QTDIR</envar +></link +>'> +<!ENTITY useractions_lnk '<link linkend="useractions" +>UserActions</link +>'> +<!ENTITY usermenu_lnk '<link linkend="useractions" +>User Menu</link +>'> +<!ENTITY faq_lnk '<link linkend="faq" +>FAQ</link +>'> +<!ENTITY forum_lnk '<link linkend="faqg_kru_forum" +>&krusader; Forum</link +>'> +<!ENTITY help_request_lnk '<link linkend="faqi_help_request" +>help request</link +>'> +<!ENTITY list_panel_lnk '<link linkend="list_panel" +>List Panel</link +>'> +<!ENTITY popup_panel_lnk '<link linkend="popup_panel" +>PopUp Panel</link +>'> +<!ENTITY quick_search_lnk '<link linkend="quicksearch" +>Quick search</link +>'> +<!ENTITY locate_lnk '<link linkend="locate" +>Locate</link +> &GUI; frontend'> +<!ENTITY foldertabs_lnk '<link linkend="folder_tabs" +>Folder tabs</link +>'> +<!ENTITY mountman_lnk '<link linkend="mount-man" +>MountMan</link +>'> +<!ENTITY cmdline_lnk '<link linkend="cmdline" +>Command Line</link +>'> +<!ENTITY termemu_lnk '<link linkend="cmdline" +>Terminal emulator</link +>'> +<!ENTITY missing_libs_lnk '<link linkend="faqi_missing_libs" +>&FAQ; missing libs or headers</link +>'> +<!ENTITY panel_profiles_lnk '<link linkend="panel_profiles" +>Panel profiles</link +>'> +<!ENTITY sync_browsing_lnk '<link linkend="panel_toolbar" +>Sync-browsing</link +>'> +<!ENTITY diskusage_lnk '<link linkend="diskusage" +>Disk Usage</link +>'> +<!ENTITY bookmarks_lnk '<link linkend="bookman" +>Bookmarks</link +>'> +<!ENTITY bookmark-manager_lnk '<link linkend="bookman" +>Bookmark-Manager</link +>'> +<!ENTITY advanced_search_module_lnk '<link linkend="krusearcher" +>Advanced Search module</link +>'> +<!ENTITY javascript_console_lnk '<link linkend="javascript_console" +>JavaScript console</link +>'> +<!ENTITY archives_lnk '<link linkend="archives" +>archives</link +>'> +<!ENTITY remote_connections_lnk '<link linkend="remote-connections" +>Remote Connections</link +>'> +<!ENTITY krusaderrc_lnk '<link linkend="config_files" +>krusaderrc</link +>'> + +<!ENTITY install_proc_lnk '<link linkend="installation" +>Installation procedure</link +>'> +<!ENTITY disablenote '<note +><para +>This feature is temporarily disabled and will be rewritten, sorry.</para +></note +>'> +<!ENTITY faqbugreports_lnk '<link linkend="faqg_bug_report" +>bug reports</link +>'> +<!ENTITY hesbugreport_lnk 'Don't hesitate to send <link linkend="faqg_bug_report" +>Bug reports</link +>.'> +<!ENTITY betafeaturenote '<note +><para +>This is a new feature that can be considered as "beta". &hesbugreport_lnk; + <link linkend="faqg_wish" +>User feedback</link +> is always welcome!</para +></note +>'> +<!ENTITY newfeaturenote '<note +><para +>This is a new feature under development. Some descriptions may become obsolete if functionality changes during development. &hesbugreport_lnk; + <link linkend="faqg_wish" +>User feedback</link +> is always welcome!</para +></note +>'> +<!ENTITY rwfeaturenote '<note +><para +>This module was rewritten. Some descriptions may become obsolete if + functionality changes during development. &hesbugreport_lnk; + <link linkend="faqg_wish" +>User feedback</link +> is always welcome!</para +></note +>'> +<!ENTITY krusaderui_rc_text '<para +>If you install a CVS or beta version and if &krusader; was previously + installed on your computer, then you should delete the <filename +>krusaderui.rc</filename +> file + in your home directory to activate the new menu entries + <prompt +>$</prompt +> <userinput +><command +>rm</command +> <option +>~/.kde/share/apps/krusader/krusaderui.rc</option +></userinput> + , click <link linkend="faqi_krusaderui_rc" +>here</link +> for more info.</para +>'> + +<!ENTITY gpl_lnk '<link linkend="credits" +>&GNU; General Public License (GPL)</link +>'> + +<!ENTITY dev_cvs_note '<note +><para> + If you are using a <link linkend="krusader_devel" +>development</link +> or + <link linkend="krusader_cvs" +>CVS</link +> version, it is possible that the latest + new features are not yet in the "The Krusader Handbook". + Please read the &changelog_url; file online or in the &krusader; + sources to find out more about the new features. + For a brief description, please read the &cvsnews_url; file online + or in the &krusader; sources. + <link linkend="faqg_wish" +>User feedback</link +> and + <link linkend="faqg_bug_report" +>Bug reports</link +> are always welcome! + </para +></note +>'> + + +<!-- markup ENTITIES --> +<!ENTITY folder_tabs '<guibutton +>Folder Tabs</guibutton +>'> +<!ENTITY right_click '<keycap +>Right-click</keycap +>'> + + +<!-- application ENTITIES --> +<!ENTITY mc '<application +>Midnight Commander</application +>'> +<!ENTITY xxdiff '<application +>xxdiff</application +>'> +<!ENTITY krename '<application +>Krename</application +>'> +<!ENTITY kget '<application +>kget</application +>'> +<!ENTITY filelight '<application +>Filelight</application +>'> +<!ENTITY kdevelop '<application +>Kdevelop</application +>'> +<!ENTITY keditbookmarks '<application +>KeditBookmarks</application +>'> +<!ENTITY kwallet "<application +>Kwallet</application +>"> + +<!-- (TM) Trademark ENTITIES --> +<!ENTITY fedora '<trademark +>Fedora</trademark +>'> +<!ENTITY yoper '<trademark +>Yoper</trademark +>'> +<!ENTITY openlx '<trademark +>OpenLX</trademark +>'> +<!ENTITY appleipod '<trademark +>Apple ipod</trademark +>'> + +<!-- (R) Registered ENTITIES --> +<!ENTITY freebsd '<trademark class="registered" +>FreeBSD</trademark +>'> +<!ENTITY debian '<trademark class="registered" +>Debian</trademark +>'> +<!ENTITY mandriva '<trademark class="registered" +>Mandriva</trademark +>'> +<!ENTITY gentoo '<trademark class="registered" +>Gentoo</trademark +>'> +<!ENTITY mepis '<trademark class="registered" +>Mepis</trademark +>'> +<!ENTITY ubuntu '<trademark class="registered" +>Ubuntu</trademark +>'> +<!ENTITY kubuntu '<trademark class="registered" +>Kubuntu</trademark +>'> +<!ENTITY linspire '<trademark class="registered" +>Linspire</trademark +>'> +<!ENTITY xandros '<trademark class="registered" +>Xandros</trademark +>'> +<!ENTITY slackware '<trademark class="registered" +>Slackware</trademark +>'> +<!ENTITY arklinux '<trademark class="registered" +>Ark Linux</trademark +>'> +<!ENTITY archlinux '<trademark class="registered" +>Arch Linux</trademark +>'> +<!ENTITY netbsd '<trademark class="registered" +>NetBSD</trademark +>'> +<!ENTITY openbsd '<trademark class="registered" +>OpenBSD</trademark +>'> +<!ENTITY knoppix '<trademark class="registered" +>Knoppix</trademark +>'> +<!ENTITY frugalware_linux '<trademark class="registered" +>Frugalware Linux</trademark +>'> +<!ENTITY pclinuxos '<trademark class="registered" +>PCLinuxOS</trademark +>'> +<!ENTITY altlinux '<trademark class="registered" +>altlinux</trademark +>'> +<!ENTITY sourcemage '<trademark class="registered" +>Source Mage</trademark +>'> +<!ENTITY kanotix '<trademark class="registered" +>Kanotix</trademark +>'> +<!ENTITY lunarlinux '<trademark class="registered" +>Lunar Linux</trademark +>'> +<!ENTITY ccuxlinux '<trademark class="registered" +>CCux Linux</trademark +>'> +<!ENTITY qilinux '<trademark class="registered" +>QiLinux</trademark +>'> +<!ENTITY rocklinux '<trademark class="registered" +>ROCK Linux</trademark +>'> + +<!ENTITY nvidia '<trademark class="registered" +>NVIDIA</trademark +>'> +<!ENTITY nc '<trademark class="registered" +>Norton Commander</trademark +>'> +<!ENTITY openoffice '<trademark class="registered" +>OpenOffice</trademark +>'> +<!ENTITY firefox '<trademark class="registered" +>Firefox</trademark +>'> +<!ENTITY safari '<trademark class="registered" +>Safari</trademark +>'> +<!ENTITY apple '<trademark class="registered" +>Apple</trademark +>'> + +<!-- (C) Copyright ENTITIES --> +<!ENTITY freebsd '<trademark class="copyright" +>FreeBSD</trademark +>'> +<!ENTITY tcmd '<trademark class="copyright" +>Total Commander</trademark +>'> +<!ENTITY tcmd_url '<ulink url="http://www.ghisler.com/" +>&tcmd;</ulink +>'> + +<!-- useraction ENTITIES --> +<!ENTITY useraction_parameter 'Parameter:'> +<!ENTITY useraction_optional_parameter 'Parameter (optional):'> +<!ENTITY useraction_default 'Default:'> + +<!-- chapters in separate docbook files --> + <!ENTITY help SYSTEM "help.docbook"> + <!ENTITY editors-note SYSTEM "editors-note.docbook"> + <!ENTITY introduction SYSTEM "introduction.docbook"> + <!ENTITY features SYSTEM "features.docbook"> + <!ENTITY user-interface SYSTEM "user-interface.docbook"> + <!ENTITY using-krusader SYSTEM "using-krusader.docbook"> + <!ENTITY commands SYSTEM "commands.docbook"> + <!ENTITY keyboard SYSTEM "keyboard.docbook" +> + <!ENTITY mouse SYSTEM "mouse.docbook" +> + <!ENTITY konfigurator SYSTEM "konfigurator.docbook"> + <!ENTITY krusader-tools SYSTEM "krusader-tools.docbook"> + <!ENTITY faq SYSTEM "faq.docbook"> + <!ENTITY credits SYSTEM "credits.docbook"> + <!ENTITY glossary SYSTEM "glossary.docbook"> + +<!-- appendices in separate docbook files --> + <!ENTITY installation SYSTEM "installation.docbook"> + <!ENTITY configuration-files SYSTEM "configuration-files.docbook"> + <!ENTITY useraction-xml SYSTEM "useraction-xml.docbook"> + <!ENTITY release-overview SYSTEM "release-overview.docbook"> + +]> + +<book lang="&language;"> +<bookinfo id="index"> +<title +>Руководство Крусадер</title> + +<authorgroup> + <othercredit role="developer" +><firstname +>Shie</firstname +><surname +>Erlich</surname +> <contrib +>Первый автор Руководства</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </othercredit> + + <othercredit role="developer" +><firstname +>Rafi</firstname +><surname +>Yanai</surname +> <contrib +>Первый автор Руководства</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </othercredit> + + <othercredit role="developer" +><firstname +>Dirk</firstname +><surname +>Eschler</surname +> <contrib +>Вебмастер & координатор локализации</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </othercredit> + + <othercredit role="developer" +><firstname +>Csaba</firstname +><surname +>Karai</surname +> <contrib +>Разработчик</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </othercredit> + + <othercredit role="developer" +><firstname +>Heiner</firstname +><surname +>Eichmann</surname +> <contrib +>Разработчик</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </othercredit> + + <othercredit role="developer" +><firstname +>Jonas</firstname +><surname +>Bähr</surname +> <contrib +>Разработчик</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </othercredit> + + <author +><firstname +>Frank</firstname +> <surname +>Schoolmeesters</surname +> <contrib +>Документация & маркетиновый координатор</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </author> + + <othercredit role="reviewer" +><firstname +>Richard</firstname +><surname +>Holt</surname +> <contrib +>Документация & корректор</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </othercredit> + + <othercredit role="reviewer" +><firstname +>Matej</firstname +><surname +>Urbančič</surname +> <contrib +>Маркетинг & исследования</contrib> + <affiliation +><address +><email +>[email protected]</email +></address +></affiliation> + </othercredit> + +</authorgroup +> + + <copyright> + <year +>2000</year> + <year +>2001</year> + <year +>2002</year> + <year +>2003</year> + <holder +>Rafi Yanai</holder> + <holder +>Shie Erlich</holder> + </copyright> + + <copyright> + <year +>2004</year> + <year +>2005</year> + <year +>2006</year> + <holder +>Krusader Krew</holder> + </copyright> + + <legalnotice +><para +>Разрешается копировать , распространять и/или изменять этот документ согласно с условиями <ulink url="http://www.gnu.org/copyleft/fdl.html" +>GNU Free Documentation License</ulink +> , Версия 1.1 или любая последняя версия , опубликованная Фондом свободного программного обеспечения .Копия лицензии включена в исходные коды &krusader;.</para +></legalnotice> + + <date +>2006-08-26</date> + <releaseinfo +>1.80.0 "cvs repository"</releaseinfo> + + <abstract> + <para +>&krusader; - это продвинутый , двухпанельный файловый менеджер для КДЕ и других деcктопов в мире *nix</para> + </abstract> + + <keywordset> + <keyword +>КДЕ</keyword> + <keyword +>крусадер</keyword> + <keyword +>КДЕ</keyword> + <keyword +>менеджер</keyword> + <keyword +>файловый менеждер</keyword> + <keyword +>двухпанельный</keyword> + <keyword +>файловый</keyword> + <keyword +>manager</keyword> + <keyword +>двух-панельный</keyword> + <keyword +>менеджер для линукс</keyword> + <keyword +>менеджер для КДЕ</keyword> + </keywordset> + +</bookinfo> + +<!-- preface --> + &help; + &editors-note; + +<!-- chapters --> + &introduction; + &features; + &user-interface; + &using-krusader; + &commands; + &keyboard; + &mouse; + &krusader-tools; + &konfigurator; + &faq; + &credits; + +<!-- appendices --> + &installation; + &configuration-files; + &useraction-xml; + &release-overview; + +<!-- glossary --> + &glossary; + +<!-- index (automagically generated) --> + &documentation.index; + +</book> + diff --git a/doc/ru/installation.docbook b/doc/ru/installation.docbook new file mode 100644 index 0000000..462446c --- /dev/null +++ b/doc/ru/installation.docbook @@ -0,0 +1,1170 @@ +<appendix id = "installation"> + +<!-- ********************************************************************** + installation.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Installation</title> + +<sect1 id="requirements"> +<title +>Requirements</title> + +<para +>In order to successfully use the most recent &krusader;, you need &kde;libs >= 3.4</para> + +<para +>Required &kde; version: <itemizedlist> + <listitem +><para +>&krusader; v1.01: &kde; 2</para> + </listitem> + <listitem +><para +>&krusader; v1.02 - 1.40: &kde; 3.0 - &kde; 3.2</para> + </listitem> + <listitem +><para +>&krusader; 1.40: prefers &kde; 3.2 (otherwise not all features will be available)</para> + </listitem> + <listitem +><para +>&krusader; v1.50 - v1.51: &kde; 3.2 - &kde; 3.3 (Konfigurator crash on &kde; 3.4)</para> + </listitem> + <listitem +><para +>&krusader; v1.60.0 - v1.70.0: &kde; 3.3 - &kde; 3.5</para> + </listitem> + <listitem +><para +>&krusader; 1.70.0: prefers &kde; >= 3.4 (otherwise not all features will be available)</para> + </listitem> + <listitem +><para +>&krusader; v2.xx.x: &kde; 4 - &Qt; 4 The big challenge, maybe a first release in 2006 ;)</para> + </listitem> +</itemizedlist> +</para> + +<para +>Platforms: <itemizedlist> + <listitem +><para +>All POSIX (&Linux;/BSD/&UNIX;-like OSes), &Solaris;.</para +></listitem> + <listitem +><para +>All BSD Platforms (&freebsd;/&netbsd;/&openbsd;/&MacOS;).</para +></listitem> + </itemizedlist> +</para> + +<para +>&krusader; uses about 3-4 MByte of memory to run (and about 15 Mbyte shared memory which is also used by other processes), but this may vary depending on your platform and configuration. In order to handle archives the archivers must be configured <link linkend="konfig-dependencies" +>here</link +>.</para> + +<para +>A package of popular (un)packers, &krusader; itself and addons can be found on the &krudownload_url;.</para> + +<para +>For more requirements, continue to read this chapter and read also the &faq_lnk; section.</para> + +</sect1> + + +<sect1 id = "getting-krusader"> +<title +>How to obtain &krusader;</title> + +<para +>The latest information about &krusader; can be found on the &kruwebsite_url; .</para> + +<sect2 id="krusader_download"> +<title +>Download &krusader;</title> + +<para +>It's recommend to use the &krusader; package that is provided by your distribution, &distrowatch_com_url; is a great resource to check the availability. If your distribution does not offer &krusader; please contact the creators of your distribution and ask them to provide a &krusader; package, thanks!</para> + +<para +>The latest version (and older versions) can be found on the &krudownload_url; and on the &sfmirrors_url;. It contains the source tarballs, RPM and DEB packages to whatever distro the &krusader;-Krew is using and packages build by third-parties and &krusader; users.</para> + +<para +>Distributions who provide &krusader;: <itemizedlist +> <listitem +> <para +>&suse_download_url; +>= 9.3, Note: please use &krusader;-1.60.0 and not &krusader;-1.51 (might be instable on &SuSE;9.3-&kde;3.4)</para +> </listitem +> <listitem +> <para +>&fedora; via &fedora_extras_url; <command +># yum install krusader</command +> will do the job, thanks to Marcin Garski. &RedHat; RPM packages can usually found on the &krudownload_url; or at &dag_wiers_download_url; and &dries_verachtert_download_url; .</para +> </listitem +> <listitem +> <para +>&debian_download_url;, on our &krudownload_url; you might find more recent "unofficial bleeding-edge" DEB packages. Note: usually &debian; packages work also on distributions who are "based on &debian;", some of these provide their own (incompatible) packages. &ubuntu_kubuntu_download_url;, &linspire_download_url;, &knoppix; 4.x DVD, &kanotix;, ...</para +> </listitem +> <listitem +> <para +>&mandriva_download_url; via the contrib repository <command +># urpmi krusader</command +> will do the job, &gentoo_download_url;, &yoper_download_url;</para +> </listitem +> <listitem +> <para +>&archlinux_download_url;, &frugalware_linux_download_url;, &pclinuxos_download_url;, &altlinux_download_url;</para +> </listitem +> <listitem +> <para +>&freebsd_download_url;, the port is maintained by <link linkend="credits" +>Heiner Eichmann</link +> .</para +> </listitem +> <listitem +> <para +>&netbsd_download_url;, &lunarlinux_download_url; ,&arklinux;, &openlx;, &sourcemage;.</para +> </listitem +> <listitem +> <para +>Even more distributions can be found with &distrowatch_com_url;</para +> </listitem +> </itemizedlist +> Use the installation tools that your distro uses to install the &krusader; package, sometimes an internet connection is needed if &krusader; is not available on the &CD; or DVD. There are probably more distributions out there who include &krusader;, sorry we can't mention you all, though feedback is always welcome to improve this distrolist. </para> + +<para +>Others <itemizedlist> + <listitem> + <para +>&slackware; tgz binaries can usually found on the &krudownload_url;, or use &portpkg_url; that contains a &kru_slackbuild_url;, <command +># portpkg krusader</command +> will do the job.</para> + </listitem> + <listitem> + <para +>There is a &macosx_download_url; port with the help of &fink_url; , the port is maintained by &bodo_tasche_url; .</para> + </listitem> +</itemizedlist> +</para> + +<para +>Installation via the &klik_protocol_url; . <itemizedlist> + <listitem> + <para +>&klik_krusader_url; downloads &krusader; provided by &debian; stable, more information is &klik_available_url; .</para> + </listitem> + <listitem> + <para +>&klik_krusader_latest_url; downloads the latest &klik_stable_krusader_url; provided by the &krusader; Krew.</para> + </listitem> + <listitem> + <para +>&klik_krusader_cvs_url; downloads a &klik_cvs_krusader_url; provided by the &krusader; Krew.</para> + </listitem> +</itemizedlist> +</para> + + + + +<para +>Search engines <itemizedlist +> <listitem +> <para +>You can also find packages on &Linux; software archives such as &freshmeat_url; or &kde_apps_url; .</para +> </listitem +> <listitem +> <para +>If you can't find a package for your distribution, we recommend searching for it with &rpmfind_url; , &rpmpbone_url; or &rpmseek_url; .</para +> </listitem +> </itemizedlist +> If you like &krusader; go to one of these sites and rate &krusader;, thanks. </para> + + +<para +>If you still can't find a package, please don't worry. We provide a very detailed installation procedure. This very thorough HowTo shows even newcomers how to compile &krusader; from source, even if you've never compiled a program from source. Please continue to read this chapter ;)</para> + +</sect2> + +<sect2 id="version_scheme"> +<title +>Version scheme</title> +<para +>We use a new version scheme since &krusader;-1.60.0 <itemizedlist +> <listitem +><para +>First digit - the major version </para +></listitem +> <listitem +><para +>Second digit(s) - percentage of features completed for this major version </para +></listitem +> <listitem +><para +>third digit(s) - bugfixes. </para +></listitem +> </itemizedlist +> So in essence, releasing &krusader;-1.60.0, means that we believe that &krusader; is about 60% done with all the features we'd schedule for the 1.x.x series. Series 2.x.x will be &kde; 4.x releases. We hope it'd be easy to understand. </para> +</sect2> + +<sect2 id="krusader_stable"> +<title +>Stable version</title> +<para +><filename +>krusader-x.xx.tar.gz</filename +></para> +<note +><para +>&krusader; is released under the &gpl_lnk;, this means that THE PROGRAM IS PROVIDED "AS IS" WITH NO WARRANTY OF ANY KIND, even when it is marked as a stable release.</para +></note> +</sect2> + + +<sect2 id="krusader_devel"> +<title +>Development version (beta release)</title> +<para +><filename +>krusader-x.xx-betax.tar.gz</filename +></para> +<para +>Before every stable release we release at least one development version, so that we can hunt down the bugs.</para> + +<warning +><para +>These releases are beta releases and will probably contain some bugs.</para +></warning +> &dev_cvs_note; <para +>The beta release has 3 goals: <itemizedlist> + <listitem> + <para +>Apply a feature-freeze until the stable is released, only bugs will be fixed. New features have to wait until the stable is released.</para> + </listitem> + <listitem> + <para +>Obtain feedback from &krusader; users so that we can fix the bugs.</para> + </listitem> + <listitem> + <para +>Give translators the time to update the translations, for the coming stable. Please read the &i18n_page_url;</para> + </listitem> + </itemizedlist> +</para> + +</sect2> + + +<sect2 id="krusader_cvs"> +<title +>CVS builds</title> +<para +><filename +>krusader-cvs-yyyymmdd.tar.gz</filename +></para> + +<warning +><para +>These builds are untested and come without any warranty. They may contain bugfixes, new features or new bugs!</para +></warning> + +<para +>We provide daily snapshots of &krusader;'s CVS version. For those who are interested, the <emphasis role="bold" +>nightly tarball</emphasis +> can be found on the &krucutedge_url;. Depending on the stage of development, this version will either be stable or unstable. Just before a stable release, the CVS version is almost stable. After a stable release new features will be committed into CVS, which might lead to the appearance of bugs. In some rare cases, the build will even not compile if we make a mistake, in that case we try to fix the mistake as soon as possible.</para> + +<para +>&krusader; provides 2 nightly snapshots: <orderedlist numeration="arabic"> + <listitem> + <para +><filename +>krusader-cvs-yyyymmdd.tar.gz</filename +>: <command +>make -f Makefile.cvs</command +> must be run before the <command +>./configure</command +> script is available</para> + </listitem> + <listitem> + <para +><filename +>krusader-cvs2-yyyymmdd.tar.gz</filename +>: for users who have problems with the <command +>make -f Makefile.cvs</command +> command, we have already done this for you and the <command +>./configure</command +> script is included in the tarball (This tarball is a bit bigger then the first one). </para> + </listitem> + </orderedlist> +</para> + +<para +><emphasis role="bold" +>Checkout from CVS</emphasis +>. &krusader; can be checked out through anonymous (pserver) CVS with the following instruction set. The module you wish to check out must be specified as the modulename. When prompted for a password for anonymous, simply press the &Enter; key.</para> + <para +>Currently, there are two module options: <itemizedlist> + <listitem +><para +>krusader_kde2: the &kde;2 branch, stable but it's basically v1.01 and there are no planned changes</para +></listitem> + <listitem +><para +>krusader_kde3: the &kde;3 branch, that we currently use</para +></listitem> + </itemizedlist +></para> + +<para +>To checkout &krusader; from CVS: <screen +><prompt>$</prompt> <userinput><command>cvs</command> <option>-d:pserver:[email protected]:/cvsroot/krusader login</option></userinput></screen +> <screen +><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[email protected]:/cvsroot/krusader co krusader_kde3</option></userinput></screen +> (note: updates from within the modules directory do not need the -d parameter)</para> + +<para +>If you want to checkout a specific version of &krusader; from CVS (⪚ &krusader;-1.60.0) : <screen +><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[email protected]:/cvsroot/krusader co -rversion_1_60_0 krusader_kde3</option></userinput></screen> +</para> + +<para +>If you want to checkout a specific date of &krusader; from CVS (⪚ &krusader;-2005-05-23) : <screen +><prompt>$</prompt> <userinput><command>cvs</command> <option>-z3 -d:pserver:[email protected]:/cvsroot/krusader co -D2005-05-23 krusader_kde3</option></userinput></screen> +</para> + +<para +>Mostly being &gentoo; users, we provide a &gentoo_life_ebuild_url; for all those who want to stay on the bleeding edge of filemanagement and don't want to miss the advantages of portage. Please take a look at our &krucutedge_url; for more installation details.</para> + +<para +>We also provide &viewcvs_url; to browse the CVS repository.</para> + +</sect2> + + +<sect2 id="krusader_svn"> +<title +>Subversion</title> +<para +>&subversion_url; will probably used for the &krusader; 2.x series for &kde;4. It's also possible to &browse_svn_repo_url;.</para> + +<para +>To checkout the latest &krusader; 1.x for &kde; 3 from SVN: (NOTE: at moment of writing it's recommend to use CVS for krusader_kde3, since krusader_kde3 is developed in CVS and not in SVN) <screen +><prompt>$</prompt> <userinput><command>svn</command> <option>co https://svn.sourceforge.net/svnroot/krusader/trunk/krusader_kde3</option></userinput></screen +> To checkout the latest &krusader; 2.x for &kde; 4 from SVN: (NOTE: not yet available at moment of writing) <screen +><prompt>$</prompt> <userinput><command>svn</command> <option>co https://svn.sourceforge.net/svnroot/krusader/trunk/krusader_kde4</option></userinput></screen> + </para> + +</sect2> + +<sect2 id="krusader_old"> +<title +>Older releases</title> +<para +>Looking for older releases? Try the &sfmirrors_url; available from our project page.</para> +</sect2> + +</sect1> + + +<sect1 id="compilation"> +<title +>Compilation and installation</title> + +<sect2 id="sourcedownload"> +<title +>I have downloaded the sources for &krusader;. What now?</title> + +<para +>Check the environment variables &kdeqtdir_lnk;.</para> + +<para +>In order to compile and install &krusader; on your system, type the following in the base directory of the &krusader; package:</para> + +<screen +><prompt>$</prompt> <userinput><command>./configure</command></userinput> +<prompt>$</prompt> <userinput><command>make</command></userinput> +<prompt>$</prompt> <userinput><command>su -c 'make</command> <option>install'</option></userinput></screen> +&krusaderui_rc_text; <para +>Since &krusader; uses <command +>autoconf</command +> and <command +>automake</command +> you should have no trouble compiling it. Should you run into problems please read the detailed installation instructions below.</para> + +</sect2> + + +<sect2 id="install_tutorial"> +<title +>Installation Tutorial</title> + +<para +>The next section will explain step by step, in detail, how to install &krusader;. This question has been asked many times and especially users new to &Linux; often have problems compiling software from source. Therefore, we are trying to keep the explanations as detailed as possible even if they are mostly not &krusader; specific. Experienced users may easily skip most of the steps.</para> + +<para +>Because not all &Linux; distributions do follow the &fhs_url; it's unfortunately impossible to write a tutorial that always works in all circumstances, but with these guidelines will be a big help in the right direction.</para> + +<note +><para +>If you encounter problems, please read first this installation procedure and the &faq_lnk;, if this does not solve your problem then feel free to ask for help with an &help_request_lnk;. </para +></note> + + +<orderedlist> +<listitem> + <para +>Install all needed packages and libraries that you need for the compilation, please read the &faq_lnk;. <tip +><para +>If you install &kdevelop; then (almost) everything that you need to compile &krusader; will be installed on your computer, BUT please don't use &kdevelop; to compile &krusader; if you are not a developer (possible automake hell), just follow the next instructions.</para +></tip> + </para> + <!-- Empty line to make it more readable --> +</listitem> + +<listitem> + <para +>Open your favourite terminal emulator (⪚ &konsole;).</para> + <!-- Empty line to make it more readable --> +</listitem> + + +<listitem> +<para +>We recommend you create a separate directory to keep all the sources you compile in. This will give you a better overview of installed programs and makes it easier to uninstall them later. <screen +><prompt>$</prompt> <userinput><command>mkdir</command> ~/source</userinput></screen +> The chosen directory is just an example, any other will work.</para> + <!-- Empty line to make it more readable --> + <!-- Empty line to make it more readable (second line is needed) --> +</listitem> + + +<listitem> + <para +>Copy the sources to the <filename +>~/source</filename +> directory and unpack them. <screen +><prompt>$</prompt> <userinput><command>cp</command> /<replaceable>"your_dir"</replaceable>/krusader-x.xx.tar.gz ~/source</userinput></screen> + <screen +><prompt>$</prompt> <userinput><command>cd</command> ~/source</userinput></screen> + <screen +><prompt>$</prompt> <userinput><command>tar</command> <option>-xzvf</option> krusader-x.xx.tar.gz</userinput></screen +></para> + <!-- Empty line to make it more readable --> +</listitem> + + +<listitem> +<para +>Optional step: the tarball is no longer needed at this point, you can delete it if you want or you can keep it if you like. <screen +><prompt>$</prompt> <userinput><command>rm</command> krusader-x.xx.tar.gz</userinput></screen +></para> + <!-- Empty line to make it more readable --> +</listitem> + + +<listitem> + <para +>Change to the directory containing the sources. <screen +><prompt>$</prompt> <userinput><command>cd</command> krusader-x.xx</userinput></screen +></para> + <!-- Empty line to make it more readable --> +</listitem> + + +<listitem id="kde_qt_dir"> +<para +>Check the environment variables <envar +>QTDIR</envar +> and <envar +>KDEDIR</envar +>. &krusader;'s <command +>./configure</command +> script needs to know where the &Qt; and &kde; directories are. </para> + +<para +><envar +>QTDIR</envar +> : <replaceable +><path to your Qt installation></replaceable +> ⪚ <filename +>/usr/lib/qt3</filename +> or <filename +>/usr/qt3</filename +></para> + +<para +><envar +>KDEDIR</envar +> : <replaceable +><path to your KDE installation></replaceable +> ⪚ <filename +>/usr</filename +> or <filename +>/opt/kde3</filename +></para> + +<para +>Normally your distribution will set them for you, but experience has shown that some don't. You can easily check the values with the <command +>echo</command +> command. <screen +><prompt>$</prompt> <userinput><command>echo</command> $QTDIR</userinput> +/usr/lib/qt3 +<prompt>$</prompt> <userinput><command>echo</command> $KDEDIR</userinput> +/usr</screen +> If both commands give an output, the enviroment variables are set (the above example are the settings of &mandriva;-&Linux;). In case you just receive empty lines, the variables are not set and you have to set them it manually. If you have no idea what to set the variables to, or if you want to check if the variables are correctly set, ask your distributor or use the <command +>find</command +> command. <screen +><prompt>$</prompt> <userinput><command>find</command> <option>/usr /opt -name</option> qtconfig <option>-type f 2>/dev/null</option></userinput> +/usr/lib/qt3/bin/qtconfig +<prompt>$</prompt> <userinput><command>find</command> <option>/usr /opt -name</option> kdeinit <option>-type f 2>/dev/null</option></userinput> +/usr/bin/kdeinit</screen +> In this case <filename +>/usr/lib/qt3</filename +> is your <envar +>QTDIR</envar +> and <filename +>/usr</filename +> is your <envar +>KDEDIR</envar +>. The installed binaries will go to <filename +>/usr/bin</filename +>. Now we will set the enviroment variables with the <command +>export</command +> command. <screen +><prompt>$</prompt> <userinput><command>export</command> QTDIR=<replaceable><replace with your QTDIR></replaceable></userinput></screen> +<screen +><prompt>$</prompt> <userinput><command>export</command> KDEDIR=<replaceable><replace with your KDEDIR></replaceable></userinput></screen> +</para> + + <note +><para +>These enviroment variables are only set for the lifetime of your current shell. When you close your terminal and open a new one they will be gone. Assuming &krusader; is not the only &Qt;/&kde; program you want to compile, we recommend to make these settings permanent (⪚ append both export commands to your <filename class="directory" +>/etc/profile</filename +>) file.</para +></note> + +<para +>If you can't determine your KDEDIR than <command +>kde-config --prefix</command +> might help you.</para> + + <!-- Empty line to make it more readable --> + <!-- Empty line to make it more readable (second line is needed) --> + +</listitem> + + + +<listitem> + <para +>If you have downloaded a stable version <filename +>"krusader-x.xx.tar.gz"</filename +> or a beta version <filename +>"krusader-x.xx-betax.tar.gz"</filename +>, you can skip this step, in this case the <filename +>./configure</filename +> script is provided.</para> + + <para +>If you have downloaded a CVS build or nightly tarball <filename +>"krusader-cvs-yyyy-mm-dd.tar.gz"</filename +>", you will have to run the following command to create the <filename +>./configure</filename +> script: <screen +><prompt>$</prompt> <userinput><command>make</command> <option>-f</option> Makefile.cvs</userinput></screen +></para> + + <para +>If everything is OK you will see the following output on your screen: <screen +><prompt>$</prompt> <userinput><command>make</command> <option>-f</option> Makefile.cvs</userinput> +This Makefile is only for the CVS repository +This will be deleted before making the distribution +*** Creating acinclude.m4 +*** Creating list of subdirectories +*** Creating configure.in +*** Creating aclocal.m4 +*** Creating configure +*** Creating config.h template +*** Creating Makefile templates +*** Postprocessing Makefile templates +*** Creating date/time stamp +*** Finished +Don't forget to run ./configure +If you haven't done so in a while, run ./configure --help +<prompt>$</prompt></screen> +</para> + + <note +><para +>You will need to have: <application +>autoconf 2.52, 2.53 or 2.54</application +> and <application +>automake 1.6</application +> (or higher) to run the <command +>make -f Makefile.cvs</command +> command</para +></note> + + <tip +><para +>If you encounter problems with this command click <link linkend="krusader_cvs" +>here</link +>. &krusader; provides 2 nightly builds (snapshots) one with a <filename +>./configure</filename +> script and one without.</para +></tip> + + <!-- Empty line to make it more readable --> + <!-- Empty line to make it more readable (second line is needed) --> +</listitem> + + +<listitem> + <para +>Your &Linux; distro &krusader; RPM or DEB package will usually install &krusader; in the <filename +>KDEDIR/bin</filename +> directory. According to the &fhs_url;, any user installed files should go to the <filename +>/usr/local</filename +> directory, but in some cases you might want that &krusader; will be installed in an other directory, this behaviour can be determed with the prefix option. If you don't have root access <filename +>/home/YOUR_USERNAME/.kde</filename +> is probably a good choice. <screen +><prompt>$</prompt> <userinput><command>./configure</command> <option>--prefix=/usr/local</option></userinput></screen +></para> + + <para +>This will take about 1 minute, if everything goes well it will ⪚ end with the following messages: </para> + +<para> + +<screen +>foo + +Krusader Project: +----------------- +Source code location: . +C Compiler: gcc +C Compiler flags: -ansi -W -Wall -pedantic -Wchar-subscripts -Wshadow -Wpointer-arith +-Wmissing-prototypes -Wwrite-strings -D_XOPEN_SOURCE=500 -D_BSD_SOURCE -O2 +-Wformat-security -Wmissing-format-attribute +C++ Compiler: g++ +prefix: /usr/local +kde_libraries: /usr/include +kde_includes: /usr/lib +kde_locale: /usr/share/locale +qt_libraries: /usr/lib/qt3/lib +qt_includes: /usr/lib/qt3/include +KDEDIR: /usr +QTDIR: /usr/lib/qt3 +Install path: /usr/local/bin +krusader version: 1.51 +krusader binary: /usr/local/bin/krusader (after 'make install') +Thank you for using Krusader + +Good - your configure finished. Start make now +<prompt>bash$</prompt> +</screen> +</para> + +<para +>This is the output for &Mandrake;-&Linux; 10, other distributions may give a different output.</para> + +<tip +><para +>At the end of the <command +>./configure</command +> script you will find a summary of the most important settings, ⪚ where the &krusader; binary will be installed (after the 'make install' command). This part will also display a warning if the environment variables &kdeqtdir_lnk; are empty. </para +></tip> + + <!-- Empty line to make it more readable --> + +<para +>Since &krusader;-1.70.0 <command +>./configure</command +> has two specific &krusader; options: <itemizedlist +> <listitem +> <para +><userinput +><command +>./configure</command +> <option +>--without-konqueror</option +></userinput +>: build Krusader without support &konqueror;'s servicemenus, default=with. This means that &konqueror;'s right-click menu entries will not be available.</para +> </listitem +> <listitem +> <para +><userinput +><command +>./configure</command +> <option +>--without-javascript</option +></userinput +>: build Krusader without JavaScript support, default=with. This means that the &javascript_console_lnk; will not be available.</para +> </listitem +> </itemizedlist +> In the past the support was always compiled in when the headers where found, now you have the choice. </para> + +<para +>Use <userinput +><command +>./configure</command +> <option +>--help</option +></userinput +> to see more options or read the <filename +>INSTALL</filename +> file in the &krusader; sources.</para> + +<para +>If you dit use the an other --prefix= than <filename +>$KDEDIR or /usr/local</filename +> , then it can't hurt to do an extra check: <screen +><prompt>$</prompt> <userinput><command>kde-config</command> <option>--path exe</option></userinput> +/home/frank/.kde/bin/:/usr/bin/:/usr/local/bin/ +<prompt>$</prompt></screen +> If the <prefix_dir/bin> directory is not shown, you need to use e.g. <command +>export KDEDIRS=/usr/local:/usr</command +>. To make these settings permanent you can ⪚ append this export command to your <filename +>/etc/profile</filename +> file. Than you need to restart &kde;, and check again. </para> + + + <note +><para +>If <command +>./configure</command +> fails, take a look at &missing_libs_lnk;.</para +></note> + + <!-- Empty line to make it more readable --> +</listitem> + + + +<listitem> + <para +>Start the compilation process with the <command +>make</command +> command. <screen +><prompt>$</prompt> <userinput><command>make</command></userinput></screen +> This will take about 10 to 40 minutes, if everything goes well it will ⪚ end with the following messages: <screen +>foo +make[2]: Leaving directory `/home/source/krusader_kde3/tar' +make[2]: Entering directory `/home/source/krusader_kde3' +make[2]: Leaving directory `/home/source/krusader_kde3' +make[1]: Leaving directory `/home/source/krusader_kde3' +<prompt>bash$</prompt> +</screen> +</para> + + <!-- Empty line to make it more readable --> + + <para +>If <command +>./configure</command +> was successful and <command +>make</command +> failed for some reason, continue to read this page. If you can't find any solution for your problem then feel free to post a help request at our &forum_lnk;.</para> + + <!-- Empty line to make it more readable --> +</listitem> + + +<listitem> + <para +>If nothing went wrong, you can now install &krusader;. <screen +><prompt>$</prompt> <userinput><command>su -c 'make</command> <option>install'</option></userinput></screen +> You will be asked to enter your root password.</para> + + <!-- Empty line to make it more readable --> + <!-- Empty line to make it more readable (second line is needed) --> +</listitem> + + +<listitem +>&krusaderui_rc_text; <para +></para +> <!-- Empty line to make it more readable --> +</listitem> + +<listitem> + <para +>Now you can <link linkend="starting-krusader" +>start</link +> &krusader;.</para> + <para +></para +> <!-- Empty line to make it more readable --> +</listitem> + + + +<listitem> + <para +>Optional step: if you want you can clean up to save some diskspace. Note: in this case all the compiled files created with the <command +>make</command +> command will be deleted. <screen +><prompt>$</prompt> <userinput><command>make</command> <option>clean</option></userinput></screen> + </para> + + <!-- Empty line to make it more readable --> + <!-- Empty line to make it more readable (second line is needed) --> +</listitem> + + +<listitem> + <para +>If you ever want to uninstall &krusader;, just use <screen +><prompt>$</prompt> <userinput><command>su -c 'make</command> <option>uninstall'</option></userinput></screen +> You will be asked to enter your root password.</para> + + <para +></para +> <!-- Empty line to make it more readable --> +</listitem> + +</orderedlist> + + +<para +>If you encounter problems with installing &krusader; please read first the &faq_lnk;. If this installation procedure and the FAQ does not solve the problem, feel free to ask for help with an &help_request_lnk;.</para> + +</sect2> + + +</sect1> + + + +<sect1 id="mac-port"> +<title +>&MacOS;-x port</title> + +<para +>Krusader is ported to &MacOS; thanks to Jonas Bähr and &bodo_tasche_url; . Unfortunately the only *stable* kdelib-binaries which &fink_url; has to offer is currenly 3.1.4 which means you need to use &krusader;-1.40 . Unfortunately the &MacOS; X &krusader; port doesn't have the same power as in a native &Linux;-&kde; environement. To run &krusader; you need also X11 which doesn't realy interact with the rest of the &MacOS; desktop (drag and drop, etc...) We hope that &Qt;4/&kde;4 will solve most of these problems. When you want a higher Krusader version than you need to compile &kde; , what is not so difficult with &fink_url; but it takes some CPU cycles. </para> + + +<para +>Installation Instructions for &krusader;-1.40 <orderedlist> + + <listitem> + <para +>Download and install &fink_url; with the &kde;3.1 binaries provided by fink and read the documentation.</para> + </listitem> + + <listitem> + <para +>Extract the <filename +>krusader-1.40.fink.darwin-ppc.tar.bz2</filename +> package to <filename +>/sw/fink/dist/local/main/</filename +> Only root can write here, you may have to create 'local' and 'main' </para> + </listitem> + + <listitem> + <para +>Run as root: <command +>fink install krusader</command +></para> + </listitem> + +</orderedlist> +</para> + + +<para +>If you like to compile more sourcecode or if you want to use a more recent &krusader; version then these are the installation instructions. <orderedlist> + + <listitem> + <para +>install &apple_x11_url;</para> + </listitem> + + <listitem> + <para +>install the &apple_x11_sdk_url; developer-tools with X11 headers (gcc is included)</para> + </listitem> + + <listitem> + <para +>install the fink-base</para> + </listitem> + + <listitem> + <para +>compile kdelibs 3.4.1 or higher (fink provides the necessary <filename +>.info</filename +> files)</para> + </listitem> + + <listitem> + <para +>compile the &krusader;-tarball or follow steps 2 and 3 of the previous section if a recent &krusader;-package ⪚ <filename +>krusader-1.60.0.fink.darwin-ppc.tar.bz2</filename +> is available</para> + </listitem> + + </orderedlist> +</para> + +</sect1> + + +<sect1 id="starting-krusader"> +<title +>Starting &krusader;</title> + +<para +>Type <userinput +><command +>krusader</command +></userinput +> (lower case) at a command prompt. You can create shortcut on your desktop or create an entry in the (&kde;) menu. Read the previous page and the &faq_lnk; if &krusader; doesn't start.</para> + +<para +>When &krusader; is started from the command-line, various options can be specified to modify its behavior.</para> + + +<screen +><prompt>$</prompt> <userinput><command>krusader</command></userinput> +WARNING: Mt.Man: Born, looking around to get familiar. +foo</screen> + + +<note +><para +>Don't worry about the messages you get in the &konsole;. These messages are log messages that can be used for debugging &krusader;.</para +></note> + +<para +>You can also use <keycombo action="simul" +>&Alt;<keycap +>F2</keycap +></keycombo +> to open the Run Command dialog box, type <userinput +><command +>krusader</command +></userinput +> (lower case) and press &Enter; or click on the <guibutton +>Run</guibutton +> button.</para> + +<para +>If &krusader; is installed by an RPM or DEB package then usually &krusader; can be started from the &kmenu;. ⪚ on &Mandrake;-&Linux; 10.0 click on the &kicon; button and choose <emphasis role="bold" +><menuchoice +><guimenuitem +>Applications</guimenuitem +><guimenuitem +>File tools</guimenuitem +> <guimenuitem +>&krusader;</guimenuitem +></menuchoice +></emphasis +>.</para> + + + +<variablelist +><title +>Command-line options:</title> + <varlistentry> + <term +><option +>--left</option +> <replaceable +><path></replaceable +></term> + <listitem +><para +><action +>start left panel at <path></action +></para +></listitem> + </varlistentry> + + <varlistentry> + <term +><option +>--right</option +> <replaceable +><path></replaceable +></term> + <listitem +><para +><action +>start right panel at <path></action +></para +></listitem> + </varlistentry> + + <varlistentry> + <term +><option +>--left</option +> <replaceable +><path1>,<path2>,<path3></replaceable +></term> + <listitem +><para +><action +>start left panel at <path1>,<path2>,<path3>, with tabs.</action +></para +></listitem> + </varlistentry> + + <varlistentry> + <term +><option +>--profile</option +> <replaceable +><panel-profile></replaceable +></term> + <listitem +><para +><action +>load a <link linkend="panel_profiles" +>panel-profile</link +> on startup (this overrides the <link linkend="konfig-startup" +>default startup profile</link +>). </action +></para +></listitem> + </varlistentry> + +</variablelist> + + +<para +>Examples: <screen +><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=<path> --right=<path></replaceable></userinput></screen> +<screen +><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=/mnt/cdrom --right=ftp://[email protected]</replaceable></userinput></screen> +<screen +><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--left=<path1>,<path2> --right=<path1>,<path2>,<path3></replaceable></userinput></screen> +<screen +><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--profile <panel-profile></replaceable></userinput></screen> +<screen +><prompt>$</prompt> <userinput><command>krusader</command> <replaceable>--profile ftp-managment</replaceable></userinput></screen> +</para> + +<para +>The standard &Qt; and &kde; command-line options are available, and can be listed by entering <userinput +><command +>krusader</command +> <option +>--help</option +></userinput +> .</para> + +<variablelist +><title +>Other command-line options:</title> + <varlistentry> + <term +><option +>--help-qt</option +></term> + <listitem +><para +><action +>List Qt-specific options</action +></para +></listitem> + </varlistentry> + <varlistentry> + <term +><option +>--help-kde</option +></term> + <listitem +><para +><action +>List KDE-specific options</action +></para +></listitem> + </varlistentry> + <varlistentry> + <term +><option +>--help-all</option +></term> + <listitem +><para +><action +>List all options</action +></para +></listitem> + </varlistentry> + <varlistentry> + <term +><option +>--author</option +></term> + <listitem +><para +><action +>Show the authors names</action +></para +></listitem> + </varlistentry> + <varlistentry> + <term +><option +>-v,--version</option +></term> + <listitem +><para +><action +>Show the version number</action +></para +></listitem> + </varlistentry> + <varlistentry> + <term +><option +>--license</option +></term> + <listitem +><para +><action +>Show license information</action +></para +></listitem> + </varlistentry> + </variablelist> + +</sect1> + +<sect1 id="configuration"> +<title +>Configure &krusader;</title> + +<para +>When you run &krusader; for the first time the &krusader; configuration module <link linkend="konfigurator" +>Konfigurator</link +> will show up and allow you to configure &krusader; as well as detect installed packers and tools. You can always run Konfigurator again from the &settingsmenu_lnk;.</para> + +</sect1> + +</appendix> + diff --git a/doc/ru/introduction.docbook b/doc/ru/introduction.docbook new file mode 100644 index 0000000..c1a0689 --- /dev/null +++ b/doc/ru/introduction.docbook @@ -0,0 +1,152 @@ +<chapter id="introduction"> + +<!-- ********************************************************************** + introduction.docbook + ++++++++++++++++++++++++ + (C)opyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + All Rights Reserved Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Вступление</title> +<sect1 id="package-description"> +<title +>Описание пакета </title> + +<!-- OLD +<screenshot> + <screeninfo +>&krusader; Logo</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="krusader_title.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="krusader_title.png" format="EPS"/></imageobject> + <textobject +><phrase +>&krusader; Logo</phrase +></textobject> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-logo" float="1"> +<title +>&krusader; Логотип</title> +<mediaobject> +<imageobject +><imagedata fileref="krusader_title.png"/></imageobject> +<textobject +><phrase +>&krusader; Логотип</phrase +></textobject> +</mediaobject> +</figure> + +<para +>&krusader; - это несложный , легкий и полнофункциональный двух-панельный файловый менеджер для &kde; и других *nix десктопов , подобный &mc; или &tcmd;.Он предоставляет вам все необходимые средства для управления файлами.</para> + +<para +>Плюс: расширенная работа с архивами , монтирование файловых систем, &FTP;, продвинутый модуль поиска , редактор/просмотрщик, синхронизация директорий, сравнение файлов по содержимому , групповое переименовывание и много, много другого. Поддерживаются такие форматы архивов: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip и 7-zip. Управление другими &kioslaves1_url; подобно smb:// или fish://.</para> + +<para +>Практически полностью настраиваемый &krusader; дает большие удобства и замечательно выглядит на вашем рабочем столе !</para> + +<para +>Попробуйте &krusader;.</para> + +<!-- OLD +<screenshot> + <screeninfo +>&krusader; screenshot</screeninfo> + <mediaobject id="krusader_screenshot"> + <imageobject +><imagedata fileref="krusader1.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="krusader1.png" format="EPS"/></imageobject> + <textobject +><phrase +>&krusader; screenshot</phrase +></textobject> + <caption +><para +>&krusader; screenshot</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-krusader" float="1"> +<title +>&krusader; снимок экрана</title> +<mediaobject> +<imageobject +><imagedata fileref="krusader1.png"/></imageobject> +<textobject +><phrase +>&krusader; снимок экрана</phrase +></textobject> +</mediaobject> +</figure> + + +<para +>Больше снимков можно увидеть на нашем сайте по адресу &kru_screenshots_url;.</para> + +</sect1 +> + +<sect1 id="welcome"> +<title +>Добро пожаловать в &krusader;!</title> + + <para +>Мы стремились сделать для вас легкий, интуитивно понятный инструмент для простого выполнения ваших ежедневных задач:управляйте и работайте с вашими файлами удобным для вас способом и посмотрите как это удобно делать!</para> + + <para +>Если вы гуру или новичок в &Linux;,&krusader; сделает управление файлами быстрым и аккуратным, позволив вам сфокусироваться на большей картине , не в окружении командной строки.Это особенно поможет , если вы новичок в xxNIX операционных системах.Сделайте это с &krusader; одетым в великолепную одежду &GUI; , поддерживащего перетаскивание обьектов и mime типов - это то что вам нужно для домашнего использования прямо сейчас !</para> + + <para +>&krusader; поставляется с продвинутым и быстрым &archives_lnk; для прозрачной работы с архивами.В дополнение, &krusader; ускоряет многие комплексные задачи управления файлами, уменьшая утомление, ошибки и раздраженность.В общем, &krusader; предоставляет все полезные возможности которые вы хотели от других качественных файловых менеджеров таких как &mc; и &tcmd;.Так почему мы изобретаем колесо ? - спросите вы.&krusader; вплотную интегрирован с &kde; - рабочим столом , выбранным многими программистами , сетевыми инженерами, и другими продвинутыми пользователями &Linux;.С &krusader; даже пользователь - новичок получит быстрый доступ к мощным , гибким и богатым возможностям в окружении &kde;.&krusader; открытый , свободный и распространяется под лицензией &gpl_lnk;, хотя мы (разработчики) всегда помним об авторских правах проекта с этим именем и управление проектов продолжает эволюционировать.</para> + + <para +>Миссия проекта &krusader; состоит в создании файлового менеджера "все в одном" , который будет делать все обычные вещи освобождая вас от этого , плюс ещё немного ... Cогласно старому принципу &krusader; основан на &ofm_url;, двухпанельных файлов менеджеров (&mc;, &nc;, &etc;), это предоставляется &krusader; в виде стандартных файловых операций Копирование , Перемещение , Удаление , &etc; , потому что это заслуженная основа !</para> + + <para +>Сначала в основном фокусе предстают Виртуальные файловые системы. &vfs_lnk; абстрактный слой для всех видов архивированой информации (Файлы ZIP, серверы &FTP; файловая система NFS , ресурсы SAMBA , ISO образы дисков , каталоги пакетов RPM , &etc;), с возможностью прозрачного доступа для пользователя ко всей информации в различных типах файловых систем - кажется будто просто находишься в обычном каталоге! Файлы можно копировать и удалять (исключение ISO,rpm,tar.gz) из источников данных/контейнеров щелчком мыши. &krusader; , в настоящее время поддерживает VFSs для всех популярных [и некоторых специализированных] типов архивов (ace, arj, bzip2, gzip, iso, lha, rar, tar, zip and 7-zip), пакетов (rpm, deb) и традиционных удаленных файловых файловых систем (&FTP;, NFS, Samba, FISH, SFTP).</para> + + <para +>&krusader; также включает встроенный менеджер монтирования &mountman_lnk; который позволяет вам смонтировать и отмонтировать файловые системы всех типов одним кликом мыши! Предоставляет использование и другую информацию в полном и легко доступном виде , во-вторых без передвижения вашей мыши!Простота и логичность это наша цель.</para> + + <para +>&bookmark-manager_lnk; для локальных файлов/удаленных &URL; и в &advanced_search_module_lnk; для быстрого определения места расположения необходимых файлов.&krusader;также предоставляет возможность конфигурирования ваших инструментальных панелей , позволяет дополнительно сравнивать файлы по содержимому (доступны несколько отдельных методов поиска ), переименование группы файлов , стандартный терминал может быть вызван одним кликом мыши!Нуждаетесь во временном доступе с правами суперпользователя ? Просто "SU" в окне вызванного терминала или кликните на &krusader;'s "Root Mode" для запуска нового &krusader; с правами суперпользователя!</para> + + <para +>Продвинутые пользователи получат большую выгоду от легкого и качественного выполнения обыденных задач без отвлечения рук от реально важной работы , большую помощь во время продолжительных ночных компиляций/редактирования. Удобные клавиатурные сокращения позволят вам легко передвигаться по дереву каталогов, создать многотабовый каталог с одновременным просмотром и полноценную историю - все одним кликом мыши! Благодаря эффективному программированию и низкой нагрузке на систему, &krusader; наиболее чувствительный во всем системном окружении инструмент для управления , который даст вам доступ ко всем потенциальным возможностям компьютера с использованием &kde;, или других , совместимых с X Window оконных менеджеров. Хотя он и спроектирован для работы в среде &kde;, &krusader; будет также работать и в Gnome, Enlightenment, WindowMaker, IceWM, BlackBox, Wiamea, XFCE, etc. - если будут установлены библиотеки &kde;.</para> + + <para +>New extensibility is provided by the flexible &useractions_lnk;, a &krusader; innovation, that allows unlimited additional custom functionality to be added to suit the user's specific needs and wishes. We are planning to develop more modules in the near future, thereby enhancing &krusader; greatly. For information on what is proposed, approved, or remains to be completed look at the &todoforum_url;.</para> + + <para +>Ни одна другая программа , из тех что мы знаем , не дает такого удобства и гибкости в таком простом и интуитивно понятном виде! Лучшие советы , из тех что мы слышим гармонично внедряются в &krusader; .Цель проекта &krusader; - простой и наиболее доступный фаловый менеджер!</para> + <para +>Мы надеемся он вам понравится !</para> + +</sect1 +> + +</chapter> diff --git a/doc/ru/keyboard.docbook b/doc/ru/keyboard.docbook new file mode 100644 index 0000000..ce7ee4a --- /dev/null +++ b/doc/ru/keyboard.docbook @@ -0,0 +1,1948 @@ +<chapter id="keyboard-commands"> +<!-- ********************************************************************** + keyboard.docbook + +++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Keyboard Commands</title> +<indexterm +><primary +>Commands</primary +><secondary +>Keyboard</secondary +></indexterm> + +<sect1 id="keyboard-usage"> +<title +>Keyboard Usage</title> + +<para +>NOTE: this chaper is work in progress ;)</para> + +<para +>In this chapter we will learn how to use the keyboard because most operations can be done much more quickly by keyboard than with the mouse. So put away your mouse and get ready for the next exercise ;) It will take some time to learn the &keybindigs_lnk;, but once you can "play piano" with &krusader; you will save a lot of time every day! Please note that &krusader; can use &keybindigs_profiles_lnk; to swap easily to other Key-binding setups, e.g. of other commanders, or you can create your own key-bindings.</para> + +<para +>After <link linkend="starting-krusader" +>starting</link +> &krusader; the keyboard action can begin. Use Ctrl+I to jump to the &location_toolbar_lnk;, here you type the desired directory. After Ctrl+Down Arrow you are in the &termemu_lnk;, and you can type any command you desire, use Ctrl+Up arrow to jump back to the active panel. If you want to jump to a file or directory that starts with "f", then simply press "f" on the keyboard to use the &quick_search_lnk; . Use the Enter key to execute the file or to open a directory that has the focus. Be sure to remember the Function Keys - to View F3, to Edit F4, to Copy F5, Alt+u Unpack, etc.</para> + +<para +>You can also perform several operations with the &foldertabs_lnk;, including several <link linkend="edit-menu" +>selection</link +> operations. And at the end you can close &krusader; with F10.</para> + +</sect1> + +<sect1 id="key_bindings"> +<title +>Key Bindings</title> +<indexterm +><primary +>Key Bindings</primary +></indexterm> +<indexterm +><primary +>Commands</primary> + <secondary +>Keyboard</secondary> +</indexterm> + +<para +>Most of the key bindings (shortcuts) are configurable in the &konfiglookandfeel_lnk;. Some key bindings are not &krusader; Key Bindings ⪚ &kde; Key Bindings. By default &krusader; has the following key bindings:</para> + +<tip +><para +>If you are used to use other Key Bindings then the default ones listed below, change them with the &konfiglookandfeel_lnk;. Here you will find even more actions who can be linked to a Key Binding.</para +></tip> + +<!-- FN keys --> +<para +><emphasis role="bold" +>Function (FN) Keys</emphasis +></para> +<para +>These are the Key Bindings of the &fnkeybar_lnk;. These Key Bindings are configurable since version 1.51</para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycap +>F1</keycap +></para +></entry> +<entry +><para +>Help</para +></entry +></row> +<row> +<entry +><para +><keycap +>F2</keycap +></para +></entry> +<entry +><para +><link linkend="tools-menu" +>Terminal</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>F3</keycap +></para +></entry> +<entry +><para +><link linkend="krviewer" +>View files</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>F4</keycap +></para +></entry> +<entry +><para +><link linkend="krviewer" +>Edit files</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>F5</keycap +></para +></entry> +<entry +><para +><link linkend="basic" +>Copy files</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>F6</keycap +></para +></entry> +<entry +><para +><link linkend="basic" +>Move files</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>F7</keycap +></para +></entry> +<entry +><para +><link linkend="basic" +>Create a new directory</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>F8</keycap +></para +></entry> +<entry +><para +><link linkend="basic" +>Delete (or move to Trash) files</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>F9</keycap +></para +></entry> +<entry +><para +><link linkend="basic" +>Rename files</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>F10</keycap +></para +></entry> +<entry +><para +>Quit &krusader;</para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- SHIFT keys --> +<para +><emphasis role="bold" +>SHIFT keys</emphasis +></para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F1</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="help-menu" +>What's this?</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F3</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="krviewer" +>Enter an &URL; to view</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F4</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="file-menu" +>Edit new file</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F9</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="multi_rename" +>Multi Rename (&krename;)</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F10</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="view-menu" +>View all files</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F12</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="view-menu" +>Custom view files</link +></para +></entry +></row> +<!-- This keybinding is disabled in the "krusader.cpp" source file +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F11</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="view-menu" +>Executables</link +></para +></entry +></row> +--> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>Left Arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="folder_tabs" +>Change to left tab</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>Right Arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="folder_tabs" +>Change to right tab</link +></para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- ALT keys --> +<para +><emphasis role="bold" +>ALT keys</emphasis +></para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>d</keycap +></keycombo +></para +></entry> +<entry +><para +>&diskusage_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>e</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="test-archive" +>Test Archive</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>k</keycap +></keycombo +></para +></entry> +<entry +><para +>Start &rootmode_lnk; &krusader;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>L</keycap +></keycombo +></para +></entry> +<entry +><para +>&panel_profiles_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>p</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="pack-archive" +>Pack files</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>u</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="unpacking-archives" +>Unpack files</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>+</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="edit-menu" +>Select All</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>-</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="edit-menu" +>Unselect All</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>*</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="edit-menu" +>Invert Selection</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>/</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="mount-man" +>MountMan</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>`</keycap +></keycombo +></para +></entry> +<entry +><para +>&usermenu_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;&Enter;</keycombo +></para +></entry> +<entry +><para +><link linkend="file-menu" +>Properties</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>Left Arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="bookman" +>Left bookmarks</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>Right Arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="bookman" +>Right bookmarks</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>Down Arrow</keycap +></keycombo +></para +></entry> +<entry +><para +>&popup_panel_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Alt;<keycap +>F1..F12</keycap +></keycombo +></para +></entry> +<entry +><para +>Standard (&kde;) key-bindings</para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- CTRL --> +<para +><emphasis role="bold" +>CTRL keys</emphasis +></para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>+</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="edit-menu" +>Select Group</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>-</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="edit-menu" +>Unselect Group</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>=</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="view-menu" +>Compare directories</link +> (Compare Mode)</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>.</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="view-menu" +>Show/Hide Hidden (dot) Files</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>/</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="cmdline" +>Opens command line history list</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Down arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="cmdline" +>Go from the active panel to the command line/terminal emulator</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Up arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="cmdline" +>Go from the command line/terminal emulator to the active panel</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Up arrow</keycap +></keycombo +></para +></entry> +<entry +><para +>Go from the active panel to the &location_toolbar_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Home</keycap +></keycombo +></para +></entry> +<entry +><para +>Jumps to the Home directory</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Left</keycap +></keycombo +> or <keycombo +><keycap +>Right arrow</keycap +></keycombo +></para +></entry> +<entry +><para +>Focus a file or directory on the left panel, press <keycombo action="simul" +>&Ctrl;<keycap +>Left arrow</keycap +></keycombo +> and the right <link linkend="panels" +>panel</link +> changes: <itemizedlist +> <listitem +><para +>on a file: the right panel gets the same path as the left <link linkend="panels" +>panel</link +></para +></listitem +> <listitem +><para +>on a directory: refreshes the right panel with the contents of the directory</para +></listitem +> </itemizedlist +> For the right panel: press <keycombo action="simul" +>&Ctrl;<keycap +>Right arrow</keycap +></keycombo +> and the left panel will change.</para> +</entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>b</keycap +></keycombo +></para +></entry> +<entry +><para +>&combinefiles_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>d</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="bookman" +>Open Bookmarks</link +> in the active panel.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>e</keycap +></keycombo +></para +></entry> +<entry +><para +>Edit file as root (Default Useraction)</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>h</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="folderhistory" +>Opens History list</link +> in the active panel.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>j</keycap +></keycombo +></para +></entry> +<entry +><para +>A &safari;-like <link linkend="jump_back" +>Jump-Back</link +> .</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>l</keycap +></keycombo +></para +></entry> +<entry +><para +>Go to the &location_toolbar_lnk; (origin) as in &firefox; and &konqueror;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>m</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="list_panel" +>Open media list</link +>.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>n</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="tools-menu" +>New Network Connection</link +> dialog.</para +></entry +></row> +<!-- TODO: Is this entry gone ???? +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>o</keycap +></keycombo +></para +></entry> +<entry +><para +>the inactive panel gets the same path as the active panel</para +></entry +></row> +--> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>o</keycap +></keycombo +></para +></entry> +<entry +><para +>Select directory dialog to open this directory in the panel.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>p</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="splitter" +>Split file</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>u</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="view-menu" +>Swap Panels</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>r</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="panels" +>Reload (Refresh) Panel</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo +><keycap +>Ctrl</keycap +><keycap +>s</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="krusearcher" +>Search</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>q</keycap +></keycombo +></para +></entry> +<entry +><para +>Quit &krusader;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>w</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="folder_tabs" +>Close tab</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>y</keycap +></keycombo +></para +></entry> +<entry +><para +>&syncdirs_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>z</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="bookman" +>Popular URL's</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Backspace;</keycombo +></para +></entry> +<entry +><para +>Jumps to the Root directory</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>PageUp</keycap +></keycombo +></para +></entry> +<entry +><para +>Up one directory</para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- CTRL+SHIFT --> +<para +><emphasis role="bold" +>CTRL+SHIFT keys</emphasis +></para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>d</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="bookman" +>Bookmark current item</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>f</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="remote-connections" +>Disconnect remote connection</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>j</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="jump_back" +>Set jump back point</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>l</keycap +></keycombo +></para +></entry> +<entry +><para +>&locate_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>Left arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="list_panel" +>Open left media list</link +>.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>Right arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="list_panel" +>Open right media list</link +>.</para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- CTRL+ALT --> +<para +><emphasis role="bold" +>CTRL+ALT keys</emphasis +></para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>j</keycap +></keycombo +></para +></entry> +<entry +><para +>&javascript_console_lnk;</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>m</keycap +></keycombo +></para +></entry> +<entry +><para +>Mount (Default Useraction)</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>n</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="folder_tabs" +>New tab</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>r</keycap +></keycombo +></para +></entry> +<entry +><para +>Toggels the &list_panel_lnk; between horizontal and vertical mode.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>s</keycap +></keycombo +></para +></entry> +<entry +><para +>Create a new symlink.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>t</keycap +></keycombo +></para +></entry> +<entry +><para +>Show/hide the <link linkend="cmdline" +>terminal emulator</link +>.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>Left Arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="folderhistory" +>Left History list</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>Right Arrow</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="folderhistory" +>Right History list</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>=</keycap +></keycombo +></para +></entry> +<entry +><para +>Equal Panel Size (Default Useraction)</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;&Shift;<keycap +>n</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="folder_tabs" +>Duplicate a tab</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;&Enter;</keycombo +></para +></entry> +<entry +><para +>Open current folder in a <link linkend="folder_tabs" +>new tab</link +></para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- GENERAL CTRL --> +<para +><emphasis role="bold" +>General CTRL keys</emphasis +></para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>a</keycap +></keycombo +></para +></entry> +<entry +><para +>Select all</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>PageDown</keycap +></keycombo +></para +></entry> +<entry +><para +>Move to the lower part in the current directory</para +></entry +></row> + +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>F1..F12</keycap +></keycombo +></para +></entry> +<entry +><para +>Standard (&kde;) key-bindings</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>F1..F12</keycap +></keycombo +></para +></entry> +<entry +><para +>Standard (&kde;) key-bindings</para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- OTHER KEYS --> +<para +><emphasis role="bold" +>Other keys</emphasis +></para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycap +>foo</keycap +></para +></entry> +<entry +><para +>&quick_search_lnk;</para +></entry +></row> +<row> +<entry +><para +>	</para +></entry> +<entry +><para +><link linkend="panels" +>Switch between the panels</link +></para +></entry +></row> +<row> +<entry +><para +>&Enter;</para +></entry> +<entry +><para +><link linkend="executing_files" +>On a file:</link +> open/execute that file</para> + <para +><link linkend="browsing-archives" +>On an archive file:</link +> browse the archive as if it was a directory</para +></entry +></row> +<row> +<entry +><para +>&Esc;</para +></entry> +<entry +><para +><link linkend="moving-around" +>Will make the menu bar loose the focus if it has it</link +></para> +</entry +></row> +<row> +<entry +><para +><keycap +>Delete</keycap +></para +></entry> +<entry +><para +><link linkend="basic" +>Delete (or move to Trash)</link +></para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>Delete</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="basic" +>Delete permanently</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>SPACE</keycap +></para +></entry> +<entry +><para +><link linkend="marking-files" +>On a file:</link +> toggle the marking of the file without affecting the marking of other files/directories.</para> + <para +><link linkend="calculate" +>On a directory:</link +> calculate the size, without without affecting the marking of other files/directories.</para +></entry +></row> +<row> +<entry +><para +>&Backspace;</para +></entry> +<entry +><para +>One directory up</para +></entry +></row> +<row> +<entry +><para +><keycap +>INSERT</keycap +></para +></entry> +<entry +><para +>Does the same as the SPACE key <link linkend="marking-files" +>but it will go one position down to toggle the next file.</link +></para +></entry +></row> +<row> +<entry +><para +><keycap +>MENU</keycap +></para +></entry> +<entry +><para +>Right-click menu</para +></entry +></row> +<row> +<entry +><para +><keycap +>Home</keycap +></para +></entry> +<entry +><para +>Cursor jumps to the top of the list</para +></entry +></row> +<row> +<entry +><para +><keycap +>End</keycap +></para +></entry> +<entry +><para +>Cursor jumps to the last file in the list</para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- COMMANDLINE --> +<para id="cmdline_keybindings" +><emphasis role="bold" +>Command Line</emphasis +></para> +<para +>&cmdline_lnk; keybindings.</para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycap +>Up arrow</keycap +> and <keycap +>Down arrow</keycap +></para +></entry> +<entry +><para +>scroll through previously typed commands.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>/</keycap +></keycombo +></para +></entry> +<entry +><para +>opens the command line history list.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Up arrow</keycap +></keycombo +></para +></entry> +<entry +><para +>jumps from the command line to the active panel.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Down arrow</keycap +></keycombo +></para +></entry> +<entry +><para +>jumps from the active panel to the command line.</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Enter;</keycombo +></para +></entry> +<entry +><para +>inserts current file / directory name without path to current command line position.</para> +</entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;&Enter;</keycombo +></para +></entry> +<entry +><para +>inserts current file / directory with full path name to current command line position.</para +></entry +></row> +<!-- "Backspace" key in terminal, /* Shortcut disabled because of the Terminal Emulator bug. */ krusader.cpp --> +</tbody> +</tgroup> +</informaltable> + + +<!-- DEFAULT USERACTIONS --> +<para +><emphasis role="bold" +>Default Useractions</emphasis +></para> +<para +>Default &useractions_lnk; keybindings provided by &krusader;.</para> +<informaltable> +<tgroup cols="2"> +<tbody> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>e</keycap +></keycombo +></para +></entry> +<entry +><para +>Edit a file as root</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>c</keycap +></keycombo +></para +></entry> +<entry +><para +>Copy current item to clipboard</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>m</keycap +></keycombo +></para +></entry> +<entry +><para +>Mount a new filesystem</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>=</keycap +></keycombo +></para +></entry> +<entry +><para +>Equal panel-size</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>a</keycap +></keycombo +></para +></entry> +<entry +><para +>Enqueue in Amarok</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>1</keycap +></keycombo +></para +></entry> +<entry +><para +>Sort by Name</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>2</keycap +></keycombo +></para +></entry> +<entry +><para +>Sort by Extension</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>3</keycap +></keycombo +></para +></entry> +<entry +><para +>Sorts the active panel by Size</para +></entry +></row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Win</keycap +><keycap +>4</keycap +></keycombo +></para +></entry> +<entry +><para +>Sort by Modified</para +></entry +></row> +</tbody> +</tgroup> +</informaltable> + + +<!-- OTHER KEYS URL'S --> +<itemizedlist> +<title +>Other Key-bindings</title> + <listitem> + <para +><link linkend="marking-files" +>Marking files</link +></para> + </listitem> + <listitem> + <para +><link linkend="krviewer" +>KrViewer</link +></para> + </listitem> + <listitem> + <para +>&diskusage_lnk;</para> + </listitem> + <listitem> + <para +>&locate_lnk;</para> + </listitem> + <listitem> + <para +>&kcontrolcenter; -> Accessibility -> Keyboard Shortcuts</para> + </listitem> + <listitem> + <para +>&useractions_lnk; configurable key-bindings</para> + </listitem> +</itemizedlist> + +</sect1> + +</chapter> diff --git a/doc/ru/konfigurator.docbook b/doc/ru/konfigurator.docbook new file mode 100644 index 0000000..7d70ff0 --- /dev/null +++ b/doc/ru/konfigurator.docbook @@ -0,0 +1,2167 @@ +<chapter id="konfigurator"> + +<!-- ********************************************************************** + konfigurator.docbook + ++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Konfigurator: &krusader;'s Configuration Center</title> +<indexterm +><primary +>Configure</primary +><secondary +>Krusader</secondary +></indexterm> + +<para +>Konfigurator is &krusader;'s configuration center. Here you can modify the way &krusader; does things and customize it to your own needs. At any time, pressing the <guibutton +>Apply</guibutton +> button will apply the changes, pressing <guibutton +>Close</guibutton +> will close Konfigurator, and pressing <guibutton +>Defaults</guibutton +> will re-apply &krusader;'s "factory" settings. Konfigurator is divided into pages, each containing items related to that page. For some changes to the &GUI;, you will have to close and restart &krusader;.</para> + +<sect1 id="konfig-startup"> +<title +>Startup</title> + +<!-- OLD +<screenshot> + <screeninfo +>Startup configuration</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="kgstartup.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="kgstartup.png" format="EPS"/></imageobject> + <textobject +><phrase +>Startup configuration</phrase +></textobject> + <caption +><para +>Configure Startup</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-kgstartup" float="1"> +<title +>Startup configuration</title> +<mediaobject> +<imageobject +><imagedata fileref="kgstartup.png"/></imageobject> +<textobject +><phrase +>Startup configuration</phrase +></textobject> +</mediaobject> +</figure> + +<para +>The startup page determines the way that &krusader; looks (and works) when it is launched. It is divided into two main parts:</para> + +<variablelist> +<varlistentry +><term +><guilabel +>General</guilabel +></term> + <listitem> + <itemizedlist> + <listitem +><para +><guilabel +>Startup Profile</guilabel +> : Starts the selected <link linkend="panel_profiles" +>Panel profile</link +> at startup. <guilabel +><Last session></guilabel +> is a special Panel Profile, it is saved automaticly when closing &krusader;. </para +></listitem> + + <listitem +><para +><guilabel +>Show splashscreen</guilabel +>: Display a splashscreen when starting &krusader;. </para +></listitem +> + + <listitem +><para +><guilabel +>Single Instance Mode</guilabel +>: Only one Krusader instance is allowed to run. </para +></listitem +> + + </itemizedlist> + </listitem> + </varlistentry> + +<varlistentry +><term +><guilabel +>User Interface</guilabel +></term> + <listitem +><para +>Determine which parts of the user interface are visible after startup. <itemizedlist> + <listitem +><para +><guilabel +>Save settings on exit</guilabel +>: if checked, restore the user interface components to their condition when last shutdown.</para +></listitem> + + <listitem +><para +><guilabel +>Show toolbar</guilabel +>: if checked, &main_toolbar_lnk; will be visible after startup.</para +></listitem> + + <listitem +><para +><guilabel +>Show statusbar</guilabel +>: if checked, the &statusbar_lnk; will be visible after startup.</para +></listitem> + + <listitem +><para +><guilabel +>Show function keys</guilabel +>: if checked, the &fnkeybar_lnk; will be visible after startup. </para +></listitem> + + <listitem +><para +><guilabel +>Show command line</guilabel +>: if checked, the &cmdline_lnk; will be visible after startup. </para +></listitem> + + <listitem +><para +><guilabel +>Show terminal emulator</guilabel +>: if checked, the &termemu_lnk; will be visible after startup. </para +></listitem> + + <listitem +><para +><guilabel +>Save last position, size and panel settings</guilabel +>: when launched, &krusader; will resize itself to the size it was when last shutdown. &krusader; will also appear in the same location on the screen, having panels sorted and aligned as they were. If this option is unchecked, you can use the menu <emphasis role="bold" +><menuchoice +><guimenu +>Settings</guimenu +> <guimenuitem +>Save Position</guimenuitem +></menuchoice +></emphasis +> option to manually set &krusader;'s size and position at startup. </para +></listitem> + + <listitem +><para +><guilabel +>Start to tray</guilabel +>: if checked, &krusader; starts to tray (if minimize to tray is set), without showing the main window. </para +></listitem> + + </itemizedlist> + </para +></listitem> + </varlistentry> +</variablelist> + +</sect1> + +<sect1 id="konfig-looknfeel"> +<title +>Look & Feel</title> + +<para +>Here you can determine the look & feel of things - which basically means fine-tuning the application to your needs. The page is divided into five tabs: <guilabel +>Operation</guilabel +>, <guilabel +>Panel</guilabel +>, <guilabel +>Toolbar</guilabel +>, <guilabel +>Key-bindings</guilabel +> and <guilabel +>Panel Toolbar</guilabel +>. Since <guilabel +>Toolbar</guilabel +> and <guilabel +>Key-bindings</guilabel +> are &kde; standard tools, we'll focus on the other sections:</para> + +<!-- OLD +<screenshot> + <screeninfo +>Look & Feel configurtarion</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="kglookfeel.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="kglookfeel.png" format="EPS"/></imageobject> + <textobject +><phrase +>Look & Feel configurtarion</phrase +></textobject> + <caption +><para +>Configure Look & Feel</para +></caption> + </mediaobject> +</screenshot> +--> + +<!--HTML_PARSING +<figure id="screenshot-kglookfeel" float="1"> +<title +>Look & Feel configurtarion</title> +<mediaobject> +<imageobject +><imagedata fileref="kglookfeel.png"/></imageobject> +<textobject +><phrase +>Look & Feel configurtarion</phrase +></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + + +<sect2 id="konfig-looknfeel-operation"> +<title +>Operation</title> + +<itemizedlist +><title +><guilabel +>Look & Feel</guilabel +></title> + <listitem +><para +><guilabel +>Warn on exit</guilabel +>: if checked, &krusader; will display an "Are you sure?" warning when you try to shut it down; otherwise, it will exit without protest. </para +></listitem> + + <listitem +><para +><guilabel +>Minimize to tray</guilabel +>: if checked, when you minimize &krusader;, it's icon will appear in the system tray instead of the taskbar. </para +></listitem> + + <listitem +><para +><guilabel +>Automark Directories</guilabel +>: when <link linkend="edit-menu" +>selecting a group of files</link +> (either by using Select Group or by using Select All), &krusader; will check this option. If checked, then directories matching the select criteria will also be marked; otherwise, only files will be marked. </para +></listitem> + + <listitem +><para +><guilabel +>Rename selects extension</guilabel +>: When renaming a file, the whole text is selected. If you want total-commander like renaming of just the name, without extension, unmark this item. </para +></listitem> + + <listitem +><para +><guilabel +>Use fullpath tab names</guilabel +>: if checked, display the full path in the &foldertabs_lnk;, otherwise only the last part of the path will be displayed. </para +></listitem> + + <listitem +><para +><guilabel +>Fullscreen terminal (mc-style)</guilabel +>: Terminal is shown instead of the &krusader; window (full screen). </para +></listitem> + +<!-- + <listitem +><para +><guilabel +>HTML viewers minimal font size</guilabel +>: when viewing an HTML file + (usually using <keycap +>F3</keycap +>), &krusader; invokes &kde;'s built-in HTML parser. This option + sets the minimal font size for the viewer, and aligns other font sizes accordingly. + </para +></listitem +> --> + +</itemizedlist> + + +<itemizedlist +><title +><guilabel +>Quicksearch</guilabel +></title> + <listitem +><para +><guilabel +>New style Quicksearch</guilabel +>: The new <link linkend="quicksearch" +>Quicksearch</link +> feature is used. </para +></listitem> + + <listitem +><para +><guilabel +>Case Sensitive Quicksearch</guilabel +>: When using the <link linkend="quicksearch" +>Quicksearch</link +> feature: if checked (the &UNIX; default), all files beginning with capital letters appear before files beginning with non-capital letters; otherwise, all files beginning with a specified letter (capital or otherwise) will appear together. </para +></listitem> +</itemizedlist> + +</sect2> + +<sect2 id="konfig-looknfeel-panel"> +<title +>Panel</title> + +<itemizedlist> + <listitem +><para +><guilabel +>Panel font</guilabel +>: allows you to change the font used inside the file lists.</para +></listitem> + <listitem +><para +><guilabel +>Filelist icon size</guilabel +>: allows you to change the size of the icons in the file lists. The available sizes are 16x16, 22x22, 32x32 and 48x48 pixels.</para +></listitem> + <listitem +><para +><guilabel +>Use icons in filenames</guilabel +>: if checked, show the icons in filenames and folders.</para +></listitem> + <listitem +><para +><guilabel +>Human readable file size</guilabel +>: if checked, the file size will be displayed in kB, Mb &etc; and not in bytes (default).</para +></listitem> + <listitem +><para +>Since &krusader;-1.70.0 you need to configure the Columns with the right click menu in the panel and not in Konfigurator. The left and right panel use their own Columns independently. The next Columns are available: <itemizedlist> + <listitem +><para +><guilabel +>Name</guilabel> + </para +></listitem> + <listitem +><para +><guilabel +>Ext</guilabel +>: show the last part of the filename (part after the last dot) in the Ext Column and not as a complete filename in the Name Column like e.g. &konqueror; does. </para +></listitem> + <listitem +><para +><guilabel +>Type</guilabel +>: show the mimetype field. </para +></listitem> + <listitem +><para +><guilabel +>Size</guilabel +>: show the size field. </para +></listitem> + <listitem +><para +><guilabel +>Modified</guilabel +>: show the modified date and time field. </para +></listitem> + <listitem +><para +><guilabel +>Perms</guilabel +>: show the full perissions ⪚ "rwxr-xr-x" or as octal numbers '0755' instead with enable/disable <guilabel +>Nummeric Permissions</guilabel +> in Look & Feel <guilabel +>Operation</guilabel +> Tab. </para +></listitem> + <listitem +><para +><guilabel +>rwx</guilabel +>: show only the rights of the current user ⪚ "-rw". </para +></listitem> + <listitem +><para +><guilabel +>Owner</guilabel +>: show the owner field. </para +></listitem> + <listitem +><para +><guilabel +>Group</guilabel +>: show the group field. </para +></listitem> + </itemizedlist> + </para +></listitem> + + <listitem +><para +><guilabel +>Show Hidden files</guilabel +>: if checked, &krusader; will display the "dot-files" which are otherwise hidden. </para +></listitem> + + <listitem +><para +><guilabel +>Case Sensitive Sorting</guilabel +>: if checked (the &UNIX; default), all files beginning with capital letters appear before files beginning with non-capital letters; otherwise, all files beginning with a specified letter (capital or otherwise) will appear together. </para +></listitem> + + <listitem +><para +><guilabel +>Always sort dirs by name</guilabel +>: Directories are sorted by name, regardless of the sort column. </para +></listitem +> + + <listitem +><para +><guilabel +>Numeric permissions</guilabel +>: Permission column (Look & Feel <guilabel +>Panel</guilabel +> Tab) shows octal numbers '0755' instead of 'rwxr-xr-x'. </para +></listitem> + +</itemizedlist> + +<tip +><para +>Uncheck the un-used columns, this allows more space for columns in use. </para +></tip> + +</sect2> + + +<sect2 id="konfig-looknfeel-ptoolbar"> +<title +>Panel Toolbar</title> +<para +><guilabel +>Panel Toolbar visible</guilabel +>: if checked, &krusader; will display the Panel Toolbar.</para> + +<para +>The buttons on the <guilabel +>Panel Toolbar</guilabel +> can be made visible or hidden: <itemizedlist> + <listitem +><para +><guilabel +>Clear Location Toolbar</guilabel +> button: clears the &location_toolbar_lnk;</para> + </listitem> + <listitem +><para +><guilabel +>Open</guilabel +> button</para> + </listitem> + <listitem +><para +><guilabel +>Equal (=)</guilabel +> button</para> + </listitem> + <listitem +><para +><guilabel +>Up (..)</guilabel +> button</para> + </listitem> + <listitem +><para +><guilabel +>Home (~)</guilabel +> button</para> + </listitem> + <listitem +><para +><guilabel +>Root (/)</guilabel +> button</para> + </listitem> + <listitem +><para +><guilabel +>Toggle-button for sync-browsing</guilabel +>: if checked, show the &sync_browsing_lnk; button.</para +></listitem> +</itemizedlist> +</para> +</sect2> + + +<sect2 id="konfig-selection_modes"> +<title +>Selection Mode</title> +<para +>Here you can configure the selection modes. <itemizedlist id="mouse_selection_modes" +><title +><guilabel +>General</guilabel +></title> + <listitem +><para +><guilabel +>&krusader; Mode</guilabel +>: the way &krusader; has worked from day one. Both mouse keys allow selecting files. To select more than one file, hold the &Ctrl; key and click the &LMB;. Right-click menu is invoked using a short click on the &RMB;.</para +></listitem> + <listitem +><para +><guilabel +>Konqueror Mode</guilabel +>: pressing the &LMB; selects files -- you can click and select multiple files. Right-click menu is invoked using a short click on the &RMB;. </para +></listitem> + <listitem +><para +><guilabel +>Total commander Mode</guilabel +>: pressing the &RMB; selects multiple files and the right-click menu is invoked by <guilabel +>pressing and holding</guilabel +> the &RMB; The &LMB; does not select, but sets the current file without affecting the current selection. </para +></listitem> + + <listitem +><para +><guilabel +>Custom Selection Mode</guilabel +>: create your own selection style! </para +></listitem> +</itemizedlist> + +<itemizedlist +><title +><guilabel +>Details</guilabel +></title> + <listitem +><para +><guilabel +>Double-click selects (classic)</guilabel +>: A single click on a file will select and focus, a double click opens the file or steps into the directory. </para +></listitem> + + <listitem +><para +><guilabel +>Obey KDE's global selection policy</guilabel +>: pressing the &LMB; selects files -- Use &kde;'s global setting: &kde; Control Center -> Peripherals -> Mouse. </para +></listitem> + + <listitem +><para +>Custom Selection Mode items: <itemizedlist> + <listitem +><para +><guilabel +>Based on KDE's selection mode</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Left mouse button selects</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Left mouse button preserves selection</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Shift/Ctrl-Left mouse button selects</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Right mouse button selects</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Right mouse button preserves selection</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Shift/Ctrl-Right mouse button selects</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Spacebar moves down</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Spacebar calculates diskspace</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Insert moves down</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Right clicking pops context-menu immediately</guilabel +></para +></listitem> + </itemizedlist> + </para +></listitem> +</itemizedlist> + +</para> +</sect2> + +</sect1> + + +<sect1 id="konfig-color"> +<title +>Colors</title> + +<para +>This page configures the colors of the &list_panel_lnk; and the &synchronizer_lnk;. The <guilabel +>KDE default colors</guilabel +> is the default color configuration. </para> + +<!-- OLD +<screenshot> + <screeninfo +>Colors configuration</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="kgcolor.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="kgcolor.png" format="EPS"/></imageobject> + <textobject +><phrase +>Colors configuration</phrase +></textobject> + <caption +><para +>Colors configuration</para +></caption> + </mediaobject> +</screenshot> +--> + + +<!--HTML_PARSING +<figure id="screenshot-kgcolor" float="1"> +<title +>Colors configuration</title> +<mediaobject> +<imageobject +><imagedata fileref="kgcolor.png"/></imageobject> +<textobject +><phrase +>Colors configuration</phrase +></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + + +<variablelist> + <varlistentry +><term +><guilabel +>General</guilabel +></term> + <listitem> + <itemizedlist> + <listitem +><para +><guilabel +>Use the default KDE colors</guilabel +>: this is the default, it uses &kde;'s the color settings of <command +>kcontrol</command +>.</para> + </listitem> + + <listitem +><para +><guilabel +>Use Alternate Background color</guilabel +>: If checked, the <guilabel +>Background</guilabel +> color and the <guilabel +>Alternate background</guilabel +> color alternates line by line. When you don't use the &kde; default colors, you can configure the alternate colors in the <guilabel +>Colors</guilabel +> box.</para> + </listitem> + + <listitem +><para +><guilabel +>Show current item even if not focused</guilabel +>: If checked, shows the last cursor position in the non active list panel. This option is only available when you don't use the &kde; default colors.</para> + </listitem> + + <listitem +><para +><guilabel +>Dim the colors of the inactive panel</guilabel +>: If checked, the colors of the inactive panel are calculated by a dim color and a dim factor, these settings can be configured in the <guilabel +>Inactive</guilabel +> tab of the <guilabel +>Colors</guilabel +> box. This option is only available when you don't use the &kde; default colors.</para> + </listitem> + + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry +><term +><guilabel +>Colors</guilabel +></term> + <listitem +><para +>Choose the colors the way you like. In the <guilabel +>Preview</guilabel +> section you can see the result. The following items of the active and inactive panel can be configured:</para> + <itemizedlist> + <listitem +><para +><guilabel +>Foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Directory foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Executable foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Symbolic link foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Invalid symlink foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Background</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Alternate background</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Marked foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Marked background</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Alternate marked background</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Current foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Marked current foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Current background</guilabel +></para +></listitem> + </itemizedlist> + <para +>The following items of the &synchronizer_lnk; can be configured:</para> + <itemizedlist> + <listitem +><para +><guilabel +>Equals foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Equals background</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Differing foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Differing background</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Copy to left foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Copy to left background</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Copy to right foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Copy to left background</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Delete foreground</guilabel +></para +></listitem> + <listitem +><para +><guilabel +>Delete background</guilabel +></para +></listitem> + </itemizedlist> + </listitem> + </varlistentry> + + + <varlistentry +><term +><guilabel +>Preview</guilabel +></term> + <listitem +><para +>Here you see a preview of the configured colors.</para> + </listitem +></varlistentry> + + <varlistentry +><term +><guilabel +>Color schemes</guilabel +></term> + <listitem +><para +>With the <guibutton +>Import Color Scheme</guibutton +> <guibutton +>Export Color Scheme</guibutton +> buttons you can load and save a Color Scheme profile. This allows that &krusader; can have the &tcmd;, &mc;, foo-commander or your custom colors. The Color Schemes are stored in <filename +>$KDEDIR/share/apps/krusader</filename +>, the <filename +>foo.color</filename +> is a binary file that holds the Color Scheme.</para> + + <tip +><para +>A &mc; and &tcmd; Color scheme file is provided. Please <link linkend="help_krusader" +>upload your favorite Color schemes</link +> so that they become available for the &krusader; community. Thanks! </para +></tip> + + </listitem +></varlistentry> + +</variablelist> + + +</sect1> + +<sect1 id="konfig-general"> +<title +>General</title> +<para +>Here you configure the basic operations.</para> + +<!-- OLD +<screenshot> + <screeninfo +>General configuration</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="kggeneral.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="kggeneral.png" format="EPS"/></imageobject> + <textobject +><phrase +>General configuration</phrase +></textobject> + <caption +><para +>General configuration</para +></caption> + </mediaobject> +</screenshot> +--> + +<!--HTML_PARSING +<figure id="screenshot-kggeneral" float="1"> +<title +>General configuration</title> +<mediaobject> +<imageobject +><imagedata fileref="kggeneral.png"/></imageobject> +<textobject +><phrase +>General configuration</phrase +></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + + +<para +>The following options determine basic aspects of operation: <itemizedlist> + <listitem +><para +><guilabel +>Delete files/Move to trash</guilabel +>: when &krusader; deletes files it can either 'really' delete them or move them to the trash folder, thereby making them available via &kde;'s trash.</para +></listitem> + <listitem +><para +><guilabel +>Use mimetype magic</guilabel +>: mimetype magic is a mechanism which allows &krusader; to inspect the files in the panels and determine their type even if the file has no identifying extension. For example, if you take an image file - 'image1.jpg' - and rename it to 'image1', &krusader; will still know it's an image file and work with it accordingly. However, this mode of operation is slower (while refreshing the panel, or changing directories), so try &krusader; with and without mimetype magic and decide what's best for you.</para +></listitem> + <listitem +><para +><guilabel +>Editor</guilabel +>: choose what editor will be used when editing a file (via F4).</para +></listitem> + <listitem +><para +><guilabel +>Default viewer mode</guilabel +>: eighter: generic, text or hex mode. </para +></listitem> + <listitem +><para +><guilabel +>Viewer opens each file in a separate window</guilabel +>: use browsing tabs or not. </para +></listitem> + <listitem +><para +><guilabel +>Terminal</guilabel +>: choose what terminal emulator will be used when &krusader; opens a console window (via F2, or Commands->Terminal menu option).</para +></listitem> + <listitem +><para +><guilabel +>Terminal Emulator sends Chdir on a panel change</guilabel +>: if unchecked, there will be no <command +>cd</command +> command sended to the Termainal Emulator if the panelfolder changes.</para +></listitem> + <listitem +><para +><guilabel +>Temp Directory</guilabel +>: this option selects the base directory for &krusader;'s temporary files. The actual files will be created in separate directories under the 'Temp directory', so that each user running &krusader; will have his/her own temporary subdirectories under the chosen directory. <note +><para +>You must choose a temporary directory to which all users running &krusader; have full permissions!</para +></note +></para +></listitem> +</itemizedlist +></para> + +</sect1> + +<sect1 id="konfig-advanced"> +<title +>Advanced</title> +<para +>This page handles more advanced issues, so you should double-check what you do here, since modifying things around here <remark +>makes &krusader; a more powerful AND dangerous tool.</remark +></para> + +<!-- OLD +<screenshot> + <screeninfo +>Advanced configuration</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="kgadvanced.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="kgadvanced.png" format="EPS"/></imageobject> + <textobject +><phrase +>Advanced configuration</phrase +></textobject> + <caption +><para +>Advanced configuration</para +></caption> + </mediaobject> +</screenshot> +--> + + +<!--HTML_PARSING +<figure id="screenshot-kgadvanced" float="1"> +<title +>Advanced configuration</title> +<mediaobject> +<imageobject +><imagedata fileref="kgadvanced.png"/></imageobject> +<textobject +><phrase +>Advanced configuration</phrase +></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + + +<para +>The page is divided into three parts:</para> + +<variablelist> +<varlistentry +><term +><guilabel +>General</guilabel +></term> + <listitem> + <itemizedlist> + <listitem +><para +><guilabel +>Preserve attributes for local copy/move (slower)</guilabel +>: If checked, &krusader; will try to preserve all attributes (time, owner, group) of the local files according to the source one depending on your <link linkend="copying" +>permissions</link +>. </para +></listitem> + <listitem +><para +><guilabel +>Automount filesystems</guilabel +>: this makes &krusader; try to mount a filesystem before entering it. For example, if you click on <filename class="directory" +>/mnt/cdrom</filename +> (and <filename class="directory" +>/mnt/cdrom</filename +> appears in <filename class="directory" +>/etc/fstab</filename +> as a mount point), &krusader; will check if it is mounted. If not, it will try and mount it for you and then enter, so that you'd see the contents of your cdrom. Note, however, that &krusader; will NOT unmount when exiting <filename class="directory" +>/mnt/cdrom</filename +>. </para +></listitem> + + <listitem +><para +><guilabel +>Don't use KDE's media protocol for the Media button (if it's buggy or missing)</guilabel +>: If checked, &krusader; won't use &kde;'s media protocol for the <link linkend="list_panel" +>Media button</link +>. Use this open when the media protocol is buggy (in some older &kde; versions) or if you have no kdebase package installed on your system. </para +></listitem> + + <listitem +><para +><guilabel +>MountMan won't (un)mount the following mount-points</guilabel +>: If you have filesystems that you don't want to accidentally unmount (or mount) then enter a list of mountpoints separated by commas (⪚ <literal +>/, /boot, /tmp</literal +>) and &mountman_lnk; won't try to (un)mount them. </para +></listitem> + </itemizedlist> + </listitem> +</varlistentry> + +<varlistentry +><term +><guilabel +>Confirmations</guilabel +></term> + <listitem +><para +>By checking the options in this section, &krusader; will ask for confirmation before doing a specific action; otherwise, the following actions will be done without warning:</para> + <itemizedlist> + <listitem +><para +>deleting non empty directorie(s)</para +></listitem> + <listitem +><para +>deleting file(s)</para +></listitem> + <listitem +><para +>copying file(s)</para +></listitem> + <listitem +><para +>moving file(s)</para +></listitem> + </itemizedlist> + </listitem +></varlistentry> + +<varlistentry +><term +><guilabel +>Fine-Tuning</guilabel +></term> + <listitem +><itemizedlist> + <listitem +><para +><guilabel +>Icon Cache Size</guilabel +>: &krusader; uses an icon cache, so it won't have to reload icons that were already used before. Of course, as the cache grows bigger, it can store more icons and further speed operations, but the memory footprint of &krusader; will be bigger.</para +></listitem> + <listitem +><para +><guilabel +>Arguments of updatedb</guilabel +>: sets additional arguments for <command +>updatedb</command +>, please read the manpages for more information.</para +></listitem> + </itemizedlist> + </listitem +></varlistentry> + +</variablelist> +</sect1> + +<sect1 id="konfig-archives"> +<title +>Archives</title> +<para +>This page handles the way &krusader; works with archives. In the <guilabel +>General</guilabel +> section you'll see a list of archive formats. Some are checked and some are grayed-out. The ones that are available (not grayed-out) are supported by &krusader;. If you check them, then &krusader; will handle them transparently and let you open them as folders; otherwise, &krusader; will attempt to invoke an application which opens that type of archive. If a certain archive is grayed-out, it means that &krusader; couldn't find the appropriate executables in the configured path. The next archives are supported: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip.</para> + +<!-- OLD +<screenshot> + <screeninfo +>Archives configuration</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="kgarchives.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="kgarchives.png" format="EPS"/></imageobject> + <textobject +><phrase +>Archives configuration</phrase +></textobject> + <caption +><para +>Archives configuration</para +></caption> + </mediaobject> +</screenshot> +--> + +<!--HTML_PARSING +<figure id="screenshot-kgarchives" float="1"> +<title +>Archives configuration</title> +<mediaobject> +<imageobject +><imagedata fileref="kgarchives.png"/></imageobject> +<textobject +><phrase +>Archives configuration</phrase +></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + + +<para +>If you've installed a certain archive application (let's say <command +>arj</command +>) and want &krusader; to know about it, just click the <guibutton +>Auto Configure</guibutton +> button. &krusader; will search for all supported executables and print a report listing the archive formats that can be handled. If all went well the new archive should be available and checked.</para> + +<note +><para +>Please install new packagers to your <envar +>PATH</envar +> (&ie;: <filename +>/usr/bin</filename +> or <filename +>/usr/local/bin</filename +> &etc;)</para +></note> + +<para +>The full path of the packagers is stored in the &konfigdependencie_lnk; (⪚ to handle ZIP archives, &krusader; needs the <command +>unzip</command +> and <command +>zip</command +> executables). It's possible that you need to configure manually the mimes to the protocols in the &konfigprotocol_lnk;.</para> + +<para +><guilabel +>Fine-Tuning</guilabel> + <itemizedlist> + <listitem +><para +><guilabel +>Allow moving into archives</guilabel +>: this option allows you to move files into an archive (as opposed to just copying into the archive). The down side is that if a power failure occurs during the process, the files that were moved might already be deleted, but not yet packed into the archive. <note +><para +>If such thing happens, the file(s) are NOT LOST. They were actually moved into a subfolder in the &krusader;'s <link linkend="konfig-general" +>temp directory</link +>. You can search that directory and find your files, safe and sound. </para +></note +></para +></listitem> + <listitem +><para +><guilabel +>Test archives when finished packing</guilabel +>: this option automatically runs a test on a newly packed archive. It is safer, but takes longer.</para +></listitem> + </itemizedlist +></para> + +</sect1> + +<sect1 id="konfig-dependencies"> +<title +>Dependencies page</title> + +<para +>This page configures the full path of the external applications. It is even possible to configure the full path of &krusader;!</para> + + +<para +><emphasis role="bold" +>General tab</emphasis +></para> +<para +>Here you can configure the full path of the following external applications: <informaltable +> <tgroup cols="2" +> <tbody> +<row> +<entry +>application</entry> +<entry +>configurable full path</entry> +</row> +<row> +<entry +><para +><command +>df</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/bin/df</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>eject</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/eject</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>kdesu</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/kdesu</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>kget</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/kget</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>kmail</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/kmail</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +>diff utility</para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/kompare</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><command +>krename</command +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/krename</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>krusader</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/krusader</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>locate</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/locate</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>mount</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/bin/mount</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>umount</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/bin/umount</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>updatedb</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/updatedb</replaceable +></filename +></para +></entry> +</row> +</tbody> +</tgroup> +</informaltable> +</para> + + + +<tip +><para +>By default &kompare; (part of the kdebase package) is used as external diff utility but you can also use your favorite diff utility ⪚ &xxdiff_url; or &kdiff3_url; , just fill in the full path and enjoy.</para +></tip> + +<para +><emphasis role="bold" +>Packers tab</emphasis +></para> +<para +>Here you can configure the full path of the following external packers, &krusader; offers also a <link linkend="konfig-archives" +>auto configure tool</link +> for packagers. <informaltable +> <tgroup cols="2" +> <tbody> +<row> +<entry +>packer</entry> +<entry +>configurable full path</entry> +</row> +<row> +<entry +><para +><command +>7z</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>usr/bin/7z</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>arj</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>usr/bin/arj</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>bzip2</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>usr/bin/bzip2</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>cpio</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/bin/cpio</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>dpkg</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/bin/dpkg</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>gzip</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/gzip</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>lha</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/lha</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>rar</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/rar</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>tar</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/bin/tar</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>unace</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/unace</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>unarj</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/unarj</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>unrar</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/unrar</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>unzip</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/unzip</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>zip</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/zip</replaceable +></filename +></para +></entry> +</row> +</tbody> +</tgroup> +</informaltable> +</para> + + +<note +><para +>It is possible that unace doesn't work, but please don't blame us. ACE doesn't want, that other programs could cooperate with it. Unace has closed source, and they wrote some additional lines, that if the stdin is redirected to somewhere else, unace gets into infinite loop. It works with the same manner as 'su', where you cannot enter the password only from the stdin. &krusader; +>= 1-51 emulates the command line environment for being able to cooperate with unace, but we noticed that unace always changes its output's format from release to release, making the cooperation almost impossible. </para +></note> + +<para +><emphasis role="bold" +>Checksum Utilities tab</emphasis +></para> +<para +>Here you can configure the full path of the following external <link linkend="checksum" +>Checksum Utilities</link +>: <informaltable +> <tgroup cols="2" +> <tbody> +<row> +<entry +>Checksum Utilities</entry> +<entry +>configurable full path</entry> +</row> +<row> +<entry +><para +><command +>md5sum</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/md5sum</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>sha1sum</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/sha1sum</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>md5deep</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/md5deep</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>sha1deep</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/sha1deep</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>sha256deep</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/sha256deep</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>tigerdeep</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/tigerdeep</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>whirlpooldeep</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/whirlpooldeep</replaceable +></filename +></para +></entry> +</row> +<row> +<entry +><para +><command +>cfv</command +></para +></entry> +<entry +><para +><filename class="directory" +><replaceable +>/usr/bin/cfv</replaceable +></filename +></para +></entry> +</row> +</tbody> +</tgroup> +</informaltable> +</para> + + +</sect1> + +<sect1 id="konfig-useractions"> +<title +>UserActions</title> + +<para +>Here you can configure the Terminal for UserActions and the font for the output-collection. The default terminal is <filename +>konsole --noclose -e</filename +> To set up, configure and manage your UserActions use ActionMan (&useractions_lnk; url). </para> + + +<!-- OLD +<screenshot> + <screeninfo +>Useractions configuration</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="kguseractions.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="kguseractions.png" format="EPS"/></imageobject> + <textobject +><phrase +>Useractions configuration</phrase +></textobject> + <caption +><para +>Useractions configuration</para +></caption> + </mediaobject> +</screenshot> +--> + +<!--HTML_PARSING +<figure id="screenshot-kguseractions" float="1"> +<title +>Useractions configuration</title> +<mediaobject> +<imageobject +><imagedata fileref="kguseractions.png"/></imageobject> +<textobject +><phrase +>Useractions configuration</phrase +></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + + +</sect1> + +<sect1 id="konfig-protocols"> +<title +>Protocols</title> + +<para +>This page links the mimes to protocols. ⪚ protocol "tar" is linked to mime "application/x-tar".</para> + + +<!-- OLD +<screenshot> + <screeninfo +>Protocols configuration</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="kgprotocols.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="kgprotocols.png" format="EPS"/></imageobject> + <textobject +><phrase +>Protocols configuration</phrase +></textobject> + <caption +><para +>Protocols configuration</para +></caption> + </mediaobject> +</screenshot> +--> + +<!--HTML_PARSING +<figure id="screenshot-kgprotocols" float="1"> +<title +>Protocols configuration</title> +<mediaobject> +<imageobject +><imagedata fileref="kgprotocols.png"/></imageobject> +<textobject +><phrase +>Protocols configuration</phrase +></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + + +<para +>In the <guilabel +>Defined Links</guilabel +> you will see ⪚ <itemizedlist> + + <listitem +><para +>Iso</para> + <itemizedlist> + <listitem +><para +>application/x-iso</para +></listitem> + </itemizedlist> + </listitem> + + <listitem +><para +>krarc</para> + <itemizedlist> + <listitem +><para +>application/x-ace</para +></listitem> + <listitem +><para +>application/x-arj</para +></listitem> + <listitem +><para +>application/x-bzip2</para +></listitem> + <listitem +><para +>application/x-cpio</para +></listitem> + <listitem +><para +>application/x-deb</para +></listitem> + <listitem +><para +>application/x-debian-package</para +></listitem> + <listitem +><para +>application/x-gzip</para +></listitem> + <listitem +><para +>application/x-jar</para +></listitem> + <listitem +><para +>application/x-lha</para +></listitem> + <listitem +><para +>application/x-rar</para +></listitem> + <listitem +><para +>application/x-rpm</para +></listitem> + <listitem +><para +>application/x-zip</para +></listitem> + </itemizedlist> + </listitem> + + <listitem +><para +>tar</para> + <itemizedlist> + <listitem +><para +>application/x-tar</para +></listitem> + <listitem +><para +>application/x-tarz</para +></listitem> + <listitem +><para +>application/x-tbz</para +></listitem> + <listitem +><para +>application/x-tgz</para +></listitem> + </itemizedlist> + </listitem> + +</itemizedlist> + + +</para> + +</sect1> + +</chapter> diff --git a/doc/ru/krusader-tools.docbook b/doc/ru/krusader-tools.docbook new file mode 100644 index 0000000..118c9b8 --- /dev/null +++ b/doc/ru/krusader-tools.docbook @@ -0,0 +1,4254 @@ +<chapter id="krusader-tools"> + +<!-- ********************************************************************** + krusader-tools.docbook + ++++++++++++++++++++++++++ + (C)opyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + All Rights Reserved Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Инструменты &krusader;</title> + +<sect1 id = "remote-connections"> +<title +>Удаленные соединения</title> +<indexterm +><primary +>Удаленные соединения</primary +></indexterm> + +<para +>Удаленные соединения легко создаются набором &URL; в <link linkend="list_panel" +>Панели адреса</link +>, они работают в &kioslaves1_url;. Пожалуйста запомните, что в панели &krusader; не поддерживаются все &kioslaves2_url; например, <command +>http://</command +> не будет работать в <link linkend="krviewer" +>просмотрщике</link +>. Некоторые примеры:</para> + + <itemizedlist> + <listitem +><para +><userinput +><command +>ftp://</command +><replaceable +>public.ftpserver.org/directory/</replaceable +></userinput +></para> + </listitem> + + <listitem +><para +><userinput +><command +>fish://</command +><replaceable +>username@hostname/</replaceable +></userinput +></para> + </listitem> + + <listitem +><para +><userinput +><command +>sftp://</command +><replaceable +>username:[email protected]/</replaceable +></userinput +></para +> + </listitem> + + <listitem +><para +><userinput +><command +>ftp://</command +><replaceable +>[email protected]:21/directory/</replaceable +></userinput +></para> + </listitem +> + + <listitem +><para +><userinput +><command +>smb://</command +><replaceable +>username:password@server/share</replaceable +></userinput +></para> + </listitem> + + <listitem +><para +><userinput +><command +>ftp://</command +><replaceable +>username@proxyusername:password@proxipassword@hostname/directory</replaceable +></userinput +></para> + </listitem +> + </itemizedlist +> + + +<para +>Вы можете добавить эти &URL;'ы в закладки, прочитайте секцию <link linkend="bookman" +>Менеджер закладок</link +> относительно <emphasis +>безопасного сохранения паролей</emphasis +>. Для соединения с большим количеством адресатов добавьте &URL;'ы в закладки и открывайте их одну за одной в или откройте их одновременно, используя &panel_profiles_lnk;. Для переключения между адресами просто откройте &foldertabs_lnk; для каждой. </para> + +<para +>Есть три способа создания удаленного соединения: <itemizedlist> + <listitem +><para +>Введите &URL; в <link linkend="list_panel" +>панели адреса</link +></para> + </listitem> + + <listitem +><para +>Выберите <emphasis role="bold" +><menuchoice +><guimenu +>Команды</guimenu +> <guimenuitem +>Новое сетевое соединение</guimenuitem +></menuchoice +></emphasis +>, которое вызовет диалог с детальным описанием соединения. Этот диалог очень удобен, если вы не пробовали вписывать &URL;'ы в панели адреса. Пустые поля пароля и логина подразумевают анонимный вход. Примечание:мы планируем переписать этот диалог.</para> + </listitem> + + <listitem +><para +>Вы можете сделать закладку для каталога на удаленной машине и вернуться в этот каталог из менеджера закладок с помощью кнопки в верхнем углу вашей панели, как будто это обычный браузер.</para> + </listitem> +</itemizedlist> +</para> + +<para +>После регистрации на удаленном сервере вы можете просматривать его как локальный диск со следующими исключениями: <itemizedlist> + <listitem +><para +>Вы не можете запускать исполняемые файлы на удаленной машине.</para> + </listitem> + <listitem +><para +>Права доступа не всегда определяются на удаленном сервере (зависит от сервера и метода доступа) вы можете получить "?" в полях прав доступа для некоторых файлов. </para> + </listitem> + <listitem +><para +>Информация о использовании дискового пространства не доступна на удаленных файловых системах.</para> + </listitem> + </itemizedlist> +</para> + +<para +>Для выбора кодировки на удаленной машине используйте <emphasis role="bold" +><menuchoice +><guimenu +>Команды</guimenu +> <guimenuitem +>Выбрать кодировку</guimenuitem +></menuchoice +></emphasis +>.</para> + +<para +>Вы можете <emphasis role="bold" +>закрыть текущее активное удаленное соединение</emphasis +> несколькими способами: <itemizedlist> + <!-- + <listitem> + <para +>Manually: <emphasis role="bold" +><menuchoice +><guimenu +>Commands</guimenu> + <guimenuitem +>Disconnect From Net</guimenuitem +></menuchoice +></emphasis +></para> + </listitem> + --> + <listitem> + <para +>Вручную: добавить кнопку разъединения на &main_toolbar_lnk; и нажать её.</para> + </listitem> + + <listitem +><para +>Автоматически: выбрать &URL; в &location_toolbar_lnk;.</para> + </listitem> + </itemizedlist +> +</para> + +<note> + <para +>&krusader; - это файловый менеджер, который поддерживает удаленные соединения через &kioslaves1_url;, поэтому, если вы хотите получить больше возможностей для удаленных соединений мы рекомендуем, например, для &FTP; - использовать &kasablanca_url; или &kftpgrabber_url;.</para> + </note> + +</sect1> + +<sect1 id = "mount-man"> +<title +>Менеджер монтирования:работа с файловыми системами</title> +<indexterm +><primary +>Монтирование</primary +></indexterm> + +<para +>Менеджер монтирования это инструмент, который поможет вам управлять монтированием файловых систем. Еще он показывает список разделов, смонтированных в настоящее время. Для каждой файловой системы он показывает имя устройства( с его номером <filename class="directory" +>/dev/fd0</filename +> для <hardware +>флоппи</hardware +>), тип (vfat, ext3, ReiserFS ...) и точку монтирования в системе (директорию, в которой файловая система смонтирована).</para> + +<!-- OLD +<screenshot> + <screeninfo +>MountMan</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="mountman.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="mountman.png" format="EPS"/></imageobject> + <textobject +><phrase +>MountMan</phrase +></textobject> + <caption +><para +>MountMan</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-mountman" float="1"> +<title +>Менеджер монтирования</title> +<mediaobject> +<imageobject +><imagedata fileref="mountman.png"/></imageobject> +<textobject +><phrase +>Менеджер монтирования</phrase +></textobject> +</mediaobject> +</figure> + +<para +>Менеджер монтирования также показывает информацию о занятом/свободном месте на разделе и свободное пространство в процентах. Если эти цифры видны как <guilabel +>N/A</guilabel +>, значит раздел не смонтирован. Клик левой кнопкой мыши на на строке раздела покажет в окне слева от списка графическую диаграмму для выбранного раздела. Щелчок на не смонтированной файловой файловой системе покажет <guilabel +>not mounted</guilabel +>.</para> + <itemizedlist> + <listitem +><para +><keycap +>Двойной клик</keycap +> на файловой системе закроет Менеджер монтирования и откроет файловую систему в текущей панели внутри &krusader;. </para +></listitem> + <listitem +><para +><keycap +>Правый клик</keycap +> на файловой системе откроет в маленьком меню диалог с доступными для данной файловой системы действиями.Сейчас можно монтировать/отмонтировать и извлечь ( для <hardware +>cdrom</hardware +>). </para +></listitem> + </itemizedlist> + +<note +><para +>Мы планируем расширить Менеджер монтирования в дальнейшем развитии &krusader;. Будет добавлено форматирование для флоппи, редактирование <filename class="directory" +>/etc/fstab</filename +>, создание новых файловых систем и другое...Мы начали работу над этим</para +></note> + +<para +><emphasis role="bold" +>Быстрый режим для Менеджер монтирования</emphasis +></para> + +<para +>Для активации быстрого режима в Менеджер монтирования нажмите и удерживайте кнопку мыши на кнопке в &main_toolbar_lnk;</para> + +<para +>Основная идея: показывать список всех доступных точек монтирования. Каждый раз, когда показывается меню, определяется точка монтирования смонтирована или нет и связывается с верным действием (монтирование/отмонтирование). Это быстрый способ доступа к Менеджер монтирования.Он позволяет только монтировать и отмонтировать. В новом &kde; будет сервис для fstab и часть старого кода будет удалена из Менеджер монтирования.</para> + +</sect1> + + +<sect1 id = "bookman"> +<title +>Менеджер закладок: управление закладками</title> +<indexterm +><primary +>Закладки</primary +></indexterm> + +<para +>Менеджер закладок в &krusader; - это инструмент управления папками закладками, локальными и <link linkend="remote-connections" +>удаленными URL'ами</link +>, и дальнейший возврат их по щелчку мыши. Меню состоит их четырех секций: <itemizedlist> + <listitem +><para +>Персональные закладки.</para> + </listitem> + + <listitem +><para +>Наиболее часто посещяемые &URL;'ы.</para> + </listitem> + + <listitem +><para +>Неизменяемые закладки.</para> + </listitem> + + <listitem +><para +>Управление закладками.</para> + </listitem> + </itemizedlist> +</para> + +<note +><para +>Вы можете сделать закладку внутри удаленной файловой системы (&FTP; или SAMBA) и после использовать для быстрого доступа к удаленной машине, но НЕЛЬЗЯ сделать закладку внутри архива.</para +></note> + +<!-- OLD +<screenshot> + <screeninfo +>Bookmark menu</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="bookmanadd.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="bookmanadd.png" format="EPS"/></imageobject> + <textobject +><phrase +>BookMan: the Bookmark menu</phrase +></textobject> + <caption +><para +>Bookmark menu</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-bookmanadd" float="1"> +<title +>меню Закладки</title> +<mediaobject> +<imageobject +><imagedata fileref="bookmanadd.png"/></imageobject> +<textobject +><phrase +>меню Закладки</phrase +></textobject> +</mediaobject> +</figure> + + +<sect2 id = "using_bookmarks"> +<title +>Использование закладок</title> + +<para +>Обычно, вы нажимаете на кнопку <guibutton +>Закладка</guibutton +>, когда вы находитесь в целевом каталоге. Для примера создадим закладку для <filename class="directory" +>/usr/tmp</filename +>, переведем &krusader; в каталог и нажимаем кнопку <guibutton +>Закладки</guibutton +>. Затем в диалоговом окне <guilabel +>Добавить закладку</guilabel +> путь к &URL; <filename class="directory" +>/usr/tmp</filename +>. <guilabel +>Имя</guilabel +>, которое вы дадите закладке (например:временный каталог). Комбинации клавиш поддерживают добавление <literal +>&</literal +> в имя закладки, например <literal +>&sourceforge, &home, down&loads</literal +> &etc;, так вы можете быстро вызвать закладку, используя горячую клавишу <keycombo action="simul" +>&Alt;<keycap +>foo</keycap +></keycombo +>. Если вы добавите закладку не давая ей имени, она будет названа по пути к каталогу. <guilabel +>URL</guilabel +> являются именами закладок. <guilabel +>Создать в</guilabel +> создает папку закладок для упорядочивания ваших закладок.</para> + +<para +>Для использования закладок нажмите кнопку <guibutton +>Закладки</guibutton +> и выберите закладку.Вы также можете использовать &keybindigs_lnk;: <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>d</keycap +></keycombo +> для добавления закладки, <keycombo action="simul" +>&Alt;<keycap +>правая/левая стрелка</keycap +></keycombo +> для <keycap +>открытия правой/левой панели закладок</keycap +> и <keycombo action="simul" +>&Ctrl;<keycap +>d</keycap +></keycombo +> для открытия закладки в активной панели. A &MMB; откроет закладку в новой <link linkend="folder_tabs" +>вкладке</link +>. </para> + +<para +>Перемещение в закладках: <orderedlist> + <listitem> + <para +>начните печатать буквы</para> + </listitem> + + <listitem> + <para +>Например, если вы напечатали <literal +>'h'</literal +> и только одна закладка начинается с буквы <literal +>'h'</literal +>, откроется именно она - дальше ничего не нужно вводить</para> + </listitem> + + <listitem> + <para +>если более чем одна закладка начинается с буквы <literal +>'h'</literal +>, вы должны вводить дальше, пока не определится необходимая закладка.</para> + </listitem> + </orderedlist> +</para> + +</sect2> + + +<sect2 id = "password_handling"> +<title +>Обработка паролей</title> + +<para +>Одно из преимуществ <link linkend="bookman" +>управления закладками</link +> - это сохранение паролей средствами &kde;, когда, например ваши пароли сохранены в &konqueror;/&kmail;. Если вы имеете бумажник &kde;, сохраняйте пароли в нем. Выберите закладки, в диалоге вас спросят о пароле и имени. Введите их и нажмите 'сохранить пароль'. Пароли и имена будут сохранены в бумажнике &kde;( если это разрешено в вашем дистрибутиве). При переустановке, если вы не сохраните ваши пароли из бумажника как файл закладок &krusader;, они будут утеряны. </para> + +</sect2> + +<sect2 id = "popular_urls"> +<title +>Наиболее часто посещаемые</title> + +<para +>Подменю <guilabel +>Наиболее часто посещаемые</guilabel +> хранит самые посещаемые &URL;'ы (локальные или удаленные). Это подменю показывает список 15 самых посещаемых мест, сортированных по посещаемости. Это удобно, если нужно быстро найти часто посещаемое место, и не обязательно нужно делать для него &bookmarks_lnk;, он служит временным списком закладок. <guilabel +>Быстрый поиск</guilabel +> это легкий способ найти/выбрать необходимый &URL;: <itemizedlist> + <listitem +><para +>откройте <guilabel +>Наиболее часто посещаемые или</guilabel +> или используйте <keycombo action="simul" +>&Ctrl;<keycap +>z</keycap +></keycombo +> </para +></listitem> + <listitem +><para +>введите несколько букв для сужения критерия поиска </para +></listitem> + <listitem +><para +>жмите ввод (вы перейдете в список &URL;) </para +></listitem> + <listitem +><para +>жмите ввод снова и панель обновится</para +></listitem> + </itemizedlist> +</para> +</sect2> + + +<sect2 id = "permanent_bookmarks"> +<title +>Неизменяемые закладки</title> + +<para +>Эти жестко запрограммированные закладки в меню не нуждаются в сохранении в файл.В &context_menu_lnk; вы можете запретить/разрешить неизменяемые закладки. Доступные следующие неизменяемые закладки. Доступны следующие неизменяемые закладки: <itemizedlist> + <listitem +><para +><guilabel +>Носители</guilabel +> использует <link linkend="konfig-advanced" +>Протокол</link +> <filename +>media:/</filename +> из &kde;</para> + </listitem> + + <listitem +><para +><guilabel +>Локальная сеть</guilabel +> использует протокол &kde; <filename +>lan:/</filename +>. </para> + </listitem> + + <listitem +><para +><guilabel +>Виртуальная файловая система</guilabel +> &vfs_lnk; <filename +>virt:/</filename +> - это не виртуальная папка, а только контейнер для &URL;'ов из различных файловых систем. Она используется например для <guilabel +>Поместить на панель</guilabel +> в модуле поиска и синхронизаторе. Панель адреса отобразит, например так :<filename +>virt:/Результаты поиска 1</filename +> или <filename +>virt:/Результаты синхронизации 1</filename +>. </para +></listitem> + + <listitem id= "jump_back" +><para +><guilabel +>Вернуться</guilabel +> или <keycombo action="simul" +>&Ctrl;<keycap +>J</keycap +></keycombo +> позволяет вернуться на начальную позицию, когда вы создаете новую вкладку в панели. Эта возможность очень удобна - если вы находитесь глубоко внутри дерева каталогов можно вернуться на один шаг назад. <guilabel +>Установить точку возврата</guilabel +> или <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>J</keycap +></keycombo +> установит текущую директорию как точку возврата.</para> + </listitem> + </itemizedlist> +</para> +</sect2> + + +<sect2 id = "manage_bookmarks"> +<title +>Управление закладками</title> + +<para +>Чтобы редактировать и настраивать ваши закладки нажмите кнопку <guibutton +>Закладки</guibutton +> и выберите меню <guimenuitem +>Управление закладками</guimenuitem +>, будет вызван Редактор закладок. Здесь вы можете редактировать/удалять и переназначать закладки. Редактор закладок (часть базового пакета КДЕ) - используется дляr &konqueror;, &krusader; и других приложений по стандарту &xbel_url; для формата закладок. Закладки сохраняются в файле <filename +>~/.kde/share/apps/krusader/krbookmarks.xml.</filename +></para> + <para +>Вы можете импортировать закладки из <application +>IE</application +>, <application +>Opera</application +>, <application +>Galeon</application +>, &kde;, <application +>Mozilla</application +>, &Netscape;. &keditbookmarks; - это легко сделать, прочитайте руководство Редактора закладок или &konqueror; если хотите узнать больше.</para> + +<!-- OLD +<screenshot> + <screeninfo +>&keditbookmarks; Bookmark Manager</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="bookmanedit.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="bookmanedit.png" format="EPS"/></imageobject> + <textobject +><phrase +>&keditbookmarks; edit and organize your Bookmarks</phrase +></textobject> + <caption +><para +>&keditbookmarks;: Bookmark Manager.</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-bookmanedit" float="1"> +<title +>Редактор закладок</title> +<mediaobject> +<imageobject +><imagedata fileref="bookmanedit.png"/></imageobject> +<textobject +><phrase +>Редактор закладок</phrase +></textobject> +</mediaobject> +</figure> + + + +</sect2> + +<sect2 id = "bookmark_buttons"> +<title +>Закладки - это кнопка управления на панели</title> + +<para +>Кнопка закладки может быть помещена на &main_toolbar_lnk; или на &actions_toolbar_lnk;, в дальнейшем вы можете назначить сочетание клавиш для неё. <itemizedlist> + <listitem +><para +>создайте ваши &bookmarks_lnk; . </para +></listitem> + <listitem +><para +>Если вы хотите, создайте сочетание клавиш для вызова закладок в секции <guilabel +>Сочетания клавиш</guilabel +> в &konfiglookandfeel_lnk; . </para +></listitem> + <listitem +><para +>Добавьте кнопку на &main_toolbar_lnk; или &actions_toolbar_lnk; используя секцию<guilabel +>Панель</guilabel +> &konfiglookandfeel_lnk; . </para +></listitem> + </itemizedlist> +</para> +</sect2> + +</sect1> + + +<sect1 id = "krusearcher"> +<title +>Krusader::Поиск: найдет то, что вы ищете</title> +<indexterm +><primary +>Поиск</primary +></indexterm> + +<para +>Добро пожаловать в многофункциональный модуль поиска, называемый Krusader::Поиск. Он является наиболее мощным(насколько мы знаем) инструментом для поиска в &Linux;, и дает несколько различных способов для быстрого поиска файлов. Функция поиска также доступна для удаленных файловых систем. Поиск разделен на два уровня : основной и дополнительный. Посмотрим на основную страницу...</para> + +<!-- OLD +<screenshot> + <screeninfo +>Krusearcher General</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="search_general.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="search_general.png" format="EPS"/></imageobject> + <textobject +><phrase +>Krusearcher General</phrase +></textobject> + <caption +><para +>Krusearcher General.</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-search-general" float="1"> +<title +>Основной поиск</title> +<mediaobject> +<imageobject +><imagedata fileref="search_general.png"/></imageobject> +<textobject +><phrase +>Основной поиск</phrase +></textobject> +</mediaobject> +</figure> + + +<para +>Страница разделена на четыре части: верхняя (фильтр) часть,нижняя часть - названная 'Содержащие текст', левая часть - 'Искать в ' и правая - 'не искать в'. Очевидно, что каждая часть предоставляет различные способы поиска.</para> + +<itemizedlist +><title +>Верхняя часть:</title> + <listitem +><para +><guilabel +>Фильтр</guilabel +>: здесь вы можете задать критерий поиска. Здесь вы можете ввести имя файла, символ (<literal role="extension" +>*.o.*</literal +>, <literal role="extension" +>*.c</literal +> &etc;) или оба - разделенные пробелом. Если вы ввели <literal +>'text'</literal +> то результаты будут подобны <literal +>'*text*'</literal +>. Вы можете исключить из поиска файлы используя '|' ( например <literal role="extension" +>'*.cpp *.h | *.moc.cpp'</literal +> ). </para +></listitem> + <listitem +><para +><guilabel +>С учетом регистра</guilabel +>: отмена этого позволит искать в верхнем и нижнем регистре (например : <literal role="extension" +>*.c</literal +> интерпретируется как <literal role="extension" +>*.c</literal +> и <literal role="extension" +>*.C</literal +>). </para +></listitem> + <listitem +><para +><guilabel +>Типы</guilabel +>: это меню позволяет искать файлы по содержимому. Например, вы можете искать все файлы аудио, которые начитаются с буквы Б. Обычно эта опция выставлена по умолчанию на 'все файлы', но вы можете выбирать поиск для архивов, каталогов, графических и текстовых файлов, видео и аудио файлов. </para +></listitem> +</itemizedlist> + +<itemizedlist +><title +>Левая и правая части:</title> + <listitem +><para +><guilabel +>Искать в</guilabel +> и <guilabel +>Не искать в</guilabel +>: используя эти две части вы можете уточнить путь поиска методом исключения. Например, вы можете искать файл в всей файловой системе ( начиная с <filename +>/</filename +>), но исключив поиск внутри <filename +>/mnt</filename +>. Все что нужно - это вписать <filename +>/</filename +> в поле <guilabel +>Искать в</guilabel +> и <filename +>/mnt</filename +> в поле <guilabel +>Не искать в</guilabel +>. Если вы хотите вписать более чем один каталог, просто нажмите ввод когда напишите первый. Имя каталога копируется в большое поле и можно вписывать следующее имя. <note +><para +>Поле ввода делает автоматическое дополнение, используя глобальные настройки &kde;. Если хотите, можете щелкнуть по <guiicon +>иконке папки</guiicon +> и просмотреть каталог, который хотите добавить. </para +></note> + </para +></listitem> +</itemizedlist> + +<itemizedlist +><title +>Нижняя часть:</title> + <listitem +><para +><guilabel +>Текст</guilabel +>: по введенному здесь тексту &krusader; проведет поиск внутри файлов (<command +>grep</command +>). Таким способом вы можете найти внутри всех файлах заголовков (<literal role="extension" +>*.h</literal +>) слово <literal +>'testing 123'</literal +>. </para +></listitem> + <listitem +><para +><guilabel +>Выбирайте только полное слово</guilabel> + </para +></listitem> + <listitem +><para +><guilabel +>С учетом регистра</guilabel +>: поиск будет производится ссылаясь на ваш текст по верхнему/нижнему регистру или по фразе, которою вы ввели. </para +></listitem> + <listitem +><para +><guilabel +>Искать в подкаталогах</guilabel +>: произведет рекурсивный поиск и внутри каталога, по указанному пути. </para +></listitem> + <listitem +><para +><guilabel +>Искать в архивах</guilabel +>: &krusader; будет искать внутри поддерживаемых архивов. Однако это очень продолжительная операция. <note +><para +>Если поставите здесь отметку, появится уведомление о невозможности использования <command +>grep</command +> внутри файлов. Это сделано потому что &krusader; распаковывает архивные файлы перед поиском, в результате на это уходит много времени.</para +></note> + </para +></listitem> + <listitem +><para +><guilabel +>Следовать по ссылкам</guilabel +>: если это установлено, &krusader; будет следовать по мягким ссылкам во время поиска. </para +></listitem> + <listitem +><para +><guilabel +>Профили</guilabel +>: если вы часто производите одинаковый поиск, например, внутри включая или исключая файлы и т.д., можно сохранить настройки. Нажмите кнопку 'Профили' и добавляйте/загружайте/удаляйте профили поиска. </para +></listitem> +</itemizedlist> + +<para +>Снимок экрана вверху показывает поиск файлов с окончанием <literal role="extension" +>c, cpp</literal +> или <literal role="extension" +>h</literal +> и включая строку <literal +>'testing 123'</literal +>. &krusader; будет искать в <filename class="directory" +>/root, /opt, /bin</filename +> и <filename class="directory" +>/usr</filename +>, не будет искать в <filename class="directory" +>/usr/lib</filename +> и <filename class="directory" +>/usr/share</filename +>. </para> + +<para +>Нажатие кнопки <guibutton +>Поиск</guibutton +> запустит поиск и покажет результат на странице результатов. Во время поиска вы можете нажать кнопку <guibutton +>Стоп</guibutton +> и остановить поиск. Кнопка <guibutton +>Закрыть</guibutton +> не доступна во время поиска. Сначала нужно остановить поиск и потом <guibutton +>Закрыть</guibutton +> окно. Когда поиск будет окончен, двойной щелчок в нем переведет активную панель в точку расположения найденных файлов. Только не закрывайте окно поиска, так будут доступны другие результаты поиска.</para> + +<para +>Иногда бывает нужно сузить параметры поиска. Это можно сделать с помощью вкладки <guilabel +>Дополнительно</guilabel +>...</para> + +<!-- OLD +<screenshot> + <screeninfo +>Krusearcher Advanced</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="search_advanced.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="search_advanced.png" format="EPS"/></imageobject> + <textobject +><phrase +>Krusearcher Advanced</phrase +></textobject> + <caption +><para +>Krusearcher Advanced.</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-search-advanced" float="1"> +<title +>Расширенный поиск</title> +<mediaobject> +<imageobject +><imagedata fileref="search_advanced.png"/></imageobject> +<textobject +><phrase +>Расширенный поиск</phrase +></textobject> +</mediaobject> +</figure> + + +<para +>Этот снимок экрана показывает поиск для файлов размером между 10KB и 150KB, которые изменялись между 10 октября и 1 ноября, принадлежащих любому пользователю в группе 'пользователи' и доступным для чтения/записи каждому в группе, но только для чтения всем остальным.</para> + +<para +>Страница расширенного поиска разделена на три части: размер, дата и владелец.</para> + +<para +><emphasis role="bold" +>Размер</emphasis +></para> + +<para +>Позволяет выбрать диапазон размера файла. Можно искать меньше чем ХХХ байт (или Кб, Мб), больше чем ХХХ байт, или, при выборе обоих параметров меньше чем ХХХ и больше чем YYY.</para> + + +<para +><emphasis role="bold" +>Дата</emphasis +></para> + +<para +>Эта часть предлагает три различных пути определения даты: <itemizedlist> + <listitem +><para +><guilabel +>Изменявшееся между</guilabel +>: вводятся две даты. &krusader; бдует искать файлы между этими датами, включая их самих. Если вы установите дату только в левое поле будет поиск файлов старее этой даты. Соответсвенно если установите дату в правом поле - новее этой даты. <note +><para +>Можно щелкнуть по иконке даты (рядом с полем ввода) - откроется стандартное окно даты - найдите свою дату в календаре. Щелчок по дате закроет окно и введет дату в соответствующее поле ввода даты. </para +></note> + </para +></listitem> + <listitem +><para +><guilabel +>Не изменявшееся после</guilabel +>: выбор этой опции заставит &krusader; искать файлы, которые не изменялись после указанной даты, что равнозначно поиску файлов старее этой же даты. </para +></listitem> + <listitem +><para +><guilabel +>Изменялись за последние/Не изменялись за последние</guilabel +>: в этих полях вводите не дату а только числа. Эти числа представляют дни/недели/месяцы (как выбрано в выпадающем списке). Введение цифры 5 в верхнем поле заставит &krusader; искать файлы изменявшиеся в течение последних пяти дней. Введение цифры 2 в нижнем поле ввода вызовет поиск файлов не изменявшихся за последние два дня. Комбинация обоих результатов даст в сумме поиск для файлов, которые изменялись в течение пяти последних дней и не изменялись за два последних дня. </para +></listitem> +</itemizedlist +></para> + + +<para +><emphasis role="bold" +>Владелец</emphasis +></para> + +<itemizedlist> + <listitem +><para +><guilabel +>Принадлежит пользователю/группе</guilabel +>: при выборе этих опций вы сможете искать файлы, принадлежащие определенным пользователям/группам. В выпадающем списке показаны все пользователи и группы в вашей системе, только выберите необходимое. </para +></listitem> + <listitem +><para +><guilabel +>Права</guilabel +>: делится на владельца, группу и всех - поиск по правам доступа к файлам. Вы можете искать по правам доступа в любой комбинации. Знак вопроса (?) - это шаблонный символ - с ним действительны любые права доступа. </para +></listitem> +</itemizedlist> + +<note +><para +>Снимок экрана вверху (раздел права доступа) поясняет поиск файлов, которые принадлежат любому пользователю в группе 'users', доступны для чтения, записи, не исполняемые и с неизвестен их владелец.</para +></note> + +<para +><emphasis role="bold" +>Результаты</emphasis +></para> + +<para +>Нажатие на кнопку <guibutton +>Поиск</guibutton +> запустит поиск и откроется окно результатов поиска.Здесь вы можете наблюдать за процессом поиска и результат выполненого действия. Если хотите отменить выполняемый поиск, нажмите кнопку<guibutton +>Стоп</guibutton +>. В списке результатов поиска выберите файл и нажмите <keycap +>F3</keycap +>/<keycap +>F4</keycap +> для просмотра/редактирования или используйте контекстное меню. Когда вы щелкните на найденном элементе, текущая активная панель переместится на каталог с файлом, если он не в текущем каталоге активной вкладки. Когда вы закроете окно поиска, выбранный элемент будет в активной панели.</para> + +<para +><emphasis role="bold" +>Поместить на панель</emphasis +></para> + +<para +>Когда вы нажмете кнопку <guibutton +>Поместить на панель</guibutton +> результаты поиска будут помещены на вкладку результаты поиска. &krusader; попросит ввести имя, оно будет использовано для вкладки.Вы можете помещать необходимые файлы в новую вкладку.Панель адреса покажет, например <filename +>virt:/Резульаты поиска 1</filename +>.</para> + +<warning +><para +>Файлы на вкладке результатов фактически и есть реальные файлы.Если вы удалите их - удалятся и реальные файлы!</para +></warning> + +</sect1> + +<sect1 id="locate"> +<title +>Размещение - графическая оболочка</title> + +<para +>&krusader; имеет графическую оболочку для команды <command +>locate</command +> (findutils). Locate используется для быстрого поиска файлов. Она не ищет в каталоге, только в базе данных. Пакет содержит два файла <command +>locate</command +> и <command +>updatedb</command +>. Updatedb осматривает локальную файловую систему и сохраняет файл внутри базы данных. Часто <command +>cron</command +> вызывает <command +>updatedb</command +> каждую ночь (установки в Kcron). Выберите <emphasis role="bold" +><menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>Размещение</guimenuitem +></menuchoice +></emphasis +> или <keycombo action="simul" +>&Ctrl;<keycap +>L</keycap +></keycombo +>. <link linkend="konfig-advanced" +>Настроить Крусадер</link +> устанавливает дополнительные аргументы для команды <command +>updatedb</command +>. </para> + +<para +>Опции <itemizedlist> + <listitem +><para +><guilabel +>Показывать только существующие файлы</guilabel +>: если база содержит данные о файлах, которые больше не существуют (удалены, перемещены после последней <command +>updatedb</command +>), <command +>locate</command +> не покажет их. Эта операция проверит каждый файл перед выводом результатов поиска (медленно).</para> + </listitem> + <listitem +><para +><guilabel +>С учетом регистра</guilabel +>: снимите отметку для поиска в верхнем и нижнем регистре одновременно.</para> + </listitem> +</itemizedlist +></para> + +<para +>Кнопки действий <itemizedlist> + <listitem +><para +><guibutton +>Locate</guibutton +>: выполнит <command +>locate <replaceable +>foo foo</replaceable +></command +> и поместит вывод в окно результатов поиска.</para +></listitem> + <listitem +><para +><guibutton +>Stop</guibutton +>: остановит выполнение locate.</para +></listitem> + <listitem +><para +><guibutton +>Обновить DB</guibutton +>: запуск команды <command +>updatedb</command +> после введения пароля суперпользователя.</para +></listitem> + <listitem +><para +><guibutton +>Закрыть</guibutton +>: закроет окно Размещения.</para +></listitem> +</itemizedlist> +</para> + +<para +>Окно результатов <itemizedlist> + <listitem +><para +>двойной щелчок на элементе: перейти в каталог, сделать элемент видимым и закрыть диалог размещения.</para> + </listitem> + + <listitem +><para +>правый клик: меню правка/просмотр/поиск. <itemizedlist> + <listitem +><para +><keycap +>F3</keycap +>: просмотр текущего элемента.</para +></listitem> + <listitem +><para +><keycap +>F4</keycap +>: редактирование текущего элемента.</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>f</keycap +></keycombo +>: поиск файлов в окне результатов.</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>n</keycap +></keycombo +>: следующий результат поиска.</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>p</keycap +></keycombo +>: предыдущий результат поиска.</para +></listitem> + </itemizedlist> + + </para +></listitem> + +</itemizedlist> + +</para> + +</sect1> + + + + +<sect1 id = "krviewer"> +<title +>KrViewer: внутренний просмотрщик-редактор</title> +<indexterm +><primary +>Просмотрщик</primary> + <seealso +>Редактор</seealso> +</indexterm> + +<para +>Нажатие &Enter; на выделенном файле <emphasis +>откроет файл в связанном с ним приложении</emphasis +>. Редактор/просмотрщик имеет многотабовый интерфейс, настройка в &konfiggereral_lnk; </para> + +<sect2 id = "krview"> +<title +>Просмотрщик</title> + +<para +>Внутренний просмотрщик &krusader; вызывается по <keycap +>F3</keycap +>. Он открывает файл быстро и с определением по содержимому . Просмотрщик - это часть &konqueror; и умеет работать с типами файлов (например, показывать изображения, проигрывать музыкальные файлы и просматривать содержимое архивов). Это доступно в режиме 'Основной просмотрщик'. Вы должны настроить привязки файлов для этого режима.</para> + +<para +>Просмотрщик работает следующим образом: <itemizedlist +> <listitem +><para +>Сначалаон пробует открыть файл в <emphasis +>'Основной просмотрщик'.</emphasis +> </para +></listitem +> <listitem +><para +>Когда тип файла (mimetype) не определяется или файл ( например приложение ) не связан ни с каким действием он не откроется в'Основном просмотрщике'. Файл будет обработан, как текстовый, в <emphasis +>'Текстовом просмотрщике'</emphasis +>. </para +></listitem +> <listitem +><para +>Пользователь может выбирать в <link linkend="kredit_krviewer_menu" +> меню KrViewer </link +> между: 'Основной просмотрщик' (если доступно), 'Текстовый просмотрщик' и <emphasis +>'Просмотрщик Hex'</emphasis +>. </para +></listitem +> </itemizedlist +> Режим по умолчанию настраивается в &konfiggereral_lnk; . </para> + +<para +><keycombo action="simul" +>&Shift;<keycap +>F3</keycap +></keycombo +>просмотреть &URL; по запросу, например: <itemizedlist> + <listitem +><para +><userinput +><command +>man:/</command +></userinput +> просмотр страниц руководства. </para +></listitem> + <listitem +><para +><userinput +><command +>man:/</command +><replaceable +>krusader</replaceable +></userinput +> покажет страницу руководства. </para +></listitem> + <listitem +><para +><userinput +><command +>info:/</command +></userinput +> просмотр страниц инфо. </para +></listitem> + <listitem +><para +><userinput +><command +>http://</command +><replaceable +>krusader.sourceforce.net/</replaceable +></userinput +> просмотр сайта. </para +></listitem> + <listitem +><para +><userinput +><command +>ftp://</command +><replaceable +>ftp.kde.org/pub/kde/</replaceable +></userinput +> просмотр сервера FTP. </para +></listitem> + <listitem +><para +><userinput +><command +>sftp://</command +><replaceable +>sftp.foo/</replaceable +></userinput +> просмотр защищенного сервера FTP. </para +></listitem> + <listitem +><para +><userinput +><command +>file:/</command +><replaceable +>home/frank</replaceable +></userinput +> просмотр домашнего каталога Франка. </para +></listitem> + <listitem +><para +><userinput +><replaceable +>/home/frank/archive.tar.gz</replaceable +></userinput +> просмотр архива <literal role="extension" +>tar.gz</literal +>. </para +></listitem> + </itemizedlist> +</para> + +<para +>KrViewer состоит из следующих меню: <link linkend="kredit_file_menu" +>Файл</link +>, <link linkend="kredit_edit_menu" +>Правка</link +>, <link linkend="kredit_view_menu" +>Вид</link +>, <link linkend="kredit_settings_menu" +>Настройки</link +> и <link linkend="kredit_krviewer_menu" +>Krviewer</link +>, в зависимости от того, какой тип файла просматривается. Это обсуждается в <link linkend="kredit" +>Разделе редактирование</link +>. Внутренний просмотрщик может переходить по ссылкам на HTML странице. <keycombo action="simul" +>&Ctrl;<keycap +>E</keycap +></keycombo +> запустит внутренний редактор &krusader;. </para> + +<note +><para +>Встроенный просмотрщик написан не нами, это часть библиотек &kde; и &kioslaves1_url;. Мы не можем и не хотим переписать его, к тому же использование готовых библиотек позволило уменьшить количество исходных кодов.Мы не изобретаем колесо ;-)</para +></note> +</sect2> + +<sect2 id="kredit"> +<title +>Редактор</title> + +<para +>Встроенный редактор &krusader; имеет все,что вы ожидаете от текстового редактора. Редактирование, подобно просмотру вызывается клавишей <keycap +>F4</keycap +>. По умолчанию используется встроенный редактор. Вы можете выбрать другой в &konfiggereral_lnk;, если вы предпочитаете использовать внешний редактор.</para> + +<tip +><para +>Если вы впервые используете встроенный редактор, рекомендуем посмотреть секцию <link linkend="kredit_settings_menu" +>Настройки</link +> в меню и настроить его удобным для вас способом. </para +></tip> + +</sect2> + +<sect2 id="kredit_menus"> +<title +>Обзор меню</title> +<para +>Большинство меню легкодоступны. ;-)</para> + +<!-- FILE menu --> +<variablelist id="kredit_file_menu" +><title +>меню <guimenu +>Файл</guimenu +></title> + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +></shortcut +> <guimenu +>Файл</guimenu +> <guimenuitem +>Сохранить</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Сохранить файл.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Файл</guimenu +> <guimenuitem +>Сохранить как</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Сохранить файл с другим именем.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycap +>F5</keycap +></shortcut +> <guimenu +>Файл</guimenu +> <guimenuitem +>Обновить</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Обновить файл.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Файл</guimenu +> <guimenuitem +>Экспорт</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Экспорт в формат <literal role="extension" +>html</literal +>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +></shortcut +> <guimenu +>Файл</guimenu +> <guimenuitem +>Печать</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Печать файла.</para> + </listitem> + </varlistentry> +</variablelist> + +<!-- EDIT menu --> +<variablelist id="kredit_edit_menu" +><title +>меню <guimenu +>Правка</guimenu +></title> + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Отменить действие</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Отменить предыдущее действие.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Повторить</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Повторить предыдущее действие.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Вырезать</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Вырезать выбранный текст в буфер.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Копировать</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Копировать выбранный текст в буфер.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Вставить</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Вставить содержимое буфера в документ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>A</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Выбрать все</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Выбрать весь документ.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>A</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Снять выделение</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Снять текущие выделение.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>B</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Block Selection Mode</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Toggle Block Selection, this will activate/deactivate the block selection possibility.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycap +>Insert</keycap +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Режим замены</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Переключение режима вставки/замены.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Поиск</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Искать текст.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F3</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Найти текст</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Искать следующий текст.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Shift;<keycap +>F3</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Найти предыдущий</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Искать предыдущий текст.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Заменить</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Заменить текст.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>G</keycap +></keycombo +></shortcut +> <guimenu +>Правка</guimenu +> <guimenuitem +>Перейти на строку</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Перейти к строке.</para> + </listitem> + </varlistentry> +</variablelist> + +<!-- VIEW menu --> +<variablelist id="kredit_view_menu" +><title +>Меню <guimenu +>Вид</guimenu +></title> + <varlistentry> + <term> + <menuchoice +><shortcut +><keycap +>F7</keycap +></shortcut +> <guimenu +>Вид</guimenu +> <guimenuitem +>Переключиться в командную строку.</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Показать командную строку.</para +> <!-- TODO --> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Вид</guimenu +> <guimenuitem +>Схема.</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Установка схемы, например &krusader; Normal, &krusader; Printing, &kate; Normal, &kwrite; Normal.</para +> <!-- TODO --> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycap +>F10</keycap +></shortcut +> <guimenu +>Вид</guimenu +> <guimenuitem +>Динамический перенос строк</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Переходить на следующую строку, когда превышается максимальное количество знаков в строке ( умолчание - 80 ).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Вид</guimenu +> <guimenuitem +>Индикаторы динамического переноса строк</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Off, Follow Line Numbers, Always On.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>View</guimenu +> <guimenuitem +>Show Static Word Wrap marker</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para +> <!-- TODO --> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycap +>F6</keycap +></shortcut +> <guimenu +>Вид</guimenu +> <guimenuitem +>Показывать отметки</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Показывать отметки.</para +> <!-- TODO --> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycap +>F11</keycap +></shortcut +> <guimenu +>Вид</guimenu +> <guimenuitem +>Показывать номера строк</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Показывать номера строк.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Вид</guimenu +> <guimenuitem +>Показывать отметки на полосе прокрутки.</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycap +>F9</keycap +></shortcut +> <guimenu +>Вид</guimenu +> <guimenuitem +>Скрыть полосу сворачивания блоков</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para +> <!-- TODO --> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Вид</guimenu +> <guimenuitem +>Сворачивание блоков кода.</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para +> <!-- TODO --> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Вид</guimenu +> <guimenuitem +>Кодировка</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Например ISO8859-1, utf8, utf16, tscii, ... .</para> + </listitem> + </varlistentry> +</variablelist> + +<!-- BOOKMARKS menu --> +<variablelist id="kredit_bookmarks_menu" +><title +>меню <guimenu +>Закладки</guimenu +></title> + <varlistentry> + <term +> <!-- TODO --> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +></shortcut +> <guimenu +>Закладка</guimenu +> <guimenuitem +>Поставить закладку</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Закладки</guimenu +> <guimenuitem +>Убрать все закладки</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + +<!-- These enties are gone on my system with kde3.3.2 + +<varlistentry> + <term> + <menuchoice> + <shortcut +><keycombo action="simul" +>&Alt;<keycap +>PageDown</keycap +></keycombo +></shortcut> + <guimenu +>Bookmark</guimenu> + <guimenuitem +>Next Bookmark</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Go to the next Bookmark.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice> + <shortcut +><keycombo action="simul" +>&Alt;<keycap +>PageUp</keycap +></keycombo +></shortcut> + <guimenu +>Bookmark</guimenu> + <guimenuitem +>Previous Bookmark</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Go to the previous Bookmark.</para> + </listitem> + </varlistentry> +--> + +</variablelist> + + +<!-- TOOLS menu --> +<variablelist id="kredit_tools_menu" +><title +>меню <guimenu +>Инструменты</guimenu +></title> + <varlistentry> + <term> + <menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>Режим 'Только для чтения'</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>Тип файла</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>Подсветка</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Подсветка для скриптов, языков программирования, макросов, например <literal role="extension" +>html, Bash, C++, XML, Makefile, Diff, ...</literal +> .</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>Конец строки</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Выбор окончания строки: &UNIX;, &Windows;/DOS, <trademark class="registered" +>Macintosh</trademark +>.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>I</keycap +></keycombo +></shortcut +> <guimenu +>Инструменты</guimenu +> <guimenuitem +>Вставить отступ</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para +> <!-- TODO--> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>I</keycap +></keycombo +></shortcut +> <guimenu +>Инструменты</guimenu +> <guimenuitem +>Снять отступ</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para +> <!-- TODO--> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>Clean Indendation</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para +> <!-- TODO--> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>D</keycap +></keycombo +></shortcut +> <guimenu +>Инструменты</guimenu +> <guimenuitem +>Закомментировать</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Добавить подходящие теги комментариев, если доступно.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>D</keycap +></keycombo +></shortcut +> <guimenu +>Инструменты</guimenu +> <guimenuitem +>Раскомментировать</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Удалить теги комментариев.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>U</keycap +></keycombo +></shortcut +> <guimenu +>Инструменты</guimenu +> <guimenuitem +>ВЕРХНИЙ РЕГИСТР</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>U</keycap +></keycombo +></shortcut +> <guimenu +>Инструменты</guimenu +> <guimenuitem +>Нижний регистр</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Alt;&Ctrl;<keycap +>U</keycap +></keycombo +></shortcut +> <guimenu +>Инструменты</guimenu +> <guimenuitem +>Как в предложениях</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>J</keycap +></keycombo +></shortcut +> <guimenu +>Инструменты</guimenu +> <guimenuitem +>Объединить строки</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>Перенос строк в документе</guimenuitem +></menuchoice +></term> + <listitem> + <para +></para +> <!-- TODO--> + </listitem> + </varlistentry> +</variablelist> + + +<!-- SETTINGS -> CONFIGURE EDITOR menu --> +<variablelist id="kredit_settings_menu" +><title +> меню <guimenu +>Настройки -> Настроить редактор</guimenu +> </title> + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Цвета</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Настройка цвета для: фона, выбранного текста, текущей строки и подсветка скобок.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Шрифты</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Настройка шрифтов для монитора и принтера: шрифт, тип и размер, с окном предпросмотра.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Indentation</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Indentation configuration: Automatically indent, use Spaces to indent, 	 Keys indent, &Backspace; key unindents, keep indent profile, keep extra spaces.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Selection</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Selection configuration: Persistent selections, Overwrite selected text.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Редактирование</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Настройка редактирования: настройка переноса строк, пробелов, автоскобки, максимальное количество шагов отмены.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Сочетания клавиш</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Настройка сочетаний клавиш.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Подсветка</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Настройка подсветки: нет и режимы подсветки.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Внешний вид</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Внешний вид: Динамический перенос строк, показывать номера строк, показывать отметки, показывать полосу сворачивания блоков(если поддерживается).</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Настроить редактор</guimenuitem +> <guimenuitem +>Модули</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Настройка модулей, например kTexteditor - встроенный модуль поиска, kTexteditor - модуль вставки файла...</para> + </listitem> + </varlistentry> +</variablelist> + +<!-- KRVIEWER menu --> +<variablelist id="kredit_krviewer_menu" +><title +> меню <guimenu +>KrViewer</guimenu +></title> + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>G</keycap +></keycombo +></shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Основной просмотрщик</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Встроенный просмотрщик &krusader; - это часть Konqueror, который умеет, например показывать изображения, проигрывать музыкальные файлы, показывать содержимое архивов.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>T</keycap +></keycombo +></shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Текстовый просмотрщик</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Просмотр файла в текстовом режиме.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>H</keycap +></keycombo +></shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Просмотрщик Hex</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Просмотр файла в Hex режиме.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>E</keycap +></keycombo +></shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Текстовый редактор</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Редактирование файла в текстовом режиме.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Alt;<keycap +>Вправо</keycap +></keycombo +></shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Следующая вкладка</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Следующая открытая вкладка.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Alt;<keycap +>Влево</keycap +></keycombo +></shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Предыдущая вкладка</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Предыдущая открытая вкладка.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>D</keycap +></keycombo +></shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Отделить вкладку</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Отделить вкладку и открыть в новом окне.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +>&Esc;</shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Закрыть текущую вкладку.</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Закрыть текущую просматриваемую вкладку.</para> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <menuchoice +><shortcut +>&Ctrl;<keycap +>Q</keycap +></shortcut +> <guimenu +>KrViewer</guimenu +> <guimenuitem +>Закрыть</guimenuitem +></menuchoice +></term> + <listitem> + <para +>Закрыть окно редактора/просмотрщика &krusader;.</para> + </listitem> + </varlistentry> +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="synchronizer"> +<title +>Синхронизатор</title> +<indexterm +><primary +>Синхронизатор</primary +></indexterm> + +<para +>Это функция сравнения каталогов левой и правой панели и представления различий между ними. После выбора опций и выполнения <guilabel +>сравнить</guilabel +> файлы и каталоги будут синхронизированы. Одна из панелей может быть сервером &FTP;. Только не забудьте опцию <guilabel +>сравнить по содержимому</guilabel +>, если файлы одинакового размера. Выберите <emphasis role="bold" +><menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>Синхронизировать каталоги</guimenuitem +></menuchoice +></emphasis +> или <keycombo action="simul" +>&Ctrl;<keycap +>Y</keycap +></keycombo +> для выполнения этой операции .<link linkend="konfig-color" +>Цвета</link +> настраиваются.</para> + +<note +><para +>Для локальных файлов: синхронизатор изменит информацию о дате на исходную.</para +></note> + +<!-- OLD +<screenshot> + <screeninfo +>Synchronizer</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="syncdir.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="syncdir.png" format="EPS"/></imageobject> + <textobject +><phrase +>Synchronizer: Synchronize files and directories.</phrase +></textobject> + <caption +><para +>Synchronizer: Synchronize files and directories.</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-syncdir" float="1"> +<title +>Синхронизатор</title> +<mediaobject> +<imageobject +><imagedata fileref="syncdir.png"/></imageobject> +<textobject +><phrase +>Синхронизатор</phrase +></textobject> +</mediaobject> +</figure> + + +<para> + <orderedlist +><title +>Процедура:</title> + <listitem +><para +>Установите <guilabel +>Левый каталог</guilabel +> и <guilabel +>Правый каталог</guilabel +>.</para> + </listitem> + <listitem +><para +>Настройте по необходимости <guilabel +>Файловый фильтр</guilabel +>, <guilabel +>Основные</guilabel +> и <guilabel +>Дополнительно</guilabel +>. <guilabel +>Основные</guilabel +> включают опцию <guilabel +>не искать в</guilabel +>, которая позволяет исключить каталоги. </para> + </listitem> + <listitem +><para +>Установите <link linkend="synccomp_checkb_options" +>опции</link +>: <guilabel +>Рекурсивный обход подкаталогов</guilabel +>, <guilabel +>Следовать по символическим ссылкам</guilabel +>, <guilabel +>Сравнивать по содержимому</guilabel +>, <guilabel +>Игнорировать дату</guilabel +> и <guilabel +>Асимметричный режим</guilabel +>.</para> + </listitem> + <listitem +><para +>Нажмите кнопку <guibutton +>Сравнить</guibutton +> для сравнения каталогов.</para> + </listitem> + <listitem +><para +>Используя <link linkend="synccomp_show_options" +>Показать параметры</link +>, вы можете включить/исключить определенные типы файлов. Эти файлы будут исключены из синхронизации.</para> + </listitem> + <listitem +><para +>Если нужно, вы можете изменить <guilabel +>задачи</guilabel +> в компараторе в <link linkend="synccomp_right_click" +>контекстном меню</link +>.</para> + </listitem> + <listitem +><para +>Когда вы согласитесь с результатами <guibutton +>Сравнить</guibutton +> нажимайте на кнопку <guibutton +>Синхронизировать</guibutton +> для показа диалога синхронизации.</para> + </listitem> + <listitem +><para +>После выбора опций в <link linkend="sychronizer" +>Сихронизировать</link +>, нажимайте на кнопку <guibutton +>Старт</guibutton +> для запуска процедуры синхронизации.</para> + </listitem> + </orderedlist> +Детальное описание всех функций и кнопок в следующем тексте. </para> + +<para +><emphasis role="bold" +>Сравнение</emphasis +></para> + +<variablelist> +<varlistentry +><term +>Панель элементов</term> + <listitem> + <itemizedlist> + <listitem +><para +><guilabel +>Левый каталог</guilabel +>: левый сравниваемый каталог.</para> + </listitem> + <listitem +><para +><guilabel +>Правый каталог</guilabel +>: правый сравниваемый каталог.</para> + </listitem> + <listitem +><para +><guilabel +>Файловый фильтр</guilabel +>: фильтр для синхронизации, например <literal role="extension" +>*.png</literal +> выбирает только файлы с окончанием <literal role="extension" +>.png</literal +> Каталоги будут выбраны, если оканчиваются на <literal role="extension" +>.png</literal +> или содержат файлы с расширением <literal role="extension" +>.png</literal +> Пример включения/исключения: <literal role="extension" +>'*.cpp *.h | *.moc.cpp'</literal +> будут включены <literal role="extension" +>*.cpp *.h</literal +> и исключены <literal role="extension" +>*.moc.cpp</literal +> </para> + </listitem> + <listitem +><para +><guilabel +>Основные</guilabel +>: содержащие текст</para> + </listitem> + <listitem +><para +><guilabel +>Дополнительно</guilabel +>: размер, дата, владелец</para> + </listitem> + </itemizedlist> + </listitem> +</varlistentry> + +<varlistentry id="synccomp_checkb_options" +><term +>Опции</term> + <listitem> + <itemizedlist> + <listitem +><para +><guilabel +>Рекурсивный обход подкаталогов</guilabel +>: Сихронизатор будет опускаться внутрь подкаталогов при сравнении.</para> + </listitem> + <listitem +><para +><guilabel +>Следовать по символическим ссылкам</guilabel +>: Сихронизатор будет переходить по символическим ссылкам на каталоги (не файлы!).</para> + </listitem> + <listitem +><para +><guilabel +>Сравнивать по содержимому</guilabel +>: файлы одинакового размера будут сравниваться по содержимому.</para> + </listitem> + <listitem +><para +><guilabel +>Игнорировать дату</guilabel +>: информация о дате будет проигнорирована ( используется для &FTP;, smb, archive, ... ), она уместна только для локальных файловых систем.</para> + </listitem> + <listitem +><para +><guilabel +>Ассиметричный режим</guilabel +>: <guilabel +>Левый каталог</guilabel +> это целевой каталог, <guilabel +>Правый каталог</guilabel +> это исходный каталог. Это способ синхронизировать содержимое левого каталога с правым. <itemizedlist +> <listitem +><para +>Файлы, которые есть только в левом каталоге будут удалены.</para +> </listitem +> <listitem +><para +>Те файлы, которые есть только в правом каталоге, будут скопированы в левый .</para +> </listitem +> <listitem +> <para +>Те файлы, котрые будут считаться одинаковыми, останутся нетронутыми.</para +> </listitem +> <listitem +> <para +>Файлы, содержащие отличия, будут копированы в левый каталог. Используйте эту возможность с осторожностью! </para +> </listitem +> </itemizedlist +> Эта функция используется если информация о дате не доступна, или синхронизацируется каталог с файловым сервером (подобно загрузке). Или сохраните содержимое правого каталога в левом, или сделайте резервную копию данных. ПРИМЕЧАНИЕ: НЕ используйте эту опцию для синхронизации с переносным компьтером ( Файлы, которые есть только в левом каталоге будут удалены!).</para> + </listitem> + <listitem +><para +><guilabel +>Автоматическая прокрутка</guilabel +>: эта опция для медленных серверов &FTP;, ... Когда Синхронизатор закончит сравнение файлов, он поместит файл в конец списка и переместит фокус в окно, если это необходимо. Это важно, если вы хотите знать что делает Синхронизатор. Если сервер слишком медлен, сравнение может занять продолжительное время. Уставливая эту опцию вы увидите работу "вживую", только медленно. На быстрой файловой системе скорость синхронизации немного уменьшится.</para> + </listitem> + </itemizedlist> + </listitem> +</varlistentry> + +</variablelist> + +<para +>Когда все указанные операции будут проделаны, нажмите кнопку <guibutton +>Сравнить</guibutton +>. Результаты сравнения будут выведены в "Список файлов".</para> + +<variablelist +><varlistentry +><term +>"Список файлов"</term> + <listitem> + <para +><guilabel +>Список файлов</guilabel +> содержит следующие столбцы: "Левый имя | Левый размер | Левый время | Задача | Правый время | Правый размер | Правый имя".</para> + </listitem> + </varlistentry> + +<varlistentry +><term +>Задачи (<= +>)</term> + <listitem +><para +>Этот столбец показывает действие, которое планируется синхронизатором.</para> + <itemizedlist> + <listitem +><para +><guibutton +>-></guibutton +>: копирует из левой части в правую. <command +>mkdir</command +> для каталогов в правой части.</para> + </listitem> + <listitem +><para +><guibutton +>=</guibutton +>: файлы одинаковы, синхронизировать нечего.</para> + </listitem> + <listitem +><para +><guibutton +>!=</guibutton +>: файлы исключены, или Синхронизатор не знает что делать.</para> + </listitem> + <listitem +><para +><guibutton +><-</guibutton +>: копирование из правой части в левую. <command +>mkdir</command +> для каталогов в левой части</para> + </listitem> + <listitem +><para +><guibutton +>DEL</guibutton +>: удалит файлы из правой части.</para> + </listitem> + </itemizedlist> + <para +>Выбор задачи доступен в <link linkend="synccomp_right_click" +>контекстом меню</link +>.</para> + </listitem> + </varlistentry> + + <varlistentry id="synccomp_show_options" +><term +>Показать опции</term> + <listitem> + <para +>Здесь можно включать/исключать специфические типы файлов. Эти файлы, которых нет в списке, будут исключены из синхронизации.</para> + <itemizedlist> + <listitem +><para +><guibutton +>-></guibutton +>: Разрешить/Запретить копирование из левой части в правую.</para +></listitem> + <listitem +><para +><guibutton +>=</guibutton +>: Разрешить/Запретить показывать в списке одинаковые файлы.</para +></listitem> + <listitem +><para +><guibutton +>!=</guibutton +>: Разрешить/Запретить показывать исключенные / "не знаю что делать" файлы.</para +></listitem> + <listitem +><para +><guibutton +><-</guibutton +>: Разрешить/Запретить копирование из правой в левую часть.</para +></listitem> + <listitem +><para +><guibutton +>Удалить</guibutton +>: Разрешить/Запретить единичное удаление файла из левой части.</para +></listitem> + <listitem +><para +><guibutton +>Duplicates</guibutton +>: Enable/Disable those files that exist on both side.</para +></listitem> + <listitem +><para +><guibutton +>Singles</guibutton +>: Enable/Disable those files that exist only on one side.</para +></listitem> + </itemizedlist +></listitem> + </varlistentry> + + <varlistentry +><term +>Кнопки действий</term> + <listitem> + <itemizedlist> + <listitem +><para +><guibutton +>Сравнить</guibutton +>: сравнить каталоги, результаты выведутся в <guilabel +>Список файлов</guilabel +>.</para +></listitem> + <listitem +><para +><guibutton +>Стоп</guibutton +>: остановить сравнение.</para +></listitem> + <listitem +><para +><guibutton +>Синхронизировать</guibutton +>: появится диалог синхронизации.</para +></listitem> + <listitem +><para +><guibutton +>Закрыть</guibutton +>: закроет окно Синхронизатора.</para +></listitem> + </itemizedlist +></listitem> + </varlistentry> + + <varlistentry +><term +>Статусная строка может включать</term> + <listitem> + <itemizedlist> + <listitem +><para +>Число сканируемых при сравнении каталогов.</para +></listitem> + <listitem +><para +>Имя файла при сравнении по содержанию(для больших файлов).</para +></listitem> + <listitem +><para +>Количество файлов в списке.</para +></listitem> + </itemizedlist +></listitem> + </varlistentry> + + <varlistentry id="synccomp_right_click" +><term +>Контекстное меню в <guilabel +>списке файлов</guilabel +></term> + <listitem> + <para +>Меню разделено на три секции:</para> + + <para +>1. выбор <guilabel +>задачи</guilabel +> - операции, выбранной для сравнения. Выберите один или несколько файлов. Изменение будут применено, только нажмите на соотвествующий элемент. Если выбрано изменение для каталога, оно применится для всех файлов/подкаталогов внутри него.</para> + <itemizedlist> + <listitem +><para +><guibutton +>Синхронизировать каталоги</guibutton +>: запуск синхронизации.</para +></listitem> + <listitem +><para +><guibutton +>Исключить</guibutton +>: исключает файл/каталог из синхронизации ( выбор != ).</para +></listitem> + <listitem +><para +><guibutton +>Восстановить настройки по умолчанию</guibutton +>: вернет начальный результат сравнения.</para +></listitem> + <listitem +><para +><guibutton +>Поменять направление</guibutton +>: изменит направление ( -> to <-, и <- to -> ).</para +></listitem> + <listitem +><para +><guibutton +>Копировать справа налево</guibutton +>: выберет <-.</para +></listitem> + <listitem +><para +><guibutton +>Копировать слева направо</guibutton +>: выберет ->.</para +></listitem> + <listitem +><para +><guibutton +>Удалить левый( левый одиночный )</guibutton +>: выберет DEL.</para +></listitem> + </itemizedlist> + + <para +>2. измените</para> + <itemizedlist> + <listitem +><para +><guibutton +>Выделить элементы</guibutton +>: откроет диалог выбора выделяемых элементов. Это диалог <guimenuitem +>Выбрать группу</guimenuitem +> из &editmenu_lnk;.</para +></listitem> + <listitem +><para +><guibutton +>Снять выделение с элементов</guibutton +>: откроет диалог, снятия выделения с выбранных элементов. Это диалог <guimenuitem +>Снять выделение с группы</guimenuitem +> из &editmenu_lnk;.</para +></listitem> + <listitem +><para +><guibutton +>инвертировать выделение</guibutton +>: инвертирует выбранное состояние для всех элементов.</para +></listitem> + </itemizedlist> + + <para +>3. другие замечания: выбранные операции работают на файле, выбранном по правому щелчку мыши, не при выделении.</para> + <itemizedlist> + <listitem +><para +><guibutton +>Просмотр левого файла</guibutton +>: запустит просмотрщик на левом файле.</para +></listitem> + <listitem +><para +><guibutton +>Просмотр правого файла</guibutton +>: запустит просмотрщик на правом файле.</para +></listitem> + <listitem +><para +><guibutton +>Сравнить файлы</guibutton +>: запустит приложение diff ( например &kompare;).</para +></listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry +><term +>Другие кнопки</term> + <listitem> + <itemizedlist> + <listitem> + <para +><guibutton +>Профили</guibutton +>: если вы часто делаете синхронизацию определенных каталогов, можно сохранить настройки, например включить/исключить файлы, ... Нажмите кнопку <guibutton +>Profile</guibutton +> добавьте / загрузите / удалите профили синхронизатора.</para> + </listitem> + <listitem> + <para +><guibutton +>Поменять стороны местами</guibutton +>: сменит стороны в <guilabel +> списке файлов</guilabel +>.</para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + + <varlistentry +><term +>Синхронизировать с &kget;</term> + <listitem> + <para +>Если вы хотите синхронизировать локальный каталог с нестабильным сервером ftp, &kget; будет лучшим решением, чем просто копирование файлов. После сравнения вы можете в контекстном меню выбрать <guimenuitem +>Синхронизировать с kget</guimenuitem +>, после этого выбранные файлы будут загружаться через kget вместо Крусадер. Конечно же <application +>kget</application +> должен быть установлен, иначе эта опция будет недоступна.</para> + </listitem> + </varlistentry> + + + </variablelist> + + + <para id="sychronizer" +><emphasis role="bold" +>Синхронизатор</emphasis +></para> + <para +>После нажатия кнопки <guibutton +>Синхронизировать</guibutton +> появится диалог синхронизации.</para> + + <variablelist> + <varlistentry +><term +>Опции</term> + <listitem> + <para +>Здесь вы подтверждаете операции копирования и удаления в Синхронизаторе</para> + <itemizedlist> + <listitem +><para +><guilabel +>Справа налево</guilabel +>: копирование файла Х1 ( Y1 bytes ) разрешить / запретить копирование из левой части в правую.</para +></listitem> + <listitem +><para +><guilabel +>Слева направо</guilabel +>: копирование файла Х2 ( Y2 bytes ) разрешить / запретить копирование из правой части в левую.</para +></listitem> + <listitem +><para +><guilabel +>Левый</guilabel +>: удалить Х3 файлов (Y3 байтов ) разрешить / запретить удаление в левой части.</para +></listitem> + <listitem +><para +><guilabel +>Подтверждать перезаписывание</guilabel +>: при включении этой опции Крусадер будет показывать диалоговое окно <guibutton +>переименовать, пропустить, перезаписать, пропустить все, перезаписать все</guibutton +> перед перезаписью файла.</para +></listitem> + </itemizedlist +></listitem> + </varlistentry> + + <varlistentry +><term +>Строки состояния</term> + <listitem> + <itemizedlist> + <listitem +><para +><guilabel +>Ready</guilabel +>: A1/A2 files, B1/B2. This line is changed at synchronizing, showing that synchronizer finished with A1 files from A2 ( B1 bytes from B2 ).</para +></listitem> + <listitem +><para +><guilabel +>Индикатор выполнения</guilabel +>: показывает состояние синхронизации (в байтах).</para +></listitem> + </itemizedlist +></listitem> + </varlistentry> + + <varlistentry +><term +>Кнопки действий</term> + <listitem> + <itemizedlist> + <listitem +><para +><guibutton +>Старт</guibutton +>: запуск синхронизации.</para +></listitem> + <listitem +><para +><guibutton +>Приостановить / Возобновить</guibutton +>: приостановка / возобновление синхронизации.</para +></listitem> + <listitem +><para +><guibutton +>Закрыть</guibutton +>: закрывает диалог синхронизации (и останавливает синхронизацию).</para +></listitem> + </itemizedlist +></listitem> + </varlistentry> + + </variablelist> + +</sect1> + + +<sect1 id="useractions"> +<title +>UserActions</title> +<indexterm +><primary +>UserActions</primary +></indexterm> +<!-- Thanks to Jonas Bar --> + +<para +>В менеджере действий вы можете устанавливать, настраивать и управлять вашими UserActions, некоторые основные настройки настраиваются в <link linkend="konfig-useractions" +>Konfigurator</link +>. В UserActions пользователь может создавать свои действия для файлов или обращаться к служебным функциям Крусадера напрямую. Действия встроены в &kde;, стандартный диалог настройки панелей и горячих клавиш также является пользовательским действием. Пользовательские действия сохраняются в файле <filename +>~/.kde/share/apps/krusader/useraction.xml</filename +> (структура файла документирована в заголовках doxygen для UserActionXML). Некоторые <link linkend="useraction_xml" +>примеры</link +> включены в документацию. UserActions редактируютсяt/добавляются/импортируются-/экспортируются в менеджере действий. UserActions по усолчанию находятся в файле <filename +>~/.kde/share/apps/krusader/useraction_examples.xml</filename +>. UserActions can appear nearly everywhere where "normal" KActions can be placed. They integrate seamless in the well knows Edit-(Toolbar,Shortcut) Dialogs from &kde;. It's even possible to place them in the menubar, but for that one has to manipulate the <filename +>krusaderui.rc</filename +> file with an editor. Some examples: <itemizedlist +> <listitem +><para +><link linkend="useractions-menu" +>Useractions Menu</link +> </para +></listitem +> <listitem +><para +>&usermenu_lnk; </para +></listitem +> <listitem +><para +>&actions_toolbar_lnk; </para +></listitem +> <listitem +><para +>right-click menu's </para +></listitem +> <listitem +><para +>&etc; </para +></listitem +> </itemizedlist +> Once you understand how to write UserActions you will find out that &krusader; has a very powerful, customizable UserActions tool. </para> + +<tip +><para +>Несколько UserActions доступно из коробки. Вы можете <link linkend="help_krusader" +>загрузить свои UserActions</link +>, так они станут доступны сообществу. Мы также имеем форум &useractionsforum_url;. </para +></tip> + +<para +>UserActions основываются на запуске внешних программ с различными параметрами. Для примера вы можете сделать UserAction следующей командой: <command +>xmms <option +>--enqueue %aList("Selected")%</option +></command +> - добавление всех выбранных элементов в активной панели в запущенный экземпляр xmms. В дополнение здесь можно получить ограниченный доступ к встроенным функциям, которые определяют параметры, так команда <command +>%aPanelSize("80")%</command +> установит ширину активной панели в 80% главного окна &krusader;. Служебные параметры могут содержать внутри себя другие параметры, маленькие скрипты можно сделать в &javascript_console_lnk;. </para> + +<para +><emphasis role="bold" +>Управление UserActions</emphasis +></para> +<para +>Откройте Конфигуратор и выберите "Меню пользователя -> Запустить менеджер действий". Здесь вы можете добавить/удалить/редактировать/импортировать/экспортировать UserActions. <itemizedlist +> <listitem +><para +><guimenuitem +>Создать новое действие</guimenuitem +>: появится пустая маска, где вы можете ввести все параметры.Действие будет добавлено, как только вы нажмете <guimenuitem +>Применить</guimenuitem +>. Имя будет показываться в списке слева. </para +></listitem +> <listitem +><para +> Редактирование действия: выберите действие в списке слева. Теперь вы можете редактировать параметры, изменения вступят в силу только после нажатия <guimenuitem +>Применить</guimenuitem +>. </para +></listitem +> <listitem +><para +><guimenuitem +>Удалить выбранное действие</guimenuitem +>: Выберите действие в списке слева и нажмите кнопку удаления. </para +></listitem +> <listitem +><para +><guimenuitem +>Загрузить действие</guimenuitem +>: при загрузке действие автоматически добавится в список. Если возникнет конфликт с именем(имена могут быть уникальными, потому что имеют ID в системе действий &kde;) вас спросят о новом имени. В списке будут показаны конфликтующие действия. Вы можете дать новое имя или удалить их. </para +></listitem +> <listitem +><para +><guimenuitem +>Сохранить действие</guimenuitem +>: у вас спросят имя для действия и оно будет сохранено в файл. Если он уже содержит какие-то действия то новое будет добавлено к сущевствующим. </para +></listitem +> </itemizedlist +> Все определенные вами действия будут видны в меню пользователя и в диалоге клавиатурных сочетаний &kde;. Также они будут доступны в контекстном меню по щелчку правой кнопкой мыши. </para> + + +<para +><emphasis role="bold" +><guimenuitem +>Основные свойства</guimenuitem +></emphasis +></para> +<para +><guimenuitem +>"Идентификатор", "Пункт меню" и "Команда"</guimenuitem +> обязательны, все остальные свойства опциональны. <itemizedlist> + <listitem +><para +><guimenuitem +>"Идентификатор"</guimenuitem +>: уникальное имя действия, используется для идентификации в системе действий &kde;. </para +></listitem> + <listitem +><para +><guimenuitem +>"Значок"</guimenuitem +>: выбор значка для вашего действия. </para +></listitem> + <listitem +><para +><guimenuitem +>"Категория"</guimenuitem +>: добавление в категорию для улучшения обзора. </para +></listitem> + <listitem +><para +><guimenuitem +>"Пункт меню"</guimenuitem +>: заголовок, показываемый в меню/диалогах. </para +></listitem> + <listitem +><para +><guimenuitem +>"Всплывающая подсказка"</guimenuitem +>: подсказка для вашего действия, показывается при наведении курсора. </para +></listitem> + <listitem +><para +><guimenuitem +>"Описание"</guimenuitem +>: описание, того что делает действие. Оно также отображается в <guimenuitem +>"Что это?"</guimenuitem +> если вы нажмете <keycombo action="simul" +>&Shift;<keycap +>F1</keycap +></keycombo +> на действии. </para +></listitem> + <listitem +><para +><guimenuitem +>"Use Tooltip checkbox"</guimenuitem +>: uses the tooltip as description. </para +></listitem> + <listitem +><para +><guimenuitem +>"Команда"</guimenuitem +>: здесь указывается команда, которая будет выполняться. Вы можете добавить шаблон нажав <guibutton +>Добавить</guibutton +>. </para +></listitem> + <listitem +><para +><guimenuitem +>"Рабочий каталог"</guimenuitem +>: каталог, из которого будет запускаться команда. </para +></listitem> + + <listitem +><para +><guimenuitem +>"Режим выполнения"</guimenuitem +>:</para> + <itemizedlist> + <listitem +><para +><guimenuitem +>"Нормальный"</guimenuitem +>: нормальный режим. </para +></listitem> + <listitem +><para +><guimenuitem +>"Запустить в терминале"</guimenuitem +>: запускает команду в терминале. </para +></listitem> + <listitem +><para +><guimenuitem +>"Перехватывать вывод"</guimenuitem +>: убирает вывод команды в окне. </para +></listitem> + <listitem +><para +><guimenuitem +>"Выделять стандартный вывод для ошибок"</guimenuitem +> когда используется "Перехватывать вывод" стандарный вывод и вывод ошибок будут разделятся </para +></listitem> + </itemizedlist> + </listitem> + + <listitem +><para +><guimenuitem +>"Применять команду"</guimenuitem +>:</para> + <itemizedlist> + <listitem +><para +><guimenuitem +>"Только для локальных файлов(не использовать URL's)"</guimenuitem +>: покажет шаблон возвращающий локальный адрес. </para +></listitem> + <listitem +><para +><guimenuitem +>"Для удаленных (URL) и локальных файлов"</guimenuitem +>: покажет шаблон возвращающий &URL;ы. </para +></listitem> + </itemizedlist> + </listitem> + +<!-- Not yet implemented, but will be after 1.50 stable is released + <listitem +><para +><guimenuitem +>"On multiple selection"</guimenuitem +>: </para> + <itemizedlist> + <listitem +><para +><guimenuitem +>"separate call for each file"</guimenuitem +>: executes the command for each selected file. + </para +></listitem> + </itemizedlist> + </listitem +> --> + + <listitem +><para +><guimenuitem +>"Комбинация клавиш по умолчанию"</guimenuitem +>: настройка сочетания клавиш для действия.</para +></listitem> + </itemizedlist> +</para> + +<para +><emphasis role="bold" +>Синтаксис командной строки:</emphasis +></para> +<para +>В основном любая введенная команда будет выполнена (если вы введете "ls -l", "ls -l", они выполнятся). Вы в можете использовать характерные для &krusader; встроенные команды, которые представляют статус текущей панели. Они выполнены как шаблоны. Шаблоны начинаются с символа ('%'), следом идет индикатор ('a' -активна, 'o' - другое, 'l -' левая и 'r' - правая панель. Если шаблон не нуждается в панели для работы вы должы указать это знаком ('_')). Затем следует имя шаблона (см. список ниже), которое может некоторые параметры окружения в кавычках, и, в конце снова знак проценты.</para> +<para +>This sounds very complicated, so lets make an example: '%aList("Selected")%' will be replaced by a list of all selected items in the active panel. So a command like 'xmms --enqueue %aList("All", " ", "", "*.mp3")%' will execute xmms with a list of all .mp3's in the current panel, separated by a single blank.</para> +<para +>В настоящее время включены следующие шаблоны: <itemizedlist +> <listitem +><para +><userinput +>Путь в панели</userinput +> - замена пути в панели</para +> <orderedlist +> <listitem +><para +>&useraction_optional_parameter; автоматически пропускать пробелы. &useraction_default; да</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Количество</userinput +> - заменяет число <первый параметр></para +> <orderedlist +> <listitem +><para +>&useraction_parameter; какие элементы; из "All", "Selected", "Files" или "Dirs"</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Маска фильтра</userinput +> - заменяет маску фильтра в панели</para +></listitem +> <listitem +><para +><userinput +>Текущий файл</userinput +> - переписывает текущий элемент</para +> <orderedlist +> <listitem +><para +>&useraction_optional_parameter; Не включать текущий путь. &useraction_default; нет</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Автоматически пропускать пробелы. &useraction_default; да</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Список значений</userinput +> - заменяет список всех <первых параметров></para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Список файлов "All", "Selected", "Files" or "Dirs"</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Разделитель между элементами. &useraction_default; " "</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Не включать текущий путь.&useraction_default; нет</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Маска (только для всех "Выделенных"). &useraction_default; *</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Автоматически пропускать пробелы&useraction_default; да</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Выбор</userinput +> - управление выбором в панели</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Маска</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; выбор по какому пути; из "Set", "Add" или "Remove". &useraction_default; "Set"</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Перейти к местонахождению</userinput +> - изменит путь панели в <первый параметр></para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Относительный или абсолютный путь, или URL</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Open the location in a new tab. &useraction_default; no</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Спрашивать пользователя о парамерах</userinput +> - запросит текст и перепишет ответ</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Вопрос</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Предустановка</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Значение</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Буфер обмена</userinput +> - управление буфером обмена</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Что должно быть скопировано (вы может использовать "%aCurrent%" здесь)</para +></listitem +> <listitem +><para +>&useraction_optional_parameter; Добавить к текущему содержимому буфера обмена через разделитель</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Копировать</userinput +> - копирование файлов, удобно для быстрого локального резервного копирования</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Что должно быть скопировано</para +></listitem +> <listitem +><para +>&useraction_parameter; Куда копировать</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Открыть профиль синхронизатора</userinput +> - откроет Синхронизатор с заданным профилем</para +> <orderedlist +> <listitem +><para +>&useraction_parameter;Выбрать профиль синхронизатора</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Открыть профиль модуля поиска</userinput +> - откроет окно поиска с заданным профилем</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Открыть профиль</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Загрузить профиль панели</userinput +> - загрузит выбранный профиль</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Выбрать профиль</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Each</userinput +> - splits the commandline into a list. These commands are executed one after another.</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; A list-item (all, all files, all dirs, all selected).</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Move</userinput +> - Move from source to destination.</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; A source</para +></listitem +> <listitem +><para +>&useraction_parameter; A destination</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>PanelSize</userinput +> - Change the ratio between the two panels.</para +> <orderedlist +> <listitem +><para +>&useraction_optional_parameter; A integer value, e.g., 80 makes the active panel use 80% of &krusader;'s width (height in vertical-mode), omitting the parameter means 50%. </para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Ask</userinput +> - Cancel the execution.</para +> <orderedlist +> <listitem +><para +>&useraction_optional_parameter; A string for the cancel question. </para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>Script</userinput +> - Executes an external <link linkend="javascript_console" +>Javascript</link +> file.</para +> <para +>NOTE: is still experimental and the interface may change, feedback is always welcome.</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; path to the external foo.js file, absolut path or relative to <filename +><kde-app-data>/krusader/js/</filename +>. <kde-app-data> is <filename +>$(kde-config --localprefix)/share/apps/</filename +> or <filename +>$(kde-config --prefix)/share/apps/</filename +>, for those who don't know where so copy the scripts/extensions. If all the needed files (normaly <filename +>.js</filename +> and maybe <filename +>.ui</filename +>) are in one of these dirs it's sufficient to give the filename only as 1. parameter. </para +></listitem +> <listitem +><para +>&useraction_optional_parameter; a list of variables which should be set, like "return=cmd; a=lalala; b='%_Ask(..)'" so that the placeholder is replaced be the content of the variable cmd and the other two have already these values when the script starts. </para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>ListFile</userinput +> - is replaced by path/filename of a temporary file containing a list of items</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; path/filename</para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>ColSort</userinput +> - set the sorting on a column of a specific panel.</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; Column: either "Name", "Ext", "Type", "Size", "Modified", "Perms", "rwx", "Owner" and "Group"</para +></listitem +> <listitem +><para +>&useraction_parameter; Sort sequence: either "Toggle", "Asc", "Desc" </para +></listitem +> </orderedlist +> </listitem +> <listitem +><para +><userinput +>View</userinput +> - set the view mode.</para +> <orderedlist +> <listitem +><para +>&useraction_parameter; View mode: either "generic", "text", "hex" </para +></listitem +> <listitem +><para +>&useraction_parameter; Window Mode: either "tab", "window" </para +></listitem +> </orderedlist +> </listitem +> </itemizedlist +> A GUI-based helper for placeholder-adding is provided. Spaces In Path, Current and List are by default, automatically escaped. There is one more important thing to know: All placeholders that interact with &krusader;-internal functions are called at expand-time (meaning directly when the placeholders are replaced). External programms are called at execution-time (meaning after all placeholders are replaced). </para> + +<para +><emphasis role="bold" +><guimenuitem +>Дополнительные свойства</guimenuitem +></emphasis +></para> +<para +>Здесь вы можете редактировать где ваши команды будут видны (в контекстном меню). В дополнение возможно подтверждать вызов каждой команды отдельно. Вы также можете запускать от имени другого пользователя. <itemizedlist> + <listitem +><para +>Правуильно настройте протокол, путь, тип Mime или имя файла.</para +></listitem> + <listitem +><para +>Настройте опции команды.</para +></listitem> + <listitem +><para +>Установите другого пользователя (это не действует в встроенных функциях крусадера)</para +></listitem> +</itemizedlist> +</para> + +</sect1> + +<sect1 id = "javascript_console"> +<title +>JavaScript Console</title> +<indexterm +><primary +>JavaScript Console</primary +></indexterm> + +<para +><keycombo action="simul" +>&Alt;&Ctrl;<keycap +>j</keycap +></keycombo +> opens the JavaScript-console. (only available if libkjsembed is present at compile- and runtime)</para> + +<para +>The JavaScript console is an interface to the embeded JS-Interpreter which can be used to play around and test how things work.</para> + +</sect1> + +<sect1 id = "javascript_interface"> +<title +>JavaScript interface</title> +<indexterm +><primary +>JavaScript interface</primary +></indexterm> + +<para +><emphasis role="bold" +>Warning:</emphasis +> The JS-Support is quite stable (which means that it won't crash &krusader; (hopefully ;)) and you can't loose any data by using it). However, the JS-interface will certainly change! So using it can't do any harm but you must know that your scripts may (or quite certainly, if you're interacting with Krusader) won't work with future versions of &krusader; anymore. </para> + +<tip +><para +>Please <link linkend="help_krusader" +>upload your favorite JavaScript Extensions</link +> so that they become available for the &krusader; community. Thanks! </para +></tip> + +<para +>JavaScript applications have usually 2 files <filename +>foo.js</filename +> and <filename +>foo.ui</filename +>. They will be installed in <filename +>~/.kde/share/apps/krusader/js/</filename +>, a useraction with a "%_Script" action will start the Javascripting. Currently we have 2 JS demo's <filename +>root-mount-extension.tar.bz2</filename +> and <filename +>js-demo-calc.tar.bz2</filename +> that will be more explenatory.</para> + +<para +>When a script is executed, the script doesn't know it's origin (or maybe there is a way which that we don't know) and all relative path's are relative to the current working-dir. But this dir is (normaly) not the one where the script is located but the current dir of the active Panel of Krusader. This needs to stay like this. However, for referenceing additional files like .ui (Userinterface, exported by &Qt;'s Designer) one need the path of the script. The alternative where absolute path's but this is more then unhandy. For this reason the Variable "scriptDir" was introduced. If a Script want to load a &GUI; from a .ui-file this can be done this way: <emphasis +>var ui = Factory.loadui( scriptDir + 'filename.ui' );</emphasis +> I recomend using Dialog as a base when designing &GUI;'s for using with JS. Execute the dialog with: <emphasis +>ui.exec();</emphasis +> The elements of the &GUI; may be accessed like this: <emphasis +>ui.child('widgetName')</emphasis +> </para> + +<para +>Currently there are only the objects 'Krusader' and 'PanelManager' which are exposed C++ objects without a real sence behind. They can be inspected using the JS-Console and the functions 'properties()', 'children()' and 'slots()'. The children can be accessed with the function 'chlid("nameOfChild")' with returns an object itself. Currently more usefull is the Variable scriptDir. Following the root-mount-extension it's already possible to create advnaced &GUI;'s for commandline-tools </para> + +<para +>You can play around with'Krusader.setCaption("Hey Ho, Let's go!");', 'Krusader.children();', 'Krusader.child("help").slots();', 'alert(Krusader.properties())' or 'Krusader.child("help").show();'.... In addition a new placeholder for the &useractions_lnk;, %_Script()%, will execute an external file.</para> + +<para +>NOTE: The object 'Krusader' will change. We haven't made decisions about the JS-interface yet (at the time of the 1.70.0-release). Any ideas are welcome. Plase use our &kruforum_url; for feedback.</para> + +<para +>The JavaScript-support is based on &kjsembed_url;. Some expamples which show the power of this library can be found on <ulink url="http://xmelegance.org/kjsembed/examples/index.html" +></ulink +>. Support for all of KDE's ground-laying technologies like DCOP or KParts is provided. You can even load whole GUI's from .ui-files, created with &Qt;'s Designer. An example extension making use of this can be found <ulink url="http://www.krusader.org/phpBB/viewtopic.php?p=4832#4832" +>here</ulink +>. </para> + +</sect1> + +<sect1 id="diskusage"> +<title +>Использование диска</title> +<indexterm +><primary +>Использование диска</primary +></indexterm> + +<para +>Интерфейс основан на коде &filelight;. Использование диска показывает в графическом виде, как используется дисковое пространство на вашей файловой системе.Доступны: <itemizedlist +> <listitem +><para +>Линейный</para +></listitem +> <listitem +><para +>Детальный</para +></listitem +> <listitem +><para +>Круговой: в виде концентрических сегментных колец.</para +></listitem +> </itemizedlist +> Выберите <emphasis role="bold" +><menuchoice +><guimenu +>Инструменты</guimenu +> <guimenuitem +>использование диска</guimenuitem +></menuchoice +></emphasis +> или <keycombo action="simul" +>&Alt;<keycap +>d</keycap +></keycombo +> для запуска в отдельном окне, или откройте в &popup_panel_lnk;. </para> + +<para +>Клавиши Использования диска, контекстное меню. <itemizedlist> + <listitem +><para +><keycap +>Del</keycap +>: Удалить</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>e</keycap +></keycombo +>: Исключить</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Shift;<keycap +>Вверх</keycap +></keycombo +>: выше на один уровень</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>n</keycap +></keycombo +>: новый поиск</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>r</keycap +></keycombo +>: обновить</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>i</keycap +></keycombo +>:включить все</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Shift;<keycap +>Вниз</keycap +></keycombo +>: войти</para +></listitem> + + <listitem +><para +>Меню вид: <itemizedlist> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>l</keycap +></keycombo +>: линейный</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>d</keycap +></keycombo +>: детальный</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>f</keycap +></keycombo +>: круговой</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Shift;<keycap +>Правый</keycap +></keycombo +>: следующий</para +></listitem> + <listitem +><para +><keycombo action="simul" +>&Shift;<keycap +>Левый</keycap +></keycombo +>: предыдущий</para +></listitem> + </itemizedlist> + </para +></listitem> + + </itemizedlist> +</para> + +<!-- OLD +<screenshot> + <screeninfo +>Disk Usage</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="diskusage.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="diskusage.png" format="EPS"/></imageobject> + <textobject +><phrase +>Konfigurator Look & Feel page</phrase +></textobject> + <caption +><para +>Disk Usage</para +></caption> + </mediaobject> +</screenshot> +--> + +<!--HTML_PARSING +<figure id="screenshot-diskusage" float="1"> +<title +>Disk Usage</title> +<mediaobject> +<imageobject +><imagedata fileref="diskusage.png"/></imageobject> +<textobject +><phrase +>Disk Usage</phrase +></textobject> +</mediaobject> +</figure> +HTML_PARSING--> + +</sect1> + + +</chapter> diff --git a/doc/ru/mouse.docbook b/doc/ru/mouse.docbook new file mode 100644 index 0000000..a1e0596 --- /dev/null +++ b/doc/ru/mouse.docbook @@ -0,0 +1,56 @@ +<chapter id="mouse-commands"> +<!-- ********************************************************************** + mouse.docbook + ++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Mouse Commands</title> +<indexterm +><primary +>Commands</primary +><secondary +>Mouse</secondary +></indexterm> + +<sect1 id="mouse-usage"> +<title +>Mouse Usage</title> + +<para +>TODO</para> + +</sect1> + +<sect1 id="mouse_gestures"> +<title +>Mouse Gestures</title> + +<para +>NOTE: this chaper is work in progress ;)</para> + +<para +>We provide online a <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1392" +>Mouse Gestures howto</ulink +> that explains howto use KHotKeys mouse gestures with &krusader;.</para> + +</sect1> + + +</chapter> diff --git a/doc/ru/release-overview.docbook b/doc/ru/release-overview.docbook new file mode 100644 index 0000000..85d5b74 --- /dev/null +++ b/doc/ru/release-overview.docbook @@ -0,0 +1,694 @@ +<appendix id = "release_overview"> + +<!-- ********************************************************************** + release-overview.docbook + ++++++++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + + +<title +>Release overview</title> +<para +>This appendix gives an overview of the &krusader; releases.</para> + + +<table id="release_overview_table" pgwide="1" frame="all"> +<title +>Release overview</title> +<tgroup cols="3" colsep="1" rowsep="1"> +<thead> +<row> + <entry +><para +>&krusader; version</para +></entry> + <entry +><para +>release date</para +></entry> + <entry +><para +>&kde; version</para +></entry> +</row> +</thead> + +<tbody> +<row> + <entry +><para +>2.0.0 "name ?????"</para +></entry> + <entry +><para +>2006-??-?? under construction</para +></entry> + <entry +><para +>&kde; 4</para +></entry> +</row> + +<row> + <entry +><para +>1.80.0 "name ?????"</para +></entry> + <entry +><para +>2006-??-?? under construction</para +></entry> + <entry +><para +>&kde; 3.3 - 3.5</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1665" +>1.70.1 "Round Robin"</ulink> + </para +></entry> + <entry +><para +>2006-07-17</para +></entry> + <entry +><para +>&kde; 3.3 - 3.5</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1465" +>1.70.0 "Round Robin"</ulink> + </para +></entry> + <entry +><para +>2006-02-12</para +></entry> + <entry +><para +>&kde; 3.3 - 3.5</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://krusader.sourceforge.net/phpBB/viewtopic.php?t=1378" +>1.70.0-beta2 "Afterburner"</ulink> + </para +></entry> + <entry +><para +>2005-11-05</para +></entry> + <entry +><para +>&kde; 3.3 - 3.5</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1323" +>1.70.0-beta1 "Hellfire"</ulink> + </para +></entry> + <entry +><para +>2005-10-02</para +></entry> + <entry +><para +>&kde; 3.3 - 3.5</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1368" +>1.60.1</ulink> + </para +></entry> + <entry +><para +>2005-10-30</para +></entry> + <entry +><para +>&kde; 3.3 - 3.4</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1158" +>1.60.0</ulink> + </para +></entry> + <entry +><para +>2005-04-10</para +></entry> + <entry +><para +>&kde; 3.3 - 3.4</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1142" +>1.60.0-beta2</ulink> + </para +></entry> + <entry +><para +>2005-03-21</para +></entry> + <entry +><para +>&kde; 3.3 - 3.4</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=1123" +>1.60.0-beta1</ulink +> + </para +></entry> + <entry +><para +>2005-03-03</para +></entry> + <entry +><para +>&kde; 3.3 - 3.4</para +></entry> +</row> + +<row> + <entry +><para> + <ulink url="http://www.krusader.org/phpBB/viewtopic.php?t=989" +>1.51</ulink> + </para +></entry> + <entry +><para +>2004-12-14</para +></entry> + <entry +><para +>&kde; 3.2 - 3.3</para +></entry> +</row> + +<row> + <entry +><para +>1.50</para +></entry> + <entry +><para +>2004-10-31</para +></entry> + <entry +><para +>&kde; 3.2 - 3.3</para +></entry> +</row> + +<row> + <entry +><para +>1.50-beta1</para +></entry> + <entry +><para +>2004-10-17</para +></entry> + <entry +><para +>&kde; 3.2 - 3.3</para +></entry> +</row> + +<row> + <entry +><para +>1.40</para +></entry> + <entry +><para +>2004-07-20</para +></entry> + <entry +><para +>&kde; 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.40-beta2</para +></entry> + <entry +><para +>2004-06-22</para +></entry> + <entry +><para +>&kde; 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.40-beta1</para +></entry> + <entry +><para +>2004-04-11</para +></entry> + <entry +><para +>&kde; 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.30</para +></entry> + <entry +><para +>2003-11-14</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.29-beta1</para +></entry> + <entry +><para +>2003-10-02</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.25-beta1</para +></entry> + <entry +><para +>2003-08-15</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.21-beta1</para +></entry> + <entry +><para +>2003-07-18</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.20</para +></entry> + <entry +><para +>2003-05-31</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.12-beta2</para +></entry> + <entry +><para +>2003-05-09</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.12-beta1</para +></entry> + <entry +><para +>2002-12-23</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.11</para +></entry> + <entry +><para +>2002-10-17</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.10</para +></entry> + <entry +><para +>2002-08-16</para +></entry> + <entry +><para +>&kde; 3.0 - 3.2</para +></entry> +</row> + +<row> + <entry +><para +>1.01</para +></entry> + <entry +><para +>2002-04-01</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>1.00</para +></entry> + <entry +><para +>2002-01-01</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.99</para +></entry> + <entry +><para +>2001-12-01</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.98</para +></entry> + <entry +><para +>2001-10-27</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.97</para +></entry> + <entry +><para +>2001-10-08</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.95</para +></entry> + <entry +><para +>2001-07-22</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.93</para +></entry> + <entry +><para +>2001-05-31</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.92</para +></entry> + <entry +><para +>2001-05-17</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.91</para +></entry> + <entry +><para +>2001-05-10</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.90</para +></entry> + <entry +><para +>2001-04-30</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.79</para +></entry> + <entry +><para +>2001-02-25</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.65</para +></entry> + <entry +><para +>2000-08-19</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>0.60</para +></entry> + <entry +><para +>2000-07-19</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>M2 (milestone 2)</para +></entry> + <entry +><para +>2000-07-11</para +></entry> + <entry +><para +>&kde; 2</para +></entry> +</row> + +<row> + <entry +><para +>M1 (milestone 1)</para +></entry> + <entry +><para +>2000-??-??</para +></entry> + <entry +><para +>&kde; 2 (Kleopatra 1.91)</para +></entry> +</row> + +<row> + <entry +><para +>Project began</para +></entry> + <entry +><para +>2000-04-30</para +></entry> + <entry +><para +>Kleopatra 1.91</para +></entry> +</row> + +</tbody> +</tgroup> +</table> + +<para +>Note: some very old 0.x beta releases are not included in this table.</para> + +</appendix> diff --git a/doc/ru/user-interface.docbook b/doc/ru/user-interface.docbook new file mode 100644 index 0000000..9e45046 --- /dev/null +++ b/doc/ru/user-interface.docbook @@ -0,0 +1,975 @@ +<chapter id="user-interface"> + +<!-- ********************************************************************** + user-interface.docbook + +++++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Интерфейс пользователя</title> +<indexterm +><primary +>Интерфейс пользователя</primary +></indexterm> + +<sect1 id="ofm-userinterface"> +<title +>OFM интерфейс</title> +<para +>ПРИМЕЧАНИЕ: эта часть ещё не дописана ;)</para> + +<para +>Концепция OFM файлменеджера содержит <link linkend="features" +>много возможностей</link +>, которые делают их наиболее мощными.Интерфейс прост: левая и правая панели, командная строка внизу. Взаимодействие между этими тремя элементами радикально увеличивает скорость управления файлами во время работы. </para> + +<para +>Если вы хотите узнать как <ulink url="http://www.softpedia.com/reviews/linux/Krusader-Review-18193.shtml" +>попробовать &krusader;</ulink +> есть только один путь, установитеего на свой компьютер и используйте некоторе время! Признайте, &krusader;, похож на &ofm_url;, вы нуждаетесь в <emphasis +>новых идеях</emphasis +> которые уже существуют 20 лет :) Если вы хотите и дальше терять время и терять производительность, вы всегда можете продолжать использовать однопанельные файловые менеджеры, которые основаны на идее &Windows; Explorer ;-) </para> + +</sect1> + + +<sect1 id="mainwindow"> +<title +>Главное окно &krusader;</title> + +<!-- OLD +<screenshot> + <screeninfo +>&krusader; Main Window</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="mainwindow.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="mainwindow.png" format="EPS"/></imageobject> + <textobject +><phrase +>&krusader; Main Window</phrase +></textobject> + <caption +><para +>&krusader;'s main window with all the different parts named on the screen.</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-mainwindow" float="1"> +<title +>Главное окно &krusader;</title> +<mediaobject> +<imageobject +><imagedata fileref="mainwindow.png"/></imageobject> +<textobject +><phrase +>Главное окно &krusader;</phrase +></textobject> +</mediaobject> +</figure +> + +<para +>Интерфейс пользователя основан на парадигме &ofm_url;, этот принцип проверен 20-ти летней практикой.Он заведомо прост, легок и мощен.В следующей части мы рассмотрим основные функции каждой части, исключая:</para> + +<itemizedlist> + <listitem> + <para +><link linkend="menu-commands" +>Меню</link +>, которое имеет свой раздел.</para> + </listitem> + + <listitem> + <para +><link linkend="bookman" +>Закладки</link +>, которое имеет свой раздел.</para> + </listitem> + + <listitem> + <para +>The <emphasis role="bold" +>Строка состояния</emphasis +> показывает свойства файла, который выбран или в фокусе. Вы можете использовать перетаскивание &URL; в строку состояния.</para> + </listitem> +</itemizedlist> +</sect1> + +<sect1 id="main_toolbar"> +<title +>Основная панель инструментов</title> +<indexterm +><primary +>Панель инструментов</primary +><secondary +>Панель инструментов</secondary +></indexterm +> + +<!-- OLD +<screenshot> + <screeninfo +>Main Toolbar</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="toolbar.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="toolbar.png" format="EPS"/></imageobject> + <textobject +><phrase +>Main Toolbar</phrase +></textobject> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-maintoolbar" float="1"> +<title +>Основная панель инструментов</title> +<mediaobject> +<imageobject +><imagedata fileref="toolbar.png"/></imageobject> +<textobject +><phrase +>Панель инструментов</phrase +></textobject> +</mediaobject> +</figure +> + + +<para +>панель инструментов &krusader; - это стандартная панель &kde;, которая перемещается внутри приложения или настраивается через <keycap +>контекстное</keycap +> меню. Вы можете выбрать показывать или нет её при запуске в &konfigstartpg_lnk;, и зафиксировать для текущей сессии в &viewmenu_lnk;. Содержимое настраивается из <guimenuitem +>Настроить панели инструментов</guimenuitem +> в &settingsmenu_lnk; или во вкладке <guilabel +>панель</guilabel +> меню &konfiglookandfeel_lnk;. Различные команды и опции в &krusader; зависят от контекста, некоторые не всегда доступны, иконки невозможных или неактивных действий деактивируются(сереют) и вы не можете выбрать или использовать их. &bookmarks_lnk; можно поместить на основную панель и панель действий перетаскиванием.</para> + +</sect1> + +<sect1 id="actions_toolbar"> +<title +>Панель действий</title> +<indexterm +><primary +>Панель инструментов</primary +><secondary +>Панель действий</secondary +></indexterm +> + +<para +>&useractions_lnk; и &bookmarks_lnk; можно поместить на <guilabel +>панель действий</guilabel +>. Выберите <emphasis role="bold" +><menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Показывать панель действий</guimenuitem +></menuchoice +></emphasis +>. Чтобы добавить действие используйте <emphasis role="bold" +><menuchoice +><guimenu +>Настройки</guimenu +> <guimenuitem +>Панели инструментов</guimenuitem +></menuchoice +></emphasis +> и выберите панель действий. Вы можете, например переместить панель в правый угол, используя мышь. </para> +</sect1> + + +<sect1 id="panels"> +<title +>Панели</title> + +<para +>Панели &krusader; это место где производится работа. В настоящее время есть два типа панелей: <itemizedlist +> <listitem +><para +>&list_panel_lnk;: показывается список каталогов и файлов. </para +></listitem +> <listitem +><para +>&popup_panel_lnk;: включает остальные режимы: Предпросмотр, Дерево каталогов, Выбор быстрых операций, Просмотр статистики использования диска файлом или каталогом. Дополнительную панель можно открывать ил закрывать по своему усомтрению. </para +></listitem +> </itemizedlist +> &krusader; - это "двухпанельный" файловый менеджер и в нем только "Левая" и "Правая" панели, или, логичнее, активная и неактивная. В активной панели вы получаете реакцию на нажатия кнопок мыши и клавиатуры. Если вы выбираете команду из <guilabel +>меню</guilabel +> или <guilabel +>панели</guilabel +> она выполнится для выбранных файлов/каталогов в активной панели. Вы можете переключатся между панелями клавишей 	, нажатием на <guilabel +>информационное поле</guilabel +>, или выбрав любой файл или каталог в панели мышью. Как всегда: стартовые настройки в &konfigstartpg_lnk;, и управление текущей сессией в &viewmenu_lnk;. </para> + +<!-- OLD +<screenshot> + <screeninfo +>List Panel</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="listpanel.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="listpanel.png" format="EPS"/></imageobject> + <textobject +><phrase +>List Panel</phrase +></textobject> + <caption +><para +>The List Panel with all the different parts indicated.</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-listpanel" float="1"> +<title +>Панель списка</title> +<mediaobject> +<imageobject +><imagedata fileref="listpanel.png"/></imageobject> +<textobject +><phrase +>Панель списка</phrase +></textobject> +</mediaobject> +</figure +> + + +<sect2 id="list_panel"> +<title +>Панель списка</title> +<indexterm +><primary +>Панель инструментов</primary +><secondary +>Панель адреса</secondary +></indexterm> +<para +>Это основная панель и она используется больше всего. Эта панель показывает содержимое каталога (раздел смонтированной файловой системы, файлы или содержимое архива) или файлы на удаленной файловой системе (&FTP; или Samba). Поддерживается копирование/вставка/вырезка через буфер обмена между &konqueror; и &krusader; сочетаниями клавиш <keycombo action="simul" +>&Ctrl;<keycap +>c</keycap +></keycombo +>, <keycombo action="simul" +>&Ctrl;<keycap +>v</keycap +></keycombo +>, <keycombo action="simul" +>&Ctrl;<keycap +>x</keycap +></keycombo +>. <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>r</keycap +></keycombo +> переключает <guilabel +>Панель списка</guilabel +> между горизонтальным и вертикальным режимами. </para> + +<para +>Имеются следующие элементы: <itemizedlist +> <listitem +><para +><emphasis +><guibutton +>Панель адреса</guibutton +></emphasis +> : показывает путь в текущей панели. Если он слишком длинный то сработает автоматическое сокращение вида "..." с пренебрежением вывода полного пути. В архиве путь будет иметь вид "имя архива:/каталог/имя архива/каталог внутри архива". Этот формат делает вывод пути легким для чтения и однообразным. <guibutton +>Панель адреса</guibutton +> также поддерживает некоторые &kioslaves1_url;, только не все, т.к. некоторые используются только в <link linkend="krviewer" +>просмотрщике</link +> или не поддерживаются. Перейти в желаемый каталог можно одним щелчком кнопки мыши, ⪚ <itemizedlist +> <listitem +> <para +><userinput +><replaceable +>/mnt/cdrom/</replaceable +></userinput +></para +> </listitem +><listitem +><para +><userinput +><command +>settings:/</command +></userinput +> просмотр и открытие компонентов <application +>Центра управления КДЕ</application +></para +> </listitem +> <listitem +><para +><userinput +><command +>devices:/</command +></userinput +> обзор устройств хранения данных, например <hardware +>floppy</hardware +> или <hardware +>cdrom</hardware +>.</para +> </listitem +> <listitem +><para +><userinput +><command +>trash:/</command +></userinput +>Корзина &kde;</para +> </listitem +><listitem +><para +><userinput +> <command +>ipod:/</command +></userinput +> используется для доступа к &kio_ipodslave_url;, загрузка песен и управление &appleipod;.</para +></listitem +> <listitem +><para +>И последнее, но не малое! &remote_connections_lnk; !</para +> </listitem +> </itemizedlist +>Вы можете копировать-вставлять &URL; в<guibutton +>Панель адреса</guibutton +> или щелкнуть колесом мыши. В контекстном меню по правому щелчку можно настроить функцию завершения текста. Дополнительно есть кнопка<guilabel +>Очистить поле адреса</guilabel +>. </para +> <para +>Быстрая навигация: <keycap +>&Ctrl;</keycap +>установите курсор в середине &URL; в <guibutton +>панели адреса</guibutton +>, всплывающее окно покажет &URL;, место, куда перейдет текущая панель при щелчке с удержанием <keycap +>&Ctrl;</keycap +>, эта возможность дает быструю и удобную навигацию в большом дереве каталогов.</para +> </listitem +> <listitem +> <para +><link linkend="panel_toolbar" +><emphasis +><guibutton +>Панель инструментов</guibutton +></emphasis +></link +> : содержит <link linkend="panel_toolbar" +>настраиваемые кнопки</link +>. </para +> </listitem +> <listitem +> <para +><emphasis +><guilabel +>Информационное поле</guilabel +></emphasis +> : показывает размер доступного пространства в файловой системе, сколько места занято в файловой системе и путь монтирования. Если информация не доступна(чаще всего в случае удаленнойфайловой системы) будет сообщение о невозможности вывести информацию.</para +> <para +><guibutton +>Кнопка Медиа</guibutton +> слева в <guilabel +>информационном поле</guilabel +> показывает список доступных медиаустройств, можно выбрать необходимое устройство(диск раздел, dvd, usb-stick, &etc;). Контекстное меню содержит несколько опций: <guilabel +>Монтировать</guilabel +>, <guilabel +>Открыть в новой вкладке</guilabel +>, &etc;. <guibutton +>Кнопка медиа</guibutton +> <link linkend="konfig-advanced" +>настраивается</link +>.</para +> </listitem +> <listitem +> <para +><emphasis +><guilabel +>Столбцы</guilabel +></emphasis +> : здесь вы можете выбрать порядок сортировки файлов и каталогов по своему желанию. По умолчанию критерий сортировки <guilabel +>Имя</guilabel +>. Критерий сортировки выбирается моментально нажатием в поле <guilabel +>Столбцы</guilabel +>. Для сортировки в обратном порядке щелкните повторно в необходимом поле. Стрелка справа от текста в поле столбца, показывает направление сортировки. Умолчальные клавиши для столбцов настраиваются в &useractions_lnk;. Имеются <guilabel +>столбцы</guilabel +>: <guilabel +>Имя, Расширение, Размер, Изменен, Права</guilabel +>. Остальные <link linkend="konfig-looknfeel-panel" +>дополнительные столбцы</link +> доступны по &RMB;. Ширину <guilabel +>столбцов</guilabel +> можно регулировать перемещения линию разделения столбцов левой кнопкой мыши(с удержанием нажатия). Обе <guilabel +>Панели</guilabel +> запоминают порядок сортировки и ширину столбцов. <guilabel +>Столбцы</guilabel +> можно изменять и сохранять индивидуально для каждой панели. </para +> </listitem +> <listitem +> <para +><emphasis +><guilabel +>Список файлов</guilabel +></emphasis +> : показывает файлы и каталоги внутри просматриваемого каталога. &quick_search_lnk; позволяет быстро находить файлы, вводя их имена, или первые буквы имени. Нажатие &Enter; или двойной щелчок мыши на файле открывает/запускает его. Вы можете выделять/снимать выделение файлов мышью, клавишей <keycap +>Insert</keycap +> или &editmenu_lnk;.</para +> </listitem +> <listitem +> <para +><emphasis +><guilabel +>Поле суммы</guilabel +></emphasis +> : выделяя или снимая выделение с файлов вы изменяете <emphasis +><guilabel +>поле суммы</guilabel +></emphasis +> в нижней панели, которое показывает сколько файлов вы выбрали (и сколько места на диске они занимают), общее количество файлов в директории и занятое ими место (иначе информационное поле показывает сведения о файловой системе в целом). Если каталог содержит много подкаталогов, то перенос &URL; на панель (где видны только подкаталоги) невозможен, но &URL; можно перетащить в "Панель состояния" или "Поле суммы". Когда установлен <link linkend="view-menu" +>специальный фильтр</link +> будет показываться только установленное. Пример: [*.cpp]. </para +> </listitem +> </itemizedlist +> Когда используются "&kde; умолчательные <link linkend="konfig-color" +>цвета</link +>", выделенные файлы отмечаются голубым и текущий файл окружен прямоугольником. По умолчанию иконка отображает связанный с файлом тип. Используйте &konfiglookandfeel_lnk; для изменения настроек по своему предпочтению. </para> + + +<para +>Некоторые полезные &keybindigs_lnk; <guilabel +>Панели списка</guilabel +>: <itemizedlist> + + <listitem> + <para +><keycombo action="simul" +>&Ctrl;<keycap +>r</keycap +></keycombo +> обновит панель.</para> + </listitem> + + <listitem> + <para +>Наведите фокус на файл или каталог в левой панели и нажмите <keycombo action="simul" +>&Ctrl;<keycap +>Стрелка вправо</keycap +></keycombo +> и правая панель изменится: <itemizedlist> + <listitem> + <para +>на файле: правая панель перейдет по пути левой панели.</para> + </listitem> + + <listitem> + <para +>на каталоге: правая панель обновится и покажет содержимое каталога.</para> + </listitem> + </itemizedlist +></para +> + </listitem> + + <listitem +><para +>Для правой панели: нажмите <keycombo action="simul" +>&Ctrl;<keycap +>Стрелка влево</keycap +></keycombo +> и изменится левая панель.</para> + </listitem> + + </itemizedlist> +</para> + +</sect2> + + +<sect2 id="popup_panel"> +<title +>Дополнительная панель</title> + +<para +>Это "третья рука" Крусадера или дополнительная панель. Нажмите кнопку со стрелкой вверх в левом <guilabel +>поле суммы</guilabel +> или <keycombo action="simul" +>&Alt;<keycap +>Down-Arrow</keycap +></keycombo +> для открытия <guilabel +>дополнительной панели</guilabel +>. Эта панель имеет несколько режимов, которые вызываются нажатием на соответсвующую кнопку <itemizedlist +> <listitem +> <para +><emphasis +><guilabel +>Панель предпросмотра</guilabel +></emphasis +> : позволяет предпросмотр файла на который наведен фокус (текущий выбранный файл).</para +> </listitem +> <listitem +> <para +><emphasis +><guilabel +>Дерево</guilabel +></emphasis +> : используется для быстрой навигации в локальном дереве каталогов. Эта панель подобна основной, только нужно выбрать один каталог и двойной щелчок или нажатие &Enter; откроет его в активной панели. панели полностью поддерживают перетаскивание (копирование, перемещение, ссылки).</para +> </listitem +> <listitem +> <para +><emphasis +><guilabel +>Панель быстрых операций</guilabel +></emphasis +>: быстрый выбор файлов, например <literal role="extension" +>*.png</literal +> и нажмите кнопку <guibutton +>"применить выбор"</guibutton +>. Кнопка "флоппи" сохранит текущее выделение. "Диалог выбора группы" также воможен. </para +> </listitem +> <listitem +> <para +><emphasis +><guilabel +>Панель просмотра</guilabel +></emphasis +> : просмотр текстового файла, просмотр изображения, &etc;. Просмотр уменьшенных копий картинок создается когда открывается <guilabel +>Панель просмотра</guilabel +> и выбирается каталог с картинками.</para +> </listitem +> <listitem +> <para +><emphasis +><guilabel +>Панель статистики</guilabel +></emphasis +> : просмотр &diskusage_lnk; каталогом.</para +> </listitem +> </itemizedlist +> Если необходимо, вы можете изменять размер окна, например для лучшего вида просматриваемой картинки или файла. Нажмите на кпопку со стрелкой вниз и <guilabel +>дополнительная панель</guilabel +> закроется. </para> + +</sect2> + + +<sect2 id="panel_toolbar"> +<title +>Панель инструментов</title> +<indexterm +><primary +>Панель инструментов</primary +><secondary +>Панель инструментов</secondary +></indexterm +> + +<para +>Обе панели имеют <link linkend="konfig-looknfeel-ptoolbar" +>настраиваемые панели инструментов</link +>. Панель инструментов или специфичные кнопки можно делать видимыми или скрытыми. <itemizedlist> + + <listitem> + <para +><guibutton +>Кнопка Открыть каталог файлов</guibutton +>: открывает браузер каталогов.</para> + </listitem> + + <listitem> + <para +><guibutton +>Кнопка равно (=)</guibutton +>: меняет каталог в активной панели на каталог неактивной.</para> + </listitem> + + <listitem> + <para +><guibutton +>Кнопка вверх (..)</guibutton +>: переводит активную панель в родительский каталог.</para> + </listitem> + + <listitem> + <para +><guibutton +>Домой (~)</guibutton +>: переход в домашний каталог</para> + </listitem> + + <listitem> + <para +><guibutton +>Корневой каталог(/)</guibutton +>: переход в корневой каталог.</para> + </listitem> + + <listitem> + <para +><guibutton +>Кнопка синхронного режима</guibutton +>: когда активна, каждое изменение любого каталога в панели применяется в другой панели автоматически.</para> + </listitem> + +</itemizedlist> +</para> +</sect2> + + +<sect2 id="folderhistory"> +<title +>История каталогов</title> + +<para +>Обе панели запоминают недавно посещенные каталоги. Нажмите на кнопку <guibutton +>"История каталогов"</guibutton +> ( значок "часы") для открытия истории посещения каталогов. Здесь вы можете быстро выбрать каталог, текущий отмечен галочкой. При каждом новом запуске история очищается. </para> +</sect2> + +</sect1> + + +<sect1 id="cmdline"> +<title +>Командная строка / Эмулятор терминала</title> + +<para +>Эта часть &GUI; имеет два режима: </para> + +<!-- OLD +<screenshot> + <screeninfo +>Command line</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="cmdline.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="cmdline.png" format="EPS"/></imageobject> + <textobject +><phrase +>Command Line</phrase +></textobject> + <caption +><para +>Command Line</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-commandline" float="1"> +<title +>Командная строка</title> +<mediaobject> +<imageobject +><imagedata fileref="cmdline.png"/></imageobject> +<textobject +><phrase +>Командная строка</phrase +></textobject> +</mediaobject> +</figure +> + + +<para +>Традиционный режим предлагает одну строку для ввода команд и две кнопки: <guibutton +>"запускать в теминале"</guibutton +> (иконка терминала) и <guibutton +>"история команд"</guibutton +> (стрелка вниз) справа от поля ввода. Когда вы начнете набирать команду будет предложено "автодополнение", только включите его в &kcontrolcenter;. Если вы хотите изменить поведение автодополнения для текущей сессии - <keycap +>правая кнопка мыши</keycap +> в командной строке и выберите необходимое. Слева в строке ввода вы можете найти локальный путь для активной панели, этот путь путь будет использован при выполнении команды. Введя <userinput +><command +>cd </command +><replaceable +><каталог></replaceable +></userinput +> в командной строке вы также переведете активную панель в этот каталог. Щелкните <link linkend="cmdline_keybindings" +>сюда</link +> для просмотра быстрых клавиш командной строки. </para> + +<!-- +<screenshot> + <screeninfo +>Terminal emulator</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="terminalEmu.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="terminalEmu.png" format="EPS"/></imageobject> + <textobject +><phrase +>Terminal emulator</phrase +></textobject> + <caption +><para +>Terminal emulator</para +></caption> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-terminalemulator" float="1"> +<title +>Эмулятор терминала</title> +<mediaobject> +<imageobject +><imagedata fileref="terminalEmu.png"/></imageobject> +<textobject +><phrase +>Эмулятор терминала</phrase +></textobject> +</mediaobject> +</figure +> + + +<para +>Эмулятор терминала - это фактически маленькая консоль и работает она также. Вы можете изменить активный каталог используя команду <userinput +><command +>cd</command +></userinput +>. Когда вы перетаскиваете файлы из <interface +>"Панели списка"</interface +>, можно выбирать между "Вставить", <command +>cd</command +>, <command +>mv</command +> и <command +>ln</command +>. Если вы перетаскиваете несколько файлов <command +>cd</command +> не доступно. Закрыть эмулятор можно командой <userinput +><command +>exit</command +></userinput +>. </para> + +<para +>Вы можете выбрать режим работы(командная строка, эмулятор, оба или ни одного) при старте Крусадера в &konfigstartpg_lnk; или для текущей сессии в &viewmenu_lnk;. </para> + +</sect1> + +<sect1 id="fnkeys"> +<title +>Функциональные клавиши(FN)</title> + +<!-- OLD +<screenshot> + <screeninfo +>Function (FN) Keys Bar</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="fnkeys.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="fnkeys.png" format="EPS"/></imageobject> + <textobject +><phrase +>Function (FN) Keys Bar</phrase +></textobject> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-fnkeys" float="1"> +<title +>Функциональные клавиши(FN)</title> +<mediaobject> +<imageobject +><imagedata fileref="fnkeys.png"/></imageobject> +<textobject +><phrase +>Функциональные клавиши(FN)</phrase +></textobject> +</mediaobject> +</figure +> + +<para +>Эта панель составлена из названий функций клавиш (FN). Для каждой кнопки на этой панели имеется соотвествующая клавиша, выполняющая определенное действие. Она унаследовала дизайн первых двухпанельных файловых менеджеров и и обычно клавиши используются для двух действий: <keycap +>F2</keycap +> для вызова терминала в текущем каталоге и <keycap +>F9</keycap +> для перемеиновывания файла. <guilabel +>Новый каталог</guilabel +> <keycap +>F7</keycap +> создает целое дерево каталогов на лету, например <literal +>foo/bar/test</literal +>. Вы можете выбрать показывать <link linkend="faqu_resize" +>или нет</link +> <guilabel +>FN панель</guilabel +> при запуске &krusader; через &konfigstartpg_lnk;, и переключать использование для текущей сессии в &viewmenu_lnk;. Действия и &keybindigs_lnk; выполняемые функциональными клавишами настраиваются с версии 1.51 , они остаются активными независимо от того видна <guilabel +>панель FN</guilabel +> или нет. </para> + +</sect1> + + +<sect1 id="folder_tabs"> +<title +>Вкладки каталогов</title> + +<!-- OLD +<screenshot> + <screeninfo +>Tabbed browsing</screeninfo> + <mediaobject> + <imageobject +><imagedata fileref="tabbed_browsing.png" format="PNG"/></imageobject> + <imageobject +><imagedata fileref="tabbed_browsing.png" format="EPS"/></imageobject> + <textobject +><phrase +>Tabbed browsing</phrase +></textobject> + </mediaobject> +</screenshot> +--> + +<figure id="screenshot-tabbedbrowsing" float="1"> +<title +>Вкладки каталогов</title> +<mediaobject> +<imageobject +><imagedata fileref="tabbed_browsing.png"/></imageobject> +<textobject +><phrase +>Вкладки каталогов</phrase +></textobject> +</mediaobject> +</figure +> + + +<para +>Используя &folder_tabs; вы можете быстро изменять многочисленные каталоги, каждая панель имеет свою &folder_tabs;. Положение во вкладках сохраняется при закрытии Крусадера. Переключаться между вкладками можно с помощью мыши. В неиспользуемых вкладках полный путь отображается в сжатом виде. Для вкладок доступны следующие операции: <itemizedlist> + + <listitem> + <para +><keycap +>открыть новую вкладку</keycap +> и остаться в текущем каталоге: &right_click; в каталоге и выбрать <keycap +>открыть в новой вкладке</keycap +>, или &MMB;, или <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>n</keycap +></keycombo +>. </para> + </listitem> + + <listitem> + <para +><keycap +>дублировать вкладку</keycap +>: &right_click; на вкладке и выбрать <keycap +>дублировать вкладку</keycap +>, или <keycombo action="simul" +>&Alt;&Ctrl;&Shift;<keycap +>n</keycap +></keycombo +>. </para> + </listitem> + + <listitem> + <para +><keycap +>закрыть вкладку</keycap +> (исключая левую): &right_click; на вкладке и выбрать <keycap +>закрыть вкладку</keycap +>, или &MMB;, или использовать кнопку <guibutton +>"красный крест"</guibutton +> или <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>c</keycap +></keycombo +>. </para> + </listitem> + + <listitem> + <para +>открыть <keycap +>вкладку в "домашнем каталоге"</keycap +>: нажмите на кнопку <guibutton +>Новая вкладка</guibutton +>. </para> + </listitem> + + <listitem> + <para +><keycap +>сменить вкладку</keycap +>: <keycombo action="simul" +>&Shift;<keycap +>Стрелка влево</keycap +></keycombo +> или <keycombo action="simul" +>&Shift;<keycap +>Стрелка вправо</keycap +></keycombo +>. </para> + </listitem> + + <listitem> + <para +>Для открытия текущего каталога в новой вкладке используйте <keycombo action="simul" +>&Ctrl;&Alt;&Enter;</keycombo +> </para> + </listitem> + +</itemizedlist> +</para> +</sect1> + + +<sect1 id="ui_buutons"> +<title +>Кнопки</title> + +<para +>Для быстрых операций доступны следующие кнопки: &main_toolbar_lnk;, &actions_toolbar_lnk;, <link linkend="panel_toolbar" +>Панель инструментов</link +>, <link linkend="list_panel" +>Очистить панель адреса</link +>, <link linkend="list_panel" +>Медиа</link +>, <link linkend="panel_toolbar" +>История каталогов</link +>, <link linkend="bookman" +>Закладки</link +>, <link linkend="folder_tabs" +>Вкладки</link +>, <link linkend="cmdline" +>Командная строка</link +>, <link linkend="fnkeys" +>Функциональные клавиши</link +>. </para> +</sect1> + +</chapter> + diff --git a/doc/ru/useraction-xml.docbook b/doc/ru/useraction-xml.docbook new file mode 100644 index 0000000..9c0a290 --- /dev/null +++ b/doc/ru/useraction-xml.docbook @@ -0,0 +1,338 @@ +<appendix id= "useraction_xml"> + +<!-- ********************************************************************** + installation.docbook + ++++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>useraction.xml</title> +<para +>This appendix gives several examples of <filename +>useraction.xml</filename +> files. With this you can begin to discover the power of the &useractions_lnk; and start learning how to use them. Once you understand how to write UserActions you will find that &krusader; is an even more powerful, customizable tool. </para> + +<para +>Please consider to upload your UserActions at &kde_files_url;. We are collecting UserActions, if your UserAction is selected by us it will be shipped with &krusader; at the next release. We provide also an &useractionsforum_url;. </para> + +<itemizedlist> + <listitem +><para +>Runs <command +>uptime</command +> <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="uptime" > + <title>Up-time</title> + <tooltip>tells how long since the computer has been booted</tooltip> + <icon>clock</icon> + <category>information</category> + <description>tells how long since the computer has been booted</description> + <command executionmode="collect_output" >uptime</command> + <defaultshortcut>Alt+Ctrl+U</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Runs <command +>ls -l</command +> <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="ls -l" > + <title>ls -l in current dir</title> + <description>Runs ls -l in current dir</description> + <command executionmode="collect_output" >ls -l %aPath% %oPath%</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Echo Placeholder <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> + <KrusaderUserActions> + <action name="test_placeholder" > + <title>Echo Placeholder</title> + <tooltip>Echo's the placeholder values</tooltip> + <category>Testing</category> + <description>Echo's the placeholder values</description> + <command executionmode="collect_output" onmultiplefiles="call_each" >echo -e "aPath %aPath()% \naCurrent: %aCurrent()%"</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>This useraction copies current path and filename to clipboard: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="clipboard current" > + <title>Copy to Clipboard</title> + <tooltip>Copy to clipboard</tooltip> + <icon>klipper</icon> + <category>System</category> + <description>Copy current path and filename to clipboard</description> + <command>%_Clipboard("%aCurrent%")%</command> + <defaultshortcut>Win+C</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Selects <literal role="extension" +>.diff</literal +> and <literal role="extension" +>*.h</literal +> in the active panel: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="test_select" > + <title>Add selection *.diff and *.h</title> + <category>Selection</category> + <command>%aSelect("*.diff", "add")% %aSelect("*.h", "add")%</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Active panel changes to <filename +>mnt/floppy</filename +> (bookmark): <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<action name="mnt/floppy bookmark" > + <title>Jump to /mnt/floppy</title> + <category>Bookmarks</category> + <command>%aGoto("/mnt/floppy", "yes")%</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Select in the non-active panel, all filenames that are highlighted in the active panel: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> + <action name="asdfasdf" > + <title>Select in Other Panel</title> + <category>Selection</category> + <description>Select all filenames that are selected in the active panel, also in the non-active panel</description> + <command>%oSelect("%aList("selected", " ", "Yes")%")%</command> + </action> +</KrusaderUserActions</programlisting> + </para +></listitem> + + <listitem +><para +>Make a backup of the current file/folder to <filename +>foo.bak</filename +> into the current directory: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="backup current" > + <title>Backup in Current Directory</title> + <tooltip>Backup in current directory</tooltip> + <icon>filesaveas</icon> + <category>System</category> + <description>Backup in current directory</description> + <command>%_Copy("%aCurrent%", "%_Ask("new name", "%aCurrent%.bak")")%</command> + <defaultshortcut>Shift+F5</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Opens <link linkend="krusearcher" +>KruSearcher</link +>: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="search" > + <title>Search Test</title> + <command>%_NewSearch("Search 2")%</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Sets the selected picture as wallpaper: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="set wallpaper" > + <title>Set as Wallpaper</title> + <tooltip>Set as wallpaper</tooltip> + <icon>image</icon> + <category>Service Menu</category> + <description>Set as wallpaper (scaled)</description> + <command>dcop kdesktop KBackgroundIface setWallpaper "%aCurrent%" 6</command> + <defaultshortcut>Win+W</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>This useraction edits a file with root permissions using <command +>kdesu</command +>: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="edit as root" > + <title>Edit as Root</title> + <tooltip>Edit as root</tooltip> + <icon>kwrite</icon> + <category>System</category> + <description>Edit a file with root permissions using kdesu</description> + <command>kdesu kedit %aCurrent%</command> + <defaultshortcut>Win+F4</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>This useraction Add item(s) to Amarok playlist: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="amarok enqueue" > + <title>Enqueue in Amarok</title> + <tooltip>Append selected item(s) to Amarok playlist</tooltip> + <icon>amarok</icon> + <category>Multimedia</category> + <description>Append selected item(s) to Amarok playlist</description> + <command>amarok --append %aList("Selected")%</command> + <defaultshortcut>Win+A</defaultshortcut> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Opens &synchronizer_lnk;: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="synchronizer" > + <title>Synchronizer</title> + <command>%_Sync("Sync 2")%</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Copy selected files & directories with root privileges (also inside archives): <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="root_copy" > + <title>Copy as "root"</title> + <tooltip>Copy as "root"</tooltip> + <icon>editcopy</icon> + <category>Selection</category> + <description>Copy selected files & directories with root privileges, also inside archives!</description> + <command run_as="root" accept="url">kfmclient copy %aList("Selected", " ", "No")% %oPath%</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + <listitem +><para +>Search and replace a strings and regular expressions in textfiles using <command +>sed</command +>: <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="search_replace" > + <title>Simple Search and Replace</title> + <tooltip>Search and replace a string/regex in textfiles</tooltip> + <icon>kcachegrind</icon> + <category>Samples</category> + <description>This UA uses the UNIX standard-tool sed (the stream-editor) so perform search and replace operations in all selected files It is possible to give a regular expression for both strings. Please note: The sed-command is "s/search/repleace/", so you have to escape the slash when you need it!</description> + <command>sed -i -e 's/%_Ask("Search for:")%/%_Ask("Replace with:")%/' %aList("Selected")%</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + + + <listitem +><para +>Converts content of selected text-files from ISO-8859-15 to UTF8 and vice versa using <command +>iconv</command +> (also inside archives): <programlisting +><?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE KrusaderUserActions> +<KrusaderUserActions> + <action name="iso8859-15_to_utf8" > + <title>ISO 8859-15 => UTF8</title> + <tooltip>convert characterset</tooltip> + <icon>editcopy</icon> + <category>Selection</category> + <description>Converts content of selected text-files from ISO-8859-15 to UTF8</description> + <command>sh -c 'cd %aPath%; for i in %aList("Selected", " ", "Yes")% ; do iconv -f iso8859-15 -t utf-8 "$i" -o %oPath%"$i"; done '</command> + </action> + <action name="utf8_to_iso8859-15" > + <title>UTF8 => ISO 8859-15</title> + <tooltip>convert characterset</tooltip> + <icon>editcopy</icon> + <category>Selection</category> + <description>Converts content of selected text-files from UTF8 to ISO-8859-15</description> + <command>sh -c 'cd %aPath%; for i in %aList("Selected", " ", "Yes")% ; do iconv -f utf-8 -t iso8859-15 "$i" -o %oPath%"$i"; done '</command> + </action> +</KrusaderUserActions></programlisting> + </para +></listitem> + +</itemizedlist> + +</appendix> diff --git a/doc/ru/using-krusader.docbook b/doc/ru/using-krusader.docbook new file mode 100644 index 0000000..d336b61 --- /dev/null +++ b/doc/ru/using-krusader.docbook @@ -0,0 +1,977 @@ +<chapter id="using-krusader"> + +<!-- ********************************************************************** + using-krusader.docbook + +++++++++++++++++++++++++++ + copyright : (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006 + Rafi Yanai, Shie Erlich, Frank Schoolmeesters + & the Krusader Krew + e-mail : [email protected] + web site : http://www.krusader.org + description : a Krusader Documentation File + +*************************************************************************** +* Permission is granted to copy, distribute and/or modify this * +* document under the terms of the GNU Free Documentation License, * +* Version 1.1 or any later version published by the Free Software * +* Foundation; with no Invariant Sections, no Front-Cover Texts and * +* no Back-Cover Texts. A copy of the license is available on the * +* GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +* MA 02110-1301, USA. * +*********************************************************************** --> + +<title +>Using &krusader;</title> + +<sect1 id="controls"> +<title +>Controls</title> + +<sect2 id="control-general"> +<title +>General</title> + +<para +>This is a rather short but important section that will go into the details of controlling &krusader;. This section doesn't try to cover all the various key combinations for two reasons: <orderedlist numeration="arabic" +> <listitem +> <para +>there are just too many of them</para +> </listitem +> <listitem +> <para +>most of &krusader;'s actions are configurable in the &konfiglookandfeel_lnk;</para +> </listitem +> </orderedlist +> We will only mention the most important keyboard shortcuts with the default configuration but keep in mind that most of the &keybindigs_lnk; are configurable. If you find that you use a certain command a lot and want to know the shortcut for this command, or you want to change this command shortcut, then check out the &keybindigs_lnk; tab at the &konfiglookandfeel_lnk;.</para> +</sect2> + +<sect2 id="moving-around"> +<title +>Moving Around</title> +<para +>By Moving Around we mean the transfer of the keyboard and mouse focus between the different parts of the &krusader; <link linkend="mainwindow" +>main window</link +>. The focus can be in one of five places: the Left or Right Panel, the Menu Bar, the Command Line or the Terminal Emulator. The panel that has the focus is called the Active Panel. An Active Panel will remain active until the other panel receives the focus (&ie;: if the Left Panel was active and you clicked on the Command Line - then the Left Panel remains the Active Panel). You must deliberately change which panel is active.</para> + +<para +>The most common way to transfer the focus to a specific panel is to use the mouse to click on that panel. But you should be aware of the following: <itemizedlist> + <listitem> + <para +>Clicking on the Toolbar, the FN keys bar or the Status Bar does *not* change the focus.</para> + </listitem> + +<!-- + Quick View Panel: old Krusader feature , removed since krusader-1.12-beta1 + <listitem> + <para +>The display part of the Quick View Panel does not accept clicks so you should click on the + Location Toolbar of this panel if you want it to have focus.</para> + </listitem> +--> + + <listitem> + <para +>Pushing the <guibutton +>"History"</guibutton +> or the <guibutton +>"Run in Terminal"</guibutton +> buttons in the Command Line will not transfer the focus so you have click inside the Input Line.</para> + </listitem> + + <listitem> + <para +>The Menu Bar can get the focus by choosing a menu but it keeps the focus until you choose a command, and then the focus returns to the previous owner.</para> + </listitem> +</itemizedlist> +</para> + +<para +>There are, of course, ways to use the keyboard to change the focus <itemizedlist> + <listitem +><para +>The 	 Key will switch panels if one of the panel has the focus, or rotate between all the commands in a menu if the Menu Bar is active.</para> + </listitem> + <listitem +><para +>The <keycombo action="simul" +>&Ctrl;<keycap +>Down Arrow</keycap +></keycombo +> will take you from the Active Panel to the Command Line or Terminal Emulator, and the <keycombo action="simul" +>&Ctrl;<keycap +>Up Arrow</keycap +></keycombo +> will take you back from the Command Line to the Active Panel.</para> + </listitem> + <listitem +><para +>The &Esc; Key will make the Menu Bar return the focus, if it has it, to the previous Active Panel.</para> + </listitem> + <listitem +><para +>If you happen to be inside the Terminal Emulator, you can use the 	 Key, or the mouse, to navigate to an Active Panel.</para> + </listitem> + <listitem +><para +>Pressing <keycombo action="simul" +>&Alt;<keycap +>"Underlined Letter"</keycap +></keycombo +> from the Menu Bar will open that menu (unless this key combination is a "Reserved Key", used by one of &krusader;'s actions).</para> + </listitem> +</itemizedlist> +</para> +</sect2> + + +<sect2 id="marking-files"> +<title +>Marking (Selecting)</title> + +<note +><para +>&krusader; offers 4 &mouse_selection_modes_lnk;, only &krusader;'s Mouse Selection Mode is explained here.</para +></note> + +<para +>Marking is a skill you need to master in order to get the most out of &krusader;. Since you can't select files in the Quick View Panel, and the Tree Panel only lets you select one directory at a time, this paragraph mainly explains how to select files in the List Panel filelist.</para> + +<para +>Moving the cursor is easy. Left-clicking on a file or directory (referred to herein as "elements" meaning, files AND directories) will select it. Here are some useful pointers that will make Krusader even easier to use: (assuming you're using &krusader;'s Mouse Selection Mode) <itemizedlist> + <listitem +><para +>The <keycap +>SPACE</keycap +> and <keycap +>Insert</keycap +> key will toggle the marking of the file under the cursor without affecting the marking of other files/directories, the cussor will go one position down.</para> + </listitem> + + <listitem +><para +>Pressing the <keycap +>SPACE</keycap +> on a Directory under the cursor will <link linkend="calculate" +>calculate occupied space</link +> without affecting the marking of other files/directories.</para> + </listitem> + + <listitem +><para +><keycap +>Left Clicking</keycap +> on a file will select, or unselect, all previously marked files.</para> + </listitem> + + <listitem +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Left Clicking</keycap +></keycombo +> will toggle the marking of the file under the cursor without affecting the marking of other files/directories.</para> + </listitem> + + <listitem +><para +><keycombo action="simul" +>&Shift;<keycap +>Left Clicking</keycap +></keycombo +> will select all the elements between the previous cursor location and the new one.</para> + </listitem> + + <listitem +><para +><keycombo action="simul" +>&Shift;<keycap +>Home</keycap +></keycombo +> selects everything above the cursor (and unselect everthing below the cusror if marked).</para> + </listitem> + + <listitem +><para +><keycombo action="simul" +>&Shift;<keycap +>End</keycap +></keycombo +> selects everything below the cursor (and unselect everthing above the cusror if marked).</para> + </listitem> + + <listitem +><para +>The ".." entry is not markable.</para> + </listitem> + + <listitem +><para +>The &editmenu_lnk; can offer more ways to select your files.</para> + </listitem> + +</itemizedlist> +</para> +</sect2> + + +<sect2 id="executing_commands"> +<title +>Executing Commands</title> +<para +>There isn't a lot to say here, all you need to do is select some files (if you don't &krusader; will operate on the file(s) or directory(s) that have the focus), choose a <link linkend="menu-commands" +>Command</link +> from the Menu Bar or use a Keyboard Shortcut (or the Right Click Menu) and the selected Command executes. See also <link linkend="executing_files" +>Executing Files</link +>. </para> +</sect2> + + +<sect2 id="quicksearch"> +<title +>Quicksearch</title> +<!-- Thanks to Heiner Eichmann --> + +<para +>This feature will do a quick search for the file name in the Active List Panel.</para> + +<para +>There are two quick search methods: <itemizedlist> + <listitem +><para +>"Old Quicksearch": type <keycap +>foo</keycap +> (one character) to do a quick search in the Active List Panel for a file beginning with "foo".</para> + </listitem> + <listitem +><para +>"New Quicksearch": type <keycap +>foo</keycap +> to open the small quick search dialog box below the Active List Panel. Type the first few characters of the desired filename (more than one character allowed), the cursor will jump to that filename (if it exists), ⪚ type "ab" to search for a file which begins with "ab". The <keycap +>Up/Down Arrow</keycap +> will jump to the next or previous match. &Esc; will close the quicksearch line. The cursor will stay on the last Quicksearch file found. </para +></listitem> + </itemizedlist> +</para> + +<note +><para +>If you press <keycombo action="simul" +>&Alt;<keycap +>foo</keycap +></keycombo +>, the key binding shortcut will be executed. If there is no configured key binding, the remaining letter <keycap +>foo</keycap +> will used for the quick search.</para +></note> + +<para +>Use &konfiglookandfeel_lnk; to change from the default configuration.</para> +</sect2> + +<sect2 id="context-menu"> +<title +>Context Menu</title> + +<para +>&krusader; has many Context menus that allow you to do fast operations with the mouse, usually a Right-Click will open the Context menu (depending on your &mouse_selection_modes_lnk; settings). This list gives an overview of the most important Context menus, use them to discover the available commands. <itemizedlist> + <listitem +><para +>&main_toolbar_lnk; (orientation, text position , icon size)</para +></listitem> + <listitem +><para +>&list_panel_lnk; on a file or directory</para +></listitem> + <listitem +><para +>&cmdline_lnk; (undo, paste, text completion, ...)</para +></listitem> + <listitem +><para +>&termemu_lnk; (send signal, font, history, ...)</para +></listitem> + <listitem +><para +>&foldertabs_lnk; (new, duplicate, close)</para +></listitem> + <listitem +><para +><link linkend="krusearcher" +>KruSearcher</link +> Search results file list (F3 View, F4 Edit)</para +></listitem> + <listitem +><para +>&mountman_lnk; (unmount, format, ...)</para +></listitem> + <listitem +><para +>&syncdirs_lnk; File List</para +></listitem> + <listitem +><para +>&useractions_lnk;</para +></listitem> + <listitem +><para +>&konqueror; Right-Click actions are shown in &krusader;</para +></listitem> + <listitem +><para +>Show/hide <link linkend="list_panel" +>Column Headers</link +></para +></listitem> + <listitem +><para +>...</para +></listitem> +</itemizedlist> +</para> +</sect2> + +</sect1> + +<sect1 id="basic"> +<title +>Basic File Management</title> + +<sect2 id="executing_files"> +<title +>Executing Files</title> +<para +>You can only execute files in the Active List Panel. To <keycap +>execute</keycap +> a file just <keycap +>(double-)click on it or press Enter</keycap +> when it is under the list cursor. &krusader; will open it in the default application for this file type (picture, textfile, ...) or the file will be executed (script, binary, ...). If you want to use <keycap +>another application</keycap +> to open the file, then <keycap +>Right-Click</keycap +> on the file and go to the "open with" sub-menu which will offer more options. &krusader; is compatible with &kde; default file-manager for all file types except archives that are opened inside the &krusader; panel and not in an external application. See <link linkend="konfig-archives" +>the archives page in Konfigurator</link +> for details.</para> +</sect2> + + +<sect2 id="copying"> +<title +>Copying and Moving</title> +<para +>To copy or move files/directories just select them and press <keycap +>F5</keycap +> to <keycap +>copy</keycap +> or <keycap +>F6</keycap +> to <keycap +>move</keycap +> them. If checked the <guimenuitem +>Preserve attributes (only on local targets)</guimenuitem +> option, &krusader; will try to preserve all attributes (time, owner, group) of the local files according to the source depending on your permissions: <itemizedlist +> <listitem +><para +>User preserving if you are root</para +></listitem +> <listitem +><para +>Group preserving if you are root or member of the group</para +></listitem +> <listitem +><para +>Preserving the timestamp</para +></listitem +> </itemizedlist +> Using this option might slow down the copy/move process. A dialog will appear and allow you to choose the operation destination, the default destination is the other-panel browsed directory. If you enter a partial &URL; &krusader; will use the current panel directory as the &URL; base.</para> +</sect2> + + +<sect2 id="deleting"> +<title +>Deleting</title> +<para +>Deleting files/directories is done by marking them and pressing <keycap +>F8</keycap +> or <keycap +>Delete</keycap +>. By <link linkend="konfig-general" +>default</link +> it will be moved to &kde;'s Trash, <keycombo action="simul" +>&Shift;<keycap +>Delete</keycap +></keycombo +> will delete the file permanently. A dialog will ask for your confirmation and will warn you when deleting non-empty directories. Of course only operations that you are permitted to do by the Operating System will be performed - you will be notified otherwise. If you don't wish to see the confirmation dialogs, you can disable them in the <link linkend="konfig-advanced" +>Konfigurator advanced tab</link +>.</para> +</sect2> + + +<sect2 id="renaming"> +<title +>Renaming files, Creating Directories, and Link Handling</title> +<para +><keycap +>Rename</keycap +> the file under the cursor with the <keycap +>F9</keycap +> key or with two single mouseclicks. If only the filename needs to be renamed and not the extension you can configure this in the &konfiglookandfeel_lnk;. <keycap +>Create a new directory</keycap +> with the <keycap +>F7</keycap +> key. <keycap +>Right-clicking on a regular file</keycap +> will give you the <keycap +>option "New Symlink"</keycap +>, a dialog will prompt you to enter a symlink name. That name will point to the file/directory you Right-Clicked on. If the file you Right-Clicked on is a symlink you will also be presented with the "redirect link" option that will allow you change the link target.</para> +</sect2> + + +<sect2 id="viewing"> +<title +>Viewing and Editing files</title> +<para +><link linkend="krviewer" +>KrViewer</link +> has a chapter of its own.</para> +</sect2> + +</sect1> + +<sect1 id="archives"> +<title +>Archive Handling</title> + +<sect2 id="browsing-archives"> +<title +>Browsing Archives</title> +<para +>The &vfs_lnk; allows to browse archives as it was a directory. &krusader; supports currently the following archives types: ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip and supports the next passworded archives: arj, ace, rar and zip. Passwords can be stored in &kwallet;. Please note that the archive support first needs to be properly <link linkend="konfig-archives" +>configured</link +> in Konfigurator. To open the archive use &Enter;, (double-)click or the <keycap +>Right Arrow</keycap +>. &krusader; supports also <emphasis role="bold" +>hidden archives</emphasis +>, these are renamed archives with a *wrong* extension. ⪚ &openoffice; uses zip archives with the next extensions: odt, sxw and odw. &Enter; will open the &openoffice; document and the <keycap +>Right Arrow</keycap +> will open the archive. An other example is J2EE where the rar extension means a zip archive. &krusader; will open with <keycap +>Right Arrow</keycap +> the archive even if it has an other mime type, since &krusader; autodetects the supported archive types. Please note that browsing archives has a few limitations: <itemizedlist> + <listitem +><para +>Not all functions are supported by all archive types. (&ie;: you can't delete files in ace or rar archives)</para> + </listitem> + <listitem +><para +>The permissions you have inside the archive are the same as the permissions you have for the archive.</para> + </listitem> + <listitem +><para +>The command line (if visible) will not follow you inside the archive but will point to the archive directory.</para> + </listitem> + <listitem +><para +>Before any action is performed on files/directories inside the archive they must be extracted. The archive will be repacked when you leave it or when &krusader; detects that extracted files have changed.</para> + </listitem> + <listitem +><para +>Packing and un-packing are "blocking operations" that display a Progress Dialog. Though, this might change in the future since we are planning to create more background operations.</para> + </listitem> +</itemizedlist> +</para> +</sect2> + + +<sect2 id="unpacking-archives"> +<title +>Unpack Files</title> +<para +>There are 2 ways to extract files from archives:</para> + +<para +>If you want to unpack a whole archive(s), browse to the archive location, select the archive(s) and select <emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Unpack</guimenuitem +></menuchoice +></emphasis +> or <keycombo action="simul" +>&Alt;<keycap +>U</keycap +></keycombo +>. &krusader; will ask you where to put the extracted files, the default location is the inactive panel directory. If you don't cancel the operation, &krusader; will try to unpack all the selected files in the inactive panel.</para> + +<para +>If you only want to extract part of the archive, then <link linkend="browsing-archives" +>browse</link +> the archive and copy the files you want to extract to their new location just as you would copy "normal" files. Note that unpacking from a browsed archive takes more time (file by file unpack) compared to unpacking a whole archive with the first method.</para> +</sect2> + + +<sect2 id="pack-archive"> +<title +>Packing Files</title> +<para +>If you want to create a new archive, begin by marking the elements you want to pack in the active panel and select <emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Pack</guimenuitem +></menuchoice +></emphasis +> or <keycombo action="simul" +>&Alt;<keycap +>P</keycap +></keycombo +>. A dialog will pop-up, prompting you to select the archive name and location, you select the packer by selecting one of the <link linkend="konfig-archives" +>supported filename extensions</link +>.</para> + +<para +>To add files to an existing archives, open the archive in one panel and the files to be copied in the other panel, then simply copy the files into the archive in exactly the same way you copy files into a "normal" directory.</para> +</sect2> + + +<sect2 id="test-archive"> +<title +>Testing Archives</title> +<para +>Krusader will not handle corrupted archives since it may result in data loss. If you receive an error message when opening an archive, or if you suspect that there something wrong with the archive you should test it before use. To test an archive, browse (navigate) to the archive location, select the archive. Next select <emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Test Archive</guimenuitem +></menuchoice +></emphasis +> or <keycombo action="simul" +>&Alt;<keycap +>E</keycap +></keycombo +>. &krusader; will test the archive file and inform you if the archive passed or failed the file integrity test.</para> +</sect2> + + +</sect1> + + +<sect1 id="more-features"> +<title +>More features</title> + +<sect2 id="vfs"> +<title +>Virtual file systems (VFS)</title> +<indexterm +><primary +>VFS</primary +></indexterm> + +<para +>A basic <link linkend="features" +>OFM feature</link +> is VFS, this an abstracted layer over all kinds of archived information (ZIP files, FTP servers, TAR archives, NFS filesystems, SAMBA shares, ISO cd/dvd images, RPM catalogs, etc.), which allows the user to access all the information in these divergent types of filesystems transparently - just like entering an ordinary sub-directory! &krusader; supports several VFS: <itemizedlist +> <listitem +><para +><link linkend="remote-connections" +>Remote connections VFS</link +>: provides the capability of working with a remote connection session (FTP, NFS, Samba, FISH, SFTP) like with local filesystems. It's perfect for complex remote operations and almost as powerful as most standalone GUI remote clients.</para +> </listitem +> <listitem +><para +><link linkend="archives" +>Archive VFS</link +>: allows to browse archives in VFS as it was a directory (ace, arj, bzip2, deb, gzip, iso, lha, rar, rpm, tar, zip and 7-zip).</para +> </listitem +> <listitem +><para +><link linkend="archives" +>Search VFS</link +>: <guibutton +>Feed to listbox</guibutton +> will place the search results in VFS. </para +> </listitem +> <listitem +><para +><link linkend="synchronizer" +>Synchronizer VFS</link +>: places the synchronizer results in VFS. </para +> </listitem +> </itemizedlist +> Actions you perform on the files in VFS are performed on the 'real' files. You don't just delete files from the VFS - you delete them from your hard drive. Limitations: you can't create directories inside in a VFS. </para> + +</sect2> + + +<sect2 id="compare"> +<title +>Compare</title> +<para +>&krusader; contains several compare functions: <guimenuitem +>Compare by content</guimenuitem +>, <guimenuitem +>Compare Directories</guimenuitem +> and the <link linkend="synchronizer" +>Synchronizer</link +> compare function. </para> + + +<sect3 id="compare-content"> +<title +>Compare by Content</title> +<para +>Select in each panel one file, and use <emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Compare by content</guimenuitem +></menuchoice +></emphasis +>. &krusader; will open a external graphical difference tool that is <link linkend="konfig-dependencies" +>configured</link +>, right now &kompare;, &kdiff3_url; and &xxdiff_url; are supported. </para> +</sect3> + + +<sect3 id="compare-dir"> +<title +>Compare Directories</title> +<para +>Compare the files of each panel by using <emphasis role="bold" +><menuchoice +><guimenu +>Mark</guimenu +> <guimenuitem +>Compare Directories</guimenuitem +></menuchoice +></emphasis +>. By default newer and single files will be selected in each panel, this behaviour can be changed in the <guimenuitem +>Compare Setup</guimenuitem +> menu. <note +><para +>The files are not compared by content but by their names and dates only.</para +></note> +</para> + +<variablelist> +<varlistentry> + <term +><menuchoice +><guimenu +>Mark</guimenu +> <guimenuitem +>Compare Setup</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Configures the <guimenuitem +>Compare Directories</guimenuitem +> function.</para> + <itemizedlist> + <listitem +><para +><guimenuitem +>Mark Newer and Single</guimenuitem +> (default) </para +></listitem> + <listitem +><para +><guimenuitem +>Mark Single</guimenuitem> + </para +></listitem> + <listitem +><para +><guimenuitem +>Mark Newer</guimenuitem> + </para +></listitem> + <listitem +><para +><guimenuitem +>Mark Different and Single</guimenuitem> + </para +></listitem> + <listitem +><para +><guimenuitem +>Mark Different</guimenuitem> + </para +></listitem> + </itemizedlist> + </listitem> + </varlistentry> +</variablelist> + +</sect3> + +</sect2> + +<sect2 id="calculate"> +<title +>Calculate Occupied Space</title> +<!-- Thanks to Heiner Eichmann --> + +<para +>There are two ways to calculate the occupied space of files/directories. <itemizedlist +> <listitem +> <para +>Pressing the <keycap +>SPACE</keycap +> on a directory under the cursor instantly calculates the occupied size. Pressing <keycap +>SPACE</keycap +> a second time will toggle the marking of the directory without affecting the selection status of other files/directories.</para +></listitem +> <listitem +> <para +>To calculate how much disk space is occupied by the marked files and directories in the active panel select <emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Calculate Occupied Space</guimenuitem +></menuchoice +></emphasis +>. After a (hopefully) small delay, a dialog box will be displayed with total occupied space and the number of files and directories you selected. The space occupied by every selected directory will be shown as if the user just pressed <keycap +>SPACE</keycap +> on that directories. If the active panel is browsing an archive, the numbers will apply to the *unpacked* size of the selected files and directories, not their compressed size. After the calculation the marking state will toggle and the cusor will move one position down.</para +> </listitem +> </itemizedlist +> Calculating the occupied space on remote filesystems is supported. <note +><para +>Performing this operation on a very large filesystem (thousands of files) may be time consuming. You can always cancel the calculation process at any time by clicking on the <guibutton +>Cancel</guibutton +> button.</para +></note> + +</para> +</sect2> + +<sect2 id="splitter"> +<title +>File Splitter</title> + +<para +>This function splits one (big) file up into multiple smaller files so that they can be placed on several smaller media (⪚ zip-drives, ...) or sent by e-mail. The multiple files can be combined again to recreate the original file. &krusader; and &tcmd; split/combine functions are compatible. To split a file choose <emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Split</guimenuitem +></menuchoice +> </emphasis +> or <keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +> A Split dialog will open to confirm the operation.</para> + +<para +>If the name of the original file is <filename +>foo</filename +>, then the name of the smaller files will be <filename +>foo.000 foo.001 foo.002</filename +> &etc; There is no theoretical limit in the number of smaller files, but it is recommended to limit the number to a max of 1023 files. &krusader; creates a <filename +>foo.crc</filename +> file. This file contains the name, size and the crc checksum of the original file. It's possible to combine the file without the <filename +>foo.crc</filename +> file but in this case &krusader; can't check if the the original file was recreated correctly.</para> + +<para +>An example of a <filename +>foo.crc</filename +> file: <programlisting +>filename=foo + size=432998467868 + crc32=21EB719A</programlisting> +</para> + + +<para +>To combine the multiple files choose, select a partial file <filename +>foo.xxx</filename +> and choose <emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Combine files</guimenuitem +></menuchoice +></emphasis +> or <keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +>. The target directory is the unactive panel and can be changed. The file names must be numbered in ascending order: <filename +>foo.001, foo.002, foo.003</filename +> &etc; or have letters in ascending order: ("<userinput +><command +>split</command +> <option +>-b</option +></userinput +> letter method") <filename +>fileaa, fileab, fileac</filename +> &etc; If the file <filename +>foo.crc</filename +> is found in the same directory as the partial files, &krusader; will use this file to check the combined file for errors.</para> + +</sect2> + + + +<sect2 id="checksum"> +<title +>Checksum creation-verification</title> + +<para +><emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Create Checksum</guimenuitem +></menuchoice +></emphasis +> : &krusader; checks which tools you have and if those tools allow recursive operation (in case you selected folders), you choose the type of checksum (md5, sha...) and it is generated. You can then save the checksum to a file, usually called checksum.md5 (or .sha1 or whatever). </para> + +<para +><emphasis role="bold" +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Verify Checksum</guimenuitem +></menuchoice +></emphasis +> : &krusader; checks if you have a tool that supports the type of checksum you need (from your specified checksum file) and displays the files that failed the checksum (if any). </para> + +<para +>The nice thing is that the system abstracts over different checksum mechanisms and different binaries. Right now, it supports md5, sha1, sha256, tiger, whirlpool and cfv. You probably have md5sum and sha1sum already, external supported tools are md5deep (sha256, tiger, whirlpool) and cfv. </para> + +</sect2> + +<sect2 id="send-email"> +<title +>Send Files by e-mail</title> +<para +>Select a file and use <emphasis role="bold" +><menuchoice +><guimenu +>Right-Click menu</guimenu +> <guimenuitem +>Send by Email</guimenuitem +></menuchoice +></emphasis +>. Selecting this option will open a new &kmail; window with the file already attached. Just fill in the subject and recipient(s) and send it. Of course, &kmail; must be properly configured. </para> +</sect2> + + +<sect2 id="shred"> +<title +>Shred Files</title> +<para +>When you delete files in your local system they are not completely erased and the information stored in them can be recovered using special software and hardware tools. If you want to erase a file without recoverable traces, select the file and use <emphasis role="bold" +><menuchoice +><guimenu +>Right-Click menu</guimenu +> <guimenuitem +>Shred</guimenuitem +></menuchoice +></emphasis +>. </para> +</sect2> + + + +</sect1> + + + + + + + + + +<sect1 id="profiles"> +<title +>Profiles</title> +<indexterm +><primary +>Profiles</primary +></indexterm> + +<para +>With profiles you can save and restore your favorite settings. Several features supports profiles, you can have ⪚ different panel profiles (work, home, remote connectios, &etc;), search profiles, synchroniser profiles, &etc; </para> + + +<sect2 id="panel_profiles"> +<title +>Panel Profiles</title> +<para +>A panel profile contains: all the tabs paths (left/right), the current tab (left/right), the active panel (left or right), all this information is stored in the &krusaderrc_lnk; file. You can have several Panel profiles ⪚ file-managment, ftp-managment, home, work, etc. The panel profile can be <link linkend="c_panel_profiles" +>saved and restored</link +> in the <guimenu +>Commands menu</guimenu +>. The <link linkend="konfig-startup" +>default startup profile</link +> will be used when starting krusader, with a <link linkend="starting-krusader" +>commandline option</link +> you override the default startup profile. </para> + +</sect2> + + +<sect2 id="color_profiles"> +<title +>Color Profiles</title> +<para +>Colormaps can be saved and restored with <link linkend="konfig-color" +>Color Profiles</link +>. &krusader; Colormaps are available at &kde_files_url;.</para> +</sect2> + + +<sect2 id="key_profiles"> +<title +>Key-binding Profiles</title> +<para +>Keymaps can be saved and restored with <link linkend="configure-shortcuts" +>Key-binding Profiles</link +>. &krusader; Keymaps are available at &kde_files_url;.</para> +</sect2> + + +<sect2 id="search_profiles"> +<title +>Search Profiles</title> +<para +>When you regularly perform the same search operation, than you can save the search settings (⪚ include files, exclude files, &etc;) in a <link linkend="krusearcher" +>Search Profile</link +>.</para> +</sect2> + + +<sect2 id="synchroniser_profiles"> +<title +>Synchroniser Profiles</title> +<para +>When you regularly perform the same synchronise operation, than you can save the synchronise settings in a <link linkend="synchronizer" +>Synchroniser Profile</link +>.</para> + +</sect2> + + +</sect1> + + + +</chapter> + diff --git a/doc/update_docbook b/doc/update_docbook new file mode 100755 index 0000000..5a3e507 --- /dev/null +++ b/doc/update_docbook @@ -0,0 +1,73 @@ +#!/bin/sh + +# *************************************************************************** +# update_docbook +# ++++++++++++++++++++ +# copyright : (C) 2006 +# Frank Schoolmeesters +# & the Krusader Krew +# e-mail : [email protected] +# web site : http://www.krusader.org +# description : update translated docbook files +# +# *************************************************************************** +# * Permission is granted to copy, distribute and/or modify this * +# * document under the terms of the GNU Free Documentation License, * +# * Version 1.1 or any later version published by the Free Software * +# * Foundation; with no Invariant Sections, no Front-Cover Texts and * +# * no Back-Cover Texts. A copy of the license is available on the * +# * GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +# * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +# * MA 02110-1301, USA. * +# *************************************************************************** +# +# This script creates the translated docbook files by inserting the translated po text into the original +# english docbook files in the language folder ../doc/i18n/$lang +# with po2xml *.docbook.po > *.docbook +# Before running this script the according english docbook files need to be copied in the language folder ../doc/i18n/$lang +# for a 100% merge the po and the english docbook files need to have the same date +# The created docbook files needs to be copied into the proper language dir ../doc/$lang + + +# Requirements: bash, po2xml +# usage: run ./update_docbook ru Russian + + +# --help +if test $# -eq 0 || test "$1" = "--help" ; then + echo "update_docbook <lang_subdir> <language>" + exit +fi + +# test if $2 is used +if test $# -eq 0 || test "$2" = "" ; then + echo "update_docbook <lang_subdir> <language>" + exit +fi + +# read first parameter +lang=$1 + +# read second parameter +newlanguage=$2 + +# jump into the lang folder +cd ../doc/i18n/$lang + + +# update +for FILENAME in $(ls *.docbook);do + #display the '*.docbook' filename + echo updating ${FILENAME} ... + # po2xml index_en.docbook index_ru_new.docbook.po > index_ru.docbook + po2xml ${FILENAME} $FILENAME.po > ${FILENAME}.new + # rename docbook.new into docbook + mv $FILENAME.new $FILENAME +done + +# change "English" in to "$newlanguage" in the translated index.docbook file +perl -p -i -e 's/English "INCLUDE"/'$newlanguage' "INCLUDE"/g' index.docbook + +echo NOTE: This script sould only be used by the Documentation i18n coordinator or the Krusader Krew +echo Please contact the Documentation i18n coordinator if you want to translate the Krusader documentation +echo Wrong usage of this script might result in outdated documentation files diff --git a/doc/update_po b/doc/update_po new file mode 100755 index 0000000..af5625c --- /dev/null +++ b/doc/update_po @@ -0,0 +1,68 @@ +#!/bin/sh + +# *************************************************************************** +# merge_po +# ++++++++++++++++++++ +# copyright : (C) 2006 +# Frank Schoolmeesters +# & the Krusader Krew +# e-mail : [email protected] +# web site : http://www.krusader.org +# description : update translated docbook files +# +# *************************************************************************** +# * Permission is granted to copy, distribute and/or modify this * +# * document under the terms of the GNU Free Documentation License, * +# * Version 1.1 or any later version published by the Free Software * +# * Foundation; with no Invariant Sections, no Front-Cover Texts and * +# * no Back-Cover Texts. A copy of the license is available on the * +# * GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +# * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +# * MA 02110-1301, USA. * +# *************************************************************************** +# +# This script merges po files with the latest version of the english pot files in the language folder ../doc/i18n/$lang +# with po2xml *.docbook.po > *.docbook +# Use this script to created the latest version for the po files + + +# Requirements: bash, ./update_pot, msgmerge, msgfmt +# usage: run ./merge_po ru + + +# --help +if test $# -eq 0 || test "$1" = "--help" ; then + echo "update_po <lang_subdir>" + exit +fi + +# create the latest pot templates +./update_pot + +# read first parameter +lang=$1 + +# jump into the lang folder +cd ../doc/i18n/$lang + +# merge po files with the updated english pot files +for FILENAME in $(ls *.po);do + # display the '*.po' filename + echo merging ${FILENAME} ... + FILENAME=`echo ${FILENAME} | perl -p -i -e 's/.po/''/g'` + # make backup copy of the *.po files + cp $FILENAME.po $FILENAME.po.bak + # merge po files with the updated english pot files + msgmerge $FILENAME.po ../pot/${FILENAME}.pot -q --force-po --output-file=${FILENAME}.po.new + # rename po.new into po + mv $FILENAME.po.new $FILENAME.po + # show translation statistics + msgfmt $FILENAME.po --statistics -c -v --output-file=$FILENAME.tmp + echo "" + # delete temporary files 'foo.po.tmp' + rm -f $FILENAME.tmp +done + +echo NOTE: This script sould only be used by the Documentation i18n coordinator or the Krusader Krew +echo Please contact the Documentation i18n coordinator if you want to translate the Krusader documentation +echo Wrong usage of this script might result in outdated documentation files diff --git a/doc/update_pot b/doc/update_pot new file mode 100755 index 0000000..e93e4ef --- /dev/null +++ b/doc/update_pot @@ -0,0 +1,57 @@ +#!/bin/sh + +# *************************************************************************** +# update_pot +# ++++++++++++++++++++ +# copyright : (C) 2006 +# Frank Schoolmeesters +# & the Krusader Krew +# e-mail : [email protected] +# web site : http://www.krusader.org +# description : update translation pot template files +# +# *************************************************************************** +# * Permission is granted to copy, distribute and/or modify this * +# * document under the terms of the GNU Free Documentation License, * +# * Version 1.1 or any later version published by the Free Software * +# * Foundation; with no Invariant Sections, no Front-Cover Texts and * +# * no Back-Cover Texts. A copy of the license is available on the * +# * GNU site http://www.gnu.org/licenses/fdl.html or by writing to: * +# * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, * +# * MA 02110-1301, USA. * +# *************************************************************************** +# +# This script creates *.pot translation template files in the krusader_kde3/doc/i18n folder +# with xml2pot *.docbook > *.docbook.pot + +# Requirements: bash, xml2pot, perl +# usage: run ./update_pot + +# jump into the english folder +cd en + +# grepping version information from index.docbook +VERSION=`grep releaseinfo index.docbook | tr -d '</releaseinfo> ' | tr -d 'a-z' | tr -d 'A-Z' | tr -d '"'` + +# current date +DATENOW=$(date +%Y-%m-%d) + +for FILENAME in $(ls *.docbook);do + echo updating ${FILENAME}.pot ... + # create pot file in the english folder + xml2pot ${FILENAME} > ${FILENAME}.pot + # modify pot header with perl seach/replace function + perl -p -i -e 's/# SOME DESCRIPTIVE TITLE./# Translation of '${FILENAME}' to LANGUAGE +# Copyright (C) 2006, Krusader Krew +# This file is distributed under the same license as the Krusader package/g' ${FILENAME}.pot + perl -p -i -e 's/Project-Id-Version: PACKAGE VERSION/Project-Id-Version: Krusader-doc-'$VERSION' '$DATENOW'/g' ${FILENAME}.pot + perl -p -i -e 's/Report-Msgid-Bugs-To: http:\/\/bugs.kde.org/Report-Msgid-Bugs-To: <frank_schoolmeesters\@yahoo.com>/g' ${FILENAME}.pot + perl -p -i -e 's/kde-i18n-doc\@kde.org/krusader-i18n\@googlegroups.com/g' ${FILENAME}.pot +done + +# move pot files to folder krusader_kde3/doc/i18n/pot since they don't belong in the english folder +mv *.pot ../i18n/pot + +echo NOTE: This script sould only be used by the Documentation i18n coordinator or the Krusader Krew +echo Please contact the Documentation i18n coordinator if you want to translate the Krusader documentation +echo Wrong usage of this script might result in outdated documentation files |