Commits

Anonymous committed 276233c

*** empty log message ***

Comments (0)

Files changed (7)

 	  "at the end".
 	- Block environments now accept overlay specification also before
 	  the argument.
+	- Added \lecture command and \includeonlylecture (useful for
+	  lecture notes).  
 	
 	Changed:
 	- Every frame is now put into a box internally. Slides will never
  7) Add commands for zooming out parts of complex slides.
  8) Make \cite commands hyperlink.
  9) Make section and subsections breakable in sidebars.
-10) Add \lecture and \includeonlylecture commands.

base/beamerbaseframe.sty

   \ifx\beamer@framerestriction\@undefined\else% restriction stuff
     \expandafter\beamer@checkifinlist\beamer@framerestriction\relax%
   \fi%
+  \ifbeamer@inlecture%
+  \else%
+    \gdef\beamer@whichframes{all:0}%
+  \fi%
   \ifx\beamer@againname\@empty%
     \beamer@slideinframe=0\relax%
     \beamer@anotherslidefalse%
   \def\beamer@endframe{%
     \beamer@templateframeend\egroup}
 
-  \long\def\useframetemplate#1#2{\gdef\beamer@templateframestart{#1}\gdef\beamer@templateframeend{#2}}
-  \useframetemplate{}{}
-
   \def\includeonlyframes#1{}% no effect
 }
 
 <all>
 {
   \beamer@slideinframe=1\relax%
+
+  \long\def\useframetemplate#1#2{\gdef\beamer@templateframestart{#1}\gdef\beamer@templateframeend{#2}}
+  \useframetemplate{}{}
 }
 
 
 % Linebreak command
 %
 \renewcommand<>{\\}{\only#1{\beameroriginal\\}}
+\renewcommand<>{\@centercr}{\only#1{\beameroriginal\@centercr}}
 
 \mode
 <article>
   \def\\{\beamer@ifnextcharospec{\beamer@breaker}{\beamer@@breaker}}
   \def\beamer@breaker<#1>{\only<#1>{\beamer@origbreak}}
   \def\beamer@@breaker{\ifbeamer@inframe\else\expandafter\beamer@origbreak\fi}
+
+  \let\beamer@origbreamcenter=\@centercr
+  \def\@centercr{\beamer@ifnextcharospec{\beamer@breakercenter}{\beamer@@breakercenter}}
+  \def\beamer@breakercenter<#1>{\only<#1>{\beamer@origbreakcenter}}
+  \def\beamer@@breakercenter{\ifbeamer@inframe\else\expandafter\beamer@origbreakcenter\fi}
 }
 
 

base/beamerbasemodes.sty

 \def\beamer@outsidemode{\afterassignment\beamer@treat\let\beamer@nexttoken=}
 \def\beamer@treat{%
   \ifx\beamer@nexttoken\frame\let\next=\beamer@stopoutsidemode\fi%
+  \ifx\beamer@nexttoken\lecture\let\next=\beamer@stopoutsidemode\fi%
   \ifx\beamer@nexttoken\notes\let\next=\beamer@stopoutsidemode\fi%
   \ifx\beamer@nexttoken\noteitems\let\next=\beamer@stopoutsidemode\fi%
   \ifx\beamer@nexttoken\appendix\let\next=\beamer@stopoutsidemode\fi%

base/beamerbasesection.sty

 
 
 %
+% Lecture Definitions
+%
+\newif\ifbeamer@inlecture
+\beamer@inlecturetrue
+
+\newcounter{lecture}
+\renewcommand\thelecture{\@arabic\c@lecture}
+\let\insertlecturenumber=\thelecture
+\newcommand\lecture{\@dblarg\beamer@lecture}
+\long\def\beamer@lecture[#1]#2#3{
+  \beamer@savemode
+  \refstepcounter{lecture}
+  \def\beamer@currentlecturelabel{#3}
+  \def\beamer@lecturename{#2}
+  \def\beamer@shortlecturename{#1}
+  \ifx\beamer@onlylecture\@empty
+  \else
+    \ifx\beamer@currentlecturelabel\beamer@onlylecture
+      \beamer@inlecturetrue
+    \else
+      \beamer@inlecturefalse
+    \fi
+  \fi
+  \beamer@atbeginlecture
+  \beamer@resumemode
+}
+
+
+\mode
+<all>
+{
+  \long\def\AtBeginLecture#1{%
+    \def\beamer@atbeginlecture{#1}}
+  \AtBeginLecture{}
+
+  \newcommand\includeonlylecture[1]{%
+    \def\beamer@onlylecture{#1}}
+
+  \includeonlylecture{}
+}
+
+\newcommand\insertlecture{\beamer@lecturename}
+\newcommand\insertshortlecture[1][]{%
+  {%
+    \beamer@setupshort{#1}%
+    \beamer@insertshort{\beamer@shortlecturename}%
+  }}
+
+\mode
+<article>
+{
+  % no effect
+  \newcommand\lecture[3][]{}
+}
+
+
+%
 % Part Definitions
 %
 \newcounter{part}
 \newcommand<>{\part}{\alt#1{\@dblarg\beamer@part}{\beamer@gobbleoptional}}
 \long\def\beamer@part[#1]#2{%
   \beamer@savemode%
-  \refstepcounter{part}%
-  \def\beamer@partname{#2}%
-  \def\beamer@partnameshort{#1}%
-  \addtocontents{nav}{\protect\headcommand{\protect\partentry{#2}{\the\c@part}}}%
-  \xdef\partlink{{Navigation\the\c@page}{\noexpand\beamer@partname}}%
-  \xdef\partlinkshort{{Navigation\the\c@page}{\noexpand\beamer@partnameshort}}%
-  \beamer@tempcount=\c@page\advance\beamer@tempcount by -1%
-  \addtocontents{nav}{\protect\headcommand{%
-      \protect\beamer@partpages{\the\beamer@partstartpage}{\the\beamer@tempcount}}}%
-  \addtocontents{nav}{\protect\headcommand{%
-      \protect\beamer@sectionpages{\the\beamer@sectionstartpage}{\the\beamer@tempcount}}}%
-  \addtocontents{nav}{\protect\headcommand{%
-      \protect\beamer@subsectionpages{\the\beamer@subsectionstartpage}{\the\beamer@tempcount}}}%
-  \beamer@partstartpage=\c@page%
-  \beamer@sectionstartpage=\c@page%
-  \beamer@subsectionstartpage=\c@page%
-  \setcounter{subsection}{0}%
-  \def\insertsection{}%
-  \def\insertsubsection{}%
-  \def\lastsubsection{}%
-  \def\insertpart{\expandafter\hyperlink\partlink}%
-  \beamer@atbeginpart%
+  \ifbeamer@inlecture%
+    \refstepcounter{part}%
+    \def\beamer@partname{#2}%
+    \def\beamer@partnameshort{#1}%
+    \addtocontents{nav}{\protect\headcommand{\protect\partentry{#2}{\the\c@part}}}%
+    \xdef\partlink{{Navigation\the\c@page}{\noexpand\beamer@partname}}%
+    \xdef\partlinkshort{{Navigation\the\c@page}{\noexpand\beamer@partnameshort}}%
+    \beamer@tempcount=\c@page\advance\beamer@tempcount by -1%
+    \addtocontents{nav}{\protect\headcommand{%
+        \protect\beamer@partpages{\the\beamer@partstartpage}{\the\beamer@tempcount}}}%
+    \addtocontents{nav}{\protect\headcommand{%
+        \protect\beamer@sectionpages{\the\beamer@sectionstartpage}{\the\beamer@tempcount}}}%
+    \addtocontents{nav}{\protect\headcommand{%
+        \protect\beamer@subsectionpages{\the\beamer@subsectionstartpage}{\the\beamer@tempcount}}}%
+    \beamer@partstartpage=\c@page%
+    \beamer@sectionstartpage=\c@page%
+    \beamer@subsectionstartpage=\c@page%
+    \setcounter{subsection}{0}%
+    \def\insertsection{}%
+    \def\insertsubsection{}%
+    \def\lastsubsection{}%
+    \def\insertpart{\expandafter\hyperlink\partlink}%
+    \beamer@atbeginpart%
+  \fi%
   \beamer@resumemode}%
 \def\insertpart{}
 \def\partlinkshort{{Navigation1}{}}
 \long\def\beamer@@@section#1{\beamer@section[#1]{#1}}
 \long\def\beamer@section[#1]#2{%
   \beamer@savemode%
-  \refstepcounter{section}%
-  \beamer@ifempty{#2}%
-  {\long\def\secname{#1}}%
-  {\advance\beamer@tocsectionnumber by 1\relax%
-   \long\def\secname{#2}\addtocontents{toc}{\protect\beamer@sectionintoc{\the\c@section}{#2}{\thepage}{\the\c@part}%
-      {\the\beamer@tocsectionnumber}}}%
-  \addtocontents{nav}{\protect\headcommand{\protect\sectionentry{\the\c@section}{#1}{\thepage}{\secname}{\the\c@part}}}%
-  {\let\\=\relax\xdef\sectionlink{{Navigation\the\c@page}{\noexpand\secname}}}%
-  \beamer@tempcount=\c@page\advance\beamer@tempcount by -1%
-  \addtocontents{nav}{\protect\headcommand{\protect\beamer@sectionpages{\the\beamer@sectionstartpage}{\the\beamer@tempcount}}}%
-  \addtocontents{nav}{\protect\headcommand{\protect\beamer@subsectionpages{\the\beamer@subsectionstartpage}{\the\beamer@tempcount}}}%
-  \beamer@sectionstartpage=\c@page%
-  \beamer@subsectionstartpage=\c@page%
-  \def\insertsection{\expandafter\hyperlink\sectionlink}%
-  \def\insertsubsection{}%
-  \def\lastsubsection{}%
-  \Hy@writebookmark{\the\c@section}{\secname}{Outline\the\c@section}{1}{toc}%
-  \hyper@anchorstart{Outline\the\c@section}\hyper@anchorend%
-  \beamer@ifempty{#2}{\beamer@atbeginsections}{\beamer@atbeginsection}%
+  \ifbeamer@inlecture
+    \refstepcounter{section}%
+    \beamer@ifempty{#2}%
+    {\long\def\secname{#1}}%
+    {\advance\beamer@tocsectionnumber by 1\relax%
+      \long\def\secname{#2}\addtocontents{toc}{\protect\beamer@sectionintoc{\the\c@section}{#2}{\thepage}{\the\c@part}%
+        {\the\beamer@tocsectionnumber}}}%
+    \addtocontents{nav}{\protect\headcommand{\protect\sectionentry{\the\c@section}{#1}{\thepage}{\secname}{\the\c@part}}}%
+    {\let\\=\relax\xdef\sectionlink{{Navigation\the\c@page}{\noexpand\secname}}}%
+    \beamer@tempcount=\c@page\advance\beamer@tempcount by -1%
+    \addtocontents{nav}{\protect\headcommand{\protect\beamer@sectionpages{\the\beamer@sectionstartpage}{\the\beamer@tempcount}}}%
+    \addtocontents{nav}{\protect\headcommand{\protect\beamer@subsectionpages{\the\beamer@subsectionstartpage}{\the\beamer@tempcount}}}%
+    \beamer@sectionstartpage=\c@page%
+    \beamer@subsectionstartpage=\c@page%
+    \def\insertsection{\expandafter\hyperlink\sectionlink}%
+    \def\insertsubsection{}%
+    \def\lastsubsection{}%
+    \Hy@writebookmark{\the\c@section}{\secname}{Outline\the\c@section}{1}{toc}%
+    \hyper@anchorstart{Outline\the\c@section}\hyper@anchorend%
+    \beamer@ifempty{#2}{\beamer@atbeginsections}{\beamer@atbeginsection}%
+  \fi%
   \beamer@resumemode}%
 \def\insertsection{}
 \def\lastsubsection{}
 \def\beamer@@@subsection#1{\beamer@subsection[#1]{#1}}
 \def\beamer@subsection[#1]#2{%
   \beamer@savemode%
-  \refstepcounter{subsection}%
-  \beamer@ifempty{#2}{\long\def\subsecname{#1}\long\def\lastsubsection{#1}}
-  {%
-    \long\def\subsecname{#2}%
-    \long\def\lastsubsection{#1}%
-    \addtocontents{toc}{\protect\beamer@subsectionintoc{\the\c@section}{\the\c@subsection}{#2}{\thepage}{\the\c@part}{\the\beamer@tocsectionnumber}}%
-  }%
-  \beamer@tempcount=\c@page\advance\beamer@tempcount by -1%
-  \addtocontents{nav}{\protect\headcommand{\protect\beamer@subsectionpages{\the\beamer@subsectionstartpage}{\the\beamer@tempcount}}}%
-  \beamer@subsectionstartpage=\c@page%
-  \edef\subsectionlink{{Navigation\the\c@page}{\noexpand\subsecname}}%
-  \def\insertsubsection{\expandafter\hyperlink\subsectionlink}
-  \Hy@writebookmark{\the\c@subsection}{#1}{Outline\the\c@section.\the\c@subsection.\the\c@page}{2}{toc}%
-  \hyper@anchorstart{Outline\the\c@section.\the\c@subsection.\the\c@page}\hyper@anchorend%
-  \beamer@ifempty{#2}{\beamer@atbeginsubsections}{\beamer@atbeginsubsection}%
+  \ifbeamer@inlecture%
+    \refstepcounter{subsection}%
+    \beamer@ifempty{#2}{\long\def\subsecname{#1}\long\def\lastsubsection{#1}}
+    {%
+      \long\def\subsecname{#2}%
+      \long\def\lastsubsection{#1}%
+      \addtocontents{toc}{\protect\beamer@subsectionintoc{\the\c@section}{\the\c@subsection}{#2}{\thepage}{\the\c@part}{\the\beamer@tocsectionnumber}}%
+    }%
+    \beamer@tempcount=\c@page\advance\beamer@tempcount by -1%
+    \addtocontents{nav}{\protect\headcommand{\protect\beamer@subsectionpages{\the\beamer@subsectionstartpage}{\the\beamer@tempcount}}}%
+    \beamer@subsectionstartpage=\c@page%
+    \edef\subsectionlink{{Navigation\the\c@page}{\noexpand\subsecname}}%
+    \def\insertsubsection{\expandafter\hyperlink\subsectionlink}
+    \Hy@writebookmark{\the\c@subsection}{#1}{Outline\the\c@section.\the\c@subsection.\the\c@page}{2}{toc}%
+    \hyper@anchorstart{Outline\the\c@section.\the\c@subsection.\the\c@page}\hyper@anchorend%
+    \beamer@ifempty{#2}{\beamer@atbeginsubsections}{\beamer@atbeginsubsection}%
+  \fi%
   \beamer@resumemode}
 \def\insertsubsection{}
 

doc/beameruserguide.tex

 
 \section{Introduction}
 
-\subsection{Overview}
-
 This user's guide explains the functionality of the \beamer\ class.
 It is a \LaTeX\ class that allows you to create a presentation with a
 projector. It can also be used to create slides. It behaves 
 advantage that it works together directly with |pdflatex|, but
 also with |dvips|.
 
-To use the \beamer\ class, proceed as follows:
+\subsection{Getting Started with the Beamer Class and \LaTeX/pdf\LaTeX}
+
+To use the \beamer\ class together with |latex| or |pdflatex|, proceed
+as follows: 
 \begin{enumerate}
 \item
   Specify |beamer| as document class instead of
 table of contents, but will also in the navigation bars.
 
 
+\subsection{Getting Started with the Beamer Class and \LyX}
+
+Once installed (see Section~\ref{section-installation}), using the
+\beamer\ class  together with \LyX\ is quite easy: You open a new file
+and choose |beamer| as the document class. It is often even easier to
+choose ``New from template'' and to pick a template from the directory
+|beamer/lyx/templates|. 
+
+To reproduce the example from the previous subsection in \LyX, proceed
+as follows:
+
+\begin{itemize}
+\item
+  The command |\usepackage{beamerthemesplit}| must be added to the
+  preamble. You can edit the preamble using Layout $\rangle$ Document
+  $\rangle$ Preamble.
+\item
+  Typeset the author and date the usual way, using the styles Author
+  and Date. The title page will then
+  be created automatically.
+\item
+  To insert the sections and subsections, use the usual Section and
+  Subsection styles.
+\item
+  To insert the frame containing the tabel of contents, insert a line
+  of style BeginFrame. Since this frame has no title, do not write
+  anything on the line with style BeginFrame. Next, insert a line of
+  Standard style and use Insert $\rangle$ Insert TOC to insert the
+  table of contents. Optionally, end the frame using a line of style
+  EndFrame (the ensuite Section style automatically closes the frame.
+\item
+  To create the last frame, start a new frame using the style
+  BeginFrame. Write the frame title on the line having this
+  style.
+\item
+  Use the Itemize style to create the itemized text.
+\item
+  Add the overlay specifications (the texts like |<1->|) to the items
+  by entering \TeX-mode (press on the little \TeX\ icon) and writing
+  |<1->|. This \TeX\ text should be placed right at the beginning of
+  the item.
+\item
+  You must end this frame using the style EndFrame (sadly, the end of
+  the document and also the beginning of the appendix do not
+  automatically end the last frame -- whereas the start of  a frames,
+  sections, parts, and subsections does).
+\end{itemize}
+
+Now use View $\rangle$ PDF to view the resulting presentation.  
+
+
 \subsection{How to Read this User's Guide}
 
 This user guide is both intended as a tutorial and as a reference
 on how permanently you intend to use the class.
 
 
-\subsection{Installing Debian and Red Hat Packages}
-
-Currently, there are no out-of-the-box Debian or Red Hat packages of
-the beamer class available.
+\subsection{Installing Prebundled Packages Like Debian or Red Hat Packages}
+
+Currently, I'm not producing prebundled packages of |beamer|. There
+are some out-of-the-box Debian packages and Mik\TeX\ packages around,
+but these are likely to be outdated. Once |beamer| stabilizes, there
+will hopefully also be easy-to-install packages. 
 
 
 
 |.tar.gz|) of the \beamer\ package from 
 \href{http://sourceforge.net/projects/latex-beamer/}{|http://sourceforge.net/projects/latex-beamer/|}
 (most likely, you have already done this). Next, you also need at
-least version 0.50 of the \textsc{pgf} package, which can be found at
+least version 0.51 of the \textsc{pgf} package, which can be found at
 the same place. Finally, you need at least version 1.06 of the
 \textsc{xcolor} package, which can also be found at that place
 (although the version on CTAN might be newer).
 For usage of the \beamer\ class with \LyX, you have to do all of the
 above. Then you also have to make \LyX\ aware of the file
 |beamer/lyx/layouts/beamer.layout|. To do so, link (or, not
-so good in case of updates, copy) this file to the directory
+so good in case of later updates, copy) this file to the directory
 |.lyx/layouts| in your home directory. Then use \LyX's Reconfigure
-option to make it aware of this file.
+command to make \LyX\ aware of this file.
 
 \vskip1em
 For a more detailed explanation of the standard installation process
 the file and check whether the resulting |beamerexample1.pdf|
 looks correct. If so, you are all set.
 
+\lyxnote
+To test the \LyX\ installation, try creating a new file from the
+template |beamerpresentation|, which is located in the directory
+|beamer/lyx/templates|.
+
 
 
 
 
 
 \subsubsection{Action Specifications}
-\label{section-alert-specifications}
+\label{section-action-specifications}
 
 
 Some overlay-specification-aware commands cannot only handle normal
   \beamernote
   Only one \meta{alert specification} may be given. The effect of
   \meta{alert specification} is described in
-  Section~\ref{section-alert-specifications}. 
+  Section~\ref{section-action-specifications}. 
   
   \example
 \begin{verbatim}
 |\partpage| to insert some text into a frame that ``advertises'' the
 beginning of a new part. See |beamerexample3.tex| for an example.
 
-\begin{command}{\part\oarg{short part name}\marg{part name}}
+\begin{command}{\part\sarg{mode specification}\oarg{short part name}\marg{part name}}
   Starts a part. The \meta{part name} will be shown when the
   |\partpage| command is used. The \meta{shown part name} is not shown
   anywhere by default, but it is accessible via the command
 \end{command}
 
 
+\subsubsection{Splitting a Course Into Lecutres}
+
+When using \beamer\ with the |article| mode, you may wish to have the
+lecture notes of a whole course reside in one file. In this case, only
+a few frames are actually part of any particular lecture.
+
+The |\lecture| command makes it easy to select only a certain set of
+frames from a file to be presented. This command takes (among other
+things) a label name. If you say |\includeonlylecture| with this label
+name, then only the frames following the |\lecture| command are
+shown. The frames following other |\lecture| commands are suppressed.
+
+By default, the |\lecture| command has no other effect. It does not
+create any frames or introduce entries in the table of
+contents. However, you can use |\AtBeginLecture| to have \beamer\
+insert, say, a title page at the beginning of (each) lecture.
+
+\begin{command}{\lecture\oarg{short lecture name}\marg{lecture
+  name}\marg{lecture label}} 
+  Starts a lecture. The \meta{lecture name} will be available via the
+  |\insertlecture| command. The \meta{short lecture name} is available
+  via the |\insertshortlecture| command.
+  
+  \example
+\begin{verbatim}
+\begin{document}
+\lecture{Vector Spaces}{week 1}
+
+\section{Introduction}
+...
+\section{Summary}
+
+\lecture{Scalar Products}{week 2}
+
+\section{Introduction}
+...
+\section{Summary}
+
+\end{document}
+\end{verbatim}
+
+  \articlenote
+  This command has no effect in |article| mode.
+\end{command}
+
+\begin{command}{\includeonlylecture\meta{lecture label}}
+  Causes all |\frame|, |\section|, |\subsection|, and |\part| commands
+  following a |\lecture| command to be suppressed, except if the
+  lecture's label matches the \meta{lecture label}. Frames before any
+  |\lecture| commands are always included. This command should be
+  given in the preamble.
+
+  \example |\includeonlylecture{week 1}|
+
+  \articlenote
+  This command has no effect in |article| mode.
+\end{command}
+
+\begin{command}{\AtBeginLecture\marg{text}}
+  The given text will be inserted at the beginning of every
+  lecture.
+  
+  \example
+\begin{verbatim}
+\AtBeginLecture{\frame{\Large Today's Lecture: \insertlecture}}
+\end{verbatim}
+
+  \articlenote
+  This command has no effect in |article| mode.
+\end{command}
+
 
 \subsubsection{Adding a Table of Contents}
 
   You need to use \TeX-mode to insert this command.
 \end{command}
 
-\begin{environment}{{block}\marg{block title}\sarg{overlay specification}}
+\begin{environment}{{block}\sarg{action specification}\marg{block
+      title}\sarg{action specification}}
+  Only one \meta{action specification} may be given.
   Inserts a block, like a definition or a theorem, with the title
-  \meta{block title}. If the \meta{overlay specification} is present,
-  the block is shown only on the specified slides. In the example, the
+  \meta{block title}. If the \meta{action specification} is present,
+  the given actions are taken on the specified slides, see
+  Section~\ref{section-action-specifications}. In the example, the 
   definition is shown only from slide 3 onward.
   \example
 \begin{verbatim}
-  \begin{block}{Definition}<3->
+  \begin{block}<3->{Definition}
     A \alert{set} consists of elements.
   \end{block}
 \end{verbatim}
 \end{environment}
 
 
-\begin{environment}{{alertblock}\marg{block title}\sarg{overlay specification}}
-  Inserts a block whose title is hilighted.  If the \meta{overlay specification} is present,
-  the block is shown only on the specified slides.
+\begin{environment}{{alertblock}\sarg{action specification}\marg{block
+title}\sarg{action specification}} 
+  Inserts a block whose title is hilighted. Behaves like the |block|
+  environment otherwise.
   \example
 \begin{verbatim}
   \begin{alertblock}{Wrong Theorem}
   Same applies as for |block|.
 \end{environment}
 
-\begin{environment}{{exampleblock}\marg{block title}\sarg{overlay specification}}
-  Inserts a block that is supposed to be an example. If the \meta{overlay specification} is present,
-  the block is shown only on the specified slides.
-  \example
-\begin{verbatim}
-  \begin{exampleblock}{Example}
+\begin{environment}{{exampleblock}\sarg{action
+specification}\marg{block title}\sarg{overlay specification}} 
+  Inserts a block that is supposed to be an example. Behaves like the
+  |block| environment otherwise.
+  
+  \example In the following example, the block is completely
+  suppressed on the first slide (it does not even occupy any space).
+\begin{verbatim}
+  \begin{exampleblock}{Example}<only@2->
     The set $\{1,2,3,5\}$ has four elements.
   \end{exampleblock}
 \end{verbatim}
 \end{environment}
   
 Predefined English block environments, that is, block environments
-with fixed title, are: |Theorem|, |Proof|, |Corollary|,
-|Fact|, |Example|, and |Examples|. You can also use these
-environments with a lowercase first letter, the result  is the
+with fixed title, are: |Theorem|, |Proof|, |Corollary|, |Definition|,
+|Definitions|, |Fact|, |Example|, and |Examples|. You can also use
+these environments with a lowercase first letter, the result  is the
 same. The following German block environments are also predefined:
 |Problem|, |Loesung|, |Definition|, |Satz|,
 |Beweis|, |Folgerung|, |Lemma|, |Fakt|,
 commands can only be used \emph{inside} a frame, the last two only
 \emph{outside}.
 
+\lyxnote
+In \LyX, only the most useful of these commands, namely |\noteitem| is
+avaiable in the form of the NoteItem style.
+
 The effect of |\note|\meta{text} is the following: When you use it
 somewhere inside the frame on a specific slide, a note page is created
 after the slide, containing the \meta{text}. Since you can add an
   usually a good idea.
   
   \example|\note<2>{Do not talk longer than 2 minutes about this.}|
+
+  \articlenote
+  Notes are ignored in |article| mode.
 \end{command}
 
 \begin{command}{\noteitem\sarg{overlay specification}\marg{note text}}
   and |\noteitem| are mixed on a slide, the notes come first, followed
   by the list of note items.
   
-  \example|\noteitem<2>{Stress this.}|  
+  \example|\noteitem<2>{Stress this.}|
+
+  \articlenote
+  Notes are ignored in |article| mode.
+
+  \lyxnote
+  Use the NoteItem style to insert a note item. 
 \end{command}
 
 The commands |\notes| and |\noteitems| should be used outside
 \frame{some text}
 \note{Talk no more than 1 minute.}
 \end{verbatim}
+
+  \articlenote
+  Notes are ignored in |article| mode.
 \end{command}
 
 \begin{command}{\noteitems\marg{list of item commands}}
 \item Use no more than 2 minutes.
 }
 \end{verbatim}
+
+  \articlenote
+  Notes are ignored in |article| mode.
 \end{command}
 
 
 \subsubsection{Including Slides from the Presentation Version in the
   Article Version}
 
+If you use the package |beamerbasearticle|, the |\frame| command
+becomes available in |article| mode. By adjusting the frame template,
+you can ``mimick'' the appearance of frames typeset by \beamer\ in
+your articles. However, sometimes you may wish to insert ``the real
+thing'' into the |article| version, that is, a precise ``screenshot''
+of a slide from the presentation. The commands introduced in the
+following help you do exactly this.
+
 In order to include a slide from your presentation in your article
 version, you must do two things: First, you must place a normal
 \LaTeX\ label on the slide using the |\label| command. Since this

lyx/layouts/beamer.layout

   EndFont
 End
 
+Style NoteItem
+  Margin		Static
+  LatexType		Command
+  LatexName		noteitem
+  ParSkip               0.5
+  TopSep                1
+  BottomSep             1
+  ParSep                0
+  Align			Left
+  LabelType		Static
+  LabelSep              xx
+  LabelString		"note: " 
+  OptionalArgs		1
+  LeftMargin        MMM
+
+  # standard font definition
+  LabelFont 
+    Family		Roman
+    Color               latex
+  EndFont
+End
+
+
 Style Only
   Margin		First_Dynamic
   LatexType		Environment