# pp(1) `pp(1)` is a shell preprocessor developed by our own user [adi](https://adi.tilde.institute). It allows one to embed shell into any text file between instances of the token `#!`. This powerful tool allows the dynamic generation of static pages using standard bourne shell. For example: ```

#! i=1 while test $i -le 10 do if test $((i % 2)) -eq 0 then #!
• $i
#! else #!
• $i
#! fi i=$((i + 1)) done #!

``` Will output, per the manual page: ```

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10

``` The manpage includes more information on advanced features, such as piping `stdin` and debugging. ## Notes * Full Guide: [adi.tilde.institute/](https://adi.tilde.institute/) [back](/)