Summary: | Guides: how to create side-by-side diff-style docs? | ||
---|---|---|---|
Product: | [OLD] Docs on www.gentoo.org | Reporter: | Michał Górny <mgorny> |
Component: | New Documentation | Assignee: | Docs Team <docs-team> |
Status: | RESOLVED CANTFIX | ||
Severity: | normal | CC: | python |
Priority: | Normal | ||
Version: | unspecified | ||
Hardware: | All | ||
OS: | Linux | ||
Whiteboard: | |||
Package list: | Runtime testing required: | --- |
Description
Michał Górny
2012-12-29 11:15:25 UTC
Beyond doing this in a single <pre>...</pre> one, I don't see an immediate way to handle this without loosing a preserved whitespace. I think allowing a <pre> in a table wouldn't make much sense as it might make things very ugly; however, perhaps we could just allow <code> or <tt> so that you can use whitespace-preserved stuff in a table. Another possibility would be to use our wiki, which allows for more formatting than GuideXML. (In reply to comment #1) > Beyond doing this in a single <pre>...</pre> one, I don't see an immediate > way to handle this without loosing a preserved whitespace. > > I think allowing a <pre> in a table wouldn't make much sense as it might > make things very ugly; however, perhaps we could just allow <code> or <tt> > so that you can use whitespace-preserved stuff in a table. Well, a quick try with gorg shows it doesn't look best but I'd say it's acceptable [1]. It would be great if the table was stretched to the width of content area, and the code blocks were of same width by default; but so far, the worst thing is the numbering which results in repeating '1.1'. [1]:http://dev.gentoo.org/~mgorny/python-r1/examples.html > > Another possibility would be to use our wiki, which allows for more > formatting than GuideXML. I'd rather keep all the docs in a single place, and mediawiki would be the last resort to me. I'd rather write plain HTML. seems to be dead/moot. closing. |