<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
  <!ENTITY dhfirstname "<firstname>Javier</firstname>">
  <!ENTITY dhsurname   "<surname>Fernandez-Sanguino</surname>">
  <!-- Please adjust the date whenever revising the manpage. -->
  <!ENTITY dhdate      "<date>May 29th, 2012</date>">
  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
  <!ENTITY dhemail     "<email>jfs@debian.org</email>">
  <!ENTITY dhusername  "Javier Fernandez-Sanguino">
  <!ENTITY dhucpackage "<refentrytitle>storymaps</refentrytitle>">
  <!ENTITY dhpackage   "storymaps">
  <!ENTITY dhcmd       "storymaps">

  <!ENTITY debian      "<productname>Debian</productname>">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
]>

<refentry>
  <refentryinfo>
    <address>
      &dhemail;
    </address>
    <author>
      &dhfirstname;
      &dhsurname;
    </author>
    <copyright>
      <year>2012</year>
      <holder>&dhusername;</holder>
    </copyright>
    &dhdate;
  </refentryinfo>
  <refmeta>
    &dhucpackage;

    &dhsection;
  </refmeta>
  <refnamediv>
    <refname>&dhcmd;</refname>

    <refpurpose>free story planning and writing application for children</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&dhcmd;</command>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

    <para>This manual page documents briefly the
      <command>&dhcmd;</command> command.</para>

    <para>This manual page was written for the &debian; distribution
      because the original program does not have a manual page.</para>

    <para><command>&dhcmd;</command> is 
    a free story planning and writing application for children that works
    in many different operating systems. It was written by Sean Hammond
    as part of his PhD. The author and worked with teachers, children, creative
    writing experts and an illustrator to design and evaluate it. 
    </para>

    <para>StoryMaps breaks down the elements of traditional fairy tales into
    building blocks which children can use to invent new stories. With
    StoryMaps children can create stories that contain their own original ideas
    while being structurally complete and well-formed. The goal of the program
    is that StoryMaps will give children a powerful mental model for
    understanding stories and their construction. School trials of StoryMaps
    found that through using the application children were able to grasp
    abstract narrative concepts and apply them to their own writing, and that
    the experience improved the narrative structure of children's
    stories.</para>

  </refsect1>
  <refsect1>
    <title>USAGE</title>

   <para>When the program starts, the <emphasis>Planning View</emphasis> is
   shown.  In this view, the user os presented with a collection of story cards
   to choose from in the green area at the top. You can inspect each card more
   closely by moving the mouse cursor over a card to see it in more detail. You
   drag-and-drop the story cards that you want to use and arrange them into a
   story map in the grey area below. You can enter a title for your story in
   the toolbar at the bottom of the window.</para>

   <para>The story cards are based on plot functions from Vladimir Propp's
   study of traditional Russian fairy tales, Morphology of the Folktale. They
   were illustrated by designer and illustrator Raymond Yuen.
   </para>

   <para>Move the mouse pointer over a story card to see it in more detail, and
   open the story editor to see even more detail about the story cards.</para>

   <para>Clicking on the <emphasis>Write your Story!</emphasis> button brings
   up the story editor. With your story map in view above, you use the text
   editor below to enter the text for your story. You have to fill in a part of
   your story for each story card in your story map. If you change your mind
   about one of the cards in your story map, you can go back to the planning
   view at any time by clicking the <emphasis>Go back to planning</emphasis>
   button.</para>

   <para>You can save your story map to file and open a saved story map to
   continue working on it later.  When you've finished writing you can preview
   your story and export it to HTML, or print it.</para>

   <para>StoryMaps automatically saves your story as you work on it. You'll
   find automatically saved stories in the StoryMaps folder in your home
   directory (on Linux) or in your My Documents folder (on Windows). You can
   open automatically saved stories using the Open a Saved Story button in the
   File menu in the StoryMaps window.</para>

  </refsect1>
  <refsect1>
    <title>SEE ALSO</title>

    <para>This program is documented fully in the <citetitle>Storymaps web page
    </citetitle>, avilable at http://seanh.sdfeu.org/storymaps/.</para>

    <para>You can read more about StoryMaps, the ideas behind it and how it was
    developed and evaluated with teachers and children in these
    publications:</para>

    <itemizedlist>
    
        <listitem>
        <para>Children's Story Authoring with Propp's Morphology, Sean Hammond,
        PhD thesis, The University of Edinburgh 2010</para>

        </listitem>

        <listitem>
        
        <para>Children's Story Authoring with Propp's Morphology: An
        Exploratory Study, Sean Hammond, Tim J. Smith and Helen Pain, 5th
        International Conference on Narrative and Interactive Learning
        Environments, Edinburgh, 6th-8th August 2008</para>

        </listitem>

        <listitem>

        <para>Player Agency in Interactive Narrative: Audience, Actor & Author,
        Sean Hammond, Helen Pain and Tim J. Smith, Artificial and Ambient
        Intelligence, AISB Annual Convention, 2-4 April 2007, Culture Lab
        Newcastle University</para>

        </listitem>

    </itemizedlist>

  </refsect1>
  <refsect1>
    <title>AUTHOR</title>

    <para>Storymaps is Copyright: (c) 2007-2012 Sean Hammond 
        <email>seanhammond@seanh.cc</email>. 
    </para>

    <para>The images for the story cards have been done by Ray Yuen 
     <email>hello@rayuen.com</email>. You can find more information about him
     in his website at http://rayuen.com
    </para>


    <para>This manual page was written by &dhusername; &dhemail; for
      the &debian; system (but may be used by others).
    </para>
    
    <para>For full licensing and copyright details
      please see <filename>/usr/share/doc/storymaps/copyright</filename>.
    </para>

  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->


