Java and the Duke logo are trademarks of Sun Microsystems, Inc.
Instructivos PDF Imprimir E-Mail
Escrito por Carlos Soderguit   
jueves, 31 de mayo de 2007

Instructivo para la elaboración de artículos

El presente instructivo presenta las líneas generales para la elaboración de artículos para su publicación en juguy.org.

El objetivo es que sirva como guía para que todos los artículos publicados cumplan con los criterios mínimos para lograr un sitio homogéneo.

Nuevamente convocamos a todos los interesados en publicar artículos, papers, noticias, etc. para que el JUG crezca con el aporte de todos y en beneficio de todos.

¿Cómo publico artículos?

  1. Debes solicitar permisos de autor a Esta dirección de correo electrónico está protegida contra los robots de spam, necesita tener Javascript activado para poder verla
  2. Ingresa al sitio con tu usuario y contraseña
  3. Entrá en la opción "Agregar noticias" del menú "Mi menú"
  4. Escribí el artículo y publicalo (va a quedar pendiente de publicación hasta que lo revise un editor)
  5. Todos los recursos adicionales (diapos, imagenes, etc.) deben entregarse por correo electrónico, especificando a que artículo corresponden.

¿Que hay que entregar si no quiero publicarlo yo?

Un archivo comprimido (zip, rar, tgz, bz2, 7z, etc.) con el artículo y todos los recursos necesarios (imágenes, diapositivas, ejemplos, etc.).

Formato

  1. Los articulos deben proveerse escritos en HTML
  2. Las imágenes pueden ser gif, jpg o png
  3. Pueden incluir otro tipo de archivos para descargar como ser zip, pdf, etc.
  4. Cuando se incluyan diapositivas deben proveerse en formato PDF.

Estructura

Los artículos constan de dos partes:
  • Resúmen - es la parte que se muestra en las páginas donde se listan artículos.
  • Contenido - es la parte del artículo que se muestra, a continuación del resúmen, cuando se amplía la nota (cliqueando en el título del artículo o en el link "Leer mas...").

Lineamientos para la estructura del resúmen

  1. Debe ser concreto para que no ocupe demasiado espacio en las páginas que listan artículos
  2. A su vez debe ser lo suficientemente claro para que el usuario tenga una idea del tema del artículo
  3. Debe terminar con dos líneas en blanco (<br><br>) para que los artículos no queden demasiado pegados en la lista

Lineamientos para la estructura del cuerpo

  1. No debe repetir el resumen, dado que la vista ampliada presenta automáticamente el resúmen seguido del contenido

Lineamientos para el título del artículo

El título del artículo aparece como:
  1. Link en los menues "Noticias", "Popular", etc
  2. Encabezando cada artículo en las páginas que listan artículos
Por lo tanto debe:
  1. Ser relativamente corto
  2. Dar una idea del tema a tratar

Lineamientos para la inclusión de imágenes

  1. Deben proveerse junto con el HTML del artículo para su publicación.
  2. Ancho máximo 400 pixeles
  3. Se prefiere que aparezcan flotando en el texto. Para esto usar un <div> basado en el que aparece a continuación.
<div style="float: left; margin-right: 15px; margin-bottom: 15px;">
  <img src="http://juguy.org/./images/stories//flag-of-uruguay.jpg"
    alt="flag-of-uruguay.jpg"
    align="left"
    hspace="6"
    width="150">
</div>

Lineamientos para los links a páginas externas

  1. Deben abrir en una ventana separada, para esto setear el atributo target del tag <a> con el valor "_blank".
    Ejemplo: <a href="http://www.google.com" target="_blank">Google</a>

Lineamientos para mostrar código fuente

Cuando se desea mostrar código fuente Java, JavaScript, etc., el mismo debe resaltarse de la siguiente forma.
  1. Al comienzo del documento definir el estilo como se muestra a continuación

    <style type="text/css">
     <!--
      .Codigo {color: #333333; font-family: monospace; font-size: 10px; background-color:#9999FF;padding-left:20px; width:auto; height:auto}
     -->
    </style>

  2. Poner el texto que corresponde al código fuente dentro de un div como el siguiente:

    <div class="Codigo">
       <!-- Acá va el codigo fuente -->
    </div>

  3. Dentro del bloque se pueden usar diferentes formatos. Por ejemplo negritas para resaltar palabras reservadas.

Instructivo para comentar libros

Si querés comentar un libro ya comentado por otro usuario:

  1. Ingresá en la sección "Libros" del menú principal
  2. Seleccioná el libro para entrar a ver el detalle de la revisión
  3. Agregá tu comentario y tu calificación

Si querés comentar un libro no comentado

En este caso tenés que dar de alta la nueva revisión.

  1. Ingresá en la opción "Comentar libro" del menú "Mi Menú"
  2. Ingresá una calificación entre 1 y 5, (1=muy malo, 5=excelente)
  3. Ingresá los datos requeridos (si bien no es requerido es bueno que agregues un sumario corto que aparecera en las listas de revisiones)
  4. Ingresá la URL de la imagen en miniatura para los listados de revisiones (en general se pueden encontrar en el sitio oficial del libro)
  5. Ingresá la URL de la imagen en normal (para la pantalla donde se muestra el detalle de la revisión)


Tips y Sugerencias

  1. Incluir título, autor, editorial y precio
  2. Agregá la URL del libro en el catálogo de la editorial (por ejemplo página del libro en el catálogo de O'Reilly http://www.oreilly.com/catalog
  3. Incluir información del libro sacada de la página correspondiente en el catálogo (ejemplo: link a capítulos de ejemplo o artículos del autor).
  4. Ser honesto
Modificado el ( miércoles, 19 de septiembre de 2007 )
 
< Anterior   Siguiente >

Ingresar






¿Recuperar clave?
¿Quiere registrarse? Regístrese aquí

Usuarios conectados

Hay 1 invitado y 3 usuarios en línea
  • lscasso
  • casvicente
  • canario1616

Cuestionario

¿Que tema elegirías para tratar en el próximo evento del jug?
 

Syndicate

joomla templates by dezinedepot
© 2008 Juguy - Grupo de Usuarios Java del Uruguay
Joomla! es Software Libre distribuido bajo licencia GNU/GPL.