Nombrado de páginas
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.
Contents
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"
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.
- Aprendiendo JavaScript – Página con la tabla principal de contenido
- Aprendiendo JavaScript:Introducción
- Aprendiendo JavaScript:Perspectiva
- Aprendiendo JavaScript:Scripting más avanzado
- Aprendiendo JavaScript:Pasos siguientes
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í.