Git commit bc2a134a510ad3671aa2f069e0468a296dd41e2d by Yuri Chornoivan. Committed on 08/05/2019 at 14:51. Pushed by yurchor into branch 'master'.
Sync Quick Start manual with UserBase M +22 -38 doc/index.docbook M +- -- doc/kdenlive-quickstart-add-last-clip.png M +- -- doc/kdenlive-quickstart-add-transition.png M +- -- doc/kdenlive-quickstart-effectstack.png M +- -- doc/kdenlive_quickstart-add-effect.png M +- -- doc/kdenlive_quickstart-effect-flag.png M +- -- doc/kdenlive_quickstart-fadeout.png M +- -- doc/kdenlive_quickstart-keyframes.png M +- -- doc/kdenlive_quickstart-new-project.png M +- -- doc/kdenlive_quickstart-overlap-clips.png M +- -- doc/kdenlive_quickstart-renderer.png M +- -- doc/kdenlive_quickstart-rendering.png M +- -- doc/kdenlive_quickstart-resize-marker.png M +- -- doc/kdenlive_quickstart-timelinecursor.png https://invent.kde.org/kde/kdenlive/commit/bc2a134a510ad3671aa2f069e0468a296dd41e2d diff --git a/doc/index.docbook b/doc/index.docbook index b7664c653..fe2d1eec5 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -16,8 +16,8 @@ <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> <legalnotice>&FDLNotice;</legalnotice> -<date>2018-10-27</date> - <releaseinfo>Applications 18.12</releaseinfo> +<date>2019-05-07</date> + <releaseinfo>Applications 19.04</releaseinfo> <abstract> <para></para> </abstract> @@ -27,7 +27,7 @@ <keyword>video</keyword> </keywordset> </bookinfo> -<!--userbase <timestamp>2018-10-27T11:21:38Z</timestamp>--> +<!--userbase <timestamp>2019-04-16T07:41:55Z</timestamp>--> <!--userbase-content--> <chapter id="quick-start"><title>Quick Start</title> @@ -70,7 +70,7 @@ </mediaobject> </screenshot> </para> -<para>Open &kdenlive; and create a new project (<menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice>). +<para>Open &kdenlive; and create a new project (<guilabel>File</guilabel> &rarr; <guilabel>New</guilabel>). </para> <para>Choose the previously created project folder (<filename>quickstart-tutorial/</filename>) and select an appropriate project profile. The video files provided above are 720p, 23.98 fps.<footnote><para><ulink url="http://en.wikipedia.org/wiki/720p";>720</ulink> is the video height, p stands for <ulink url="http://en.wikipedia.org/wiki/Progressive_scan";>progressive scan</ulink> in contrast to <ulink url="http://en.wikipedia.org/wiki/Interlaced_video";>interlaced video</ulink>, and the fps number denotes the number of full frames per second.</para></footnote> If you are using your own files and don’t know which one to use, &kdenlive; will suggest an appropriate one when the first clip is added <footnote><para>Provided Configure Kdenlive Settings under <ulink url="http://userbase.kde.org/Special:myLanguage/Kdenlive/Manual/Settings_Menu/Configure_Kdenlive#Misc";>Misc</ulink> is set to <emphasis>Check if first added clip matches project profile</emphasis></para></footnote> , so you can leave the field on whatever it is. </para> @@ -84,15 +84,15 @@ <imagedata fileref="kdenlive_quickstart-add-clips.png" format="PNG"/> </imageobject> <textobject> - <phrase>Project Tree: Adding video clips</phrase> + <phrase>Project Bin: Adding video clips</phrase> </textobject> <caption> - <para>Project Tree: Adding video clips</para> + <para>Project Bin: Adding video clips</para> </caption> </mediaobject> </screenshot> </para> -<para>Now that the project is ready, let’s start adding some clips (&ie; the ones you downloaded). This works via the <emphasis>Project Tree widget</emphasis>; a click on the <guilabel>Add Clip</guilabel> icon <inlinemediaobject> <imageobject> <imagedata fileref="Icon-add-clip.png" format="PNG"/> </imageobject> </inlinemediaobject> directly opens the file dialog, a click on the small arrow shows a list of additional clip types that can be added as well. Video clips, audio clips, images, and other &kdenlive; projects can be added via the default <guilabel>Add Clip</guilabel> dialog. +<para>Now that the project is ready, let’s start adding some clips (&ie; the ones you downloaded). This works via the <emphasis>Project Bin widget</emphasis>; a click on the <guilabel>Add Clip</guilabel> icon <inlinemediaobject> <imageobject> <imagedata fileref="Icon-add-clip.png" format="PNG"/> </imageobject> </inlinemediaobject> directly opens the file dialog, a click on the small arrow shows a list of additional clip types that can be added as well. Video clips, audio clips, images, and other &kdenlive; projects can be added via the default <guilabel>Add Clip</guilabel> dialog. </para> <para> <screenshot> @@ -102,10 +102,10 @@ <imagedata fileref="kdenlive_quickstart-mainwindow.png" format="PNG"/> </imageobject> <textobject> - <phrase>Kdenlive 16.08 window with the tutorial files</phrase> + <phrase>Kdenlive window with the tutorial files</phrase> </textobject> <caption> - <para>Kdenlive 16.08 window with the tutorial files</para> + <para>Kdenlive window with the tutorial files</para> </caption> </mediaobject> </screenshot> @@ -128,11 +128,11 @@ </mediaobject> </screenshot> </para> -<para>Let’s save the work via <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice>. This saves our project, &ie; where we placed the clips on the timeline, which effects we applied, and so on. It can <emphasis>not</emphasis> be played.<footnote><para>To be correct, it <emphasis>can</emphasis> be played using <varname>melt yourproject.kdenlive</varname>, but this is not the way you would want to present your final video since it is (most likely) too slow. Additionally, it only works if melt is installed.</para></footnote> The process of creating the final video is called <emphasis>Rendering</emphasis>. +<para>Let’s save the work via <guilabel>File</guilabel> &rarr; <guilabel>Save</guilabel>. This saves our project, &ie; where we placed the clips on the timeline, which effects we applied, and so on. It can <emphasis>not</emphasis> be played.<footnote><para>To be correct, it <emphasis>can</emphasis> be played using <varname>melt yourproject.kdenlive</varname>, but this is not the way you would want to present your final video since it is (most likely) too slow. Additionally, it only works if melt is installed.</para></footnote> The process of creating the final video is called <emphasis>Rendering</emphasis>. </para> </sect1> <sect1 id="timeline"><title>Timeline</title> -<para>See also <link linkend="timeline">Timeline section of the manual</link> +<para>See also <ulink url="http://userbase.kde.org/Special:myLanguage/Kdenlive/Manual/Timeline";>Timeline section of the manual</ulink> </para> <para>Now comes the actual editing. Project clips are combined to the final result on the timeline. They get there by drag and drop: Drag some Napoli (assuming you are using the files provided above, as in the rest of this quick start tutorial; If not, please make sure your screen is waterproof, and perhaps tomatoproof) from the project tree, and drop it onto the first track in the timeline. </para> @@ -226,7 +226,7 @@ </mediaobject> </screenshot> </para> -<para>Now that the clips overlap, the transition can be added. This is done either by right-clicking on the upper clip and choosing <guilabel>Add Transition</guilabel> or, easier, by clicking the green triangle that appears when you hover the mouse over the lower right corner of the Spoon clip. The latter, by default, adds a dissolve transition, which is in this case the best idea anyway since the Spoon is not required for playing. +<para>Now that the clips overlap, the transition can be added. This is done either by right-clicking on the upper clip and choosing <guilabel>Add Transition</guilabel> or, easier, by hovering the mouse over the lower right corner of the Spoon clip until the pointing-finger pointer is shown and the message <quote>Click to add transition</quote> appears. The latter, by default, adds a dissolve transition, which is in this case the best idea anyway since the Spoon is not required for playing. </para> <para>The dissolve transitions fades the first clip into the second one. See also <ulink url="http://userbase.kde.org/Special:myLanguage/Kdenlive/Manual/Transitions";>Transition section of the manual</ulink>. </para> @@ -262,7 +262,7 @@ </mediaobject> </screenshot> </para> -<para>The Piano can be colourized by adding an <emphasis>effect</emphasis> to it. Select the piano clip, then double-click the <guilabel>RGB Adjustment</guilabel> effect in the <guilabel>Effect List</guilabel>. If it is not visible, you can get it via <menuchoice><guimenu>View</guimenu><guimenuitem>Effect List</guimenuitem></menuchoice>. +<para>The Piano can be colourized by adding an <emphasis>effect</emphasis> to it. Select the piano clip, then double-click the <guilabel>RGB Adjustment</guilabel> effect in the <guilabel>Effect List</guilabel>. If it is not visible, you can get it via <guilabel>View</guilabel> &rarr; <guilabel>Effect List</guilabel>. </para> <para> <screenshot> @@ -277,7 +277,7 @@ </mediaobject> </screenshot> </para> -<para>Once the effect has been added, its name will be added to the timeline clip. It will also be shown in the <guilabel>Effect Stack</guilabel> widget. +<para>Once the effect has been added, its name will be added to the timeline clip. It will also be shown in the <guilabel>Properties</guilabel> widget. </para> <para> <screenshot> @@ -297,9 +297,9 @@ </para> <para>To get a warm yellow-orange tone on the image, fitting the comfortable evening, blue needs to be reduced and red and green improved. </para> -<para>The values in the effect stack widget can be changed by using the slider (middle mouse button resets it to the default value), or by entering a value directly by double-clicking the number to the right of the slider. +<para>The values in the Properties widget can be changed by using the slider (middle mouse button resets it to the default value), or by entering a value directly by double-clicking the number to the right of the slider. </para> -<para>Effects can also be added with the <guilabel>Add new effect</guilabel> icon (framed in the image on the left) in the <guilabel>Effect Stack</guilabel>; It always refers to the timeline clip that is currently selected. By unchecking the checkbox they are temporarily disabled (the settings remain though), this is ⪚ useful for effects that require a lot of computing power, so they can be disabled when editing and enabled again for rendering. +<para>The Properties widget always refers to the timeline clip that is currently selected. Each effect can be temporarily disabled by clicking the eye icon, or all effects for that clip can be disabled using the check box at the top of the Properties widget (the settings are saved though), this is ⪚ useful for effects that require a lot of computing power, so they can be disabled when editing and enabled again for rendering. </para> <para>For some effects, like the one used there, it is possible to add keyframes. The framed watch icon indicates this. Keyframes are used for changing effect parameters over time. In our clip this allows us to fade the piano’s colour from a warm evening colour to a cold night colour. </para> @@ -319,15 +319,15 @@ </mediaobject> </screenshot> </para> -<para>After clicking the <guilabel>keyframe</guilabel> icon (the clock icon framed in the previous image), the Effect Stack widget will re-arrange. By default there will be two keyframes, one at the beginning of the timeline clip and one at the end. Move the timeline cursor to the end of the timeline clip, such that the project monitor actually shows the new colours when changing the parameters of the keyframe at the end. +<para>After clicking the <guilabel>keyframe</guilabel> icon (the clock icon framed in the previous image), the Properties widget will re-arrange. By default there will be two keyframes, one at the beginning of the timeline clip and one at the end. Move the timeline cursor to the end of the timeline clip, such that the project monitor actually shows the new colours when changing the parameters of the keyframe at the end. </para> -<para>Make sure the last keyframe is selected in the Effect Stack’s list. Then you are ready to flood the piano with a deep blue. +<para>Make sure the last keyframe is selected in the Properties list. Then you are ready to flood the piano with a deep blue. </para> <para>Moving the timeline cursor to the beginning of the project and playing it (with <keycap>Space</keycap>, or the <guilabel>Play</guilabel> button in the <guilabel>Project Monitor</guilabel>), the piano should now change the colour as desired. </para> <para>Keyframing was the hardest part of this tutorial. If you managed to do it, you will master &kdenlive; easily! </para> -<para>See also <link linkend="effects">Effects section of the manual</link>. +<para>See also <ulink url="http://userbase.kde.org/Special:myLanguage/Kdenlive/Manual/Effects";>Effects section of the manual</ulink>. </para> </sect2> <sect2 id="music"><title>Music</title> @@ -349,7 +349,7 @@ </para> <para>Since the clips do not provide any audio, let’s search for some nice piece of music, from your local collection or on web pages like <ulink url="http://www.jamendo.com";>Jamendo</ulink>. The audio clip should, after adding it, be dragged to an audio track on the timeline. </para> -<para>The audio clip can be resized on the timeline the same way as video clips are. The cursor will snap in at the end of the project automatically. To add a fade out effect at the end of the audio clip (except if you found a file with exactly the right length) you can hover the top right (or left) edge of the timeline clip and drag the green disc to the position where fading out should start.<footnote><para>This green disc is a shorthand for adding the effect <menuchoice><guimenu>Fade</guimenu><guimenuitem>Fade out</guimenuitem></menuchoice>. Both ways lead to the same result.</para></footnote> +<para>The audio clip can be resized on the timeline the same way as video clips are. The cursor will snap in at the end of the project automatically. To add a fade out effect at the end of the audio clip (except if you found a file with exactly the right length) you can hover the top right (or left) edge of the timeline clip and drag the red shaded triangle to the position where fading out should start.<footnote><para>This shaded triangle is a shorthand for adding the effect <guilabel>Fade</guilabel> &rarr; <guilabel>Fade out</guilabel>. Both ways lead to the same result.</para></footnote> </para> </sect2> </sect1> @@ -370,7 +370,7 @@ </mediaobject> </screenshot> </para> -<para>A few minutes left, and the project is finished! Click the Render button (or go to <menuchoice><guimenu>Project</guimenu><guimenuitem>Render</guimenuitem></menuchoice>, or press <keycombo>&Ctrl;&Enter;</keycombo>) to get the dialog shown on the left. Select the desired output file for our new video with all effects and transitions, choose MPEG4 (works nearly everywhere) and a bitrate of 2000k (the higher the bitrate, the larger the output file and the better the quality – but since the bitrate for the input clips was 2000k already, using a higher one would not improve quality and is therefore unnecessary), and press the <guilabel>Render to File</guilabel> button. +<para>A few minutes left, and the project is finished! Click the Render button (or go to <guilabel>Project</guilabel> &rarr; <guilabel>Render</guilabel>, or press <keycombo>&Ctrl;&Enter;</keycombo>) to get the dialog shown on the left. Select the desired output file for our new video with all effects and transitions, choose MP4 (works nearly everywhere), select the output file location and press the <guilabel>Render to File</guilabel> button. </para> <para> <screenshot> @@ -390,27 +390,11 @@ </para> <para>After some seconds rendering will be finished, and your first &kdenlive; project completed. Congratulations! </para> -<screenshot> -<screeninfo></screeninfo> - <mediaobject> - <imageobject> - <imagedata fileref="kdenlive_quickstart-rendering.png" format="PNG"/> - </imageobject> - <textobject> - <phrase>Rendering progress</phrase> - </textobject> - <caption> - <para>Rendering progress</para> - </caption> - </mediaobject> -</screenshot> </sect1> -<sect1> -<title>Complete manual</title> +<sect1 id="complete-manual"><title>Complete manual</title> <para>Further documentation for the current version of &kdenlive; can be found in <ulink url="http://userbase.kde.org/Special:myLanguage/Kdenlive/Manual";>the full manual</ulink>. </para> </sect1> - </chapter> <!--userbase-content--> diff --git a/doc/kdenlive-quickstart-add-last-clip.png b/doc/kdenlive-quickstart-add-last-clip.png index a7e13ffc8..13fcc1546 100644 Binary files a/doc/kdenlive-quickstart-add-last-clip.png and b/doc/kdenlive-quickstart-add-last-clip.png differ diff --git a/doc/kdenlive-quickstart-add-transition.png b/doc/kdenlive-quickstart-add-transition.png index 25d3bcf36..9a337694e 100644 Binary files a/doc/kdenlive-quickstart-add-transition.png and b/doc/kdenlive-quickstart-add-transition.png differ diff --git a/doc/kdenlive-quickstart-effectstack.png b/doc/kdenlive-quickstart-effectstack.png index 9ff6a4cab..1f4e99739 100644 Binary files a/doc/kdenlive-quickstart-effectstack.png and b/doc/kdenlive-quickstart-effectstack.png differ diff --git a/doc/kdenlive_quickstart-add-effect.png b/doc/kdenlive_quickstart-add-effect.png index d560f9463..d8dca72ca 100644 Binary files a/doc/kdenlive_quickstart-add-effect.png and b/doc/kdenlive_quickstart-add-effect.png differ diff --git a/doc/kdenlive_quickstart-effect-flag.png b/doc/kdenlive_quickstart-effect-flag.png index 32cc23e61..eb39b16b1 100644 Binary files a/doc/kdenlive_quickstart-effect-flag.png and b/doc/kdenlive_quickstart-effect-flag.png differ diff --git a/doc/kdenlive_quickstart-fadeout.png b/doc/kdenlive_quickstart-fadeout.png index e99685509..88293f0c6 100644 Binary files a/doc/kdenlive_quickstart-fadeout.png and b/doc/kdenlive_quickstart-fadeout.png differ diff --git a/doc/kdenlive_quickstart-keyframes.png b/doc/kdenlive_quickstart-keyframes.png index 998d15be0..83742e6a0 100644 Binary files a/doc/kdenlive_quickstart-keyframes.png and b/doc/kdenlive_quickstart-keyframes.png differ diff --git a/doc/kdenlive_quickstart-new-project.png b/doc/kdenlive_quickstart-new-project.png index d254d6309..468c7cd86 100644 Binary files a/doc/kdenlive_quickstart-new-project.png and b/doc/kdenlive_quickstart-new-project.png differ diff --git a/doc/kdenlive_quickstart-overlap-clips.png b/doc/kdenlive_quickstart-overlap-clips.png index 211dbdac0..a53d30227 100644 Binary files a/doc/kdenlive_quickstart-overlap-clips.png and b/doc/kdenlive_quickstart-overlap-clips.png differ diff --git a/doc/kdenlive_quickstart-renderer.png b/doc/kdenlive_quickstart-renderer.png index 6d35642d3..881d89b30 100644 Binary files a/doc/kdenlive_quickstart-renderer.png and b/doc/kdenlive_quickstart-renderer.png differ diff --git a/doc/kdenlive_quickstart-rendering.png b/doc/kdenlive_quickstart-rendering.png index 36fd58b8a..369facb2d 100644 Binary files a/doc/kdenlive_quickstart-rendering.png and b/doc/kdenlive_quickstart-rendering.png differ diff --git a/doc/kdenlive_quickstart-resize-marker.png b/doc/kdenlive_quickstart-resize-marker.png index 9daf6e9f7..e59802f84 100644 Binary files a/doc/kdenlive_quickstart-resize-marker.png and b/doc/kdenlive_quickstart-resize-marker.png differ diff --git a/doc/kdenlive_quickstart-timelinecursor.png b/doc/kdenlive_quickstart-timelinecursor.png index c8fbd6efb..ca5ed0292 100644 Binary files a/doc/kdenlive_quickstart-timelinecursor.png and b/doc/kdenlive_quickstart-timelinecursor.png differ
