Line indentation in tagged examples

Question:

I used tags in an example and now it's difficult to find the correct line indentation. The result looks like

    %hash=(
                 key1 => value1,
             key2 => value2,
               );

when it should be

    %hash=(
           key1 => value1,
           key2 => value2,
          );

Answer:

Write down the complete example first as pure text and relatively indent the lines as necessary. Add the wished tags in a second step.

Discussion:

This is a common problem with markup languages and not special to PerlPoint. Tags consume space. While this is no problem in a text dynamically wrapped, it is sometimes an issue in example authoring: sometimes its difficult to see how the resulting lines of an example will be indented:

    \PREFIX<%>\BOLD<hash>=\ITALIC<(>
            \BOLD<\YELLOW<key1>> => \GREEN<value1>,
            \BLACK<\ITALIC<key2>> => value2,
         \ITALIC<)>;
  
  

In order to simplify the task of indenting lines correctly, the "pure" example can be indented as necessary first

    %hash=(
           key1 => value1,
           key2 => value2,
          );

and then you can add the tags you wish without modifying original indention and spaces.

    \PREFIX<%>\BOLD<hash>=\ITALIC<(>
           \BOLD<\YELLOW<key1>> => \GREEN<value1>,
           \BLACK<\ITALIC<key2>> => value2,
          \ITALIC<)>;