This file is indexed.

/usr/share/doc/kde/HTML/en/stage/guides.docbook is in calligrastage 1:2.4.0-0ubuntu2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<chapter id="guides">
<chapterinfo>
<authorgroup>
<author>
<firstname>Neil</firstname>
<surname>Lucock</surname>
<affiliation>
<address><email>neil@nlucock.freeserve.co.uk</email></address>
</affiliation>
</author>
<author>
<firstname>Krishna</firstname>
<surname>Tateneni</surname>
<affiliation>
<address><email>tateneni@pluto.njcc.com</email></address>
</affiliation>
</author>
<author>
<firstname>Brad</firstname>
<surname>Hards</surname>
<affiliation>
<address><email>bradh@frogmouth.net</email></address>
</affiliation>
</author>
<author>
<firstname>Danny</firstname>
<surname>Allen</surname>
<affiliation>
<address><email>danny@dannyallen.co.uk</email></address>
</affiliation>
</author>
<author>
<firstname>Anne-Marie</firstname>
<surname>Mahfouf</surname>
<affiliation>
<address><email>annemarie.mahfouf@free.fr</email></address>
</affiliation>
</author>

<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</chapterinfo>
<title>Detailed Guides</title>

<para>This chapter describes how to perform some common tasks in
&stage;.</para>

<sect1 id="html-wizard">
<title>Create a &HTML; Slideshow</title>

<para>Turn an existing presentation into standard &HTML;
pages with accompanying navigation aids.</para>

<para>First, either make a new presentation, or open an existing one. Then,
click on <menuchoice><guimenu>File</guimenu><guimenuitem>Export as 
  HTML...</guimenuitem></menuchoice></para>
<para>You will then get a dialog box asking for a few details:</para>

<screenshot>
<screeninfo>Fill in the details for your &HTML;
slideshow</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="htmlshow3.png" format="PNG"/>
</imageobject>
<textobject><phrase>Fill in the details for your &HTML;
slideshow</phrase></textobject>
</mediaobject>
</screenshot>

<para>Fill in <guilabel>Title</guilabel> and <guilabel>Author</guilabel> fields. 
Select the slides which should be exported. If you want to change a name 
used on the &HTML; page for each slide double click on the name and edit it 
inline.</para>

<para>In the <guilabel>Output preview</guilabel> 
area the downsized slides are displayed and you can check the correct slide order 
and browse the presentation with the <guiicon>&lt;</guiicon> and <guiicon>&gt;</guiicon> buttons.
</para>

<para>Now you can select a stylesheet with the configuration of the &HTML; options.</para>

<para>To actually produce your &HTML; presentation, press the <guibutton>Export</guibutton> 
button and select a folder.</para>

<para>What we now have are the newly-produced <filename>html/</filename>
and <filename>pics/</filename> folders,
created where we earlier set the path:</para>

<screenshot>
<screeninfo>The newly created &HTML; slideshow
folders</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="htmlshow9.png" format="PNG"/>
</imageobject>
<textobject><phrase>The newly created &HTML; slideshow
folders</phrase></textobject>
</mediaobject>
</screenshot>

<para>There is also an <filename>index.html</filename> file to launch
your web slideshow.</para>

<para>You can see how it works by using your file manager or web
browser to open the <filename>index.html</filename> file. Click where prompted,
and the first slide of your presentation is displayed. It will now behave as a
&stage; slideshow.</para>

<para>Each click on the arrow icons take you to the next or previous slide. 
To get back to the start of the slideshow click on the slide icon.</para>

<tip><para>To share your presentation with the world, transfer the
newly-produced files to a network-accessible location (&ie; webspace),
remembering to keep the folder structure intact.</para></tip>
</sect1>

<sect1 id="creating-templates">
<title>Creating &stage; Templates</title>

<para>It is very easy to create a new template for &stage;.</para>

<para>If you have made a presentation in a style that you would like to use
again, you can save it as a template.</para>

<para>This tutorial will show how we can make a new template and save
it.</para>

<para>Open &stage; and create a new document.</para>

<para>To add a little sparkle to the blank slide, we can change the slide
background - do this by selecting the <guilabel>Background editing tool</guilabel> 
in the Tools docker.</para>

<para>We want the background to look attractive, so you may choose to use an image as a
background by clicking the <guibutton>Select background image</guibutton> button: feel free to
experiment, but keep it beautiful!</para>

<screenshot>
<screeninfo>Choosing a slide background</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="template03.png"/>
</imageobject>
<textobject><phrase>Choosing a slide background</phrase></textobject>
</mediaobject>
</screenshot>

<para>The page should now have the background you desire. Create a text box, and
type a heading for your slide:</para>

<screenshot>
<screeninfo>Adding a Heading to the new template</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="template04.png" format="PNG"/>
</imageobject>
<textobject><phrase>Adding a Heading to the new template</phrase></textobject>
</mediaobject>
</screenshot>

<para>When you are happy with your template, go to <menuchoice><guimenu>File</guimenu>
<guimenuitem>Save As</guimenuitem></menuchoice> and select <guilabel>Opendocument 
Presentation Template</guilabel> filetype in the file dialog.</para>

</sect1>

</chapter>