Difference between revisions of "Documentation/SL/How Tos/Nastavitev sloga za oštevilčevanje vrstic kode"

Revision as of 17:48, 5 May 2008

Template:Documentation/Howto

Ta dokument opisuje, kako nastavitev slog odstavka, ki uporablja za številčenje vrstic slog seznama (dejansko odstavke) v izpisih programske kode.

Primer pričakovanega rezultata

Ustvariti želimo slog odstavka za programsko kodo, ki je tako oštevilčen, pri čemer so številke desno poravnane, vsaka vrstica kode je enako zamaknjena in odstavki so dovolj zamaknjeni, da se številke prilegajo v prostor, ki je na voljo. (Vsaka vrstica kode je v ločenem odstavku.)

     1  Vrstica 1 
     2  Vrstica 2 
     3  Vrstica 3 
        ... 
     8  Vrstica 8 
     9  Vrstica 9 
    10  Vrstica 10 
    11  Vrstica 11 
        ... 
   101  Vrstica 101 
  1001  Vrstica 1001

Slika 1: Primer seznama.

Navodila

Postopek ima tri korake:

Korak 1. Ustvarite slog oštevilčevanja seznama.

Korak 2. Ustvarite slog odstavka.

Korak 3. Uporabite slog odstavka na izpisu izvorne kode.

Preden začnete, pritisnite F11. Odpre se okno Slogi in oblikovanje, v kolikor še ni odprto.

Korak 1. Ustvarite slog oštevilčevanja seznama.

1. Kliknite ikono Slogi seznama na vrhu okna Slogi in oblikovanje (peti z leve).
2. 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.)


Slika 2: Starting a new list style.

Opomba: Although the icon at the top of the Styles and Formatting window is labelled List Styles, the dialog that opens is labelled Numbering Style.

3. Na strani Organizator pogovornega okna Slog oštevilčevanja poimenujte novi slog seznama, npr. OštevilčevanjeKode.
4. Na strani Možnosti naredite naslednje:
1. V polju Raven izberite 1.
2. Na seznamu Oštevilčevanje izberite 1,2,3.
3. Leave the Before and After boxes blank, or delete anything that is in them.
4. Pustite Slog znakov na nastavitvi Brez.
5. Make sure Start at is 1.
6. Show sublevels should be grayed out. Do not select the checkbox for Consecutive numbering.
7. 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.


Figure 3: Setting up the new CodeNumbering list (numbering) style.

5. On the Position page, do this:
1. In the Level box, choose 1.
2. For Indent, choose 0.5cm. (You may need to adjust this later.)
3. For Spacing to text, choose 1.0cm.
4. For Minimum space..., choose 0.4cm.
5. For Numbering alignment, choose Right.


Figure 4: Setting the alignment and indentation for the CodeNumbering style.

6. Ne naredite ničesar na drugih straneh tega pogovornega okna.
7. Kliknite V redu in s tem shranite ta slog.

Korak 2. Ustvarite slog odstavka.

1. Click the Paragraph Styles icon at the top of the Styles and Formatting window (first icon on the left).
2. Right-click and choose New.
3. On the Organizer page of the Paragraph Style dialog:
1. Give the new paragraph style a name. We’ll call it ProgCode.
2. In the Next Style box, choose ProgCode (that will make the following paragraph also be in this style, until you choose a different style).
3. In Linked with, I recommend choosing -None-.
4. Category should be Custom Styles, though I think that doesn't matter.


Figure 5: Creating the ProgCode paragraph style.

4. On the Font page, choose the font you want, perhaps Courier New, and the size.
5. On the Indents & Spacing page, leave all the boxes showing 0.00cm.
6. On the Numbering page, choose from the list the CodeNumbering style you just created.


Figure 6: Associating the paragraph style with a numbering style.

7. You should not need to do anything on the other pages of this dialog.
8. Click OK to save this style.

Korak 3. Uporabite slog odstavka na izpisu izvorne kode.

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.