Unequivocally force first reference to same page as the referred item?

Question

Background

Writing a manual using LyX. All tables, figures, and source listings are always referenced in the paragraph (or enumerated step) that immediately precedes them. The preamble to the manual includes \raggedbottom to prevent large vertical spaces between list items.

Problem

The problem can be seen here:

The heading "1.1 Hierarchies" (no orphaned headings allowed) and the reference to "Figure 1.1" should be at the top of Page 2, on the same page as the image.

LaTeX Code

The images are added to floats so that they can have captions and cross-references. The LyX documents contain the following commands:

\float_placement H

I have tried changing the commands to:

\float_placement !htbp

These affect figure placement, but do nothing for the cross-references.

LyX Code

This is the code that LyX generates:

\begin{figure}[H]
\includegraphics{drawings/directory-hierarchy-01}

\caption{\label{fig:Example-Directory-Organization}Recommended Directory Organization}

\end{figure}

Possible Solutions

1. \begin{samepage} ... \end{samepage}
2. \clearpage

The \clearpage option is possible when the manual is complete. The samepage environment needs tweaking.

Question

What needs to be added to the document preamble to force the first cross-reference to remain on the same page as the item that is being referenced?

Related

• Force image and its caption to be on the same page
• Keeping tables/figures close to where they are mentioned
• Force figure placement in text

Answer 1

Looking at the relevant entry on the UK's TeX FAQ, there is probably no way to automatically and conveniently do this.

Indeed, the two most simple solutions would be to use the samepage environment (which may not work in all situations) or manually insert \clearpage as needed.

My advise would be to leave the figures wherever they happen to fall, and only in the end add \clearpage's as appropriate to break pages exactly at the places you want.

Sorry, there seems to be no “keep with next” in (La)TeX.