Gracias Gracias:  0
Me Gusta Me Gusta:  0
No me Gusta No me Gusta:  0
Mostrando resultados del 1 al 8 de 8

Tema: CÓMO creación de artículos en la wiki opensuse.org

  1. #1
    Fecha de Ingreso
    07-febrero-2007
    Ubicación
    Ourense
    Mensajes
    8.666
    Post Thanks / Like
    Poder de Credibilidad
    22

    CÓMO creación de artículos en la wiki opensuse.org

    En el presente documento voy a tratar brevemente cómo realizar documentos en la wiki oficial de opensuse, centrándome en el caso particular de la traducción de documentos de la versión inglesa.

    Los comentarios, críticas, correcciones y sugerencias, aquí.

    Antes de comenzar, es buena idea echarle un vistazo a la documentación de la propia wiki:

    * Cómo participar
    * Tareas

    y los más importantes:

    * Guía de estilo
    * Ayuda

    Asumiré que has leído al menos estos dos últimos.

  2. #2
    Fecha de Ingreso
    07-febrero-2007
    Ubicación
    Ourense
    Mensajes
    8.666
    Post Thanks / Like
    Poder de Credibilidad
    22

    1. Sobre la creación de artículos

    En esta sección trataré de ilustrar con un ejemplo sencillo cómo se puede crear una nueva página. Como he dicho en la introducción, me centraré en la traducción de artículos, aunque lo que se dice aquí, por supuesto, sirve para la nueva creación de artículos.

    En el resto del presente artículo necesitaréis disponer de cuenta en la web de Novell o en la de openSUSE para poder trabajar sobre el wiki.

    En primer lugar, debemos saber qué artículo queremos crear/traducir. Entre las "páginas especiales" de las que hablaremos posteriormente, podemos encontrar "Páginas requeridas"[1]

    Como no puede ser de otra forma, trataré de encontrar un artículo relativamente pequeño en inglés para facilitar el seguimiento de esta sección. Viendo la lista, voy a seleccionar la página del escritorio XFCE.

    La parte de editar el texto es sencilla y cada uno puede usar la técnica que prefiera: editar directamente en el cuadro de edición de la página, crear el documento en vi, LibreOffice... yo, en aras de simplificar, voy a tomar el código del artículo en inglés y lo voy a pegar en el cuadro de edición de la página en español. Para ello, accedo al artículo en inglés y pulso "edit": selecciono todo el texto en inglés y lo pego en el cuadro de edición de la página española.

    Hecho esto, voy a eliminar las primeras líneas:

    * __NOTOC__ es una orden que hace que la wiki no cree una tabla de contenidos.
    * El cuadro de información (infobox) no tiene la plantilla correspondiente en español. De todas formas, hay un artículo por ahí que usa esa plantilla, así que podríamos dejar el cuadro a la espera de que alguien la crease...

    También voy a reducir el nivel de títulos; no sé qué hacen otras páginas similares, pero en la Guía de estilo se establece claramente que la primera sección debe tener nivel 1 (un =).

    Comienzo una traducción literal del texto. Luego habrá que corregir algún enlace, categorizar la página y añadir las entradas para las distintas versiones idiomáticas. Sin olvidar subir a la web las imágenes correspondientes!

    ... en construcción ...

    [1] Al parecer, cuando una página que no existe se referencia en más de un lugar, se añade a esta "categoría".

  3. #3
    Fecha de Ingreso
    07-febrero-2007
    Ubicación
    Ourense
    Mensajes
    8.666
    Post Thanks / Like
    Poder de Credibilidad
    22

    1.1 Añadiendo imágenes

    Desconozco cómo "reutilizar" imágenes de la wiki inglesa[1] en la española, si acaso es posible. Así que utilizaré el procedimiento estándar.

    1. Guardo en el disco las imágenes de la wiki inglesa.
    2. Subo de una en una cada imagen. En la columna de la izquierda, entre otras opciones podemos ver una que es "subir páginas". Pulsamos ahí y nos lleva a una página para esta tarea, en la que vemos dos partes diferenciadas:

    * Archivo fuente, donde ponemos la ruta al archivo que queremos subir.
    * Descripción del archivo, que nos permite darle el nombre que tendrá ese archivo en la wiki y añadir una descripción del mismo. Como dice en la ayuda, pon nombres descriptivos

    El código para añadir una imagen en nuestro artículo es
    Código:
    [[Archivo:Nombre_del_Archivo]]
    , donde Nombre_del_Archivo es el especificado en la Descripción.

    En la página "subir archivo" se nos indica que existen estas tres posibilidades:
    • [[Archivo:File.jpg]] para usar el fichero en tamaño completo
    • [[Archivo:File.png|200px|thumb|left|texto descriptivo]] para una versión de 200 pixeles de ancho en una caja en el margen izquierdo con 'texto descriptivo' como descripción
    • [[Media:File.ogg]] para enlazar directamente al fichero sin mostrarlo.

    También existe un elemento denominado "galería" (con el código
    Código:
    <gallery>
    Archivo:primer_elto|Primer elemento de la galería
    Archivo:segundo_elto|Segundo elemento de la galería
    </gallery>
    que permite listar varias imágenes en el formato adecuado para estas pequeñas "previsualizaciones", siendo necesario únicamente especificar el archivo a insertar y el texto descriptivo que irá debajo; por ejemplo, la primera imagen tiene el código:
    Código:
    Archivo:OS11.2-xfce-1.png|Menú de Xfce

    [1] Para añadir archivos de la propia wiki, basta con usar su URL.

  4. #4
    Fecha de Ingreso
    07-febrero-2007
    Ubicación
    Ourense
    Mensajes
    8.666
    Post Thanks / Like
    Poder de Credibilidad
    22

    1.2 Categorizar una página

    Considero oportuno subrayar siempre que una wiki bien hecha tiene que estar bien categorizada. Esto es, tiene que haber una división bien establecida de "categorías" de páginas, que deben naturalmente contener todas las páginas respectivas. La wiki hace uso de una página especial llamada "Category". Dicha página consta de un texto descriptivo y de una clasificación alfabética de las páginas que se incluyen en tal categoría. Eventualmente, una categoría puede contener otras subcategorías, que también se listarían en la página.

    El código correspondiente para incluir una página en una categoría es
    Código:
    [[Category:LaQueSea]]
    , y una misma página puede estar incluida en varias categorías distintas, e incluso en distintas subcategorías.

    El motor del wiki interpreta ese código e incluye esa página en las categorías especificadas.

    En el caso que nos ocupa, la página de Xfce, podemos compararla con otras entradas: digamos que tiene cierto sentido que Xfce tenga la misma categoría que otros escritorios. En el caso de KDE y de GNOME, veo que cada uno tiene su propia categoría. Podemos intentar echar un vistazo a páginas de la versión inglesa, pero EMHO no nos sacan de dudas.

    Podemos intentar reflexionar sobre esta cuestión y si acaso dejar una nota (comentarios entre <!-- y -->) para que otro pueda corregir o mejorar lo que hagamos. En mi caso, la reflexión lleva el siguiente camino:

    * Existe al menos otra página (aunque no creada aún) sobre la misma cuestión: y es que, en línea con lo hecho en la versión inglesa, entre los enlaces "ver más" he dejado una entrada para crear una respecto al equipo de desarrollo de Xfce. Esto sólo ya justificaría una categoría propia. Y más si en el futuro próximo alguien añade artículos sobre su instalación, configuración, etc.
    * Xfce es un "entorno gráfico", de igual forma que KDE, GNOME y otros. Posiblemente sea interesante una categoría "entorno gráfico", aunque esto simplemente traslada la cuestión a dónde ubicar esta nueva categoría.

    Pero también podemos retomar la idea de la wiki inglesa, aprovechando que ya tenemos la página "Conceptos Básicos"... en un primer momento voy a tener una subcategoría "interfaz gráfica" dentro de la categoría "Conceptos"; a su vez, Interfaz gráfica contiene una subcategoría "Entornos gráficos de escritorio", que es un nombre un poco redundante xd, que es donde está el artículo Xfce.

    En la versión inglesa usan dos cosas abundantemente: los portales y las SBD (Support DataBase). Una SDB que tienen muy interesante es la de "guías para principiantes".

  5. #5
    Fecha de Ingreso
    07-febrero-2007
    Ubicación
    Ourense
    Mensajes
    8.666
    Post Thanks / Like
    Poder de Credibilidad
    22

    1.3 Idiomas

    Entre las opciones de la columna izquierda figura una lista de idiomas en la que está disponible la página actual. Uno de los objetivos de esta lista es permitir el fácil acceso a otra versión en otro idioma, por ejemplo porque es más cómodo para el usuario o porque se quiera confrontar con la otra versión[1].

    Para añadir el enlace a una versión en otro idioma, sólo se necesita indicar el código de dos letras correspondiente al idioma, seguida de dos puntos y el nombre (en ese idioma) de dicha página. Por ejemplo, en el artículo de Xfce añadimos
    Código:
    [[en:Xfce]]
    .

    Lo suyo es, a continuación de crear la versión en castellano, ir a las diversas versiones y añadir el enlace para la española:
    Código:
    [[es:Xfce]]
    : en la inglesa, francesa, italiana y en las que existan.

    [1] Yo con frecuencia hago eso en la wikipedia: si bien para mí es mucho más cómodo usar el castellano, los artículos de la wikipedia inglesa en promedio son mucho mejores y más completos.

  6. #6
    Fecha de Ingreso
    07-febrero-2007
    Ubicación
    Ourense
    Mensajes
    8.666
    Post Thanks / Like
    Poder de Credibilidad
    22

    1.4 Detalles, detalles

    Ahora tocan los pequeños detalles. Por ejemplo, el primer párrafo voy a meterlo en un cuadro de información como el que se emplean en otros artículos (Intro-frame), con el código:
    Código:
    {{Intro-frame|Texto que constituye la introducción en el artículo.}}
    y lo voy a desplazar al principio de la página.

    También, como no, corrijo algunos errores (y los que han de quedar, y eso que es un artículo pequeñito!).

  7. #7
    Fecha de Ingreso
    07-febrero-2007
    Ubicación
    Ourense
    Mensajes
    8.666
    Post Thanks / Like
    Poder de Credibilidad
    22

    2. Edición de artículos

    En la sección anterior presentamos la edición o creación de un artículo en la wiki de opensuse.org. Ahora trataremos de desgranar los aspactos generales de la edición de cualquier página.

    Uso de enlaces.

    El lenguaje de la wiki trata de forma diferente a los enlaces a páginas que estén en el mismo wiki, respecto a enlaces "externos" (a cualquier lugar fuera del wiki). Para mediawiki, un enlace es el contenido entre dos parejas de corchetes:
    Código:
    [[página del wiki]]
    En la página veríamos el texto "página del wiki" marcado como un enlace; generalmente, veremos el enlace de color azul si se corresponde a una página existente en el wiki y de color rojo si no hay una página en el wiki con ese nombre. Como hemos comentado en la sección anterior, si pulsas un enlace de una página que no existe, mediawiki presentará un cuadro de edición para que creemos texto para dicha página: es preciso puntualizar que para que exista página es preciso que haya algún texto en la misma. Esto es un matiz sutil para páginas especiales, como las categorías: si abres una página correspondiente a una categoría que no contiene texto, mediawiki indexará las páginas que estén dentro de esa categoría, pero el wiki advertirá de que esa página "todavía no existe".

    Los enlaces permiten ciertas variaciones: por ejemplo, una raya vertical separa el nombre de la página a la que corresponde tal enlace del texto que queremos que sea visible para dicho enlace. Por ejemplo:
    [code]
    [[página3|Página sobre fuentes]] mostrará el texto "Página sobre fuentes" marcado como enlace a una página llamada "página3". En HTML, esto sería algo como
    Código:
    <a href="página3">Página sobre fuentes</a>
    Hay enlaces "especiales". De las Categorías ya hemos hablado: en realidad sólo son páginas especiales que contienen el nombre de las páginas que se incluyen en dicha categoría. Un enlace a una Categoría "software" es algo de la forma:
    Código:
    [[category: software]]
    Todas las páginas que contengan este enlace se mostrarán en el índice de la página correspondiente.

    Los idiomas en los que está disponible la página son un tipo de enlace más sutil: generalmente mediawiki los muestra en columna a la izquierda, al margen de la página. El código para añadir el idioma inglés a una página llamada "computador" (computer, en inglés) sería algo como:
    [[en:computer]]

    Los enlaces externos simplemente llevan un par de corchetes
    Código:
    [http://página.com/]
    Si lo que se desea es poner un texto diferente al de la dirección http, basta con añadirlo a continuación:
    Código:
    [http://pagina.com/ texto a mostrar]

  8. #8
    Fecha de Ingreso
    07-febrero-2007
    Ubicación
    Ourense
    Mensajes
    8.666
    Post Thanks / Like
    Poder de Credibilidad
    22

    3. Usando plantillas

    Las plantillas son una herramienta que facilita mantener la coherencia entre los distintos artículos, y simplificar en parte algunas tareas repetitivas. Su uso es sencillo: basta con añadir su nombre entre dobles llaves, seguido de la información que sea precisa para la plantilla. Su formato general es
    Código:
    {{Plantilla}}
    Por ejemplo, lo siguiente añade un cuadro de información (con un borde a la derecha):
    Código:
    {{Info|Texto informativo}}
    Las plantillas pueden anidarse unas dentro de otras. De hecho, algunas plantillas (por ejemplo, la plantilla para portales) consisten en varias plantillas.

    Por otra parte, podemos usar variables. Por ejemplo, la caja de información "Infobox" tiene el siguiente formato:
    Código:
    {{Infobox |  
    |name= | 
    |packagename= | 
    |developer= | 
    |image= | 
    |description= | 
    |vendor= | 
    |license= | 
    |website= | }}
    Por ejemplo, si damos un nombre "Firefox" con el nombre de paquete "firefox" y una descripción "Navegador web de Mozilla", mediawiki creará un cuadro con esos datos:
    Código:
    {{Infobox | 
    |name=Firefox |
    |packagename=firefox |
    |developer= |
    |image= [[Archivo:firefox.png|thumb]]|
    |description=Navegador web |
    |vendor= |
    |license= |
    |website= |
    }}
    En este caso, la propia plantilla tiene información para añadir enlaces para usar el buscador de paquetes de la web para buscar el paquete correspondiente.

    En cuanto a las plantillas de artículos completos, es necesario copiar el código de la plantilla salvo las últimas líneas que son de aplicación sólo para la plantilla:
    Código:
    <noinclude>
    ----
    {{{{FULLPAGENAME}}/doc}}
    [[Category:Plantillas de artículo]]
    </noinclude>
    Estas líneas se añaden a las plantillas para documentar su funcionamiento. Por ejemplo, en Intro-frame hay un par de línas sobre su uso, describiendo cómo usarlo y en qué parte de la página va situado. Tal documentación se guarda en Intro-frame/doc.

    En el caso mencionado de las plantillas de artículos, al copiar el código de la propia plantilla, se incluye el código para generar esta "subpágina", lo cual es superfluo en el nuevo artículo. Por ahora desconozco cómo generar una plantilla de artículo que pueda ser usada directamente con sólo añadir {{nombre_plantilla}}.

    En "Páginas Especiales -> Plantillas" se listan las plantillas disponibles en la wiki en castellano. Trataré de listar algunas de ellas:

    • Caja-encabezado: crea una caja con el texto de encabezado que se indique a continuación.
    • Caja-pie de pagina: permite añadir un texto en el pie de una página (abajo a la derecha). Si no hay una caja preexistente, sitúa el texto a la derecha.
    • CajaInfo: traducción de Infobox, aunque ésta está documentada. Permite crear un cuadro con imagen e información básica sobre una aplicación o paquete comunitario.
    • Infobox NC: variación de Infobox para adaptar el cuadro para software no comunitario y, por tanto, sin repositorios oficiales.
    • Eliminar: permite "marcar" para eliminación una página, ya que ésta es una tarea administrativa que requiere privilegios.
    • En proceso
    • En revisión: ambas simplemente añaden iconos para que al ver la página el lector advierta tal circunstancia.
    • Plantilla:Estado de la traducción: en realidad redirige a la versión inglesa. Tal vez nos interese traducir eso y usarlo -o no
    • Info: define un cuadro con borde a la izquierda para resaltar texto informativo.
    • Advertencia: coloca un icono, un texto "advertencia" sobre fondo rojo y el texto de advertencia que sea.
    • Intro
    • Intro-frame: definen cuadros para texto introductorio.
    • Navbar: permite crear un cuadro de navegación horizontal, tal que la página actual es una de las de la lista, y el título el nombre que agrupe a tal lista. Véase http://es.opensuse.org/Categor%C3%AD...iguraci%C3%B3n
    • Note: para añadir notas.
    • Obsoleto: para "marcar" el artículo como "obsoleto".
    • ProbadoEn: (aunque siga el "camelcase" xd) permite marcar que un artículo ha sido verificado en las distribuciones indicadas.
    • Apunta aquí: caja informativa para usar con iconos en lugar de viñetas.
    • SDB:Navbar: versión de Navbar para ser utilizada en artículos del SDB.
    • Shell: aunque no lo estamos utilizando, permite poner un recuadro a texto sin formato correspondiente a comandos y similar.
    • Índice alfabético: para generar índices alfabéticos en páginas como Siglas, Vocabulario y similares.

    Las plantillas que he traducido para crear artículos están en http://es.opensuse.org/Categor%C3%AD..._art%C3%ADculo

Thread Information

Users Browsing this Thread

There are currently 1 users browsing this thread. (0 members and 1 guests)

Temas Similares

  1. Respuestas: 1
    Último mensaje: 28-nov-2006, 22:35
  2. como jugar con suse
    By goundzchecky in forum FAQs, Manuales y Tutoriales
    Respuestas: 4
    Último mensaje: 23-may-2006, 11:19
  3. Respuestas: 2
    Último mensaje: 02-abr-2006, 11:50
  4. Pregunta medio tonta, script, como?
    By leonedo in forum Software
    Respuestas: 7
    Último mensaje: 07-mar-2006, 09:47
  5. como configurar una ATI en SUSE 9.2 (mini "how to")
    By yakko in forum FAQs, Manuales y Tutoriales
    Respuestas: 1
    Último mensaje: 21-abr-2005, 15:52

Marcadores

Normas de Publicación

  • No puedes crear nuevos temas
  • No puedes responder mensajes
  • No puedes subir archivos adjuntos
  • No puedes editar tus mensajes
  •