Documentación Inclusion Code - Modo del editor Markdown

Versión 2.5.1

Actualizado: 12 de julio de 2021

Introducción

Inclusion Code es un editor accesible que permite crear fácilmente documentos en Markdown o contenidos en HTML. Una vez en el editor, se puede ya sea escribir los correspondientes códigos manualmente, o utilizar los menús para generar los mismos automáticamente.

El interface de Inclusion Code es uno sencillo con barras de menús, que utiliza los controles estándares de Windows, por lo que resulta accesible a programas lectores de pantalla y líneas braille utilizados por personas ciegas.

Pantalla de inicio

Cuando Inclusion Code se inicia, saldrá una ventana con varias opciones que podemos seleccionar para abrir el editor. Las mismas son:

Si se selecciona HTML, el editor se abrirá en una pantalla en blanco, donde se podrá comenzar a insertar los códigos de las etiquetas HTML.
Si se selecciona Markdown, el editor se abrirá en una pantalla en blanco, donde se podrá comenzar a crear un documento utilizando las etiquetas de marcado de Markdown.
Si se selecciona Salir, se saldrá del programa.

Modo editor Markdown

Esta documentación es la ayuda para la opción del editor Markdown, también hay otra ayuda disponible con la documentación para la opción del editor HTML.

El modo del editor Markdown en Inclusion Code, facilita el proceso de la creación de documentos al automatizar la creación de etiquetas de Markdown. El usuario selecciona el elemento deseado desde el menú, el programa generará los correspondientes caracteres especiales y los integrará en el editor. Por lo que se pueden crear contenidos en muy poco tiempo, sin tener que saber necesariamente Markdown.

Igualmente, el que se puedan generar las etiquetas automáticamente, permite también al usuario, ir aprendiendo los diferentes caracteres especiales de Markdown. Markdown es un lenguaje de marcado que facilita la aplicación de formato a un texto empleando una serie de caracteres de una forma en particular. En principio, fue pensado para elaborar textos cuyo destino iba a ser la web con más rapidez y sencillez que si estuviésemos empleando directamente HTML. Pero también podemos emplearlo para cualquier tipo de texto, independientemente de cual vaya a ser su destino, incluyendo la creación de documentos.

Usos recomendados

Recomendamos el uso del modo del editor Markdown en Inclusion Code para:

Características del editor Markdown

Compatibilidad del programa

Inclusion Code es compatible con las siguientes versiones de Windows:
10/8/7 y con ambas arquitecturas 32 y 64 bits.

Igualmente, Inclusion Code no requiere instalación, ya que es un programa auto ejecutable, ideal para guardarlo en una unidad portable de memoria USB, y utilizarlo en cualquier computadora con Windows.

Menús y comandos de teclado

A continuación, se presentan los menús del editor en modo Markdown, así como una descripción de como activarlos, utilizando comandos del teclado.

Menú Archivo

Nuevo

Limpia el editor para la creación de un nuevo documento.
Alt + a, n

Abrir

Se abrirá un archivo Markdown previamente guardado. El mismo, se cargará en el editor. Importante: el editor de Inclusion Code apoya archivos con codificación ANSI. Para abrir un documento con codificación UTF-8 debe hacerse desde la opción Importar UTF-8.
Alt + a, a

Guardar

Guardará el archivo que está actualmente en el editor y que ya había sido previamente guardado. Se guardará con el mismo nombre. Importante: El editor Inclusion Code guarda los archivos con la codificación ANSI. Para guardar un documento con codificación UTF-8 debe hacerse desde la opción Exportar UTF-8.
Alt + a, g

Guardar como

Se utiliza para guardar un archivo Markdown con la opción de cambiarle el nombre al mismo. Importante: El editor Inclusion Code guarda los archivos con la codificación ANSI. Para guardar un documento con codificación UTF-8 debe hacerse desde la opción Exportar UTF-8.
Alt + a, c

Importar UTF-8

Se abrirá un archivo Markdown previamente guardado con codificación UTF-8. El mismo, se cargará en el editor. Importante: el editor de Inclusion Code convertirá los textos como ANSI. Para guardarlos como UTF-8, se debe ir a la opción de Exportar UTF-8.
Alt + a, i

Exportar UTF-8

Se utiliza para guardar un archivo Markdown con la codificación UTF-8.
Alt + a, e

Imprimir

Enviar el código del el editor a la impresora. Alt + a, i

Salir del editor

Salir del editor y regresar al menú principal.
Alt + a, s

Menú Edición

Deshacer

Cancela la más reciente acción de edición.
Alt + e, d

Cortar

Corta texto seleccionado del editor y lo envía al portapapeles.
Alt + e, a

Copiar

Copia texto seleccionado del editor y lo envía al portapapeles.
Alt + e, c

Pegar

Coloca el texto del portapapeles en la posición del cursor en el editor.
Alt + e, p

Seleccionar todo

Selecciona todo el texto del editor.
Alt + e, s

Buscar/Reemplazar

Busca un texto especificado en el editor. Puede reemplazar el mismo, con otro texto.
Alt + e, b

Menú Insertar

Encabezados

Primeramente, se presenta una ventana con una lista donde se puede seleccionar encabezados desde el nivel 1 hasta el nivel 6. Al presionar Enter, saldrá una ventana con un cuadro de edición y una vez escritos los textos, se debe presionar la tecla Enter para su integración en la posición actual del cursor en el editor.
Alt + i, e

Lista

Primero, se presenta una ventana donde se debe seleccionar el tipo de lista, ordenada o sin ordenar. Luego saldrá otra ventana para seleccionar el número de items y finalmente saldrán las ventanas con cuadros de edición para escribir los items de la lista.
Alt + i, l

Link (Enlace)

Primero, se presenta una ventana para escribir la dirección URL del enlace (Se debe escribir la dirección completa, incluyendo el https://) y se presiona Enter. Luego saldrá una ventana con un cuadro de edición para escribir el texto del enlace y una vez escritos los textos, se debe presionar la tecla Enter para su integración en la posición actual del cursor en el editor.
Alt + i, k

Negrilla

Saldrá una ventana con un cuadro de edición y una vez escritos los textos, se debe presionar la tecla Enter para su integración con la etiqueta de negrilla en la posición actual del cursor en el editor.
Alt + i, n

Itálica

Saldrá una ventana con un cuadro de edición y una vez escritos los textos, se debe presionar la tecla Enter para su integración con la etiqueta de itálica en la posición actual del cursor en el editor.
Alt + i, i

Blockquote

Saldrá una ventana con un cuadro de edición y una vez escritos los textos, se debe presionar la tecla Enter para su integración con la etiqueta blockquote en la posición actual del cursor en el editor.
Alt + i, q

Línea horizontal

Se integrará la etiqueta correspondiente a una línea horizontal en la posición actual del cursor en el editor.
Alt + i, h

Textos

Saldrá una ventana con un cuadro de edición y una vez escritos los textos, se debe presionar la tecla Enter para su integración en la posición actual del cursor en el editor.
Alt + i, t

Plantilla Power Point

Integrará en el editor, unos códigos Markdown equivalentes a dos diapositivas en Power Point. La primera diapositiva integra un encabezado de nivel 1 que es la sección. La segunda diapositiva integra un encabezado de nivel 2 con textos y una lista.
Alt + i, t

Menú Código

Previsualizar en el navegador

Presenta el documento Markdown con su correspondiente formato en el navegador por defecto.
Alt + c, n

Exportar como documento Word

Convertirá los códigos Markdown del editor a un documento Word. Saldrá una ventana donde se puede escribir el nombre del documento en formato Word.
Alt + c, w

Exportar como presentación Power Point

Convertirá los códigos Markdown del editor a una presentación Power Point. Saldrá una ventana donde se puede escribir el nombre del documento en formato Power Point. Importante: Desde el Menú Insertar, se puede integrar una plantilla con los códigos de Markdown para una presentación sencilla en Power Point.
Alt + c, p

Info del documento

Saldrá una ventana con la información del número de líneas, caracteres y palabras de los textos en el editor.
Alt + c, i

Leer en voz alta

Leerá los textos del editor usando el motor de voz predeterminado por el sistema.
Alt + c, l

Detener lectura

Detiene la reproducción de la lectura actual por el motor de voz.
Alt + c, d

Menú opciones

Idioma

Se podrá seleccionar entre los idiomas de Inglés y Español. El programa se va a reiniciar, para que el cambio de idioma tenga efecto. Igualmente, se debe ir a la opción de configuración de texto a voz en Windows, para cambiar la voz SAPI5 del idioma seleccionado. Alt + o, i

Fuente

Se podrá seleccionar el tipo de fuente y su tamaño, que se utilizará en el editor.
Alt + o, f

Contrastes colores

Se podrán seleccionar colores de alto contraste (fondo negro y letras blancas) para utilizar en el editor.
Alt + o, c

Sonidos

Se podrá activar o desactivar la opción de los efectos de sonidos.
Alt + o, s

Preferencias texto a voz

Se podrá activar o desactivar la opción de los mensajes parlantes. También, se podrá ir a la pantalla de configuración de texto a voz de Windows, y seleccionar entre las voces SAPI5 instaladas en el sistema.
Alt + o, v

Menú Ayuda

Documentación

Se abrirá el documento de ayuda en el navegador.
Alt + u, d

Página web Inclusion Code

Se accederá a la página www.inclusioncode.com, se debe tener una conexión de Internet activa.
Alt + u, i

Acerca de

Se ofrece información de la versión actual de Inclusion Code. Así como los créditos del autor.
Alt + u, a

Créditos

Inclusion Code ha sido programado por José Manolo Alvarez, programador ciego profesor de la Universidad de Puerto Rico.
La versión 2.1, integra el modo del editor Markdown y se ha utilizado durante toda esta situación de una educación en línea por el COVID-19, como alternativa para que estudiantes ciegos redacten sus documentos en Markdown y los conviertan en formato Word accesible en Inclusion Code.

Página web Inclusion Code:
Inclusion Code

E-Mail:
manolo@manolo.net