Skip to content

Commit

Permalink
4.1.1 numbersFontSize and footerFontSize
Browse files Browse the repository at this point in the history
  • Loading branch information
MartinPacker committed Jul 10, 2023
1 parent 2811c95 commit 15b6dba
Show file tree
Hide file tree
Showing 5 changed files with 85 additions and 19 deletions.
4 changes: 2 additions & 2 deletions md2pptx
Expand Up @@ -79,8 +79,8 @@ except:
have_graphviz = False


md2pptx_level = "4.1+"
md2pptx_date = "9 July, 2023"
md2pptx_level = "4.1.1"
md2pptx_date = "10 July, 2023"

namespaceURL = {
"mc": "http://schemas.openxmlformats.org/markup-compatibility/2006",
Expand Down
30 changes: 25 additions & 5 deletions user-guide.html
Expand Up @@ -1247,13 +1247,15 @@ <h3 id="table-of-contents">Table Of Contents<a class="headerlink" href="#table-o
<li><a href="#funnel-orientation-funnelwidest">Funnel Orientation - <code>funnelWidest</code></a></li>
</ul>
</li>
<li><a href="#footer-metadata">Footer Metadata</a><ul>
<li><a href="#footer-and-slide-number-metadata">Footer And Slide Number Metadata</a><ul>
<li><a href="#slide-numbers-numbers">Slide Numbers - <code>numbers</code></a></li>
<li><a href="#specifying-slide-number-font-size-with-numbersfontsize">Specifying Slide Number Font Size With <code>numbersFontSize</code></a></li>
<li><a href="#specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight">Specifying How Much Space To Reserve For Slide Numbers With <code>NumbersHeight</code></a></li>
<li><a href="#specifying-footer-text">Specifying Footer Text</a><ul>
<li><a href="#footer-flexibility">Footer Flexibility</a></li>
</ul>
</li>
<li><a href="#specifying-footer-font-size-with-footerfontsize">Specifying Footer Font Size With <code>footerFontSize</code></a></li>
</ul>
</li>
<li><a href="#slide-heading-levels-topheadinglevel">Slide Heading Levels - <code>TopHeadingLevel</code></a></li>
Expand Down Expand Up @@ -1462,6 +1464,11 @@ <h2 id="change-log">Change Log<a class="headerlink" href="#change-log" title="Pe
</thead>
<tbody>
<tr>
<td align="left">4.1.1</td>
<td align="right">10&nbsp;July&nbsp;2023</td>
<td align="left">Added Added <a href="#specifying-slide-number-font-size-with-numbersfontsize"><code>numbersFontSize</code></a> and <a href="#specifying-footer-font-size-with-footerfontsize"><code>footerFontSize</code></a>.</td>
</tr>
<tr>
<td align="left">4.1</td>
<td align="right">28&nbsp;April&nbsp;2023</td>
<td align="left">Added <a href="#funnel-labels-position-funnellabelsposition"><code>funnelLabelsPosition</code></a> and <a href="#funnel-orientation-funnelwidest"><code>funnelWidest</code></a>. Added <a href="#card-title-background-colours-cardtitlebackground"><code>cardTitleBackground</code></a>. Added quotation mark related <a href="#html-entity-references">HTML entity references</a>.</td>
Expand Down Expand Up @@ -3563,22 +3570,29 @@ <h5 id="funnel-orientation-funnelwidest">Funnel Orientation - <code>funnelWidest
<li><code>vpipe</code> - short for &ldquo;vertical pipe&rdquo; - where the stages have constant width</li>
</ul>
<p>You can do this dynamically (on a slide-by-slide basis) with <a href="#funnelwidest-dynamic"><code>funnelWidest</code></a>.</p>
<h4 id="footer-metadata">Footer Metadata<a class="headerlink" href="#footer-metadata" title="Permanent link"></a></h4>
<p><a id="footer-metadata"></a></p>
<h4 id="footer-and-slide-number-metadata">Footer And Slide Number Metadata<a class="headerlink" href="#footer-and-slide-number-metadata" title="Permanent link"></a></h4>
<p><a id="footer-and-slide-number-metadata"></a></p>
<p>You can specify a number of things about the bottom of each slide:</p>
<ul>
<li>You can specify whether slide numbers are to be generated by md2pptx - with <a href="#slide-numbers-numbers"><code>numbers</code></a>.</li>
<li>You can specify how much space to reserve at the bottom of the slide for things like slide numbers - with <a href="#specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight"><code>NumbersHeight</code></a>.</li>
<li>You can add &ldquo;pseudo-footer&rdquo; information in three places at the bottom of the slide. These are not genuine footer elements but are more flexible. See <a href="#specifying-footer-text">Specifying Footer Text</a>.</li>
<li>You can specify the font sizes for slide numbers and footers - with <a href="#specifying-slide-number-font-size-with-numbersfontsize">numbersFontSize</a> and <a href="#specifying-footer-font-size-with-footerfontsize">footerFontSize</a>, respectively.</li>
</ul>
<p><strong>Note:</strong> This user guide will use the term &ldquo;footer&rdquo; rather than &ldquo;pseudo-footer&rdquo;.</p>
<p><strong>Note:</strong> This user guide will use the term &ldquo;footer&rdquo; rather than &ldquo;pseudo footer&rdquo;, and &ldquo;slide number&rdquo; instead of &ldquo;pseudo slide number&rdquo;.</p>
<h5 id="slide-numbers-numbers">Slide Numbers - <code>numbers</code><a class="headerlink" href="#slide-numbers-numbers" title="Permanent link"></a></h5>
<p><a id="slide-numbers-numbers"></a></p>
<p>md2pptx can add slide numbers. These are generated by md2pptx itself (or hardcoded) and are not the same as ones you can turn on in a footer.</p>
<p>The default value is <code>no</code>. You can turn them on for all slides with <code>yes</code> or non-title slides with <code>content</code>.</p>
<p>Example:</p>
<pre><code>numbers: yes
</code></pre>
<h5 id="specifying-slide-number-font-size-with-numbersfontsize">Specifying Slide Number Font Size With <code>numbersFontSize</code><a class="headerlink" href="#specifying-slide-number-font-size-with-numbersfontsize" title="Permanent link"></a></h5>
<p><a id='specifying-slide-number-font-size-with-numbersfontsize'></a></p>
<p>You can specify the size of the slide number font with <code>numbersFontSize</code>. For example</p>
<pre><code>numbersFontSize: 16.5
</code></pre>
<p>will cause slide numbers to be displayed with a 16.5 point font. The default value is 12 points.</p>
<h5 id="specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight">Specifying How Much Space To Reserve For Slide Numbers With <code>NumbersHeight</code><a class="headerlink" href="#specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight" title="Permanent link"></a></h5>
<p><a id="specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight"></a></p>
<p>You can override the default space left at the bottom of the slides - for slide numbers or maybe a custom footer:</p>
Expand Down Expand Up @@ -3627,11 +3641,17 @@ <h6 id="footer-flexibility">Footer Flexibility<a class="headerlink" href="#foote
<p>will place the first line of the presentation title and the first line of the presentation subtitle in the right footer - on two lines.</p>
<p><strong>Notes</strong></p>
<ol>
<li>Lines are separated by<code>&lt;br/&gt;</code>).</li>
<li>Lines are separated by<code>&lt;br/&gt;</code>.</li>
<li>For slides before the first Section Slide the title will be empty.</li>
<li>There will be no symbol substitution - beyond what was in the section title.</li>
<li>The case of the terms must be as shown. For example, <code>&lt;presTitle1&gt;</code> must be coded exactly as shown.</li>
</ol>
<h5 id="specifying-footer-font-size-with-footerfontsize">Specifying Footer Font Size With <code>footerFontSize</code><a class="headerlink" href="#specifying-footer-font-size-with-footerfontsize" title="Permanent link"></a></h5>
<p><a id='specifying-footer-font-size-with-footerfontsize'></a></p>
<p>You can specify the size of the footer text font with <code>footerFontSize</code>. For example</p>
<pre><code>footerFontSize: 14.0
</code></pre>
<p>will cause footers to be displayed with a 14 point font. The default value is 8 points.</p>
<p><a id="slide-heading-levels-topheadinglevel"></a></p>
<h4 id="slide-heading-levels-topheadinglevel">Slide Heading Levels - <code>TopHeadingLevel</code><a class="headerlink" href="#slide-heading-levels-topheadinglevel" title="Permanent link"></a></h4>
<p>The usual heading levels for different types of slides are as follows:</p>
Expand Down
8 changes: 5 additions & 3 deletions user-guide.log
Expand Up @@ -5,8 +5,8 @@ mdpre Markdown Preprocessor v0.6.5 (17 February, 2023)
Def mdpre_date = 17 February, 2023
Def mdpre_level = 0.6.5
Def userid = martinpacker
Def time = 10&colon;19
Def date = 28 April&comma; 2023
Def time = 20&colon;05
Def date = 10 July&comma; 2023
Def TOC = Table Of Contents
Def md = Markdown
Def pp = Powerpoint
Expand Down Expand Up @@ -149,11 +149,13 @@ CSV Stop
..... ..... ..... ..... Funnel Labels Space - `funnelLabelsPercent`
..... ..... ..... ..... Funnel Labels Position - `funnelLabelsPosition`
..... ..... ..... ..... Funnel Orientation - `funnelWidest`
..... ..... ..... Footer Metadata
..... ..... ..... Footer And Slide Number Metadata
..... ..... ..... ..... Slide Numbers - `numbers`
..... ..... ..... ..... Specifying Slide Number Font Size With `numbersFontSize`
..... ..... ..... ..... Specifying How Much Space To Reserve For Slide Numbers With `NumbersHeight`
..... ..... ..... ..... Specifying Footer Text
..... ..... ..... ..... ..... Footer Flexibility
..... ..... ..... ..... Specifying Footer Font Size With `footerFontSize`
..... ..... ..... Slide Heading Levels - `TopHeadingLevel`
Column Alignment - spec 'r l'
CSV Start
Expand Down
32 changes: 27 additions & 5 deletions user-guide.md
Expand Up @@ -137,11 +137,13 @@ As you can see in the [change log](#change-log), md2pptx is frequently updated -
* [Funnel Labels Space - `funnelLabelsPercent`](#funnel-labels-space-funnellabelspercent)
* [Funnel Labels Position - `funnelLabelsPosition`](#funnel-labels-position-funnellabelsposition)
* [Funnel Orientation - `funnelWidest`](#funnel-orientation-funnelwidest)
* [Footer Metadata](#footer-metadata)
* [Footer And Slide Number Metadata](#footer-and-slide-number-metadata)
* [Slide Numbers - `numbers`](#slide-numbers-numbers)
* [Specifying Slide Number Font Size With `numbersFontSize`](#specifying-slide-number-font-size-with-numbersfontsize)
* [Specifying How Much Space To Reserve For Slide Numbers With `NumbersHeight`](#specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight)
* [Specifying Footer Text](#specifying-footer-text)
* [Footer Flexibility](#footer-flexibility)
* [Specifying Footer Font Size With `footerFontSize`](#specifying-footer-font-size-with-footerfontsize)
* [Slide Heading Levels - `TopHeadingLevel`](#slide-heading-levels-topheadinglevel)
* [Slides With Multiple Content Blocks](#slides-with-multiple-content-blocks)
* [Horizontal Or Vertical Split - `ContentSplitDirection`](#horizontal-or-vertical-split-contentsplitdirection)
Expand Down Expand Up @@ -339,6 +341,7 @@ To quote from the python-pptx license statement:

|Level|Date|What|
|:-|-:|:-|
|4.1.1|10&nbsp;July&nbsp;2023|Added Added [`numbersFontSize`](#specifying-slide-number-font-size-with-numbersfontsize) and [`footerFontSize`](#specifying-footer-font-size-with-footerfontsize).|
|4.1|28&nbsp;April&nbsp;2023|Added [`funnelLabelsPosition`](#funnel-labels-position-funnellabelsposition) and [`funnelWidest`](#funnel-orientation-funnelwidest). Added [`cardTitleBackground`](#card-title-background-colours-cardtitlebackground). Added quotation mark related [HTML entity references](#html-entity-references).|
|4.0|7&nbsp;April&nbsp;2023|Added [Funnel](#funnels) support. [`CardColour`](#card-background-colour-cardcolour) can now be pluralised: `CardColors` or `CardColours`.|
|3.7|26&nbsp;March&nbsp;2023|Added [`cardDividerColour`](#card-divider-colour-carddividercolour). Most colours now RGB or Theme Colour (documented in [Specifying Colours](#specifying-colours)).|
Expand Down Expand Up @@ -2477,16 +2480,17 @@ The supported values are:
You can do this dynamically (on a slide-by-slide basis) with [`funnelWidest`](#funnelwidest-dynamic).


#### Footer Metadata
<a id="footer-metadata"></a>
#### Footer And Slide Number Metadata
<a id="footer-and-slide-number-metadata"></a>

You can specify a number of things about the bottom of each slide:

* You can specify whether slide numbers are to be generated by md2pptx - with [`numbers`](#slide-numbers-numbers).
* You can specify how much space to reserve at the bottom of the slide for things like slide numbers - with [`NumbersHeight`](#specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight).
* You can add "pseudo-footer" information in three places at the bottom of the slide. These are not genuine footer elements but are more flexible. See [Specifying Footer Text](#specifying-footer-text).
* You can specify the font sizes for slide numbers and footers - with [numbersFontSize](#specifying-slide-number-font-size-with-numbersfontsize) and [footerFontSize](#specifying-footer-font-size-with-footerfontsize), respectively.

**Note:** This user guide will use the term "footer" rather than "pseudo-footer".
**Note:** This user guide will use the term "footer" rather than "pseudo footer", and "slide number" instead of "pseudo slide number".

##### Slide Numbers - `numbers`
<a id="slide-numbers-numbers"></a>
Expand All @@ -2499,6 +2503,14 @@ Example:

numbers: yes

##### Specifying Slide Number Font Size With `numbersFontSize`
<a id='specifying-slide-number-font-size-with-numbersfontsize'></a>

You can specify the size of the slide number font with `numbersFontSize`. For example

numbersFontSize: 16.5

will cause slide numbers to be displayed with a 16.5 point font. The default value is 12 points.

##### Specifying How Much Space To Reserve For Slide Numbers With `NumbersHeight`
<a id="specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight"></a>
Expand Down Expand Up @@ -2564,11 +2576,21 @@ will place the first line of the presentation title and the first line of the pr

**Notes**

1. Lines are separated by`<br/>`).
1. Lines are separated by`<br/>`.
1. For slides before the first Section Slide the title will be empty.
1. There will be no symbol substitution - beyond what was in the section title.
1. The case of the terms must be as shown. For example, `<presTitle1>` must be coded exactly as shown.

##### Specifying Footer Font Size With `footerFontSize`
<a id='specifying-footer-font-size-with-footerfontsize'></a>

You can specify the size of the footer text font with `footerFontSize`. For example

footerFontSize: 14.0

will cause footers to be displayed with a 14 point font. The default value is 8 points.


<a id="slide-heading-levels-topheadinglevel"></a>
#### Slide Heading Levels - `TopHeadingLevel`

Expand Down
30 changes: 26 additions & 4 deletions user-guide.mdp
Expand Up @@ -154,6 +154,7 @@ To quote from the python-pptx license statement:
=colalign l r l
=csv
Level,Date,What
4.1.1,10&nbsp;July&nbsp;2023,Added Added [`numbersFontSize`](#specifying-slide-number-font-size-with-numbersfontsize) and [`footerFontSize`](#specifying-footer-font-size-with-footerfontsize).
4.1,28&nbsp;April&nbsp;2023,Added [`funnelLabelsPosition`](#funnel-labels-position-funnellabelsposition) and [`funnelWidest`](#funnel-orientation-funnelwidest). Added [`cardTitleBackground`](#card-title-background-colours-cardtitlebackground). Added quotation mark related [HTML entity references](#html-entity-references).
4.0,7&nbsp;April&nbsp;2023,Added [Funnel](#funnels) support. [`CardColour`](#card-background-colour-cardcolour) can now be pluralised: `CardColors` or `CardColours`.
3.7,26&nbsp;March&nbsp;2023,Added [`cardDividerColour`](#card-divider-colour-carddividercolour). Most colours now RGB or Theme Colour (documented in [Specifying Colours](#specifying-colours)).
Expand Down Expand Up @@ -2530,17 +2531,18 @@ The supported values are:
You can do this dynamically (on a slide-by-slide basis) with [`funnelWidest`](#funnelwidest-dynamic).


#### Footer Metadata
<a id="footer-metadata"></a>
#### Footer And Slide Number Metadata
<a id="footer-and-slide-number-metadata"></a>

You can specify a number of things about the bottom of each slide:

* You can specify whether slide numbers are to be generated by md2pptx - with [`numbers`](#slide-numbers-numbers).
* You can specify how much space to reserve at the bottom of the slide for things like slide numbers - with [`NumbersHeight`](#specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight).
* You can add "pseudo-footer" information in three places at the bottom of the slide. These are not genuine footer elements but are more flexible. See [Specifying Footer Text](#specifying-footer-text).
* You can specify the font sizes for slide numbers and footers - with [numbersFontSize](#specifying-slide-number-font-size-with-numbersfontsize) and [footerFontSize](#specifying-footer-font-size-with-footerfontsize), respectively.

**Note:** \
This user guide will use the term "footer" rather than "pseudo-footer".
This user guide will use the term "footer" rather than "pseudo footer", and "slide number" instead of "pseudo slide number".

##### Slide Numbers - `numbers`
<a id="slide-numbers-numbers"></a>
Expand All @@ -2555,6 +2557,15 @@ Example:

numbers: yes

##### Specifying Slide Number Font Size With `numbersFontSize`
<a id='specifying-slide-number-font-size-with-numbersfontsize'></a>

You can specify the size of the slide number font with `numbersFontSize`. For example

numbersFontSize: 16.5

will cause slide numbers to be displayed with a 16.5 point font. \
The default value is 12 points.

##### Specifying How Much Space To Reserve For Slide Numbers With `NumbersHeight`
<a id="specifying-how-much-space-to-reserve-for-slide-numbers-with-numbersheight"></a>
Expand Down Expand Up @@ -2625,11 +2636,22 @@ will place the first line of the presentation title and the first line of the pr

**Notes**

1. Lines are separated by`<br/>`).
1. Lines are separated by`<br/>`.
1. For slides before the first Section Slide the title will be empty.
1. There will be no symbol substitution - beyond what was in the section title.
1. The case of the terms must be as shown. For example, `<presTitle1>` must be coded exactly as shown.

##### Specifying Footer Font Size With `footerFontSize`
<a id='specifying-footer-font-size-with-footerfontsize'></a>

You can specify the size of the footer text font with `footerFontSize`. For example

footerFontSize: 14.0

will cause footers to be displayed with a 14 point font. \
The default value is 8 points.


<a id="slide-heading-levels-topheadinglevel"></a>
#### Slide Heading Levels - `TopHeadingLevel`

Expand Down

0 comments on commit 15b6dba

Please sign in to comment.