Skip to content

Latest commit

 

History

History
39 lines (27 loc) · 1.57 KB

doc_iterm_profiles.md

File metadata and controls

39 lines (27 loc) · 1.57 KB
title tags keywords last_updated summary
iTerm profiles
publishing
iterm, terminal, build shortcuts, mac
August 12, 2015
Set up profiles in iTerm to facilitate the build process with just a few clicks. This can make it a lot easier to quickly build multiple outputs.

About iTerm profiles

When you're working with tech docs, a lot of times you're single sourcing multiple outputs. It can be a hassle to fire up each one of these outputs using the build files containing the shell scripts. Instead, it's easier to configure iTerm with profiles that initiate the scripts.

Set up profiles

  1. Open iTerm and go to Profiles > Open Profiles.

  2. Click Edit Profiles.

  3. Click the + button in the lower-left corner to create a new profile.

  4. In the Name field, type a name describing the output, such as Doc theme -- designers.

  5. In the Send text at start field, type the command for the build script, such as this:

    jekyll serve --config configs/config_designers.yml

    Leave the Login shell option selected.

  6. In the Working Directory section, select Directory and enter the directory for your project, such as /Users/tjohnson/projects/documentation-theme-jekyll.

  7. Close the profiles panel.

Here's an example:

iTerm profile example

Launching a profile

  1. In iTerm, make sure the Toolbar is shown. Go to View > Toggle Toolbar.
  2. Click the New button and select your profile.

{{site.data.alerts.tip}} When you're done with the session, make sure to click Ctrl+C.{{site.data.alerts.end}}