Debian Codegraph @

po/ca@valencia/docs/desktoptojson/man-desktoptojson.8.docbook

raw
1 <?xml version="1.0" ?>
2 <!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
3 <!ENTITY % Catalan-Valencian "INCLUDE"
4 ><!-- change language only here -->
5 ]>
6
7 <refentry lang="&language;">
8
9 <refentryinfo>
10 <title
11 >&kde-frameworks;: KService</title>
12 <author
13 ><firstname
14 >Scarlett</firstname
15 > <surname
16 >Clark</surname
17 > <contrib
18 >Va escriure la documentació original.</contrib>
19 <affiliation>
20 <address
21 ><email
22 >[email protected]</email
23 ></address>
24 </affiliation>
25 </author>
26 <author
27 ><firstname
28 >Alex</firstname
29 > <surname
30 >Merry</surname
31 > <contrib
32 >Ha editat la documentació.</contrib>
33 <affiliation>
34 <address
35 ><email
36 >[email protected]</email
37 ></address>
38 </affiliation>
39 </author>
40
41 <date
42 >2 d'abril de 2014</date>
43 <releaseinfo
44 >Frameworks 5.0</releaseinfo>
45 <productname
46 >Frameworks de KDE</productname>
47
48 </refentryinfo>
49
50
51 <refmeta>
52 <refentrytitle
53 ><command
54 >desktoptojson</command
55 ></refentrytitle>
56 <manvolnum
57 >8</manvolnum>
58 </refmeta>
59
60 <refnamediv>
61 <refname
62 ><command
63 >desktoptojson</command
64 ></refname>
65 <refpurpose
66 >Convertix un fitxer <filename class="extension"
67 >.desktop</filename
68 > a un fitxer <filename class="extension"
69 >.json</filename
70 >.</refpurpose>
71 </refnamediv>
72
73 <refsynopsisdiv>
74 <title
75 >Sinopsi</title>
76
77 <cmdsynopsis
78 ><command
79 >desktoptojson</command
80 > <arg choice="plain"
81 >--input <replaceable
82 >FITXER_DESKTOP</replaceable
83 ></arg
84 > <arg choice="plain"
85 >--output <replaceable
86 >FITXER_JSON</replaceable
87 ></arg
88 > </cmdsynopsis>
89 <cmdsynopsis
90 ><command
91 >desktoptojson</command
92 > <group choice="req"
93 > <arg choice="plain"
94 >--version</arg
95 > <arg choice="plain"
96 >--help</arg
97 > </group
98 > </cmdsynopsis>
99
100 </refsynopsisdiv>
101
102
103
104
105 <refsect1>
106 <title
107 >Descripció</title>
108
109 <para
110 >L'entorn de treball KService utilitza la informació continguda en els fitxers <filename class="extension"
111 >.desktop</filename
112 > per a localitzar els serveis, inclosos els connectors per a les aplicacions i biblioteques basades en les &Qt; 5. De tota manera, el sistema de connectors de les &Qt; 5, utilitza les dades &JSON; incrustades en el mateix connector. <command
113 >desktoptojson</command
114 > permet que la informació continguda en un fitxer <filename class="extension"
115 >.desktop</filename
116 > també es puga utilitzar com a dades incrustades en un connector de les Qt 5, convertint les entrades a dins del fitxer <filename class="extension"
117 >.desktop</filename
118 > en dades &JSON;.</para>
119
120 <para
121 >Les dades &JSON; generades són un objecte &JSON; que mapa les entrades des del grup <literal
122 >[Desktop Entry]</literal
123 > del fitxer <filename class="extension"
124 >.desktop</filename
125 >. Qualssevol altre grup serà ignorat. La majoria de les entrades són senzillament convertides a cadenes &JSON;, però certes entrades (com <literal
126 >Hidden</literal
127 > i <literal
128 >X-KDE-PluginInfo-EnabledByDefault</literal
129 >) són conegudes per ser valors booleans i per tant es convertixen, i algunes similars (com <literal
130 >X-KDE-ServiceTypes</literal
131 > i <literal
132 >X-KDE-PluginInfo-Depends</literal
133 >) sempre es convertixen a matrius de cadenes.</para>
134 </refsect1>
135
136
137
138 <refsect1>
139 <title
140 >Opcions</title>
141 <variablelist>
142
143 <varlistentry>
144 <term
145 ><option
146 >--input <replaceable
147 >FITXER_DESKTOP</replaceable
148 ></option
149 ></term>
150 <listitem>
151 <para
152 >El fitxer <filename class="extension"
153 >.desktop</filename
154 > a convertir.</para>
155 </listitem>
156 </varlistentry>
157
158 <varlistentry>
159 <term
160 ><option
161 >--output <replaceable
162 >FITXER_JSON</replaceable
163 ></option
164 ></term>
165 <listitem>
166 <para
167 >El fitxer on escriure les dades &JSON; generades.</para>
168 </listitem>
169 </varlistentry>
170
171 <varlistentry>
172 <term
173 ><option
174 >--help</option
175 ></term>
176 <listitem>
177 <para
178 >Mostra un text breu d'ajuda.</para>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry>
183 <term
184 ><option
185 >--version</option
186 ></term>
187 <listitem>
188 <para
189 >Mostra la informació sobre la versió.</para>
190 </listitem>
191 </varlistentry>
192
193 </variablelist>
194 </refsect1>
195
196
197
198 <refsect1>
199 <title
200 >Ús</title>
201 <para
202 >La majoria dels usuaris d'esta eina podran utilitzar la macro de &cmake; <function
203 >kservice_desktop_to_json</function
204 > com a part del procés de construcció d'un connector. <programlisting language="cmake">
205 <![CDATA[
206 add_library(myplugin MODULE ${myplugin_SRCS})
207 kservice_desktop_to_json(myplugin myplugin.desktop)
208 ]]>
209 </programlisting
210 > Açò presentarà el fitxer &JSON; <filename
211 >myplugin.json</filename
212 >, al qual es pot fer referència des de les macros <function
213 >K_PLUGIN_FACTORY_WITH_JSON</function
214 > o <function
215 >Q_PLUGIN_METADATA</function
216 >. </para>
217 </refsect1>
218
219
220
221 <refsect1>
222 <title
223 >Errors</title>
224 <para
225 >Utilitzeu el <ulink url="https://bugs.kde.org"
226 >Seguidor d'errors de &kde;</ulink
227 > (escriviu-hi en anglés) per a informar dels errors.</para>
228 </refsect1>
229
230 </refentry>
231
232
233