General

AsciiDoc2Go is a portable version of asciidoc with all necessary software components included in one package.

Motivation for AsciidocToGo

The first steps with asciidoc are pretty easy. Just grab python and asciidoc and you are done. If you would like to use the more advanced features and optional packages like syntax highlighting for source code or the diagram tools like dot, blockdiag, mathplotlib, etc. it becomes pretty hard to get the job done. Also some filters needs external programms and asciidoc is not very verbose about what dependencies have to be solved. A lot of the software delivered with AsciidocToGo was found by source code analysis.

It will go even worse if one would like to create docbook pdf’s, because a complete LaTeX-Toolchain is needed and the dblatex installer is/was broken.

AsciidocToGo have all this in a predefined environment and adds also a shell menu in the windows explorer, so that you can just right click a txt file and create a document out of it.

It takes over a month to create the AsciidocToGo package as it is now.

About AsciidocToGo

Projectwebsite

http://dbcb.github.io/asciidocToGo

Repository

https://github.com/dbcb/asciidocToGo

License

AsciidocToGo and third party packages Licenses

User Manual

./Manual.html

Included Software packages

Not (yet) included Software Packages

TODO:

qrencode: https://code.google.com/p/qrencode-win32/

MikTex

Some packages are missing in miktex and have to be manually installed.

Install them with mpm_mfc_admin.exe!

Miktex can’t install packages:

Example of AsciidocToGo

Source Code Highlighting

AsciidocToGo use highlight.exe for syntax highlighting of source code

int Test(void)
{
    // SomeCode
}

Mathplotlib

AsciidcoToGo has build in support for mathplotlib

example_sin.png

Graphviz (Dot)

Diagramms printed with dor

example_dot.png

Blockdiag

Diagramms printed with blockdiag. Refer to the following link for more examples: Examples

" "
images/example-blockdiag.svg

actdiag

Diagramms printed with actdiag. Refer to the following link for more examples: Examples

" "
images/example-actdiag.svg

SeqDiag

Seqdiag Is a dRawing engine for sequence diagrams.

Refer to "Seqdiag Webpage"

" "
images/example-seqdiag.svg

NwDiag

NwDiag is used to draw network related stuff like:

  • Networks topology,

  • IP-Ranges,

  • Protocols,

  • …

Refer to "nwdiag website"

" "
images/example-nwdiag.svg

PacketDiag

PacketDiag is a diagramm tool for any kind of digital network protocols.

Please refer to: PacketDiag Website

" "
images/example-packetdiag.svg