From 0a7dd146a5b291c69f6f3d4a82b7209e6f4e2847 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sl=C3=A1vek=20Banko?= Date: Sat, 27 Aug 2022 10:29:31 +0200 Subject: Move the documentation to a new directory layout. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Slávek Banko --- CMakeLists.txt | 2 +- doc/CMakeLists.txt | 8 - doc/Makefile.am | 4 +- doc/audiocd-howto.docbook | 96 ---- doc/burndialog_audio.png | Bin 19981 -> 0 bytes doc/burndialog_progress.png | Bin 22373 -> 0 bytes doc/cdcloning_dialog.png | Bin 22861 -> 0 bytes doc/cdcloning_reading.png | Bin 15184 -> 0 bytes doc/cdcopy-howto.docbook | 86 ---- doc/cdcopy_done.png | Bin 22176 -> 0 bytes doc/cdcopy_reading.png | Bin 19404 -> 0 bytes doc/cdcopy_settings.png | Bin 21192 -> 0 bytes doc/cdcopy_writing.png | Bin 22507 -> 0 bytes doc/commands.docbook | 700 ------------------------------ doc/dcop.docbook | 104 ----- doc/en/Makefile.am | 3 + doc/en/audiocd-howto.docbook | 96 ++++ doc/en/burndialog_audio.png | Bin 0 -> 19981 bytes doc/en/burndialog_progress.png | Bin 0 -> 22373 bytes doc/en/cdcloning_dialog.png | Bin 0 -> 22861 bytes doc/en/cdcloning_reading.png | Bin 0 -> 15184 bytes doc/en/cdcopy-howto.docbook | 86 ++++ doc/en/cdcopy_done.png | Bin 0 -> 22176 bytes doc/en/cdcopy_reading.png | Bin 0 -> 19404 bytes doc/en/cdcopy_settings.png | Bin 0 -> 21192 bytes doc/en/cdcopy_writing.png | Bin 0 -> 22507 bytes doc/en/commands.docbook | 700 ++++++++++++++++++++++++++++++ doc/en/dcop.docbook | 104 +++++ doc/en/index.docbook | 239 ++++++++++ doc/en/k3bsetup.png | Bin 0 -> 68880 bytes doc/en/select_audiofiles.png | Bin 0 -> 46327 bytes doc/en/select_project.png | Bin 0 -> 25469 bytes doc/en/tdeioslave/Makefile.am | 1 + doc/en/tdeioslave/videodvd/Makefile.am | 2 + doc/en/tdeioslave/videodvd/index.docbook | 42 ++ doc/index.docbook | 239 ---------- doc/k3bsetup.png | Bin 68880 -> 0 bytes doc/man/CMakeLists.txt | 6 - doc/select_audiofiles.png | Bin 46327 -> 0 bytes doc/select_project.png | Bin 25469 -> 0 bytes doc/tdeioslave/CMakeLists.txt | 3 - doc/tdeioslave/Makefile.am | 1 - doc/tdeioslave/en/CMakeLists.txt | 3 - doc/tdeioslave/en/Makefile.am | 1 - doc/tdeioslave/en/videodvd/CMakeLists.txt | 3 - doc/tdeioslave/en/videodvd/Makefile.am | 2 - doc/tdeioslave/en/videodvd/index.docbook | 42 -- 47 files changed, 1275 insertions(+), 1298 deletions(-) delete mode 100644 doc/CMakeLists.txt delete mode 100644 doc/audiocd-howto.docbook delete mode 100644 doc/burndialog_audio.png delete mode 100644 doc/burndialog_progress.png delete mode 100644 doc/cdcloning_dialog.png delete mode 100644 doc/cdcloning_reading.png delete mode 100644 doc/cdcopy-howto.docbook delete mode 100644 doc/cdcopy_done.png delete mode 100644 doc/cdcopy_reading.png delete mode 100644 doc/cdcopy_settings.png delete mode 100644 doc/cdcopy_writing.png delete mode 100644 doc/commands.docbook delete mode 100644 doc/dcop.docbook create mode 100644 doc/en/Makefile.am create mode 100644 doc/en/audiocd-howto.docbook create mode 100644 doc/en/burndialog_audio.png create mode 100644 doc/en/burndialog_progress.png create mode 100644 doc/en/cdcloning_dialog.png create mode 100644 doc/en/cdcloning_reading.png create mode 100644 doc/en/cdcopy-howto.docbook create mode 100644 doc/en/cdcopy_done.png create mode 100644 doc/en/cdcopy_reading.png create mode 100644 doc/en/cdcopy_settings.png create mode 100644 doc/en/cdcopy_writing.png create mode 100644 doc/en/commands.docbook create mode 100644 doc/en/dcop.docbook create mode 100644 doc/en/index.docbook create mode 100644 doc/en/k3bsetup.png create mode 100644 doc/en/select_audiofiles.png create mode 100644 doc/en/select_project.png create mode 100644 doc/en/tdeioslave/Makefile.am create mode 100644 doc/en/tdeioslave/videodvd/Makefile.am create mode 100644 doc/en/tdeioslave/videodvd/index.docbook delete mode 100644 doc/index.docbook delete mode 100644 doc/k3bsetup.png delete mode 100644 doc/man/CMakeLists.txt delete mode 100644 doc/select_audiofiles.png delete mode 100644 doc/select_project.png delete mode 100644 doc/tdeioslave/CMakeLists.txt delete mode 100644 doc/tdeioslave/Makefile.am delete mode 100644 doc/tdeioslave/en/CMakeLists.txt delete mode 100644 doc/tdeioslave/en/Makefile.am delete mode 100644 doc/tdeioslave/en/videodvd/CMakeLists.txt delete mode 100644 doc/tdeioslave/en/videodvd/Makefile.am delete mode 100644 doc/tdeioslave/en/videodvd/index.docbook diff --git a/CMakeLists.txt b/CMakeLists.txt index 93a1a56..b0fe2a8 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -161,7 +161,7 @@ add_subdirectory( src ) add_subdirectory( tdefile-plugins ) add_subdirectory( tdeioslaves ) tde_conditional_add_subdirectory( BUILD_K3BSETUP k3bsetup ) -tde_conditional_add_subdirectory( BUILD_DOC doc ) +tde_conditional_add_project_docs( BUILD_DOC ) ##### write configure files ##################### diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt deleted file mode 100644 index ae3a9d0..0000000 --- a/doc/CMakeLists.txt +++ /dev/null @@ -1,8 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -add_subdirectory( tdeioslave ) -add_subdirectory( man ) - -##### documentation ############################# -tde_create_handbook( DESTINATION k3b ) - diff --git a/doc/Makefile.am b/doc/Makefile.am index bebd343..81fee21 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,3 +1 @@ -KDE_LANG = en -KDE_DOCS = k3b -SUBDIRS = tdeioslave +SUBDIRS = en diff --git a/doc/audiocd-howto.docbook b/doc/audiocd-howto.docbook deleted file mode 100644 index b993db5..0000000 --- a/doc/audiocd-howto.docbook +++ /dev/null @@ -1,96 +0,0 @@ - - - Quickguide: Burning an Audio-CD in 4 Steps - - - This Quickguide shows you how to create a AudioCD with &k3b;. To reproduce - these steps you need a working &k3b; and a directory in which you have - audiofiles. - - - Step 1 - - When you start &k3b; you should see something like this. - - Here you can select one of four projects &k3b; offers - - - - - - Screenshot - - - - - - - Step 2 - - Now you click on "New Audio CD Project" - - This is a dialog where you can select which files you want to burn on a CD - - - - - - Screenshot - - - - - - The files you see on the top-part of &k3b; can be dropped with the mouse to the bottom-widget. - Another way is to right-click on a file an select Add to Project. In order to rearrange - the order of the audio-tracks you can simply move the tracks with the left mouse-button. The properties - of the tracks can be changed by clicking with the &RMB; and choosing Properties. - As soon as you like the arrangement of the tracks click on Burn... in the right-bottom - corner. - - - - When you burn AudioCD from MP3s or other lossy compressed music, remember that if you encode this CD back to MP3, you'll get poorer quality regardless the bitrate you use. To check whether AudioCD was burnt from lossy format, try auCDtect. - - - - - Step 3 - - This is a dialog where you can decide the settings for the CD. - - - - - - Screenshot - - - - - In this dialog you can control the settings of the burning itself. The default-settings of &k3b; - are probably correct for you. In the top-right corner you can control the speed. One last - step before the actual burning you can give the CD a title by choosing CD-Text and - selecting Write CD-Text. The two which are probably most important for you - are Title and Performer. As soon as you are content with - the settings click on Burn. - - - - Step 4 - - - In this dialog you can see the progress of you burning - - - - - - Screenshot - - - - In this dialog is nothing you can do. Just wait for you computer to finish the session. - - - diff --git a/doc/burndialog_audio.png b/doc/burndialog_audio.png deleted file mode 100644 index 3517598..0000000 Binary files a/doc/burndialog_audio.png and /dev/null differ diff --git a/doc/burndialog_progress.png b/doc/burndialog_progress.png deleted file mode 100644 index b38d4b1..0000000 Binary files a/doc/burndialog_progress.png and /dev/null differ diff --git a/doc/cdcloning_dialog.png b/doc/cdcloning_dialog.png deleted file mode 100644 index 7d0e50c..0000000 Binary files a/doc/cdcloning_dialog.png and /dev/null differ diff --git a/doc/cdcloning_reading.png b/doc/cdcloning_reading.png deleted file mode 100644 index 6d05d8f..0000000 Binary files a/doc/cdcloning_reading.png and /dev/null differ diff --git a/doc/cdcopy-howto.docbook b/doc/cdcopy-howto.docbook deleted file mode 100644 index ded1ae0..0000000 --- a/doc/cdcopy-howto.docbook +++ /dev/null @@ -1,86 +0,0 @@ - - - Quickguide: Copying a Data-CD in 4 Steps - - - This Quickguide shows you how to create a Data-CD with &k3b;. To reproduce - these steps you need a working &k3b; and the CD you wish to copy inserted in your - CD-ROM. - - - Step 1 - - To copy a Data-CD you select Tools,CDCopy CD... - You will see a dialog where you can set up the burning. - - In this dialog you can select the settings you want to use for the burning. - - - - - - Screenshot - - - - - - - Step 2 - - After you have set up &k3b; click on Start CD Copy. You will get a dialog similar to this: - - In this dialog you can watch to progress of the copying. As soon as the writing of the - image-file is done you will be asked for a emtpy CD on which the data will be burned. - - - - - - Screenshot - - - - - - In this dialog you can watch to progress of the copying. As soon as the writing of the - image-file is done you will be asked for a emtpy CD on which the data will be burned. - - - - Step 3 - - &k3b; is burning the Image file. You have to wait until the Overall process - is at 100% - - - - - - Screenshot - - - - - &k3b; is burning the Image file. You have to wait until the Overall process - is at 100%. - - - - Step 4 - - - In this dialog you can see the result of your burning - - - - - - Screenshot - - - - &k3b; has finished the burning. Click on Close to close the dialog. - - - diff --git a/doc/cdcopy_done.png b/doc/cdcopy_done.png deleted file mode 100644 index ae13eb4..0000000 Binary files a/doc/cdcopy_done.png and /dev/null differ diff --git a/doc/cdcopy_reading.png b/doc/cdcopy_reading.png deleted file mode 100644 index c6c1542..0000000 Binary files a/doc/cdcopy_reading.png and /dev/null differ diff --git a/doc/cdcopy_settings.png b/doc/cdcopy_settings.png deleted file mode 100644 index fe81c8a..0000000 Binary files a/doc/cdcopy_settings.png and /dev/null differ diff --git a/doc/cdcopy_writing.png b/doc/cdcopy_writing.png deleted file mode 100644 index 0e57e63..0000000 Binary files a/doc/cdcopy_writing.png and /dev/null differ diff --git a/doc/commands.docbook b/doc/commands.docbook deleted file mode 100644 index a6f69ae..0000000 --- a/doc/commands.docbook +++ /dev/null @@ -1,700 +0,0 @@ - - - - The Menu Entries - - - The <guimenu>File</guimenu> Menu - - - - - - - &Ctrl;N - - - File - New Project - - - - - Creates a new project. - You have to choose the project type (Audio CD, Data DVD, ...). - - - - - - - - &Ctrl;O - - - File - Open... - - - - - Opens an existing project which - can be selected with KDE's Open File dialog. - - - - - - - - &Ctrl;R - - - File - Open Recent - - - - - This is a shortcut to re-open recently opened - projects. The sub-menu belonging to this item - contains a list of these projects, clicking on a specific file - will open it again. - - - - - - - - &Ctrl;S - - - File - Save - - - - - Saves the current project. - If there has already been a save of the document then this - will overwrite the previously saved file without asking - for the user's consent. If it is the first save of a new - document the Save As dialog will be invoked. - - - - - - - File - Save As... - - - - - Saves the current project with a new - file name. KDE's Save As dialog appears to specify - name and directory of the new project file. - - - - - - - File - Save All - - - - - Saves all open projects. - This is the same as selecting - - File - Save - for each of them. - - - - - - - - &Ctrl;C - - - File - Close - - - - - Closes the current project. - If a project has been modified but not yet saved - then &k3b; will ask what to do. - You can choose to save or discard the changes, - and you also have the opportunity to cancel closing - and keep the project open. - - - - - - - File - Close All - - - - - Closes all open projects. For each unsaved - project &k3b; will ask what to do, just like it does when - - File - Close - is selected. - - - - - - - - &Ctrl;Q - - - File - Quit - - - - - Quits &k3b; after closing all of its open - projects. For every unsaved project &k3b; will ask what to do, - just like it does when - - File - Close - is selected. - - - - - - - - - - The <guimenu>Project</guimenu> Menu - - - - - - Project - Add Files... - - - - - When this item is selected, the appearing dialog - lets you choose one or more files to be added - to the project. This has the same effect as dragging - files directly from the Contents View into the Project View. - If the current project is a data disc project, - the added files will appear in the disc's root directory. - - - - - - - Project - Clear Project - - - - - Removes all files and directories - from the current project. - The project itself remains open. - - - - - - - - &Ctrl;B - - - Project - Burn... - - - - - Opens the Burn dialog for the current project. - This is in fact the same as the Properties dialog - the only - difference is that there is an additional Burn button which - causes &k3b; to burn a disc from project data. The Burn dialog - won't open if the project does not contain any files. - - - - - - - - &Ctrl;P - - - Project - Properties... - - - - - Opens the Properties dialog for the current project. - Here you can specify a lot of options concerning - the project. Every project type has got a different set of - options, most of them can be explained by using What's This - (accessible by right-mouse-clicking). - - - - - - - Project - Import Session - - - - - This Item only appears if a Data CD/DVD or Video DVD project - is active. It causes K3b to import the file entries - from the previous session to the current project. - You can use this when compiling files for multi-session discs. - Hence that data from the previous session is always included, - even if you don't choose to make use of this command. - It just helps to know what's on the disc already. - - - - - - - Project - Clear Imported Session - - - - - This Item only appears if a Data CD/DVD or Video DVD project - is active. It causes K3b to remove the file entries - from the current project that were imported by - - Project - Import Session - while keeping all of the other data - in the project. Hence that making use of this command doesn't - actually remove anything from the disc that will be burned, - it just hides these files again. - - - - - - - Project - Edit Boot Images - - - - - This Item only appears if a Data CD/DVD or Video DVD project - is active. Here you can specify boot images - in order to create bootable CDs or DVDs. A boot image can be - a direct copy of a floppy or hard disk (for example, created - by the dd shell command) as well as another disc's boot image. - In any case it's a single file containing a complete, bootable - system that is burned as a normal file. In order to let the - computer know that the disc contains a boot image, the burning - application creates a boot catalog file whose name can be - determined in the dialog window. - - - - - - - - - - - - - The <guimenu>Tools</guimenu> Menu - - - - - - Tools - Copy CD... - - - - - Opens the CD Copy dialog. - Without the need of a project file, it provides - the ability to copy a CD's content to another disc. - Alternatively, you can choose only to create an image - of the source CD which can be burned anytime. There is - also an option to clone the CD instead of normal - copying, which should be preferred when copying CDs - with defective sectors or Video CDs. - - - - - - - Tools - Copy DVD... - - - - - Opens the DVD Copy dialog. - Without the need of a project file, it provides - the ability to copy a DVD's content to another disc. - Alternatively, you can choose only to create an image - of the source DVD which can be burned anytime. - Video transcoding within the DVD Copy dialog - is not yet supported, so the destination disc - has to be large enough to contain all of the - source disc's (video) data in its original form. - - - - - - - Tools - Erase CD-RW... - - - - - Opens the Erase CD-RW dialog. - With its help you can clear the contents of a CD-RW, - or part of it. - - - - - - - Tools - Format DVD±RW... - - - - - Opens the DVD Formatting dialog. - With its help you can format a DVD-R(W) or DVD+R(W), - which causes the disc's contents to be deleted. - &k3b; gives the choice between the "Overwrite" and - "Incremental" writing modes. - - - - - - - Tools - Burn CD Image... - - - - - Burns a previously created CD image. - The Burn CD Image dialog asks to select an - *.iso, - *.cue or - *.toc file - as data source that you can instantly burn by pressing - the Start button. - (Nero *.nrg files - are currently not supported, so you have to make use - of other tools like - Nrg2Iso.) - - - - - - - Tools - Burn DVD ISO Image... - - - - - Burns a previously created DVD image. - The Burn Iso9660 Image dialog asks to select an - *.iso file as data - source that you can instantly burn by pressing - the Start button. - - - - - - - Tools - Encode Video... - - - - - A DVD video that has already been ripped can be - encoded with a little help from the Encoding Video - dialog. This dialog box normally opens after ripping the DVD - from within the Contents View, but can also be used standalone. - It contains information about the ripped DVD video, encoding - options and even video resizing and cropping abilities. - - - - - - - Tools - Diskinfo - - - - - Shows information about the inserted disk. - This information will be displayed in the Contents View and - covers disk properties like type, size and track length - of the CD or DVD in your drive. - - - - - - - - - - The <guimenu>Settings</guimenu> Menu - - - - - - Settings - Toolbars - - - - - Pops up a list of &k3b;'s toolbars. - If a toolbar entry is checked, it means that - the toolbar is currently visible. - - - - - - - Settings - Show/Hide Statusbar - - - - - This enables you to show or hide the small bar - at the bottom of the main window containing - various information about &k3b;'s status and activities. - - - - - - - Settings - Show Directories - - - - - Toggles the visibility of the Directory View. - This view enables you to select directories and disc drives. - When selected, their contents will appear in the Contents View. - Disc drives have also got a context menu providing functions - like Disk Info, (un)mounting the drive or ejecting the medium. - - - - - - - Settings - Show Contents - - - - - Toggles the visibility of the Contents View. - This view enables you to select files that can be dragged - into the Project View in order to add them to the project. - The Contents View also acts as an interface to rip - audio CDs and video discs when a disc drive containing - an appropriate CD/DVD is selected in the Directory View. - - - - - - - Settings - Show Document Header - - - - - Toggles the visibility of the document header - belonging to the Project View. This is a small bar that is - only visible if the Project View contains any open projects. - The document header has no functionality, yet it's nice - eye candy and improves clarity by separating - the Project View from the other views. - - - - - - - Settings - Configure Shortcuts... - - - - - This command opens a dialog box where the key bindings - for &k3b;'s menu commands may be changed. - After selecting one of the available commands - from the upper part of the dialog, the shortcut - for this action can be changed in the lower part. - - - - - - - Settings - Configure Toolbars... - - - - - This command opens a dialog box where the toolbars - can be customized. The drop down box on top - of the dialog determines which toolbar can be edited - at the moment. The Available Actions list on the left contains - all commands that can be added to the toolbar, - the Current Actions list on the right shows the ones - that are already there. Items can be added by selecting - the appropriate command out of the Available Actions list and - pressing the right button to move it to the Current Actions - list. Removing an item works the other way round. - The up and down buttons change the commands's position - within the toolbar. - - - - - - - Settings - &k3b; Setup - - - - - This opens &k3bsetup; which helps setting the - right permissions needed by &k3b; in order to burn - CDs and DVDs. Linux' user rights management permits program - execution and access to disc drives if no permissions have - been granted by the administrator. &k3bsetup; cannot set - permissions without administrator privileges, so you have - to enter the root password when starting up. - - - - - - - Settings - Configure &k3b;... - - - - - Opens the Options dialog - where general program settings can be configured. - Although most of &k3b;'s functionality should work out - of the box, this dialog allows to customize and fine-tune - the program. - - - - - - - - - - The <guimenu>Help</guimenu> Menu -&help.menu.documentation; - - - - \ No newline at end of file diff --git a/doc/dcop.docbook b/doc/dcop.docbook deleted file mode 100644 index 0958946..0000000 --- a/doc/dcop.docbook +++ /dev/null @@ -1,104 +0,0 @@ - - The &k3b; &DCOP; Interface - &k3b; features, like many other &tde; applications as well, a - &DCOP; interface which makes it possible to control a part of it's - functionality from ⪚ a shellscript. - To use these &DCOP; functions you can either use the - dcop commandline program or the more convenient - Kdcop application. Both provide the same - functionality so it's mostly a matter of taste and context of usage when - deciding which way to choose. - This chapter assumes that you're using the dcop - commandline program. To access &k3b;'s &DCOP; functions, make sure that - &k3b; is started and then enter something like this at a console: - -# dcop [function] - - - -Besides the generic &DCOP; functions available to all &tde; -applications, &k3b;'s DCOP interface mainly consists of two parts as described below. - - -The default K3bInterface - -The default K3b DCOP interface provides functionality like copyCD, formatDVD, and methods for creating new projects. - - -DCOPRef createDataCDProject() -DCOPRef createAudioCDProject() -DCOPRef createMixedCDProject() -DCOPRef createVideoCDProject() -DCOPRef createMovixCDProject() -DCOPRef createDataDVDProject() -DCOPRef createVideoDVDProject() -DCOPRef createMovixDVDProject() -DCOPRef openProject(KURL url) -QValueList<DCOPRef> projects() -DCOPRef currentProject() -void copyCd() -void copyDvd() -void eraseCdrw() -void formatDvd() -void burnCdImage(KURL url) -void burnDvdImage(KURL url) - - -As result from one of the createXXXProject methods one gets a DCOP reference to the newly created project: - -DCOPRef(k3b,K3bProject-0) - -Alternatively you may create a project using the command line: - - -# k3b --audiocd - - -and then retrieve a reference to this project with - - -# dcop currentProject - - -Using this reference it is possible to manipulate the project using the K3bProjectInterface. - - - - -K3bProjectInterface - - -void addUrls(KURL::List urls) -void addUrl(KURL url) -void burn() - - -K3b offers the K3bProjectInterface as listed above or the more powerful K3bDataProjectInterface which only applies to data projects (CD and DVD): - - -void createFolder(QString name) -void createFolder(QString name,QString parent) -void addUrl(KURL url,QString parent) -void addUrls(KURL::List urls,QString parent) -void removeItem(QString path) -void renameItem(QString path,QString newName) -void setVolumeID(QString id) - - - -Using this it is possible to fill a data project with files and folders from a script. -The following script for example creates a new data project, adds several folders to the project, and adds files to the newly created folders: - - -#!/bin/bash -PROJECT=$(dcop k3b K3bInterface createDataCDProject) -dcop $PROJECT createFolder test -dcop $PROJECT createFolder foo -dcop $PROJECT createFolder bar /foo -dcop $PROJECT addUrl /home/trueg/somefile.txt /foo/bar - - - - - - diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am new file mode 100644 index 0000000..bebd343 --- /dev/null +++ b/doc/en/Makefile.am @@ -0,0 +1,3 @@ +KDE_LANG = en +KDE_DOCS = k3b +SUBDIRS = tdeioslave diff --git a/doc/en/audiocd-howto.docbook b/doc/en/audiocd-howto.docbook new file mode 100644 index 0000000..b993db5 --- /dev/null +++ b/doc/en/audiocd-howto.docbook @@ -0,0 +1,96 @@ + + + Quickguide: Burning an Audio-CD in 4 Steps + + + This Quickguide shows you how to create a AudioCD with &k3b;. To reproduce + these steps you need a working &k3b; and a directory in which you have + audiofiles. + + + Step 1 + + When you start &k3b; you should see something like this. + + Here you can select one of four projects &k3b; offers + + + + + + Screenshot + + + + + + + Step 2 + + Now you click on "New Audio CD Project" + + This is a dialog where you can select which files you want to burn on a CD + + + + + + Screenshot + + + + + + The files you see on the top-part of &k3b; can be dropped with the mouse to the bottom-widget. + Another way is to right-click on a file an select Add to Project. In order to rearrange + the order of the audio-tracks you can simply move the tracks with the left mouse-button. The properties + of the tracks can be changed by clicking with the &RMB; and choosing Properties. + As soon as you like the arrangement of the tracks click on Burn... in the right-bottom + corner. + + + + When you burn AudioCD from MP3s or other lossy compressed music, remember that if you encode this CD back to MP3, you'll get poorer quality regardless the bitrate you use. To check whether AudioCD was burnt from lossy format, try auCDtect. + + + + + Step 3 + + This is a dialog where you can decide the settings for the CD. + + + + + + Screenshot + + + + + In this dialog you can control the settings of the burning itself. The default-settings of &k3b; + are probably correct for you. In the top-right corner you can control the speed. One last + step before the actual burning you can give the CD a title by choosing CD-Text and + selecting Write CD-Text. The two which are probably most important for you + are Title and Performer. As soon as you are content with + the settings click on Burn. + + + + Step 4 + + + In this dialog you can see the progress of you burning + + + + + + Screenshot + + + + In this dialog is nothing you can do. Just wait for you computer to finish the session. + + + diff --git a/doc/en/burndialog_audio.png b/doc/en/burndialog_audio.png new file mode 100644 index 0000000..3517598 Binary files /dev/null and b/doc/en/burndialog_audio.png differ diff --git a/doc/en/burndialog_progress.png b/doc/en/burndialog_progress.png new file mode 100644 index 0000000..b38d4b1 Binary files /dev/null and b/doc/en/burndialog_progress.png differ diff --git a/doc/en/cdcloning_dialog.png b/doc/en/cdcloning_dialog.png new file mode 100644 index 0000000..7d0e50c Binary files /dev/null and b/doc/en/cdcloning_dialog.png differ diff --git a/doc/en/cdcloning_reading.png b/doc/en/cdcloning_reading.png new file mode 100644 index 0000000..6d05d8f Binary files /dev/null and b/doc/en/cdcloning_reading.png differ diff --git a/doc/en/cdcopy-howto.docbook b/doc/en/cdcopy-howto.docbook new file mode 100644 index 0000000..ded1ae0 --- /dev/null +++ b/doc/en/cdcopy-howto.docbook @@ -0,0 +1,86 @@ + + + Quickguide: Copying a Data-CD in 4 Steps + + + This Quickguide shows you how to create a Data-CD with &k3b;. To reproduce + these steps you need a working &k3b; and the CD you wish to copy inserted in your + CD-ROM. + + + Step 1 + + To copy a Data-CD you select Tools,CDCopy CD... + You will see a dialog where you can set up the burning. + + In this dialog you can select the settings you want to use for the burning. + + + + + + Screenshot + + + + + + + Step 2 + + After you have set up &k3b; click on Start CD Copy. You will get a dialog similar to this: + + In this dialog you can watch to progress of the copying. As soon as the writing of the + image-file is done you will be asked for a emtpy CD on which the data will be burned. + + + + + + Screenshot + + + + + + In this dialog you can watch to progress of the copying. As soon as the writing of the + image-file is done you will be asked for a emtpy CD on which the data will be burned. + + + + Step 3 + + &k3b; is burning the Image file. You have to wait until the Overall process + is at 100% + + + + + + Screenshot + + + + + &k3b; is burning the Image file. You have to wait until the Overall process + is at 100%. + + + + Step 4 + + + In this dialog you can see the result of your burning + + + + + + Screenshot + + + + &k3b; has finished the burning. Click on Close to close the dialog. + + + diff --git a/doc/en/cdcopy_done.png b/doc/en/cdcopy_done.png new file mode 100644 index 0000000..ae13eb4 Binary files /dev/null and b/doc/en/cdcopy_done.png differ diff --git a/doc/en/cdcopy_reading.png b/doc/en/cdcopy_reading.png new file mode 100644 index 0000000..c6c1542 Binary files /dev/null and b/doc/en/cdcopy_reading.png differ diff --git a/doc/en/cdcopy_settings.png b/doc/en/cdcopy_settings.png new file mode 100644 index 0000000..fe81c8a Binary files /dev/null and b/doc/en/cdcopy_settings.png differ diff --git a/doc/en/cdcopy_writing.png b/doc/en/cdcopy_writing.png new file mode 100644 index 0000000..0e57e63 Binary files /dev/null and b/doc/en/cdcopy_writing.png differ diff --git a/doc/en/commands.docbook b/doc/en/commands.docbook new file mode 100644 index 0000000..a6f69ae --- /dev/null +++ b/doc/en/commands.docbook @@ -0,0 +1,700 @@ + + + + The Menu Entries + + + The <guimenu>File</guimenu> Menu + + + + + + + &Ctrl;N + + + File + New Project + + + + + Creates a new project. + You have to choose the project type (Audio CD, Data DVD, ...). + + + + + + + + &Ctrl;O + + + File + Open... + + + + + Opens an existing project which + can be selected with KDE's Open File dialog. + + + + + + + + &Ctrl;R + + + File + Open Recent + + + + + This is a shortcut to re-open recently opened + projects. The sub-menu belonging to this item + contains a list of these projects, clicking on a specific file + will open it again. + + + + + + + + &Ctrl;S + + + File + Save + + + + + Saves the current project. + If there has already been a save of the document then this + will overwrite the previously saved file without asking + for the user's consent. If it is the first save of a new + document the Save As dialog will be invoked. + + + + + + + File + Save As... + + + + + Saves the current project with a new + file name. KDE's Save As dialog appears to specify + name and directory of the new project file. + + + + + + + File + Save All + + + + + Saves all open projects. + This is the same as selecting + + File + Save + for each of them. + + + + + + + + &Ctrl;C + + + File + Close + + + + + Closes the current project. + If a project has been modified but not yet saved + then &k3b; will ask what to do. + You can choose to save or discard the changes, + and you also have the opportunity to cancel closing + and keep the project open. + + + + + + + File + Close All + + + + + Closes all open projects. For each unsaved + project &k3b; will ask what to do, just like it does when + + File + Close + is selected. + + + + + + + + &Ctrl;Q + + + File + Quit + + + + + Quits &k3b; after closing all of its open + projects. For every unsaved project &k3b; will ask what to do, + just like it does when + + File + Close + is selected. + + + + + + + + + + The <guimenu>Project</guimenu> Menu + + + + + + Project + Add Files... + + + + + When this item is selected, the appearing dialog + lets you choose one or more files to be added + to the project. This has the same effect as dragging + files directly from the Contents View into the Project View. + If the current project is a data disc project, + the added files will appear in the disc's root directory. + + + + + + + Project + Clear Project + + + + + Removes all files and directories + from the current project. + The project itself remains open. + + + + + + + + &Ctrl;B + + + Project + Burn... + + + + + Opens the Burn dialog for the current project. + This is in fact the same as the Properties dialog - the only + difference is that there is an additional Burn button which + causes &k3b; to burn a disc from project data. The Burn dialog + won't open if the project does not contain any files. + + + + + + + + &Ctrl;P + + + Project + Properties... + + + + + Opens the Properties dialog for the current project. + Here you can specify a lot of options concerning + the project. Every project type has got a different set of + options, most of them can be explained by using What's This + (accessible by right-mouse-clicking). + + + + + + + Project + Import Session + + + + + This Item only appears if a Data CD/DVD or Video DVD project + is active. It causes K3b to import the file entries + from the previous session to the current project. + You can use this when compiling files for multi-session discs. + Hence that data from the previous session is always included, + even if you don't choose to make use of this command. + It just helps to know what's on the disc already. + + + + + + + Project + Clear Imported Session + + + + + This Item only appears if a Data CD/DVD or Video DVD project + is active. It causes K3b to remove the file entries + from the current project that were imported by + + Project + Import Session + while keeping all of the other data + in the project. Hence that making use of this command doesn't + actually remove anything from the disc that will be burned, + it just hides these files again. + + + + + + + Project + Edit Boot Images + + + + + This Item only appears if a Data CD/DVD or Video DVD project + is active. Here you can specify boot images + in order to create bootable CDs or DVDs. A boot image can be + a direct copy of a floppy or hard disk (for example, created + by the dd shell command) as well as another disc's boot image. + In any case it's a single file containing a complete, bootable + system that is burned as a normal file. In order to let the + computer know that the disc contains a boot image, the burning + application creates a boot catalog file whose name can be + determined in the dialog window. + + + + + + + + + + + + + The <guimenu>Tools</guimenu> Menu + + + + + + Tools + Copy CD... + + + + + Opens the CD Copy dialog. + Without the need of a project file, it provides + the ability to copy a CD's content to another disc. + Alternatively, you can choose only to create an image + of the source CD which can be burned anytime. There is + also an option to clone the CD instead of normal + copying, which should be preferred when copying CDs + with defective sectors or Video CDs. + + + + + + + Tools + Copy DVD... + + + + + Opens the DVD Copy dialog. + Without the need of a project file, it provides + the ability to copy a DVD's content to another disc. + Alternatively, you can choose only to create an image + of the source DVD which can be burned anytime. + Video transcoding within the DVD Copy dialog + is not yet supported, so the destination disc + has to be large enough to contain all of the + source disc's (video) data in its original form. + + + + + + + Tools + Erase CD-RW... + + + + + Opens the Erase CD-RW dialog. + With its help you can clear the contents of a CD-RW, + or part of it. + + + + + + + Tools + Format DVD±RW... + + + + + Opens the DVD Formatting dialog. + With its help you can format a DVD-R(W) or DVD+R(W), + which causes the disc's contents to be deleted. + &k3b; gives the choice between the "Overwrite" and + "Incremental" writing modes. + + + + + + + Tools + Burn CD Image... + + + + + Burns a previously created CD image. + The Burn CD Image dialog asks to select an + *.iso, + *.cue or + *.toc file + as data source that you can instantly burn by pressing + the Start button. + (Nero *.nrg files + are currently not supported, so you have to make use + of other tools like + Nrg2Iso.) + + + + + + + Tools + Burn DVD ISO Image... + + + + + Burns a previously created DVD image. + The Burn Iso9660 Image dialog asks to select an + *.iso file as data + source that you can instantly burn by pressing + the Start button. + + + + + + + Tools + Encode Video... + + + + + A DVD video that has already been ripped can be + encoded with a little help from the Encoding Video + dialog. This dialog box normally opens after ripping the DVD + from within the Contents View, but can also be used standalone. + It contains information about the ripped DVD video, encoding + options and even video resizing and cropping abilities. + + + + + + + Tools + Diskinfo + + + + + Shows information about the inserted disk. + This information will be displayed in the Contents View and + covers disk properties like type, size and track length + of the CD or DVD in your drive. + + + + + + + + + + The <guimenu>Settings</guimenu> Menu + + + + + + Settings + Toolbars + + + + + Pops up a list of &k3b;'s toolbars. + If a toolbar entry is checked, it means that + the toolbar is currently visible. + + + + + + + Settings + Show/Hide Statusbar + + + + + This enables you to show or hide the small bar + at the bottom of the main window containing + various information about &k3b;'s status and activities. + + + + + + + Settings + Show Directories + + + + + Toggles the visibility of the Directory View. + This view enables you to select directories and disc drives. + When selected, their contents will appear in the Contents View. + Disc drives have also got a context menu providing functions + like Disk Info, (un)mounting the drive or ejecting the medium. + + + + + + + Settings + Show Contents + + + + + Toggles the visibility of the Contents View. + This view enables you to select files that can be dragged + into the Project View in order to add them to the project. + The Contents View also acts as an interface to rip + audio CDs and video discs when a disc drive containing + an appropriate CD/DVD is selected in the Directory View. + + + + + + + Settings + Show Document Header + + + + + Toggles the visibility of the document header + belonging to the Project View. This is a small bar that is + only visible if the Project View contains any open projects. + The document header has no functionality, yet it's nice + eye candy and improves clarity by separating + the Project View from the other views. + + + + + + + Settings + Configure Shortcuts... + + + + + This command opens a dialog box where the key bindings + for &k3b;'s menu commands may be changed. + After selecting one of the available commands + from the upper part of the dialog, the shortcut + for this action can be changed in the lower part. + + + + + + + Settings + Configure Toolbars... + + + + + This command opens a dialog box where the toolbars + can be customized. The drop down box on top + of the dialog determines which toolbar can be edited + at the moment. The Available Actions list on the left contains + all commands that can be added to the toolbar, + the Current Actions list on the right shows the ones + that are already there. Items can be added by selecting + the appropriate command out of the Available Actions list and + pressing the right button to move it to the Current Actions + list. Removing an item works the other way round. + The up and down buttons change the commands's position + within the toolbar. + + + + + + + Settings + &k3b; Setup + + + + + This opens &k3bsetup; which helps setting the + right permissions needed by &k3b; in order to burn + CDs and DVDs. Linux' user rights management permits program + execution and access to disc drives if no permissions have + been granted by the administrator. &k3bsetup; cannot set + permissions without administrator privileges, so you have + to enter the root password when starting up. + + + + + + + Settings + Configure &k3b;... + + + + + Opens the Options dialog + where general program settings can be configured. + Although most of &k3b;'s functionality should work out + of the box, this dialog allows to customize and fine-tune + the program. + + + + + + + + + + The <guimenu>Help</guimenu> Menu +&help.menu.documentation; + + + + \ No newline at end of file diff --git a/doc/en/dcop.docbook b/doc/en/dcop.docbook new file mode 100644 index 0000000..0958946 --- /dev/null +++ b/doc/en/dcop.docbook @@ -0,0 +1,104 @@ + + The &k3b; &DCOP; Interface + &k3b; features, like many other &tde; applications as well, a + &DCOP; interface which makes it possible to control a part of it's + functionality from ⪚ a shellscript. + To use these &DCOP; functions you can either use the + dcop commandline program or the more convenient + Kdcop application. Both provide the same + functionality so it's mostly a matter of taste and context of usage when + deciding which way to choose. + This chapter assumes that you're using the dcop + commandline program. To access &k3b;'s &DCOP; functions, make sure that + &k3b; is started and then enter something like this at a console: + +# dcop [function] + + + +Besides the generic &DCOP; functions available to all &tde; +applications, &k3b;'s DCOP interface mainly consists of two parts as described below. + + +The default K3bInterface + +The default K3b DCOP interface provides functionality like copyCD, formatDVD, and methods for creating new projects. + + +DCOPRef createDataCDProject() +DCOPRef createAudioCDProject() +DCOPRef createMixedCDProject() +DCOPRef createVideoCDProject() +DCOPRef createMovixCDProject() +DCOPRef createDataDVDProject() +DCOPRef createVideoDVDProject() +DCOPRef createMovixDVDProject() +DCOPRef openProject(KURL url) +QValueList<DCOPRef> projects() +DCOPRef currentProject() +void copyCd() +void copyDvd() +void eraseCdrw() +void formatDvd() +void burnCdImage(KURL url) +void burnDvdImage(KURL url) + + +As result from one of the createXXXProject methods one gets a DCOP reference to the newly created project: + +DCOPRef(k3b,K3bProject-0) + +Alternatively you may create a project using the command line: + + +# k3b --audiocd + + +and then retrieve a reference to this project with + + +# dcop currentProject + + +Using this reference it is possible to manipulate the project using the K3bProjectInterface. + + + + +K3bProjectInterface + + +void addUrls(KURL::List urls) +void addUrl(KURL url) +void burn() + + +K3b offers the K3bProjectInterface as listed above or the more powerful K3bDataProjectInterface which only applies to data projects (CD and DVD): + + +void createFolder(QString name) +void createFolder(QString name,QString parent) +void addUrl(KURL url,QString parent) +void addUrls(KURL::List urls,QString parent) +void removeItem(QString path) +void renameItem(QString path,QString newName) +void setVolumeID(QString id) + + + +Using this it is possible to fill a data project with files and folders from a script. +The following script for example creates a new data project, adds several folders to the project, and adds files to the newly created folders: + + +#!/bin/bash +PROJECT=$(dcop k3b K3bInterface createDataCDProject) +dcop $PROJECT createFolder test +dcop $PROJECT createFolder foo +dcop $PROJECT createFolder bar /foo +dcop $PROJECT addUrl /home/trueg/somefile.txt /foo/bar + + + + + + diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..22d3ab8 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,239 @@ + +K3b"> + cdrdao"> + DVD+RW-Tools"> + mkisofs"> + cdrecord"> + K3bSetup"> + + + + + + + +]> + + + + +The &k3b; Handbook + + +CarstenNiehaus +JakobPetsovits +&tde-authors; + + + + +2003-2004 +Carsten Niehaus + + +&tde-copyright-date; +&tde-team; + + +&FDLNotice; + +Reviewed: &tde-release-date; +&tde-release-version; + + + +&k3b; is a CD and DVD burning application for &tde; with a comfortable user interface. + + + + +TDE +cdrecord +DVD +CD +burning +ripping +iso +K3b + + + + + +Introduction + + +&k3b; is a CD and DVD burning application for Linux systems +optimized for &tde;. It provides a comfortable user interface +to perform most CD/DVD burning tasks like creating an Audio CD +from a set of audio files or copying a CD. +While the experienced user can take influence in all steps +of the burning process, the beginner may find comfort +in the automatic settings and the reasonable &k3b; defaults +which allow a quick start. The actual burning in K3b is done +by the command line utilities +cdrecord, +cdrdao, and +growisofs. + + + + +Pre-setup +When you run &k3b; for the first time, you may find &k3b; informing you +that no optical writer drivers have been found, meaning you will not be able to +write to any optical discs. There is no need to panic as &k3b; will open a +configuration window which will help you get various tools used by &k3b; up and +running. This includes viewing the user group that owns those applications. You +should not need to change this as &k3b; will apply the correct permissions on external +programs itself. These programs are generally cdrecord, +growisofs and cdrdao. If preferred, one can +tell &k3b; to use the burning user group and point it to the +optical drive. Below is an image of the configuration window where these settings +are possible. + + + + + + + + + + + + + + + + + +&k3b-commands; + + +HOWTOs for a quickstart to &k3b; + +&k3b-audiocd-howto; +&k3b-cdcopy-howto; + + + +&k3b-dcop; + + +Requirements + + +To use &k3b; you need &tde;. + + +&cdrdao;: Records audio or data CD-Rs in disk-at-once (DAO) +mode based on a textual description of the CD contents (toc-file). + + +&cdrecord;/&mkisofs;: Records any kind of CD-Rs. &cdrecord; contains all of &cdrdao;'s features and extended functionality and therefore is &k3b;'s standard choice for CD burning. In some cases, &cdrdao; reaches better audio CD burning quality though. + + +&dvdtools;: The &dvdtools; are used to burn and format DVD+R(W) and DVD-R(W) media. + + + +Optionally &k3b; can make use of all these libraries: + + + +cdparanoia: A Compact Disc Digital Audio (CDDA) extraction tool, +commonly known on the net as a 'ripper'. + + + +Ogg Vorbis library: Ogg Vorbis is a completely open, patent-free, +professional audio encoding and streaming technology with all the benefits +of Open Source, and in direct competition with the MP3 format. +Used by the Ogg Vorbis Decoder and Encoder plugins. + + + +MAD (MPEG Audio Decoder) Library: A high-quality MPEG audio decoder, +supporting the MPEG-1, MPEG-2 and MPEG 2.5 formats. All three audio +layers Layer I, Layer II, and Layer III (i.e. MP3) are fully implemented. +Used by the MP3 Decoder plugin. + + + +LAME: A highly evolved MP3 encoder, with quality and speed able to rival +state of the art commercial encoders. Used by the MP3 Encoder plugin. + + + +FLAC: A free, open source codec for lossless audio compression and +decompression. Used by the FLAC Decoder plugin and the +External Audio Encoder plugin, so you can read and write FLAC files. + + + +Libsndfile, FFmpeg, FLAC, Musepack decoders: Other libraries for processing a +broad range of audio file formats. For example, with FFmpeg it is possible to +decode WMA files in order to burn them onto audio CDs. +Used by the respective plugins. + + + +SoX: A utility that can convert between various audio file formats. +Used by the SoX Audio Encoder plugin. + + + +transcode: A Linux text-console utility for video stream processing. +You need this if you want to rip DVD video. + + + +VCDImager: A full-featured mastering suite for authoring, +disassembling and analyzing Video CDs and Super Video CDs. + + + +Normalize: A tool for adjusting the volume of audio files to a standard level. +This is useful for things like creating mixed CDs and MP3 collections, where +different recording levels on different albums can cause the volume to vary +greatly from song to song. + + + +eMovix: A tiny Linux distribution that is burned on CD together with video +files. eMovix contains all the software to boot from a CD and automatically +play every video file localized in the CD root. + + + + + +Credits and License + + +&k3b; + + +Program copyright 1999-2005 Sebastian Trueg trueg@k3b.org +and the K3b team + + +Contributors: + +Thomas Froescher + +Christian Kvasny + +Klaus-Dieter Krannich + + + + +&underFDL; +&underGPL; + + + + diff --git a/doc/en/k3bsetup.png b/doc/en/k3bsetup.png new file mode 100644 index 0000000..003db72 Binary files /dev/null and b/doc/en/k3bsetup.png differ diff --git a/doc/en/select_audiofiles.png b/doc/en/select_audiofiles.png new file mode 100644 index 0000000..be602a9 Binary files /dev/null and b/doc/en/select_audiofiles.png differ diff --git a/doc/en/select_project.png b/doc/en/select_project.png new file mode 100644 index 0000000..8bd35f8 Binary files /dev/null and b/doc/en/select_project.png differ diff --git a/doc/en/tdeioslave/Makefile.am b/doc/en/tdeioslave/Makefile.am new file mode 100644 index 0000000..55ab08d --- /dev/null +++ b/doc/en/tdeioslave/Makefile.am @@ -0,0 +1 @@ +SUBDIRS = videodvd diff --git a/doc/en/tdeioslave/videodvd/Makefile.am b/doc/en/tdeioslave/videodvd/Makefile.am new file mode 100644 index 0000000..adf07a4 --- /dev/null +++ b/doc/en/tdeioslave/videodvd/Makefile.am @@ -0,0 +1,2 @@ +KDE_LANG = en +KDE_DOCS = tdeioslave/videodvd diff --git a/doc/en/tdeioslave/videodvd/index.docbook b/doc/en/tdeioslave/videodvd/index.docbook new file mode 100644 index 0000000..1355fde --- /dev/null +++ b/doc/en/tdeioslave/videodvd/index.docbook @@ -0,0 +1,42 @@ + + + +]> + +
+videodvd + + + + +&tde-authors; + + + +&tde-release-version; +Reviewed: &tde-release-date; + + +&tde-copyright-date; +&tde-team; + + + + +This handbook describes the videodvd protocol. + + + + +TDE +videodvd +protocol + + + + +The videodvd protocol supports copying files from a video DVD with +on-the-fly decryption when libdvdcss is installed. + +
diff --git a/doc/index.docbook b/doc/index.docbook deleted file mode 100644 index 22d3ab8..0000000 --- a/doc/index.docbook +++ /dev/null @@ -1,239 +0,0 @@ - -K3b"> - cdrdao"> - DVD+RW-Tools"> - mkisofs"> - cdrecord"> - K3bSetup"> - - - - - - - -]> - - - - -The &k3b; Handbook - - -CarstenNiehaus -JakobPetsovits -&tde-authors; - - - - -2003-2004 -Carsten Niehaus - - -&tde-copyright-date; -&tde-team; - - -&FDLNotice; - -Reviewed: &tde-release-date; -&tde-release-version; - - - -&k3b; is a CD and DVD burning application for &tde; with a comfortable user interface. - - - - -TDE -cdrecord -DVD -CD -burning -ripping -iso -K3b - - - - - -Introduction - - -&k3b; is a CD and DVD burning application for Linux systems -optimized for &tde;. It provides a comfortable user interface -to perform most CD/DVD burning tasks like creating an Audio CD -from a set of audio files or copying a CD. -While the experienced user can take influence in all steps -of the burning process, the beginner may find comfort -in the automatic settings and the reasonable &k3b; defaults -which allow a quick start. The actual burning in K3b is done -by the command line utilities -cdrecord, -cdrdao, and -growisofs. - - - - -Pre-setup -When you run &k3b; for the first time, you may find &k3b; informing you -that no optical writer drivers have been found, meaning you will not be able to -write to any optical discs. There is no need to panic as &k3b; will open a -configuration window which will help you get various tools used by &k3b; up and -running. This includes viewing the user group that owns those applications. You -should not need to change this as &k3b; will apply the correct permissions on external -programs itself. These programs are generally cdrecord, -growisofs and cdrdao. If preferred, one can -tell &k3b; to use the burning user group and point it to the -optical drive. Below is an image of the configuration window where these settings -are possible. - - - - - - - - - - - - - - - - - -&k3b-commands; - - -HOWTOs for a quickstart to &k3b; - -&k3b-audiocd-howto; -&k3b-cdcopy-howto; - - - -&k3b-dcop; - - -Requirements - - -To use &k3b; you need &tde;. - - -&cdrdao;: Records audio or data CD-Rs in disk-at-once (DAO) -mode based on a textual description of the CD contents (toc-file). - - -&cdrecord;/&mkisofs;: Records any kind of CD-Rs. &cdrecord; contains all of &cdrdao;'s features and extended functionality and therefore is &k3b;'s standard choice for CD burning. In some cases, &cdrdao; reaches better audio CD burning quality though. - - -&dvdtools;: The &dvdtools; are used to burn and format DVD+R(W) and DVD-R(W) media. - - - -Optionally &k3b; can make use of all these libraries: - - - -cdparanoia: A Compact Disc Digital Audio (CDDA) extraction tool, -commonly known on the net as a 'ripper'. - - - -Ogg Vorbis library: Ogg Vorbis is a completely open, patent-free, -professional audio encoding and streaming technology with all the benefits -of Open Source, and in direct competition with the MP3 format. -Used by the Ogg Vorbis Decoder and Encoder plugins. - - - -MAD (MPEG Audio Decoder) Library: A high-quality MPEG audio decoder, -supporting the MPEG-1, MPEG-2 and MPEG 2.5 formats. All three audio -layers Layer I, Layer II, and Layer III (i.e. MP3) are fully implemented. -Used by the MP3 Decoder plugin. - - - -LAME: A highly evolved MP3 encoder, with quality and speed able to rival -state of the art commercial encoders. Used by the MP3 Encoder plugin. - - - -FLAC: A free, open source codec for lossless audio compression and -decompression. Used by the FLAC Decoder plugin and the -External Audio Encoder plugin, so you can read and write FLAC files. - - - -Libsndfile, FFmpeg, FLAC, Musepack decoders: Other libraries for processing a -broad range of audio file formats. For example, with FFmpeg it is possible to -decode WMA files in order to burn them onto audio CDs. -Used by the respective plugins. - - - -SoX: A utility that can convert between various audio file formats. -Used by the SoX Audio Encoder plugin. - - - -transcode: A Linux text-console utility for video stream processing. -You need this if you want to rip DVD video. - - - -VCDImager: A full-featured mastering suite for authoring, -disassembling and analyzing Video CDs and Super Video CDs. - - - -Normalize: A tool for adjusting the volume of audio files to a standard level. -This is useful for things like creating mixed CDs and MP3 collections, where -different recording levels on different albums can cause the volume to vary -greatly from song to song. - - - -eMovix: A tiny Linux distribution that is burned on CD together with video -files. eMovix contains all the software to boot from a CD and automatically -play every video file localized in the CD root. - - - - - -Credits and License - - -&k3b; - - -Program copyright 1999-2005 Sebastian Trueg trueg@k3b.org -and the K3b team - - -Contributors: - -Thomas Froescher - -Christian Kvasny - -Klaus-Dieter Krannich - - - - -&underFDL; -&underGPL; - - - - diff --git a/doc/k3bsetup.png b/doc/k3bsetup.png deleted file mode 100644 index 003db72..0000000 Binary files a/doc/k3bsetup.png and /dev/null differ diff --git a/doc/man/CMakeLists.txt b/doc/man/CMakeLists.txt deleted file mode 100644 index f07121a..0000000 --- a/doc/man/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -SET(MANFILES k3b.1) - -INSTALL(FILES - ${MANFILES} - DESTINATION share/man/man1) - diff --git a/doc/select_audiofiles.png b/doc/select_audiofiles.png deleted file mode 100644 index be602a9..0000000 Binary files a/doc/select_audiofiles.png and /dev/null differ diff --git a/doc/select_project.png b/doc/select_project.png deleted file mode 100644 index 8bd35f8..0000000 Binary files a/doc/select_project.png and /dev/null differ diff --git a/doc/tdeioslave/CMakeLists.txt b/doc/tdeioslave/CMakeLists.txt deleted file mode 100644 index a39cb92..0000000 --- a/doc/tdeioslave/CMakeLists.txt +++ /dev/null @@ -1,3 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -add_subdirectory( en ) diff --git a/doc/tdeioslave/Makefile.am b/doc/tdeioslave/Makefile.am deleted file mode 100644 index 81fee21..0000000 --- a/doc/tdeioslave/Makefile.am +++ /dev/null @@ -1 +0,0 @@ -SUBDIRS = en diff --git a/doc/tdeioslave/en/CMakeLists.txt b/doc/tdeioslave/en/CMakeLists.txt deleted file mode 100644 index 5e29142..0000000 --- a/doc/tdeioslave/en/CMakeLists.txt +++ /dev/null @@ -1,3 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer - -add_subdirectory( videodvd ) diff --git a/doc/tdeioslave/en/Makefile.am b/doc/tdeioslave/en/Makefile.am deleted file mode 100644 index 55ab08d..0000000 --- a/doc/tdeioslave/en/Makefile.am +++ /dev/null @@ -1 +0,0 @@ -SUBDIRS = videodvd diff --git a/doc/tdeioslave/en/videodvd/CMakeLists.txt b/doc/tdeioslave/en/videodvd/CMakeLists.txt deleted file mode 100644 index 18127c6..0000000 --- a/doc/tdeioslave/en/videodvd/CMakeLists.txt +++ /dev/null @@ -1,3 +0,0 @@ -# This file is genereted by trinity-automake-cmake-convert script by Fat-Zer -tde_create_handbook( DESTINATION tdeioslave/videodvd ) - diff --git a/doc/tdeioslave/en/videodvd/Makefile.am b/doc/tdeioslave/en/videodvd/Makefile.am deleted file mode 100644 index adf07a4..0000000 --- a/doc/tdeioslave/en/videodvd/Makefile.am +++ /dev/null @@ -1,2 +0,0 @@ -KDE_LANG = en -KDE_DOCS = tdeioslave/videodvd diff --git a/doc/tdeioslave/en/videodvd/index.docbook b/doc/tdeioslave/en/videodvd/index.docbook deleted file mode 100644 index 1355fde..0000000 --- a/doc/tdeioslave/en/videodvd/index.docbook +++ /dev/null @@ -1,42 +0,0 @@ - - - -]> - -
-videodvd - - - - -&tde-authors; - - - -&tde-release-version; -Reviewed: &tde-release-date; - - -&tde-copyright-date; -&tde-team; - - - - -This handbook describes the videodvd protocol. - - - - -TDE -videodvd -protocol - - - - -The videodvd protocol supports copying files from a video DVD with -on-the-fly decryption when libdvdcss is installed. - -
-- cgit v1.2.1