lunes, 26 de noviembre de 2012

Ayuda Markdown

En esta sección se brinda una ayuda de como agregar cada uno de los componentes del menú según la que sintaxis puede usar en el editor.

Entre los elementos que cuenta la barra están:

Abrir

Para poder cargar un archivo y ser utilizado en este editor de markdown es necesario utilizar el primer botón de la barra de herramientas el cual posee el nombre de "Seleccionar archivo desde la PC", debe realizar un click sobre el anteriormente mencionado, de esta manera el usuario podrá navegar en su PC y así elegir el archivo de markdown que desee visualizar y editar.


Guardar

Esta opción nos permite salvar nuestro documento, es decir, cuando abrimos un archivo existente y lo comensamos a editar, y queremos guardar estos cambios en el mismo archivos, entonces hacemos uso de este botón que se encuentra en la barra de herramientas mediante el nombre de "Guardar", de esta manera sobreescribiendo el archivo ya existente por lo que se esta mostrando en el programa(Texto editado o cambiado).


Guardar Como

Esta opción de guardar nos permite salvar un archivo ya existente o uno generado desde cero en nuestra aplicación, a la hora de utilizar el botón "Guardar como" que se encuentra en la barra de herramientas, el programa abrirá el navegado de búsqueda, en este momento el usuario tiene el poder de elegir la dirección y el nombre de como se quiere salvar este documento.


H1

Esta es la opción permite ingresar ingresar un titulo en formato de markdown .
Hay dos maneras de invocarlo : La primera es digitar la frase que se desea poner como titulo, luego se marca en el editor y posteriormente da click en el botón "H1", y el programa convertirá el texto en titulo con formato markdown La segunda opción es dar click en el botón, y el programa le desplegara en el editor un campo con la siguiente leyenda : "Ingrese el texto aquí". El usuario debe remplazar ese texto por el texto que desea que aparezca como titulo. Es importante recalcar que no se deben borrar el caracter # al lado izquierdo del texto, puesto que esto es lo que permite tener el texto en formato markdown.







H2

La funcionalidad es la misma descrita anteriormente para agregar títulos, solo que esta vez es para agregar subtítulos al editor del texto.

Ejemplos:








Letra Negrita

Esta opción del editor permite ingresar texto en letra negrita mostrada en el HTML.
Hay dos manera de acceder a esta funcionalidad. La primera es digitar la frase o palabra que se desea poner como palabra en negrita, luego se marca en el editor y posteriormente da click en el botón con el símbolo "B", y el programa convertirá el texto con formato en negrita. La segunda opción es dar click en el botón, y el programa le desplegara en el editor un campo con la siguiente leyenda : "Ingrese el texto aquí". El usuario debe remplazar ese texto por el texto que desea que aparezca como con formato en negrita.

Es importante recalcar que no se deben borrar los elementos "" a los lados del texto, puesto que esto es lo que permite tener el texto en formato markdown.

Ejemplos:





Letra Cursiva

Esta opción del editor permite ingresar texto en letra cursiva mostrada en el HTML.
Hay dos manera de acceder a esta funcionalidad. La primera es digitar la frase o palabra que se desea poner como palabra en negrita, luego se marca en el editor y posteriormente da click en el botón con el símbolo "I", y el programa convertirá el texto con formato en cursiva. La segunda opción es dar click en el botón, y el programa le desplegara en el editor un campo con la siguiente leyenda : "Ingrese el texto aquí". El usuario debe remplazar ese texto por el texto que desea que aparezca como con formato en cursiva.

Es importante recalcar que no se deben borrar los elementos "" a los lados del texto, puesto que esto es lo que permite tener el texto en formato markdown.

Ejemplos:

                     


                       


Convertir a mayúscula

El editor permite convertir un texto ya digitado en el editor de minúscula a mayúscula. Para esto, el usuario debe digitar el texto en el editor, posteriormente lo marca y seguidamente da click en el botón con la siguiente representación: "A" y el programa convertirá el texto en mayúscula.

Ejemplo:







Convertir a minúscula

El editor permite convertir un texto ya digitado en el editor de mayúscula a minúscula. Para esto, el usuario debe digitar el texto en el editor, posteriormente lo marca y seguidamente da click en el botón con la siguiente representación : "a" y el programa convertirá el texto en minúscula.

Ejemplos:






Link

El editor permite ingresar un link de algún dominio de Internet y empaquetarlo en un solo identificador.
Para agregar esta sintaxis al editor, el usuario debe dar click en el botón que muestra la leyenda click, posteriormente se le desplegara una pequeña ventana que muestra dos campos para ingresar texto . El primero corresponde al URL del sitio web donde se debe digitar con el formato : http//:"URL". En el segundo campo editable el usuario puede ingresar un nombre o identificador que se mostrara en el HTML. Al darle click a este identificador el navegador automáticamente  accederá al sitio mediante el navegador predeterminado en el computador.

Ejemplos:



Imagen

Otra de las funcionalidades del editor es agregar el link de una imagen ubicada en algún dominio de Internet y el programa desplegara la imagen en el HTML generado.
Para acceder a esta funcionalidad , el usuario debe dar click en el botón con una representación de una paisaje y con la leyenda "Imagen". Una vez esto , el editor desplegara una pequeña ventana que muestra dos campos para ingresar texto . El primero corresponde al URL del sitio web donde de encuentra la imagen que se desea mostrar. Este link se debe digitar con el formato : http//:"URL de la imagen". En el segundo campo editable el usuario puede ingresar un nombre o identificador que se le dará a la imagen cuando el mouse del usuario este posado sobre ella.

Ejemplos:





Lista

Esta opción nos permite agregar listas al texto que estamos editando, para esto debemos utilizar el botón que se se encuentra en la barra de herramientas y posee el nombre de "Lista", debe realizar un click sobre el anteriormente mencionado, de este manera, el programa le mostrara una pagina donde le solicita que escoja que tipo de lista quiere, Numerada, o No Numerada, esto mediante el uso de un listbox. Además debe de ingresar los items que quiere que aparezcan en la lista en un campo de texto destinado a este fin, el único cuidado es que debe de separar cada ítem mediante el uso de un "*". Y como ultimo paso hacer uso del botón "Agregar Lista", e inmediatamente se mostrara la lista en los dos campos de texto de la aplicación.

Ejemplos:




Código

El editor permite ingresar texto de manera que se presenta un código de programación.
Hay dos manera de acceder a esta funcionalidad. La primera es digitar la frase o palabra que se desea poner como código de programación, luego se marca en el editor dicho texto y posteriormente da click en el botón con el símbolo "<>", y el programa convertirá el texto con formato de código de programación. La segunda opción es dar click en el botón, y el programa le desplegara en el editor un campo con la siguiente leyenda : "Ingrese el código aquí". El usuario debe remplazar ese texto por el texto que desea que aparezca como código de programación.
Es importante recalcar que no se deben borrar los elementos '' a los lados del texto, puesto que esto es lo que permite tener el texto en formato markdown.

Ejemplos:








Párrafo

Esta funcionalidad nos permite agregar un párrafo a nuestro documento, mediante el uso del botón que se encuentra en la barra de herramientas, este mismo se puede encontrar mediante el nombre de "Párrafo", y la explicación del funcionamiento es la misma que para la funcionalidad de insertar código.

Ejemplos:



Cita

Esta funcionalidad nos permite agregar un cita textual a nuestro documento, mediante el uso del botón que se encuentra en la barra de herramientas, este mismo se puede encontrar mediante el nombre de "Cita Textual", y la explicación del funcionamiento es la misma que para la funcionalidad de insertar código.


Ejemplos:







Separador

Esta opción nos permite agregar un separador a nuestro texto, este mismo sera una linea especial la cual se incorpora a nuestro documento para brindar lucidez a la hora de la lectura y separar los textos, para hacer uso de esta, debemos colocar el cursor en una linea vacía y que queremos que acá aparezca el divisor, después de esto debemos de hacer uso del botón "Separador Horizontal", al hacer click sobre este, inmediatamente se agrega el separador al texto, y lo podremos utilizar y visualizar.

Ejemplo:




Guia

Si no conocemos de buena manera la sintaxis de Markdown, el programa nos brinda la opción de guiarnos a la pagina oficial de markdown donde podemos conocer mas de la sintaxis y otros aspectos de markdown, para esto debe de hacer uso de botón que se encuentra en la barra de herramientas llamado "Guia oficial de Sintaxis de Markdown" al hacer click sobre este, el programa abrirá otra ventana en nuestro navegador, y nos mostrara la pagina anteriormente mencionada, donde se podrá visualizar todo esta información.. Sintaxis Markdown  

Acerca de

Esta opción que nos brinda el programa es básicamente para visualizar información como: Porque se realiza este proyecto, quienes fueron los desarrolladores del mismo, y para que carrera e institución se dio el desarrollo.