Login  Register

A bit of AsciiDoctor proselytism/promotion

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
2 messages Options Options
Embed post
Permalink
suy
Reply | Threaded
Open this post in threaded view
| More
Print post
Permalink

A bit of AsciiDoctor proselytism/promotion

suy
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
Reply | Threaded
Open this post in threaded view
| More
Print post
Permalink

Re: A bit of AsciiDoctor proselytism/promotion

mojavelinux
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