Skip to main content
  • Log in
  • Manage Cookies
Eclipse Plugins, Bundles and Products - Eclipse Marketplace
  • My Marketplace
  • Add Content
  • More
      • Community

      • Marketplace
      • Events
      • Planet Eclipse
      • Newsletter
      • Videos
      • Blogs
      • Participate

      • Report a Bug
      • Forums
      • Mailing Lists
      • Wiki
      • IRC
      • Research
      • Eclipse IDE

      • Download
      • Learn More
      • Documentation
      • Getting Started / Support
      • How to Contribute
      • IDE and Tools
      • Newcomer Forum
    • Search

  1. Home
  2. Marketplace
  3. Tools
  4. Asciidoctor Editor

Please be aware that some listings have been temporarily delisted from our marketplace in order to improve the security of the platform. We apologize for any inconvenience this may caused.

For more information on this matter, please visit #1.

If you are a listing owner and would like to have your listing(s) reinstated, please open a ticket at https://gitlab.eclipse.org/eclipsefdn/it/websites/marketplace.eclipse.org/-/issues.

Thank you for your understanding and cooperation.

Asciidoctor Editor

Asciidoctor Editor
177
29
Install

Drag to Install!

Drag to your running Eclipse* workspace.
*Requires Eclipse Marketplace Client

Add this URL to your Eclipse Installation to reach this solution's update site.

2023-03 (4.27)
2022-12 (4.26)
2022-09 (4.25)
2022-06 (4.24)
2022-03 (4.23)
2021-12 (4.22)
2021-09 (4.21)
2021-06 (4.20)
2021-03 (4.19)
2020-12 (4.18)
2020-09 (4.17)
2020-06 (4.16)
2020-03 (4.15)
2019-12 (4.14)
2019-09 (4.13)
2019-06 (4.12)
2019-03 (4.11)
2018-12 (4.10)

https://de-jcup.github.io/update-site-eclipse-asciidoctor-editor/update-site/

Learn more...

Screenshot 0

Screenshot 1

Screenshot 2

Screenshot 3

Details Group Tabs

Details

Asciidoctor Editor

This eclipse plugin is a text editor for asciidoc files.

Features

  • Fast html preview
  • Easy to use, no special project setup necessary (YouTube video)
  • Can generate overview graph for bigger documents (YouTube video)
  • Uses ASP for out-of-the-box usage (no installation of asciidoctor required) or can use installed asciidoctor with customizable CLI arguments
  • Can export to PDF
  • Code completion for pathes used in includes, images, diagrams etc. (YouTube video)
  • Supports text based diagram generation
    ( ditaa, plantuml and graphviz) (YouTube video)
  • 3 different preview modes:
    • Inline preview with editor
      • Vertical splitted
      • Horizontal splitted
      • Both variantes are immediately updated on text save
      • When cursor comes in line of anchor or headline it automatically scrolls internal preview to location - also opposite way, when selecting a headline in preview the editor part will be selected and shown (if not an included part...) (YouTube video)
    • External preview
      • Using external Browser
      • Update per autorefresh in browser
        • time configurable
        • can be turned off also
      • Interesting when having multiple monitors and wanting to have full sized text document and preview
  • Provides asciidocconfig.adoc files (YouTube video, Wiki)
  • Outline and Quickoutline
    • Headlines
    • Includes (double click opens file)
  • Syntax highlighting in Text Editor
    • Colors can be customized.
    • Dark theme automatic color support.
  • Templates + Simple code completion for existing words
  • Tooltips
  • Hyperlinking (CTRL+Mouse) and opening in IDE:
    • included asciidoc files
    • plantuml diagrams
    • ditaa diagrams
    • images
    • cross references (YouTube video)
    • external links
  • Can search for references of asciidoc files in workspace (YouTube video)
  • Convenient toolbar actions
    • Table wizard
    • Code block templates
    • Possibility to toggle TOC on/off in output view
    • Switch preview layout variant
    • Jump to top of preview (internal preview panel only)
  • Additional editors included for
    • .ditaa files
    • .plantuml files
  • Can convert one file or multiple files in selected folder
    • Formats supported:
      • markdown (*.md)
  • PlantUML editor (from Asciidoctor Editor) has many PlantUML examples (e.g. C4 diagram examples) which can be injected by toolbar action.
  • Can override attributes globally by preferences/from toolbar (YouTube video)

Links related to the plugin

  • Issue Tracker
  • Release history
  • Wiki
  • YouTube Video playlist

Additional links

  • Asciidoctor Quickreference for details about syntax
  • ditaaon github
  • plantuml
  • graphviz

Technical details

  • It uses internally ASP server or installed asciidoctor to provide a WYSWYG integration.
  • When using plantuml (or graphviz itself) you must ensure you have installed graphviz on your machine
Categories:
  • Documentation,
  • Editor,
  • Tools
Tags:
  • asciidoc,
  • asciidoctor,
  • fileExtension_adoc,
  • wysiwyg,
  • ditaa,
  • plantuml,
  • graphviz,
  • documentation,
  • doc,
  • agile documentation,
  • text,
  • editor,
  • adoc,
  • fileExtension_ditaa,
  • fileExtension_plantuml,
  • fileExtension_puml,
  • fileExtension_iuml,
  • fileExtension_pu,
  • filextension_asciidoc
Additional Details
Eclipse Versions: 
2023-03 (4.27), 2022-12 (4.26), 2022-09 (4.25), 2022-06 (4.24), 2022-03 (4.23), 2021-12 (4.22), 2021-09 (4.21), 2021-06 (4.20), 2021-03 (4.19), 2020-12 (4.18), 2020-09 (4.17), 2020-06 (4.16), 2020-03 (4.15), 2019-12 (4.14), 2019-09 (4.13), 2019-06 (4.12), 2019-03 (4.11), 2018-12 (4.10)
Platform Support: 
Windows, Mac, Linux/GTK
Organization Name: 
Albert Tregnaghi
Development Status: 
Production/Stable
Date Created: 
Thu, 2018-03-15 15:51
License: 
Apache 2.0
Date Updated: 
Fri, 2023-02-10 16:57
Submitted by: 
Albert Tregnaghi
Screenshots
Screenshot 0
Screenshot 1
Screenshot 2
Screenshot 3
Metrics
DateRankingInstallsClickthroughs
March 2023128/665269 (0.1%)13
February 2023107/668422 (0.13%)39
January 2023111/677396 (0.11%)39
December 2022119/805372 (0.11%)25
November 2022123/808413 (0.11%)21
October 2022115/811429 (0.11%)36
September 2022116/812460 (0.12%)29
August 2022125/808380 (0.11%)33
July 2022118/816411 (0.11%)33
June 2022116/810421 (0.11%)16
May 2022123/810455 (0.1%)42
April 2022131/817393 (0.09%)39
View Data for all Listings
Errors

Unsuccessful Installs in the last 7 Days: 0

Download last 500 errors (CSV)
External Install Button

Marketplace Drag to Install button

By adding the following code below to your website you will be able to add an install button for Asciidoctor Editor.

HTML Code:


Markdown Syntax:



Output: Drag to your running Eclipse* workspace. *Requires Eclipse Marketplace Client
Wednesday, March 22, 2023 - 22:24

Reviews Sign in to post reviews

atregnaghi's picture

Version 3.1.1 released

Submitted by Albert Tregnaghi on Fri, 2023-02-10 16:58

There was a bug inside auto refresh for external previews (when TOC was enabled). Has been fixed with this hotfix.

atregnaghi's picture

Version 3.1.0 released

Submitted by Albert Tregnaghi on Fri, 2023-02-10 11:39

Version 3.1.0 has been relesaed on marketplace. For details look at

https://github.com/de-jcup/eclipse-asciidoctor-editor/releases/tag/v3.1.0

 

atregnaghi's picture

Version 3.0.1 released

Submitted by Albert Tregnaghi on Mon, 2023-01-23 12:50

Version 3.0.1 has been released. The hotfix fixes the problems with base dir calculation (for example diagrams were no longer correctly resolved).

For details look at https://github.com/de-jcup/eclipse-asciidoctor-editor/releases/tag/v3.0.1

atregnaghi's picture

Version 3.0.0 has been released

Submitted by Albert Tregnaghi on Fri, 2023-01-20 13:14

This version has some breaking changes + some new features

New features

- Global asciidoc model
- Overview diagram about current document + all included and used files  
  with warnings, errors etc. inside diagram
- Zoom level setup inside plantuml diagram editor internal preview
- Using SVG external view supports now always zoom capability...
- Possibility to define global custom attributes via preferences 
- Render preferences like "attributes" and "environment" are now directly 
  accessible by user from toolbar (dedicated action)

Breaking changes

- Output images are now always SVG
- Feature of persisting output images into source folder has been removed
- It was necessary to change custom environment preference key, so those
  preferences must be edited again (sorry)

More

- For details look at 
  https://github.com/de-jcup/eclipse-asciidoctor-editor/milestone/37?closed=1
atregnaghi's picture

Version 2.7.0 released

Submitted by Albert Tregnaghi on Sat, 2022-07-30 19:32

Version 2.7.0 has been released on marketplace.
It contains hyperlinking for cross references.
The You Tube Video shows the new feature.

atregnaghi's picture

Version 2.6.1 released - fixes bug from 2.6.0

Submitted by Albert Tregnaghi on Tue, 2022-07-26 17:02

V2.6.0 had a base path calculation bug inside which resulted in problems with diagrams. I just released V2.6.1 which fixes this problem.

atregnaghi's picture

Version 2.5.1 released, fixes Windows path problem

Submitted by Albert Tregnaghi on Wed, 2022-05-04 21:29

Just released Version 2.5.1 on eclipse marketplace which handles a bug on Windows with 2.5.0

See Release V2.5.1 on GitHub for details.

mmoseri5v's picture

Image generation always timing out.

Submitted by Michael Moser on Sat, 2021-05-22 17:37

I have installed the asciidoctor plugin on a second machine. Before I did I installed the GraphViz stuff and tested it and its working (you see - I learned my lesson with this plugin).

But now I have another most annoying effect:

If I create a testfile containing just 

@startuml
testdot
@enduml

and save it then the plugin kicks in and a few seconds later I get an "image" that reads:

PlantUML verson 1.2021.2 (Sun Mar 07 12:10:27 CET 2021)
Dot version: dot - graphviz version 2.47.1 (20210417.1919)
Installation seems OK. File generation OK

So, the config seems to be working.
 

However, as soon as I save a file that contains more than just 2-3 components or classes then the image generation always hangs "forever" (i.e. a minute or so) and all I ever get is a message like:

Preview file generation timed out, so preview not available at: 
C:\Users\mmo\AppData\Local\Temp\asciidoctor-editor-temp\project_example_app-174616751\-1369575984_internal_mainclasses.html

My Laptop is pretty fast (i7 CPU (10th gen), 16GB RAM, 1TB SSD, etc.) so I doubt that a simple picture with maybe 10 rectangles can really be taking so long that the graph generation times out. 
Any idea what could cause this? 

This is on eclipse 2021-03.

atregnaghi's picture

Re: Image generation always timing out.

Submitted by Albert Tregnaghi on Wed, 2021-07-07 18:11

Hi Michael,

you have put a lot of effort into providing the information, but please create an issue in GitHub project issue tracker and provide a sample file there that triggers the problem, so I can try to reproduce it.

 

atregnaghi's picture

Re: Image generation always timing out.

Submitted by Albert Tregnaghi on Sun, 2021-05-23 20:58

@Michael Moser: I just released v2.4.1 on eclipse marketplace which contians the bugfix.
Please update and try out. Changes are described at at https://github.com/de-jcup/eclipse-asciidoctor-editor/releases/tag/v2.4.1

 

Best wishes
Albert

mmoseri5v's picture

Re: Re: Image generation always timing out.

Submitted by Michael Moser on Mon, 2021-05-31 04:12

Thanks!

Odd: on one system it's much better. On my second it's still incredibly lame (but no more timeouts, so that's definitely an improvement).

atregnaghi's picture

Re: Image generation always timing out.

Submitted by Albert Tregnaghi on Sun, 2021-05-23 16:41

Hello Michael,

I created issue #358 and copied your text there.
Please do me a favor and create issues always in official GitHub issue tracker . It's much easier to communicate and you can also update comments, examples etc.

Please refer the created issue for updates.

Best wishes

atregnaghi's picture

Version 2.3.0 released - fixes p2 update site location problem

Submitted by Albert Tregnaghi on Fri, 2021-05-07 21:49

I just deployed Version 2.3.0 to eclipse marketplace. Just do the update by the eclipse marketplace client (as usual).
The update site will automatically be updated and the new version fetched.

For details please look at https://github.com/de-jcup/eclipse-asciidoctor-editor/releases

hkneisselv4b's picture

Updatesite no longer available - alternatives?

Submitted by Hermann Kneissel on Wed, 2021-05-05 01:33

Marketplace install fails with

No repository found at ... dl.bintray.com/de-jcup/asciidoctoreditor

Is there an alternative update-site?

atregnaghi's picture

Re: Updatesite no longer available - alternatives?

Submitted by Albert Tregnaghi on Wed, 2021-05-05 19:56

I just tested - and most plugins are no longer hosted at https://bintray.com/de-jcup ! Only 3 repositories are listed: yamleditor, sqleditor, test-generic but not this one.

OMG. I have no idea why this happened - it seems this is an issue at bintray.
Nevertheless I will migrate other plugins as soon as possible and provide a new update url at marketplace.

I think I will provide a new version until end of this week.

For details look at https://github.com/de-jcup/eclipse-asciidoctor-editor/issues/333#issueco...

 

nperansin0r0's picture

No more P2 on bintray

Submitted by Nicolas PERANSIN on Tue, 2021-05-04 12:40

Hello,

I love the tool but Bintray is closed for free accounts. (I had the same issue)

Can you deploy in an other container please ? (I am considering Github-page myself)

Thanks for the great job.

Nicolas

atregnaghi's picture

Re: No more P2 on bintray

Submitted by Albert Tregnaghi on Wed, 2021-05-05 20:07

Hello Nicolas,

Yes it's always a 401 - unauthenticated... 

When I first read https://jfrog.com/blog/into-the-sunset-bintray-jcenter-gocenter-and-char... and their later updates on their website I was pretty sure that the repository data would be still available to Mai 2022.
But it seems its only for JCenter and not for bintray parts.

For details look at https://github.com/de-jcup/eclipse-asciidoctor-editor/issues/333

 

So this becomes now very urgent. I think I will provide a new version until end of this week.

amanhda's picture

C4 functionality

Submitted by Andy Man on Tue, 2021-04-06 08:20

I'm trying to use C4-PlantUML via the the !include command. Unfortunately this seems to not work with Asciidoctor. I simply copied the first example from them. The example works fine if i just use PlantUML itself.

Would be great i that would work :)

 

PS: I cannot include the links to their github because links are forbidden (lol), if you google "C4-PlantUML" you should find it easily.

mmoseri5v's picture

puml functionality not working

Submitted by Michael Moser on Sun, 2020-11-01 15:23

Freshly installed the plugin into my Eclispe 2020-09.
When I try to render a .puml file all I get is:

dot executable: null
NO dot executable found
Cannot find Graphviz. You should try

@startuml
testdot
@enduml

or java -jar plantuml.jar -testdot

Any hint or guess what's not working?

Eclipse Version: 2020-09 (4.17.0) / Build id: 20200910-1200

AsciiEditor: 2.2.0

Later edit: providing a test-file as suggested by the error message yields another error stating:

PlantUML version 1.2019.12 (Sun Nov 03 11:24:54 CET 2019)
The environment variable GRAPHVIZ_DOT has not been set
Dot executable is null
Error: Not dot executable found
Error: Only sequence diagrams will be generated.

That's at least telling a bit more. But what should I set this environment variable to? Some hints or instructions what one needs to (install and) configure before being able to use this plugin would have been helpful! Because I would have expected that this would run as-is after installing the plugin...

 

aaiezza's picture

Re: puml functionality not working

Submitted by Alessandro Aiezza on Thu, 2020-12-03 10:17

I too, would benefit from a fix.
Thank you!

In the meantime, @Michael Moser, the PlantUML plugin seems to still work great!

mmoseri5v's picture

Re: puml functionality not working

Submitted by Michael Moser on Sun, 2020-11-01 15:37

Googling further brought me here: https://github.com/de-jcup/eclipse-asciidoctor-editor/issues/47 which - among other stuff - had a link to- the download page for the graphviz utility (which is obviously required to render these files): https://www.graphviz.org/download/

I downloaded and installed the "Development Windows install packages" (x64 version) and after that the .puml visualization now works!

You may want to provide these instructions here on the plugin download page somewhere.

atregnaghi's picture

Re: Re: puml functionality not working

Submitted by Albert Tregnaghi on Wed, 2021-03-03 17:06

With #322 the editor will support also other install locations - in the meantime Plantuml must be installed standard way (as described in comment before).

mjanuf3y's picture

yml rendering configuration usage

Submitted by Mario Janu on Tue, 2020-09-29 10:42

hi, how am i able to let the ascii doctor editor use my custom yml file to render it in the eclipse editor?

it is used correctly when i render via mvn.

thanks & regards

atregnaghi's picture

Re: yml rendering configuration usage

Submitted by Albert Tregnaghi on Sat, 2020-10-03 11:10

Hello Mario,

I think you were talking about inlcuding  a yaml file example inside an asciidoc file.
I created Issue #96 at github to check for problems with yaml rendering.
Tried out embedded variant and also by including a file.

Both ways work out of the box, as shown in picture inside github issue.
If there are still questions/problems please add them to github issue.

Best wishes

Albert

jmenoyo's picture

Great Post

Submitted by Jorge Menoyo on Thu, 2019-07-11 08:08

Its a good post from reolve the problem.

I have a  [www.bilbolink.com/]

Tacnks!

atregnaghi's picture

Version 2.0.2 available - fixes Windows OS startup problem

Submitted by Albert Tregnaghi on Tue, 2019-07-09 19:09

Release 2.0.0 did not work with Windows OS - see https://github.com/de-jcup/eclipse-asciidoctor-editor/issues/248 for details.
Is fixed with 2.0.2

atregnaghi's picture

Version 1.4.2 now available, install problems fixed

Submitted by Albert Tregnaghi on Thu, 2019-04-11 18:31

There were some issues with 1.4.0, 1.4.1 and 1.4.2 installation. This is fixed now and 1.4.2 can be installed without problems.

Sorry about the inconvenience.

Best wishes
Albert

PS: Parts inside library plugin has been updated as well, so this update is bigger than usual (~37 MB)

ovikevry's picture

Handshake failure

Submitted by Ole Jonny Vikevry on Tue, 2018-12-18 03:40

When I try to install the plugin, the process fails with the log statement shown below. The same error occurs both via the Install link on this site, Eclipse marketplace and Update site:

Using Eclipse 2018-09 on Win10.

(I have padded urls with whitespace due to form validation)

An error occurred while collecting items to be installed session context was:(profile=epp.package.jee, phase=org.eclipse.equinox.internal.p2.engine.phases.Collect, operand=, action=). Unable to read repository at h t t p s : / / dl.bintray.com/de-jcup/asciidoctoreditor/plugins/de.jcup.asciidoctoreditor_1.2.0.jar. Received fatal alert: handshake_failure Unable to read repository at h t t p s : //dl.bintray.com/de-jcup/asciidoctoreditor/plugins/de.jcup.asciidoctoreditor.libs_1.2.0.jar. Received fatal alert: handshake_failure

Please advice

atregnaghi's picture

Re: Handshake failure

Submitted by Albert Tregnaghi on Tue, 2018-12-18 10:16

Reproducing problem

I tried following: I downloaded https://dl.bintray.com/de-jcup/asciidoctoreditor/plugins/de.jcup.asciido... directly inside my browser (e.g. chrome) and had no certificate problems - or just open https://dl.bintray.com/de-jcup/asciidoctoreditor/plugins/

I also got a fresh eclipse 2018-09 and installed Asciidoctor Editor by marketplace (from a german location) and had no problems. Installation was done.

So I was not able to reproduce your problem.

About the problem

This sound like a SSL problem. Maybe you got the same probleme as described at https://github.com/gnu-mcu-eclipse/eclipse-plugins/issues/171 (other plugin but same issue)

Possible next steps

Please try to download the jar file or view the folder with your browser as described above.

If you have also SSL problems with your browser you could have a either 

- proxy  problems
- bintray is rolloing out new certificates (in this case please try a little bit later asgain)
- a "man in the middle"...

If it works in your browser than you could have a problem with your java version running your eclipse.

To solve this you can do either:

- import bintray certificates in java store of your JVM used for eclipse
- update your JVM used for starting eclipse or
- start your eclipse with another - suitable - JVM instance

Hope this helps
Albert

Markets

  • Eclipse Project (4)
  • Tools (1342)
    • Application Development Frameworks (171)
    • Application Management (32)
    • Application Server (31)
    • BIRT (10)
    • Build and Deploy (104)
    • Business Intelligence, Reporting and Charting (14)
    • Code Management (117)
    • Collaboration (37)
    • Database (44)
    • Database Development (34)
    • Database Persistence (17)
    • Documentation (60)
    • Eclipse Kura (122)
    • Eclipse SmartHome (46)
    • EclipseRT Target Platform Components (10)
    • Editor (339)
    • Entertainment (14)
    • General Purpose Tools (124)
    • Graphics (34)
    • IDE (344)
    • Internet of Things (IoT) (35)
    • J2EE Development Platform (44)
    • J2ME (5)
    • Languages (155)
    • Linux Tools (19)
    • Logging (22)
    • Mobile and Device Development (49)
    • Modeling (90)
    • Modeling Tools (146)
    • Mylyn Connectors (20)
    • Network (14)
    • Other (74)
    • Process (18)
    • Profiling (22)
    • Programming Languages (100)
    • Reporting (32)
    • Rich Client Applications (39)
    • Science (4)
    • SCM (20)
    • Search (42)
    • SOA Development (15)
    • Source Code Analyzer (99)
    • Systems Development (59)
    • Team Development (54)
    • Testing (90)
    • Tools (568)
    • UI (97)
    • UML (40)
    • Web (90)
    • Web Services (31)
    • Web, XML, Java EE and OSGi Enterprise Development (32)
    • XML (29)
  • IoT (172)
    • Eclipse Kura (122)
    • Eclipse SmartHome (46)
  • RCP Applications (79)
  • Training & Consulting (53)
  • Long Term Support (11)

Search

Advanced Search

More like this

  • ASCII UML (asciidoc editor + plantuml plugin)
  • Mylyn WikiText
  • Markdown Text Editor
  • LiClipseText
  • FluentMark

Favorited by

Eclipse Foundation

  • About Us
  • Contact Us
  • Sponsor
  • Members
  • Governance
  • Code of Conduct
  • Logo and Artwork
  • Board of Directors
  • Careers

Legal

  • Publishing Guidelines
  • Privacy Policy
  • Terms of Use
  • Copyright Agent
  • Eclipse Public License
  • Legal Resources

Useful Links

  • Welcome to Marketplace
  • Report a Bug
  • Documentation
  • How to Contribute
  • Mailing Lists
  • Forums
  • Marketplace

Other

  • IDE and Tools
  • Projects
  • Working Groups
  • Research@Eclipse
  • Report a Vulnerability
  • Service Status

Copyright © Eclipse Foundation. All Rights Reserved.

Back to the top