Skip to content
Albert Tregnaghi edited this page Oct 29, 2018 · 22 revisions

How can I install the plugin?

Use the eclipse marketplace client and search for asciidoc or open https://marketplace.eclipse.org/content/asciidoctor-editor

How can I sync editor with internal preview?

When preference Link editor with internal preview is enabled cursor movement to headlines and anchors inside editor will scroll to corresponding part in preview. This works also from outline view.

PlantUML not working

39388377 e2b41568 4a7f 11e8 8633 2e4206b0abc2

This will happen on every machine where plantuml is executed and graphviz is not already installed. PlantUML uses this product to render the images. Its free, see https://graphviz.gitlab.io/license/

So download and install it on your machine: https://www.graphviz.org/download/ (when .msi installer on a windows server you should install graphviz for all users)

Initial installation slow, updates fast ?

The initial installation takes a long time, but updates are extreme fast - why?

AsciiDoctor editor is an feature which contains following plugins:

  • asciidoctor-editor-plugin

  • asciidoctor-editor-libs (complete jruby, complete asciidoctor (ruby gems) + asciidoctorj (1.5.6))

  • asciidoctor-editor-css (fat css styles for font-awesome and co.)

At installation time all parts of the feature are automatically installed, so you got always all dependencies.

The big dependencies are packaged inside libs and css plugins which are pretty stable. So normally no newer versions are available. The logic of Asciidoctor Editor is kept inside asciidoctor-editor-plugin. So bugfixes, new features etc. normally lead only to a newer asciidoctor-editor-plugin version which is pretty small

How can I use installed "native" asciidoctor?

How can I install "native" asciidoctor?

Please look at https://asciidoctor.org/docs/install-toolchain/ for detailed information

How can I turn off/on building Asciidoctor preview?

External preview auto build can be configured in preferences and is turned off per default.

Preference example to disable auto build for external preview

More information can be found at Issue 143

In a nutshell:

  • install ruby on your OS

  • execute gem install asciidoctor

  • execute gem install asciidoctor-diagram

Clone this wiki locally