Ajuda:Sintaxi wiki
Aquesta pàgina és la traducció corresponent de m:Help:Wikitext examples (en anglès). Si cal fer modificacions, considereu abans fer-les en la pàgina original, ja que es podrien perdre en una propera actualització. |
- 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 (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 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
|
Posar text en una <tt>font mecanogràfica</tt>.
Generalment s'utilitza la mateixa font per
<code>codi de programari</code>.
|
|
<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
|
|
<center>Text centrat</center>
|
|
<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ó menorNo 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.
|
marca el final de la llista.
|
* 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.
|
Una línia nova marca el final de la llista.
|
# 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:
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
*# i incrustar-les
*# dins d'altres
*#* o trencar línies<br>en llistes.
*#; les llistes de definició
*#: també es
*#:; poden : incrustar
|
Una línia nova comença un nou paràgraf.
|
: 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.
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: → |
<nowiki>
L'etiqueta nowiki ignora
la ''sintaxi'' [[wiki]].
Interpreta el text
traient
línies noves i espais
múltiples.
Interpreta també caràcters
especials: &rarr;
</nowiki>
|
L'etiqueta pre ignora la ''sintaxi''
[[wiki]].
No modifica el format
del text.
Però encara interpreta caràcters
especials: →
|
<pre>
L'etiqueta pre ignora la ''sintaxi''
[[wiki]].
No modifica el format
del text.
Però encara interpreta caràcters
especials: &rarr;
</pre>
|
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: &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:
- Ajuda:Carregar un fitxer, per com carregar un fitxer;
- Ajuda:Ús d'imatges, per com posar imatges en una pàgina;
- Ajuda:Taula, per com crear una taula.
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: La imatge enquadrada amb un peu d'imatge: |
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: O un enllaç directe a la pròpia imatge: |
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: |
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: | Proporcioneu un text escoltat amb una plantilla:
{{audio
|1=Xavi_Richart_-_Muixeranga_(low_quality).ogg
|2=cant de la Muixeranga
}}
| ||||
|
{| 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>
:
-
Peu d'imatge
-
S'hi poden afegir enllaços.
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]]
|