Nombrado de páginas

From Apache OpenOffice Wiki
< ES‎ | AyudaWiki
Revision as of 12:33, 6 October 2012 by Salva (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

El nombrado de las páginas para la wiki es relativamente sencillo, pero es importante que lo haga en el orden correcto para beneficiarte de la extensión personalizada "breadcrumb" que hemos añadido.

Debes leer también la Guia de estilos antes de crear nuevas páginas.

Convenios generales

Cómo crear correctamente una nueva página

La estructura del wiki puede ser muy caotica, por eso los colaboradores deben observar ciertos convenios para manejar el contenido y agregar estructura a ésta. Al crear una nueva página es importante:

  • Que se defina dentro de una subcarpeta (excepto casos especiales)
  • Que se defina una o más categorías
  • Que su URL se mantenga en una longitud moderada
  • Que el título sea especifico al tópico

Definir la subcarpeta a la que pertenece la página

Para situar una página en una subcarpeta, integra el nombre de la subcarpeta en el título de la página. Por ejemplo:

  • Para crear una página en la subcarpeta AyudaWiki nombra la página como ES/AyudaWiki/Mi Pagina
  • Para crear una página en la subcarpeta Calc, situada dentro de la subcarpeta Documentación, nombra la página como ES/Documentacion/Calc/Mi Pagina

Esto permite que al visitar la página se pueda ver que pertenece a la subcarpeta 'Subcarpeta'.

Asignar categorias

Todas las páginas deben estar asignadas al menos a una categoría. La categoría se agrega al pie de la pagina, y nos permite agrupar los contenidos de la wiki. Para asignar una página a una categoría, inserta ésta instrucción al final de la página:

 [[Category:MiCategoria]]

Una pagina puede pertenecer a varias categorias. Inserta una instrucción por cada categoría que deseas asignar a la página:

 [[Category:MiPrimeraCategoria]][[Category:MiSegundaCategoria]][[Category:MiTerceraCategoria]]

Todas las páginas de la wiki en Español deben estar asignadas como mínimo a la categoría ES:

 [[Category:ES]]

Definir un título adecuado

Confiamos en que el editor tiene la creatividad suficiente como para definir titulos que sean suficientemente descriptivos y a la vez, suficientemente cortos. Por ejemplo:

 www.sitio.com/wiki/ES/DiccionarioMedico -- Diccionario de términos medicos
 www.sitio.com/wiki/ES/Localizacion321 -- Localización de la versión 3.2.1

Uso de mayúsculas

Al nombrar una nueva página, se deben usar mayúsculas sólo para la primera letra de la primera palabra y de los nombres propios; es incorrecto nombrar la página con "todo mayúsculas":

  • Correcto: "Un nuevo método de crear rollovers en JavaScript"
  • Incorrecto: "Un Nuevo Método de Crear Rollovers en JavaScript"
  • Incorrecto: "UN NUEVO METODO DE CREAR ROLLOVERS EN JAVASCRIPT"
Estas reglas para las mayúsculas se deben aplicar a las páginas nuevas. Las páginas antiguas que fueron nombradas incorrectamente se corregirán en un futuro

Uso de acentos

Este wiki acepta carácteres especiales incluyendo acentos, diptongos, etc. Sientente libre de insertarlos sin que el título se codifique de forma diferente en alguno de los navegadores.

Uso de listas

Asegúrate de utilizar listas en lugar de tablas siempre cuando sea posible. Ésto facilita el trabajo con la fuente sobretodo cuando el contenido es editado por un grupo de personas.

Uso de formatos de texto

Este wiki tiene soporte para formatos de texto en el lenguaje wiki y tambien en HTML, quiere decir que puedes agregar etiquetas para poder definir tu contenido, inclusive etiquetas como SPAN y DIV asi como metodos como STYLE y otros. Sin embargo se prefiere usar el lenguaje nativo del wiki antes de usar HTML.

Mi artículo sólo necesita una página

Mejor con URLs cortas

Si vas a crear un artículo u otro contenido que sólo requiera una página, crea la página con un nombre corto para que ésta tenga una URL corta. El titulo explicito se le puede asignar más adelante al editar la página.

Por ejemplo, la página para un artículo simple llamado "Acercamiento a los rollovers en JavaScript" sería, simplemente:

[[RolloverJavascript]]

Una vez creada la pagina "RolloverJavascript" se puede añadir la instruccion DISPLAYTITLE:

{{DISPLAYTITLE:Acercamiento a los Rollovers en Javascript}}

Esto hara que se muestre el título largo sin que se extienda innecesariamente la URL.

Evita duplicar títulos

Cuando sea posible, deberás intentar utilizar un título corto para simplificar el nombre de la página lo más posible. Pero no siempre será recomendable.

Por ejemplo, si necesitas añadir una página llamada "Optimización", llamándola simplemente “Optimización", se crearía un posible conflicto ya que “Optimización” se puede aplicar a una gran variedad de temas dentro del wiki. Si mi artículo sobre optimización es específico sobre CSS, es preferible utilizar un título más largo para que sea único (ej: [[Optimización en CSS]]).

Si hay dos o más páginas con el mismo título, se deberá crear una página de desambiguación.

Lo más adecuado es crear páginas con títulos únicos siempre que sea posible.

Mi artículo necesita más de una página

Si el contenido que está añadiendo requiere más de una página, utiliza el siguiente método de nombrado. Este método se beneficia de la extensión breadcrumb.

Observa que se ha creado una página inicial llamada " Aprendiendo JavaScript", y que las demás páginas agregan al título de la principal un subtítulo, separado del título por : (dos puntos). Para que la extensión breadcrumb funcione, cada parte de los nombres separados por dos puntos debe de existir separadamente y debe ser navegable.

Si deseas usar la extensión breadcrumb para navegar jerárquicamente por las páginas, deberás usar el sistema de nombrado con la delimitación de los dos puntos tal y como se menciona aquí.

Personal tools