javiereguiluz / easybook

Book publishing as easy as it should be (built with Symfony components)
https://easycorp.io/EasyBook
Other
754 stars 81 forks source link

No funciona correctamente el coloreado de sintaxis de los bloques de código (highlight) #107

Closed oscarAguayo closed 11 years ago

oscarAguayo commented 11 years ago

En el Apéndice A.1, A.2 de la documentación de easybook, se dice que easybook soporta la sintaxis básica y la sintaxis extendida de Markdown, cosa que lo hace, al reconocer correctamente los bloques de código, lo que NO hace correctamente es colorear automáticamente la sintaxis de los listados de código utilizando esas sintaxis de Markdown. La única forma en la que funciona el coloreado de sintaxis en los bloques de código, es si en estos, se dejan 4 espacios en blanco, si se utiliza 1 Tab o si se utiliza los bloques de código alternativos de la sintaxis de PHP Markdown Extra el coloreado de la sintaxis NO funciona... ejemplos:

Sintaxis oficial de Markdown.

1.- Haciendo bloques de código utilizando 4 espacios en blanco... funciona!

[java]
public class HolaMundo {
    public static void main(String[] args) {
        System.out.println("¡Hola, mundo!");
    }
}

2.- Haciendo bloques de código utilizando 1 Tab... No funciona! (Bug)

[java]
public class HolaMundo {
    public static void main(String[] args) {
        System.out.println("¡Hola, mundo!");
    }
}

Con la sintaxis de PHP Markdown Extra.

1.- Haciendo bloques de códgo utilizando ~ y utilizando el coloreado de la sintaxis de easybook... No funciona! (Bug)

    ~~~
    [java]
    public class HolaMundo {
        public static void main(String[] args) {
            System.out.println("¡Hola, mundo!");
        }
    }
    ~~~

1.1.- Haciendo bloques de código utilizando ~ y utilizando el coloreado de la sintaxis de PHP Markdown Extra... No funciona! (sugerencia)

    ~~~~~ .java
    public class HolaMundo {
        public static void main(String[] args) {
            System.out.println("¡Hola, mundo!");
        }
    }
    ~~~~~

1.2.- Haciendo bloques de código utilizando ~ y en un intento desesperado basándome en el coloreado de la sintaxis de PHP Markdown Extra y utilizando la de easybook... No funciona! (esto solo fue un intento)

    ~~~ [java]
    public class HolaMundo {
        public static void main(String[] args) {
            System.out.println("¡Hola, mundo!");
        }
    }
    ~~~
javiereguiluz commented 11 years ago

@oscarAguayo ¡muchas gracias por el informe tan detallado de los errores producidos en los listados de código!

Recientemente la gestión de los listados de código se ha renovado por completo y ahora se soportan (espero que sin errores) tres estilos diferentes de listados: el tradicional tabulado ([php]), el de PHP Markdown Extra (~~~ .php) y el de Github (```php).

Aquí tienes los detalles: http://easybook-project.org/blog/easybook-improves-the-code-listings-for-technical-books/