[kde-doc-english] [kamoso] /: Add Kamoso documentation created by GCI-2012 student
Yuri Chornoivan
yurchor at ukr.net
Wed Jan 16 18:03:30 UTC 2013
Git commit bf2d9c463162bf26e126820ef8285ea531b1b7c3 by Yuri Chornoivan.
Committed on 16/01/2013 at 19:03.
Pushed by yurchor into branch 'master'.
Add Kamoso documentation created by GCI-2012 student
M +1 -0 CMakeLists.txt
A +1 -0 doc/CMakeLists.txt
A +- -- doc/Face-smile.png
A +114 -0 doc/index.docbook
A +- -- doc/kamoso-settings.png
http://commits.kde.org/kamoso/bf2d9c463162bf26e126820ef8285ea531b1b7c3
diff --git a/CMakeLists.txt b/CMakeLists.txt
index f84a6ce..5d6bfb1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -17,3 +17,4 @@ include_directories(${CMAKE_CURRENT_BINARY_DIR})
add_subdirectory(src)
add_subdirectory(icons)
+add_subdirectory(doc)
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
new file mode 100644
index 0000000..4596a95
--- /dev/null
+++ b/doc/CMakeLists.txt
@@ -0,0 +1 @@
+kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kamoso)
diff --git a/doc/Face-smile.png b/doc/Face-smile.png
new file mode 100644
index 0000000..e80180a
Binary files /dev/null and b/doc/Face-smile.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
new file mode 100644
index 0000000..d49b428
--- /dev/null
+++ b/doc/index.docbook
@@ -0,0 +1,114 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+ <!ENTITY % addindex "IGNORE">
+ <!ENTITY % English "INCLUDE">
+]>
+<book lang="&language;">
+<bookinfo>
+<title>The Kamoso Handbook</title>
+<authorgroup>
+<author>
+<personname>
+ <firstname>This documentation was converted from the KDE UserBase <ulink url=" http://userbase.kde.org/Kamoso">Kamoso</ulink> page.</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>
+<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>
+ </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>
+ </listitem>
+ </varlistentry>
+</variablelist>
+</para>
+ </abstract>
+ <keywordset>
+<keyword>KDE</keyword>
+</keywordset>
+</bookinfo>
+<!--userbase <timestamp>2012-12-05T19:30:21Z</timestamp>-->
+
+<!--userbase-content-->
+<chapter id="user-guide"><title>User Guide</title>
+<para>Welcome to <application>Kamoso</application>!
+</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>
+<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>
+<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.
+</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!
+</para>
+<para><note><para>You need to have an account on Facebook to upload the picture you made </para></note>
+</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>
+</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>
+<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>
+</sect1>
+<sect1 id="customising"><title>Customising</title>
+<para>
+<screenshot>
+<screeninfo></screeninfo>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="kamoso-settings.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase></phrase>
+ </textobject>
+ </mediaobject>
+</screenshot>
+</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>
+<para>Enjoy using <application>Kamoso</application>! <inlinemediaobject> <imageobject> <imagedata fileref="Face-smile.png" format="PNG"/> </imageobject> </inlinemediaobject>
+</para>
+</sect1>
+</chapter>
+
+<!--userbase-content-->
+<chapter id="credits">
+<title>Credits and License</title>
+ <para>
+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;
+</chapter>
+&documentation.index;
+</book>
diff --git a/doc/kamoso-settings.png b/doc/kamoso-settings.png
new file mode 100644
index 0000000..a671477
Binary files /dev/null and b/doc/kamoso-settings.png differ
More information about the kde-doc-english
mailing list