Re: Fedora Packaging Guidelines on docs.fedoraproject.org

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



>>>>> "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.

I'm extremely dissatisfied at the way this has been handled and wish I'd
had sufficient free time to find some of these issues before this was
implemented, but at the time I didn't and now it seems that the only way
out is forward.

 - J<
_______________________________________________
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




[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Fedora Announce]     [Fedora Users]     [Fedora Kernel]     [Fedora Testing]     [Fedora Formulas]     [Fedora PHP Devel]     [Kernel Development]     [Fedora Legacy]     [Fedora Maintainers]     [Fedora Desktop]     [PAM]     [Red Hat Development]     [Gimp]     [Yosemite News]

  Powered by Linux