DITA and XMetaL Discussion

XMetaL Community Forum DITA and XMetaL Discussion Topic Step Numbers Are Missing

  • kwag_myers

    Topic Step Numbers Are Missing

    Participants 5
    Replies 6
    Last Activity 10 years, 3 months ago

    I'm starting a new job at a new location so I'm starting from scratch. I just downloaded the trial version of 7.0 on a Windows 7 machine. Two issues I've run into:

    1. My task topic shows numbers and bullet points in the editor (tags view), but not in the webhelp output.
    2. My css and footer are overwritten every time I generate output. I seem to remember this being a way of regulating the trial version, but I'm not sure about that.

    I should mention that I'm using a custom OT and I'm not having any trouble with the wrap, just the frame content.

    Reply

    Derek Read

    Reply to: Topic Step Numbers Are Missing

    There's no difference between the trial and licensed version (for all features) except that if you are generating PDF using RenderX XEP RenderX puts their logo on each page and the software will not let you use it after 30 days.

    1. This is likely default behavior for the DITA OT for all XHTML-based outputs although I'm not sure exactly what you mean here. Note that our WebHelp is based on the “XHTML” transtype and you should see the same thing for all XHTML outputs (XHTML, CHM, Eclipse, Java, etc) unless they have been further customized. Since this is a “task” can I assume you are talking about ? If so, this should be output as numbered lists in XHTML outputs using the

      HTML tag.

      2. I'm not sure what you are doing (where files are placed, settings, etc) so not sure what is going on here. When you generate output most files will be overwritten, and in some cases files are deleted prior to output being generated by the DITA OT. The DITA OT will overwrite the files commonltr.css and commonrtl.css when it generates output. Are those the files? Or perhaps you have some additional DITA OT parameters set?

    Reply

    kwag_myers

    Reply to: Topic Step Numbers Are Missing

    Here's the source code of the web help output:
    [code]

      PUBLIC “-//W3C//DTD XHTML 1.0 Transitional//EN” “http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”>










    Enter Something


     

    Enter Something

     

    Instructions for entering Headcount information.
     

    Go to the
      Department homepage for this task.

       

    1.   Select
      Something from the
      Something Else pull-down menu.
       

        A login page displays.
    2.    

    3.   Login using:
       

       

      • Department
        Username and Password.
      • Outside Department Network
        ID.
      •  

        New Something Form
      displays.
       

    [/code]

    I've tried both Firefox 13 and IE 8. Also, I tried Multiple HTML output with good results. So, I think I might have broke something in my tweeking of the webhelp stylesheets and may just start over with a fresh install.

    As for my css and footer files, the only parameters I have are the defaults plus the DITA_OT_BUILD_DIR. I'm using the custom.css and custom-ftr files in the webhlep_out folder for the project and have those directories set in the Edit Deliverable Type dialog box. However, as I'm typing this I just realized that in my previous project I changed the name of the footer file (that project had variations upon variations, so I had OTs and footers everywhere). Also, my previous project I used the commonrtl.css.

    Reply

    Derek Read

    Reply to: Topic Step Numbers Are Missing

    There's an

      in there so that should give you a numbered list in all browsers. The only thing I can think of is that maybe the CSS is overriding that?

    Reply

    kwag_myers

    Reply to: Topic Step Numbers Are Missing

    I probably missed a closing tag or something. I've started over with a fresh OT and I'm systematically revising each customized file. I've just been informed that they want me to use the same CSS as the developers, which means I'll have to merge theirs with yours. So, I have to start over anyway.

    I also changed the directory for the CSS and footer files to keep the files from being overwritten. This helped with the footer. Hopefully, this will resolve the CSS issue, too.

    Thanks for the help. I was getting frustrated since it's only been two months since I've used XMetaL until it occurred to me that it was two years ago when I set the OTs up on my last project. Version 7 looks good so far. I'll be putting it through Kwaggie's Mire on this project. There's quite a list of deliverables on my ToDo list.

    Reply

    kwag_myers

    Reply to: Topic Step Numbers Are Missing

    You can recreate the missing step numbers by following Su-Laine's instructions for Customizing WebHelp ([url=http://forums.xmetal.com/index.php/topic,626.msg1988.html#msg1988]http://forums.xmetal.com/index.php/topic,626.msg1988.html#msg1988[/url]) and specify the custom.css style sheet in the Edit Deliverable Type dialog box. If I specify either of the other two style sheets in the webhelp_out folder, the numbers and bullets display.

    Also, I found that if I noted out the line [code]ul, ol, dl, li, dt, dd { list-style: none; }[/code] in the /* body */ section of the custom.css, the bullets displayed, but still no step numbers. So it is definitely something in the custom.css file right out of the box.

    Reply

    Derek Read

    Reply to: Topic Step Numbers Are Missing

    Su-Laine's tutorial really should have stated which version she created it for. I have not had time to do a diff between the files she modified (or recommended modifying) and the files that shipped with 6.0. That would need to be done and then a diff would need to be done between that and what ships with 7.0. Or maybe load all three into KDiff at the same time and try to understand what's going on.

    Nobody is maintaining her tutorial (and Su-Laine no longer works here). Unfortunately, I don't have time at the moment to look at it right now and I'll be hiking into the mountains for a while beginning tomorrow so can't even say I might try to look at it soon). At this point I'm not sure what “fixes” would look like since the tutorial is about making changes to how things are styled.

    Perhaps the best thing to do (rather than trying to diff three different versions of files) would be to load the final results into FireFox with FireBug (or a different browser with a similar CSS/HTML/Script inspection tool) and then just find all the elements you don't like the look of and work backwards from there to locate the selector(s) in specific files that are affecting the element?

    Reply

  • You must be logged in to reply to this topic.

Lost Your Password?

Products
Downloads
Support