On 1.10.2018 20:00, Jason L Tibbitts III wrote:
"BP" == Björn Persson <Bjorn@rombobjörn.se> writes:
BP> This was on Fedora 27. So one needs Fedora 28 to help fixing the
BP> formatting of the guidelines then? (Once that other breakage is
BP> fixed I suppose?)
I believe one could build the antora stack from scratch instead of using
a container. I would hope it wouldn't require F28 to do so, but it's
still way too high of a barrier.
BP> Yeah, no I don't think I'm going to run any document conversion
BP> programs as root.
You certainly shouldn't have to. The problem is making it look like it
looks on the web site, since I guess the markup itself is dependent on
stylesheets and extra information which isn't actually included in the
documents.
For a single page, though, it seems that you can get a reasonable
interpretation merely by installing asciidoc and running "asciidoc
foo.adoc". That will spit out foo.html which you can open in a local
browser. That's what I've been doing, but unfortunately it doesn't give
me the same results. For example, it doesn't appear to handle the
`+whatever+` syntax properly and inserts the literal plusses in the
output while the antora-generated version doesn't. I do not know why.
BP> I'm getting the impression that you're shooting mosquitoes with a
BP> cannon.
Plain asciidoc is the lightest weight solution I've found so far. Maybe
someone knows some magic that could be passed to asciidoc or another
converter which is actually part of the distribution which could be used
for at least a more consistent previous.
For what's it work, I had a good experience with asciidoctor, although I
haven't tried to use it on our guidelines yet.
$ sudo dnf install asciidoctor
--
Miro Hrončok
--
Phone: +420777974800
IRC: mhroncok
_______________________________________________
devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/devel@xxxxxxxxxxxxxxxxxxxxxxx
