Toolbox/ca: Difference between revisions

From KDE UserBase Wiki
(Created page with "===Aplicacions de la comunitat===")
(Created page with "Els enllaços externs es donen com a URL i un text separats per un espai i delimitats per claudàtors simples com a {{Input|1=<nowiki>[https://ca.wikipedia.org/wiki/KDE pàgina de la viquipèdia del KDE]</nowiki>}} el qual proporciona la [https://ca.wikipedia.org/wiki/KDE pàgina de la viquipèdia del KDE].")
 
(196 intermediate revisions by 3 users not shown)
Line 2: Line 2:
{{Info/ca|Aquesta pàgina ofereix exemples de codi amb format per a tasques comunes.}}
{{Info/ca|Aquesta pàgina ofereix exemples de codi amb format per a tasques comunes.}}


<span id="Add_an_Introductory_Screenshot_and_Description"></span>
==Afegir una captura de pantalla i una descripció com a introducció==  
==Afegir una captura de pantalla i una descripció com a introducció==  


Line 11: Line 12:
|}</nowiki>}}
|}</nowiki>}}


<span id="Format_Your_Text"></span>
==Donar format al text==  
==Donar format al text==  


<span id="Use_Headings"></span>
===Usar títols===  
===Usar títols===  


Els títols formaran part automàticament de la taula de continguts, de manera que s'han d'estructurar. El seu lloc en l'arbre es regeix per diversos caràcters «=» a cada extrem del títol. Eviteu l'ús de només un: Doncs denota un títol de la pàgina i automàticament la pàgina utilitzarà aquest títol. Els títols principals utilitzen «==el text va aquí==», el següent nivell, «===més text=== i així successivament.
Cada títol va en la seva pròpia línia d'inici i final amb dos o més caràcters «=». Una vegada hi hagi un grapat de títols en una pàgina es crearà automàticament una taula de continguts, de manera que els utilitzem. El nombre de caràcters «=» determina el seu nivell en la taula de continguts, per això els títols haurien de ser «==Nom de la secció principal==», «===Nom de la subsecció===», «====Nom de la subsecció inferior====», i així successivament. Eviteu l'ús d'un sol «=», ja que denota un títol de pàgina i cada pàgina del wiki ja compta amb un. Per exemple, el títol d'aquesta pàgina «{{PAGENAME}}» apareix com al seu títol de pàgina.


<span id="Use_bold_and_italic"></span>
===Usar '''negreta''' i ''cursiva''===  
===Usar '''negreta''' i ''cursiva''===  


Line 23: Line 27:
Utilitzeu <nowiki>'''text en negreta'''</nowiki> per a especificar '''text en negreta''' i <nowiki>''text en cursiva''</nowiki> per a especificar ''text en cursiva''.
Utilitzeu <nowiki>'''text en negreta'''</nowiki> per a especificar '''text en negreta''' i <nowiki>''text en cursiva''</nowiki> per a especificar ''text en cursiva''.


Per tal de garantir que s'obtenen traduccions fàcils i precises, si us plau, adheriu-vos a les ''[[Typographical_Guidelines|directrius tipogràfiques]]''.
Per tal de garantir que s'obtenen traduccions fàcils i precises, si us plau, adheriu-vos a les ''[[Special:myLanguage/Typographical_Guidelines|directrius tipogràfiques]]''.


<span id="Add_a_Code_Snippet"></span>
===Afegir un fragment de codi===  
===Afegir un fragment de codi===  


Tenim plantilles per ajudar en la correcta visualització de fragments de codi. Exemples d'ús en diverses situacions es troben disponibles en [[Typographical_Guidelines|la pàgina directrius tipogràfiques]].
Tenim plantilles per ajudar en la correcta visualització de fragments de codi. Exemples d'ús en diverses situacions es troben disponibles en [[Special:myLanguage/Typographical_Guidelines|la pàgina directrius tipogràfiques]].


Si teniu problemes per a visualitzar els caràcters de canonada en el vostre fragment de codi, si us plau, vegeu l'explicació i marques detallades en [[Typographical_Guidelines|Directrius tipogràfiques]].
Si teniu problemes per a visualitzar els caràcters de canonada en el vostre fragment de codi, si us plau, vegeu l'explicació i marques detallades en [[Special:myLanguage/Typographical_Guidelines|Directrius tipogràfiques]].


<span id="Add_Indents"></span>
===Afegir sagnat===  
===Afegir sagnat===  


:El caràcter «''':'''» s'utilitza per a un sagnat, i s'utilitza múltiples vegades en algunes pàgines antigues. Això és obsolet, i causa alguns problemes, de manera que s'eliminaran a mesura que es trobin. Un únic «''':'''» sagna amb quatre caràcters.
:El caràcter «''':'''» s'utilitza per a un sagnat, i s'utilitza múltiples vegades en algunes pàgines antigues. Això és obsolet, i causa alguns problemes, de manera que s'eliminaran a mesura que es trobin. Un únic «''':'''» sagna amb quatre caràcters.


<span id="Format_Dates"></span>
===Format a les dates===
===Format a les dates===


Les dates en un format purament numèric causa confusió, a causa de les diferències en el que s'espera a les zones geogràfiques. Si us plau, doneu format a les dates com {{Input|1=<nowiki>18 Mar 2011</nowiki>}} amb el mes ja s'escrigui sencer o en forma abreujada, i l'any en format de 4 dígits. El dia pot ser d'un o dos dígits.<span id="Bulleted Lists"></span>
Les dates en un format purament numèric causa confusió, a causa de les diferències en el que s'espera a les zones geogràfiques. Si us plau, doneu format a les dates com {{Input|1=<nowiki>18 Mar 2011</nowiki>}} amb el mes ja s'escrigui sencer o en forma abreujada, i l'any en format de 4 dígits. El dia pot ser d'un o dos dígits.<span id="Bulleted Lists"></span>
<span id="Bulleted_Lists"></span>
===Llistes amb vinyetes===  
===Llistes amb vinyetes===  


Line 59: Line 67:
* Panses
* Panses


<span id="Enumerations"></span>
=== Enumeracions ===  
=== Enumeracions ===  


Line 77: Line 86:
# Al forn
# Al forn


Per a més detalls, veure en les llistes de [http://meta.wikimedia.org/wiki/Help:List wikimedia].
<span id="Combining_Bulleted_Lists_and_Enumerations"></span>
=== Combinació de llistes amb vinyetes i enumeracions ===
=== Combinació de llistes amb vinyetes i enumeracions ===


Line 111: Line 123:
# Altres coses
# Altres coses


{{Note|1=Enumerations should never have blank lines in them: it breaks the sequence and numbering starts at one again. Similarly, there should never be blank lines before a sublist item whether enumerated or bulleted: it creates two levels of item markings (bullets or numbers)}}
{{Note/ca|1=Les enumeracions mai haurien de tenir línies en blanc entre elles: Es trenca la seqüència i numeració començant de nou. De la mateixa manera, mai hauria d'haver-hi línies en blanc abans d'un element de subllista en l'enumeració o les vinyetes: Es creen dos nivells de marques d'element (números o vinyetes).}}
 
{{Note/ca|1=Si us plau, recordeu que les llistes llargues són un problema pels traductors. Amb llistes amb vinyetes d'un únic nivell, posiciona el punt en una secció pròpia, és a dir, crea una línia en blanc entre les vinyetes. Amb dos nivells de punts els subelements s'han de mantenir en la mateixa secció que el punt d'alt nivell; Si heu d'utilitzar subpunts, si us plau, manteniu les subllistes curtes! Amb enumeracions involucrades, heu de mantenir-ho tot en una sola unitat. Si us plau, mireu d'evitar les enumeracions, i si trobeu que s'han de fer servir mireu de mantenir-les curtes.}}
 
{{Remember/ca|2=Solució|1=Tot i que és important per evitar les línies en blanc en les enumeracions i llistes amb vinyetes encara és possible dividir les llistes d'aquest tipus en diverses unitats de traducció. Això és altament recomanable!}}
 
Per obtenir cada vinyeta i subvinyeta en la seva pròpia unitat de traducció podeu introduir quelcom com això:
 
{{Input|1=<nowiki>* Primera vinyeta&lt;/translate&gt;
&lt;translate&gt;
** Primera subvinyeta&lt;/translate&gt;
&lt;translate&gt;
** Una altra subvinyeta<br /><br />Aquesta consisteix en dos paràgrafs&lt;/translate&gt;
&lt;translate&gt;
* La següent vinyeta principal&lt;/translate&gt;
&lt;translate&gt;
** I així successivament</nowiki>}}
 
Es mostra així:


{{Note|1=Please remember, that long lists are a problem for translators. With single level bulleted lists, place each bullet in a section of its own, i.e. make a blank line between bullets. With two levels of bullets the subitems must be kept in the same section as their top level bullet; if you have to use subbullets, please keep the sublists short! With enumerations involved, you must keep everything in one unit. Please try to avoid enumerations, and if you find that you must use them try to keep them short.}}
* Primera vinyeta
** Primera subvinyeta
** Una altra subvinyeta<br /><br />Aquesta consisteix en dos paràgrafs
* La següent vinyeta principal
** I així successivament


=== Itemizations ===
El mateix mètode s'aplicarà als altres tipus de llistes.


Itemizations are produced using ''';''' and ''':''' alternatively.  They are best for giving short descriptions for a group of related objects.
Si d'altra banda necessiteu tenir més seccions en el mateix article, podeu fer quelcom com això per a tenir cada secció en una unitat de traducció pròpia:


{{Input|1=<nowiki>
{{Input|1=<nowiki>* Primera vinyeta&lt;/translate&gt;
&lt;translate&gt;
* Segona vinyeta, primera secció.&lt;/translate&gt;<br /><br />&lt;translate&gt;Segona secció de la segona vinyeta. Aquesta secció té una unitat de traducció pròpia&lt;/translate&gt;
&lt;translate&gt;
* I així successivament</nowiki>}}
 
Es mostrarà així:
 
* Primera vinyeta
* Segona vinyeta, primera secció.<br /><br />Segona secció de la segona vinyeta. Aquesta secció té una unitat de traducció pròpia
* I així successivament
 
<span id="Itemizations"></span>
===Subdividir en elements===
 
El subdividir en elements es produeix utilitzant ''';''' i ''':''' alternativament. És el millor per donar una breu descripció d'un grup d'objectes relacionats.
 
{{<!--}}-->Input|1=<nowiki>
;Animals
;Animals
: They move around and devour other creatures.
: Es mouen i devoren altres criatures.


;Plants
;Plantes
: They have roots and feed upon ground water and sun.
: Tenen arrels i s'alimenten d'aigües subterrànies i del sol.
</nowiki>}}
</nowiki><!--{{-->}}
produces
produeix


;Animals
;Animals
: They move around and devour other creatures.
: Es mouen i devoren altres criatures.


;Plants
;Plantes
: They have roots and feed upon ground water and sun.
: Tenen arrels i s'alimenten d'aigües subterrànies i del sol.


{{Note|1=As allways, please keep each item in a section of its own; it helps translators a lot.}}
{{Note/ca|1=Com sempre, si us plau, manteniu cada element en una secció pròpia, això ajuda un munt als traductors.}}


<span id="Add_a_Link"></span>
===Afegir un enllaç===  
===Afegir un enllaç===  


There are two kinds of links to learn, internal ones, to another userbase page, and external URL links.
Hi ha tres tipus d'enllaços per aprendre, dos de caràcter intern, a una altra pàgina o a una secció en una pàgina de userbase, i els enllaços URL externs.


For an internal link the format <nowiki>[[PageLayout]]</nowiki>, where you want to display the name of the page, does work, but it is not ideal, particularly for translation to docbook and for localisation. It is better to use the form <nowiki>[[Special:myLanguage/PageLayout|Page Layout]]</nowiki>, because that allows translators to link correctly even though the page name is localised. The result is that it directs to the correctly translated page, if one exists. You often need to include the link in a sentence, so in that case you would use
Per un enllaç intern el format <nowiki>[[PageLayout]]</nowiki>, en el que voleu mostrar el nom de la pàgina, funciona, però no és ideal, especialment per a la traducció a docbook i per a la localització. És millor utilitzar la forma <nowiki>[[Special:myLanguage/PageLayout|Page Layout]]</nowiki>, ja que permet als traductors vincular correctament encara que es tradueixi el nom de la pàgina. El resultat és que s'anirà directament ​​a la pàgina traduïda, si és que existeix. Sovint és necessari incloure l'enllaç en una oració, de manera que en aquest cas haureu d'utilitzar


{{Input|1=<nowiki>[[Special:myLanguage/PageLayout|this page]]</nowiki>}} which displays
{{Input|1=<nowiki>[[Special:myLanguage/PageLayout|aquesta pàgina]]</nowiki>}} mostrarà
[[Special:myLanguage/PageLayout|this page]]
[[Special:myLanguage/PageLayout|aquesta pàgina]]


External links are slightly different so
Els enllaços interns cap a les subseccions d'una pàgina utilitzen el caràcter '#' (hash) i haurien de tenir aquest aspecte {{Input|1=<nowiki>[[Special:myLanguage/Tasks_and_Tools#Working_with_Languages|...]]</nowiki>}}Amb aquest tipus d'enllaç és molt important, que la pàgina que enllaça declari l'àncora de referència. Si l'àncora conté caràcters d'espai, substituïu-los pel caràcter '_' (guió baix) quan crideu a la referència. Si es troba la referència, el vostre navegador mostrarà automàticament la secció (si gestiona els ancoratges). Si no és el cas, haureu de passar per la pàgina fins trobar la secció referenciada.


{{Input|1=<nowiki>[http://techbase.kde.org/Schedules our road map]</nowiki>}} displays
Els enllaços externs es donen com a URL i un text separats per un espai i delimitats per claudàtors simples com a {{Input|1=<nowiki>[https://ca.wikipedia.org/wiki/KDE pàgina de la viquipèdia del KDE]</nowiki>}} el qual proporciona la [https://ca.wikipedia.org/wiki/KDE pàgina de la viquipèdia del KDE].
[http://techbase.kde.org/Schedules our road map], which would take you straight to the techbase page.


One last thing to note - when you preview your page, all links are live.  This gives you two benefits. You can check (by hovering) that your links are set up as you expected, and you can use a red link to create a new page.
<span id="Anchor_declaration"></span>
=== Declarar un ancoratge ===


La declaració de l'àncora s'ha de fer immediatament ABANS de la secció referenciada i seguida d'una línia en blanc que separi l'àncora i la seva capçalera. En l'exemple següent, només cal copiar el valor ID i el títol de la secció associada. Hauria de ser així:
{{Input|1=<nowiki>&lt;/translate&gt;<span id="Working with Languages"></span> &lt;translate&gt;</nowiki>}}
Si la pàgina que conté la secció que enllaceu encara no està marcada per a la traducció, s'han d'ometre les etiquetes <nowiki>&lt;/translate&gt; i &lt;translate&gt;</nowiki>.
Els enllaços externs són una mica diferents
{{Input|1=<nowiki>[http://techbase.kde.org/Schedules el nostre full de ruta]</nowiki>}} mostrarà [http://techbase.kde.org/Schedules el nostre full de ruta], el que us porta directament a la pàgina de techbase.
Una última cosa a fer nota: Una vista prèvia de la pàgina, tots els enllaços són actius. Això us dóna dos beneficis. Podeu comprovar (situant-vos a sobre amb el punter del ratolí) que els enllaços s'estableixen com s'esperava, i podeu utilitzar un enllaç de color vermell per crear una nova pàgina.
<span id="Make_an_application_list"></span>
=== Fer una llista d'aplicacions ===
Si voleu crear una llista d'[[Special:myLanguage/Applications|aplicacions]], haureu d'utilitzar la plantilla <code>AppItem</code>. Simplement introduïu
{{Input|1=<nowiki>{|
{{AppItem|System Settings/Locale|Preferences-desktop-locale.png|
Arranjament per a la gestió local de nombres, dates, etc.}}Un text curt.
Unes poques línies curtes més sobre l'aplicació. Això és opcional.
|-
{{AppItem|System Settings/Shortcuts and Gestures|Preferences-desktop-keyboard.png|
Dreceres i gestos}}Un altre text curt. Si no premeu <keycap>Retorn</keycap> entre el text
obtindreu una secció, no importa l'allargada del text.
|}</nowiki>}}
Això resulta en el següent:
{|
{{AppItem|System Settings/Locale|Preferences-desktop-locale.png|
Arranjament per a la gestió local de nombres, dates, etc.}}Un text curt.
Unes poques línies curtes més sobre l'aplicació. Això és opcional.
|-
{{AppItem|System Settings/Shortcuts and Gestures|Preferences-desktop-keyboard.png|
Dreceres i gestos}}Un altre text curt. Si no premeu <keycap>Retorn</keycap> entre el text
obtindreu una secció, no importa l'allargada del text.
|}
Tingueu en compte, que no s'ha de anteposar «Special:myLanguage» al nom de la pàgina -la plantilla s'encarrega d'això-. Tingueu també en compte, que heu de donar un títol, encara que el títol sigui el mateix que el nom de la pàgina.
<span id="Footnotes"></span>
=== Notes al peu ===
Les notes al peu s'utilitzen poques vegades a les nostres pàgines, però si les necessiteu podeu col·locar un <code><nowiki><ref></nowiki>''text''<nowiki></ref></nowiki></code> en la font on ha d'aparèixer la marca «footnote». No ha de ser una <code><nowiki><referència /></nowiki></code> en algun lloc de la font, normalment anirà al final de la pàgina. Aquí és on apareixerà el text afegit per les etiquetes <nowiki><ref></nowiki>. Per a més informació veure la [http://en.wikipedia.org/wiki/Help:Footnotes pàgina de la Viquipèdia].
<span id="Illustrate_Your_Text"></span>
==Il·lustrar el text==  
==Il·lustrar el text==  


<span id="Add_a_single_image,_centered"></span>
===Afegir una única imatge, centrada===  
===Afegir una única imatge, centrada===  


{{Input|1=<nowiki>[[Image:KMail-kde4.png|250px|center]]</nowiki>}}
{{Input|1=<nowiki>[[File:KMail-kde4.png|250px|center]]</nowiki>}}


Note that you can change the position of the image, but the default is left. The size of the image depends on the circumstances, but for screenshots I recommend no less than 250px and no more than 500px.
Tingueu en compte que es pot canviar la posició de la imatge, però el valor per omissió és l'esquerra. La mida de la imatge dependrà de les circumstàncies, però per les captures de pantalla recomano no menys de 250 píxels i no més de 500 píxels.


===Make the Image Clickable, and Add a Caption===
Tingueu també en compte que <code>Image:</code> i <code>File:</code> són sinònims.
De manera que <code><nowiki>[[Image:KMail-kde4.png]]</nowiki></code> és el mateix que <code><nowiki>[[File:KMail-kde4.png]]</nowiki></code>. De tota manera <code>Image:</code> està desaconsellat, en el contingut nou preferim <code>File:</code>.


Where you need to show more detail, create a moderately sized image, clickable, so that the full-size can be seen. Simply add the parameter '|thumb' within the image parentheses.
Per a més informació, veure [http://www.mediawiki.org/wiki/Help:Images mediawiki].


A caption can also be added as a parameter, but will only show if '|thumb' is present.
<span id="Make_the_Image_Clickable_and_Add_a_Caption"></span>
===Fer la imatge clicable i afegir un títol===


===Utilitzar taules per a col·locar amb precisió diverses imatges===  
Quan necessiteu mostrar més detalls, creeu una imatge de grandària moderada, on es pugui fer clic, de manera que es pugui veure tota. N'hi ha prou amb el paràmetre «|thumb» dins dels parèntesis de la imatge.
 
També es pot afegir un títol com a paràmetre, però només es mostrarà si «|thumb» és present.
 
Exemple:
 
{{Input|1=<nowiki>[[File:file_name.png|thumb|aquest serà el títol]]</nowiki>}}
 
<span id="Add_a_caption_without_a_thumbnail"></span>
=== Afegir un títol sense una miniatura ===
 
Els títols també apareixen en les imatges marcades amb la sintaxi del marc.
 
Exemple:
 
{{Input|1=<nowiki>[[File:image.png|frame|left|aquest serà el títol]]
</nowiki>}}
 
<span id="Prevent_text_from_flowing_around_image"></span>
===Prevenir que el text flueixi al voltant de la imatge===
 
A vegades és possible que no vulgueu que el text flueixi pels costats de la imatge. Això es pot evitar afegint una etiqueta <code><nowiki> <br clear=all> </nowiki></code> entre l'etiqueta «File:» i el text en qüestió.
 
Exemple:
{{Input|1=<nowiki>[[File:image.png]]
<br clear=all>
Aquest text normalment fluix pels costats de la imatge, però ara es trobarà sota de la imatge.
</nowiki>}}
 
<span id="Use_Tables_to_Precisely_Place_Multiple_Images"></span>
===Utilitzar taules per a col·locar amb precisió múltiples imatges===  


{{Input|1=<nowiki>{|class="tablecenter" style="border: 1px solid grey;"
{{Input|1=<nowiki>{|class="tablecenter" style="border: 1px solid grey;"
Line 174: Line 305:
|}</nowiki>}}
|}</nowiki>}}


displays
mostrarà


{|class="tablecenter" style="border: 1px solid grey;"
{|class="tablecenter" style="border: 1px solid grey;"
Line 184: Line 315:




Note that all the parameters for one image are contained within <nowiki>[[...]]</nowiki>, and cells are separated by '||'. To start a new line, insert '|-' on an otherwise-empty line, then '|' at the start of the next one.
Tingueu en compte que tots els paràmetres d'una imatge es troben dins de <nowiki>[[...]]</nowiki>, i les cel·les estan separades per «||». Per iniciar una nova línia, introduïu «|-» en una línia d'altra manera buida i després «|» al començament de la següent.
 
Per més detalls sobre el format de la Taula veure el [http://www.mediawiki.org/wiki/Help:Tables mediawiki].
<span id="Embed a Video"></span>
<span id="Embed_a_Video"></span>
=== Incrustar un vídeo ===
 
A partir de juliol de 2012, l'extensió [http://www.mediawiki.org/wiki/Extension:EmbedVideo EmbedVideo] del MediaWiki ha estat instal·lada a «userbase.kde». Això vol dir que podeu incrustar vídeos des de diversos llocs d'allotjament de vídeo en el contingut de la pàgina i fer que es mostrin en línia.
 
La funció analitzadora de «EmbedVideo» espera ser cridada en qualsevol de les següents maneres:


<nowiki> {{#ev:servei|id}} </nowiki> <br />
<nowiki> {{#ev:servei|id|amplada}}</nowiki><br />
<nowiki> {{#ev:servei|id|amplada|alineació}}</nowiki><br />
<nowiki> {{#ev:servei|id|amplada|alineació|descripció}}</nowiki><br />
<nowiki> {{#evp:servei|id|descripció}}</nowiki><br />
<nowiki> {{#evp:servei|id|descripció|alineació}}</nowiki><br />
<nowiki> {{#evp:servei|id|descripció|alineació|amplada}}</nowiki><br />
On: <br />
«servei» és el nom d'un servei de compartiment de vídeo (veure «nom servei» en la llista a sota).
«id» és l'identificador del vídeo a incloure.
«amplada» (opcional) és l'amplada en píxels de l'àrea de visió (l'alçada es determinarà de forma automàtica).
«alineació» (opcional) és un atribut d'alineació (float). Pot ser «left» (esquerra) o «right» (dreta).
«descripció» (opcional) és una breu descripció per mostrar sota del vídeo quan està alineat.
Per exemple, per incloure el famós vídeo «evolution of dance» de YouTube, cal que introduïu:
<pre>{{#ev:youtube|dMH0bHeiRNg}}</pre>
I si el voleu reduir a mida de miniatura, a la dreta amb una breu descripció, podeu utilitzar:
<pre>{{#ev:youtube|dMH0bHeiRNg|100|right|Aquest és un vídeo incrustat!}}</pre>
A partir de la versió 1.0, «EmbedVideo» admet incrustar contingut de vídeo des dels següents serveis:
{| class="wikitable"
|-
! Lloc
! Nom del servei
|-
! [http://www.dailymotion.com/ Dailymotion]
| <tt>dailymotion</tt>
|-
! Div Share
| <tt>divshare</tt>
|-
! [http://edutopia.org Edutopia]
| <tt>edutopia</tt>
|-
! [http://www.funnyordie.com/ FunnyOrDie]
| <tt>funnyordie</tt>
|-
! [http://video.google.com/ Google Video]
| <tt>googlevideo</tt>
|-
! [http://interia.pl/ Interia]
| <tt>interia</tt> or <tt>interiavideo</tt>
|-
! [http://revver.com/ Revver]
| <tt>revver</tt>
|-
! [http://sevenload.com/ sevenload]
| <tt>sevenload</tt>
|-
! [http://teachertube.org TeacherTube]
| <tt>teachertube</tt>
|-
! [http://www.youtube.com/ YouTube]
| <tt>youtube</tt> and <tt>youtubehd</tt>
|-
! [http://www.vimeo.com Vimeo]
| <tt>vimeo</tt>
|}
<span id="Add Notes and Warnings"></span>
<span id="Add_Notes_and_Warnings"></span>
==Afegir notes i avisos==  
==Afegir notes i avisos==  


Where a note or warning is relevant within your text, use these templates:
{{Warning/ca|2=Important|1=Les caixes de sagnat no es mostren correctament! Mai col·loqueu dos punts al davant d'un quadre, sinó fareu que el quadre prengui un aspecte molt estrany.}}


<nowiki>{{Info|This is general information}}</nowiki> displays
Quan una nota o avís és pertinent dins del text, useu aquestes plantilles:
{{Info|This is general information}}


<nowiki>{{Note|Some important information at this point}}</nowiki> displays
<nowiki>{{Info|Aquesta és informació general.}}</nowiki> mostrarà
{{Note|Some important information at this point}}
{{Info|Aquesta és informació general.}}


<nowiki>{{Tip|A helpful piece of advice, something to remember}}</nowiki>displays
<nowiki>{{Note|Alguna informació important en aquest moment.}}</nowiki> mostrarà
{{Tip|A helpful piece of advice, something to remember}}
{{Note|Alguna informació important en aquest moment.}}


<nowiki>{{Warning|Take care - this is a dangerous thing to do}}</nowiki> displays
<nowiki>{{Tip|Un consell útil, alguna cosa a recordar.}}</nowiki> mostrarà
{{Warning|Take care - this is a dangerous thing to do}}
{{Tip|Un consell útil, alguna cosa a recordar.}}


Where the strongest possible warning is needed, the Remember box can be used, but please use sparingly.
<nowiki>{{Warning|Aneu amb compte: És una cosa perillosa de fer.}}</nowiki> mostrarà
<nowiki>{{Remember|1=This is for things that definitely must not be forgotten}}</nowiki>
{{Warning|Aneu amb compte: És una cosa perillosa de fer.}}
{{Remember|1=This is for things that definitely must not be forgotten}}


You can also change the heading:
Quan l'avís sigui necessari ser el més fort possible, podeu usar el quadre Recordeu però, si us plau, utilitzeu-lo amb moderació.
<nowiki>{{Remember|1=Per a les coses que definitivament no s'han d'oblidar.}}</nowiki>
{{Remember|1=Per a les coses que definitivament no s'han d'oblidar.}}


{{Remember|3=Don't Forget This!|1=You can use parameter number 3 to set an individual box heading:
També podeu canviar el títol:
{{Input|1=<nowiki>{{Remember|3=Don't Forget This!|1=You can use...}}</nowiki>}}}}


{{Remember/ca|2=No oblideu això!|1=Podeu utilitzar el número de paràmetre 2 per establir un quadre de títol:
{{Input|1=<nowiki>{{Remember|2=No oblideu això!|1=Podeu usar...}}</nowiki>}}}}
==Redirecció de la pàgina==
Podeu crear una pàgina per a redirigir automàticament cap a una altra mitjançant:
<pre>#REDIRECT [[Pagename]]</pre>
<span id="KDE3_and_KDE_SC_4_Versions_of_Applications"></span>
==Les versions KDE3 i KDE SC 4 de les aplicacions==  
==Les versions KDE3 i KDE SC 4 de les aplicacions==  


By default, KDE SC 4 is assumed. If the KDE SC 4 version is not yet ready for release, or where only a KDE 3 version exists, it may be necessary to document the KDE3 version. In this case you should add an icon  <nowiki>{{KDE3}}</nowiki>
Per omissió, s'assumeix KDE SC 4. Si la versió del KDE SC 4 encara no està llesta pel llançament, o quan només hi ha una versió de KDE 3, pot ser necessari documentar la versió del KDE3. En aquest cas, haureu d'afegir la plantilla {{tl|KDE3}} que mostrarà {{KDE3/tla}}. Si considereu escriure sobre les versions de KDE3 i de KDE SC 4 a la mateixa pàgina, utilitzeu les icones d'ambdós:{{tl|KDE4}} que mostrarà {{KDE4}}.
which displays {{KDE3}}
Should you be writing about a KDE3 version and KDE SC 4 version on the same page, use icons for both - <nowiki>{{KDE4}}</nowiki> which displays {{KDE4}}


<span id="Other_Useful_Templates"></span>
==Altres plantilles d'utilitat==  
==Altres plantilles d'utilitat==  
 
<span id="Inserting GUI Icons"></span>
<span id="Inserting_GUI_Icons"></span>
===Inserció d'icones de la IGU===
===Inserció d'icones de la IGU===


The best way to refer to icons in the GUI is to display it in the text. This can be done with a template like this: <code><nowiki>{{Icon|list-add}}</nowiki></code>. This will display the {{Icon|list-add}} icon.
La millor manera de referir-se a les icones de la interfície gràfica d'usuari és que aparegui en el text. Això es pot fer amb una plantilla com aquesta: <code><nowiki>{{Icon|list-add}}</nowiki></code>. Això mostrarà la icona {{Icon|list-add}}.


For this to work, the icon image must have been uploaded to the wiki. See [[Special:myLanguage/Update_an_Image|Update an Image]] for an explanation on how to upload images. The .png files can usually be found here: <tt>usr/share/icons/oxygen</tt>. If possible use the 16x16 icon. The file name should have an <tt>Icon-</tt> prefix as in <tt>Icon-list-add.png</tt> &mdash; apart from the prefix the filename should exactly match the usual name. Note, that when using the template you should neither write the <tt>Icon-</tt> prefix nor the <tt>.png</tt> file type extension.
Per què això funcioni, la imatge d'icona s'ha de pujar al wiki. Veure [[Special:myLanguage/Update_an_Image|Actualitzar una imatge]] per a una explicació sobre la forma de pujar-les. Els fitxers PNG es poden trobar aquí: <tt>usr/share/icons/oxygen</tt>. Si és possible useu la icona de 16x16. El nom del fitxer ha de tenir un prefix <tt>Icon</tt>, com en <tt>Icon-list-add.png</tt>: a part del prefix el nom del fitxer ha de coincidir exactament amb el nom comú. Tingueu en compte que quan s'utilitza la plantilla haureu d'escriure el prefix <tt>Icon</tt> no l'extensió <tt>.png</tt> del tipus de fitxer.


The {{Plus}} icon can also be written as <code><nowiki>{{Plus}}</nowiki></code>, and the {{Minus}} icon as <code><nowiki>{{Minus}}</nowiki></code>. You can also use <code><nowiki>{{Configure}}</nowiki></code> to get the {{Configure}} icon, and <code><nowiki>{{Exit}}</nowiki></code> gets you the {{Exit}} icon.
La icona {{Plus}} també es pot escriure com <nowiki><code>{{Plus}}</code></nowiki>, i la icona {{Minus}} com <nowiki><code>{{Minus}}</code></nowiki>. També podeu utilitzar <nowiki><code>{{Configure}}</code></nowiki> per obtenir la icona {{Configure}}, i amb <nowiki><code>{{Exit}}</code></nowiki> obtindreu la icona {{Exit}}.


<span id="Community_Applications"></span>
===Aplicacions de la comunitat===  
===Aplicacions de la comunitat===  


The final consideration concerns those applications which are not distributed as core KDE applications. These need to be indicated by an icon, placing <nowiki>{{Community-app}}</nowiki>
L'última consideració es refereix a les aplicacions que no es distribueixen com a base de les aplicacions KDE. Aquestes s'han d'indicar amb una icona com <nowiki>{{Comunitat-app}}</nowiki>.


{{Community-app}}
{{Community-app/ca}}


at the end of your sentence or line, just as you would to denote a footnote in general writing. You then need to add <nowiki>{{Community-app-footnote}}</nowiki> which will create a footnote, like this:
Al final de la vostra sentència o de la línia, simplement per referir-vos a un peu de pàgina en l'escrit en general. A continuació necessitareu afegir <nowiki>{{Community-app-footnote}}</nowiki> el qual crearà un peu de pàgina, com:


{{Community-app-footnote}}
{{Community-app-footnote/ca}}


<span id="Making_Major_Edits_to_Existing_Pages"></span>
===Fer edicions importants a les pàgines existents===  
===Fer edicions importants a les pàgines existents===  


If a page is likely to be open for editing for some time there is a danger of conflicts - someone else may edit at the same time, and saving your edit will cancel out theirs, or vice versa. The way to avoid that is to make a temporary entry, directly under the language bar, using <nowiki>{{Being_Edited}}</nowiki> which will display
Si una pàgina és oberta per a l'edició des de fa algun temps hi ha perill de conflictes: Algú pot editar-la alhora, i el desar-la cancel·larà els vostres canvis, o viceversa. La forma d'evitar-ho és creant una entrada temporal, directament sota la barra d'idiomes, utilitzant <nowiki>{{Being_Edited}}</nowiki> que mostrarà


{{Being_Edited}}
{{Being_Edited/ca}}


''Don't forget to remove it when you have finished!''
''No oblideu manllevar-la una vagada finalitzada!''


<span id="Adding_a_New_Complex_Page"></span>
===Afegir una nova pàgina complexa===  
===Afegir una nova pàgina complexa===  


If you need to be able to work on a page for quite some time, over several days, for instance, you may like to use the Construction template - <nowiki>{{Construction}}</nowiki>, which displays
Si necessiteu poder treballar en una pàgina durant força temps, diversos dies, per exemple, potser voldreu utilitzar la plantilla de construcció: <nowiki>{{Construction}}</nowiki>, que mostrarà


{{Construction}}
{{Construction/ca}}


<span id="Links_to_Pages_in_the_Neighbourhood"></span>
===Enllaços a pàgines veïnes===  
===Enllaços a pàgines veïnes===  


You can add links to a preceding or a following page using the following templates as described here:
Podeu afegir enllaços a una pàgina anterior o següent amb les plantilles que s'exposen aquí:
{{Input|1=<nowiki>{{Prevnext|Previous Pagename|Following Pagename|The page before this page|This page you should read later}}</nowiki>}}
{{Input|1=<nowiki>{{Prevnext2|prevpage=Previous Pagename|nextpage=Following Pagename|prevtext=La pàgina abans d'aquesta pàgina|nexttext=Aquesta pàgina s'hauria de llegir després|index=Index page|indextext=El menú Enrere}}</nowiki>}}
{{Prevnext|Previous Pagename|Following Pagename|The page before this page|This page you should read later}}
{{Prevnext2|prevpage=Previous Pagename|nextpage=Following Pagename|prevtext=La pàgina abans d'aquesta pàgina|nexttext=Aquesta pàgina s'hauria de llegir després|index=Index page|indextext=El menú Enrere}}
 
Els sis arguments són opcionals. Per a les primeres pàgines, sense pàgina anterior o les últimes pàgines, sense pàgines següent, utilitzeu això:
{{Input|1=<nowiki>{{Prevnext2|nextpage=Following Pagename|nexttext=Aquesta pàgina s'hauria de llegir després}}</nowiki>}}
{{Prevnext2|nextpage=Following Pagename|nexttext=Aquesta pàgina s'hauria de llegir després}}
{{Input|1=<nowiki>{{Prevnext2|prevpage=Previous Pagename|prevtext=La pàgina abans d'aquesta pàgina}}</nowiki>}}
{{Prevnext2|prevpage=Previous Pagename|prevtext=La pàgina abans d'aquesta pàgina}}
Si no s'especifica un <code>indexname</code> es mostrarà el nom de la pàgina actual.
 
{{Note/ca|1=Sempre haureu d'especificar un text per les pàgines que enllacen, i sempre s'haurà d'utilitzar <code>Special:myLanguage</code> amb els vostres enllaços, en cas contrari creareu problemes als traductors.}}
 
<span id="Links_to_bugs"></span>
=== Enllaços a errors ===
 
Podeu enllaçar directament amb un error al Bugzilla utilitzant aquesta plantilla:
 
<code><nowiki>{{Bug|123456}}</nowiki></code>


For first pages with no preceeding page or last pages with no following page use this:
Si us plau, no oblideu afegir <code><nowiki><s> i </s></nowiki></code> quan es tanqui un error.
{{Input|1=<nowiki>{{Next|Following Pagename|This page you should read later}}</nowiki>}}
{{Next|Following Pagename|This page you should read later}}
{{Input|1=<nowiki>{{Prev|Previous Pagename|The page before this page}}</nowiki>}}
{{Prev|Previous Pagename|The page before this page}}


<span id="Adding_a_List_of_Sub-Pages"></span>
==Afegir una llista de subpàgines==  
==Afegir una llista de subpàgines==  


{{Input|1=<nowiki>== Subpàgines de {{FULLPAGENAME}} ==
{{Input|1=<nowiki>== Subpàgines de {{FULLPAGENAME}} ==
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}</nowiki><!--}}-->
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}</nowiki>}}


És molt útil quan es desitja llistar subpàgines amb enllaços actius, com ara  
És molt útil quan es desitja llistar subpàgines amb enllaços actius, com ara  


<span id="Subpages_of_{{FULLPAGENAME}}"></span>
=== Subpàgines de {{FULLPAGENAME}}===  
=== Subpàgines de {{FULLPAGENAME}}===  


Line 280: Line 508:




[[Category:Contributing]]
[[Category:Col·laboració/ca]]

Latest revision as of 08:30, 10 August 2023

Other languages:

Informació

Aquesta pàgina ofereix exemples de codi amb format per a tasques comunes.


Afegir una captura de pantalla i una descripció com a introducció

Sempre que sigui possible comenceu una pàgina de nivell superior per a l'aplicació amb això. El codi per aconseguir-ho és: 

{|class="tablecenter vertical-centered"
|[[Image:La_vostra_captura.png|250px|thumb]]
|El text descriptiu
|}

Donar format al text

Usar títols

Cada títol va en la seva pròpia línia d'inici i final amb dos o més caràcters «=». Una vegada hi hagi un grapat de títols en una pàgina es crearà automàticament una taula de continguts, de manera que els utilitzem. El nombre de caràcters «=» determina el seu nivell en la taula de continguts, per això els títols haurien de ser «==Nom de la secció principal==», «===Nom de la subsecció===», «====Nom de la subsecció inferior====», i així successivament. Eviteu l'ús d'un sol «=», ja que denota un títol de pàgina i cada pàgina del wiki ja compta amb un. Per exemple, el títol d'aquesta pàgina «Toolbox/ca» apareix com al seu títol de pàgina.

Usar negreta i cursiva

Els caràcters d'apòstrof s'utilitzen per especificar les paraules en negreta i cursiva.

Utilitzeu '''text en negreta''' per a especificar text en negreta i ''text en cursiva'' per a especificar text en cursiva.

Per tal de garantir que s'obtenen traduccions fàcils i precises, si us plau, adheriu-vos a les directrius tipogràfiques.

Afegir un fragment de codi

Tenim plantilles per ajudar en la correcta visualització de fragments de codi. Exemples d'ús en diverses situacions es troben disponibles en la pàgina directrius tipogràfiques.

Si teniu problemes per a visualitzar els caràcters de canonada en el vostre fragment de codi, si us plau, vegeu l'explicació i marques detallades en Directrius tipogràfiques.

Afegir sagnat

El caràcter «:» s'utilitza per a un sagnat, i s'utilitza múltiples vegades en algunes pàgines antigues. Això és obsolet, i causa alguns problemes, de manera que s'eliminaran a mesura que es trobin. Un únic «:» sagna amb quatre caràcters.

Format a les dates

Les dates en un format purament numèric causa confusió, a causa de les diferències en el que s'espera a les zones geogràfiques. Si us plau, doneu format a les dates com 

18 Mar 2011

amb el mes ja s'escrigui sencer o en forma abreujada, i l'any en format de 4 dígits. El dia pot ser d'un o dos dígits.

Llistes amb vinyetes

* Aquest és el símbol que s'utilitzarà per a les llistes amb vinyetes. ** Dóna un segon nivell:

* Ametlles

* Nous
** Castanyes

* Panses

produeix

  • Ametlles
  • Nous
    • Castanyes
  • Panses

Enumeracions

Les enumeracions es produeixen de la mateixa manera, amb el caràcter «#». 

# Tamisar
# Mesclar
## Remoure bé
# Al forn

produeix

  1. Tamisar
  2. Mesclar
    1. Remoure bé
  3. Al forn

Per a més detalls, veure en les llistes de wikimedia.

Combinació de llistes amb vinyetes i enumeracions

Podeu tenir una subllista enumerada en una llista amb vinyetes i viceversa, d'aquesta manera: 

* Nous
*# Castanyes
*# Sucre
* Altres coses

produeix

  • Nous
    1. Castanyes
    2. Sucre
  • Altres coses

mentre que 

# Nous
#* Castanyes
#* Sucre
# Altres coses

produeix

  1. Nous
    • Castanyes
    • Sucre
  2. Altres coses

Nota

Les enumeracions mai haurien de tenir línies en blanc entre elles: Es trenca la seqüència i numeració començant de nou. De la mateixa manera, mai hauria d'haver-hi línies en blanc abans d'un element de subllista en l'enumeració o les vinyetes: Es creen dos nivells de marques d'element (números o vinyetes).


Nota

Si us plau, recordeu que les llistes llargues són un problema pels traductors. Amb llistes amb vinyetes d'un únic nivell, posiciona el punt en una secció pròpia, és a dir, crea una línia en blanc entre les vinyetes. Amb dos nivells de punts els subelements s'han de mantenir en la mateixa secció que el punt d'alt nivell; Si heu d'utilitzar subpunts, si us plau, manteniu les subllistes curtes! Amb enumeracions involucrades, heu de mantenir-ho tot en una sola unitat. Si us plau, mireu d'evitar les enumeracions, i si trobeu que s'han de fer servir mireu de mantenir-les curtes.


Solució

Tot i que és important per evitar les línies en blanc en les enumeracions i llistes amb vinyetes encara és possible dividir les llistes d'aquest tipus en diverses unitats de traducció. Això és altament recomanable!


Per obtenir cada vinyeta i subvinyeta en la seva pròpia unitat de traducció podeu introduir quelcom com això: 

* Primera vinyeta</translate>
<translate>
** Primera subvinyeta</translate>
<translate>
** Una altra subvinyeta<br /><br />Aquesta consisteix en dos paràgrafs</translate>
<translate>
* La següent vinyeta principal</translate>
<translate>
** I així successivament

Es mostra així:

  • Primera vinyeta
    • Primera subvinyeta
    • Una altra subvinyeta

      Aquesta consisteix en dos paràgrafs
  • La següent vinyeta principal
    • I així successivament

El mateix mètode s'aplicarà als altres tipus de llistes.

Si d'altra banda necessiteu tenir més seccions en el mateix article, podeu fer quelcom com això per a tenir cada secció en una unitat de traducció pròpia: 

* Primera vinyeta</translate>
<translate>
* Segona vinyeta, primera secció.</translate><br /><br /><translate>Segona secció de la segona vinyeta. Aquesta secció té una unitat de traducció pròpia</translate>
<translate>
* I així successivament

Es mostrarà així:

  • Primera vinyeta
  • Segona vinyeta, primera secció.

    Segona secció de la segona vinyeta. Aquesta secció té una unitat de traducció pròpia
  • I així successivament

Subdividir en elements

El subdividir en elements es produeix utilitzant ; i : alternativament. És el millor per donar una breu descripció d'un grup d'objectes relacionats. 

;Animals
: Es mouen i devoren altres criatures.

;Plantes
: Tenen arrels i s'alimenten d'aigües subterrànies i del sol.

produeix

Animals
Es mouen i devoren altres criatures.
Plantes
Tenen arrels i s'alimenten d'aigües subterrànies i del sol.

Nota

Com sempre, si us plau, manteniu cada element en una secció pròpia, això ajuda un munt als traductors.


Afegir un enllaç

Hi ha tres tipus d'enllaços per aprendre, dos de caràcter intern, a una altra pàgina o a una secció en una pàgina de userbase, i els enllaços URL externs.

Per un enllaç intern el format [[PageLayout]], en el que voleu mostrar el nom de la pàgina, funciona, però no és ideal, especialment per a la traducció a docbook i per a la localització. És millor utilitzar la forma [[Special:myLanguage/PageLayout|Page Layout]], ja que permet als traductors vincular correctament encara que es tradueixi el nom de la pàgina. El resultat és que s'anirà directament ​​a la pàgina traduïda, si és que existeix. Sovint és necessari incloure l'enllaç en una oració, de manera que en aquest cas haureu d'utilitzar 

[[Special:myLanguage/PageLayout|aquesta pàgina]]

mostrarà

aquesta pàgina

Els enllaços interns cap a les subseccions d'una pàgina utilitzen el caràcter '#' (hash) i haurien de tenir aquest aspecte 

[[Special:myLanguage/Tasks_and_Tools#Working_with_Languages|...]]

Amb aquest tipus d'enllaç és molt important, que la pàgina que enllaça declari l'àncora de referència. Si l'àncora conté caràcters d'espai, substituïu-los pel caràcter '_' (guió baix) quan crideu a la referència. Si es troba la referència, el vostre navegador mostrarà automàticament la secció (si gestiona els ancoratges). Si no és el cas, haureu de passar per la pàgina fins trobar la secció referenciada. Els enllaços externs es donen com a URL i un text separats per un espai i delimitats per claudàtors simples com a 

[https://ca.wikipedia.org/wiki/KDE pàgina de la viquipèdia del KDE]

el qual proporciona la pàgina de la viquipèdia del KDE.

Declarar un ancoratge

La declaració de l'àncora s'ha de fer immediatament ABANS de la secció referenciada i seguida d'una línia en blanc que separi l'àncora i la seva capçalera. En l'exemple següent, només cal copiar el valor ID i el títol de la secció associada. Hauria de ser així: 

</translate><span id="Working with Languages"></span> <translate>

Si la pàgina que conté la secció que enllaceu encara no està marcada per a la traducció, s'han d'ometre les etiquetes </translate> i <translate>.

Els enllaços externs són una mica diferents 

[http://techbase.kde.org/Schedules el nostre full de ruta]

mostrarà el nostre full de ruta, el que us porta directament a la pàgina de techbase.

Una última cosa a fer nota: Una vista prèvia de la pàgina, tots els enllaços són actius. Això us dóna dos beneficis. Podeu comprovar (situant-vos a sobre amb el punter del ratolí) que els enllaços s'estableixen com s'esperava, i podeu utilitzar un enllaç de color vermell per crear una nova pàgina.

Fer una llista d'aplicacions

Si voleu crear una llista d'aplicacions, haureu d'utilitzar la plantilla AppItem. Simplement introduïu 

{|
{{AppItem|System Settings/Locale|Preferences-desktop-locale.png|
Arranjament per a la gestió local de nombres, dates, etc.}}Un text curt.
Unes poques línies curtes més sobre l'aplicació. Això és opcional.
|-
{{AppItem|System Settings/Shortcuts and Gestures|Preferences-desktop-keyboard.png|
Dreceres i gestos}}Un altre text curt. Si no premeu <keycap>Retorn</keycap> entre el text
obtindreu una secció, no importa l'allargada del text.
|}

Això resulta en el següent:

Arranjament per a la gestió local de nombres, dates, etc.

Un text curt.

Unes poques línies curtes més sobre l'aplicació. Això és opcional.

Dreceres i gestos

Un altre text curt. Si no premeu Retorn entre el text

obtindreu una secció, no importa l'allargada del text.

Tingueu en compte, que no s'ha de anteposar «Special:myLanguage» al nom de la pàgina -la plantilla s'encarrega d'això-. Tingueu també en compte, que heu de donar un títol, encara que el títol sigui el mateix que el nom de la pàgina.

Notes al peu

Les notes al peu s'utilitzen poques vegades a les nostres pàgines, però si les necessiteu podeu col·locar un <ref>text</ref> en la font on ha d'aparèixer la marca «footnote». No ha de ser una <referència /> en algun lloc de la font, normalment anirà al final de la pàgina. Aquí és on apareixerà el text afegit per les etiquetes <ref>. Per a més informació veure la pàgina de la Viquipèdia.

Il·lustrar el text

Afegir una única imatge, centrada

[[File:KMail-kde4.png|250px|center]]

Tingueu en compte que es pot canviar la posició de la imatge, però el valor per omissió és l'esquerra. La mida de la imatge dependrà de les circumstàncies, però per les captures de pantalla recomano no menys de 250 píxels i no més de 500 píxels.

Tingueu també en compte que Image: i File: són sinònims. De manera que [[Image:KMail-kde4.png]] és el mateix que [[File:KMail-kde4.png]]. De tota manera Image: està desaconsellat, en el contingut nou preferim File:.

Per a més informació, veure mediawiki.

Fer la imatge clicable i afegir un títol

Quan necessiteu mostrar més detalls, creeu una imatge de grandària moderada, on es pugui fer clic, de manera que es pugui veure tota. N'hi ha prou amb el paràmetre «|thumb» dins dels parèntesis de la imatge.

També es pot afegir un títol com a paràmetre, però només es mostrarà si «|thumb» és present.

Exemple: 

[[File:file_name.png|thumb|aquest serà el títol]]

Afegir un títol sense una miniatura

Els títols també apareixen en les imatges marcades amb la sintaxi del marc.

Exemple: 

[[File:image.png|frame|left|aquest serà el títol]]

Prevenir que el text flueixi al voltant de la imatge

A vegades és possible que no vulgueu que el text flueixi pels costats de la imatge. Això es pot evitar afegint una etiqueta <br clear=all> entre l'etiqueta «File:» i el text en qüestió.

Exemple: 

[[File:image.png]]
<br clear=all>
Aquest text normalment fluix pels costats de la imatge, però ara es trobarà sota de la imatge.

Utilitzar taules per a col·locar amb precisió múltiples imatges

{|class="tablecenter" style="border: 1px solid grey;"
|[[Image:Desktop-config-customized.png|230px|center]]||[[Image:Desktop-settings-rightclick.png|230px|center]]
|-
|[[Image:Desktop-theme-details-dialog.png|230px|center]]||[[Image:Plasma-multiple-themes.png|230px|center]]
|}

mostrarà


Tingueu en compte que tots els paràmetres d'una imatge es troben dins de [[...]], i les cel·les estan separades per «||». Per iniciar una nova línia, introduïu «|-» en una línia d'altra manera buida i després «|» al començament de la següent.

Per més detalls sobre el format de la Taula veure el mediawiki.

Incrustar un vídeo

A partir de juliol de 2012, l'extensió EmbedVideo del MediaWiki ha estat instal·lada a «userbase.kde». Això vol dir que podeu incrustar vídeos des de diversos llocs d'allotjament de vídeo en el contingut de la pàgina i fer que es mostrin en línia.

La funció analitzadora de «EmbedVideo» espera ser cridada en qualsevol de les següents maneres:

{{#ev:servei|id}}
{{#ev:servei|id|amplada}}
{{#ev:servei|id|amplada|alineació}}
{{#ev:servei|id|amplada|alineació|descripció}}
{{#evp:servei|id|descripció}}
{{#evp:servei|id|descripció|alineació}}
{{#evp:servei|id|descripció|alineació|amplada}}

On: 

«servei» és el nom d'un servei de compartiment de vídeo (veure «nom servei» en la llista a sota).
«id» és l'identificador del vídeo a incloure.
«amplada» (opcional) és l'amplada en píxels de l'àrea de visió (l'alçada es determinarà de forma automàtica).
«alineació» (opcional) és un atribut d'alineació (float). Pot ser «left» (esquerra) o «right» (dreta).
«descripció» (opcional) és una breu descripció per mostrar sota del vídeo quan està alineat.

Per exemple, per incloure el famós vídeo «evolution of dance» de YouTube, cal que introduïu: 

{{#ev:youtube|dMH0bHeiRNg}}

I si el voleu reduir a mida de miniatura, a la dreta amb una breu descripció, podeu utilitzar: 

{{#ev:youtube|dMH0bHeiRNg|100|right|Aquest és un vídeo incrustat!}}


A partir de la versió 1.0, «EmbedVideo» admet incrustar contingut de vídeo des dels següents serveis:

Lloc Nom del servei
Dailymotion dailymotion
Div Share divshare
Edutopia edutopia
FunnyOrDie funnyordie
Google Video googlevideo
Interia interia or interiavideo
Revver revver
sevenload sevenload
TeacherTube teachertube
YouTube youtube and youtubehd
Vimeo vimeo

Afegir notes i avisos

Important

Les caixes de sagnat no es mostren correctament! Mai col·loqueu dos punts al davant d'un quadre, sinó fareu que el quadre prengui un aspecte molt estrany.


Quan una nota o avís és pertinent dins del text, useu aquestes plantilles:

{{Info|Aquesta és informació general.}} mostrarà

Information

Aquesta és informació general.


{{Note|Alguna informació important en aquest moment.}} mostrarà

Note

Alguna informació important en aquest moment.


{{Tip|Un consell útil, alguna cosa a recordar.}} mostrarà

Tip

Un consell útil, alguna cosa a recordar.


{{Warning|Aneu amb compte: És una cosa perillosa de fer.}} mostrarà

Warning

Aneu amb compte: És una cosa perillosa de fer.


Quan l'avís sigui necessari ser el més fort possible, podeu usar el quadre Recordeu però, si us plau, utilitzeu-lo amb moderació. {{Remember|1=Per a les coses que definitivament no s'han d'oblidar.}}

Remember

Per a les coses que definitivament no s'han d'oblidar.


També podeu canviar el títol:

No oblideu això!

Podeu utilitzar el número de paràmetre 2 per establir un quadre de títol: 
{{Remember|2=No oblideu això!|1=Podeu usar...}}


Redirecció de la pàgina

Podeu crear una pàgina per a redirigir automàticament cap a una altra mitjançant: 

#REDIRECT [[Pagename]]

Les versions KDE3 i KDE SC 4 de les aplicacions

Per omissió, s'assumeix KDE SC 4. Si la versió del KDE SC 4 encara no està llesta pel llançament, o quan només hi ha una versió de KDE 3, pot ser necessari documentar la versió del KDE3. En aquest cas, haureu d'afegir la plantilla {{KDE3}} que mostrarà . Si considereu escriure sobre les versions de KDE3 i de KDE SC 4 a la mateixa pàgina, utilitzeu les icones d'ambdós:{{KDE4}} que mostrarà .

Altres plantilles d'utilitat

Inserció d'icones de la IGU

La millor manera de referir-se a les icones de la interfície gràfica d'usuari és que aparegui en el text. Això es pot fer amb una plantilla com aquesta: {{Icon|list-add}}. Això mostrarà la icona .

Per què això funcioni, la imatge d'icona s'ha de pujar al wiki. Veure Actualitzar una imatge per a una explicació sobre la forma de pujar-les. Els fitxers PNG es poden trobar aquí: usr/share/icons/oxygen. Si és possible useu la icona de 16x16. El nom del fitxer ha de tenir un prefix Icon, com en Icon-list-add.png: a part del prefix el nom del fitxer ha de coincidir exactament amb el nom comú. Tingueu en compte que quan s'utilitza la plantilla haureu d'escriure el prefix Icon no l'extensió .png del tipus de fitxer.

La icona també es pot escriure com <code>{{Plus}}</code>, i la icona com <code>{{Minus}}</code>. També podeu utilitzar <code>{{Configure}}</code> per obtenir la icona , i amb <code>{{Exit}}</code> obtindreu la icona .

Aplicacions de la comunitat

L'última consideració es refereix a les aplicacions que no es distribueixen com a base de les aplicacions KDE. Aquestes s'han d'indicar amb una icona com {{Comunitat-app}}.

 Llegiu la nota

Al final de la vostra sentència o de la línia, simplement per referir-vos a un peu de pàgina en l'escrit en general. A continuació necessitareu afegir {{Community-app-footnote}} el qual crearà un peu de pàgina, com:

L'ajuda per a aquesta aplicació es troba a la pàgina web del projecte.

Fer edicions importants a les pàgines existents

Si una pàgina és oberta per a l'edició des de fa algun temps hi ha perill de conflictes: Algú pot editar-la alhora, i el desar-la cancel·larà els vostres canvis, o viceversa. La forma d'evitar-ho és creant una entrada temporal, directament sota la barra d'idiomes, utilitzant {{Being_Edited}} que mostrarà

Actualment s'està editant

Aquesta pàgina s'està editant.
Si aquest avís persisteix durant un temps raonable, si us plau, notifiqueu-ho al canal #kde-www de irc.freenode.org o informeu-ne sobre la pàgina de debat de l'Annew.

Nota: Pàgines que normalment no es marquen per a la traducció mentre s'hi treballa activament.


No oblideu manllevar-la una vagada finalitzada!

Afegir una nova pàgina complexa

Si necessiteu poder treballar en una pàgina durant força temps, diversos dies, per exemple, potser voldreu utilitzar la plantilla de construcció: {{Construction}}, que mostrarà

En construcció

Aquesta és una pàgina nova, actualment en construcció!


Enllaços a pàgines veïnes

Podeu afegir enllaços a una pàgina anterior o següent amb les plantilles que s'exposen aquí: 

{{Prevnext2|prevpage=Previous Pagename|nextpage=Following Pagename|prevtext=La pàgina abans d'aquesta pàgina|nexttext=Aquesta pàgina s'hauria de llegir després|index=Index page|indextext=El menú Enrere}}

Els sis arguments són opcionals. Per a les primeres pàgines, sense pàgina anterior o les últimes pàgines, sense pàgines següent, utilitzeu això: 

{{Prevnext2|nextpage=Following Pagename|nexttext=Aquesta pàgina s'hauria de llegir després}}
{{Prevnext2|prevpage=Previous Pagename|prevtext=La pàgina abans d'aquesta pàgina}}

Si no s'especifica un indexname es mostrarà el nom de la pàgina actual.

Nota

Sempre haureu d'especificar un text per les pàgines que enllacen, i sempre s'haurà d'utilitzar Special:myLanguage amb els vostres enllaços, en cas contrari creareu problemes als traductors.


Enllaços a errors

Podeu enllaçar directament amb un error al Bugzilla utilitzant aquesta plantilla:

{{Bug|123456}}

Si us plau, no oblideu afegir <s> i </s> quan es tanqui un error.

Afegir una llista de subpàgines

== Subpàgines de {{FULLPAGENAME}} ==
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}

És molt útil quan es desitja llistar subpàgines amb enllaços actius, com ara

Subpàgines de Toolbox/ca

En canvi també llista totes les pàgines d'«altres idiomes», useu-lo doncs amb prudència.



Retrieved from "https://userbase.kde.org/index.php?title=Toolbox/ca&oldid=477591"