Asciidoctor :: Discussion

A bit of AsciiDoctor proselytism/promotion

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

2 messages Options

suy

A bit of AsciiDoctor proselytism/promotion

Hi.

The C++ ISO standarization team is publishing a document which, in my humble
opinion, would be much better authored if it were written in AsciiDoc(tor).
Look at the problems they tend to have

https://github.com/isocpp/CppCoreGuidelines/compare/isocpp:2a50e98...isocpp:2110e06

I've reported an issue so at least they know about other options:

https://github.com/isocpp/CppCoreGuidelines/issues/154

I don't suggest that we spam the issue, but if anyone with more experience
than me is interested, it would be nice to promote a bit AsciiDoctor's
benefits if someone asks there. :)

Cheers.

--
Alex

mojavelinux

Re: A bit of AsciiDoctor proselytism/promotion

Administrator

Thanks! My fingers are crossed that they are open to considering the power of AsciiDoc.

PDF support is coming along very nicely. There are still some challenges to overcome, but I think that Asciidoctor PDF produces some of the best looking PDFs out there already. If, for some reason, that doesn't suffice, it's always possible to convert to DocBook and then to PDF from there. AsciiDoc is all about options and flexibility.

Hyphenation is possible, but not supported (yet) out of the box in Asciidoctor PDF. There's an open issue (https://github.com/asciidoctor/asciidoctor-pdf/issues/20). I'm sure the DocBook pipeline can handle it in the meantime.

Cheers,

-Dan

On Mon, Sep 28, 2015 at 3:08 PM, suy [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi.

The C++ ISO standarization team is publishing a document which, in my humble
opinion, would be much better authored if it were written in AsciiDoc(tor).
Look at the problems they tend to have

https://github.com/isocpp/CppCoreGuidelines/compare/isocpp:2a50e98...isocpp:2110e06

I've reported an issue so at least they know about other options:

https://github.com/isocpp/CppCoreGuidelines/issues/154

I don't suggest that we spam the issue, but if anyone with more experience
than me is interested, it would be nice to promote a bit AsciiDoctor's
benefits if someone asks there. :)

Cheers.

--
Alex

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/A-bit-of-AsciiDoctor-proselytism-promotion-tp3771.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen