Merge pull request '[I55] announcements template' (#56) from I55_announcements-template into main

Reviewed-on: rho_n/hpr_generator#56

site.cfg

@@ -138,6 +138,10 @@ content: content-twat_episode.tpl.html
 multipage: true
 filename: eps/twat[id]/index.html
 
+[mumble-howto]
+navigation: navigation-about.tpl.html
+content: content-mumble-howto.tpl.html
+
 [hpr_ogg]
 root_template: rss.tpl.xml
 content: rss-hpr.tpl.xml

templates/content-index-announcement.tpl.html

@@ -0,0 +1,77 @@
+<!--% PROCESS 'shared-utils.tpl.html' %-->
+<hr>
+<h2><u>The Eleventh Annual 26 Hour New Years Eve Show</u></h2>
+<!--
+
+<p>
+<img src="livestream.png" /><br />
+<audio controls autoplay>
+    <source src="http://shownotes.ooguy.com:8000/stream" type="audio/mpeg" >
+</audio> <br />
+<a href="http://shownotes.ooguy.com:8000/stream">http://shownotes.ooguy.com:8000/stream.m3u</a><br />
+<a href="https://hackerpublicradio.org/live">https://hackerpublicradio.org/live</a><br />
+</p>
+-->
+<h3>Welcome every <a href="https://www.timeanddate.com/counters/multicountdown.html">TimeZone</a>!</h3>
+
+<p><em>If you keep talking, we'll keep recording.</em> </p>
+
+
+<p>For those who don't know, on New Years Eve 2022-12-31 10:00 UTC (5:00 AM EST), we will have a recording going on the HPR Mumble server for anyone to come on and say "Happy New Years" and talk about whatever they want. We will leave the recording going until at least 2023-01-01 12:00 UTC (7:00 AM EST), and keep recording until the conversation stops.<br>
+So please stop in. Say "Hi" and maybe join in the conversation with other HPR listeners and contributors. It's always a good time!!</p>
+
+<h3>Join the conversation on Mumble</h3>
+
+
+<p>Already have Mumble installed, then <a href="mumble://chatter.skyehaven.net:64738/Hacker%20Public%20Radio?version=1.2.0">this link will bring you to the HPR Room</a></p>
+
+<p>Get the PC Client <a href="https://wiki.mumble.info/wiki/Main_Page">https://wiki.mumble.info/wiki/Main_Page</a><br>
+Get the Android Client Mumla <a href="https://f-droid.org/packages/se.lublin.mumla">https://f-droid.org/packages/se.lublin.mumla</a><br>
+
+<p>Then join the Server: <strong>chatter.skyehaven.net</strong><br>
+Port: <strong>64738</strong><br>
+Channel: <strong>HPR</strong></p>
+
+<p>For those who have never used Mumble before, see this <a href="<!--% absolute_path(baseurl) %-->mumble-howto.html">how-to explaining the setup of the desktop Mumble client</a>, or listen to <a href="<!--% absolute_path(baseurl) %-->eps/hpr3503/index.html">hpr3503 :: Configuring Mumble</a>.</p>
+
+<!--<h3>Add to the Show-notes</h3>
+
+<p>
+<strong>Please help fill out the show notes</strong><br />
+<a href="http://shownotes.ooguy.com:9001/p/HPR-NYE-2022">http://shownotes.ooguy.com:9001/p/HPR-NYE-2022</a><br />
+We are using Etherpad for people to share links and info to things they are discussing. The Etherpad will be used for the HPR audio shownotes so please feel free to add to it. The entire event will be broken into 2 to 3 hour segments and made available as HPR episodes.<br/>
+<em>This really, really helps us out to post the show faster !</em>
+</p>
+
+<h3>Record to the Show</h3>
+
+<p>
+We're going to release the show as a podcast, so it would be great if you could grab a copy as a backup.
+
+<pre>
+while true;do timestamp="$HOSTNAME-$(\date -u +%Y-%m-%d_%H-%M-%SZ_%A)"; echo "Recording ${timestamp}";cvlc "http://shownotes.ooguy.com:8000/stream.m3u" --sout "file/mp3:${timestamp}.mp3" --run-time="3600" vlc://quit;done
+</pre>
+</p>-->
+
+<!--
+while true;do ffmpeg -i https://hackerpublicradio.org/live -c copy hprnye-$( \date -u +%s )-$( \date -u +%Y%m%dT%H%M%SZ )-${HOSTNAME}.mp3; done
+
+<p>
+The show will be held on the <a href="mumble://chatter.skyehaven.net:64738/Hacker%20Public%20Radio?version=1.2.0">HPR Room on Mumble</a>, so now you can prepare by installing the <a href="https://wiki.mumble.info/wiki/Main_Page">mumble PC Client</a>, or the <a href="https://f-droid.org/packages/se.lublin.mumla">mumla Android Client</a>. The Server we will use is: <strong>chatter.skyehaven.net</strong>, Port: <strong>64738</strong>, Channel: <strong>HPR</strong>
+</p>
+-->
+
+<h3>Spread the Word</h3>
+
+<p>If you are a podcaster please spread the word by including either the <a href="https://hackerpublicradio.org/promote/new-year-show-promo.ogg">ogg</a>, <a href="https://hackerpublicradio.org/promote/new-year-show-promo.mp3">mp3</a>, or <a href="https://hackerpublicradio.org/promote/new-year-show-promo.wav">wav</a> in your show ! <br>
+<audio controls preload="none">";
+    <source src="https://hackerpublicradio.org/promote/new-year-show-promo.ogg" type="audio/ogg" >
+    <source src="https://hackerpublicradio.org/promote/new-year-show-promo.mp3" type="audio/mpeg" >
+</audio></p>
+
+<!--
+<p>
+If you prefer to just listen to the show and not participate using Mumble, use the link below for the live audio stream using your web browser or favorite audio application such as VLC, or live in your web browser.<br/>
+</p>
+It's that time of year again. Time for the 24 hr (26 hr) New Years Eve Show. 
+-->

templates/content-index.tpl.html

@@ -1,6 +1,7 @@
 <!--% PROCESS 'shared-avatar.tpl.html' %-->
 <!--% PROCESS 'shared-utils.tpl.html' %-->
 <!--% PROCESS 'shared-listen-now.tpl.html' %-->
+<!--% INCLUDE 'content-index-announcement.tpl.html' %-->
 <hr>
   <article>
     <header>

templates/content-mumble-howto.tpl.html

@@ -0,0 +1,189 @@
+<!--% PROCESS 'shared-utils.tpl.html' %-->
+<p>In this article we will show you how to connect to the HPR Community Room on Mumble.</p>
+
+<p>You can think of Mumble like visiting a hotel that has different meeting rooms. Some are locked to you, some only allow you access if you are registered, some you can join but only listen to. In most, like the HPR room, you can hear the other people in the room talking. If you talk they can also hear you. There is a chat section where text can be shared as well.</p>
+
+<p>When using Mumble <strong><em>you should always use a microphone and headset</em></strong> positioned close to your mouth but slightly off to the side.</p>
+<h2>Install the software</h2>
+
+<p>The <a href="https://www.mumble.info/downloads/">Mumble website offers download and install instructions</a> for different operating systems.
+</p> 
+
+<p>Once you have installed the client then connect to the <a href="mumble://chatter.skyehaven.net:64738/Hacker%20Public%20Radio?version=1.2.0">HPR Room on Mumble</a>.
+
+<p>There is a first run wizard that will step you through the process of configuring Mumble the first time. This will open up a series of configuration options.</p>
+
+<p>Press <strong>Next</strong> on the introduction.</p>
+
+<p><img alt="intro screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/01-intro.png" ></p>
+
+<p>The device selection page will allow you to select which audio to use. As this will be different for everyone we can't offer you much help here other than to say that the defaults are usually fine.</p>
+
+<p>When you are done press <strong>Next</strong>.</p>
+
+<p><img alt="device selection screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/02-device-selection.png" ></p>
+
+<p>The device tuning page will allow you to fine tune the latency. Normally the defaults are usually fine.</p>
+
+<p>When you are done press <strong>Next</strong>.</p>
+
+<p><img alt="device tuning screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/03-device-tuning.png" ></p>
+
+<p>The Volume Tuning page will allow you to set your audio levels. Normally the defaults are usually fine.</p>
+
+<p>Then press <strong>Next</strong>.</p>
+
+<p><img alt="volume tuning screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/04-volume.png" ></p>
+
+<p>It is <strong>very important</strong> that you set <strong>Push to Talk (PTT)</strong>, as you will disturb the other people in the room if you select the other methods. It may seem to be working fine to you, but it <em>will</em> result in issues for the others.
+</p> 
+<ul>
+	<li>Click "Push to Talk:"</li>
+	<li>Click in the area next to it and press the key you intend to use as the Push To Talk (PTT) Key</li>
+</ul>
+
+<p>Try and pick a key that you don't normally use or need. You may have to disable that key mapping in the operating system you are using.</p>
+
+<p>Then press <strong>Next</strong>.</p>
+
+<p><img alt="ptt screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/05-ptt.png" ></p>
+
+<p>The Quality Settings page will allow you to adjust the bandwidth. Normally the defaults are usually fine.</p>
+
+<p>It is <strong>very important</strong> that you <strong>Disable Text-To-Speech</strong>, as all notifications will be read back and will disturb the other people in the room. It may seem to be working fine to you, but it <em>will</em> result in issues for the others.</p>
+<ul>
+<li>Click "Disable Text-To-Speech and use sounds instead"</li>
+</ul>
+
+<p>Then press <strong>Next</strong>.</p>
+
+<p><img alt="no tts screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/06-notts.png" ></p>
+
+<p>The positional audio page will allow you to fine tune the latency. Normally the defaults are usually fine.</p>
+
+<p>Just press <strong>Next</strong>.</p>
+
+<p><img alt="positional audio screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/07-positional-audio.png" ></p>
+
+<p>That's it the initial configuration is done.</p>
+
+<p>Then press <strong>Finish</strong>.</p>
+
+<p><img alt="stats screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/08-stats.png" ></p>
+
+<p>You are expected to have a digital certificate when connecting to Mumble servers.</p>
+
+<p>This screen will allow you to Automatically create one.</p>
+
+<p>Just press <strong>Next</strong>.</p>
+
+<p><img alt="cert screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/09-cert.png" ></p>
+
+<p>That completes the first setup of Mumble.</p>
+
+<p>Then press <strong>Finish</strong>.</p>
+
+<p><img alt="finished screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/10-finished.png" ></p>
+<hr>
+
+<p>Now that you have the Mumble client set up we can now start the process of connecting to the <a href="mumble://chatter.skyehaven.net:64738/Hacker%20Public%20Radio?version=1.2.0">HPR Room on Mumble</a>.</p>
+
+<p>If you opened Mumble by clicking the link above, then you may not see the following options, but we'll cover them here if at any time you need to add the HPR server again</p>
+
+<p>Just open mumble and press <strong>Server - Connect</strong></p>
+
+<p>Then press <strong>Add New...</strong>.</p>
+
+<p><img alt="add new connection screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/20-add-new.png" ></p>
+
+<p>You will need to enter the information for the HPR server:</p>
+<ul>
+<li>Address: <strong>chatter.skyehaven.net</strong></li>
+<li>Port: 64738</li>
+<li>Username: <strong><em>Your Username</em></strong></li>
+<li>Label: chatter.skyehaven.net</li>
+</ul>
+
+<p>Think about your username a bit as if you register it on the server you will not be able to change it again.</p>
+
+<p>Then press <strong>Next</strong>.</p>
+
+<p><img alt="add new server screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/21-add-server.png" ></p>
+
+<p>If you clicked the link to the <a href="mumble://chatter.skyehaven.net:64738/Hacker%20Public%20Radio?version=1.2.0">HPR Room on Mumble</a>, then you may be brought to the option to enter a username. Think about this a bit as if you register it on the server you will not be able to change it again.</p>
+
+<p>Then press <strong>Next</strong>.</p>
+
+<p><img alt="username screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/11-username.png" ></p>
+
+<p>You will need to confirm the servers Certificate matches this:</p>
+
+<p>
+<pre>Digest (SHA-1): 09:22:05:88:D6:60:17:FD:39:8F:55:B0:F5:A0:45:DA:96:32:9C:23</pre>
+</p>
+
+<p>If it matches then press <strong>Yes</strong>.</p>
+
+<p><img alt="accept cert screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/12-accept-cert.png" ></p>
+
+<p>All going well you will be connected to the server. By default you will end up in the <strong>Root</strong> - think the lobby of an hotel !</p>
+
+<p>You will see a lot of rooms with names of other podcasts that use the server.</p>
+
+<p>Before connecting to any room it's good etiquette to make sure your audio is working correctly.</p>
+
+<p>The room <strong>Audio Test</strong> will allow you to speak and the <strong>OpieTheRepeatherBot</strong> will record your speech and after 10 seconds will play it back for you.</p>
+
+<p><em>Click and hold</em> on your username (<em>ken1</em> in this example) and <em>drag</em> yourself into the <strong>Audio Test</strong> room.</p>
+
+<p><img alt="audio test screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/13-audio-test.png" ></p>
+
+<p>You now know how to switch from room to room.</p>
+
+<p>Try to say something. Remember to press the <strong>Push to talk (PTT)</strong>. Everyone forgets to do this but it will become second nature after a while.</p>
+
+<p>A good test is to count to ten slowly.</p>
+
+<p>When you are talking the server should change your icon from a green person to a <em>blue</em> one with <em>sound circles</em> around the head.</p>
+
+<p><img alt="audio ping screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/14-audio-ping.png" ></p>
+
+<p>The <strong>OpieTheRepeatherBot</strong> will create another client with the prefix <strong>Mimic-</strong> followed by your username.</p>
+
+<p>In this example it is <em>Mimic-ken1</em>.</p>
+
+<p>You should hear your audio back.</p>
+
+<p><img alt="audio pong screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/15-audio-pong.png" ></p>
+
+<p>If your audio is poor - as is often the case - then this gives you the opportunity to fix it before interrupting other people.</p>
+
+<p>How you fix it will depend on the operating system that you are using and the exact nature of the problem.</p>
+
+<p>A common problem is that the operating system uses the built in speaker and microphone from the laptop instead of your headset. A tip would be to press the <strong>Push to talk (PTT)</strong> button and tap the microphone of your head set lightly. If you don't hear the tapping then Mumble is probably getting the wrong microphone as input.</p>
+
+<p>In the example below I clicked the Microphone icon in my taskbar and a application (<em>pavucontrol</em>) opened allowing me to set the correct microphone.</p>
+
+<p><img alt="hpr room screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/22-pavucontrol-recording.png" ></p>
+
+<p>While I was there I also checked to make sure that Mumble was playing audio to my headset.</p>
+
+<p><img alt="hpr room screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/23-pavucontrol-playback.png" ></p>
+
+<p>Satisfied that the audio is good, you can <em>click and drag</em> your icon to the <strong>HPR</strong> room.</p>
+
+<p><img alt="hpr room screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/16-hpr-room.png" ></p>
+
+<p>Some rooms require you to be registered to enter a room, to speak, to record, or to chat in the room.</p>
+
+<p>To register first <em>Right Click</em> on your icon and a menu will open.</p>
+
+<p>Press <strong>Register....</strong></p>
+
+<p><img alt="register screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/17-register.png" ></p>
+
+<p>Then press <strong>Yes</strong></p>
+
+<p><img alt="register confirm screenshot" src="<!--% absolute_path(baseurl) %-->images/mumble-howto/18-register-confirm.png" ></p>
+
+<p>That's it - you are now all set to use mumble.</p>