Editing CommunityData:Beamer

== Dependencies ==

* TeX and Beamer — On Debian or Ubuntu, you can install the following packages:
** texlive-latex-base
** latex-beamer
** rubber
** latexmk
** texlive-fonts-extra
* [https://www.gnu.org/software/gawk/gawk gawk] — Package should be <code>gawk</code>
* [https://github.com/pdfpc/pdfpc PDF Presenter Console]

== Getting Basic Templates ==

First step is to download the basic templates from [http://projects.mako.cc/source/?p=beamer-mako the git repository]:

 git clone git://projects.mako.cc/beamer-mako

The path of least resistance will be to clone the repository so that is located as a subdirectory of <code>~/tex/</code>.

Next, copy or create symlinks so that the following three files are in your path (e.g., in <code>~/bin/</code> if that's in your path):

* <code>new_beamer_presentation</code>
* <code>vc-git</code>
* <code>vc-git.awk</code>

Once you have done this, you can use the script to create new presentations like:

 new_beamer presentation foo-20150920

This will create a new subdirectory called <code>foo-20150920</code> with a file called <code>foo-20150920.tex</code> inside.

== Modify/Customize Templates ==

At the very least, you will need to modify the lines that start with <code>\title</code>, <code>\author</code>, and <code>\institute</code>. Please don't push back changes or patches that include modifications to these lines.

== Building Slides and Presenting ==

The templates assume that you'll be presenting with [https://github.com/pdfpc/pdfpc PDF Presenter Console] which is a pretty full featured presenter console written specifically with Beamer in mind. If you run into any trouble, please [https://github.com/pdfpc/pdfpc download and install the latest version of PDFPC from Github] as the note functionality we use is not in some released version of Debian and Ubuntu who have lagged behind development and been slow to pull in new patches fixing bugs and adding functionality.

To tell if your version of PDFPC will work, you can run <code>pdfpc --help</code> and look to see if it has an option for <code>-n/--notes</code>. If it has this option, you are likely good to go. You can also run <code> pdfpc -v</code> to see which version is installed. Version 4.0 (and perhaps earlier) has support for notes, so if the version is >= 4.0, then it should work.

There are three basic ways to build slides that are supported by the makefile in the repository:

* <code>make pdf</code> — Create a double-wide slide that is appropriate for displaying with PDFPC's "notes" feature. Effectively, the left part will be the slide displayed on the projector and the right part will be the notes displayed on your laptop screen. This will require a new version of PDFPC.
* <code>make notesonly</code> — Generate only the notes (e.g., for printing out speaker notes)
* <code>make slides</code> — Generate only the PDF slides which will be appropriate for presenting with a PDF viewer other than PDFPC.

If you want to switch between building notes, slides, or notes only, you will need to run <code>make clean</code> to "reset" your repository.

When you are ready to present, run the following command from a terminal on the monitor that you want to be the secondary or laptop monitor. The slides should presented on the other monitor:

 make pdfpc

This will run a command like this (which you could also do directly):

 pdfpc --notes=right presentation.pdf

This show the notes on the monitor to the right (usually the second monitor on most setups). You can obviously switch this to left, top, or bottom as per your arrangement of displays.