Subscribe to News
Help:Contenidos
From TechnologicalWiki
< English Version - Versión Ingles >
¿ Por qué debería de contribuir con thewiki4opentech ?
Este sitio tiene como objetivo ser un referente en tecnologias de contenidos abiertos.
¿ Quién añade contenidos ?
Los contenidos son añadidos por experimentados grupos de trabajo de empresa y gente anónima Ellos tienen la libertad de añadir :
- Proyectos gestionados.
- Tutoriales de cómo hacer algo concreto ( configuración de sistemas, creación de scripts, desarrollo de pequeñas aplicaciones, ... )
- Articulos acerca de alguna tecnología que este siendo estudiada.
Pienso que puedo contribuir, pero no estoy seguro de si mis contenidos son apropiados para este lugar
No te preocupes. Si estos contenidos se refieren a asuntos relacionados con tecnologías abiertas : scripts, pequeños programas, información acerca de las nuevas tecnologías, eventos y noticias de la comunidad de software libre, ... , puedes incluirlos en la wiki. Tu deberias ser respetuoso en tus contenidos y no usar lenguaje malsonante. Además, tu deberias seguir las reglas básicas de edición.
¿ Por qué es interesante para mi, el contribuir con la wiki tecnológica ?
Queremos promover la creación de artículos, así, cuando un usuario crea un artículo, su apodo (user), es mostrado en la cabecera, y todo el mundo puede acceder a la pagina del autor haciendo clic sobre el apodo. Un usuario puede escribir acerca de lo que él quiera en su página ( con educación, por supuesto ).
¿ Qué formato debería usar para escribir los artículos ?
Esta plataforma está basada en Mediawiki Software así que la sintaxis es similar a Wikipedia (basada en Mediawiki). Si tienes alguna duda, prueba a leer estos enlaces :
Esta wiki añade nuevas funcionalidades, así que usa nueva sintaxis. Para saber más acerca de la sintaxis, por favor leete la página completa.
¿ Por qué deberia crear un usuario ?
Cuando creas o modificas un articulo, estas contribuyendo a la comunidad. En ese momento tu puntuación aumenta. Así, otros usuarios pueden conocerme y visitar tu pagina personal en la wiki. Cada usuario tiene una con su nombre.
Cómo crear un usuario
Haz click sobre "log in / create account" , localizado en la esquina superior derecha. Ahora clickea en "create an account". Rellena cada campo y haz click en el botón. Por favor, inserta una cuenta de correo valida. Esta es la única manera de recuperar tu contraseña en caso de olvidarla. Si quieres protejer un projecto, puedes hacer una petición a través de esa cuenta.
Establece tus preferencias de navegación
Cuando hayas creado una cuenta de usuario, puedes establecer algunas preferencias para navegar haciendo click en my_preferences (en la parte superior de la pantalla) :
- User profile :Cambia tus datos personales. ( Para recibir alguna notificación por email, debes de confirmar tu cuenta en esta sección).
- Skins : Para seleccionar tu Skin para la Wiki( defecto ).
- Files : Imagenes en articulos.
- Date and time : Formato.
- Editing : Preferencias para edición.
- Recent changes : Establece preferencias para Recent changes.
- Watchlist : Preferencias para tu Watchlist.
- Search : Establece las preferencias de busqued por defecto para tu usuario.
- Misc : Establece el formato de la salida.
The Watchlist
Watchlist es una lista de paginas que tu estas "vigilando". Cuando tu estas viendo un articulo, una pestaña watch aparece encima con las otras pestañas. Puedes activar/desactivar esta funcionalidad para el articulo en cuestión, haciendo click en la pestaña. Cuando estas "vigilando" una página, puedes obtener información de manera asíncrona de sucesos en la Wiki. Cuando alguien hace un cambio en el articulo "vigilada", recibirás un correo de alerta. Puedes configurarlo en your preferences (User Profile / Watchlist).
¿ Cómo crear un Artículo ?
Mira primero la sección ¿ Por que debería crear un usuario ?.
Hay algunos pasos que deben ser seguidos por el usuario cuando crea un artículo para obtener un correcto funcionamiento de la Wiki.
2- Escribe la categoria / categorias a las cuales pertenece el artículo.
Cada artículo debe pertenecer al menos a alguna de las categorías de las siguientes:
- Project ( Página Principal del projecto ) - asignada automáticamente al crear un proyecto.
- ProjectSection ( Section Project ) - asignada automáticamente al crear un proyecto.
- OpenSource ( Contenido Open Source )
- Mobile ( referente a tecnologías móviles )
- HowTo ( ¿ Cómo hacer ... ? )
- UnifiedCommunications ( Linea de Comunicaciones Unificadas )
- OSAmI ( Proyecto OSAmI-Commons )
Cuando se salva un artículo, una plantilla (Article) se incluye automáticamente en el cuerpo del artículo.
Esta plantilla tiene un parametro : "description" que es un pequeño resumen acerca del artículo.
Puedes modificar este valor para cambiar el contenido del resumen.
{{Article | description=__NOTOC__
...... Contenido del resumen ......
}}
¿ Cómo insertar un video en un Artículo ?
Se pueden mostar videos subidos a la plataforma de YouTube dentro de un artículo. Lo que debes hacer es :
<youtube>ID_del_video_en_YouTube</youtube>
un ejemplo :
<youtube>ZN_yU0e96GA</youtube>
¿ Cómo crear un Artículo en formato reStructured ?
Puedes introducir código en formato rst usando la siguente etiqueta :
<rst>...</rst>
Así, puedes documentar más facil si estas acostumbrado a documentar en formato rst.
Limitaciones
No existe soporte para imagenes. Si tu quieres mostrar una imagen en el artículo (en rst), tienes que insertarla en formato Wiki :
.. image: miImagen.jpg
... debe ser transformada a :
</rst> [[Image:MiImagen]] <rst>
o poner la URL externa donde está alojada la imagen:
.. image: http://domain/MiImagen.jpg
... entonces, sube la imagen a la wiki haciendo click sobre el link que se crea al salvar el articulo.
¿ Cómo crear un proyecto en esta Wiki ?
Para crear un conjunto de pestañas para tu proyecto :
Esto es necesario para diseñar el número y nombre de secciones/subsecciones del proyecto. ¿ Cómo hacer ésto ? Solo tienes que crear un nuevo artículo con el siguiente nombre : Nombre de mi proyecto
MiProyecto
...si quieres crear un proyecto llamado MiProyecto
Usa la etiqueta project.
El código para esto sería :
<project>
name = MiProyecto
nombre de la sección 1
*nombre de la subsección 1-1
*nombre de la subsección 1-2
nombre de la sección 2
nombre de la sección 3
*nombre de la subsección 3-1
nombre de la sección 4
...
nombre de la sección n
*nombre de la subsección n-1
</project>
{{ContentProject}}
Nota : No usar caracteres especiales ( # , ? , $ , & , + , @ , / , = , , , ; ) en los nombres de las pestañas.
Página ppal. del proyecto, secciones & sub-secciones están ahora creados, pero con el contenido vacio. El contenido debe ser escrito como un artículo normal.
Si quieres cambiar el número o el nombre de las pestañas, solo tienes que modificar la página ppal. del proyecto añadiendo o borrando las nuevas pestañas (si borras algunas de las pestañas, los artículos que enlazados a traves de ellos (secciones), deben ser borrados manualmente).
La página ppal. pertenece a la Categoria Project por defecto ( automáticamente al crear ) y cada sección del proyectos es salvado como miembro de la categoria ProjectSection ( automáticamente ).
¿ Cómo proteger un proyecto ?
Para proteger un proyecto ( para edición ), manda un email ( desde tu cuenta registrada ) al correo de soporte, especificando :
1. titulo.
2. autor ( tu usuario ).
3. a qué usuarios quieres permitir la edición.
Solo los autores pueden hacerlo.
Personalizando Categorias
¿ Cómo añado al articulo
Cada artículo puede pertenecer a una o más categorias. Para añadir una categoría al articulo solo hay que escribir[[Category:Nombre_de_la_categoria]]al final del artículo.
un ejemplo :
... Cuerpo del Articulo ... [[Category:Mobile]]Solo los proyectos y las secciones de los proyectos añaden categorías de forma automática a su contenido :
[[Category:Project]]
y
[[Category:ProjectSection]]
Articulos Drafts
Un usuario tiene la posibilidad de guardar los artículos en la categoría Drafts. Cuando un artículo pertenece a esta categoría, es considerado un artículo sin acabar. Entonces, no será mostrado en la lista de artículos. Cuando un usaurio haya finalizado éste, debe ser descategorizado de Drafts.
Por favor, no modifiques un artículo categorize as Drafts.
¿ Que categorías existen en esta Wiki ?
Existen 4 principales categorías :
- Project
- HowTo
- OpenSource
- Mobile
... pero tu puedes introducir nuevas si las crees necesarias.
Por ejemplo ... si estás trabajndo en un artículo referente a la web, puedes escribir :
... Cuerpo del Artículo ... [[Category:HowTo]]
... y añadir :
Cuerpo del Artículo ... Article Body ... [[Category:HowTo]] [[Category:Web]]
Puedes introducir cualquier categoría que tu necesites. Ésta no debe ser de mal gusto ni concerniente a un tema no relacionado con las tecnologías de codigo abierto.. El equipo de soporte se guarda el derecho de eliminar dichas categorías si esto ocurriese.
Cómo usar el buscador
Los contenidos de la wiki, tanto proyectos como artículos independientes, pueden encontrarse utilizando el buscador, introduciendo el término a buscar en el area de texto localizado en el menu de la izquierda. También, puedes encontrar artículos de open source alojados en otros sitios. Utilizado el buscador, se obtiene una lista de enlaces internos/externos.
Cuando haces click en el botón "Go", obtienes el artículo requerido si existe en la wiki o una lista de enlaces a artículos internos / externos. Si por el contrario pulsas en "Search", verás la lista directamente.
Cada uno de los registros de busqueda está compuesto por los siguientes campos :
- title : Titulo del registro.
- summary : Pequeño resumen del artículo ( obtenido del cuerpo del articulo )
- another fragmentos : Esta parte, es un pequeño conjunto de fragmentos del artículo donde el termino aparece.
- url : URL del articulo.
Busqueda Avanzada
Cuando haces click en el botón "Search", obtienes una lista de enlaces a artículos internos / externos. Puedes hacer una busqueda avanzada haciendo click en
"Para ver resultados de sitios extenos, ve a External Search".
Entonces, podrás ver una lista con un formulario de busqueda avanzado:
- All of the words : Todas las palabras deben estar en texto buscado.
- Exact sentence : La sentencia exacta debe ser encontrada en el texto.
- Without the words : Ninguna de las palabras deben estar presentes en el text.
- Host : Solo se mostrarán los artículos pertenecientes al sitio especificado.
Función Interwiki ( BETA )
Es posible mostrar contenido remoto (artículo de otra wiki) directamente como si fuera un artículo propio. El objetivo es crear una red de wikis. El usuario puede ver un conjunto de artículos accediendo a esta wiki. ( local & artículos remotos ). Para añadir un contenido remoto, los usuarios pueden usar la etiqueta interwiki :<interwiki>
Cómo configurar la función Interwiki
Combinar contenido de multiples wikis es una tarea dificil. Algunas funcionalidades de algunas wikis no son soportadas en otras wikis, y la wiki sebe ser configurada para filtar la funcionalidad que no puede ser manejada. Esta función usa la API de mediawiki, la cual es utilizada por la plataforma para recibir peticiones de otras aplicaciones ( otras wikis u otras aplicaciones ). Para obtener desde una wiki remota, está debe permitir acceso remoto a su API. Una API de mediawiki es accedida a través de una URL.
El formato
<interwiki>
Domain=-Dominio Remoto-
APIprefix=-prefijo de la api- ( Podría ser vacio )
Prefix=-prefijo wiki- : e.g. : si http://myWiki/wiki/index.php/NombreArticulo entonces prefijo wiki es wiki
Article=-Nombre del artículo-
Templates=-Permitir Plantillas- : "all" : permite todas las plantillas,
"no" : las platillas no se ejecutarán (se filtrarán),
"local" : solo las plantillas locales
</interwiki>
Un ejemplo
<interwiki> Domain=http://en.wikipedia.org APIprefix=w Prefix=wiki Article=Ruby_on_Rails Templates=local </interwiki>
Ruby on Rails : Ejemplo Interwiki
Asi puedes editar en la wiki remota directamente
Si el usuario está viendo un artículo con contenido remoto, puede evitar cada sección del artículo. Si el usuario hace click en la etiqueta edit ( en cada sección ), éste es redirigido a la pagina de edición de la sección del artículo remoto.
Nota : Esta funcionalidad es solo una versión beta en pruebas, así que la operación puede producir resultados inesperados. La visualización de imagenes remotas no están actualmente soportadas y éstas son filtradas.
Página de Ayuda de Administración
Esta sección ha sido creada para conocer cómo gestionar la Wiki. El contenido en este articulo es solo para usuarios Sysop (administradores).
Para acceder a la página haz click aquí (Inglés)
