On Sun, Mar 13, 2016 at 12:22 PM, Dan Allen <[email protected]> wrote: > > 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 just copied it to the normal spot :) > I'll add a note about this to the migration guide. Nice. I suppose it's impossible but would be nice if ruby gave an option to follow the normal convention. My ruby bin that presumably handled the gem is at $HOME/local/bin/ruby, so it could behave like autoconf. I guess they might regard this as too greedy of man page name space in general, but for large apps like asciidoctor it would be nice to have an option for it to work the usual way or add a link or something. >> * 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. Well I'm pretty dated myself :) Most of my pages are css-free. I guess I'll find somewhere in the docs how to use a null style :) >> 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. Ok I'll try it. Could it be brought up to speed for asciidoctor as an option? I could try to do this if there's interest. > 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. The thing is size has semantic meaning (e.g. header vs text) so doing that magically puts the first paragraph in a different category. It therefore doesn't belong in the style sheet IMO. > 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 Thanks. Looks really good in general and was a pleasure compared to HTML (which is why I looked at it didn't feel like typing many tags this time :). Britton -- 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.
