Proyecto:Guia de estilo

De Gentoo Linux Wiki

[editar] Introducción

En principio, no tengas miedo de que puedas estropear algo o algún documento que haya por estos lares. Si cometieses un error y vieses por ejemplo que ha desaparecido toda una información que tratabas de modificar o corregir, o que te hayas liados con las claves que debes utilizar para formatear y dar forma a tu documento o al que corriges, ya que si se diese el caso, y te vieses perdido, existe un historial de cambios, en el que o bien tú o cualquier otro usuario más experimentado podrá restaurar sin mucha dificultad a su estado anterior.

Por lo que en principio, no lo dudes mucho, seguro que paseando por aquí ya has visto algo que no debería ser explicado de ese modo y tú sabes como debe ser explicado. Corrígelo YA, segúro que incluso son estas misma líneas que estas leyendo ;-))..... o quizás no ^_^

El principio es escribir. Todo lo que escribas se verá plasmado en el documento que esté creando o modificando. Habrán cosas que te chocarán como que si quieres cambiar de línea simplemente pulsando un retorno de carro, esto no se refleja en el resultado final. Sólo se reflejará cuando se encuentre una línea en blanco. Entonces sí habrá salto de párrafo. También he comprobado que puedes utilizar la etiqueta
por ejemplo:

La lista de acciones:

La primera
La segunda
La tercera

La lista de acciones:

La primera<br>
La segunda<br>
La tercera

</center> O podemos dejar una línea en blanco entre los renglones.

Aunque puedes ver que se utilizan etiquetas html en principio ve olvidandote de ellas, si conoces la codificación html verás que esto dista bastante, e incluso puede hacerte dar muchas vueltas a la cabeza (Mientras no te des de cabezazos todo puede ir bien :)) )

también verás que los espacios en blanco tienes un significado especial si al empezar a escribir dejas un espacio al principio de la línea, veras que

he dejado un espacio en blanco y ...

y si en la línea siguiente volvemos a escribir sin dejar un espacio, resgresamos a la normalidad :))

Si queremos utilizar espacios al principio de la línea utilizarmos ":" que actuará como tabulador, por ejemplo:

:no dejo espacio en blanco pero ...

Todo lo que escribas dejando un espacio al principio, será reflejado en el resultado final del mismo modo que lo escribiste, es decir no sufritá cambios. Si además quieres que no interprete las etiquetas wiki puede utilizar la etiqueta en la disposición del texto, por ejemplo:

probando la teoria del espacio
    me está respetando
    los '''saltos''' de línea
    y la posición

probando la teoria del espacio
    me está respetando
    los <nowiki>'''saltos'''</nowiki> de línea
    y la posición

Ahora si quieres, tenemos un lugar reservado para las prácticas, para que pruebes el funcionamiento del wiki, comprueba tu mismo lo que acabas de ver. Pulsa el siguiente enlace para ir al Lugar de prácticas. Una vez allí verás, igual que en la mayoria de los apartados de las wikis, en la parte superior unas pestañas. Pulsa edit, y entretente comprobando lo que puedes llegar a conseguir.

[editar] Crear tu página

Bien, si tienes pensado escribir un documento y prefieres continuar con una nueba página en lugar de con el Lugar de prácticas, existen dos modos de hacerlo.

• Escribiendo directamente el nombre en la URL por ejemplo http://es.gentoo-wiki.com/mi_nueva_pagina
• o creaando un enlace en una página que edites a tu futura página. Cuando pulses sobre el enlace estarás en ella.

[editar] Estilos para el texto

Antes de hablar de la página veamos un poquitín el formáto que puedes aplicar al texto con un ejemplo. Como antes, en la parte derecha se verá el código que se ha de utilizar para conseguir el resultado que podras ver en la parte izquierda.

Escribiendo en '''negrita''', en ''cursiva'' y
con los '''''dos estilos'''''.

Letras <small>pequeñas</small>
y <big>grandes</big>

Puedes <strike>tacharlas</strike>
y <u>subrayarlas</u>

Tenemos<sup>superindices</sup>
y también<sub>subindices</sub>

Y muchas más que ya iremos descubriendo, con esto los textos se volverán mucho más expresivos.

Ya sabes ... Lugar de prácticas

[editar] Secciones

Las secciones son las que dividirán tu documento en apartados. Si conoces html son las cabebeceras <h2></h2><h3></h3><h4></h4>..., para realizarlas se utiliza el signo igual =, para iniciar tu primera sección lo escribirás a modo de ==Mi primera Sección== que sería lo equivalente en html a <h2>Mi primera sección</h2>.

Dentro de cada sección puede poner subsecciones. es decir secciones dentro de tu sección, que serian los sub apartados de ésta.

Cuando hayas puesto más de una sección en tu página, verás que automáticamente en la parte superior te aparece una tabla de contenido TDC, mostrando toda la estructura de tus secciones.

Me va a ser un poco dificil emular en el ejemplo de a continuación lo que te quiero decir, por lo que, ésto, para comprenderlo es mejor que lo pruebes en el Lugar de prácticas, escribe el código y verás el resultado, por ejemplo ve al Lugar de prácticas y escribe lo siuguiente

==Primer nivel==
===Segundo nivel===
===Segundo nivel===
==Primer nivel==
==Primer nivel==
===Segundo nivel===
====Tercer nivel====
====Tercer nivel====
=====Cuarto nivel=====
==Primer nivel==
==Primer nivel==

Esto seria como tu máqueta, luego irias rellenando las secciones escribiendo el contendio entre ellas es decir

==Primer nivel==
...
contenido de primer nivel
...
===Segundo nivel===
...
contenido
...

Voy a copiar el recuadro que hay en la ayuda en ingles de gentoo-wiki

== New section ==

=== Subsection ===

==== Sub-subsection ====

Como he dicho antes, la mejor forma de comprenderlo es que lo pruebes, así que ya sabes que está a tu disposición el Lugar de prácticas.

[editar] Tablas

La tablas las utilizaremos para encerrar datos en su interior. Y mostrarlo en forma de rejilla,

Para iniciar una tabla emplearemos {| y para terminarla |}, que sería exactamente lo mismo que en html cuando se utiliza las etiquetas <table> y </table>, como en html, si queremos la apartura puede ir acompañada de atributos que modificaran la estructura de la tabla por defecto:

{|border=1
|}

los atributos que podemos utilizar son los mismos que en la etiqueta html.

Para separar una fila de la siguiente utilizaremos |- ésta no hara falta cerrarla y para indicar el principio de una celda utilizaremos |, para iniciar una celda a su lado podemos bajar a la línea siguiente e iniciar otra o utilizar || que el se interpretará como un salto de línea y el simbolo de la línea horizontal. veamos una tabla de 3x2 celdas con marco y sin marco de las dos maneras:

{|
|-
|1x1||1x2||1x3
|-
|2x1||2x2||2x3
|}

{|border=1
|-
|1x1||1x2||1x3
|-
|2x1||2x2||2x3
|}

{|
|-
|1x1
|1x2
|1x3
|-
|2x1
|2x2
|2x3
|}

{|border=1
|-
|1x1
|1x1
|1x1
|-
|2x1
|2x1
|2x1
|}

Al igual que se pueden asignar atributos al crear la tabla etiqueta <table> de html también puede aplicarlo a una fila o a una celda, si lo aplicas a la fila tendrás que dejas un espació despues de |- para las celdas debes poner los atributos sin espació incluyendo una nueva barra tras ello... veamoslo mejor en la practica (si ... mejor que me calle!)

{| align=center border=1
|- bgcolor=blue style="color:#99ffff;"
|una celda||otra celda
|-
|colspan=2|dos celdas juntas
|-
|rowspan=2|otra unión||align=center|una celda
|-
|y ahora qué?
|}

Bien ... pero se me está olvidando algo, se me está olvidando algo ... ahh! sí, ya recuerdo, y es que ... no puedes dejar de visitar la estupenda zona de prácticas que te está esperando ;-))

[editar] Estructuras de texto

Esisten unas estructuras de texto que nos serán muy utiles en nuestros documentos, como son las listas, listas ordenadas, tabuladores, definidores de listas, alineamientos de parrafo, separadores ...

[editar] Alineamientos de parrafo

Hay una etiqueta que posiblemente todos conozcamos, se trata de la etiqueta <center></center> que mostrará el parrafo que hay en su interior centrado.

<center>Este texto se tiene
que ver centrado</center>

Por defecto todos nuestros párrafos se alinearán a la izquierda, si queremos que se alíneen a la derecha tendremos que utilizar etiquetas de estilos, como puedes ver en el ejemplo de a continuación:

<div style="text-align: right;">Este texto
se tiene que ver en la derecha</center>

[editar] Listas

[editar] Listas simples

Para crear listas simples utilizaremos un asterísco, los niveles de esta lista los determinará el número de asterísco que se pongan.

* elemento 1
* elemento 2
** elemento 2.1
** elemento 2.2
* elemento 3

[editar] Listas ordenadas

Para las listas ordenadas utilizaremos la alfombrilla #, y al igual que en las listas simples los niveles vendrán determinados por el número de éstas que pongamos:

# elemento 1
# elemento 2
## elemento 2.1
## elemento 2.2
# elemento 3

[editar] Combinación de listas

Podemos combinar ambos tipos de litas. Respetando el símbolo del nivel anterior:

# elemento 1
# elemento 2
#* elemento 2.1
#* elemento 2.2
# elemento 3

A veces podemos comprobar que si utizamos saltos de línea entre los niveles, la lista pierde el norte, enotoces una solución es utilizar ":" que actuará como tabulador para un nivel.

[editar] Enlaces

Muchas veces necesitaremos hacer referencia a otras páginas para que complementen la información que estamos escribiendo. Para ello utilizaremos enlaces a las paginas a la que queremos hacer referencia.

De entre estos enlaces, tendremos que diferenciar tres tipos.

• Los que enlazan con esta misma wiki (http://es.gentoo-wiki.com)
• los que enlazan con cualquier otro lugar de la red http://gentoo-wiki.com como por ejemplo http://de.gentoo-wiki.com, http://fr.gentoo-wiki.com ...
• y por los enlaces externos a este dominio, por ejemplo http://www.gentoo.org

Vemos como podemos crear cada uno de ellos:

[editar] Enlaces a este sitio

Para enlazarlas loa que haremos es coger el nombre de la página y encerrarlo entre dobles corchetes, y nos aparecería un enlace con el nombre de la pagina a esa pagina, si además queremos que el nombre que se muestre sea el que nosotros escojamos, primero escribiremos el nombre de la página y separado por | y el nombre que escojamos, por ejemplo, para enlazar con el Indice HOWTO podríamos hacer lo siguiente:

[[Index:HOWTO]]

[[Index:HOWTO|Todos los HOWTOs]]

[editar] Enlaces a todo gentoo-wiki.com

Para enlazar con cualquier página que se encuentre dentro de la red gentoo-wiki.com seguiremos el mismo proceso que para las páginas locales pero antes del nombre de la página le indicaremos donde debe buscarlo, añadiendo los dos digitos que indican la lengua en la que está escrita. (Por supuesto debemos conocer el nombre de la páguina con la que queremos enlazar): Actualmente se utilizan los siguiente identificadores para los diferentes idiomas:

en: Inglés, fr: Francés hu:Húngaro nl: Dutch ru: Ruso de: Alemán

Los siguientes también forman parte de la red gentoo-wiki aunque por problemas técnicos ahora no se reconocen en es.gentoo-wiki.com:

he: Hebreo, pt: Portugués, zh: Chino

Estos son también los prefijos utilizados en la url, el nuestro ya sabes cual es

Bien pues sólo añadiríamos el prefijo rodeado de : y al igual que con los enlaces locales podremos poner el nombre que escojamos para el enlace separandolo de la página con | pero, mejor veamoslo con ejmplos, enlazando como antes al indice de HowTos pero esta vez en los diferentes lenguajes:

[[:en:Index:HOWTO|Indice HowTo en Inglés]]

[[:nl:HOWTOs|Indice HowTo en '''Dutch''']]

[[:hu:Index:HOGYAN|Indice HowTo en Ungaro]]

[[:ru:%D0%A0%D0%A3%D0%9A%D0%9E%D0%92%D0%9E%D0%94%D0%A1%D0%A2%D0%92%D0%90_%D0%B8%D0%BD%D0%B4%D0%B5%D0%BA%D1%81|Indice HowTo en Ruso]]

[[:de:HOWTO_Index|Indice HowTo en Alemán]]

[[:fr:HOWTO_Index|Indice HowTo en Francés]]

[editar] Enlaces externos

Los enlaces a páginas externas, son tan sencillos como dejarlos tal y como están. Y si queremos añadirles la descripción los encerraremos entre corchetes y dejaremos un espacio después de la URL, veamoslo con ejemplos:

http://www.gentoo.org/doc/es

[http://www.gentoo.org/doc/es Documentación Gentoo]

[editar] Plantillas

Las plantilla son páginas especiales que contienen una estructura de código wiki que será mostrado cuando los llamemos, para llamar a una plantilla sólo tenemos que encerrar su nombre entre dobles llaves, si la plantilla acepta parámetros, los pondremos después del nombre de la plantilla separandolos con una barra vertical. Por ejemplo:

{{Advertencia|Este es un ejemplo de uso de las plantillas}}

En el menú de la ayuda verás que hay un apartado dedicado a la lista de plantillas.