[gnome-photos/gnome-3-12] Start adding user help



commit e2df826613d37cddeb59f42c2c7bed6ed8e51a1a
Author: Venkatesh Tahiliani <pulsar viki gmail com>
Date:   Thu Apr 3 20:35:15 2014 +0100

    Start adding user help

 help/C/addphotos.page       |   60 +++++++++++++++++++++++++++++++
 help/C/createanalbum.page   |   56 +++++++++++++++++++++++++++++
 help/C/deleteanalbum.page   |   45 +++++++++++++++++++++++
 help/C/imgprops.page        |   58 ++++++++++++++++++++++++++++++
 help/C/index.page           |   47 ++++++++++++++++++++++++
 help/C/media/logo1.png      |  Bin 0 -> 3582 bytes
 help/C/printing.page        |   60 +++++++++++++++++++++++++++++++
 help/C/removephotos.page    |   51 ++++++++++++++++++++++++++
 help/C/selectionmode.page   |   83 +++++++++++++++++++++++++++++++++++++++++++
 help/C/setasbackground.page |   30 +++++++++++++++
 help/C/setupfavourites.page |   55 ++++++++++++++++++++++++++++
 help/C/viewingphoto.page    |   75 ++++++++++++++++++++++++++++++++++++++
 12 files changed, 620 insertions(+), 0 deletions(-)
---
diff --git a/help/C/addphotos.page b/help/C/addphotos.page
new file mode 100644
index 0000000..7d5586c
--- /dev/null
+++ b/help/C/addphotos.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="addphotos">
+
+  <info>
+    <link type="guide" xref="index#albums"/>
+       <credit type="author">
+        <name>Venkatesh Tahiliani</name>
+        <email>pulsar viki gmail com</email>
+       </credit>
+      <credit type="editor">
+        <name>Aruna Sankaranarayanan</name>
+        <email>safincrazy gmail com</email>
+      </credit>
+    <desc> Add photos to an existing album.</desc>
+  </info>
+
+  <title>Adding photos to an album</title>
+   <p>
+  We can add photos to an existing album present in the <gui style="tab">Albums</gui> tab.
+  The photos which are to be added to an existing album can be from
+  another album, from <gui style="tab">Favourites</gui> or from the <gui style="tab">Photos</gui> tab.
+  </p>
+ <section id="addphotos">
+   <title>To add photos to an existing album:</title>
+  <steps>
+    <item>
+     <p>
+       Select the photos using any one of the selection modes.
+     </p>
+    </item>
+    <item>
+     <p>
+       When photos are selected a lower secondary toolbar appears,
+        select <gui style="button">Add to Album</gui> from the secondary toolbar.
+     </p>
+    </item>
+    <item>
+     <p>
+       A dialog box titled <gui>Organize</gui> appears,
+        check the check box for the album to
+        which the photos are to be added.
+     </p>
+    </item>
+    <item>
+     <p>
+       Click <gui style="button">Ok</gui>
+     </p>
+    </item>
+  </steps>
+ </section>
+ <section>
+   <note>
+    <p>
+       If a check box in the <gui>Organize</gui> dialog box is already checked,
+       it indicates that the photo is already present in that album.
+    </p>
+   </note>
+ </section>
+</page>
diff --git a/help/C/createanalbum.page b/help/C/createanalbum.page
new file mode 100644
index 0000000..054fb88
--- /dev/null
+++ b/help/C/createanalbum.page
@@ -0,0 +1,56 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="createanalbum">
+
+  <info>
+    <link type="guide" xref="index#albums"/>
+   <credit type="author">
+    <name>Venkatesh Tahiliani</name>
+    <email>pulsar viki gmail com</email>
+   </credit>
+    <credit type="editor">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+    <desc> Create an album to group your photos.</desc>
+  </info>
+  <title>Creating an album</title>
+  <p>
+  We can create an album to group a set of photos together.
+  Albums can be created by selecting photos either from the
+  <gui style="tab">Photos</gui> tab or <gui style="tab">Favourites</gui> tab.
+  An album may also be created by selecting photos from an 
+  existing album in the <gui style="tab">Albums</gui> tab.
+  </p>
+ <section id="createalbum">
+ <title>To create an album:</title>
+  <steps>
+   <item>
+    <p>
+    Select the photos to be deleted using any one of the selection modes.
+    </p>
+   </item>
+   <item>
+    <p>
+    When photos are selected a lower secondary toolbar appears.
+    Select <gui style="button">Add to Album</gui> from the secondary toolbar.
+    </p>
+   </item>
+   <item>
+    <p>
+    A dialog box labelled <gui>Organize</gui> appears, select Add from the same.
+    </p>
+   </item>
+   <item>
+    <p>
+    Type in the name of the album to be created
+    </p>
+   </item>
+   <item>
+    <p>
+    Click <key>Ok</key>
+    </p>
+   </item>
+  </steps>
+ </section>
+</page>
diff --git a/help/C/deleteanalbum.page b/help/C/deleteanalbum.page
new file mode 100644
index 0000000..a297235
--- /dev/null
+++ b/help/C/deleteanalbum.page
@@ -0,0 +1,45 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="deleteanalbum">
+
+  <info>
+    <link type="guide" xref="index#albums"/>
+  <credit type="author">
+   <name>Venkatesh Tahiliani</name>
+   <email>pulsar viki gmail com</email>
+  </credit>
+    <credit type="editor">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+    <desc> Delete an album.</desc>
+  </info>
+  <title>Deleting an album</title>
+  <p>
+  An album can be deleted from the Albums tab.
+  More than one album can be deleted by selecting
+  them using any one of the selection modes.
+  </p>
+ <section id="deletealbum">
+ <title>To delete an album:</title>
+ <steps>
+  <item>
+  <p>
+  Select the <gui style="tab">Albums</gui> tab.
+  </p>
+  </item>
+  <item>
+   <p>
+   Right click on the album to be deleted,alternatively use any one
+   of the selection modes to select more than one album.
+   </p>
+  </item>
+  <item>
+   <p>
+   The secondary toolbar pops up with the Delete button enabled,
+   a click on the delete button discards all the selected albums.
+   </p>
+  </item>
+ </steps>
+ </section>
+</page>
diff --git a/help/C/imgprops.page b/help/C/imgprops.page
new file mode 100644
index 0000000..da064f8
--- /dev/null
+++ b/help/C/imgprops.page
@@ -0,0 +1,58 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="imgprops">
+
+  <info>
+    <link type="guide" xref="index#preferences"/>
+
+<credit type="author">
+ <name>Venkatesh Tahiliani</name>
+ <email>pulsar viki gmail com</email>
+</credit>
+<credit type="editor">
+ <name>Aruna Sankaranarayanan</name>
+ <email>safincrazy gmail com</email>
+</credit>
+
+    <desc> View attributes of an album or image.</desc>
+  </info>
+
+  <title>Properties</title>
+<p>
+Properties are associated with an image or an album. Attributes like title, source, date modified and type 
are associated with an album. Image attributes have much precise detailed information like the camera used, 
exposure, focal length, aperture and flash. Properties can only be viewed for an individual album or photo 
and cannot be viewed for a selected set of albums or photos.
+</p>
+ <section id="viewprops">
+  <title>To view properties:</title>
+  <steps>
+   <item><p>Select the photo or album using any one of the selection modes.</p></item>
+   <item><p>The lower secondary toolbar appears, click on <gui style="button">Properties</gui> to view 
properties of the selection.</p></item>
+   <item><p>Click <gui style="button">Done</gui> to close the Properties window.</p></item>
+  </steps>
+  <note style="tip">
+   <p>
+  Properties of an image can also be accessed from the same when opened for viewing by 
+  clicking on the gear icon on the  primary toolbar and selecting Properties.
+   </p> 
+  </note>
+ </section>
+ <section id="title">
+ <title>To change an image title:</title>
+ <p>
+  <gui style="input">Title</gui> is an editable attribute of an image or album and can be changed by 
accessing properties of the same.
+ </p>
+ <steps>
+  <item><p>
+   Select the photo or album using any one of the selection modes.
+  </p></item>
+  <item><p>
+  The lower secondary toolbar appears, click on <gui style="button">Properties</gui>.
+  </p></item>
+  <item><p>
+  A window titled <gui>Properties</gui> appears, edit the text for the <gui style="input">Title</gui> 
attribute to any desired name.
+   </p></item>
+  <item><p>
+  On completion, click <gui style="button">Done</gui>.
+  </p></item>
+ </steps>
+ </section>
+</page>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..c661be1
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,47 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="guide" style="2column"
+       id="index">
+
+ <info>
+  <title type="link">Photos</title>
+  <credit type="author">
+   <name>Venkatesh Tahiliani</name>
+   <email>pulsar viki gmail com</email>
+  </credit>
+  <credit type="editor">
+   <name>Aruna Sankaranarayanan</name>
+   <email>safincrazy gmail com</email>
+  </credit>
+   <license>
+   <p>
+     Creative Commons Share Alike 3.0
+   </p>
+  </license>
+ </info>
+   <title>
+     <media type="image" src="media/logo1.png" width="28" height="28"></media>
+      Photos
+   </title>
+     <p>
+        <app> Photos</app> is an application a user can use as an alternative
+        to the file browser. It also enables a user to directly view photos
+        present in the picture directory in a much more interactive way and
+        perform tasks like creating albums, printing photos and setting
+        favourites.
+     </p>
+   <section id="gettingstarted" style="2column">
+     <title>
+       Getting started
+     </title>
+   </section>
+   <section id="albums" style="2column">
+      <title>
+        Albums
+      </title>
+   </section>
+   <section id="preferences" style="2column">
+      <title>
+        Preferences
+      </title>
+   </section>
+</page>
diff --git a/help/C/media/logo1.png b/help/C/media/logo1.png
new file mode 100644
index 0000000..3f236c0
Binary files /dev/null and b/help/C/media/logo1.png differ
diff --git a/help/C/printing.page b/help/C/printing.page
new file mode 100644
index 0000000..58f5a3a
--- /dev/null
+++ b/help/C/printing.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="printing">
+
+  <info>
+    <link type="guide" xref="index#preferences"/>
+
+<credit type="author">
+<name>Venkatesh Tahiliani</name>
+<email>pulsar viki gmail com</email>
+</credit>
+
+    <credit type="editor">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <desc> Print desired photos.</desc>
+  </info>
+
+  <title>Printing a photo</title>
+ <section id="printingphoto">
+ <title>To print a photo:</title>
+  <p>
+   Printing preferences can be accessed in any one of the following ways:
+  </p>
+  
+  <list>
+  <item><p>Select the photo using anyone of the selection modes
+        and click <gui style="button">Print</gui> from the secondary toolbar.
+  </p></item>
+  <item><p>
+  Hold <keyseq><key>Ctrl</key><key>P</key></keyseq> after a photo is opened for viewing.
+  </p></item>
+  <item><p>
+  Click on the gear icon in the primary toolbar and manually select <gui style="menuitem">Print</gui>.
+  </p></item>
+  </list>
+  <p>
+  From the printing preferences window:
+  </p>
+   <steps>
+   <item><p>
+   Select the printer from the <gui style="tab">General</gui> tab if more than one are available.
+   </p></item>
+   <item><p>
+   Click on the <gui style="tab">Image Settings</gui> tab and specify the position of the image either 
manually or by dragging it in the preview.
+   </p></item>
+   <item><p>
+   On the same tab optionally specify the height and width from the size section or leave them as default 
for best fit.
+   </p></item>
+   <item><p>
+   Select the <gui style="tab">Page Setup</gui> tab if a high quality paper is used. The corresponding 
settings for the paper size and orientation can be set here.
+   </p></item>
+   <item><p>
+   Click <gui style="button">Print</gui>.
+   </p></item>
+  </steps>
+ </section>
+</page>
diff --git a/help/C/removephotos.page b/help/C/removephotos.page
new file mode 100644
index 0000000..84853d9
--- /dev/null
+++ b/help/C/removephotos.page
@@ -0,0 +1,51 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="removephotos">
+
+  <info>
+    <link type="guide" xref="index#albums"/>
+   <credit type="author">
+    <name>Venkatesh Tahiliani</name>
+    <email>pulsar viki gmail com</email>
+   </credit>
+    <credit type="editor">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+    <desc> Remove photos already grouped in an album.</desc>
+  </info>
+
+  <title>Removing photos from an album</title>
+   <p>
+   Photos can be deleted from an album in the <gui style="tab">Albums</gui> tab,
+   alternatively we can delete photos present in one of the albums
+   from the <gui style="tab">Photos</gui> or <gui style="tab">Favourites</gui>
+   tab if we know the album name.
+   </p>
+ <section id="removephotos">
+  <title>To delete photos from an album:</title>
+   <steps>
+   <item>
+    <p>
+    Select the photos to be deleted using any one of the selection modes.
+    </p>
+   </item>
+   <item>
+    <p>
+    The lower secondary toolbar pops up, click on <key>Add to Album</key>.
+    </p>
+   </item>
+   <item>
+    <p>
+    A dialog box titled <gui>Organize</gui> appears, uncheck the check
+    box for the album from which the photo is to be deleted.
+    </p>
+   </item>
+   <item>
+    <p>
+    Click <key>Ok</key>
+    </p>
+   </item>
+   </steps>
+ </section>   
+</page>
diff --git a/help/C/selectionmode.page b/help/C/selectionmode.page
new file mode 100644
index 0000000..fa7a8fe
--- /dev/null
+++ b/help/C/selectionmode.page
@@ -0,0 +1,83 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="selectionmode">
+
+<info>
+  <link type="guide" xref="index#gettingstarted"/>
+   <link type="seealso" xref="viewingphoto"/>
+    <credit type="author">
+       <name>Venkatesh Tahiliani</name>
+       <email>pulsar viki gmail com</email>
+    </credit>
+    <credit type="editor">
+       <name>Aruna Sankaranarayanan</name>
+       <email>safincrazy gmail com</email>
+    </credit>
+    <license>
+       <p>Creative Commons Share Alike 3.0</p>
+    </license>
+
+  <desc> Select multiple photos at once.</desc>
+</info>
+
+<title>Using selection mode</title>
+
+<p>
+Selection mode is used to perform a selection on a set of photos or albums to perform a desired operation on 
the selected set. For instance, Opening a photo can be performed on a set of photos at once rather than 
manually opening every single one.
+</p>
+
+
+<section id="selectmodeon">
+ <title>To select multiple photos:</title>
+  <list>
+   <title>Multiple photos can be selected in anyone of the following ways:</title>
+    <item>
+       <p>
+       Click on the check mark icon labelled <gui style="button">Select Items
+       </gui>on the primary toolbar at the top right corner to go into selection
+        mode and click on the photos to be selected.
+       </p>
+    </item>
+    <item>
+     <p>
+     Hold the <key>Ctrl</key> key and click on the photos to be selected.
+     </p>
+    </item>
+    <item>
+     <p>
+     Click and drag to form a rubber-band selection
+     of the enclosing area containing the photos.
+     </p>
+    </item>
+    <item>
+     <p>
+     Right click on the photos to be selected.
+     </p>
+     </item>
+  </list>
+</section>
+<section id="selectmodeoff">
+ <title>To cancel selection mode:</title>
+  <list>
+   <title>One can cancel selection mode in either one of the following ways:</title>
+    <item>
+     <p>
+       Click on the <gui style="button">Cancel</gui> button which appears
+       on the primary toolbar in selection mode.
+     </p>
+    </item>
+    <item>
+     <p>
+       Press the <key>Esc</key> key.
+     </p>
+     </item>
+  </list>
+ </section>
+ <section>
+       <note style="tip">
+          <p>
+               In selection mode a new button replaces the existing ones on the primary                      
  toolbar which provides options to select all or deselect selected photos                        in one go, 
it also keeps the count of currently selected photos.
+          </p>
+       </note>
+ </section>
+</page>
diff --git a/help/C/setasbackground.page b/help/C/setasbackground.page
new file mode 100644
index 0000000..a227b53
--- /dev/null
+++ b/help/C/setasbackground.page
@@ -0,0 +1,30 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="imgasback">
+
+  <info>
+    <link type="guide" xref="index#preferences"/>
+
+<credit type="author">
+<name>Venkatesh Tahiliani</name>
+<email>pulsar viki gmail com</email>
+</credit>
+
+    <credit type="editor">
+      <name>Aruna Sankaranarayanan</name>
+      <email>safincrazy gmail com</email>
+    </credit>
+
+    <desc> Set an image as your wallpaper.</desc>
+  </info>
+
+  <title>Set an image as background</title>
+ <section id="setbackground">
+  <title>To set an image as background:</title>
+    <steps>
+     <item><p>Open the image</p></item>
+     <item><p>Click the gear icon on the right hand side of the primary toolbar.</p></item>
+     <item><p>Select <gui style="menuitem">Set as Background</gui>.</p></item>
+    </steps>
+ </section>
+</page>
diff --git a/help/C/setupfavourites.page b/help/C/setupfavourites.page
new file mode 100644
index 0000000..f1302f7
--- /dev/null
+++ b/help/C/setupfavourites.page
@@ -0,0 +1,55 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="favourites">
+
+  <info>
+    <link type="guide" xref="index#preferences"/>
+
+<credit type="author">
+ <name>Venkatesh Tahiliani</name>
+ <email>pulsar viki gmail com</email>
+</credit>
+  
+<credit type="editor">
+   <name>Aruna Sankaranarayanan</name>
+   <email>safincrazy gmail com</email>
+</credit>
+
+    <desc> Add photos and albums to favourites.</desc>
+  </info>
+
+  <title>Setting up favourites</title>
+ <p>
+ Photos or albums can be marked as favourites from the <gui style="tab">Photos</gui> tab or 
+<gui style="tab">Albums</gui> tab respectively. Every item marked as favourite appears in the 
+<gui style="tab">Favourites</gui> tab.
+ </p>
+ <section id="addfavs">
+  <title>To add to favourites:</title>
+   <p>
+   Select the photos or albums using any one of the selection modes and click the iconified favourite button 
on the left hand side of the secondary toolbar.
+   </p>
+   <p>
+   Photos can also be added to or removed from favourites by opening a photo and clicking the iconified 
favourite button on the lower right corner of the photo.
+   </p>
+ </section>
+ <section id="remfavs">
+ <title>To remove  to favourites:</title>
+ <steps>
+  <item><p>
+   Select the <gui style="tab">Favourites</gui> tab to view photos and albums marked as favourites. 
+  </p></item>
+  <item><p>
+   Select the items to be removed from favourites using any one of the selection modes.
+  </p></item>
+  <item><p>
+   Click the <gui style="button">Favourite</gui> button on the left hand side of the lower secondary toolbar.
+  </p></item>
+ </steps>
+  <note style="important">
+  <p>
+  The iconified favourite button is a switch which looks pushed down or enabled in case a photo is already 
marked as favourite.
+  </p>
+  </note>
+ </section>
+</page>
diff --git a/help/C/viewingphoto.page b/help/C/viewingphoto.page
new file mode 100644
index 0000000..54f62ab
--- /dev/null
+++ b/help/C/viewingphoto.page
@@ -0,0 +1,75 @@
+<page xmlns="http://projectmallard.org/1.0/";
+       type="topic" style="task"
+       id="viewingphoto">
+
+  <info>
+    <link type="guide" xref="index#gettingstarted"/>
+  <credit type="author">
+    <name>Venkatesh Tahiliani</name>
+    <email>pulsar viki gmail com</email>
+  </credit>
+   <credit type="editor">
+     <name>Aruna Sankaranarayanan</name>
+     <email>safincrazy gmail com</email>
+   </credit>
+
+    <desc> Open a photo for viewing.</desc>
+     <license>
+       <p>
+        Creative Commons Share Alike 3.0
+       </p>
+     </license>
+  </info>
+
+  <title>Opening a photo</title>
+
+    <p>
+       When <app>Photos</app> is opened the user is shown the <gui style="tab">Photos</gui> tab.
+       The <gui style="tab">Photos</gui> tab lists all the photos present in the pictures directory
+       in the from of a grid. We can choose to view a photo from the <gui style="tab">Photos</gui> tab,
+       the <gui style="tab">Albums</gui> tab or the <gui style="tab">Favourites</gui> tab.
+    </p>
+  <section id="viewfromphotos">
+   <title>
+       Viewing a photo from <gui style="tab">Photos</gui>
+       or <gui style="tab">Favourites</gui>.
+   </title>
+  <list>
+   <title>To open a photo:</title>
+    <item>
+     <p>
+        Select the Photos or Favourites tab click on the desired photo.
+    </p>
+   </item>
+   <item>
+    <p>
+       Navigate to the desired photo using the arrow keys or the
+       <keyseq><key>Ctrl</key><key>P</key></keyseq> to move up and
+       <keyseq><key>Ctrl</key><key>N</key></keyseq> to move down through
+       the photos grid and press <keyseq><key>Enter</key></keyseq>.
+    </p>
+   </item>
+  </list>
+  </section>
+
+   <section id="viewfromalbum">
+    <title>Viewing a photo from an album.</title>
+   <steps>
+     <item>
+      <p>
+       Select the <gui style="tab">Albums</gui> tab.
+      </p>
+     </item>
+     <item>
+     <p>
+       Navigate or click on the desired album.
+     </p>
+     </item>
+     <item>
+      <p>
+       Navigate or click on the desired photo from that album.
+      </p>
+     </item>
+    </steps>
+  </section>
+</page>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]