Help:VisualEditor/User guide/ca

Per començar: la barra d'eines de l'editor visual
center|950px|alt=Captura de pantalla de la barra d'eines de l'editor visual

border|950px|center

Editar referències
{| cellpadding="15"
 * colspan=2 |

Sistemes disponibles a la Viquipèdia
El primer sistema (mostrat a la dreta) és el de , en el que es vol utilitzar una citació que ja s'estigui utilitzant en un altre lloc de l'article. Teniu el cercador per tal de buscar-lo. S'explica amb una mica més de detall, a la següent secció. Algun detall innecessari a Algun detall innecessari a
 * Podeu utilitzar qualsevol dels tres sistemes de notes a peu de pàgina, segons us convingui, després de clicar el botó "Cita":
 * Podeu utilitzar qualsevol dels tres sistemes de notes a peu de pàgina, segons us convingui, després de clicar el botó "Cita":
 * border|center|200px
 * colspan=2 |
 * El segon sistema, o Manual, permet afegir una citació segons algunes de les diferents plantilles establertes (Lloc web, Llibre, Publicació i Tesi), o la forma Bàsica que permet un text lliure.
 * El segon sistema, o Manual, permet afegir una citació segons algunes de les diferents plantilles establertes (Lloc web, Llibre, Publicació i Tesi), o la forma Bàsica que permet un text lliure.
 * El segon sistema, o Manual, permet afegir una citació segons algunes de les diferents plantilles establertes (Lloc web, Llibre, Publicació i Tesi), o la forma Bàsica que permet un text lliure.
 * border|center|200px
 * colspan=2 |
 * border|center|100px
 * El tercer sistema, o Automàtic, permet tan sols copiant la url que s'anoti el títol, autor, data, i altres; en molts casos. S'obre un quadre de diàleg on hi ha un procés de citació automàtica mitjançant el servei Citoid.
 * border|center|100px
 * El tercer sistema, o Automàtic, permet tan sols copiant la url que s'anoti el títol, autor, data, i altres; en molts casos. S'obre un quadre de diàleg on hi ha un procés de citació automàtica mitjançant el servei Citoid.
 * El tercer sistema, o Automàtic, permet tan sols copiant la url que s'anoti el títol, autor, data, i altres; en molts casos. S'obre un quadre de diàleg on hi ha un procés de citació automàtica mitjançant el servei Citoid.
 * El tercer sistema, o Automàtic, permet tan sols copiant la url que s'anoti el títol, autor, data, i altres; en molts casos. S'obre un quadre de diàleg on hi ha un procés de citació automàtica mitjançant el servei Citoid.
 * border|center|400px
 * colspan=2 |
 * colspan=2 |

Editar una referència existent

 * Per modificar una referència existent, feu-hi clic on apareix dins del text (normalment en forma de número entre claudàtors). Veureu una icona "" (punt de llibre) o una icona (i un nom) de la plantilla utilitzada per crear aquesta referència. En qualsevol cas, clicant al botó "Modifica" obrireu un diàleg on podreu modificar la referència.
 * border|400px|center
 * colspan=2 |
 * En el cas de la icona "", clicant a "Modifica" s'obre el diàleg "Referència". Per començar a canviar la informació de la referència, feu-hi clic.
 * colspan=2 |
 * En el cas de la icona "", clicant a "Modifica" s'obre el diàleg "Referència". Per començar a canviar la informació de la referència, feu-hi clic.
 * En el cas de la icona "", clicant a "Modifica" s'obre el diàleg "Referència". Per començar a canviar la informació de la referència, feu-hi clic.

Molts wikis usen plantilles per formatar les referències. Si en la referència en qüestió hi ha una plantilla, quan passeu el punter per damunt de la informació de la referència, es ressaltarà tota la informació del camp.

Si s'hi va utilitzar una plantilla i cliqueu a la informació de la referència, apareixerà la icona (peça de trencaclosques) amb alguna informació. Per modificar el contingut de la plantilla al diàleg mini-editor de plantilles, cliqueu al botó "modifica".
 * border|center|400px
 * colspan=2 |
 * Si quan cliqueu a una referència apareix la icona d'una plantilla estàndard de citació (com a l'exemple de la dreta), clicant a "Modifica" s'obrirà el diàleg mini-editor de plantilles.
 * border|center|400px
 * colspan=2 |
 * Dins del mini-editor de plantilles, podeu afegir o treure tipus d'informació o canviar-ne el contingut actual. Al principi, només hi apareixeran els camps (paràmetres de la plantilla) que tinguin contingut. Per afegir-hi camps, cliqueu a "" (al capdavall del mini-editor).
 * border|center|400px
 * colspan=2 |
 * Quan acabeu, feu clic a "".
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * Quan acabeu, feu clic a "".
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Reutilitzar una referència ja existent

 * Si la pàgina ja conté una referència que serveix per documentar el text, la podeu reutilitzar.
 * Si la pàgina ja conté una referència que serveix per documentar el text, la podeu reutilitzar.

Per reutilitzar una referència existent, col·loqueu el cursor al cos del text on voleu afegir una referència nova (número) d'aquesta citació, i després de clicar "" feu clic a la pestanya "Reutilitza" de la finestra.

(Nota: Si el vostre wiki té el tercer dels sistemes de notes a peu de pàgina descrits més amunt, veureu una pestanya "Reutilitza" dins d'un diàleg, en comptes d'un element "Reutilitza" en el menú "".)
 * border|200px|center
 * colspan=2 |
 * Al diàleg, cerqueu a la llista la referència que voleu reutilitzar i seleccioneu-la. Si hi ha moltes referències, podeu utilitzar el quadre de cerca perquè es mostrin només les referències que continguin un text determinat (etiquetat com a «»).
 * border|400px|center
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Afegir una nova referència

 * Per afegir una nova referència mitjançant el menú «», col·loqueu el cursor on la vulgueu afegir al text. A continuació, seleccioneu el tipus de cita adequat al menú.
 * border|200px|center
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Utilitzant la citació bàsica

 * Si seleccioneu l'element "Forma bàsica", es mostrarà això. En l'editor de referències podeu afegir la citació i donar-li format.
 * Si seleccioneu l'element "Forma bàsica", es mostrarà això. En l'editor de referències podeu afegir la citació i donar-li format.

Podeu fer que la referència pertanyi a un grup determinat, tot i que normalment això es deixa en blanc. (Aquesta opció s'utilitza per mostrar grups de referències amb l'eina "".)
 * border|400px|center
 * colspan=2 |
 * En el diàleg de referències, si voleu incloure una plantilla de citació o qualsevol altra plantilla a la referència nova, feu clic a la icona (la peça de trencaclosques) del menú "" de l'editor de referències.
 * border|center|200px
 * colspan=2 |
 * Aleshores, cerqueu la plantilla que voleu utilitzar, afegiu-la i modifiqueu-la com ho faríeu amb qualsevol altra. (Vegeu la secció Editar plantilles, més avall, si necessiteu més informació sobre les plantilles.)
 * colspan=2 |
 * Aleshores, cerqueu la plantilla que voleu utilitzar, afegiu-la i modifiqueu-la com ho faríeu amb qualsevol altra. (Vegeu la secció Editar plantilles, més avall, si necessiteu més informació sobre les plantilles.)
 * Aleshores, cerqueu la plantilla que voleu utilitzar, afegiu-la i modifiqueu-la com ho faríeu amb qualsevol altra. (Vegeu la secció Editar plantilles, més avall, si necessiteu més informació sobre les plantilles.)
 * Aleshores, cerqueu la plantilla que voleu utilitzar, afegiu-la i modifiqueu-la com ho faríeu amb qualsevol altra. (Vegeu la secció Editar plantilles, més avall, si necessiteu més informació sobre les plantilles.)

Quan acabeu de modificar la plantilla nova, feu clic a "" per tornar a l'editor de referències, i torneu a fer clic a "" per tornar a la pàgina que esteu modificant.
 * border|center|400px
 * colspan=2 |
 * Si encara no hi ha una llista de referències a la pàgina (per exemple, si heu afegit la primera referència de la pàgina), heu d'indicar on apareixeran la llista de referències i el seu text.
 * Si encara no hi ha una llista de referències a la pàgina (per exemple, si heu afegit la primera referència de la pàgina), heu d'indicar on apareixeran la llista de referències i el seu text.
 * Si encara no hi ha una llista de referències a la pàgina (per exemple, si heu afegit la primera referència de la pàgina), heu d'indicar on apareixeran la llista de referències i el seu text.

Col·loqueu el cursor on voleu mostrar la llista de referències (normalment al capdavall de la pàgina), obriu el menú "" i feu clic a la icona "" (tres llibres).
 * border|center|200px
 * colspan=2 |
 * Si esteu utilitzant diversos grups de referències (cosa poc freqüent), en aquest quadre de diàleg podeu indicar el grup. Al lloc de la pàgina on esteu col·locant el grup només es mostraran les referències que hi pertanyen.
 * Si esteu utilitzant diversos grups de referències (cosa poc freqüent), en aquest quadre de diàleg podeu indicar el grup. Al lloc de la pàgina on esteu col·locant el grup només es mostraran les referències que hi pertanyen.
 * Si esteu utilitzant diversos grups de referències (cosa poc freqüent), en aquest quadre de diàleg podeu indicar el grup. Al lloc de la pàgina on esteu col·locant el grup només es mostraran les referències que hi pertanyen.

El pas final a fer en el diàleg "Llista de referències" és clicar a "".
 * border|center|400px
 * colspan=2 |
 * colspan=2 |

Utilitzar plantilles estàndard de citació

 * El vostre wiki local pot haver afegit plantilles de citació addicionals al menú "". Si és així, teniu un accés ràpid a les plantilles de citació més habituals del vostre wiki. (Les instruccions per afegir plantilles de citació addicionals al vostre wiki local són disponibles a .)
 * border|200px|center
 * colspan=2 |
 * Clicant a la icona d'una plantilla com ara "Llibre", s'obrirà el mini-editor de plantilles d'aquella plantilla. Els camps importants poden estar marcats amb un asterisc. Encara que s'hi mostren els camps més comuns, no tots són necessaris.
 * border|430px|center
 * colspan=2 |
 * Per afegir-hi més paràmetres, desplaceu-vos avall pel mini-editor de plantilles i cliqueu a l'opció "".
 * border|430px|center
 * colspan=2 |
 * Per afegir-hi més paràmetres, desplaceu-vos avall pel mini-editor de plantilles i cliqueu a l'opció "".
 * Per afegir-hi més paràmetres, desplaceu-vos avall pel mini-editor de plantilles i cliqueu a l'opció "".
 * Per afegir-hi més paràmetres, desplaceu-vos avall pel mini-editor de plantilles i cliqueu a l'opció "".

Quan acabeu, cliqueu a "".
 * border|200px|center
 * }

Editar imatges i altres mitjans
{| cellpadding="15"
 * colspan=2 |
 * colspan=2 |

Editar imatges

 * Per afegir una nova imatge (o un altre tipus de fitxer multimèdia) a la pàgina, premeu la icona "" (una imatge de muntanyes) al menú "". La imatge s'afegirà allà on sigui el cursor.
 * border|200px|center
 * colspan=2 |
 * Clicant la icona "" s'obre un diàleg que busca automàticament a Wikimedia Commons i al vostre wiki local els fitxers multimèdia relacionats amb el títol de la pàgina que esteu modificant.
 * colspan=2 |
 * Clicant la icona "" s'obre un diàleg que busca automàticament a Wikimedia Commons i al vostre wiki local els fitxers multimèdia relacionats amb el títol de la pàgina que esteu modificant.
 * Clicant la icona "" s'obre un diàleg que busca automàticament a Wikimedia Commons i al vostre wiki local els fitxers multimèdia relacionats amb el títol de la pàgina que esteu modificant.

Podeu buscar altres fitxers multimèdia canviant el text al diàleg de cerca.

Cliqueu una miniatura per a escollir un fitxer.

Això col·loca la imatge a la pàgina que esteu modificant.
 * border|center|500px
 * colspan=2 |
 * Quan s'ha inserit a la pàgina la imatge que havíeu seleccionat, s'obre un altre diàleg que us permet afegir i modificar el peu de la imatge, que pot contenir format i enllaços.
 * border|center|400px
 * colspan=2 |
 * El diàleg de mitjans també us permet afegir peus amb text alternatiu per assistir els usuaris que empren lectors de pantalla o el que han inhabilitat que es mostrin les imatges.
 * border|center|400px
 * colspan=2 |
 * A la finestra de "" podeu establir diversos paràmetres de la imatge, com ara l'alineació, el tipus i la mida.
 * border|center|400px
 * colspan=2 |
 * Quan hàgiu acabat, cliqueu "" per a tancar el diàleg i tornar a la pàgina d'edició.
 * border|center|150px
 * colspan=2 |
 * Si voleu afegir o modificar un peu o qualsevol altre configuració d'una imatge ja existent, cliqueu a la imatge i a continuació cliqueu a la icona "" que hi apareix a sota.
 * border|center|400px
 * colspan=2 |
 * Quan hàgiu acabat, cliqueu "" per a tancar el diàleg i tornar a la pàgina d'edició.
 * border|center|150px
 * colspan=2 |
 * Si voleu afegir o modificar un peu o qualsevol altre configuració d'una imatge ja existent, cliqueu a la imatge i a continuació cliqueu a la icona "" que hi apareix a sota.
 * colspan=2 |
 * Si voleu afegir o modificar un peu o qualsevol altre configuració d'una imatge ja existent, cliqueu a la imatge i a continuació cliqueu a la icona "" que hi apareix a sota.
 * Si voleu afegir o modificar un peu o qualsevol altre configuració d'una imatge ja existent, cliqueu a la imatge i a continuació cliqueu a la icona "" que hi apareix a sota.
 * Si voleu afegir o modificar un peu o qualsevol altre configuració d'una imatge ja existent, cliqueu a la imatge i a continuació cliqueu a la icona "" que hi apareix a sota.

Podeu redimensionar una imatge existent clicant-hi i a continuació movent la icona de redimensionament (la fletxa doble que hi ha en una de les cantonades inferiors o en totes dues).

També podeu arrossegar i deixar anar una imatge més amunt o més avall de la pàgina.
 * center|360px
 * }

Editar plantilles
The powerful MediaWiki template system lets you insert dynamic content, text from other pages, and much more. For a detailed explanation and examples, see the Templates help page.

In the VisualEditor you can search for a relevant template, add an invocation or transclusion on the page you’re editing and, if needed, add custom content using parameters.

Insert new template
{| cellpadding="15"
 * Per afegir una nova plantilla a una pàgina, col·loqueu el cursor on voleu inserir-la, i llavors feu clic a la icona "$template" (la peça de trencaclosques) del menú "$insert". Then open the menu and select "[[File:OOjs_UI_icon_puzzle-ltr.svg]] ". Alternatively, type two curly brackets {{ to open the same dialog.
 * border|300px|center
 * Find the template you want to insert by typing either its name or a relevant keyword. Results containing the search term in either the name or description will display in a dropdown. This should help you find a relevant template, even if you don’t know its exact name.
 * Find the template you want to insert by typing either its name or a relevant keyword. Results containing the search term in either the name or description will display in a dropdown. This should help you find a relevant template, even if you don’t know its exact name.
 * Find the template you want to insert by typing either its name or a relevant keyword. Results containing the search term in either the name or description will display in a dropdown. This should help you find a relevant template, even if you don’t know its exact name.

If you’re having trouble finding the kind of template you want by using keywords, you can look on other wiki pages with similar content and view or edit the page source to see which templates are in use. When you find the desired template’s name, you can type it into this field to insert it here.
 * VisualEditor_Template_Search.png
 * colspan=2 |
 * També podeu modificar una plantilla que ja sigui a la pàgina. Quan cliqueu a la plantilla per seleccionar-la, es tornarà de color blau i apareixerà un quadre amb una icona "$template" (la peça de trencaclosques). Llavors cliqueu a l'enllaç "$edit". When you select the template you want to edit, it turns blue, and a box appears displaying "[[File:OOjs_UI_icon_puzzle-ltr.svg]] ". Then select the "" link or double click on the template itself to open the template.
 * VisualEditor_Template_Context_Menu.png
 * colspan=2 |
 * Algunes plantilles no són visibles als lectors d'una pàgina. A l'editor visual, aquestes plantilles ocultes es mostren com a icones de trencaclosques. El nom de la plantilla es mostrarà al costat de la icona del trencaclosques.
 * VisualEditor_Hidden_Templates.png
 * colspan=2 |
 * Algunes plantilles no són visibles als lectors d'una pàgina. A l'editor visual, aquestes plantilles ocultes es mostren com a icones de trencaclosques. El nom de la plantilla es mostrarà al costat de la icona del trencaclosques.
 * VisualEditor_Hidden_Templates.png
 * VisualEditor_Hidden_Templates.png


 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Paràmetres de plantilla

 * You’ll see this dialog box when you’re adding a new template or editing one already in place. What you see in the box depends on whether the template in question contains, helpful metadata added by other editors to make it easier to edit templates in the Visual Editor.
 * You’ll see this dialog box when you’re adding a new template or editing one already in place. What you see in the box depends on whether the template in question contains, helpful metadata added by other editors to make it easier to edit templates in the Visual Editor.

When a template contains TemplateData, the VisualEditor can use it to present annotated fields for you to fill in.

For templates that have some community-provided TemplateData, the VisualEditor displays a list of the named parameters and, often, descriptions and instructions explaining the meaning and required format for each parameter’s values.
 * Template_parameters_in_VisualEditor.png
 * colspan="2" |
 * En una plantilla ja existent, podeu modificar els paràmetres que es mostren al diàleg i podeu afegir-ne clicant a "", al capdavall del diàleg.
 * Template_parameter_list_in_VE_(old_UI).png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Adding undocumented parameters

 * If you’re inserting or editing a template whose author hasn’t laid out its parameters in TemplateData, it has what we call “undocumented” or “unnamed parameters”. In these cases, you should consult the page for the template itself. There you can learn how to correctly employ and work with all of the template’s parameters. This includes learning the exact names of the parameters as written by the template author.
 * If you’re inserting or editing a template whose author hasn’t laid out its parameters in TemplateData, it has what we call “undocumented” or “unnamed parameters”. In these cases, you should consult the page for the template itself. There you can learn how to correctly employ and work with all of the template’s parameters. This includes learning the exact names of the parameters as written by the template author.

If you find in the documentation that the template expects parameters without have names, fill in numbers as placeholders for the parameter names using the undocumented parameter input, then add next to the values you want to provide as you normally would.

Example: * first unnamed parameter: “1” * first unnamed parameter’s value: “en_US” * second unnamed parameter: “2” * second unnamed parameter’s value: “yes”

If you accidentally include nonexistent, misspelled or erroneous parameters, the values you enter for those parameters won’t show up on the page you’re editing.
 * Template_without_TemplateData_in_VisualEditor_(old_UI).png
 * colspan=2 |
 * colspan="2" |
 * colspan="2" |
 * colspan="2" |

Autogenerated parameters

 * In this example, the template in question lacks TemplateData but it was possible to autogenerate the parameters. This means that the undocumented parameters have already been added for you, but the names may not be easily understandable and the dialog cannot display any directions or descriptions. As a result the dialog box provides a link to the template’s documentation, which should help you deduce and fill in the template’s various parameters.
 * Autogenerated_parameters_in_the_VisualEditor.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Editing multi-part template content

 * During editing, you may open template content consisting of multiple templates or a single template linked to some wikitext. This differs from the nested templates described below. In this case, the templates are better visualized as being stacked or connected.
 * During editing, you may open template content consisting of multiple templates or a single template linked to some wikitext. This differs from the nested templates described below. In this case, the templates are better visualized as being stacked or connected.

This content often contains “unbalanced templates,” templates which are incomplete on their own and need to be paired with some wikitext or another template in order to function.
 * Multi-part_template_content_in_the_VisualEditor.png
 * colspan=2 |
 * colspan="2" |
 * colspan="2" |
 * colspan="2" |

Nested templates

 * Templates can include other templates as the value for parameters. You’ll recognize it when you see a parameter whose value contains the double curly braces denoting a template.
 * Templates can include other templates as the value for parameters. You’ll recognize it when you see a parameter whose value contains the double curly braces denoting a template.

The VisualEditor can’t present this template within a template (a nested template) using the editor’s easy-to-use interface, so if you want to nest a template yourself, you’ll need to understand how to add the template by hand in wikitext into the appropriate parameter field.
 * Embedded_template_in_VisualEditor.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Completing your edit

 * Quan hàgiu acabat de modificar una plantilla, cliqueu a "" per a tancar el diàleg i tornar a la pàgina principal que estàveu modificant. Then you can preview your edit and make sure it looks the way you want and expect.
 * Quan hàgiu acabat de modificar una plantilla, cliqueu a "" per a tancar el diàleg i tornar a la pàgina principal que estàveu modificant. Then you can preview your edit and make sure it looks the way you want and expect.

You may also see an error message, which (like the other TemplateData mentioned above) is community-provided content and may vary in usefulness. You may need to consult the template’s own documentation to get to the bottom of some errors. If you’re still having trouble, consider posting about your problem on the template’s talk page.
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Removing a template

 * To remove a template in the VisualEditor, click the template box. A context menu will appear with a "Delete" button. Click it to remove the template from the page.
 * Removing_templates_from_a_page_via_context_menu.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Editing on mobile

 * When editing a template on a page using the VisualEditor on a mobile device, you’ll see that the sidebar starts out hidden. You can make it visible by pressing the “Show/hide options” button.
 * When editing a template on a page using the VisualEditor on a mobile device, you’ll see that the sidebar starts out hidden. You can make it visible by pressing the “Show/hide options” button.


 * VisualEditor_template_editing_on_mobile.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Substituir plantilles

 * When you insert a template in a wiki page, its content and appearance are reevaluated every time the page loads, based on the template code and the values of its parameters. This means if someone updates the code of a template, then every page which uses that template will also get updated when they publish.
 * When you insert a template in a wiki page, its content and appearance are reevaluated every time the page loads, based on the template code and the values of its parameters. This means if someone updates the code of a template, then every page which uses that template will also get updated when they publish.

There’s another, much less common way to use templates, though, and that’s to substitute a template. Doing this permanently includes the template content just as it appears at the moment you insert it. It will not update if the template code is later changed.

Most users won’t ever need to resort to substitution. Substitution is typically only useful when you need to capture the exact appearance of one version of a template, such as when content is under development and needs evaluation.

To substitute a template in the VisualEditor, insert a template using the name syntax. (Autocomplete doesn’t work in this case.) Then press the blue “Add template” button.

When you’re finished, press “Insert”, which will insert the template content as you see it.
 * SUBST_in_VE.png
 * }

Dreceres de teclat
Molts editors estan acostumats a introduir directament codi wiki, especialment negretes, cursives i enllaços wiki. Les dreceres de teclat permeten introduir ràpidament formats similars sense haver d'utilitzar els elements de la barra d'eines. Aquestes són les dreceres més comunes de l'Editor Visual: