Tutorial superbasico AsciiDoctor

Primer ejemplo de Asciidoctor.

*esto en negrita*

_esto en cursiva_

est**o** tiene negrita solo la o

Y si queremos que lo renderize tal cual pues \*usamos* una barra en el primero

.Una lista con titulo
- una lista de elementos 1
- una lista de elementos 2

* una sublista de elementos de 2
* una sublista de elementos de 2

.Esto es una lista ordenada
. fijate en que usamos el punto
. en lugar del guión

.Y esto una lista etiquetada
UNO:: El primer numero
DOS:: El que va después
MONO:: Qué pinta un mono
en una lista
etiquetada (fijate que la linea está separada
en el fichero para mejorar su edición)

image::homer.jpg[]

[quote, Homer, en algún capítulo]
Para empezar presionar cualquier tecla ¿ Dónde está la tecla "cualquier" ?

|===

| Cell in column 1, row 1 | Cell in column 2, row 1

| Cell in column 1, row 2 | Cell in column 2, row 2

| Cell in column 1, row 3 | Cell in column 2, row 3

|===


[cols="3*"]
.Tabla con titulo
|===
|si queremos poner cada celda
|en una linea
|mejor indicarle en la cabecera cuantas columnas son

|si queremos poner cada celda
|en una linea
|mejor indicarle en la cabecera cuantas columnas son
|===

[cols="1,2,1"]
.Tabla repartiendo espacio
|===
|si queremos poner cada celda
|en una linea
|mejor indicarle en la cabecera cuantas columnas son

|si queremos poner cada celda
|en una linea
|mejor indicarle en la cabecera cuantas columnas son
|===

[cols="<,^,>"]
.Tabla alineando
|===
|a la izquierda
|centrada
|a la derecha

|a la izquierda
|centrada
|a la derecha
|===


[cols=".<2,.^5,^.>3"]
.Tabla copiada de la docu oficial
|===
|Cell in column 1, row 1 with lots and lots and lots and lots of content
|Cell in column 2, row 1
|Cell in column 3, row 1

|Cell in column 1, row 2
|Cell in column 2, row 2
|Cell in column 3, row 2 and another bucket of content, and then a jelly roll of content
|===


Lógicamente podemos indicar nuestras cabeceras si así se lo decimos:

[cols=2*,options="header"]
|===
|Name of Column 1
|Name of Column 2

|Cell in column 1, row 1
|Cell in column 2, row 1

|Cell in column 1, row 2
|Cell in column 2, row 2
|===

mvn clean install

mvn clean install

gradle init

gradle asciidoctor

./gradlew asciidoctor  (en linux)

gradlew.bat asciidoctor (en windows)

<?xml
....
   <plugin>
    <groupId>org.asciidoctor</groupId>
    <artifactId>asciidoctor-maven-plugin</artifactId>
    <version>1.5.3</version>
    <dependencies>      (1)
        <dependency>
            <groupId>org.asciidoctor</groupId>
            <artifactId>asciidoctorj-pdf</artifactId>
            <version>1.5.0-alpha.11</version> (2)
        </dependency>
    </dependencies>

  <execution>   (1)
    <id>generate-pdf</id>
    <phase>generate-resources</phase>
    <goals>
        <goal>process-asciidoc</goal>
    </goals>
    <configuration>
        <backend>pdf</backend>   (2)
        <doctype>book</doctype>
        <sourceDocumentExtensions>adoc</sourceDocumentExtensions>
        <attributes>
        </attributes>
    </configuration>
 </execution>

dependencies{
    asciidoctor 'org.asciidoctor:asciidoctorj-pdf:1.5.0-alpha.11' (1)
}

task buildHtml(type:org.asciidoctor.gradle.AsciidoctorTask){  (2)
    backends 'html5'
    attributes \
        'build-gradle': file('build.gradle'),
        'source-highlighter': 'coderay',
        'toc': 'left',
        'icons': 'font',
        'setanchors': '',
        'idprefix': '',
        'idseparator': '-',
        'docinfo1': ''
    sources{
        include 'index.adoc'
    }
}

// de forma análoga buildPdf con backend 'pdf'

build.dependsOn = ['buildHtml','buildPdf']  (3)

[ditaa,asciidoctor-diagram-process]
....
                   +-------------+
                   | Asciidoctor |-------+
                   |   diagram   |       |
                   +-------------+       | PNG out
                       ^                 |
                       | ditaa in        |
                       |                 v
 +--------+   +--------+----+    /---------------\
 |        |---+ Asciidoctor +--->|               |
 |  Text  |   +-------------+    |   Beautiful   |
 |Document|   |   !magic!   |    |    Output     |
 |     {d}|   |             |    |               |
 +---+----+   +-------------+    \---------------/
     :                                   ^
     |          Lots of work             |
     +-----------------------------------+
....

[plantuml,casos-de-uso-crud,png]
....
left to right direction
skinparam packageStyle rect
title Productos y lugares

actor Usuario as usuario

rectangle red{
    usuario -- (lugares)
    (lugares) <.. (alta lugar) : extend
    (lugares) <.. (modificacion lugar) : extend
    (lugares) <.. (ver lugar) : extend

    (productos) ...> (ver lugar)
    usuario -- (productos)
    (productos) <.. (alta producto) : extend
    (productos) <.. (modificacion producto) : extend
}

....

[plantuml,secuencia-login,png]
....
title Login
autonumber

actor Anonimo
control Api
control Security
entity Usuario
database Neo4j

Anonimo -> Api  : login username
Api -> Usuario : findByUsername
Usuario -> Neo4j : match n

alt username registered

Usuario --> Api: found
Api -> Api: check password

    alt successfull

        Api -> Security: generate token
        Security --> Api: token
        Api --> Anonimo: token

    else doesn't match

        Api --> Anonimo: 403

    end

else username not registered

Usuario --> Api: not found
Api --> Anonimo: error 403

end
....

[mermaid]
....
gantt
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid
        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d
        Future task               :         des3, after des2, 5d
        Future task2               :         des4, after des3, 5d
        section Critical tasks
        Completed task in the critical line :crit, done, 2014-01-06,24h
        Implement parser and jison          :crit, done, after des1, 2d
        Create tests for parser             :crit, active, 3d
        Future task in critical line        :crit, 5d
        Create tests for renderer           :2d
        Add to mermaid                      :1d
....

Failed to generate image: Could not find the 'mermaid' executable in PATH; add it to the PATH or specify its location using the 'mermaid' document attribute
gantt
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid
        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d
        Future task               :         des3, after des2, 5d
        Future task2               :         des4, after des3, 5d
        section Critical tasks
        Completed task in the critical line :crit, done, 2014-01-06,24h
        Implement parser and jison          :crit, done, after des1, 2d
        Create tests for parser             :crit, active, 3d
        Future task in critical line        :crit, 5d
        Create tests for renderer           :2d
        Add to mermaid                      :1d

<plugin>
    <groupId>org.asciidoctor</groupId>
    <artifactId>asciidoctor-maven-plugin</artifactId>
    <version>1.5.3</version>
    <dependencies>
      <dependency>
        <groupId>org.asciidoctor</groupId>
        <artifactId>asciidoctorj</artifactId>
        <version>1.5.4.1</version>
      </dependency>
      <dependency>
         <groupId>org.asciidoctor</groupId>
         <artifactId>asciidoctorj-diagram</artifactId>
         <version>1.5.0</version>
     </dependency>
    </dependencies>

<requires>
  <require>asciidoctor-diagram</require>
</requires>

= primera linea del documento
autor
fecha
:atributo1: valor1
..
:stem:  (1)

Desde pequeño aprendes que:

[stem]
++++
sqrt(4) = 2
++++

y que la fórmula del agua

[stem]
++++
H_2O
++++

es la primera que aprendes cuando el colegio se vuelve ya serio

Cuando

[stem]
++++
a \ne 0
++++

hay dos soluciones a

[stem]
++++
ax^2 + bx + c = 0
++++

que son

[stem]
++++
x = (-b +- sqrt(b^2-4ac))/(2a)
++++

Algunas tonterias sin mucho sentido (o sí?)

[stem]
++++
sum_(i=1)^n i^3=((n(n+1))/2)^2
++++

[stem]
++++
+-beta * omega = [[a,b],[c,d]]
++++

[stem]
++++
lim_(x->oo) = int_0^1 f(x)dx
++++