<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [

  <!ENTITY kappname "&rocs;">
  <!ENTITY package "kdeedu">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Swedish "INCLUDE"
> 
]>
<book lang="&language;">

<bookinfo>
<title
>Handbok &rocs;</title>
<authorgroup>
<author
><personname
> <firstname
>Tomaz</firstname
> <surname
>Canabrava</surname
> </personname
> <email
>tomaz.canabrava@gmail.com</email
> </author>
<othercredit role="translator"
> <firstname
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2009</year>
<holder
>Tomaz Canabrava</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2009-11-05</date>
<releaseinfo
>1.0</releaseinfo>

<abstract>
<para
>&rocs; är ett grafteoretisk visningsverktyg för KDE </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>matematik</keyword>
<keyword
>matematik</keyword>
<keyword
>grafer</keyword>
<keyword
>nod</keyword>
<keyword
>båge</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Inledning</title>
<para
>&rocs; syfte är att vara en integrerad utvecklingsmiljö för grafteori, för att hjälpa lärare att visa resultaten av en grafalgoritm, och också hjälpa elever att göra algoritmerna.</para>

<para
>&rocs; har en skriptmodul, skapad med Qt Script, som påverkar den ritade grafen, där varje ändring av grafen med skriptet avspeglas i den ritade grafen.</para>
</chapter>

<chapter id="using-rocs">
<title
>Använda &rocs;</title>
<para
>Användargränssnittet är uppdelat i två delar: </para
> 

<itemizedlist>
<listitem
><para
>Den övre högra delen där graferna ritas, och den nedre högra delen där algoritmer skapas. </para
></listitem>
<listitem
><para
>Den vänstra sidoraden är platsen där alla öppna grafer finns. Det går att öppna flera grafer per fil. </para
></listitem>
</itemizedlist>


<sect1 id="rocs-features">
<title
>&rocs; allmänna inställningar</title>
<para
>I den vänstra sidoraden finns alternativ för varje öppen graf. Alla dessa alternativ är allmänna per graf, och kan ändras per nod och båge med dialogrutorna Nodegenskaper och Bågegenskaper.</para>
<itemizedlist>
<listitem
><para>
<guilabel
>Grafnamn</guilabel>
</para
></listitem>
<listitem
><para
><guilabel
>Nodfärg</guilabel
> För nyskapade noder, kan nodfärgen för alla aktuella noder ändras genom att klicka på knappen <guilabel
>Alla</guilabel
>. </para
></listitem>
<listitem
><para>
<guilabel
>Bågfärg</guilabel>
</para
></listitem>
</itemizedlist>
<para
>Den sista raden alternativ består av alternativknappar:</para>
<itemizedlist>
<listitem
><para
><guilabel
>Visa namn för:</guilabel
> <guilabel
>Noder</guilabel
> eller <guilabel
>Bågar</guilabel
>. </para
></listitem>
<listitem
><para
><guilabel
>Visa värden för:</guilabel
> <guilabel
>Noder</guilabel
> eller <guilabel
>Bågar</guilabel
>. </para
></listitem>
<!--listitem
><para>
<guilabel
>Graph is oriented</guilabel>
</para
></listitem>
<listitem
><para>
<guilabel
>Graph is Automate</guilabel>
</para
></listitem-->
</itemizedlist>
</sect1>

<sect1 id="rocs-toolbars">
<title
>&rocs; verktygsrader</title>
<para
>Det finns två verktygsrader längst upp. Huvudverktygsraden har följande verktyg:</para>
<itemizedlist>
<listitem
><para
><guilabel
>Flytta nod</guilabel
>: Flyttar omkring en not runt i ritområdet.</para
></listitem>
<listitem
><para
><guilabel
>Lägg till nod</guilabel
>: Skapar en ny nod på den position som klickas i ritområdet.</para
></listitem>
<listitem
><para
><guilabel
>Lägg till båge</guilabel
>: Skapar en ny båge mellan två noder.</para
></listitem>
<listitem
><para
><guilabel
>Markera</guilabel
>: Markera objekt genom att klicka på dem.</para
></listitem>
<listitem
><para
><guilabel
>Ta bort</guilabel
>: Ta bort objekt genom att klicka på dem.</para
></listitem>
<listitem
><para
>Använd justeringsverktygen för att placera markerade noder.</para
></listitem>
</itemizedlist>

<para
>Ett klick på en nod eller båge med höger musknapp visar egenskapsdialogrutan för den noden eller bågen.</para>
<para
>Layoutverktygsraden består av diverse justeringsikoner.</para>

<para
>För att justera noder, välj verktyget <guiicon
>Markera</guiicon
>, klicka och dra en rektangel, och välj därefter justeringen du vill använda. </para>
</sect1>
</chapter>

<chapter id="scripting-rocs">
<title
>Använda skript i &rocs;</title>
<para
>Efter grafen visas på skärmen, kan du börja skapa dess skript. Språket använder Javascript-syntax och följande objekt används för grafer, noder och bågar.</para>

<sect1 id="script-graph">
<title
>Graf</title>
<programlisting
>     array list_nodes();
     array list_edges();
     node add_node(name);
     edge add_edge(from, to);
     node node_byname(QString&amp; name);
     node begin_node();
     array end_nodes();
</programlisting
> 
<para
>Grafvariabler som kan ändras:</para>
<programlisting
>     bool directed
     bool automate
     string name
     string nodeDefaultColor  // hexadecimal
     string edgeDefaultColor  // hexadecimal 
</programlisting>
</sect1>

<sect1 id="script-nodes">
<title
>Noder</title>
<programlisting
>     array adj_nodes();
     array adj_edges();
     array  input_edges();
     array output_edges();
     array loop_edges();
     array connected_edges(Node *n);
     void self_remove();
</programlisting
> 
<para
>Nodvariabler</para>
<programlisting
>    double x
    double y
    double width
    string value
    string name
    string color  // hexadecimal
    bool begin
    bool end
</programlisting>
</sect1>

<sect1 id="script-edges">
<title
>Bågar</title>
<programlisting
>    string color ( em hexa )
    string value
    string name
    double width
    string style ( dot, dash, dash dot, solid )

    node start();
    node  end();

    void self_remove();
</programlisting
> 
</sect1>

<sect1 id="script-example">
<title
>Exempel</title>
<para
>Här är ett enkelt exempel på ett skript som ställer in färgen på de fyra första noderna i den första grafen:</para>
<programlisting
>/* Ett enkelt exempel som ställer in färgen på de fyra första noderna 
i den första grafen: */
 
var colours = new Array("red", "green", "blue", "yellow");

/* graphs är ett fält av grafer, du kan komma åt en graf med dess index i
fältet eller med dess namn, så om den första grafens namn är Untitled0,
är följande sats riktig */
var list1 = graphs[0].list_nodes(); // 1:a formen
var list2 = Untitled0.list_nodes(); // 2.a formen
 
 for ( var i = 0; i &lt; colours.length; i++){
        if (i &gt; list2.length) break;
        list2[i].color = colours[i]
 }
</programlisting>
</sect1>

</chapter>

<chapter id="commands">
<title
>Kommandoreferens</title>

<sect1 id="rocs-mainwindow">
<title
>Menyer och snabbtangenter</title>

<sect2>
<title
>Menyn <guimenu
>Arkiv</guimenu
></title>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Arkiv</guimenu
> <guimenuitem
>Avsluta</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Avslutar</action
> &rocs;</para
></listitem>
</varlistentry>
</variablelist>

</sect2>


<sect2>
<title
>Menyn <guimenu
>Inställningar</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guisubmenu
>Visade verktygsrader</guisubmenu
> </menuchoice
></term>
<listitem
><para
><action
>Visa eller dölj</action
> verktygsraderna <guimenuitem
>Huvudverktygsrad</guimenuitem
> och <guimenuitem
>Layoutverktygsrad</guimenuitem
>.</para
></listitem>
</varlistentry>


<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Visa statusrad</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visa eller dölj</action
> statusraden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa genvägar...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Öppnar</action
> den vanliga inställningsdialogrutan i &kde; som låter dig välja olika snabbtangenter för olika åtgärder. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa verktygsrader...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Anpassa</action
> objekt som du vill placera i verktygsraden. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title
>Menyn <guimenu
>Hjälp</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>


<chapter id="credits">

<title
>Tack till och licens</title>

<para
>&rocs; </para>
<para
>Program copyright 2009 Tomaz Canabrava tcanabrava snabela kde punkt org </para>

<para
>Dokumentation copyright 2009 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; och Tomaz Canabrava tcanabrava snabela kde punkt org </para>

<para
>Översättning Stefan Asserhäll <email
>stefan.asserhall@comhem.se</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="getting-rocs">
<title
>Hur man skaffar &rocs;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Kompilering och installation</title>
&install.compile.documentation; </sect1>
</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->