[kamoso] doc: Update kamoso docbook to kf5
Burkhard Lück
lueck at hube-lueck.de
Sun Sep 11 15:25:30 UTC 2016
Git commit ea06d138bffebc5fce91be4a1ce1dc1a01bae0b4 by Burkhard Lück.
Committed on 11/09/2016 at 15:25.
Pushed by lueck into branch 'master'.
Update kamoso docbook to kf5
REVIEW:128756
D +- -- doc/Face-smile.png
A +- -- doc/folder-images.png
A +- -- doc/gallery-actions.png
M +87 -36 doc/index.docbook
M +- -- doc/kamoso-settings.png
A +- -- doc/mainwindow.png
A +- -- doc/preferences-other.png
A +- -- doc/sc-actions-burst.png
A +- -- doc/sc-actions-record.png
A +- -- doc/sc-actions-shoot.png
A +- -- doc/start-stop.png
http://commits.kde.org/kamoso/ea06d138bffebc5fce91be4a1ce1dc1a01bae0b4
diff --git a/doc/Face-smile.png b/doc/Face-smile.png
deleted file mode 100644
index e80180a..0000000
Binary files a/doc/Face-smile.png and /dev/null differ
diff --git a/doc/folder-images.png b/doc/folder-images.png
new file mode 100644
index 0000000..dd689c0
Binary files /dev/null and b/doc/folder-images.png differ
diff --git a/doc/gallery-actions.png b/doc/gallery-actions.png
new file mode 100644
index 0000000..a8f84c2
Binary files /dev/null and b/doc/gallery-actions.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
index b17684b..9a6e8bd 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -9,26 +9,26 @@
<authorgroup>
<author>
<personname>
- <firstname>This documentation was converted from the KDE UserBase <ulink url=" http://userbase.kde.org/Kamoso">Kamoso</ulink> page.</firstname>
+ <firstname>This documentation was converted from the KDE UserBase <ulink url=" http://userbase.kde.org/Kamoso">Kamoso</ulink> page and updated by the &kde; documentation team.</firstname>
<surname></surname>
</personname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<legalnotice>&FDLNotice;</legalnotice>
-<date>2012-12-05</date>
- <releaseinfo>2.0.2 (&kde; SC 4.10)</releaseinfo>
+<date>2016-08-24</date>
+ <releaseinfo>&kamoso; 3.2</releaseinfo>
<abstract>
<para>
<variablelist>
<varlistentry><term><emphasis role="bold">Take a shot</emphasis></term>
<listitem>
- <para><application>Kamoso</application> gives you an opportunity to make photos from your webcam and upload them to Facebook</para>
+ <para>&kamoso; gives you an opportunity to make photos from your webcam and upload them to Internet</para>
</listitem>
</varlistentry>
<varlistentry><term><emphasis role="bold">Record video</emphasis></term>
<listitem>
- <para><application>Kamoso</application> allows to record videos from your webcam and upload them to YouTube</para>
+ <para>&kamoso; allows to record videos from your webcam and upload them to the Internet</para>
</listitem>
</varlistentry>
</variablelist>
@@ -42,36 +42,92 @@
<!--userbase-content-->
<chapter id="user-guide"><title>User Guide</title>
-<para>Welcome to <application>Kamoso</application>!
+<para>Welcome to &kamoso;!
</para>
-<para><application>Kamoso</application> is a great program to use your webcam to take pictures or make videos. It probably should be the best webcam recorder for &Linux;. This guide will help you use Kamoso once you have installed it. We tried to make it simple and friendly. Good luck!
+<para>&kamoso; is a great program to use your webcam to take pictures or make videos. This guide will help you to use &kamoso; once you have installed it.
</para>
<sect1 id="quick-start"><title>Quick Start</title>
-<para>On launching <application>Kamoso</application>, you are greeted with two groups of buttons on the left and right, and a button in the center.
+<para>On launching &kamoso;, it displays this window with buttons at the bottom:
</para>
-<para>The central button helps you to click a picture! Go ahead and try it now! SMILE! <inlinemediaobject> <imageobject> <imagedata fileref="Face-smile.png" format="PNG"/> </imageobject> </inlinemediaobject>
-</para>
-<para><application>Kamoso</application> will give you a 3 second heads up so you can pose for your picture, and ask you to smile right before clicking!
-</para>
-<para>If you click on the second button from the left, <application>Kamoso</application> changes to burst-mode. <application>Kamoso</application> will keep clicking pictures rapidly till you don't click on the center button and tell it to stop. The pictures line up in chronological order on the bottom, and you can view them by double-clicking them. Alternatively, you could right click and choose <guilabel>Open</guilabel> to view the pictures too! If you aren't happy with any of the pictures, just right click and select <guilabel>Trash</guilabel> to delete that particular picture.
+
+<screenshot>
+<screeninfo></screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="mainwindow.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase></phrase>
+ </textobject>
+ </mediaobject>
+</screenshot>
+
+<simplelist>
+<member><inlinemediaobject><imageobject>
+<imagedata fileref="sc-actions-shoot.png" format="PNG"/></imageobject>
+</inlinemediaobject> Switch to <guibutton>Shoot</guibutton> mode to take one picture
+</member>
+<member><inlinemediaobject><imageobject>
+<imagedata fileref="sc-actions-burst.png" format="PNG"/></imageobject>
+</inlinemediaobject> Switch to <guibutton>Burst</guibutton> mode and take continuously pictures until you stop by clicking the middle button again
+</member>
+<member><inlinemediaobject><imageobject>
+<imagedata fileref="sc-actions-record.png" format="PNG"/></imageobject>
+</inlinemediaobject> Switch to <guibutton>Record</guibutton> mode to record a video
+</member>
+<member><inlinemediaobject><imageobject>
+<imagedata fileref="start-stop.png" format="PNG"/></imageobject>
+</inlinemediaobject>Start or stop taking pictures or recording a video</member>
+<member><inlinemediaobject><imageobject>
+<imagedata fileref="folder-images.png" format="PNG"/></imageobject>
+</inlinemediaobject> <guibutton>Show gallery</guibutton>
+</member>
+<member><inlinemediaobject><imageobject>
+<imagedata fileref="preferences-other.png" format="PNG"/></imageobject>
+</inlinemediaobject> <guibutton>Show settings</guibutton>
+</member></simplelist>
+
+<para>Pictures and videos are numbered consecutively and saved automatically in the <guilabel>Captures directory</guilabel> defined in the settings.
</para>
+
</sect1>
-<sect1 id="upload-image-to-facebook"><title>Upload image to Facebook</title>
-<para>If you feel your newly-clicked pictures must be uploaded to your Facebook profile, just right click on the picture and select <guilabel>Facebook Import/Export</guilabel>. A window will open up on your browser asking you to grant permission to <application>Kamoso</application>. Once you do this, upload away!
+
+<sect1 id="managing-captures"><title>Managing Captures</title>
+
+<para>To view and menage your captured pictures or videos click the <guibutton>Show gallery</guibutton> button.
+In the context context menu for each entry in the gallery you find actions to manage them:
</para>
-<para><note><para>You need to have an account on Facebook to upload the picture you made </para></note>
+
+<screenshot>
+<screeninfo></screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="gallery-actions.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase></phrase>
+ </textobject>
+ </mediaobject>
+</screenshot>
+
+<para>Use <guimenuitem>Open</guimenuitem> to view your captures in the associated applicaton.
</para>
-<para>If you want to avoid all the right clicks, click on the second button on the right side and you'll be provided with the same options as when you right click.
+
+<para>If you want to delete pictures and videos open the captures folder in the filemanager.
</para>
-</sect1>
-<sect1 id="upload-video-to-youtube"><title>Upload video to YouTube</title>
-<para><application>Kamoso</application> also allows you to capture videos! By clicking on the red button on the left, you change to video mode. Click on the central button to shoot your video! Right click on the video and select <guilabel>YouTube</guilabel> to upload it to YouTube.
+
+<para>The next actions allow you to upload captures to the Internet or send them to a contact or device.
</para>
-<para><note><para>You need to have an account on YouTube and provide <application>Kamoso</application> an access with your username and password – don't worry, it's totally safe!</para></note>
+
+<para>Use <guimenuitem>Save as</guimenuitem> to copy the complete content of the gallery to a new folder.
</para>
+
</sect1>
-<sect1 id="customising"><title>Customising</title>
-<para>
+
+<sect1 id="customizing"><title>Customizing</title>
+<para>Click the <guibutton>Show settings</guibutton> button to open the settings panel. Click the button again to hide the settings panel.
+</para>
+
<screenshot>
<screeninfo></screeninfo>
<mediaobject>
@@ -83,29 +139,24 @@
</textobject>
</mediaobject>
</screenshot>
+
+<para>If you want to change the folder where &kamoso; saves pictures and videos, change the <guilabel>Captures directory</guilabel> at the top.
</para>
-<para>If you feel your picture quality isn't optimal, click on the button on the extreme right and select <guilabel>Settings</guilabel>. This is the settings panel.
-</para>
-<para>If you want to change the directory where <application>Kamoso</application> saves the pictures, navigate to the <guilabel>General</guilabel> panel, and change the directory from thereon.
-</para>
-<para>If you want to change the time before <application>Kamoso</application> clicks your picture, navigate to <guilabel>Photo settings</guilabel>.
-</para>
-<para>If you're a really technical user, scroll over to the <guilabel>Video settings</guilabel> and there you can adjust settings like brightness, contrast, &etc;
-</para>
-</sect1>
-<sect1 id="the-end"><title>The End</title>
-<para>Well, we've reached the end of our tutorial. I hope your queries have been adequately answered!
+
+<para>Enable <guibutton>Use flash</guibutton> to highligt the window before taking photos.
</para>
-<para>Enjoy using <application>Kamoso</application>! <inlinemediaobject> <imageobject> <imagedata fileref="Face-smile.png" format="PNG"/> </imageobject> </inlinemediaobject>
+
+<para>Using the sliders you can modify camera settings like brightness, hue, contrast, saturation and gamma.
</para>
</sect1>
+
</chapter>
<!--userbase-content-->
<chapter id="credits">
<title>Credits and License</title>
<para>
-Documentation Copyright see the UserBase
+Documentation Copyright see the UserBase
<ulink url="http://userbase.kde.org/index.php?title=Kamoso&action=history">Kamoso page history</ulink></para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
diff --git a/doc/kamoso-settings.png b/doc/kamoso-settings.png
index a671477..31d1823 100644
Binary files a/doc/kamoso-settings.png and b/doc/kamoso-settings.png differ
diff --git a/doc/mainwindow.png b/doc/mainwindow.png
new file mode 100644
index 0000000..f033ba6
Binary files /dev/null and b/doc/mainwindow.png differ
diff --git a/doc/preferences-other.png b/doc/preferences-other.png
new file mode 100644
index 0000000..d560d4e
Binary files /dev/null and b/doc/preferences-other.png differ
diff --git a/doc/sc-actions-burst.png b/doc/sc-actions-burst.png
new file mode 100644
index 0000000..f1afe17
Binary files /dev/null and b/doc/sc-actions-burst.png differ
diff --git a/doc/sc-actions-record.png b/doc/sc-actions-record.png
new file mode 100644
index 0000000..3d587d6
Binary files /dev/null and b/doc/sc-actions-record.png differ
diff --git a/doc/sc-actions-shoot.png b/doc/sc-actions-shoot.png
new file mode 100644
index 0000000..8e39f99
Binary files /dev/null and b/doc/sc-actions-shoot.png differ
diff --git a/doc/start-stop.png b/doc/start-stop.png
new file mode 100644
index 0000000..1c57597
Binary files /dev/null and b/doc/start-stop.png differ
More information about the kde-doc-english
mailing list