How to create a short caption (as \listoffigures entry) with \twopagepicture?

Question

Using the \twopagepicture command like in this example (How to include a picture over two pages, left part on left side, right on right (for books)?), is there any chance to create an entry to the List of Figures which only takes part of a very long figure caption (instead of the "...very very...long caption" itself; similar to the \caption[]{} command), such as

....
\twopagepicture{t}{p}{image}*[short caption]*{Other test with 
very very very very very very very very very very very
very very very very very very very very very very very
very very very very very very very very very very very
long caption
}
...,

starting form the above-posted example? I am facing this problem in my thesis for a two-page figure where a long caption is inevitable. A general option, of course, would be to give the details on the figure in the text but (a) this does not meet with my supervisor´s approval, and (b) a statement like "See text for further details" in the figure caption would also enter the List of Figures which, I think, is not adequate for a LoF entry. So this option is actually not an option for me. Maybe the answer is very simple but I have not come across it yet...

Any suggestions are highly appreciated. Thank you very much for your time!

Answer 1

Just to let people know, this is the beautiful code you cite, written by Martin Scharrer:

\makeatletter
\newcommand*{\twopagepicture}[4]{%
    \checkoddpage
    \ifoddpage
        \expandafter\@firstofone
    \else
        \expandafter\afterpage
    \fi
    {\afterpage{%
    \if #1t%
        \if #2p%
            \thispagestyle{empty}%
            \afterpage{\thispagestyle{empty}}%
        \fi
    \fi
    \begin{figure}[#1]
        \if #2p%
            \if #1t%
                \vspace*{-\dimexpr1in+\voffset+\topmargin+\headheight+\headsep\relax}%
            \fi
        \fi
        \if #1b%
            \caption{#4}%
        \fi
        \makebox[\textwidth][l]{%
        \if #2p\relax
            \let\mywidth\paperwidth
            \hskip-\dimexpr1in+\hoffset+\evensidemargin\relax
        \else
            \let\mywidth\linewidth
        \fi
        \adjustbox{trim=0 0 {.5\width} 0,clip}{\includegraphics[width=2\mywidth]{#3}}}%
        \if #1b\else
            \caption{#4}%
        \fi
        \if #2p%
            \if #1b%
                \vspace*{-\dimexpr\paperheight-\textheight-1in-\voffset-\topmargin-\headheight-\headsep\relax}%
            \fi
        \fi
    \end{figure}%
    \begin{figure}[#1]
        \if #2p%
            \if #1t%
                \vspace*{-\dimexpr1in+\voffset+\topmargin+\headheight+\headsep\relax}%
            \fi
        \fi
        \makebox[\textwidth][l]{%
        \if #2p%
            \let\mywidth\paperwidth
            \hskip-\dimexpr1in+\hoffset+\oddsidemargin\relax
        \else
            \let\mywidth\linewidth
        \fi
        \adjustbox{trim={.5\width} 0 0 0,clip}{\includegraphics[width=2\mywidth]{#3}}}%
        \if #2p%
            \if #1b%
                \vspace*{-\dimexpr\paperheight-\textheight-1in-\voffset-\topmargin-\headheight-\headsep\relax}%
            \fi
        \fi
    \end{figure}%
    }}%
}
\makeatother

To achieve what you want, replace the two lines:

            \caption{#4}%

with

            \caption#4%

so to have

\makeatletter
\newcommand*{\twopagepicture}[4]{%
    \checkoddpage
    \ifoddpage
        \expandafter\@firstofone
    \else
        \expandafter\afterpage
    \fi
    {\afterpage{%
    \if #1t%
        \if #2p%
            \thispagestyle{empty}%
            \afterpage{\thispagestyle{empty}}%
        \fi
    \fi
    \begin{figure}[#1]
        \if #2p%
            \if #1t%
                \vspace*{-\dimexpr1in+\voffset+\topmargin+\headheight+\headsep\relax}%
            \fi
        \fi
        \if #1b%
            \caption#4%
        \fi
        \makebox[\textwidth][l]{%
        \if #2p\relax
            \let\mywidth\paperwidth
            \hskip-\dimexpr1in+\hoffset+\evensidemargin\relax
        \else
            \let\mywidth\linewidth
        \fi
        \adjustbox{trim=0 0 {.5\width} 0,clip}{\includegraphics[width=2\mywidth]{#3}}}%
        \if #1b\else
            \caption#4%
        \fi
        \if #2p%
            \if #1b%
                \vspace*{-\dimexpr\paperheight-\textheight-1in-\voffset-\topmargin-\headheight-\headsep\relax}%
            \fi
        \fi
    \end{figure}%
    \begin{figure}[#1]
        \if #2p%
            \if #1t%
                \vspace*{-\dimexpr1in+\voffset+\topmargin+\headheight+\headsep\relax}%
            \fi
        \fi
        \makebox[\textwidth][l]{%
        \if #2p%
            \let\mywidth\paperwidth
            \hskip-\dimexpr1in+\hoffset+\oddsidemargin\relax
        \else
            \let\mywidth\linewidth
        \fi
        \adjustbox{trim={.5\width} 0 0 0,clip}{\includegraphics[width=2\mywidth]{#3}}}%
        \if #2p%
            \if #1b%
                \vspace*{-\dimexpr\paperheight-\textheight-1in-\voffset-\topmargin-\headheight-\headsep\relax}%
            \fi
        \fi
    \end{figure}%
    }}%
}
\makeatother

Now use the command \twopagepicture in this way:

\twopagepicture{b}{l}{image}{{Test}}

when you DON'T want the abbreviated caption (note the double braces in the last argument), and

\twopagepicture{t}{p}{image}{[abbreviation]{Other test with
very very very very very very very very very very very
very very very very very very very very very very very
very very very very very very very very very very very
long caption}}

when you DO want the abbreviated caption ([abbreviation] in this case).

Answer 2

If the caption package is used replace

\newcommand*{\twopagepicture}[4]{%

with

\newcommand*{\twopagepicture}[3]{%
  \caption@withoptargs{\@twopagepicture{#1}{#2}{#3}}}
\newcommand*{\@twopagepicture}[5]{%

and within the macro definition replace

\caption{#4}%

(twice) with

\caption#4{#5}%

Afterwards

\twopagepicture{t}{p}{image}[short caption]{Other test with 
very very very very very very very very very very very
very very very very very very very very very very very
very very very very very very very very very very very
long caption
}

should work as expected.

(\caption@withoptargs collects optional arguments and passes them as extra argument, #4 is this case. If no optional argument is given this extra argument is empty.)