Registrarse
Home
Foros
Miembros
Calendario
Normas
Ayuda

Foros de usuarios de openSUSE
Retroceder   ForoSUSE > Zona Aforados > Colaboración wiki opensuse


Síguenos en Twitter Suscríbete a nuestras noticias Acompáñanos en Facebook

Tema Cerrado
 
Herramientas Desplegado

CÓMO creación de artículos en la wiki opensuse.org
  #1  
Antiguo 27-sep-2011, 17:40
Avatar de karlggest
karlggest karlggest está desconectado
Moderador
 
Fecha de Ingreso: 07-febrero-2007
Ubicación: Ourense
Versión: Leap 42.3
Mensajes: 8.296
Agradecimientos: 43
Agradecido 1.288 Veces en 950 Mensajes
Poder de Credibilidad: 20
karlggest está en el buen camino
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.
Índice:

1. Sobre la creación de artículos
1.1 Añadiendo imágenes
1.2 Categorizar una página
1.3 Idiomas
1.4 Detalles, detalles...

2. Edición de artículos
3. Usando plantillas


__________________
http://sementedotempo.blogspot.com/

-Si lo creen unos pocos, es un delirio; si son muchos los creyentes, es una religión
Los Siguientes 4 Usuarios Han Dado las Gracias a karlggest Por Este Mensaje:
DiabloRojo (27-sep-2011), Holmes (27-sep-2011), THORNS (09-dic-2011), victorhck (12-oct-2011)
1. Sobre la creación de artículos
  #2  
Antiguo 27-sep-2011, 18:33
Avatar de karlggest
karlggest karlggest está desconectado
Moderador
 
Fecha de Ingreso: 07-febrero-2007
Ubicación: Ourense
Versión: Leap 42.3
Mensajes: 8.296
Agradecimientos: 43
Agradecido 1.288 Veces en 950 Mensajes
Poder de Credibilidad: 20
karlggest está en el buen camino
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".
__________________
http://sementedotempo.blogspot.com/

-Si lo creen unos pocos, es un delirio; si son muchos los creyentes, es una religión
1.1 Añadiendo imágenes
  #3  
Antiguo 27-sep-2011, 23:12
Avatar de karlggest
karlggest karlggest está desconectado
Moderador
 
Fecha de Ingreso: 07-febrero-2007
Ubicación: Ourense
Versión: Leap 42.3
Mensajes: 8.296
Agradecimientos: 43
Agradecido 1.288 Veces en 950 Mensajes
Poder de Credibilidad: 20
karlggest está en el buen camino
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.
__________________
http://sementedotempo.blogspot.com/

-Si lo creen unos pocos, es un delirio; si son muchos los creyentes, es una religión
El Siguiente Usuario Ha Dado las Gracias a karlggest Por Este Mensaje:
arag (04-oct-2011)
1.2 Categorizar una página
  #4  
Antiguo 27-sep-2011, 23:42
Avatar de karlggest
karlggest karlggest está desconectado
Moderador
 
Fecha de Ingreso: 07-febrero-2007
Ubicación: Ourense
Versión: Leap 42.3
Mensajes: 8.296
Agradecimientos: 43
Agradecido 1.288 Veces en 950 Mensajes
Poder de Credibilidad: 20
karlggest está en el buen camino
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".
__________________
http://sementedotempo.blogspot.com/

-Si lo creen unos pocos, es un delirio; si son muchos los creyentes, es una religión
1.3 Idiomas
  #5  
Antiguo 27-sep-2011, 23:51
Avatar de karlggest
karlggest karlggest está desconectado
Moderador
 
Fecha de Ingreso: 07-febrero-2007
Ubicación: Ourense
Versión: Leap 42.3
Mensajes: 8.296
Agradecimientos: 43
Agradecido 1.288 Veces en 950 Mensajes
Poder de Credibilidad: 20
karlggest está en el buen camino
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.
__________________
http://sementedotempo.blogspot.com/

-Si lo creen unos pocos, es un delirio; si son muchos los creyentes, es una religión
1.4 Detalles, detalles
  #6  
Antiguo 28-sep-2011, 00:06
Avatar de karlggest
karlggest karlggest está desconectado
Moderador
 
Fecha de Ingreso: 07-febrero-2007
Ubicación: Ourense
Versión: Leap 42.3
Mensajes: 8.296
Agradecimientos: 43
Agradecido 1.288 Veces en 950 Mensajes
Poder de Credibilidad: 20
karlggest está en el buen camino
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!).
__________________
http://sementedotempo.blogspot.com/

-Si lo creen unos pocos, es un delirio; si son muchos los creyentes, es una religión
2. Edición de artículos
  #7  
Antiguo 10-oct-2011, 21:36
Avatar de karlggest
karlggest karlggest está desconectado
Moderador
 
Fecha de Ingreso: 07-febrero-2007
Ubicación: Ourense
Versión: Leap 42.3
Mensajes: 8.296
Agradecimientos: 43
Agradecido 1.288 Veces en 950 Mensajes
Poder de Credibilidad: 20
karlggest está en el buen camino
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]
__________________
http://sementedotempo.blogspot.com/

-Si lo creen unos pocos, es un delirio; si son muchos los creyentes, es una religión
3. Usando plantillas
  #8  
Antiguo 20-oct-2011, 19:25
Avatar de karlggest
karlggest karlggest está desconectado
Moderador
 
Fecha de Ingreso: 07-febrero-2007
Ubicación: Ourense
Versión: Leap 42.3
Mensajes: 8.296
Agradecimientos: 43
Agradecido 1.288 Veces en 950 Mensajes
Poder de Credibilidad: 20
karlggest está en el buen camino
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
__________________
http://sementedotempo.blogspot.com/

-Si lo creen unos pocos, es un delirio; si son muchos los creyentes, es una religión
Tema Cerrado

Marcadores


(0 miembros y 1 visitantes)
 
Herramientas
Desplegado

Normas de Publicación
No puedes crear nuevos temas
No puedes responder mensajes
No puedes subir archivos adjuntos
No puedes editar tus mensajes

Los Códigos BB están Activado
Las Caritas están Activado
[IMG] está Activado
El Código HTML está Desactivado

Ir al Foro

Temas Similares
Tema Autor Foro Respuestas Último mensaje
Hola!!!! Busco AUTORES de los artículos sobre SuSE!!!!!!!!!! Kaska___ General OpenSUSE 1 28-nov-2006 22:35
como jugar con suse goundzchecky FAQs, Manuales y Tutoriales 4 23-may-2006 12:19
Como piensan las Administraciones Publicas y grandes corporaciones ZorroPlateado El Contubernio 2 02-abr-2006 12:50
Pregunta medio tonta, script, como? leonedo Software 7 07-mar-2006 09:47
como configurar una ATI en SUSE 9.2 (mini "how to") yakko FAQs, Manuales y Tutoriales 1 21-abr-2005 16:52



Síguenos en Twitter Suscríbete a nuestras noticias Acompáñanos en Facebook


La franja horaria es GMT +2. Ahora son las 23:46.
Powered by vBulletin™
Copyright © vBulletin Solutions, Inc. All rights reserved.

Esta página está bajo una licencia de Creative Commons, salvo que no se indique lo contrario.
Creative Commons License

Valid CSS!

Diseño por:Designed by: vbdesigns.devbdesigns.de 
Contáctenos - ForoSUSE - Archivo - Declaración de Privacidad - Arriba