Leo Butler <leo.but...@umanitoba.ca> writes: > 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.
Agreed -- we need more in the Org documents. >>> + Frames and Blocks are difficult concepts -- perhaps there should be a >>> link to examples in Worg to show the possibilities? > > I think the examples on worg do a good job showing how these things work. Didn't see that before (the intro page on Worg is getting long). Whoops, the link to the first tutorial for Beamer on Worg has a bad URL (looks like it was a "file:" link instead of an "http:" link). >>> + 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/ That would be good if it could be rewritten for Org & Beamer. >> 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") That's a good point, but it could mention "ox-*" are the backends. > But see my comment below, too. > > 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 That probably does a 'require on the export engine. > 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. Just need to get the tutorial link fixed in worg. -- David Masterson
