28.10 Using macros to fine-tune HTML or XML output
You can use macros and macro variables to solve special HTML or XML problems that are not addressed by the usual Mif2Go configuration settings. This section describes the best approach.
Start from the HTML end. Take one of the output .htm files Mif2Go generates from your FrameMaker document and use a plain-text editor to modify the HTML code:
1. Look at the code Mif2Go produces, and decide what additional bits of code are needed to achieve the effect you want; for example, <table>, <tr>, and <td> tags to create a two-cell table around an in-line image and its adjacent text.
2. Add the bits of code to the HTML, on lines of their own where possible, and view the result in a browser. You might have to experiment with variations until you get the effect you want.
3. Include the successful HTML code in Mif2Go macro definitions. Make each separate chunk of added code into one macro. For example (assuming the anchor for each in-line image is at the very start of the adjacent text):
; Start a table, row, and cell just before an in-line image:
<table class="GrInfo"><tr><td>\
; After an in-line image, start a new cell for the adjacent text:
; After the adjacent text, end the cell, row, and table:
4. Consider where your new HTML-code macros should go in the document flow. Do they precede the opening of some type of paragraph? Follow the closing? Go at the top or bottom of the page? Or just get plunked in at arbitrary points? You might have to define some new paragraph formats in FrameMaker to identify places to invoke the macros. For example, if sometimes you have multiple paragraphs of text adjacent to an in-line image, you might need three different format names for those paragraphs:
If you do not want to change format names, you could put HTML Macro markers before and after each instance of adjacent text. The starting marker would contain:
and the ending marker would contain:
You would keep the same macros defined in Step 3, and get the same result.
5. Tell Mif2Go where to invoke the macros in the output, so the code gets inserted in the right places automatically, by adding settings to the configuration file to invoke your new macros. For example, to invoke the macros defined in Step 3 whenever Mif2Go encounters paragraphs in the formats defined in Step 4:
; Assign code placement to each GrInfo* paragraph format:
; Starting and sole paragraphs need code just before them:
; Ending and sole paragraphs need code to follow them:
; The image itself needs code to close its cell:
See §28.1.2 Invoking a macro and §28.9.3 Surrounding or replacing text with code or macros.
6. Convert the file again, and see if the new code shows up where it is needed. Does the code also pop up where it is not wanted? If so, you can include a test to prevent the code from appearing in other places. For example, to avoid creating a table around a graphic that does not have adjacent text, you could modify the macros in Step 3 to use a macro variable and a conditional expression (both shown in boldface):
<table class="GrInfo"><tr><td>\
<$_if ($$GrInf)></p></td><td><p class="Body"><$_endif>
; Put any macro definition sections before this section.
See §28.3 Using macro variables and §28.6.4.2 Using conditional expressions.
> 28 Working with macros > 28.10 Using macros to fine-tune HTML or XML output