From Fedora Project Wiki
Line 11: Line 11:
  
 
== Nombrando páginas ==
 
== Nombrando páginas ==
The current naming convention is to largely abandon the heavily nested page names that were inherited from MoinMoin. While this is not meant to supplant the [[Example_wiki_structure | standard for page naming] a simple statement of the rule is that if it is end user documention there should be no nesting. If the page is documentation specific to a sub-project it should contain no more than one level of nesting. The final guidance is that page names should be more natural language like. Thus this page is Example wiki page and not ExampleWikiPage. This provides better search capabilities.
+
La convención de la nomenclatura actual es en gran medida abandonar los nombres de páginas fuertemente anidadas que fueron heredados de MoinMoin. Mientras que esto no pretende suplantar el [[Example_wiki_structure | estándar para asignar nombres de página]] a una simple declaración de reglas, si es que se trata de documentación del usuario final no debe haber anidación. Si la página es documentación específica de un subproyecto debe contener no más de un nivel de anidamiento. La orientación final es que los nombres de páginas deben tener un lenguaje más natural. Por lo tanto esta página es la Página wiki de ejemplo y no PáginaWikiEjemplo. Esto proporciona mejores capacidades de búsqueda.
  
 
== Enlaces ==
 
== Enlaces ==

Revision as of 14:49, 10 December 2012

DocsProject Header docTeam1.png
Warning.png
Esta página es sólo un proyecto
Todavía está en construcción y el contenido podría cambiar. No confíe en la información de esta página.


Warning.png
Esta es una página que describe las políticas del proyecto Fedora.
Para las páginas de políticas, la precisión y la claridad son importantes. Le animamos a editar el wiki para mejorarlo. Si tiene algún cambio sustancial que hacer a esta página, utilice la página de discusión para discutir los cambios con otros mantenedores de la página. Haga esto antes de hacer los cambios.


Introducción

Esta página no pretende ser una guía de estilo, sino más bien una guía que indica cuáles son los elementos técnicos necesarios para que una página wiki sea considerada completa desde el punto de vista del paisaje wiki.

Esta página no es para enseñar a Cómo realizar el formato wiki, ni los especiales lineamientos de formato del wiki de Fedora.

Nombrando páginas

La convención de la nomenclatura actual es en gran medida abandonar los nombres de páginas fuertemente anidadas que fueron heredados de MoinMoin. Mientras que esto no pretende suplantar el estándar para asignar nombres de página a una simple declaración de reglas, si es que se trata de documentación del usuario final no debe haber anidación. Si la página es documentación específica de un subproyecto debe contener no más de un nivel de anidamiento. La orientación final es que los nombres de páginas deben tener un lenguaje más natural. Por lo tanto esta página es la Página wiki de ejemplo y no PáginaWikiEjemplo. Esto proporciona mejores capacidades de búsqueda.

Enlaces

Los enlaces a la wiki del Proyecto Fedora siempre deben ser enlaces internos, y no enlaces externos.

Tamaño

Generalmente, usted debe considerar dividir un documento en varias páginas si el tamaño del documento supera los 32 KB. Este no es un límite absoluto sino más bien un elemento a tener en cuenta.

Títulos

If a header exists for a given project that a page belongs to it should be included in the documents.

Subtítulos

You should subdivide your content with headings. Mediawiki automatically will create table of contents. Using headers also permits you to link directly to sections of a page.

No tenga miedo a los subtítulos ...

Subdividir el contenido incluye organizarlo internamente con más profundidad de anidación.

... pero trate de no ir más allá que estos

If you find yourself getting deeper than four-levels of nesting, you are at risk of making a confusing mess for your readers.


Includes

Do not repeat content from another page manually. That creates additional work to edit and change. Using includes permits changes to occur in one place and be updated everywhere it is used.

This content is actually included from a separate page, Example wiki page include.

Categorías

Cada página debe tener al menos una categoría, y será una página rara la que tenga sólo una categoría. En nuestra implementación actual las Categorías son los espacios de orientación para el wiki. Puede encontrar una lista de todas las categorías aquí.