No support for certain DocBook elements

[pmkovar]

When converting Publican-based DocBook XML docs from the Fedora Doc Project, it turned out some of the often-used elements are unsupported:

• [ ] productname
• [ ] productnumber
• [x] menuchoice
• [x] guimenu
• [x] guisubmenu
• [x] guimenuitem
• [x] userinput
• [x] computeroutput
• [x] option
• [x] systemitem
• [x] remark
• [ ] revhistory
• [x] replaceable
• [x] guiicon
• [x] citetitle
• [x] package
• [ ] qandaset
• [ ] programlistingco
• [x] foreignphrase
• [ ] calloutlist
• [x] property
• [x] type
• [x] attribution
• [x] database
• [x] exceptionname
• [ ] biblioentry
• [x] quote
• [x] citation
• [x] function

[pmkovar]

One more that seems to be missing:

• replaceable

[pmkovar]

Found two more:

• guiicon
• citetitle

[mojavelinux]

It's going to be really helpful if you can cite examples for each missing element. Just point to a DocBook source somewhere. The reason is that there are so many ways to structure a DocBook file, so how the element is used in context actually becomes quite important to the implementation of the converter (at least to hit the 80-90% case).

[mojavelinux]

In my opinion, some of these inline elements should just get erased when converting to AsciiDoc (or mapped to simplified markup such as bold with a role perhaps). The reason is because I feel very strongly that DocBook goes way overboard with markup. It's such a time sync for writers when the reader never sees the distinction anyway. My observation is that writers often overuse markup, wasting time and money and making editing much harder than it has to be.

[mojavelinux]

Something like a gui menu is a great example of something that should be preserved...and we do have support for that in Asciidoctor.

[mojavelinux]

I think I've implemented menuchoice correctly now, which also covers:

• guimenu
• guisubmenu
• guimenuitem

If I'm missing a use case, just point me to a sample.

[mojavelinux]

I've handled a whole bunch more. I'm updating the original list as I go.

[mojavelinux]

We now have a test suite to use for providing samples.

[mojavelinux]

part is also missing, but we're handling that as part of #6

[pmkovar]

@mojavelinux Thanks a lot for working on these! Erasing some of the elements works for me and makes sense provided the content itself is preserved.

Do you still need samples for the remaining elements?

[mojavelinux]

I'll always take samples. But now that we have a test suite, there's actually somewhere to put those examples now. Definitely looking for edge cases and things that we aren't currently covering.

[mojavelinux]

I'd like to get this list in the description completed checked off. That's definitely the goal here. Some of the tags I don't yet understand the context, so seeing it "in the wild" definitively helps know how to map it.

[tradej]

Hi, it seems to me that

• simplelist
• superscript

also aren't supported.