This file is indexed.

/usr/share/doc/kde/HTML/gl/kstars/dumpmode.docbook is in kde-l10n-gl 4:4.8.2-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
<chapter id="dumpmode">
<title
>Modo da liña de comandos para a xeración de imaxes</title>
<indexterm
><primary
>Modo de emborcado de imaxes</primary
></indexterm>

<para
>Pódese empregar o &kstars; para xerar unha imaxe do ceo sen realmente lanzar a parte <acronym
>GUI</acronym
> do programa. Para utilizar esta funcionalidade hai que iniciar o &kstars; desde unha liña de comandos empregando argumentos para especificar o nome do ficheiro da imaxe, así como as dimensións que se desexan para a imaxe: <cmdsynopsis
><command
>kstars</command
> <arg choice="plain"
>--dump</arg
> <arg
>--filename <replaceable
>kstars.png</replaceable
></arg
> <arg
>--height <replaceable
>640</replaceable
></arg
> <arg
>--width <replaceable
>480</replaceable
></arg
> <arg
>--script <replaceable
>omeuscript.kstars</replaceable
></arg
> <arg
>--date <replaceable
>"4 de xullo de 1976 12:30:00"</replaceable
></arg
> </cmdsynopsis>
</para>
<para
>Se non se especifica un nome de ficheiro xérase un ficheiro chamado <filename
>kstars.png</filename
>. Tentarase xerar unha imaxe que corresponda coa extensión do nome do ficheiro. Recoñécense as extensións seguintes: <quote
>png</quote
>, <quote
>jpg</quote
>, <quote
>jpeg</quote
>, <quote
>gif</quote
>, <quote
>pnm</quote
> e <quote
>bmp</quote
>. Se non se recoñece a extensión do nome do ficheiro, por omisión será o tipo de imaxe <quote
>PNG</quote
>. </para>
<para
>Igualmente, se non se especifican a anchura e a altura, por omisión serán 640 e 480, respectivamente. </para>
<para
>Por omisión, o &kstars; le os valores das opcións almacenadas no ficheiro <filename
>$KDEHOME/share/config/kstarsrc</filename
> para determinar onde se centrará a imaxe e como se presentará. Isto significa que hai que executar o &kstars; no modo GUI normal e sair do programa cando estea configurado coas opcións desexadas para as imaxes xeradas. Isto non é moi flexíbel, polo que tamén fornecemos a posibilidade de executar un script <acronym
>DCOP</acronym
> do &kstars; para preparar a escena antes de xerar a imaxe. O nome de ficheiro que se especifique como argumento do script ha de ser un script <acronym
>DCOP</acronym
> válido do &kstars;, como os que se crean coa <link linkend="tool-scriptbuilder"
>Ferramenta Construtor de scripts</link
>. Algunhas das funcións de <acronym
>DCOP</acronym
> non teñen sentido nun modo distinto da GUI (como, por exemplo, <function
>waitForKey()</function
>; se se atopan estas funcións cando se examina o guión, simplemente ignóranse. </para>
<para
>Por omisión, o &kstars; utilizará a hora e a data da CPU do sistema para xerar a imaxe. Como alternativa, pódense especificar unha hora e data co argumento <quote
>--date</quote
>. Tamén se pode empregar este argumento para especificar a data de arranque no modo GUI normal. </para>

</chapter>