You are using a browser which doesn't fully support Cascading Style Sheets. This site will look much better in a browser that supports web standards, but its content is accessible to any browser or Internet device.

Defining document streams

A docstream is a section of a chapter that can include many paragraphs. It starts with a special paragraph type and ends together with the chapter or another docstream start. The starting paragraph has a tilde ( ~) prefix and contains the name of the docstream.

     =An Exciting Slide
  
     * Point One
  
     * Point Two
  
     * Point Three
  
     ~notes
  
     Point one is important because blah blah
  
     Point two really means that blah ...
  
     =Another

This is a possible source for the slide that Robert requested. At the beginning of the chapter ( =An Exciting Slide) the default stream main is entered. Everything belongs to this stream until the stream start paragraph, ~notes. All subsequent paragraphs in this chapter now belong to that stream. So, the chapter really has two parts now.

     =An Exciting Slide
  
     * Point One
  
     * Point Two
  
     * Point Three
  
     ~notes
  
     Point one is important because blah blah
  
     Point two really means that blah ...

The parts do not have to be defined in blocks, they can be interrupted by others. It's also possible to have many streams in a chapter and not only two. Switching back to the main stream is possible by using a ~main paragraph.

     =Streaming chapter
  
     This goes to the main stream.
  
     ~notes
  
     This is a note.
  
     ~main
  
     Back to the main stream.
  
     ~secret notes
  
     Notes of a special type.
  
     ~main
  
     Back to the main stream.
  
     ~notes
  
     Standard notes again.

Ok, fine, we have divided our chapter into parts. But to translate this into a layout like Roberts, we have to go through two more steps: processing and layout definition.