Skip to main content
  • Log in
  • Manage Cookies
projects.eclipse.org
Download
  • Projects
  • Working Groups
  • Members
  • 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
  • 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. Projects
  3. AsciiDoc®
  4. Eclipse Austen
  5. Eclipse Austen
  6. Creation Review

Eclipse Austen Creation Review

Type: 
Creation
State: 
Successful
End Date of the Review Period: 

Reviews run for a minimum of one week. The outcome of the review is decided on this date. This is the last day to make comments or ask questions about this review.

Wednesday, April 21, 2021
Project: 
Eclipse Austen
Proposal: 

Eclipse Austen

Parent Project: 
Eclipse Technology
Background: 

The goal of this project is to provide a native and compatible implementation of the AsciiDoc Language specification that can be run on the Java Virtual Machine (JVM).

This will allow languages such as Java, Kotlin, Groovy, Scala, and JRuby, that run on the JVM, to process AsciiDoc-based documentation as part of a build process or application.

Today these languages can process AsciiDoc using AsciidoctorJ. However, AsciidoctorJ relies on JRuby to wrap the Asciidoctor Ruby implementation with a Java API. We want to take this opportunity to not only create a compatible implementation, but one that is written directly in Java so it has a lighter footprint and improved performance.

Scope: 

Eclipse Austen provides a Java implementation of the AsciiDoc Language Specification.

A pure Java implementation could provide smaller binaries and faster startup times. Access to a detailed abstract syntax tree (AST) of a parsed document and source-maps for generated documents are enabling features for improving editors and IDEs, including auto-completion and syntax checking.

This implementation will not provide any additional features to the AsciiDoc Language that are not part of the AsciiDoc Language Specification. However, it will implement the Extension API and provide hooks for users to write extensions using the extension points named by the specification.

The architecture of this implementation will be documented in order to be easier to understand and maintain by developers of this implementation. This implementation will serve as a reference for developers in other languages. Documented design decisions will offer implementations in other languages a head start. 

It aims to be a library with minimal dependencies. This lets it run in environments such as GraalVM and OSGi.

This implementation will be compatible with at least the following runtime environments:

  • OpenJDK 8 / 11

  • GraalVM

  • OSGi / p2

Description: 

AsciiDoc is a comprehensive, semantic markup language for producing a variety of presentation-rich output formats from content encoded in a concise, human-readable, plain text format.

This implementation will include a set of APIs for transforming the encoded content, extending the syntax/grammar and processor lifecycle, and integrating with tools and publishing platforms.

Why Here?: 

The Eclipse Foundation’s values of open source, transparency, and vendor neutrality are of the utmost importance to AsciiDoc and its community.

In addition, this project is created under the top level AsciiDoc Language Specification project that is already part of the Eclipse Foundation.

Initial Contribution: 

No initial contribution. Since the role of this project is to work alongside the AsciiDoc Language project to develop the specification for the language, it has to build on prior work to bootstrap. In addition to the AsciiDoc user documentation, which is the initial contribution for the AsciiDoc Language project, this project will draw ideas for the API from AsciidoctorJ. We're aware that AsciidoctorJ has shortcoming we want to address, but it also has many strong points that we want to carry over.

Legal Issues: 

None that we know of.

Licenses: 
Eclipse Public License 2.0
Project Scheduling: 

This project will follow the specification scheduling but we plan to focus first on the following set of “core” functionalities:

  1. Minimal proof-of-concept to show 

    1. loading - parsing - AST - conversion to HTML (with an option to add more output formats)

    2. Testing harness for TCK 

  2. Growing functionality in step with the AsciiDoc Specification

  3. AsciidoctorJ API compatible implementation (to be discussed)

  4. AsciidoctorJ API compatible Java extensions (to be discussed) 

  5. Adapter for Language Server Protocol (given demand/sponsors)

Future Work: 

We will add any functionalities approved as part of the AsciiDoc Language Specification. We will also make sure that the implementation remains compatible with the ever-changing Java landscape (esp with respect to compatibility with newer Java language features).

People
Project Leads: 
Abel Salgado Romero
Rob Winch
Committers: 
Abel Salgado Romero
Rob Winch
Sarah White
Dan Allen
Robert Panzer
Guillaume Grossetie
Alexander Schwartz
Albert Tregnaghi
Schalk Cronjé
Interested Parties: 

Projects

  • AsciidoctorJ
  • IntelliJ plugin for AsciiDoc
  • Pantheon 2
  • docToolchain
  • Eclipse Mylyn Docs
  • Eclipse plugin for AsciiDoc

Organizations

  • VMWare
  • Red Hat
  • Webtide
  • OpenCore
  • DB Systel

Individuals

  • Alexander Schwartz
  • Jason Porter
  • Daniel Kocot
  • Benjamin Radey / Pantheon 2
  • Ralf D. Müller / docToolchain
  • Robert Panzer / AsciidoctorJ
  • Torkild Ulvøy Resheim / Eclipse Mylyn Docs
  • Alexander Fedorov / Eclipse Passage, OSGi p2
  • Lars Francke / OpenCore
  • Albert Tregnaghi / Eclipse plugin for AsciiDoc
Mentors: 
Jesse McConnell
  • Sign in to post comments.
Links: 
GitLab tracking issue
  • Sign in to post comments.
Incubating - Eclipse Austen

Related Projects

Project Hierarchy:

  • AsciiDoc®
  • Eclipse Austen

Eclipse Foundation

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

Legal

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

Useful Links

  • 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