# [Tex/LaTex] How to add side-icons in a LaTeX book

book-designfloatsgraphics

Most of the technical books I've read use what I call "side icons" to mark out certain types of content. Stuff like "watch out for this" and "helpful tip", with corresponding icons.

Here's an example of what I mean (the "key point" and "coding horror" icons):

Taken from http://www.codinghorror.com/blog/2007/12/on-the-meaning-of-coding-horror.html

How can I do this in LaTeX (with \documentclass{book})? To be clear, I want to be able to attach icons (with captions) to text so that the icons are outside the normal flow of the text.

I have tried \marginpar (reversed), it's always pushing a portion of the image out of the paper. For example, the following code:

\reversemarginpar
\chapter{Getting started}
AABBB
\marginpar{\includegraphics[scale=0.3]{images/example}}

CCC


gives:

I get similar results with \marginnote

Try a right-justified paragraph:

\marginpar{\hfill\includegraphics[scale=0.3]{images/example}}


On even-numbered pages, you need a left-justified paragraph:

\marginpar{\includegraphics[scale=0.3]{images/example}\hfill}


This can be simplified by using the optional argument for odd/even pages. It is convenient to encapsulate all this magic in a macro.

You may also need to adjust the size of the images to the width of the margin par:

\marginpar{\hfill\includegraphics[width=\marginparwidth]{images/example}}


or use a fraction:

\marginpar{\hfill\includegraphics[width=0.95\marginparwidth]{images/example}}