anchor.diff:  == ¿Qué es HubPress?
   image::http://hubpress.io/img/editor.png[]
   
  -HubPress es una herramienta de código abierto, que puedes usar para construir un enriquecido blog basado en AsciiDoc y utilizando GitHub Pages!
  -
  -Creado y mantenimo por http://github.com/anthonny[Anthonny Quérouil] (twitter http://twitter.com/anthonny_q[@anthonny_q]).
  -
  -NOTE: Aunque HubPress parezca tener todas las funcionalidades, esta actualmente en vista preliminar. Los errores son inevitables, por eso si encuentras que algo no se esta comportando de la manera que piensas deberia hacerlo, notifica el error y el equipo del proyecto se dirigirá a él tan pronto como sea posible.
  -
  -La documentación esta evolucionando rápidamente en la medida que el proyecto va creciendo. Visita regularmente para obtener más consejos sobre como usar HubPress. Si encuentras algún error en la documentación, por favor notifica el error. Tu ayuda en la mejora de todos los aspectos de HubPress es muy apreciada, Los Pull Request *siempre* son bienvenidos.
  +HubPress es una herramienta de código abierto, que puedes usar para construir un blog enriquecido basado en AsciiDoc, y además utilizando GitHub Pages!
  +
  +Creado y mantenido por http://github.com/anthonny[Anthonny Quérouil] (twitter http://twitter.com/anthonny_q[@anthonny_q]).
  +
  +NOTE: Aunque HubPress parezca tener todas las funcionalidades, está actualmente en Vista Preliminar (o _Tech Preview_). Como los errores son inevitables, si encuentras algo no está funciona de la manera que crees debería hacerlo, notifica el error y el equipo del proyecto lo revisará tan pronto como sea posible.
  +
  +La documentación está evolucionando rápidamente en la medida que el proyecto va creciendo. Visita esta web regularmente para obtener más consejos sobre como usar HubPress. Si encuentras algún error en la documentación, por favor notifica el error. Tu ayuda en la mejora de todos los aspectos de HubPress es extremadament apreciada y cualquier Pull Request es *siempre* bienvenido.
   
   == Compatibilidad con Navegadores
   
   HubPress es compatible con Chrome para escritorio, Firefox para escritorio y Chrome para Android.
   
  -Chrome Beta para Android será completamente compatible pronto, pero no esta completamente soportada por algunos errores en IndexedDB, por eso durante la vista preliminar usa unicamente Chrome para Android.
  +Chrome Beta para Android será completamente compatible pronto, pero no está completamente soportada por algunos errores en IndexedDB, por eso durante la Vista Preliminar usa únicamente Chrome para Android.
   
   == Introducción
   
   === Instalación
  +
   ==== Hacer fork al repositorio
  -Has Click en el icono de Fork image:http://hubpress.io/img/fork-icon.png[Fork,80] para crear una copia de este repositorio con tu cuenta de GitHub.
  +Haz Click en el icono de Fork image:http://hubpress.io/img/fork-icon.png[Fork,80] para crear una copia de este repositorio con tu cuenta de GitHub.
   
   ==== Usa el dominio github.io
   
  -Si nunca has usado el dominio de GitHub Pages, puedes usar este procedimiento para rápidamente instalar HubPress. Con este método, se requieren solo algunos pasos para tener Hubpress instalado y listo para usar.
  -
  -IMPORTANT: Si actualmente estas usando tu  `usuario.github.io` de GitHub Pages para otro proyecto, o si deseas usar un dominio personalizado, salta a las siguientes instrucciones.
  +Si nunca has usado el dominio de GitHub Pages, sigue estos pasos para instalar rápidamente HubPress. Solo se necesitan unos pocos pasos para tener Hubpress instalado y listo para usar.
  +
  +IMPORTANT: Si actualmente estás usando tu `usuario.github.io` de GitHub Pages para otro proyecto, o si deseas usar un dominio personalizado, puedes ignorar esta sub-sección y saltar a la siguiente.
   
   . Cambia el nombre del repositorio a `<usuario>.github.io`
   
  -. Configura los valores iniciales en `hubpress/config.json`
  +. Añade la configuración necesaria a `hubpress/config.json`
   +
   image:http://hubpress.io/img/edit-config.png[Edit config]
   +
   Los siguientes parámetros son obligatorios :
   +
  -* `username`, que es su nombre  de usuario de GitHub,
  -* `repositoryName`, que es el nuevo nombre del Fork del repositorio, `<usuario>.github.io`.
  -. Confirma los cambios, e ingrese al dominio de GitHub Pages:  `http://<usuario>.github.io/`.
  -. La siguiente pantalla indica que has configurado correctamente HubPress.
  +* `username`, tu nombre de usuario de GitHub,
  +* `repositoryName`, el nuevo nombre del Fork del repositorio, `<usuario>.github.io`.
  +. Confirma los cambios, y abre el dominio de GitHub Pages: `http://<usuario>.github.io/`.
  +. La siguiente pantalla aparecerá si has configurado correctamente HubPress.
   +
   image:http://hubpress.io/img/home-install.png[Install complete,300]
   
  -==== Usar un dominio personalizado ó si su dominio de GitHub Page esta actualmente en uso
  -
  -Si deseas tener tu blog disponible en un dominio personalizado , o si ya estas usando tu dominio de GitHub Pages para otro proyecto, necesitas una configuración adicional.
  -
  -. En la configuración del Repositorio, establece la rama por defecto a `gh-pages` :
  +==== Usar un dominio personalizado o si tu dominio de GitHub Page está actualmente en uso
  +
  +Si deseas tener tu blog en un dominio personalizado, o si ya estás usando tu dominio de GitHub Pages para otro proyecto, necesitas una configuración adicional.
  +
  +. En la configuración del Repositorio, establece la rama por defecto a `gh-pages`:
   +
   image:http://hubpress.io/img/settings-gh-pages.png[Settings gh-pages,400]
  -. cambia tu repositorio a la rama  *gh-pages*
  +. cambia tu repositorio a la rama *gh-pages*
   +
   image:http://hubpress.io/img/switch-gh-pages.png[Install complete,300]
   +
  
positive.code: Los siguientes campos son configurables:
  
  Git CNAME::
  Le permite especificar un nombre de dominio personalizado. Ver https://help.github.com/articles/setting-up-a-custom-domain-with-github-pages/[Setting Up A Custom Domain] para obtener instrucciones sobre cómo configurar un CNAME para tu blog.
  Live Preview Render Delay::
  Controla cuanto tiempo tarda el renderizador en vivo para refrescar, en milisegundos. Para mecanógrafos  rápidos, establece el campo en un valor superior a `2000` (dos segundos) esto dará lugar a una experiencia de edición más suave porque la vista previa no se regenerará con tanta frecuencia. Establecer este valor por debajo de `2000` dará lugar a la generación de la vista previa más rapido, pero puede dar lugar a cierto retraso del cursor al escribir.
  
  ==== Sitio
  
  ===== Titulo y Descripción
  
  Los campos  *Title* y *Description* te permiten colocar un nombre a tu blog, y una breve descripción para que tus visitantes puedan conocer que esperar de tus entradas en el blog.
  
  Los campos *Logo* y *Cover Image* pueden ser usados de las siguientes maneras:
  
  * Un enlace HTML a un servicio de hosting de imagenes, pro ejemplo Gravatar.
  * Un enlace a una imagen almacenada en el directorio /images del repositorio de tu blog.
  
  NOTE: Revisa el archivo `/images/README.adoc` para algunas opciones de como incluir imagenes es tus entradas del blog.
  
  ===== Temas
  
  El campo *Theme* es seleccionable de una lista de temas almacenados en el directorio `/themes`. El nombre debe ser especificamente el mismo que posee el directorio que contiene el tema.
  
  ===== Google Analytics
  
  El Campo *Google Analytics* toma el código único de Google Analytics generado para el sitio.
  
  ===== Nombre Corto Disqus
  
  El campo *Disqus shortname* toma tu Disqus URL/nombrecorto que especificas cuando registras un nuevo sitio para Disqus. Solo el nombre corto es requerido, no el enlace a tu perfil personal.
  
  ==== Redes Sociales
  
  Todos los campos en este grupo requieren el URLs completo a tu pagina de perfil publico. La manera en que estos valores son renderizados en tu blog depende en el tema seleccionado.
  
  == Manajando entradas
  
  Cuando inicies con HubPress, la vista *Posts* esta vacia. A medida que crees tus entradas en el blog, la pagina irá creciendo con la lista de entradas a tu izquierda, y una vista previa de la entrada en si a la derecha.
  
  === Creando una Entrada
  
  NOTE: Si nunca has usado AsciiDoc para escribir contenido, la http://asciidoctor.org/docs/asciidoc-writers-guide/[guía para Escritores de AsciiDoctor] debe ser tu primera parada en tu viaje. La guía te provee de ejemplos de marcas básicos y avanzados para copiar y usar.
  
  El editor de HubPress muestra el código de AsciiDoc a la izquierda, y la vista previa en la derecha.
  
  ===== Titulo del blog y encabezamiento
  
  El titulo del blog siempre estará de primer nivel en la entrada en AsciiDoc. Por ejemplo, `= Titulo del Blog` establece el nombre de la entrada del blog a `Titulo del Blog`.
  
  Una linea `= Titulo del Blog` es requerida para guardar satisfactoriamente la entrada.
  
  Si quieres colocar un encabezado de primer nivel debes utilizar `== Encabezado de Primer Nivel`, y de esta manera crear los encabezados anidados consecutivamente.
  
  ==== Parámetros de HubPress
  
  HubPress le permite modificar las características de cada entrada del blog mediante atributos.
  
  ===== :hp-image: para Imagen de Portada de la Entrada del Blog 
  
  Si quieres agregar una imagen de portada a tu entrada del blog, debes agregar el atributo `hp-image`.
  
  . :hp-image: Por Ejemplo:
  [source, asciidoc]
  ----
  = Blog Title
  :hp-image: a-cover-image.jpg
  ----
  
  NOTA: Debido a los valores predeterminados en HubPress el directorio `/images` funciona como la raíz de todas las imágenes, sólo tiene que declarar el nombre del archivo de la imagen. Debido a esto, es posible que desee considerar la creación de un directorio `/covers` en su repositorio para agrupar las imágenes de las portadas juntas.
  Nombrar las imágenes de la cubierta consistentemente hará que sea muy fácil de aplicar a cada entrada. Si usted tiene un tema para su blog, esto permite a sus lectores obtener una idea visual de lo que trata la entrada.
  
  Los temas que actualmente soportan imagenes de portadas en las entradas del blog son: 
  
  * Saga
  
  ==== :published_at: Para alterar la Fecha de Publicación
  
  Por defecto,  la fecha de publicación es la fecha de creación de la entrada en el blog. puedes forzar la fecha de publicación añadiendo el atributo `published_at`.
  
  . :published_at: Por Ejemplo :
  [source, asciidoc]
  ----
  = Blog Title
  
negative.code: 
  ==== :hp-tags: Etiquetas
  
  NOTE: Categorías no están soportadas.
  
  Añadir etiquetas mediante el atributo `hp-tags`.
  
  . :hp-tags: Ejemplo:
  [source, asciidoc]
  ----
  = Blog Title
  :hp-tags: HubPress, Blog, Open Source,
  ----
  
  ==== :hp-alt-title: para indicar un Título Alternativo
  
  Especifique un título alternativo mediante el atributo `hp-alt-title`.
  
  El título alternativo se utiliza en lugar del nombre de archivo HTML generado por HubPress.
  
  . :hp-alt-title: Ejemplo :
  [source, asciidoc]
  ----
  = 大千世界
  :hp-alt-title: My English Title
  ----
  
  ==== Añadiendo Imágenes
  
  ===== Publicando Imágenes en un repositorio GitHub
  
  Puedes usar la consola de comando o un cliente de Git para añadir imágenes a una entrada. Para ello:
  
  . Sube la imágen (mediante _commit_) al directorio `/images`.
  . Usa la siguiente expresión de AsciiDoc en tu entrada del blog:
  +
  [source,AsciiDoc]
  ----
  image::<filename>[]
  ----
  . Revisa http://asciidoctor.org/docs/asciidoc-writers-guide/ para ver más opciones de inserción de imágenes.
  
  Si están integrando imágenes publicadas en otro dominio -- instagram, otros repositorios GitHub, o cualquier servicio de imágenes -- simplemente indica la URL completa en el lugar de `<filename>`.
  
  .Inserción de imágenes en otros dominios
  ----
  image::http://<full path to image>[]
  ----
  
  ===== Usando incidencias de GitHub para publicar imágenes
  
  Puedes usar una única incidencia para almacenar y publicar las imágenes de una entrada, para ello añade varias imágenes como comentarios, o como alternativa, puedes usar múltiples incidencias para almacenar imágenes de forma separada. Usa lo que mejor se adapte a tu estilo y el de tu organización. En el siguiente vídeo encontrarás ejemplos sobre como usar incidencias de GitHub y servicios de Cloud Hosting, también encontrarás algunos consejos extra sobre el uso del boque `image` en AsciiDoc.
  
  video::KoaGU91qJv8[youtube]
  
  ==== Insertando Vídeos
  
  HubPress permite insertar vídeo en una entrada mediante una sintaxi simple. No necesitas indicar la URL completa, solamente indica el ID único del video como en el ejemplo.
  
  ```
  video::[id_unico_youtube][youtube | vimeo]
  ```
  
  .Insertando vídeo de YouTube
  ```
  video::KCylB780zSM[youtube]
  ```
  
  .Insertando vídeo de Vimeo
  ```
  video::67480300[vimeo]
  ```
  
  == Actualizando HubPress
  
  Gracias a que HubPress está en GitHub, puedes actualizar a los últimos cambios haciendo pull del repostiorio master de HubPress.
  
  Para aprender a hacerlo correctamente, puedes ver el siguiente vídeo (hay ciertas consideraciones a tener en cuenta la primera vez que haces pull del upstream).
  
  video::KCylB780zSM[youtube]
  
  https://www.youtube.com/watch?v=KCylB780zSM[Actualizando HubPress]
  
  == Solución de problemas
  
  Si algo no está funcionando como esperas, algunos de estos consejos podrían ayudarte.
  
  === Restablecimiento de la Base de datos del Blog en Android
  
  A veces, la base de datos local de HubPress se desincronización con tu blog publicado. Esto puede suceder debido a que estás editando tu blog en tu PC, y luego cambias a la tableta.
  
  HubPress trabaja con una base de datos local específica en tu navegador, por lo que si cambias de dispositivo -- y en consecuencia cambias de navegador -- se pierde la sincronía entre los navegadores.
  
  Para devolver la instancia de HubPress a la del blog publicado, borra la caché del navegador y de datos en Ajustes > Aplicaciones. Tras esto, HubPress reconstruirá la base de datos local, y reflejará el estado del blog en GitHub.
  
  == Créditos
  
  Gracias a https://github.com/jaredmorgs[Jared Morgan] por poner en orden el archivo README que se ve aquí, y seguir siendo el "Documentador" para HubPress.
  Gracias a https://github.com/takkyuuplayer[takkyuuplayer], https://github.com/hinaloe[hinaloe] por haber traducido el README a Japonés.
  