Markdown Slides [ES]

Creación

Primero copia la carpeta doc y renombrala a tu gusto. Es importante renombrarla para que no de error.
Crea los ficheros md que quieras generar en la carpeta md. Los ficheros md son ficheros Markdown, que no son nada más que ficheros de texto plano, con extensión md, y con un marcado ligero (que hay que conocer pero que es muy sencillo).

Imports (I)

Podemos añadir fichero con @import import/NOMBRE_FICHERO [startLine=NUMERO] [endLine=NUMERO] [showNumberLines]

Primer ejemplo:

 @import import/import-2.md

Line 1 of import-2.md
Line 2 of import-2.md
Line 3 of import-2.md
Line 4 of import-2.md

Imports (II)

Segundo ejemplo:

 @import import/import-1.md endLine=4

Line 1 of import-1.md
Line 2 of import-1.md
Line 3 of import-1.md
Line 4 of import-1.md

Imports (III)

Tercer ejemplo:

 @import import/import-1.md startLine=6

- Line 1 of import-2.md
- Line 2 of import-2.md
- Line 3 of import-2.md
- Line 4 of import-2.md

Imports (IV)

Cuarto ejemplo:

 @import import/import-1.md startLine=2 endLine=3 showNumberLines

2 - Line 2 of import-1.md
3 - Line 3 of import-1.md

Notas

Puedes añadir notas que serán visibles en modo libro o si pulsas la letra ‘s’ en las slides mediante @start-notes y @end-notes.

 @start-notes
 Esto solo es visible en modo libro o si pulsas 's' en las slides.
 @end-notes

Notas plus

Puedes crear notas con @plus que solo estarán disponibles en ficheros “plus” siempre y cuando en el build.properties tengas GENERATE_PLUS_VERSION=‘yes’

 @plus las lineas de abajo solo estarás disponible en la versión plus

 @plus @import import/import-2.md

las lineas de abajo solo estarás disponible en la versión plus

Line 1 of import-2.md
Line 2 of import-2.md
Line 3 of import-2.md
Line 4 of import-2.md

MathJax

Se puede utilizar la librería MathJax.

Así esto:

$$x = {-b \pm \sqrt{b^2-4ac}}.$$

Se transforma en:

$x = - b \pm \sqrt{b^{2} - 4 a c} .$

Código

function holaMundo() {
    alert('Hola mundo');
}

Niveles

Puedes tener tantos niveles como quieras. Ejemplo:

# Nivel 1 (en slides y libro)

## Nivel 2 (en slides y libro)

## Nivel 3 (en libro pero se queda como nivel 2 en slides)

Pero sólo en los libros. En las slides solo puedes tener 2 niveles.

Numeración

Puedes nombrar igual varias slides con (I), (II), etc. pero luego solo el primero será exportado al libro. Ejemplo:

 ## Foo Bar (I)

 ## Foo Bar (II)

En el libro quedará:

 ## Foo Bar

Configuración (I)

Podemos configurar los ficheros que queremos generar desde el fichero build.properties

DEFAULT_GENERATION_MODE='min'
GENERATE_PLUS_VERSION='yes'
DEFAULT_BUILD='REVEAL_SLIDES_PDF'

BUILD_REVEAL_SLIDES='min'
BUILD_REVEAL_SLIDES_PDF='med'

BUILD_HTML_BOOK='min'
BUILD_PDF_BOOK='med'
BUILD_DOCX_BOOK='max'
BUILD_EPUB_BOOK='max'

Configuración (II)

Podemos configurar también algunas cosas más desde el fichero build.properties

CLEAN_LIB_FOLDER='no'
COPY_IMG_FOLDER='no'
ZIP_EXPORT_FOLDER='no'
NUMBER_SECTIONS='no'
NUMBER_OFFSET='no'
CURRENT_NUMBER_OFFSET=1
REMOVE_GENERATE_MD_FILES='yes'

Configuración (III)

Podemos configurar también algunas cosas más sobre reveal.js desde el fichero build.properties

#THEME='black|white|league|sky|beige|simple|serif|blood|night|moon|solarized'
REVEAL_JS_THEME='beige'
REVEAL_JS_SHOW_TITLE_FOOTER='yes'
REVEAL_JS_DEFAULT_TITLE_FOOTER='yes'
REVEAL_JS_TITLE_FOOTER="'MarkdownSlides by @asanzdiego :-)'"
REVEAL_JS_SHOW_MENU='yes'
REVEAL_JS_SHOW_CHALKBOARD='yes'
REVEAL_JS_ONLINE='no'

Generación

Hay que posicionarse en la carpeta raiz, y ejecutar:

./build.sh [modo] [carpeta]

[modo] puede tomar los valores: min, med o máx.
[carpeta] donde va a buscar los ficheros md. Si no se indica nada convertirá todos los ficheros md de todas las carpetas.

Markdown Slides [ES]

Adolfo Sanz De Diego

@asanzdiego