public class Paginate : ContainerModule, IModule, IModuleList, IList<IModule>

If your input document is a Razor template for a blog archive, you can use Paginate to get pages of 10 blog posts each. If you have 50 blog posts, the result of the Paginate module will be 5 copies of your input archive template, one for each page. Your configuration file might look something like this:

 Pipelines.Add("Posts",
     ReadFiles("*.md"),
     Markdown(),
     WriteFiles("html")
 );

 Pipelines.Add("Archive",
     ReadFiles("archive.cshtml"),
     Paginate(10,
         Documents("Posts")
     ),
     Razor(),
     WriteFiles(string.Format("archive-{0}.html", @doc["CurrentPage"]))
 );

This module forms pages from the output documents of the specified modules. Each input document is cloned for each page and metadata related to the pages, including the sequence of documents for each page, is added to each clone. For example, if you have 2 input documents and the result of paging is 3 pages, this module will output 6 documents. Note that if there are no documents to paginate, this module will still output an empty page without any documents inside the page.