---
title:  Welcome to middleman-targets
layout: template-logo-large
---

# Welcome to middleman-targets

The `middleman-targets` gem is an extension to [Middleman][1] that gives you the
ability to specify multiple build targets and provides useful tools for dealing
with multiple targets and features.

- Generate multiple targets for different uses using the same basic project
  structure, content, and code.
- Assign “features” to targets which give you fine-grained control over what
  content appears in each target.
- Select images automatically based on the current build target.
- Use images selectively based on the current build target or feature.
- Include target-specific versions of data in a consistent fashion.

`middleman-targets` was written as part of the [Middlemac][2] Help Book building
system for Mac OS X applications, but it’s suitable for any project that
requires multiple build targets, such as software documentation, training
manuals, and more.

This documentation will refer to two sample targets: `:pro` and `:free`, which
is something that a typical software publisher might do.

Note that parts of this documentation will have different content depending on
whether you are building the `:pro` or `:free` target. These are just examples,
though, and all of the technical documentation is the same.
{:.note}

* * *

[Simple features demonstration](simple-demo.html)

 : The features demonstration shows you what `middleman-targets` can do for you.

[Build and Serve Different Targets](build-serve-targets.html)

 : Learn how to build and serve different targets using `middleman-targets`.

[Configuration](target-feature-config.html)

 : Proper configuration is the key to building and serving multiple targets
   with the features that you want.

[Helpers and Resources](helpers-resources.html)

 : Discover the helpers and resources that make working with `middleman-targets`
   easier.

[Front Matter](frontmatter.html)

 : Learn how to use front matter to include or exclude pages only for certain
   targets or features.

[The Command Line Interface](cli.html)

 : Use the simple command line interface to generate documentation and sample
   projects.

[The MIT License](license.html)

 : Describes your legal rights and obligations for using these materials.


 [1]: https://middlemanapp.com/
 [2]: https://github.com/middlemac