Coder Social home page Coder Social logo

asciidocnet's Introduction

AsciiDocNet

This is a very alpha implementation of an AsciiDoc processor for .NET. It's been written from scratch using .NET idioms, although it's been influenced by the AsciiDoctor text processor in Ruby.

What is AsciiDoc?

From AsciiDoctor

AsciiDoc belongs to the family of lightweight markup languages, the most renowned of which is Markdown. AsciiDoc stands out from this group because it supports all the structural elements necessary for drafting articles, technical manuals, books, presentations and prose. In fact, it’s capable of meeting even the most advanced publishing requirements and technical semantics.

More information can be found on the AsciiDoctor website as well as the original AsciiDoc guide.

Why write a processor for .NET?

Writing the processor came out of a need to modify existing AsciiDoc files to make modifications to them such as add Section titles, rearrange elements, etc.. and then save them again as AsciiDoc files for processing by an existing AsciiDoc toolchain.

Since this modification happens within a .NET application, the intention was to be able to parse an Asciidoc file into an element tree representation that could be easily modified by visiting elements within the tree using the visitor pattern and then allow it to be output to different representations including AsciiDoc, HTML, docbook, PDF, etc.

Is it production ready?

In short, no! There are many _TODO_s in the source and many scenarios that are not yet handled, for example, Table elements are not handled at all and neither are list item continuations. Additionally, since the original goal was to be able to output an AsciiDoc file from and AsciiDoc input, generating HTML or docbook outputs are either incomplete or not yet started. Over time, this functionality will be added but if you are itching for a feature now, We accept Pull Requests :)

License

AsciiDocNet is licensed under Apache 2. See the license for more details

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.