Org Beamer question

Org Beamer question

[David Masterson]

Given the following simple Org Beamer file, why is Conclusion turned
into a slide when I've set OPTIONS H:2 ??  If I remove the header line
Intro, the Introduction is also included as a slide (although without
the Introduction frame.  I had assumed that the option would set the
frame level at 2 and all headers at level 1 would be ignored (and, thus,
comments to explain the slides to me).

What am I misunderstanding?

====
#+author: David Masterson
#+date: \today
#+description: Items to consider on the home
#+subtitle: in Our Home
#+title: Home Management Ideas
#+OPTIONS: H:2 toc:t num:t
#+LATEX_CLASS: beamer
#+LATEX_CLASS_OPTIONS: [presentation]
#+LATEX_CLASS_OPTIONS: [bigger]
#+LATEX_CLASS_OPTIONS: [aspectratio=42]
#+BEAMER_THEME: Antibes
#+COLUMNS: %45ITEM %10BEAMER_env(Env) %10BEAMER_act(Act) %4BEAMER_col(Col) %8BEAMER_opt(Opt)
* Introduction
** Intro
Here I will create a slide show of plans to consider for the Masterson family.
* Living Room / Dining Room
** Furniture To Get Rid Of
A list of furniture items with pictures
| Item         | Item         | Item          |
|--------------+--------------+---------------|
| Beige Sofa   | Orange Chair | Orange Chair  |
| Coffee Table | Dining Table | Dining Chairs |
| Old Recliner | Floor Lamps  |               |
* Conclusion
This concludes the slide show for the Masterson family.
====

-- 
David Masterson

Re: Org Beamer question

[Fraga, Eric]

Response below/inline for email David Masterson wrote:
> (original email sent 19 Nov 2024 at 20:42)
> 
> I had assumed that the option would set the frame level at 2 and all
> headers at level 1 would be ignored (and, thus, comments to explain
> the slides to me).

They are not ignored: they define sections in the LaTeX.  If you want
the section ignored, add the :noexport: tag to the headline?

-- 
: Eric S Fraga, with org 9.7.15-a1df10 in Emacs 31.0.50

Re: Org Beamer question

[David Masterson]

"Fraga, Eric" <e.fraga@ucl.ac.uk> writes:

> Response below/inline for email David Masterson wrote:
>> (original email sent 19 Nov 2024 at 20:42)
>> 
>> I had assumed that the option would set the frame level at 2 and all
>> headers at level 1 would be ignored (and, thus, comments to explain
>> the slides to me).
>
> They are not ignored: they define sections in the LaTeX.  If you want
> the section ignored, add the :noexport: tag to the headline?

Ok.  So, what is the difference between a section and a frame as far as
Beamer is concerned?  In particular, in my example below, the generated
slides for the Intro* headers just look wrong. The Introduction is
mentioned in TOC, but it's combined with the Intro2 slide (which is also
level 1). Is there a bug here?

Also, isn't :noexport: inherited by children?

====
#+author: David Masterson
#+date: \today
#+description: Items to consider on the home
#+subtitle: in Our Home
#+title: Home Management Ideas
#+OPTIONS: H:2 toc:t num:t
#+LATEX_CLASS: beamer
#+LATEX_CLASS_OPTIONS: [presentation]
#+LATEX_CLASS_OPTIONS: [bigger]
#+LATEX_CLASS_OPTIONS: [aspectratio=42]
#+BEAMER_THEME: Antibes
#+COLUMNS: %45ITEM %10BEAMER_env(Env) %10BEAMER_act(Act) %4BEAMER_col(Col) %8BEAMER_opt(Opt)
* Introduction
test
* Intro2
test
** Intro
Here I will create a slide show of plans to consider for the Masterson family.
* Living Room / Dining Room
test
** Furniture To Get Rid Of
A list of furniture items with pictures
| Item         | Item         | Item          |
|--------------+--------------+---------------|
| Beige Sofa   | Orange Chair | Orange Chair  |
| Coffee Table | Dining Table | Dining Chairs |
| Old Recliner | Floor Lamps  |               |
* Conclusion
This concludes the slide show for the Masterson family.
====

-- 
David Masterson

Re: Org Beamer question

[Fraga, Eric]

Response below/inline for email David Masterson wrote:
> (original email sent 20 Nov 2024 at 14:32)
> 
> Ok.  So, what is the difference between a section and a frame as far as
> Beamer is concerned?  

Sections are semantic information that allow you to group frames.  Some
themes will show the section on each slide.  You are not meant to have
text outside frames, however.

So, for org, top level headlines (in your example) can be used to group
frames but you should ensure that all text appears below second level
headlines.

-- 
: Eric S Fraga, with org 9.7.15-a1df10 in Emacs 31.0.50

Re: Org Beamer question

[David Masterson]

"Fraga, Eric" <e.fraga@ucl.ac.uk> writes:

> Response below/inline for email David Masterson wrote:
>> (original email sent 20 Nov 2024 at 14:32)
> So, for org, top level headlines (in your example) can be used to group
> frames but you should ensure that all text appears below second level
> headlines.

Ok. Why is toc:t giving me only a top level TOC?  It would seem that the
level 1 headlines are only slightly useful in a Beamer TOC (as dividers
for the other headlines).  Also, is this restriction about limiting text
to level 2+ headlines mentioned in the Org manual.  I also think it
would be good for the Org manual to reference Beamer and Latex manuals
(via a link) to help people know where to dig for more information.

What do you think?

-- 
David Masterson

Re: Org Beamer question

[Fraga, Eric]

Response below/inline for email David Masterson wrote:
> (original email sent 21 Nov 2024 at 15:05)
> 
> Ok. Why is toc:t giving me only a top level TOC?  

I don't know.  Maybe try toc:2?  There's a whole section on TOC in the
org manual.

> It would seem that the level 1 headlines are only slightly useful in a
> Beamer TOC (as dividers for the other headlines).  

I find them very useufl for that purpose.  YMMV, of course! :-)

> Also, is this restriction about limiting text to level 2+ headlines
> mentioned in the Org manual.  I also think it would be good for the
> Org manual to reference Beamer and Latex manuals (via a link) to help
> people know where to dig for more information.

I'm sure that patches to the manual would be welcome.  Links to
supporting documentation would probably be good.

-- 
: Eric S Fraga, with org 9.7.15-a1df10 in Emacs 31.0.50

Re: Org Beamer question

[Ihor Radchenko]

David Masterson <dsmasterson@zohomail.com> writes:

> Ok. Why is toc:t giving me only a top level TOC?  It would seem that the
> level 1 headlines are only slightly useful in a Beamer TOC (as dividers
> for the other headlines).  Also, is this restriction about limiting text
> to level 2+ headlines mentioned in the Org manual.  I also think it
> would be good for the Org manual to reference Beamer and Latex manuals
> (via a link) to help people know where to dig for more information.
>
> What do you think?

May you please elaborate what exactly you want to change?

-- 
Ihor Radchenko // yantar92,
Org mode maintainer,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>