Plugin Exercises!
Este plugin permite introducir ejercicios interactivos, a modo de que el lector pueda, por ejemplo, escribir la solución de un problema para posteriormente el autor del gitbook pueda verificarla y validarla.
¿Cómo podemos instalar este plugin?
Debemos instalar el siguiente paquete y añadirlo a nuestro package.json:
$ npm install gitbook-plugin-exercises --save-dev
Una vez instalado, debemos incorporar el plugin en nuestro fichero book.json
{
"plugins": ["exercises"]
}
Finalmente, ejecutamos el siguiente comando para instalar y preparar el plugin: bash
$ gitbook install
¿Cómo podemos usar este plugin?
Cada ejercicio debe definirse siguiente la siguiente estructura basada en 4 partes fundamentales:
- Mensaje u objetivo del ejercicio:
{ % exercise % }
"Mensaje o enunciado del ejercicio"
- Código inicial que se muestra al usuario. Punto de partida:
{ % initial % }
"Condiciones y datos iniciales que se muestran al usuario para que resuelta el mensaje"
- Solucion del ejercicio
{ % validation % }
"Solucion del ejercicio"
- Código de validación de resultado
{ % context % }
"Código que comprueba si el resultado del usuario es correcto"
- Fin del ejercicio
{ % endexercise % }
Ejemplo
{ % exercise % }
Definir una variable res que contenga el resultado de la siguiente operacion: (5-4).
{ % initial % }
var resultado =
{ % solution % }
var resultado = 1;
{ % validation % }
assert(resultado == 1);
{ % context % }
function magicFunc() {
return 3;
}
{ % endexercise % }
Exercise
Correct!
var resultado=
var resultado = 1;
assert(resultado == 1);
function magicFunc(){
return 3;
}