On Sun, Mar 13, 2016 at 1:45 PM, Britton Kerin <[email protected]> wrote:
> * It seems that asciidoctor gem doesn't end up installing a man page for > itself. > Correct, RubyGems doesn't have a way to install a man page (that I know of). You get the man page when you install via the Linux package. dnf install asciidoctor (Fedora/RHEL) apt-get install asciidoctor (Debian/Ubuntu) Having said that, the man page is inside the gem, so I've been thinking about adding a flag to asciidoctor much like in asciidoc that resolves the man page from the installation directory. Something like asciidoctor -h manpage Until then, you could resolve it using: man "$(dirname $(gem which asciidoctor))/../man/asciidoctor.1" I'll add a note about this to the migration guide. > > * I like the default asciidoc style better than the asciidoctor default. > Wow, really? You're the first person I've ever heard say that. I find the CSS in AsciiDoc Python hideous and dated. That's what prompted me to create the default stylesheet in Asciidoctor. I didn't quickly find a way to make * asciidoctor use it. > Just grab the CSS from AsciiDoc Python and pass it to the stylesheet option. It will work for most elements. asciidoctor -a stylesheet=asciidoc.css document.css This is one of the things covered in the migration guide that I mentioned. There are other themes you can use as well (though some are in need of updating). http://themes.asciidoctor.org/preview/ > * For some reason, the first line of my document after the header comes > out bigger in asciidoctor, but not asciidoc. > That's a feature of the default Asciidoctor stylesheet. The preamble is treated as a lead paragraph, which means it has enlarged text. It's a style preference. You can always use your own stylesheet or tweak the CSS if you don't like it. I'll add a note about that to the migration guide. Here's the issue tracking the addition of the migration guide: https://github.com/asciidoctor/asciidoctor.org/issues/434 -Dan -- Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
