summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pdfpc/README.md
blob: 5d243921dedfe4d1925b4923dec6824786378115 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# pdfpc

This LaTeX package provides a convenient way to specify notes and to define
certain meta properties of the presentation when used with [PDF Presenter
Console (`pdfpc`)](https://pdfpc.github.io), a GPLv3+ licensed multi-monitor PDF
presentation viewer application available on GitHub.


## Dependencies

The `pdfpc` package depends on these other packages:
[`kvoptions`](https://ctan.org/pkg/kvoptions),
[`xstring`](https://ctan.org/pkg/xstring),
[`iftex`](https://ctan.org/pkg/iftex),
[`hyperxmp`](https://ctan.org/pkg/hyperxmp)

When using LuaTeX, it additionally depends on these packages:
[`stringenc`](https://ctan.org/pkg/stringenc),
[`pdftexcmds`](https://ctan.org/pkg/pdftexcmds)


## Usage

The [PDF Presenter Console](https://pdfpc.github.io) program accepts a variety
of configuration options when started from the command line. (See the *pdfpc(1)*
manual page for details.)

This package allows certain details, such as presentation duration, default
slide transitions, and speaker notes, to be specified within the metadata of the
PDF itself, instead of via the command line. These settings are parsed by the
PDF Presenter Console when the presentation is loaded.

These parameters can be specified as package options, or via the `\pdfpcsetup` command.

The following is a simple LaTeX document demonstrating a few example features:

```latex
\documentclass{beamer}
\usepackage[overridenote]{pdfpc}
% "overridenote" must be specified as a package option
\pdfpcsetup{
    % Other settings can be package options, or can go here
    duration=5,
    lastminutes=2,
}

% The usual Beamer document setup
\title{\texttt{pdfpc} Example Presentation}
\author{\texttt{pdfpc} Contributors}
\institute{GitHub}
\date{\today}

\begin{document}
\maketitle

\begin{frame}
    Hello PDFPC World!
    % Because of "overridenote", this uses the pdfpc note command
    \note{This speaker note will be shown by `pdfpc`, but hidden for the audience.}
    \pause
    Notice that the timer starts counting down from 5 minutes, just as we specified in the preamble!
\end{frame}

\end{document}
```


## Documentation

Complete
[documentation](http://mirrors.ctan.org/macros/latex/contrib/pdfpc/pdfpc-doc.pdf)
for the current version of `pdfpc` is availble on [its CTAN
page](https://ctan.org/pkg/pdfpc).