Documentation/How Tos/Setting up a Style for Numbering Lines in Code Listings
This document describes how to set up a paragraph style that uses a list style to number lines (actually paragraphs) in code listings.
Contents
Example of required result
We want to create a program code paragraph style that numbers like this, with the numbers right-aligned, each line of code indented the same distance, and the paragraphs indented enough so that the numbers fit in the available space. (Each line of code is in a separate paragraph.)
1 Line 1 2 Line 2 3 Line 3 ... 8 Line 8 9 Line 9 10 Line 10 11 Line 11 ... 101 Line 101 1001 Line 1001
Figure 1: Example of list.
Instructions
The process has three steps:
Step 1. Create the list numbering style.
Step 2. Create the paragraph style.
Step 3. Apply the paragraph style to the code listing.
Before you begin, press F11 to open the Styles and Formatting window, if it is not already open.
Step 1. Create the list numbering style.
- Click the List Styles icon at the top of the Styles and Formatting window (fifth from the left).
- Right-click in the blank area below the list of styles and choose New. (You could modify one of the existing styles, but it’s easier to remember which style is for what special purpose if you create a new one.)
- On the Organizer page of the Numbering Style dialog, give the new list style a name, for example CodeNumbering.
- On the Options page, do this:
- In the Level box, choose 1.
- In the Numbering list, choose 1,2,3.
- Leave the Before and After boxes blank, or delete anything that is in them.
- Leave Character Style as None.
- Make sure Start at is 1.
- Show sublevels should be grayed out. Do not select the checkbox for Consecutive numbering.
- You do not need to do anything with any of the other levels, because this paragraph style is not going to be part of a hierarchy in an outline.
- On the Position page, do this:
- In the Level box, choose 1.
- For Indent, choose 0.5cm. (You may need to adjust this later.)
- For Spacing to text, choose 1.0cm.
- For Minimum space..., choose 0.4cm.
- For Numbering alignment, choose Right.
- Do nothing on the other pages of this dialog.
- Click OK to save this style.
Figure 2: Starting a new list style.
Note: Although the icon at the top of the Styles and Formatting window is labelled List Styles, the dialog that opens is labelled Numbering Style.
Figure 3: Setting up the new CodeNumbering list (numbering) style.
Figure 4: Setting the alignment and indentation for the CodeNumbering style.
Step 2. Create the paragraph style.
- Click the Paragraph Styles icon at the top of the Styles and Formatting window (first icon on the left).
- Right-click and choose New.
- On the Organizer page of the Paragraph Style dialog:
- Give the new paragraph style a name. We’ll call it ProgCode.
- In the Next Style box, choose ProgCode (that will make the following paragraph also be in this style, until you choose a different style).
- In Linked with, I recommend choosing -None-.
- Category should be Custom Styles, though I think that doesn't matter.
- On the Font page, choose the font you want, perhaps Courier New, and the size.
- On the Indents & Spacing page, leave all the boxes showing 0.00cm.
- On the Numbering page, choose from the list the CodeNumbering style you just created.
- You should not need to do anything on the other pages of this dialog.
- Click OK to save this style.
Figure 5: Creating the ProgCode paragraph style.
Figure 6: Associating the paragraph style with a numbering style.
Step 3. Apply the paragraph style to the code listing.
If you have already entered the lines of code, select them and double-click ProgCode in the Styles and Formatting window. All the lines should now be numbered, indented, and in the correct font.
Note: If you have previously been applying manual formatting to these paragraphs, first select all the paragraphs, right-click, and choose Default Formatting; then apply the ProgCode style.
If you are starting a new block of code, apply the ProgCode style to the first line (either before or after entering it). Then when you press Enter at the end of that line, the next line will appear in the same ProgCode style but with the next number in the list sequence.
Restarting numbering (if required)
If you have more than one list in a chapter, the second and subsequent lists may continue numbering from the previous list. To restart at 1, place the cursor anywhere in the paragraph you want numbered 1, right-click and choose Restart numbering.
Content on this page is licensed under the Creative Common Attribution 3.0 license (CC-BY). |