On Thu, Feb 13 2025, Sébastien Gendre <s...@k-7.ch> wrote: > David Masterson <dsmaster...@icloud.com> writes: > >> Forgive the repeat -- I didn't see this come up... >> >> I've been looking at Beamer as a way to write a slide show to help >> explain some projects to others. Working on it, I have developed a >> number of questions that I'm not seeing answers to in the docs. >> >> + What is the difference between TOC and the "Outline" slide? Are they >> meant to be the same thing? >> + Why is my "Outline" slide blank? Shouldn't it be picking up all the >> "H:1" headings? What am I missing? >> + The section on "Table of Contents" mentions the titletoc package, but >> doesn't explain what it is or how to include it. Is this necessary to >> answer the previous question? >> + I think "theme" in Beamer needs more explanation -- perhaps a link to >> even the official Beamer place to find information and sample themes?
There is a huge amount of material about beamer and themes online. Steering users to the official beamer manual may not be the best idea. It is very long, detailed, and likely 95% of it is irrelevant for simple usage. If you are asking for the Beamer manual, but it is here: https://tug.ctan.org/macros/latex/contrib/beamer/doc/beameruserguide.pdf If you are using a texlive distribution, then this should work from the command-line: texdoc -s beamer (the first option will be the locally installed guide). >> + Frames and Blocks are difficult concepts -- perhaps there should be a >> link to examples in Worg to show the possibilities? I still don't get >> the reason for frames and blocks. Perhaps the reference to "Beamer's >> sectioning elements, frames, and blocks" should also link to Beamer's >> official docs to help. As I understand it, a frame is a visual organizational unit that lets one present a number of things sequentially. Roughly, it corresponds to a page, but the writer controls not only where visual elements are displayed on the page, but also in which order. Each visual element needs to be organized into some kind of container: a block is the simplest, and there are several others that are oriented toward an academic user (e.g. theorem). I think the examples on worg do a good job showing how these things work. >> + Basically, I think the Org Mode doc on Exporting to Beamer should have >> a link or two to official Beamer documentation to give new users >> something else to jump into if they want to make really good slides. I don't think this is official, but how about something like: https://latex-beamer.com/quick-start/ ? > > I would like to add that, in the documentation, the beamer export > commands are documented but it miss an essential point: > > To have these commands in the Org export dispatcher, a user first need > to enable "org-beamer-mode". > > Otherwise, the beamer export command do not appear in the export > dispatcher. This complaint may be made against the documentation of several export formats. However, in §13 of the Org manual, in the paragraph before the Menu, there is an explanation of how to load an export dispatcher: see (info "(Org) Exporting") But see my comment below, too. > The first time I have used the beamer export, I have read its > documentation section by section. And tried what I have read, gradually. > At this moment, I did not understand why I did not have the export > commands in the export dispatcher. > > I imagine that someone, who only read the parts of the manual that he or > she need, will also have the same misunderstanding problem. > > I think that a short paragraph about the need to enable > "org-beamer-mode" to access some action/features could be welcome in > related section. Like, for example, in section "13.8.1 Beamer export > commands". > > > If I can help on something, do not hesitate to ask. > > It is funny how different people use the manual. IIRC, I started wtih the example at the end of the section. I don't recall why (likely a good guess), but I added the single header #+STARTUP: beamer from §13.8.5 in order to play with editing. When I tried exporting, I had no difficulties because that had enabled beamer export. My only suggestion would be to modify the example to include the startup line above (patch attached). I went on to use the worg examples as prototypes. Leo
From 01302b6a166df6b0495ac8279b3a3857ea152c04 Mon Sep 17 00:00:00 2001 From: Leo Butler <leo.but...@umanitoba.ca> Date: Thu, 13 Feb 2025 10:09:15 -0600 Subject: [PATCH] doc/org-manual.org: add STARTUP to Beamer example To work out of the box, the given example needs to load `ox-beamer'. Ref: https://list.orgmode.org/87tt8yvp2a....@icloud.com/ --- doc/org-manual.org | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/org-manual.org b/doc/org-manual.org index 65a1185d1..109321d95 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -13288,6 +13288,7 @@ Here is an example of an Org document ready for Beamer export. ,#+AUTHOR: Carsten Dominik ,#+OPTIONS: H:2 toc:t num:t ,#+LATEX_CLASS: beamer +,#+STARTUP: beamer ,#+LATEX_CLASS_OPTIONS: [presentation] ,#+BEAMER_THEME: Madrid ,#+COLUMNS: %45ITEM %10BEAMER_ENV(Env) %10BEAMER_ACT(Act) %4BEAMER_COL(Col) -- 2.47.2
