asciidoctor-diagram 2.2.8 → 2.2.10

data/docs/modules/ROOT/partials/advanced.adoc

@@ -1,397 +0,0 @@
-== Advanced Usage
-
-=== Enabling Extensions
-
-In your program, you can either load and register the entire set of diagram extensions
-
-[source,ruby]
-----
-require 'asciidoctor-diagram'
-----
-
-or load and register each extension individually.
-
-[source,ruby]
-----
-require 'asciidoctor-diagram/<extension_name>'
-----
-
-`<extension_name>` can be one of `a2s`, `blockdiag`, `bytefield`, `diagrams`, `ditaa`, `dpic`, `erd`, `gnuplot`, `graphviz`, `meme`, `mermaid`, `msc`, `pikchr`, `plantuml`, `shaape`, `smcat`, `svgbob`, `syntrax`, `umlet`, `vega` or `wavedrom`.
-
-Requiring one or more of these files will automatically register the extensions for all processed documents.
-
-If you need more fine-grained control over when the extensions are enabled, `asciidoctor-diagram/<extension_name>/extension` can be used instead.
-This loads the extensions but does not register it in the Asciidoctor extension registry.
-You can then manually register the extensions at the appropriate times using the `Asciidoctor::Extensions` API.
-
-This document explains the various features of asciidoctor-diagram blocks using ditaa diagrams as an example.
-
-=== Diagram Macros
-
-The diagram extensions can also be used in inline, or block macro form.
-
-.Anatomy of a diagram block macro
-----
-diagram-type::source-file-name[format=output-format] // <1> <2> <3>
-----
-<1> The macro name specifies the diagram syntax that is being used.
-<2> The source file name specifies the external file that contains the diagram source code.
-<3> The `format` attribute determines the output image format to use. If a format is not specified, the default output format for the chosen diagram type will be used.
-
-When the source file name is a relative path it is resolved with respect to the location of the document being processed.
-
-=== Image Output Location
-
-When Asciidoctor Diagram writes images to disk it will go over the following options in order to determine where to write the files.
-
-. `\{imagesoutdir\}` if the `imagesoutdir` attribute has been specified
-. `\{outdir\}/\{imagesdir\}` if the `outdir` attribute has been specified
-. `\{to_dir\}/\{imagesdir\}` if the `to_dir` attribute has been specified
-. `\{base_dir\}/\{imagesdir\}`
-
-=== Image Cache Location
-
-The image generation also outputs metadata files that by default are located in `.asciidoctor/diagram`.
-To place them in different location, Asciidoctor Diagram checks for (in this order).
-
-. `\{cachedir\}` attribute is specified  in the block header (i.e. `[plantuml, png, cachedir=my-cache]`)
-. `\{diagram-cachedir\}` if the `diagram-cachedir` attribute has been specified
-. `\{outdir\}/\{imagesdir\}`
-
-=== Specifying Diagram Generator Paths
-
-Asciidoctor Diagram depends on external tools to generate images.
-In most cases it will locate these tools automatically for you by looking for specific executables in each directory in the `PATH` environment variable.
-In case you've installed a tool in a way where the executable is not in the `PATH`, you can override its location manually using document attributes.
-The following table lists the tools that are required for each diagram type, the location where they can be downloaded and the document attribute you can use to override their locations.
-
-[cols=">,2*<",options="header"]
-|===
-   |Diagram Type |Tool                                                                  |Attribute
-   |a2s          |{uri-a2s}[AsciiToSvg]                                                 |`a2s`
-   |actdiag      |{uri-actdiag}[ActDiag]                                                |`actdiag`
-   |blockdiag    |{uri-blockdiag}[BlockDiag]                                            |`blockdiag`
-   |bpmn         |{uri-bpmn}[bpmn-js-cmd]                                               |`bpmn`
-   |bytefield    |{uri-bytefield}[bytefield-svg]                                        |`bytefield-svg`
-   |diagrams     |{uri-python}[Python]                                                  |`diagrams-python`
-   |D2           |{uri-d2}[D2]                                                          |`d2`
-   |DBML         |{uri-dbml}[dbml-renderer]                                             |`dbml-renderer`
-   |ditaa        |{uri-java}[Java]                                                      |`java`
-   |dpic         |{uri-dpic}[dpic]                                                      |`dpic`
-   |erd          |{uri-erd}[Erd] or {uri-erd-go}[Erd Go]                                |`erd`
-   |gnuplot      |{uri-gnuplot}[Gnuplot]                                                |`gnuplot`
-   |graphviz     |{uri-graphviz}[GraphViz]                                              |`dot` or `graphvizdot`
-   |meme         |{uri-imagemagick}[ImageMagick]                                        |`convert` and `identify`
-   |mermaid      |{uri-mermaid}[Mermaid.cli]                                            |`mmdc`
-   |msc          |{uri-mscgen}[Mscgen] or {uri-mscgen-js}[mscgen.js]                    |`mscgen`
-   |nomnoml      |{uri-nomnoml}[Nomnoml]                                                |`nomnoml`
-   |nwdiag       |{uri-nwdiag}[NwDiag]                                                  |`nwdiag`
-   |packetdiag   |{uri-nwdiag}[NwDiag]                                                  |`packetdiag`
-   |pikchr       |{uri-pikchr}[Pikchr]                                                  |`pikchr`
-   |plantuml     |{uri-java}[Java]                                                      |`java`
-   |rackdiag     |{uri-nwdiag}[NwDiag]                                                  |`rackdiag`
-   |seqdiag      |{uri-seqdiag}[SeqDiag]                                                |`seqdiag`
-   |shaape       |{uri-shaape}[Shaape]                                                  |`shaape`
-   |smcat        |{uri-smcat}[State Machine Cat]                                        |`smcat`
-   |structurizr  |{uri-java}[Java] and {uri-structurizr}[Structurizr CLI]               |`java` and the `DIAGRAM_STRUCTURIZRCLI_HOME` environment variable
-   |svgbob       |{uri-svgbob}[SvgBob]                                                  |`svgbob`
-   |symbolator   |{uri-symbolator}[Symbolator]                                          |`symbolator`
-   |syntrax      |{uri-syntrax}[Syntrax]/{uri-jsyntrax}[JSyntrax]                       |`syntrax` or `java` and the `DIAGRAM_JSYNTRAX_HOME` environment variable
-   |tikz         |A TeX distribution that supports {uri-tikz}[TikZ]                     |`pdflatex` and `pdf2svg`
-   |umlet        |{uri-umlet}[Umlet]                                                    |`umlet`
-   |vega         |{uri-vega}[vg2png] and/or {uri-vega}[vg2png]                          |`vg2png` and `vg2svg`
-   |vegalite     |{uri-vegalite}[vl2vg] and {uri-vega}[vg2png] and/or {uri-vega}[vg2svg]|`vl2vg`, `vg2png` and `vg2svg`
-.2+|wavedrom     |{uri-wavedromeditor}[WaveDrom Editor]                                 |`wavedrom`
-                <|{uri-wavedromcli}[WaveDrom CLI] (and {uri-phantomjs}[PhantomJS] for WaveDrom CLI v1)      |`wavedrom` (and `phantomjs`)
-|===
-
-If for instance you installed `actdiag` in `/home/me/actdiag/bin` and this path is not included in the `PATH` you can specify its location on the command line
-
- $ asciidoctor -a actdiag=/home/me/actdiag/bin/actdiag -r asciidoctor-diagram sample.adoc
-
-[[meme]]
-=== The Meme Extension
-
-The meme extension provides a basic '`Advice Animal`' style image generator.
-Its usage is easiest to explain with an example.
-
-----
-meme::yunoguy.jpg[Doc writers,Y U NO // AsciiDoc]
-----
-
-The target of the block macro tells the extension which image to use as background.
-The first two positional attributes are `top` and `bottom` and are used for the top and bottom label.
-Occurrences of `//` surrounded by whitespace are interpreted as line breaks.
-
-[[barcode]]
-=== The Barcode Extension
-
-The barcode extension provides barcode rendering.
-Barcode macros can be specified using blocks, inline macros or block macros using one of the following templates.
-
-[source, asciidoc]
-------
-// Barcode block
-[<type>, <attributes>] <1> <2>
-----
-<content> <3>
-----
-
-// Barcode block macro
-<type>::<content>[<attributes>]
-
-// Barcode inline macro
-<type>::<content>[<attributes>]
-------
-<1> Type barcode type. One of `bookland`, `codabar`, `code25`, `code25iata`, `code25interleaved`, `code39`, `code93`, `code128`, `code128a`, `code128b`, `code128c`, `ean8`, `ean13`, `gs1_128`, `qrcode`, or `upca`.
-<2> Barcode attributes (see the <<barcode_attributes>> attributes section)
-<3> The content to encode in the barcode
-
-By default, the `content` field of the barcode macros will be interpreted as the barcode content.
-This works fine for simple barcodes, but for complex data (e.g., a vCard encoded as a QR code) this is not practical.
-If the `external` attribute is set on a barcode macro, the target is interpreted as a file path.
-The barcode content will then be obtained by reading the contents of the referenced file.
-
-=== Diagram Attributes
-
-Certain diagram types allow image generation to be customized using attributes.
-Each attribute can be specified per individual diagram block or for all blocks of a given diagram type in a document level.
-This is illustrated for the blockdiag `fontpath` attribute in the example below.
-
-----
-= Asciidoctor Diagram
-:blockdiag-fontpath: /path/to/font.ttf <1>
-
-[blockdiag] <2>
-....
-....
-
-[blockdiag, fontpath="/path/to/otherfont.ttf"] <3>
-....
-....
-----
-<1> Attributes can be specified for all diagram of a certain type at the document level by prefixing them with `<blocktype>-`.
-In this example, the `fontpath` attribute is specified for all diagrams of type `blockdiag`.
-<2> The first diagram does not specify an explicit value for `fontpath` so the global `blockdiag-fontpath` value will be used
-<3> The second diagram does specify a `fontpath` value.
-This overrides the global `blockdiag-fontpath` value.
-
-Each attribute can either be specified at the block level or at the document level.
-The attribute name at the document level should be prefixed with the diagram type name and a dash.
-
-==== Shared Attributes
-
-The set of shared attributes applies to all diagram types.
-The value for these attributes can be defined at the document level for a single diagram type using the diagram type as prefix or for all diagram types using `diagram` as prefix.
-
-[cols=">,<,<",options="header"]
-|===
-|Name          |Default value   |Description
-|svg-type      |unspecified     |One of `static`, `inline` or `interactive`.
-This determines the style of SVG embedding that's used in certain backends.
-The xref:asciidoc:macros:image-svg.adoc[asciidoc spec] describes this in more detail.
-|server-url    |unspecified    |External service to render diagram.
-Usage removes the need to depend on external tools to be installed locally.
-|server-type   |unspecified    |One of `plantuml` or `kroki_io`
-|max-get-size  |1024           |The maximum size of the URI path for HTTP GET requests.
-If the maximum size is exceeded, POST requests are used instead
-|===
-
-==== AsciiToSVG
-
-[cols=">,<,<",options="header"]
-|===
-|Name         |Default value   |Description
-|fontfamily   |unspecified     |The font family to use in the generated SVG image
-|noblur       |unspecified     |Disable drop-shadow blurring
-|===
-
-[[barcode_attributes]]
-==== Barcode
-
-[cols=">,<,<",options="header"]
-|===
-|Name          |Default value |Description
-|height        |100           |The height of the bars. (1D only, 2D uses ydim)
-|xdim          |1             |The width of the narrowest bar in a barcode. Thicker bars are multiples of the xdim.
-|ydim          |Same as xdim  |This is the same as xdim, but for the height of the blocks in a 2D barcode.
-|margin        |10            |The width of the quiet zone around the barcode.
-|foreground    |black         |The color of the bars specified as a 3 or 6 digit hex RGB value or HTML color name.
-|background    |white         |The color of the background specified as a 3 or 6 digit hex RGB value or HTML color name.
-|===
-
-==== Blockdiag
-
-[cols=">,<,<",options="header"]
-|===
-|Name         |Default value   |Description
-|fontpath     |unspecified     |The path to the font that should be used by blockdiag
-|===
-
-==== BPMN
-
-[cols=">,<,<",options="header"]
-|===
-|Name         |Default value   |Description
-|height       |786             |The target height of the diagram. Does not apply for output type `svg`.
-|width        |1024            |The target width of the diagram. Does not apply for output type `svg`.
-|===
-
-==== D2
-
-[cols=">,<,<",options="header"]
-|===
-|Name            |Default value                 |Description
-|layout          |dagre                         |Set the diagram layout engine
-|theme           |0                             |Set the diagram theme ID
-|pad             |100                           |Pixels padded around the rendered diagram
-|animate-interval|                              |If given, multiple boards are packaged as 1 SVG which transitions through each board at the interval (in milliseconds). Can only be used with SVG exports.
-|sketch          |false                         |Renders the diagram to look like it was sketched by hand
-|font-regular    |Source Sans Pro Regular       |Path to .ttf file to use for the regular font
-|font-italic     |Source Sans Pro Regular-Italic|Path to .ttf file to use for the italic font
-|font-bol        |Source Sans Pro Bold          |Path to .ttf file to use for the bold font
-|===
-
-==== DBML
-
-No specific attributes.
-
-==== Diagrams
-
-No specific attributes.
-
-==== Ditaa
-
-[cols=">,<,<",options="header"]
-|===
-|Name         |Default value   |Description
-|scale        |1               |A scale factor that is applied to the image.
-|tabs         |8               |An integer value that specifies the tab size as a number of spaces.
-|background   |FFFFFF          |The background colour of the image. The format should be a six-digit hexadecimal number (as in HTML, FF0000 for red). Pass an eight-digit hex to define transparency.
-|antialias    |true            |Enables or disables anti-aliasing.
-|separation   |true            |Prevents the separation of common edges of shapes.
-|round-corners|false           |Causes all corners to be rendered as round corners.
-|shadows      |true            |Enables or disable drop shadows.
-|debug        |false           |Renders the debug grid over the resulting image.
-|fixed-slope  |false           |Makes sides of parallelograms and trapezoids fixed slope instead of fixed width.
-|transparent  |false           |Makes the background of the image transparent instead of using the background color.
-|bullet-characters|*o          |The characters to recognize as bullets
-|===
-
-==== Gnuplot
-
-[cols=">,<,<",options="header"]
-|===
-|Name         |Default value   |Description
-|background   |unspecified     |Background color, e.g. `red`, `#FF0000`. Does not work with `txt`.
-|height       |unspecified     |The height of the plot. Must be specified together with `width`.
-|width        |unspecified     |The width of the plot. Must be specified together with `height`.
-|crop         |unspecified     |Trims blank space from the edges of the completed plot (true/false). Does not work with `svg`, `pdf`.
-|transparent  |unspecified     |Generate transparent background (true/false). Does not work with `svg`, `pdf`, `txt`.
-|font         |unspecified     |The font face with optional font size to use for the text, e.g. `font="Arial"`, `font="Arial,11"`. Does not work with `txt`.
-|fontscale    |unspecified     |Scales all label for given factor. Does not work with `txt`.
-|===
-
-==== GraphViz
-
-[cols=">,<,<",options="header"]
-|===
-|Name         |Default value   |Description
-|layout       |unspecified     |The graphviz layout engine to use (dot -K option).
-|===
-
-==== Meme
-
-[cols=">,<,<",options="header"]
-|===
-|Name          |Default value |Description
-|fill-color    |white         |The fill color for the text.
-|stroke-color  |black         |The outline color for the text
-|stroke-width  |2             |The width of the text outline.
-|font          |Impact        |The font face to use for the text.
-|options       |unspecified   |a comma separate list of flags that modify the image rendering. Currently only `noupcase` is supported which disable upper casing the labels.
-|===
-
-==== Mermaid
-
-[cols=">,<,<",options="header"]
-|===
-|Name            |Default value   |Description
-|background      |FFFFFF          |The background colour of the image. The format should be a six-digit hexadecimal number (as in HTML, FF0000 for red). Pass an eight-digit hex to define transparency.
-|css             |unspecified     |Path to a CSS file to pass to mermaid.
-|config          |unspecified     |Path to a JSON config file to pass to mermaid.
-|gantt-config    |unspecified     |Path to a gantt config file to pass to mermaid.
-|puppeteer-config|unspecified     |Path to a puppeteer config file to pass to mermaid.
-|sequence-config |unspecified     |Path to a sequence config file to pass to mermaid.
-|theme           |unspecified     |Theme of the chart, could be default, forest, dark or neutral.
-|width           |unspecified     |Width of the page.
-|height          |unspecified     |Height of the page.
-|===
-
-==== Msc
-
-[cols=">,<,<",options="header"]
-|===
-|Name         |Default value   |Description
-|font         |unspecified     |The name of the font that should be used by mscgen
-|===
-
-==== PlantUML
-
-[cols=">,<,<",options="header"]
-|===
-|Name            |Default value   |Description
-|config          |unspecified     |Path to a config file to pass to PlantUML.
-|theme           |unspecified     |PlantUML theme to use.
-|size-limit      |4096            |The maximum dimensions (width and height) of generated diagrams.
-|includedir      |unspecified     |sets a common directory for puml includes (plantuml.include.path)
-|preprocess      |true            |Preprocess PlantUML code before rendering the diagram.
-|===
-
-==== State Machine Cat
-
-[cols=">,<,<",options="header"]
-|===
-|Name          |Default value   |Description
-|direction     |unspecified     |The direction of the state machine diagram. One of `top-down`, `bottom-top`, `left-right` or `right-left`.
-|engine        |unspecified     |The layout engine to use. One of `dot`, `circo`, `fdp`, `neato`, `osage`, or `twopi`
-|===
-
-==== Structurizr
-
-[cols=">,<,<",options="header"]
-|===
-|Name          |Default value   |Description
-|renderer      |plantuml-c4     |The rendering backend to use. One of `d2`, `graphviz`, `mermaid`, `plantuml`, or `plantuml-c4`
-|view          |unspecified     |The key of the view to render
-|===
-
-==== svgbob
-
-[cols=">,<,<",options="header"]
-|===
-|Name          |Default value   |Description
-|font-family   |arial           |text will be rendered with this font
-|font-size     |14              |text will be rendered with this font size
-|scale         |1               |scale the entire svg (dimensions, font size, stroke width) by this factor
-|stroke-width  |2               |stroke width for all lines
-|===
-
-==== Syntrax
-
-[cols=">,<,<",options="header"]
-|===
-|Name          |Default value   |Description
-|heading       |unspecified      |Diagram title
-|scale         |1               |A scale factor that is applied to the image.
-|style-file    |unspecified      |Path to a style config file to pass to Syntrax.
-|transparent   |false           |Makes the background of the image transparent instead of opaque white.
-|===
-
-==== TikZ
-
-[cols=">,<,<",options="header"]
-|===
-|Name          |Default value   |Description
-|preamble      |unspecified     |Code definitions to pass to TikZ.
-|===

data/docs/modules/ROOT/partials/installation.adoc

@@ -1,19 +0,0 @@
-== Installation
-
-Asciidoctor Diagram is a RubyGem, which can be installed using the `gem` or `bundle` commands.
-
-You can install the Asciidoctor Diagram gem by typing `gem install` in the CLI.
-
- $ gem install asciidoctor-diagram
-
-by first adding the following entry to your project's [.path]_Gemfile_.
-
-.Gemfile
-[source,ruby]
-----
-gem 'asciidoctor-diagram'
-----
-
-Then execute `bundle` in the CLI.
-
- $ bundle