Vés al contingut

Ajuda:Sintaxi wiki

De la Viquipèdia, l'enciclopèdia lliure
Per a un informació bàsica vegeu Ajuda:Com es modifica una pàgina.

Format bàsic de text

[modifica]

Podeu donar format al text utilitzant caràcters especials de sintaxi wiki.

Com es mostra Com s'escriu

Podeu fer text en cursiva posant 2 apòstrofs a cada costat.

3 apòstrofs faran el text en negreta.

5 apòstrofs fan el text en
negreta i cursiva.

(4 apòstrofes no fa res en especial: els dos últims es mostren com a 'part del text'.)

Podeu fer ''text en cursiva'' posant 2 
apòstrofs a '''cada''' costat. 

3 apòstrofs faran el '''text en negreta'''. 

5 apòstrofs fan '''''el text''''' en
'''negreta''' i ''cursiva''.

(4 apòstrofes no fa res en especial: 
els dos últims es mostren com a 
''''part del text''''.)

Una única línia nova generalment no té cap efecte. Es pot utilitzar per separar frases dins d'un paràgraf. Alguns editors troben que això ajuda l'edició i millora la funció de difs (utilitzada internament per comparar diferents versions d'una pàgina).

Però una línia buida separa els paràgrafs.

En una llista, una línia nova no afecta l'estructura (vegeu més avall).

Una única línia nova 
generalment no té cap efecte.
Es pot utilitzar per separar 
frases dins d'un paràgraf.
Alguns editors troben que això ajuda l'edició
i millora la funció de ''difs''
(utilitzada internament per comparar
diferents versions d'una pàgina).

Però una línia buida 
separa els paràgrafs.

En una llista, una línia nova ''no'' 
afecta l'estructura ([[#llistes|vegeu més avall]]).

Podeu trencar línies
sense un nou paràgraf.
Però utilitzeu-ho amb moderació.

No trenqueu una línia en mig d'un enllaç o text en cursiva o negreta.

Podeu trencar línies<br/>
sense un nou paràgraf.<br/>
Però utilitzeu-ho amb moderació.

No trenqueu una línia en mig d'un
enllaç o text en ''cursiva'' o '''negreta'''.

Hauríeu de signar els vostres comentaris en pàgines de discussió:

Hauríeu de signar els vostres comentaris 
en pàgines de discussió:
* Tres titlles fan la vostra 
signatura: ~~~
* Quatre titlles fan la vostra 
signatura datada: ~~~~
* Cinc titlles fan només la 
datació: ~~~~~

Elements HTML

[modifica]

També es poden utilitzar alguns elements HTML, però s'haurien d'evitar en favor de la sintaxi wiki sempre que sigui possible.

Com es mostra Com s'escriu

Posar text en una font mecanogràfica. Generalment s'utilitza la mateixa font per codi de programari.

Posar text en una <tt>font mecanogràfica</tt>. 
Generalment s'utilitza la mateixa font per 
<code>codi de programari</code>.

Ratllar o subratllar text, o escriure'l en versaleta.

<strike>Ratllar</strike>
o <u>subratllar</u> text,
o escriure'l en <span style=
"font-variant:small-caps">
versaleta</span>.

Superíndex i subíndex: X2, H2O

Superíndex i subíndex:
X<sup>2</sup>, H<sub>2</sub>O
Text centrat
<center>Text centrat</center>

L'element blockquote dóna format a un paràgraf de citació, típicament envoltant-lo d'espais en blanc i amb una font lleugerament diferent

<blockquote>
L'element '''blockquote''' dóna format a un paràgraf 
de citació, típicament envoltant-lo d'espais 
en blanc i amb una font lleugerament diferent
</blockquote>

Comentaris ocults dirigits als editors (<!-- -->) que apareixen només en editar la pàgina.

Comentaris ocults dirigits als editors (<!-- -->)
que apareixen només en editar la pàgina.
<!-- Nota als editors: bla, bla, bla. -->

Organització del text

[modifica]
Vegeu també: Ajuda:Ús d'imatges
Com es mostra Com s'escriu

Encapçalaments de secció

Els encapçalaments organitzen el vostre text en seccions. El programari del Wiki els utilitza per generar automàticament una taula de continguts.


Subsecció

Utilitzant més signes d'igual (=) crea una subsecció.

Subsecció menor

No us salteu nivells, com ara de dos a quatre signes d'igual.

Comenceu amb 2 signes d'igual, no 1 ja que crea un element H1 reservat pel títol de la pàgina.

== Encapçalaments de secció ==

Els ''encapçalaments'' organitzen el vostre text en 
seccions. El programari del ''Wiki'' els utilitza per generar 
automàticament una [[Ajuda:Seccions|taula de continguts]].

=== Subsecció ===
Utilitzant més signes d'igual (=) crea una subsecció.

==== Subsecció menor ====

No us salteu nivells, com ara de dos a quatre signes d'igual.

Comenceu amb 2 signes d'igual, no 1 ja que crea un
element H1 reservat pel títol de la pàgina.
  • Les llistes no numerades són fàcils de fer:
    • Comenceu cada línia amb un asterisc.
      • Més asteriscs indiquen un nivell més.
    L'element anterior continua.
    • Una línia nova
  • en una llista

marca el final de la llista.

  • Però podeu començar de nou.
* Les ''llistes no numerades'' són fàcils de fer:
** Comenceu cada línia amb un asterisc.
*** Més asteriscs indiquen un nivell més.
*: L'element anterior continua.
** Una línia nova
* en una llista
marca el final de la llista.  
*Però podeu començar de nou.
  1. Les llistes numerades són:
    1. Ben organitzades
    2. Fàcils de llegir

Una línia nova marca el final de la llista.

  1. Una nova numeració comença per 1.
# Les ''llistes numerades'' són:
## Ben organitzades
## Fàcils de llegir
Una línia nova marca el final de la llista.
# Una nova numeració comença per 1.

Això és una llista de definicions:

Mot
Definició del mot
Una frase més llarga per definir
Frase definida
Una paraula
Que té una definició
També una segona
Fins i tot una tercera

Comenceu amb un punt i coma. Un element per línia. Es pot posar els dos punts en una línia nova, però utilitzant-los amb un espai de separació millora l'anàlisi estructural.

Això és una ''llista de definicions'':
; Mot : Definició del mot
; Una frase més llarga per definir
: Frase definida
; Una paraula : Que té una definició
: També una segona
: Fins i tot una tercera

Comenceu amb un punt i coma. Un element per línia.
Es pot posar els dos punts en una línia nova, però
utilitzant-los amb un espai de separació millora 
l'anàlisi estructural.
  • Fins i tot es poden fer llistes mixtes
    1. i incrustar-les
    2. dins d'altres
      • o trencar línies
        en llistes.
      les llistes de definició
      també es
      poden
      incrustar
* Fins i tot es poden fer llistes mixtes
*# i incrustar-les
*# dins d'altres
*#* o trencar línies<br>en llistes.
*#; les llistes de definició
*#: també es
*#:; poden : incrustar
Dos punts (:) sagnen una línia o paràgraf.

Una línia nova comença un nou paràgraf.
Només s'hauria d'utilitzar en pàgines de discussió.
En articles, probablement necessitareu l'element blockquote.

Utilitzem 1 signe de dos punts per un sagnat.
Utilitzem 2 signes de dos punts per doble sagnat.
3 signes de dos punts per sagnar 3 vegades, etcètera.
: Dos punts (:) sagnen una línia o paràgraf.
Una línia nova comença un nou paràgraf.
Només s'hauria d'utilitzar en pàgines de discussió.
En articles, probablement necessitareu l'element blockquote.
: Utilitzem 1 signe de dos punts per un sagnat.
:: Utilitzem 2 signes de dos punts per doble sagnat.
::: 3 signes de dos punts per sagnar 3 vegades, etcètera.

Podeu fer una línia horitzontal (----) per separar el text


Però normalment hauríeu d'utilitzar seccions. Així apareixeran a la taula de continguts

Podeu fer una línia horitzontal (----) per separar el text
----
Però normalment hauríeu d'utilitzar seccions.
Així apareixeran a la taula de continguts

Podeu afegir notes a peu de pàgina dins d'una frase utilitzant l'etiqueta ref. És especialment útil per citar una font.

Hi ha més de sis mil milions de persones al món.[1]
Referències:
  1. CIA World Factbook, 2006.

Per a més informació vegeu Ajuda:Notes a peu de pàgina.

Podeu afegir notes a peu de pàgina dins 
d'una frase utilitzant l'etiqueta <tt>ref</tt>. 
És especialment útil per citar una font.

:Hi ha més de sis mil milions de persones 
al món.<ref>CIA World Factbook, 2006.</ref>

Referències: <references/>

Per a més informació vegeu [[Ajuda:Notes a peu de pàgina]].

Enllaços

[modifica]

Sovint voldreu fer que un text enllaci a una altra pàgina.

Com es mostra Com s'escriu

Això és un enllaç a la pàgina anomenada Gat. També podeu escriure gats i l'enllaç es mostrarà correctament.

Això és un enllaç a la pàgina anomenada [[Gat]].
També podeu escriure [[gat]]s
i l'enllaç es mostrarà correctament.

Podeu posar format al text fora de l'enllaç. Per exemple: Viquipèdia.

Podeu posar format al text fora de l'enllaç.
Per exemple: ''[[Viquipèdia]]''.

La lletra inicial dels articles es converteix automàticament en majúscula. Així gat porta al mateix lloc que Gat. A banda de la inicial les majúscules sí que afecten al títol de la pàgina.

La ''lletra inicial'' dels articles es converteix
automàticament en majúscula. Així [[gat]] porta
al mateix lloc que [[Gat]]. A banda de la inicial
les majúscules sí que afecten al títol de la pàgina.

Un enllaç és vermell quan la pàgina encara no existeix. Es pot crear clicant sobre l'enllaç.

Un [[enllaç és vermell]] quan la pàgina encara no existeix.
Es pot crear clicant sobre l'enllaç.

Es pot enllaçar a una secció d'una pàgina pel seu encapçalament:

Si diferents seccions tenen el mateix encapçalament, numereu-les: #Exemple 3 és la tercer secció anomenada "Exemple".

Es pot enllaçar a una secció d'una pàgina pel seu encapçalament:

* [[Ajuda:Enllaços#Enllaços a àncores]]

Si diferents seccions tenen el mateix encapçalament,
numereu-les: [[#Exemple 3]] és la tercer secció
anomenada "Exemple".

Es pot fer que un enllaç porti a un lloc diferent amb un enllaç conduït. Poseu primer la pàgina a enllaçar, després el caràcter de separació "|" i finalment el text a enllaçar.

També podeu utilitzar un enllaç conduït per evitar el text de desambiguació del títol i que l'enllaç sigui més concís.

Es pot fer que un enllaç porti a un lloc diferent
amb un [[Ajuda:Enllaç conduït|enllaç conduït]].
Poseu primer la pàgina a enllaçar, després el caràcter
de separació "|" i finalment el text a enllaçar.

* [[Ajuda:Enllaços|Sintaxi]]
* [[Llista de reis de França#Dinastia Carolíngia|Reis carolingis]]

També podeu utilitzar un enllaç conduït per evitar
el text de desambiguació del títol i que l'enllaç
sigui més concís.

* [[Mercuri (planeta)|]]
* [[Jordi Pujol i Soley|Jordi Pujol]]

Es pot fer un enllaç extern escrivint l'URL: http://www.nupedia.com

Se li pot posar un títol: Nupedia

O deixar el títol en blanc: [1]

L'enllaç extern es pot utilitzar per enllaçar a una pàgina wiki quan no es pugui fer servir l'enllaç de [[pàgina]]: http://ca.wikipedia.org/w/index.php?title=Gat&oldid=6253708#Metabolisme

Es pot fer un enllaç extern escrivint l'URL:
http://www.nupedia.com

Se li pot posar un títol:
[http://www.nupedia.com Nupedia]

O deixar el títol en blanc:
[http://www.nupedia.com]

L'enllaç extern es pot utilitzar per enllaçar a una pàgina wiki 
quan no es pugui fer servir l'enllaç de <nowiki>[[pàgina]]</nowiki>:
http://ca.wikipedia.org/w/index.php?title=Gat&oldid
=6253708#Metabolisme

De la mateixa forma es pot enllaçar a una adreça de correu: mailto:amic@exemple.com o amic

De la mateixa forma es pot enllaçar a una adreça de correu:
mailto:amic@exemple.com o [mailto:amic@exemple.com amic]

Es pot redirigir el lector a una altra pàgina.

#REDIRECT [[Moix]]

Els enllaços a categories no es mostren dins del cos de text sinó al final de la pàgina, i fan que la pàgina es mostri dins de la categoria Afegiu dos punts inicials a la categoria per enllaçar-se dins del text sense provocar que la pàgina s'inclogui a la categoria: Categoria:Ajuda:Guia d'ús

Els [[Ajuda:Categoria|enllaços a categories]] no es 
mostren dins del cos de text sinó al final de la pàgina, 
''i fan que la pàgina es mostri dins de la categoria''
[[Categoria:Ajuda:Guia d'ús]]

Afegiu dos punts inicials a la categoria per 
enllaçar-se dins del text sense provocar que 
la pàgina s'inclogui a la categoria:
[[:Categoria:Ajuda:Guia d'ús]]

Text sense format

[modifica]

Hi ha diferents formats que mostren el text tal com està escrit.

Com es mostra Com s'escriu

L'etiqueta nowiki ignora la ''sintaxi'' [[wiki]]. Interpreta el text traient línies noves i espais múltiples. Interpreta també caràcters especials: →

&lt;nowiki&gt;
L'etiqueta nowiki ignora 
la ''sintaxi'' [[wiki]].
Interpreta el text 
traient
línies noves    i espais
 múltiples.
Interpreta també caràcters
especials: &amp;rarr;
&lt;/nowiki&gt;
L'etiqueta pre ignora la ''sintaxi''
 [[wiki]].
No modifica el     format
 del text.
Però encara interpreta caràcters
especials: →
&lt;pre&gt;
L'etiqueta pre ignora la ''sintaxi''
 [[wiki]].
No modifica el     format
 del text.
Però encara interpreta caràcters
especials: &amp;rarr;
&lt;/pre&gt;

Un espai inicial és una altra forma de mantenir el format.

Posant un espai al 
començament de cada
línia s'evita que el
text sigui modificat.
Però interpreta la
sintaxi wiki i
caràcters especials: →
Un espai inicial és una altra 
forma de mantenir el format.

 Posant un espai al 
 començament de cada
 línia s'evita que el
 text sigui modificat.
 Però interpreta la
 ''sintaxi'' [[wiki]] i
 caràcters especials: &amp;rarr;

Codi font

[modifica]

Si està instal·lada l'extensió per ressaltar la sintaxi, es pot mostrar el codi font d'un llenguatge de programació de forma molt similar a l'etiqueta HTML <syntaxhighlight lang="wikitext">, però no el tipus de ressaltat de sintaxi que es pot trobar en editors de text avançats per a programari.

Aquest és un exemple de com mostrar un codi font en C#:

<nowiki>
<syntaxhighlight lang="csharp">
// Hello World in Microsoft C# ("C-Sharp").

using System;

class HelloWorld
{
    public static int Main(String[] args)
    {
        Console.WriteLine("Hello, World!");
        return 0;
    }
}

</nowiki></syntaxhighlight>

En resulta:

// Hello World in Microsoft C# ("C-Sharp").

using System;

class HelloWorld
{
    public static int Main(String[] args)
    {
        Console.WriteLine("Hello, World!");
        return 0;
    }
}

Imatges, taules, vídeo i so

[modifica]

Aquesta és una breu introducció. Per a més informació, vegeu:

Després de carregar el fitxer, escriviu el seu nom, ressalteu-lo amb el ratolí i cliqueu al botó "Fitxer incrustat" de la barra d'eines d'edició .

Això produirà la sintaxi per incrustar un fitxer: [[Fitxer:Nom.png]]

Com es mostra Com s'escriu

Una imatge amb text alternatiu:

Logotip de la Viquipèdia

La imatge enquadrada amb un peu d'imatge:

Logotip de la Viquipèdia
Una imatge amb text alternatiu:

[[Fitxer:Wiki-ca.png|Logotip de la Viquipèdia]]

La imatge enquadrada amb un peu d'imatge:
[[Fitxer:Wiki-ca.png|frame|Logotip de la Viquipèdia]]

Un enllaç a la pàgina de la imatge:
Fitxer:Wiki-ca.png

O un enllaç directe a la pròpia imatge:
Media:Wiki-ca.png

Un enllaç a la pàgina de la imatge:
[[:Fitxer:Wiki-ca.png]]

O un enllaç directe a la pròpia imatge:
[[Media:Wiki-ca.png]]

Utilitzeu els enllaços media: per enllaçar directament a fitxers de so o vídeo:
Un fitxer de so

Utilitzeu els enllaços '''media:''' per enllaçar 
directament a fitxers de so o vídeo: 
[[media:Classical guitar scale.ogg|Un fitxer de so]]
Proporcioneu un text escoltat amb una plantilla:

cant de la Muixeranga cant de la Muixeranga (pàg.)

Proporcioneu un text escoltat amb una plantilla:
{{audio
 |1=Xavi_Richart_-_Muixeranga_(low_quality).ogg
 |2=cant de la Muixeranga
}}
Això és
una taula
{| border="1" cellspacing="0" cellpadding="5" align="center"
! Això 
! és
|- 
| una
| taula
|}

Galeries

[modifica]

Les imatges també es poden agrupar en galeries utilitzant l'etiqueta <gallery>:

Fórmules matemàtiques

[modifica]

Podeu escriure fórmules matemàtiques amb el format TeX.

Com es mostra Com s'escriu

<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>

Plantilles

[modifica]

Les plantilles són trossos de sintaxi wiki amb el propòsit de ser copiat automàticament ("inclós") dins de pàgines. S'afegeixen posant el nom de la plantilla entre {{claus dobles}}. També és possible incrustar altres pàgines utilitzant {{:dos punts i claus dobles}}.

Algunes plantilles poden tenir paràmetres que se separen amb una barra vertical.

Com es mostra Com s'escriu

Aquest text prové de la pàgina anomenada Plantilla:Mostra d'inclusió. Ha estat inclòs dins d'aquesta pàgina.

{{Mostra d'inclusió}}

Aquest text és una mostra d'inclusió de pàgines que prové de Ajuda:Sintaxi wiki/Mostra d'inclusió per a ser inclòs en una altra pàgina.

{{Ajuda:Sintaxi wiki/Mostra d'inclusió}}

Aquesta plantilla té dos paràmatres, i crea un text subratllat amb una caixa emergent en la majoria de navegadors:

Poseu el ratolí sobre aquest text

Vegeu la pàgina de la pròpia plantilla: Plantilla:Text emergent

Aquesta plantilla té dos paràmatres, i
crea un text subratllat amb una caixa
emergent en la majoria de navegadors:

{{Text emergent|Aquest és el text emergent|
Poseu el ratolí sobre aquest text}}

Vegeu la pàgina de la pròpia plantilla:
[[Plantilla:Text emergent]]