Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Multi-level lists #28

Closed
mhGLEIF opened this issue Mar 28, 2017 · 6 comments
Closed

Multi-level lists #28

mhGLEIF opened this issue Mar 28, 2017 · 6 comments
Milestone

Comments

@mhGLEIF
Copy link

mhGLEIF commented Mar 28, 2017

This is a kind of a subset of #26 but maybe there should be some logic involved too?

Multilevel lists (bullets and/or numbered) come up a lot in DITA and technical writing generally.

Would it make sense to have some logic to map the depth of the physical <li> tags in the DITA to the corresponding standard Word headings (Bullet list / Numbered list)?

@jelovirt
Copy link
Owner

Mapping different styles to different list item depths is something that you currently have to override. Again, since there is no single one answer for this, it's left to the customization to handle it.

@mhGLEIF
Copy link
Author

mhGLEIF commented Mar 28, 2017

I would suggest to standardize it to the built-in Word styles that appear in a fresh copy of normal.dotm:

image

Is this something the user community is expected to do?

I'm intending to learn XSLT in depth but I as far as I can understand these tweaks would not be a lot of work for someone who already knows - maybe oxygen can get it done somehow?

@jelovirt
Copy link
Owner

Sounds reasonable. I will implement this to be the default.

@jelovirt jelovirt added this to the 1.3.0 milestone Mar 28, 2017
@mhGLEIF
Copy link
Author

mhGLEIF commented Mar 28, 2017

This is extremely helpful!

Sorry for the long exchange - sometimes even a technical writer is not able to explain their requirements as clearly as they'd like ;-)

@dagoss
Copy link
Contributor

dagoss commented Mar 28, 2017

Would this be expected to affect <task> elements too, or are we just talking about basic list elements like <ol> and <ul>?

For example:

<steps>
    <step>
        <cmd>This is "List Number"</cmd>
        <info>This is "List Continue"</info>
    </step>
    <step>
        <cmd>This is "List Number"</cmd>
        <substeps>
            <substep>
                <cmd>This is "List Number 2"</cmd>
                <info>This is "List Continue 2"</cmd>
             </substep>
        </substep>
    </step>
    <step>
        <cmd>This is "List Number"</cmd>
        <choices>
            <choice>This is "List Bullet 2"</choice>
        </choice>
    </step>
</steps>

@mhGLEIF
Copy link
Author

mhGLEIF commented Mar 28, 2017

@dagoss I was assuming just ol and ul because they are semantic-free and could therefore reasonably be expected to behave like Word styles (which are almost all semantic free).

There's no Word style that uniquely / directly corresponds to most of the DITA semantic elements. That doesn't mean your suggestion is not a good idea, but I don't know how much effort that would take to implement, plus at a certain point maybe you have to make choices about what the semantics will be (?).

codeph might work as e.g. HTML Code (which I'd suggest) but I will admit I don't know what all the other Word HTML _____ styles mean.

jelovirt added a commit that referenced this issue Mar 28, 2017
jelovirt added a commit that referenced this issue Mar 28, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants