Merge pull request '[i335] docker image for site generator' (#336 ) from i335_docker-image-for-site-generator into main

Reviewed-on: #336 Reviewed-by: norrist <norrist@josh@dao-mail.com>
Merge branch 'main' into i335_docker-image-for-site-generator
2026-05-28 12:32:50 +00:00 · 2026-05-28 12:32:09 +00:00 · 2026-05-28 13:28:49 +02:00 · 2026-05-27 17:49:45 +02:00 · 2026-05-27 09:36:07 +02:00 · 2026-05-26 07:45:28 +02:00
26 changed files with 1609 additions and 1195 deletions
@@ -0,0 +1,24 @@
 FROM perl:stable
 RUN   cpanm Config::Std \
   && cpanm Template \
   && cpanm Template::Plugin::DBI \
   && cpanm Template::Plugin::HTML::Strip \
   && cpanm DBD::SQLite \
   && cpanm Tie::DBI \
   && cpanm Date::Calc \
   && cpanm Text::CSV_XS \
   && cpanm HTML::Entities \
   && mkdir -p /usr/src/app
 WORKDIR /usr/src/app
 ADD site-generator /usr/src/app/site-generator
 ADD site.cfg /usr/src/app/site.cfg
 ADD templates /usr/src/app/templates
 ADD LICENSE /usr/src/app/LICENSE
 # Tell Perl where to find the local modules
 ENV PERL5LIB=/usr/local/lib/perl5/site_perl
 ENTRYPOINT ["/usr/src/app/site-generator"]
@@ -11,7 +11,9 @@ password are required), run:
 On success, an "hpr_generator" directory will be created in the folder from 
 which the clone command was executed containing a local copy of the git repository.
-# Install required Perl modules
+# Building on local system
 ## Install required Perl modules
 Installing the Perl modules is the most finicky part of the installation process. 
 The needed Perl modules can be found using the operating system's package 
@@ -34,7 +36,7 @@ apt install libconfig-std-perl \
 ```
-## Using CPAN to install the modules
+### Using CPAN to install the modules
 A cross platform method to install the needed modules is the Perl CPAN application. 
 Make sure that the [gcc](https://www.gnu.org/software/gcc/), 
@@ -55,7 +57,7 @@ cpan Tie::DBI
 cpan Text:CSV_XS
 ```
-## Testing for Perl module dependencies
+### Testing for Perl module dependencies
 A bash script is included in the utils directory that will list the Perl modules used by the site-generator and report whether the modules are installed on the current OS.
@@ -65,6 +67,39 @@ It can be run from any directory. To run from the utils directory:
 ./check-dependencies.sh
 ```
 # Building with Docker
 The docker file will copy the local version of the site-generator program, the templates directory, the LICENSE file,
 and the site.cfg file into the Docker image. For the docker image to run correctly it needs access to your local 
 hpr.db file and the output directory (defaults to "public_html"). The default site.cfg assumes the hpr.db is located 
 in the directory from which the site-generator is run. There are two ways to make the db available to the container:
 * Put the hpr.db file in the public_html folder and modify the driver option under the [DBI] section of the site.cfg to:<br>
  ```driver: dbi:SQLite:public_html/hpr.db```
 * mount the hpr.db file into the container when starting up the container with the -v option: <br>
  ```-v <path to db directory>/hpr.db:/usr/src/app/hpr.db```
 Build the image by running the following command from the hpr_generator directory:
 ```docker build -t hpr/site-generator .```
 The first build will take a while. It must pull down the base container, perl-latest, and then pull down and build the 
 various Perl modules from CPAN. After the initial build, if you have modified your site.cfg file, templates dir, or the 
 site-generator program itself, builds will be very quick.
 If the build fails, it is often from a CPAN module failing to download and install. Try running the Docker build command again.
 ## Running the container
 When runing the Docker image, your local output directory (typically public_html) must be mounted into the container using 
 the -v option. If you are using the default path for the hpr.db, then the local hpr.db file must also be mounted into the image.
 The following is an example of running the site-generator with default locations from the hpr_generator directory:
 ```
 docker run \
 -v "$(pwd)/public_html":/usr/src/app/public_html \
 -v "$(pwd)/hpr.db":/usr/src/app/hpr.db \
 hpr/site-generator --help
 ```
 # Create the HPR database
 The hpr_generator relies on information from a database to generate many of the 
@@ -2,6 +2,9 @@
 Static web page generator for the Hacker Public Radio website.
 ## Installation
 ### On local system
 * Clone or download this repository
 * With SQLite
 	* Create the sqlite3 database from the hpr.sql MySQL dump file available on
@@ -31,6 +34,10 @@ Static web page generator for the Hacker Public Radio website.
    * Text::CSV_XS
    * HTML::Entities
 ### Using Docker
 * run: `docker build -t hpr/site-generator .`
 * See the [Getting Started](GETTING_STARTED.md) tutorial for more details on
  installing the HPR generator.
@@ -1,4 +1,4 @@
-#!/usr/bin/perl
+#!/usr/bin/env perl
 # {{{ POD documentation
@@ -26,6 +26,10 @@ media_baseurl: https://hub.hackerpublicradio.org/ccdn.php?filename=/eps/hpr$eps_
 generator_name: The HPR Robot
 generator_email: robot.nospam@nospam.hackerpublicradio.org
 # Is safe for work: 0 for true, 1 for false -- if true substitute 
 # variations of Hobby for Hacker
 is_sfw: 1
 # Configure the navigation menu and the content templates for each page 
 # of the site:
 #
@@ -55,6 +59,10 @@ content: content-index.tpl.html
 navigation: navigation-about.tpl.html
 content: content-about.tpl.html
 [contribute]
 navigation: content-contribute.tpl.html
 content: content-contribute.tpl.html
 [correspondents]
 navigation: navigation-about.tpl.html
 content: content-correspondents.tpl.html
@@ -130,6 +138,10 @@ content: content-promote.tpl.html
 navigation: navigation-about.tpl.html
 content: content-comments_viewer.tpl.html
 [new_year]
 navigation: navigation-about.tpl.html
 content: content-new_year.tpl.html
 [hpr_ogg]
 root_template: rss.tpl.xml
 content: rss-hpr.tpl.xml
@@ -3,7 +3,7 @@
 <!--% PROCESS 'shared-listen-now.tpl.html' %-->
 <!--% PROCESS "queries-episode.tpl.html" %-->
 <!--% USE DBI(constants.driver) %-->
-
+<!--% page_title = "HPR ~ Current comments on the shows" %-->
 <h2>Comment Viewer</h2>
 <p>Because of the spammers we have had to turn on comment moderation. Sorry about the delay this will cause.</p>
 <p><a href="<!--% absolute_path(baseurl) %-->comments.rss">Subscribe</a> to the comment feed.</p>
@@ -1,3 +1,4 @@
 <!--% page_title = "HPR ~ Contact the Community" %-->
 <article>
    <header>
        <h1>Contact</h1>
@@ -0,0 +1,994 @@
 <!--% page_title = "HPR ~ Contribute to this community podcast" %-->
 <ul>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#so_you_want_to_record_a_podcast') %-->">So you want to record a podcast</a></li>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#stuff_you_need_to_know') %-->">Stuff you need to know</a></li>
  <ul>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#wikipedia') %-->">You will no longer be allowed to edit HPR pages on Wikipedia</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#syndication') %-->">We do not syndicate shows not produced for HPR</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#license') %-->">You are agreeing to license your show CC BY-SA 4.0</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#permission') %-->">You have permission to redistribute your show in its entirety</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#not_moderated') %-->">The audio of your show will not be moderated</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#explicit_content') %-->">Your show will be signaled as containing explicit content</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#schedule') %-->">You determine when your show will be released</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#utf8') %-->">We use UTF-8 end to end</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#accessibility') %-->">Keep accessibility in mind</a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#international') %-->">Your show will be heard by an International Audience</a></li>
  </ul>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#pick_a_topic') %-->">Pick a Topic</a></li>
  <ul>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
    <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
  </ul>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->"></a></li>
 </ul>
 <div class="lane stack">
 <article>
 <header>
  <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
  <h1 id="so_you_want_to_record_a_podcast">So you want to record a podcast<a href="<!--% absolute_url(baseurl,'contribute.html#so_you_want_to_record_a_podcast') %-->">.</a></h1>
 </header>
 <p>Well you've come to the right place.
 Our goal here at HPR is to make it as easy as possible for you to get your show released. 
 We take care of the hard bits so you don't need to. 
 </p>
 <p> 
 Recording your first show can be a daunting prospect but <a href="<!--% absolute_url(baseurl) %-->correspondents/index.html">hundreds of people</a> 
 like yourself have done it, and so can you.
 Don't worry that we won't like the topic, just have a look at our <a href="<!--% absolute_url(baseurl) %-->eps/index.html">Archive</a>
 to see how diverse the contributions have been.</p>
 <p>
 Don't worry if your audio isn't perfect, 
 that your voice sounds funny, 
 that English isn't your native language, 
 that you suffer from a <a href="<!--% absolute_url(baseurl,'/eps/hpr1102/index.html') %-->">speech impediment</a>, 
 that your show has loads of ummms and awws in it, etc.
 We have plenty of hosts that fall into all these categories, but continue to produce great shows.
 </p>
 <p>
 At the end of the day the show is about the content and less about perfection. 
 That's not to say we won't help you with ways to improve the audio if you wish, 
 or narrate your script for you if you can't or won't record it yourself.
 </p>
 </article>
 <article>
 <header>
  <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
  <h1 id="stuff_you_need_to_know">Stuff you need to know<a href="<!--% absolute_url(baseurl,'contribute.html#stuff_you_need_to_know') %-->">.</a></h1>
 </header>
 <p>
 This is some important information that you will need to know before uploading to HPR.
 </p>
 <details>
 <summary id="wikipedia">You will no longer be allowed to <a href="<!--% absolute_url(baseurl,'about.html#hpr_wikipedia_page') %-->">edit HPR pages</a> on Wikipedia<a href="<!--% absolute_url(baseurl,'contribute.html#wikipedia') %-->">.</a></summary>
 <p>
 Once you upload a show, you will be associated with the HPR project. 
 As such, <a href="https://en.wikipedia.org/wiki/Wikipedia:FAQ/Organizations">Wikipedia</a> policies will prevent you from creating, 
 or editing pages relating to 
 <a href="https://en.wikipedia.org/wiki/Hacker_Public_Radio">Hacker Public Radio</a>. For more information see <a href="<!--% absolute_url(baseurl,'about.html#hpr_wikipedia_page') %-->">(Re)Creating a HPR page on wikipedia</a>.
 </p>
 </details>
 <details>
 <summary id="syndication">We <strong>do not syndicate</strong> shows not produced for HPR<a href="<!--% absolute_url(baseurl,'contribute.html#syndication') %-->">.</a></summary>
 <p>
 HPR is founded on the principle of Hackers sharing knowledge, so we are not a media aggregation site.
 For this reason we are only releasing material created exclusively for HPR.
 Once released, the creative commons license will allows sharing it to other locations.
 </p>
 <p>
 We will continue to promote new podcasts, and other creative commons material, 
 thought our sister site <a href="https://freeculturepodcasts.org/">Free Culture Podcasts</a>.
 </p>
 <p>
 We do allow <strong>promotion of one example</strong> episode of creative commons content.
 You post it as a regular show in the series <a href="<!--% absolute_url(baseurl) %-->series/0075.html">Podcast recommendations</a>,
 with your introduction as to what the piece is, why it's important, 
 what version of Creative Commons it is released under, and provide links to the website, and to the RSS feed.
 </p>
 </details>
 <details>
 <summary id="license">You are agreeing to <strong>license</strong> your show <strong>CC BY-SA 4.0</strong><a href="<!--% absolute_url(baseurl,'contribute.html#license') %-->">.</a></summary>
 <p>
 All our shows are now released under a 
 <a href="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</a>
 license, which means that while you continue to retain the copyright to your show, 
 you are allowing us (and everyone else) to use it provided we give you attribution and that we release it under the same license.
 Click the <a href="https://creativecommons.org/licenses/by-sa/4.0/">link</a> for more information.
 </p>
 </details>
 <details>
 <summary id="permission">You have <strong>permission</strong> to redistribute your show in its entirety<a href="<!--% absolute_url(baseurl,'contribute.html#permission') %-->">.</a></summary>
 <p>
 Never include content, for example music, in your show that you do not have permission to redistribute.
 Try to avoid using any content in your show that can not be redistributed under a 
 <a href="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) </a> 
 license.
 If you are redistributing under  another Creative Commons license, GNU Free Documentation License, public domain, 
 or FLOSS software license, then please signal that when you upload your show. 
 We do not post <a href="https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/policies.md#policy-change-should-we-reject-a-show-with-copyrighted-fair-use-clips-in-it-httpslistshackerpublicradiocompipermailhpr2019-may003673html">other copyrighted content</a>, even if it is made available under fair use, or by arranged permission.
 </p>
 </details>
 <details>
 <summary id="not_moderated">The audio of your show will <strong>not be moderated</strong><a href="<!--% absolute_url(baseurl,'contribute.html#not_moderated') %-->">.</a></summary>
 <p>
 We do not vet, edit, moderate or in any way censor any of the audio you submit, <strong>we expect you to do that</strong>.
 Aside from checking snippets for audio quality/spam checking, 
 we have a policy that we don't listen to the shows before they are aired.
 This is a long standing tradition arising from the fact that HPR is a community of peers 
 who believe that any host has as much right to submit shows as any other.
 </p>
 <p>
 Please note that this only relates to the audio you upload.
 We <strong>do</strong> transform the audio into different formats.
 The rest of the meta-data (branding/summaries/tags/show notes/etc.), are managed by the HPR Community, 
 and <strong>probably will</strong> be edited.
 </p>
 <p>
 There is no guarantee that we will accept your show.
 Even after it is processes, <strong>any material that is reported as harming HPR may be unlisted until such a time as the situation can be resolved</strong>.
 You can expect your show to be rejected for (incomplete list):
 <ul>
 <li>Inaudible audio</li>
 <li>Containing Copyright Content, even <em>Fair Use</em></li>
 <li>Not a HPR Episode</li>
 <li>Containing Harassment, Trolling, Spamming, etc, Content</li>
 </ul>
 </p>
 <p>
 Please refer to <a href="https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/policies.md#free-speech-and-general-conduct">Free speech and general conduct</a> 
 which describes the agreed approach to this topic.
 </p>
 </details>
 <details>
 <summary id="explicit_content">Your show will be signaled as containing <strong>explicit</strong> content<a href="<!--% absolute_url(baseurl,'contribute.html#explicit') %-->">.</a></summary>
 <p>
 Given that we are an open forum for free speech,
 we signal all our shows as "explicit" with the assumption that the listeners will apply the required discretion when playing the shows in public.
 That said the majority of our content is technical in nature and therefore is often considered appropriate for any audience.
 If you feel that your show will be considered <strong>inoffensive in every region of the world</strong> 
 then you can signal your show as <em>Clean</em> when you upload the show.
 </p>
 <p>
 When dealing with content that is "explicit" or contains material that would best be suited for a mature audience, 
 it has become traditional to include a <strong>short warning</strong> at the very beginning of the show before the intro, 
 to allow listeners <strong>sufficient time</strong> to switch off the episode should they so desire.
 </p>
 <p>
 Please refer to <a href="https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/policies.md#free-speech-and-general-conduct">Free speech and general conduct</a> 
 which describes the agreed approach to this topic.
 </p>
 </details>
 <details>
 <summary id="schedule">You determine when your show will be <strong>scheduled</strong><a href="<!--% absolute_url(baseurl,'contribute.html#schedule') %-->">.</a></summary>
 <p>You decide when you upload your show <a href="<!--% absolute_url(baseurl,'contribute.html#upload_your_show') %-->">when it should be released</a>.
 You can pick a day, or put it in the reserve pool and let the Janitors use it there are free slots.</p>
 </details>
 <details>
 <summary id="utf8">We use <strong>UTF-8</strong> end to end<a href="<!--% absolute_url(baseurl,'contribute.html#utf8') %-->">.</a></summary>
 <blockquote>See the video "<a href="https://www.youtube.com/watch?v=MijmeoH9LT4">Characters, Symbols and the Unicode Miracle - 
    Computerphile</a>" for an interesting background to ASCII and <a href="https://en.wikipedia.org/wiki/UTF-8">UTF-8</a>.
 </blockquote>
 </details>
 <details>
 <summary id="accessibility">Keep <strong>accessibility</strong> in mind<a href="<!--% absolute_url(baseurl,'contribute.html#accessibility') %-->">.</a></summary>
 <p>
 When you includes output from the command line in the show notes, 
 posting screen-shots of console or terminal output 
 makes it impossible for screen readers to access the text.
 Always try to include the raw output ( eg: embedded in &lt;pre&gt; tags) 
 </p>
 <p>Include descriptive language in any link texts. 
 Avoid structures like: <em>"For accessibility information 
 <a href="<!--% absolute_url(baseurl,'contribute.html#accessibility') %-->">click here</a>"</em>.
 Rather use: <em>"For more information click our 
 <a href="<!--% absolute_url(baseurl,'contribute.html#accessibility') %-->">accessibility page</a>"</em>
 </p>
 <p>When adding Images, add the descriptive text under the image (not in the alt tag). 
 That way everyone can benefit from the description.
 </details>
 <details>
 <summary id="international">Your show will be heard by an <strong>International Audience</strong><a href="<!--% absolute_url(baseurl,'contribute.html#international') %-->">.</a></summary>
 <p>
 We have people listening from all over the world, who may not have the same cultural background as yourself, 
 therefore you should be as clear as possible when giving details.
 For example always give temperatures in both Celsius and Fahrenheit, measurements in Metric and Imperial, 
 dates in <strong>YYYY-MM-DD</strong> <a href="https://en.wikipedia.org/wiki/ISO_8601">iso8601</a> format, 
 and abbreviations using the <a href="https://en.wikipedia.org/wiki/NATO_phonetic_alphabet">NATO phonetic alphabet</a>.
 </p>
 <p>
 Never assume that your audience knows what age a sixth grader is, or how big a 20 Cent Euro coin is.
 Keep in mind that keyboard layouts are also different so make sure to specify the key shape or the position 
 inrelation to a common known standard.
 For example:
 </p>
 <blockquote>The at sign normally situated above the 2 key on a US keyboard, and has a unicode number of U+0040.
  For more information see <a href="https://en.wikipedia.org/wiki/At_sign">Wikipedia</a></blockquote>
 <p>
 <a href="https://xkcd.com/1179/"><img src="https://imgs.xkcd.com/comics/iso_8601.png" 
                    title="ISO 8601 was published on 06/05/88 and most recently amended on 12/01/04." alt="An xkcd cartoon showing ISO 8601" /></a>
 </p>
 </details>
 <p>
 If you have any questions please join one of our <a href="<!--% absolute_url(baseurl,'about.html#contact') %-->">contact channels</a> to chat with people who will help.
 </p>
 </article>
 <div class="lane stack">
 <article>
 <header>
  <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
  <h1 id="pick_a_topic">Pick a Topic<a href="<!--% absolute_url(baseurl,'contribute.html#pick_a_topic') %-->">.</a></h1>
 </header>
 <p>
 The first thing you will need to do is decide on a topic for your show. 
 OMG I just learned, broke, hacked, discovered this cool thing and noone in my house get’s it.
 Check out our 91 in depth series, or 6,938 unique tags for ideas.
 You might already have an idea,
 but if not you can have a look at our <a href="<!--% absolute_url(baseurl) %-->eps/index.html">Archive</a> page for examples of shows people have recorded in the past. 
 <p id="requested topics">
 We maintain a page of <a href="https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/requested_topics">requested topics</a>
 that have been sent in by the community. 
 Feel free to add it to the list via <a href="<!--% absolute_url(baseurl,'about.html#contact') %-->">the contact channels</a>.
 </p>
 <a href="<!--% absolute_url(baseurl,'contribute.html#requested_topics') %-->">Requested Topics</a>, or our 
 <a href="<!--% absolute_url(baseurl) %-->series/index.html">Series</a> page to see if you can add your knowledge to the pool.
 </p>
 <p>
 If you are worried that your show may not be of interest to Hackers then you can <a href="<!--% absolute_url(baseurl) %-->will-my-show-be-of-interest-to-hackers.html">click here</a> to check if it is.
 </p>
 <p>
 If you can't think of anything to talk about then please just record a show telling us 
 <a href="<!--% absolute_url(baseurl) %-->series/0029.html">how you got into tech</a> 
 as a way to introducing yourself to the community.
 </p>
 </article>
 <h2 id="record_your_show">3. Record your show<a href="<!--% absolute_url(baseurl,'contribute.html#record_your_show') %-->">.</a></h2>
 <p>
 Please select <a href="<!--% absolute_url(baseurl,'contribute.html#recording_a_podcast') %-->">more detailed information</a> 
 on how to record a show:
 </p>
 <ul>
  <li>Recording with a <a href="<!--% absolute_url(baseurl,'contribute.html#portable_media_player') %-->">portable media player</a>.</li>
  <li>Recording with a <a href="<!--% absolute_url(baseurl,'contribute.html#smart_phone') %-->">smart phone</a>.</li>
  <li><a href="<!--% absolute_url(baseurl,'contribute.html#editing') %-->">Recording/Editing</a> using your Computer.</li>
  <li>Recording Interviews with the <a href="<!--% absolute_url(baseurl,'contribute.html#phone_interviews') %-->">Phone</a>.</li>
  <li>Recording <a href="<!--% absolute_url(baseurl,'contribute.html#round_table') %-->">round table</a> discussions.</li>
  <li>Avoid <a href="<!--% absolute_url(baseurl,'contribute.html#background_music') %-->">Bedding/background</a> music.</li>
  <li>We mix down to <a href="<!--% absolute_url(baseurl,'contribute.html#encoding') %-->">Mono</a>.</li>
  <li>No need to add <a href="<!--% absolute_url(baseurl,'contribute.html#no_metadata') %-->">Metadata</a> to the file.</li>
 </ul>
 <p>Don't forget to <strong>introduce yourself</strong> in your show.</p>
 <h2 id="upload_your_show">4. Upload your show<a href="<!--% absolute_url(baseurl,'contribute.html#upload_your_show') %-->">.</a></h2>
 <p>
 Once you have your audio ready you can post your show by going to the <a href="<!--% hub_baseurl %-->calendar.php">Calendar</a> 
 page or press the <a href="<!--% hub_baseurl %-->calendar.php"><strong>⇧Upload⇧</strong></a> button.
 </p>
 <p>
 After you have selected a date you will be redirected to the <a href="<!--% hub_baseurl %-->request.php">request page</a>, 
 where you will be asked to select your show and email address. 
 We will send a link to where you can upload your show to this address and so it must be a valid working address 
 that you can access quickly. 
 We intend to use <a href="https://www.gnupg.org/">GPG</a> to speed up the validation of hosts, 
 so you may wish to use an email address that has an associated public key available on public key servers.
 </p>
 <p>
 <a href="<!--% absolute_url(baseurl,'contribute.html#requesting_slot') %-->">More Information</a>.
 </p>
      <li>You determine where in the <a href="<!--% absolute_url(baseurl,'contribute.html#schedule') %-->">schedule</a> your show will be released.</li>
      <li>We use <a href="<!--% absolute_url(baseurl,'contribute.html#utf8') %-->">UTF-8</a> end to end.</li>
      <li>Your show will be heard by an <a href="<!--% absolute_url(baseurl,'contribute.html#international') %-->">International</a> Audience.</li>
      <li>We also need <a href="<!--% absolute_url(baseurl,'contribute.html#reserve_queue') %-->">reserve</a> shows.</li>
      <li>You will no longer be allowed to edit HPR pages on 
      <a href="<!--% absolute_url(baseurl,'contribute.html#faq_wikipedia') %-->">Wikipedia</a>.</li>
      </ul>
      <h1 id="scheduling">Deciding when to post your show</h1>
      <p>Y</p>
      <p>We have a <a href="https://repo.anhonesthost.net/HPR/hpr_documentation/raw/branch/main/workflow/SchedulingGuidlinesFlowChart.odg">flow diagram</a> if that helps.</p>
      <p>Please see <a href="https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/queue.md">for more information on the queue</a>.</p>
      <h2 id="regular_queue">Regular Queue</h2>
      <ol>
        <li>You must have your audio recording ready to upload <strong>before</strong> you pick a slot.</li>
        <li>All hosts must leave at least 9 slots (approximately two weeks) between their shows.</li>
        <li>New hosts, Interviews, and other time critical shows should use the first free slot. 
        Otherwise, when the queue is filling up then leave some slots free for new contributors by selecting a slot in the first empty week.</li>
      </ol>
      <h2 id="reserve_pool">Reserve Pool</h2>
        <li>If you have a non urgent show that is timeless, then add it to the <a href="<!--% absolute_url(baseurl,'contribute.html#reserve_pool') %-->">reserve pool</a>.</li>
      </article>
      future feed
      <p>
      Over the years 
      The HPR Schedule is entirely community driven and we recommend that <strong>you</strong> pick the date or show number 
      as then you know when your show will be released.
      However the slots will only be allocated once the shows have been successfully processed.
      Any missing information can result in a show missing the requested slot.
      </p>
      <p>
      The reserve pool is intended only to be used in the cases where there is still a gap in the schedule one week prior to release. 
      This was known as the emergency queue, but now can also be used when the hosts don't care when the shows are scheduled. 
      They will be used on a first come first go basis, when there is no conflict with the scheduling Rules.
      These shows contain a message alerting listeners to the fact that we had free slots that were not filled.
      </p>
      <p>
      <a href="https://repo.anhonesthost.net/HPR/hpr_documentation/src/branch/main/policies.md#permission-to-move-out-a-show">not possible to move them</a>.
      </p>
      <h2 id="reserving">All reservations need to be approved<a href="<!--% absolute_url(baseurl,'contribute.html#reserving') %-->">.</a></h2>
      <h3 id="regular_queue">Regular Queue<a href="<!--% absolute_url(baseurl,'contribute.html#regular_queue') %-->">.</a></h3>
      <p>
      Any host can select any free slot a up to year in advance. However the audio must be ready at time of picking a slot 
      so that it can be upload immediately afterwards.
      </p>
      <p>
      In exceptional circumstances it may be necessary to reserve a slot while not having the audio available, 
      but this must be approved by the <a href="<!--% absolute_url(baseurl,'/maillist') %-->">HPR Mailing List</a> in advance.
      Be sure to allow as much time as possible, and include a reason why you feel it is necessary to reserve the slot.
      </p>
      <p>
      This is intended only for exceptional circumstances, such as a scheduled interview where we would 
      like the audio to be released as soon after the event as possible, 
      or to cover an important topical situation that has occurred.
      Due to the extended time now needed to post shows to external sites, 
      the extra work this entails and the disruptive effect of reservations, 
      we will no longer be allowing them except in very rare cases of the type mentioned above.
      </p>
      <p>
      The following are standing reservations:
      </p>
      <ul>
        <li>Anniversary episodes.</li>
        <li>HPR Community News on the first Monday of the month.</li>
        <li>The first day of the fourth month.</li>
        <li>The days following new year.</li>
      </ul>
      <h3 id=""><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->">.</a></h3>
      <h3 id=""><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->">.</a></h3>
      <h3 id=""><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->">.</a></h3>
      <h3 id=""><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->">.</a></h3>
      <h3 id=""><a href="<!--% absolute_url(baseurl,'contribute.html#') %-->">.</a></h3>
      <hr class="no-css">
      <article>
        <header>
          <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
          <h1 id="requesting_slot">Picking a slot for your show</h1>
        </header>
      <p>
      Any host can select any free slot a up to year in advance, by recording their show and uploading it to the desired slot. 
      In exceptional circumstances it may be necessary to reserve a slot while not having the audio available, 
      but this must be approved by the <a href="<!--% absolute_url(baseurl,'/maillist') %-->">HPR mailing list</a> in advance. 
      Be sure to allow as much time as possible, and include a reason why you feel it is necessary to reserve the slot.
      </p>
      <p>
      This is intended only for exceptional circumstances, such as a scheduled interview where we would like the audio to be 
      released as soon after the event as possible, or to cover an important topical situation that has occurred. 
      Due to the extended time now needed to post shows to external sites, 
      the extra work this entails and the disruptive effect of reservations, 
      we will no longer be allowing them except in very rare cases of the type mentioned above. 
      [<a href="https://lists.hackerpublicradio.com/pipermail/hpr/2018-February/003482.html">?</a>]
      </p>
      <p>
      You can post your show by going to the <a href="<!--% hub_baseurl %-->calendar.php">Calendar</a> page. 
      Once you have selected a date you will be redirected to the <a href="<!--% hub_baseurl %-->request.php">request page</a>, 
      where you will be asked to select your show and email address. 
      We will send a link to where you can upload your show to this address and therefore it must be a valid working address 
      that you can access quickly. We intend to use <a href="https://www.gnupg.org/">GPG</a> to speed up the validation of hosts, 
      so you may wish to use an email address that has an associated public key available on public key servers. 
      </p>
      <p>
      The audio of your show will not be moderated, however <em>the information provided in the upload form 
        <strong>may be moderated</strong></em>. 
      All publicly facing material is managed by the HPR Community as a whole, and not just the host providing the show. 
      The show <a href="<!--% absolute_url(baseurl) %-->eps/hpr2210/index.html">hpr2210 :: On Freedom of Speech and Censorship</a> 
      describes the agreed approach to this topic.
      </p>
      <p><strong>Note:</strong> This email address will be published on the HPR website and will be given out in the feeds, 
      so please use a <strong>public email</strong> address for this purpose. 
      Where we publish it we pad it with dot nospam at-sign nospam dot. <br>
      i.e. <em>hpr@example.com</em> becomes <em>hpr.nospam@nospam.example.com</em>. 
      If you do not want to have your email exposed, please contact the admin@hpr team to arrange a alias.
      </p>
      <p>
      Once you press <em>next</em>, an email will be sent to your email address pointing to where you can upload the show. 
      You need to <em>open</em> the link within <strong>15 minutes</strong> or the temporary lock will be released. 
      Once you open the link, you can fill in the information at your leisure. 
      The upload form works on the assumption you will be posting one show at a time, from the same IP address. 
      Once you have pressed submit you will not be able to edit any of the information.
      </p>
      <ul>
 <h2 id="questions">Questions ?<a href="<!--% absolute_url(baseurl,'contribute.html#questions') %-->">.</a></h2>
 <p>
 Got any questions not covered here, then just email <strong>"admin" at "HPR"</strong>, 
 and we'll get in touch with you with all you need to know about getting your show published.<br>
 You can chat with other podcasters using IRC in the <strong>#oggcastplanet</strong> channel on the 
 <a href="https://web.libera.chat/gamja/?channels=oggcastplanet">libera.chat</a> network. 
 Follow us on <a href="https://infosec.exchange/@hpr">Mastodon</a> (use the tag <strong>#hpr</strong>) 
 and on <a href="https://twitter.com/hpr">Twitter</a> (use the tag <strong>#hpr</strong>). 
 We have a <a href="https://www.facebook.com/HenryPartickReilly">Facebook</a> and 
 <a href="https://www.linkedin.com/groups?mostPopular=&amp;gid=3737302">LinkedIn</a> group, 
 so please join and spread the word.</p>
 <h2 id="response_episode">Response Episode</h2>
 https://lists.hackerpublicradio.com/pipermail/hpr/2021-September/004250.html
 <h2 id="motto">Our Mottos</h2>
 <blockquote>Any audio is better than no audio.</blockquote>
 <blockquote>Any topic of intrest to <!--% make_sfw(is_sfw, "hobbyist", "hacker") %-->s.</blockquote>
 <blockquote>It ain't a show unless it's on the server.</blockquote>
 <blockquote>If you tell us you are doing a show, then you owe us a show.</blockquote>
 <p>You don't need anyones permission to upload a show, but if you have any questions then drop into the 
 <a href="https://web.libera.chat/gamja/?channels=oggcastplanet">#oggcastplanet</a> channel on libera.chat 
 and chat with a live person 24/7.
 </p>
 </article>
 <hr class="no-css">
 <article>
  <header>
    <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
    <h1 id="recording_a_podcast">Recording a Podcast</h1>
  </header>
 <p>
 On this page you will find information on how to record a podcast. Our golden rule is <strong>Any audio is better than no audio.</strong> 
 so keep that in mind. Don't forget to <strong>introduce yourself</strong> in your show.
 </p>
 <h2 id="portable_media_player">Recording with a portable media player
  <a href="<!--% absolute_url(baseurl,'contribute.html#portable_media_player') %-->">.</a></h2>
 <p>
 Many of today's <a href="https://wiki.xiph.org/PortablePlayers">portable media players</a> support recording audio out of the box. 
 Search for "Voice Recorder", to see if there is an application for your smartphone. 
 Whichever option you have close to hand, try and set the recording to the best quality format 
 (<a href="https://en.wikipedia.org/wiki/WAV">WAV</a> or <a href="https://en.wikipedia.org/wiki/FLAC">FLAC</a>), 
 and set everything else to the highest setting. 
 It's always the goal to get the best quality audio but here at Hacker Public Radio we value content over quality 
 and so long as it's audible we'll take it. 
 </p>
 <p>
 Then just record your show, <a href="<!--% absolute_url(baseurl,'contribute.html#requesting_slot') %-->">request a slot</a>, 
 and we'll do the rest.
 </p>
 <h2 id="smart_phone">Recording with a portable media player<a href="<!--% absolute_url(baseurl,'contribute.html#smart_phone') %-->">.</a></h2>
 <p>
 Some of our hosts recommend <a href="https://gitlab.com/axet/android-audio-recorder">Android Audio Recorder</a> on my android phone. 
 It's available on <a href="https://f-droid.org/en/packages/com.github.axet.audiorecorder/">F-Droid</a> 
 and <a href="https://play.google.com/store/apps/details?id=com.github.axet.audiorecorder">Google Play</a>. 
 These are the recommended settings:
 </p>
 <ul>
  <li>Recording Source - Unprocessed</li>
  <li>Sample Rate - 44.1 kHz</li>
  <li>Encoding - .flac</li>
  <li>Audio Channels - Mono</li>
 </ul>
 <h2 id="editing">Recording/Editing using your Computer<a href="<!--% absolute_url(baseurl,'contribute.html#editing') %-->">.</a></h2>
 <p>
 The majority of podcasters use <a href="https://audacity.sourceforge.net/download/">Audacity</a>. 
 First set the Project Rate to 44100Hz, then you can either record your show in Audacity itself or 
 import the file you recorded earlier and edit it as you wish.
 </p>
 <p>
 <img srcset="images/contribute-audacity-record-sm.png 460w, images/contribute-audacity-record.png 640w"
     sizes="(max-width: 460px) 95vw, 640px" 
     src="images/contribute-audacity-record.png" alt="Audacity Can Record" title="Audacity Screenshot of Recording" >
 </p>
 <blockquote>Audacity is a free, easy-to-use and multilingual audio editor and recorder for 
  Windows, Mac OS X, GNU/Linux and other operating systems.</blockquote>
 <iframe id="youtube" src="//www.youtube.com/embed/ss8CyTwBOPY"></iframe>
 <p>
 When you have finished editing your podcast you can export it.
 </p>
 <ol>
  <li>Confirm that the Project Rate is set to 44100 Hz (bottom left).</li>
  <li><em>File -> Export</em> and select <strong>FLAC File</strong>.</li>
  <li>Click <em>Options...</em> to reveal FLAC Export Setup.</li>
  <li>Set <em>Level</em> to <strong>8 (best)</strong>.</li>
  <li>Set <em>Bit depth</em> to <strong>24</strong>.</li>
 </ol>
 <p>
 <img srcset="images/contribute-audacity-export-sm.png 460w, images/contribute-audacity-export.png 640w"
     sizes="(max-width: 460px) 95vw, 640px" 
 src="images/contribute-audacity-export.png" alt="Audacity Export Settings" title="Audacity Screenshot of an Export" >
 </p>
 <h2 id="phone_interviews">Recording Interviews with the Phone<a href="<!--% absolute_url(baseurl,'contribute.html#phone_interviews') %-->">.</a></h2>
 <p>
 If you want to record a one-to-one interview with someone then you can use 
 <a href="https://www.skype.com/en/">Skype</a> in conjunction with <a href="https://atdot.ch/scr/">Skype Call Recorder</a>. 
 If everyone is using skype then it won't cost you anything otherwise you will need to pay for SkypeOut service. 
 Although the quality is usually terrible, you could also put your phone on hands free and 
 record with a <a href="https://wiki.xiph.org/PortablePlayers">portable media player</a>.
 </p>
 <h2 id="round_table">Recording round table discussions<a href="<!--% absolute_url(baseurl,'contribute.html#round_table') %-->">.</a></h2>
 <p>
 If you would like to record with multiple participants then you can use <a href="https://www.mumble.com/">Mumble</a>. 
 Connect to <strong>chatter.skyehaven.net</strong> Port: <strong>64738 </strong>.<br>
 Walk through the audio wizard and then pop into the <strong>Hacker Public Radio</strong> room. 
 Once you are ready press the <strong>recording</strong> button, select <em>multichannel</em> and then <em>start</em>. 
 That will record multiple tracks, one for each participant which you can edit and then submit.
 <br>
 Kwisher made a <a href="<!--% absolute_url(baseurl) %-->mumble-howto">Mumble tutorial</a> 
 which you might find useful and <a href="<!--% absolute_url(baseurl) %-->correspondents/0228.html">Delwin</a> 
 has produced a number of short shows on how to configure the audio quality.
 </p>
 <p>
 <img srcset="images/contribute-mumble-record-sm.png 460w, images/contribute-mumble-record.png 640w"
     sizes="(max-width: 460px) 95vw, 640px" 
     src="images/contribute-mumble-record.png" alt="Audacity Can Record" title="Audacity Screenshot of Recording" >
 </p>
 <h2 id="background_music">Avoid Bedding/background music<a href="<!--% absolute_url(baseurl,'contribute.html#background_music') %-->">.</a></h2>
 <p>
 You may include backing music but it's best if you don't. Most long time podcast listeners speed up their shows, 
 as this allows them to cram more shows into a day. Having bedding music makes it more difficult to understand, 
 and prevents tools like <em>truncate silence</em> from working correctly.<br/>
 Others will convert shows to mono to listen in one ear leaving the other free to carry out their other chores. 
 Still more slow the shows down so that they can improve their English. 
 Others are hard of hearing and backing music makes it difficult to understand the text.
 </p>
 <h2 id="encoding">We mix down to Mono<a href="<!--% absolute_url(baseurl,'contribute.html#encoding') %-->">.</a></h2>
 <p>
 We will by default mix down your show to one channel mono and we will 
 <a href="https://gitorious.org/hpr-scheduling-system/hpr-scheduling-system/source/2d526e000d31e79afa3d863ea8659503e2074267:transcoding/hprtranscode">transcode</a> to MP3, ogg and spx formats. If you want to control this in more detail then please email admin at Hacker Public Radio for more information.
 </p>
 <h2 id="no_metadata">No need to add Metadata to the file<a href="<!--% absolute_url(baseurl,'contribute.html#no_metadata') %-->">.</a></h2>
 <p>
 There is no need to add any information to the file as that will be inserted based on the information you fill in when you upload the show.
 </p>
 </article>
 <hr class="no-css">
 <article>
  <header>
    <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
    <h1 id="promote_hpr">Please promote HPR<a href="<!--% absolute_url(baseurl,'contribute.html#promote_hpr') %-->') %-->">.</a></h1>
  </header>
 <p>Feel free to use the promotional material to spread the word in your podcasts, or have them played on to other shows.</p>
 <h2>General HPR promotion</h2>
 <ul>
  <li><a href="<!--% absolute_url(baseurl) %-->promos/HPRpromoKlaatu.ogg">Klaatu explains HPR Daily podcast by the 
      Community for the Community</a></li>
  <li><a href="<!--% absolute_url(baseurl) %-->promos/HPRpromoNewsCast.ogg">HPR Promo NewsCast theme by Klaatu</a></li>
  <li><a href="<!--% absolute_url(baseurl) %-->promos/HPRpromoSkirlet.ogg">HPR Promo by Skirlet</a></li>
  <li><a href="<!--% absolute_url(baseurl) %-->promos/hpr-contributor-promo-sax.ogg">HPR Promo sax theme by slick0</a></li>
  <li><a href="<!--% absolute_url(baseurl) %-->promos/hpr-contributor-promo-basenettheme.ogg">HPR Promo basenet roll theme by slick0</a></li>
 </ul>
 <h2>New Year Promo</h2>
 <ul>
  <li><a href="<!--% absolute_url(baseurl) %-->promos/hpr-nye-promo.ogg">HPR New Years Promo</a></li>
 </ul>
 </article>
 <hr class="no-css">
 <article>
  <header>
    <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
    <h1 id="adding_an_episode">Adding an Episode</h1>
  </header>
 <p>
 The unique link sent by email will allow you to manage both the episode and information about yourself that is displayed on HPR. 
 The following information will be requested:
 </p>
 <h2 id="personal_information">Personal Information</h2>
 <p>
 Remember <em>All information will be displayed publicly</em>. The only exception is that your email address will be sent 
 in the feed with some anti-spam additions.<br>
 For example <em>hpr@example.com</em> will become <em>hpr.nospam@nospam.example.com</em>
 </p>
 <ul>
  <li id="email"><strong>email:</strong> <em>already populated</em><br>
    See notes <a href="<!--% absolute_url(baseurl,'contribute.html#requesting_slot') %-->">above</a><br>
  </li>
  <li id="image"><strong>image:</strong> <em>Optional</em><br>
    If you have associated a <a href="https://en.gravatar.com/">Gravatar</a> image with an email address, 
    then it will be displayed here. 
    Otherwise you can upload a 80x80 image .</li>
  <li id="Name_Handle"><strong>Name/Handle:</strong> <em>Mandatory</em><br>
    It should be the name you wish to be known as on HPR. It can be your real name, an Internet handle or both.</li>
  <li id="Default_license"><strong>Your Default license:</strong> <em>Mandatory</em><br>
    This field tells us what your work is normally licensed under. All our shows are now released under a 
    <a href="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 
      International (CC BY-SA 4.0)</a> license, which means that while you continue to retain the copyright 
    to your show you are allowing us (and everyone else) to use it provided we give you attribution and 
    that we release it under the same license. Click the <a href="https://creativecommons.org/licenses/by-sa/4.0/">link</a>
    for more information.</li>
  <li id="Profile"><strong>Profile:</strong> <em>Optional</em><br>
    Enter some text about yourself with links to your blog or other online presence.</li>
 </ul>
 <p>
 Your profile information is used on the website, in the RSS feeds, and on social media sites. You can change your profile information at any time, by submitting another show.
 </p>
 <h2 id="episode_information">Episode Information</h2>
 <ul>
  <li id="Title"><strong>Title:</strong> <em>Mandatory</em><br>
    This will be a short descriptive title and will be used everywhere to identify your show. Any valid UTF-8 character is acceptable, but keep the length short and clear.</li>
  <li id="Short_Summary"><strong>Summary:</strong> <em>Mandatory</em><br>
    This is a short 100 character summary of what your show is about. 
    Please fill this out as it is used once the show has gone off the main page, on the mobile site, 
    on printed brochures, on text to speech announcements, on twitter, <a href="https://infosec.exchange/@hpr">Mastodon</a> etc.</li>
  <li id="Theme"><strong>Theme:</strong> <em>Automatic</em><br>
    The Intro, and the Outro will be added automatically. Please do not add it.
  </li>
  <li id="Explicit"><strong>Explicit:</strong> <em>Mandatory</em><br>
    See <a href="https://web.archive.org/web/20150326185817/http://www.apple.com/uk/itunes/podcasts/specs.html">iTunes</a> 
    for more information.</li>
  <li id="License"><strong>License:</strong> <em>Mandatory</em><br>
    All our shows are now released under a 
    <a href="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</a> 
    license, which means that while you continue to retain the copyright to your show you are allowing us (and everyone else) 
    to use it provided we give you attribution and that we release it under the same license. 
    Click the <a href="https://creativecommons.org/licenses/by-sa/4.0/">link</a> for more information.</li>
  <li id="show_notes"><strong>show notes:</strong> <em>Mandatory</em><br>
    It is important to provide good show notes because:
    <ul>
      <li><strong>They provide the listeners with more information on the topic.</strong><br>
        You have taken the time to record a show on a topic, so many people will want to find out more on the subject, 
        therefore you should include links to give more information. It is not enough to just give it in the show itself 
        as people may be listening while away from the Internet, and they may have forgotten or misheard your links.
      </li>
      <li><strong>They ensure your show gets posted on time.</strong><br>
        If you do not supply show notes then your show notes will need to be edited manually by an HPR volunteer and 
        this will most likely result in delays. During that time other shows will be processed and may get posted 
        before your show. 
        It is always better if you send us show notes yourself as you know best what information you are trying to convey.</li>
      <li><strong>They encourage people to download your show.</strong><br>
        We produce a lot of shows and many people download based on the text in the show notes. 
        If the show notes are not descriptive then it is less likely that 
        it will get as many downloads as other shows with good show notes.</li>
      <li><strong>They allow your show to be indexed by search engines.</strong><br>
        Search engines cannot determine the content of your show from the audio alone. 
        The only way for your show to be indexed is for you to describe in the associated text what you say in the audio.</li>
      <li><strong>They make your show accessible to the deaf and hard of hearing.</strong><br>
        Your audio is completely inaccessible to those who have hearing problems, 
        so the only way for your show to be of help to them is if you distill the essence of the show into the show notes. 
        If you are using a script to prepare your show then include that.</li>
      <li><strong>Adding the shownotes</strong>
        <ul>
          <li>Add text and use the WYSIWYG editor buttons to add additional formatting</li>
          <li>Optionally - You can paste in <strong>Rendered</strong> HTML</li>
          <li><strong>Do not paste un-rendored markup (HTML, Markdown,
              RestructuredText)</strong> unless your intention is to have un-rendored
            markup as shownotes.</li>
        </ul>
      </li>
    </ul>
  </li>
  <li id="series"><strong>Series:</strong> <em>Optional</em><br>
      Select the <a href="<!--% absolute_url(baseurl) %-->series/index.html">series</a> if any that your show is a part of.</li>
  <li id="tags"><strong>Tags:</strong> <em>Optional</em><br>
      Add a list of comma separated tags. Pick the most important words from the shownotes. 
      These are used to <a href="<!--% absolute_url(baseurl) %-->tags.html">find shows via the tags page</a>.</li>
  <li id="upload_method"><strong>Upload Method:</strong> <em>Optional</em><br>
      You have the choice of the following options:<br>
      <ul>
        <li id="browser"><strong>Upload now via this browser</strong><br>
          You can upload single or multiple files using this method. 
          Chrome will display the percentage uploaded but to see this in Firefox you will need to install a 
          <a href="https://addons.mozilla.org/en-US/firefox/addon/uploadprogress/">plugin</a>, or just wait.
        </li>
        <li id="url"><strong>Provide a url for us to get it from</strong><br>
          Using this option may cause delays as a HPR volunteer will need to troubleshoot any issues that may occur, 
          and this can result in your show not been posted on time. 
          This must be publicly accessable using a curl or wget command. 
          Please avoid services that require login or downloading via a browser.
        </li>
        <li id="upload_later"><strong>Other</strong><br>
          The postal information will be sent to you after submission.
        </li>
      </ul>
      <br>
      If you want to submit an additional file with your show, then put them in a zip, or tgz file. 
      This should expand to a directory with a index.html file that refers to the other files. 
      This will be hosted in the eps directory under a new directory with the episode number.
      <pre>
    <!--% absolute_url(baseurl) %-->eps/hpr9999/full_shownotes.html
    <!--% absolute_url(baseurl) %-->eps/hpr9999/other-file.pdf
    <!--% absolute_url(baseurl) %-->eps/hpr9999/yet-other-file.c
    ...
      </pre>
      Ensure that all links are full urls, as relative urls will not work in RSS feeds. 
      Adding additional files will delay processing as they need to be verified manually.</li>
  </li>
 </ul>
 <p>
 Press submit and your show will be sent to the HPR Volunteers to be processed. 
 Keep an eye on the <a href="<!--% hub_baseurl %-->calendar.php">calendar</a> for when it is posted.
 Your show information is used to process the media files, on the website, in the RSS feeds, and on social media sites.
 </p>
 </article>
 <hr class="no-css">
 <article>
  <header>
    <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
    <h1 id="workflow">Workflow</h1>
  </header>
 <ol>
  <li>REQUEST_UNVERIFIED    - </li>
  <li>REQUEST_EMAIL_SENT    - email sent</li>
  <li>EMAIL_LINK_CLICKED    - pending upload</li>
  <li>SHOW_SUBMITTED        - upload complete</li>
  <li>METADATA_PROCESSED    - shownotes.{json,txt} processed to html</li>
  <li>SHOW_POSTED           - show in the database</li>
  <li>MEDIA_TRANSCODED      - audio all generated</li>
  <li>UPLOADED_TO_IA        - on the IA and visible</li>
  <li>UPLOADED_TO_RSYNC_NET - archived on rsync.net</li>
 </ol>
 </article>
 <hr class="no-css">
 <article>
  <header>
    <p class="index-link"><a href="/contribute.html#TOP">↑ Go to top</a></p>
    <h1 id="faq">Frequently Asked Questions</h1>
  </header>
 <h2 data-number="0.2" id="what-is-a-show"><span class="header-section-number">0.2</span> What is a show?</h2>
 <ul>
  <li><p>A show is your <em>audio</em> presentation (which we do not moderate), 
    with an <em>intro</em>, <em>outro</em>, a <em>title</em> and a <em>summary</em>.</p></li>
  <li><p>The <em>audio</em> is the recording you have made and sent in to HPR.</p></li>
  <li><p>The <em>intro</em> (introduction) is a piece of audio introducing the show. The components are:</p>
    <ul>
      <li>a synopsis taken from the details submitted with the show (added automatically)</li>
      <li>acknowledgement of our hosting provider (added automatically)</li>
      <li>HPR introduction music (added automatically)</li>
    </ul></li>
    <li><p>The <em>outro</em> is added automatically. It contains the HPR outro music.</p></li>
    <li><p>Each show needs a <em>title</em> to describe what it is about.</p></li>
    <li><p>Similarly, a <em>summary</em> helps to add more information describing the show so a potential listener 
      can decide whether to listen to it or not.</p></li>
    <li><p>Each show is expected to have certain mandatory attributes listed 
      <a href="<!--% absolute_url(baseurl,'contribute.html#what-are-the-mandatory-elements-of-an-hpr-show') %-->">below</a>.</p></li>
    <li><p>HPR shows are usually expected to be informative or educational, and as such some sort of accompanying written material 
      is highly desirable. This might consist of brief notes, links to relevant web sites, or possibly longer notes 
      and examples. Photographs, diagrams and example files are also welcome if the host feels 
      it helps to get the message across.</p></li>
    <li><p>Shows are released under a <a href="">Creative Commons Attribution-ShareAlike 3.0 Unported</a> license. 
      See <a href="<!--% absolute_url(baseurl,'contribute.html#stuff_you_need_to_know') %-->"><em>Stuff you need to know</em></a> 
      for much more detail about this and related issues.</p></li>
    <li><p>As a contributor you can choose when your show will be released. 
      We only release one show a day, during week days,
      but if a slot is free you can claim it. Go to the <a href="<!--% hub_baseurl %-->calendar.php"><em>calendar</em></a> 
      page to do this. You need to have your show ready to upload before you reserve a slot though.</p></li>
 </ul>
 <h2 data-number="0.4" id="what-defines-a-show-as-being-produced-for-hacker-public-radio"><span class="header-section-number">0.4</span> 
  What defines a show as being "<em>Produced for Hacker Public Radio</em>"?</h2>
 <ul>
  <li>If you create material and post it first on HPR then it meets the requirements of "<em>being produced for HPR</em>". 
    That means once you upload it to the HPR server you can publish it anywhere else you like.</li>
 </ul>
 <h2 data-number="0.5" id="what-are-the-mandatory-elements-of-an-hpr-show"><span class="header-section-number">0.5</span> 
  What are the mandatory elements of an HPR show?</h2>
 <ul>
  <li><p>See <a href="<!--% absolute_url(baseurl,'contribute.html#requesting_slot') %-->"><em>Picking a slot for your show</em></a> 
    for the full details of how to submit a show and what information is required.</p></li>
  <li><p>A quick summary of the main components is:</p>
    <ul>
      <li>A show title</li>
      <li>A summary of what the show is about</li>
      <li>The <em>explicit</em>/<em>clean</em> flag</li>
      <li>License</li>
      <li>Show notes</li>
      <li>Tags</li>
      <li>Audio</li>
    </ul></li>
 </ul>
 <h2 data-number="0.6" id="what-are-tags"><span class="header-section-number">0.6</span> What are tags?</h2>
 <ul>
  <li><p>We are trying to maintain a collection of tags to allow people to find shows on the same (or similar) topic.</p></li>
  <li><p>Tags are simple words or short phrases describing aspects of a show such as what topics are covered in it. 
    To get hints about what tags have already been used you can view all the current tags in alphabetical order on this page: 
    <a href="<!--% absolute_url(baseurl) %-->tags.html">Tag summary</a></p></li>
  <li><p>Some examples are: <b>android</b>, <b>creative commons</b> and <b>gaming</b>.</p></li>
  <li><p>Are there any tags that are best avoided?</p></li>
 </ul>
 <h2 data-number="0.7" id="is-it-ok-if-i-dont-include-notes-with-my-show') %-->"><span class="header-section-number">0.7</span> 
  Is it OK if I don't include notes with my show?</h2>
 <ul>
  <li><strong>Please don't do that</strong>. It is important to provide good show notes for reasons described on the 
    <a href="<!--% absolute_url(baseurl,'contribute.html#requesting_slot') %-->"><em>Picking a slot for your show</em></a> page:
    <ul>
      <li>They provide the listeners with more information on the topic your show is covering</li>
      <li>They ensure your show gets posted on time (the volunteers don't have to make notes for you)</li>
      <li>They encourage people to download your show</li>
      <li>They allow your show to be indexed by search engines</li>
      <li>They make your show accessible to the deaf and hard of hearing</li>
    </ul></li>
 </ul>
 <h2 data-number="0.8" id="how-do-i-include-photographs-or-other-files-with-my-show"><span class="header-section-number">0.8</span> 
  How do I include photographs or other files with my show?</h2>
 <ul>
  <li>TBA</li>
 </ul>
 <h2 data-number="0.9" id="what-is-and-is-not-edited-in-a-show-after-submission"><span class="header-section-number">0.9</span> 
  What is and is not edited in a show after submission?</h2>
 <ul>
  <li><p>We don't listen to the audio before posting a show to the website, so we don't change the content.</p></li>
  <li><p>Unless you have done so and told us you have, we add an introduction to the audio announcing what it is. 
    Similarly we add an <em>outro</em>. This is not <u>editing</u> since we don't change the content.</p></li>
  <li><p>We may make changes to the show title, summary or tags. Usually these are minor changes such as spelling corrections. 
    The intention is not any sort of censorship, merely to make these items more understandable or easier to index.</p></li>
  <li><p>Depending on the form the show notes take we may modify these.</p>
    <ul>
      <li>If what is submitted is plain text we convert it to Markdown in order to generate HTML.</li>
      <li>If the notes are one of the permitted markup formats (mostly Markdown flavours) we may adjust this to ensure 
        that valid HTML is generated.</li>
      <li>If the notes are HTML we run them through an HTML checker and correct any mistakes it highlights.</li>
      <li>We may correct spelling, grammar and punctuation if this clarifies anything which might otherwise be unclear.</li>
      <li>If despite the request for show notes of some kind, none are provided, we may add notes which help to clarify 
        the content of the show. This may be done after the show is released (when we have had a chance to listen to it).</li>
    </ul></li>
    <li><p>We are working on the production of reports about any changes made, which will be sent to the host after we have 
      processed the show.</p></li>
    <li><p>We may make changes to a show's metadata if the host requests it (see the item on 
      <a href="<!--% absolute_url(baseurl,'contribute.html#if-i-notice-an-error-in-my-shows-details-how-can-it-be-fixed') %-->">
        fixing errors after upload</a>).</p></li>
    <li><p>If a show contains links to resources which disappear after a period of time, we may at some future time change 
      the notes to refer to any <em>Wayback Machine</em> copy that can be found.</p></li>
 </ul>
 <h2 data-number="0.10" id="what-are-some-common-errors-in-show-notes"><span class="header-section-number">0.10</span> 
  What are some common errors in show notes?</h2>
 <p>It depends on the note format to some extent:</p>
 <h3 data-number="0.10.1" id="html-notes"><span class="header-section-number">0.10.1</span> HTML notes</h3>
 <ul>
  <li><p>It's very easy to hand-write bad HTML. That's why we use an HTML checker on it, and fix the errors it reports.</p></li>
  <li><p>A common fault is to write <code>&lt;code&gt;&lt;pre&gt;</code> to define a pre-formatted block of text using a fixed-width font. 
    However it's illegal because the <code>&lt;pre&gt;</code> tag can't be enclosed in other tags like 
    <code>&lt;code&gt;</code>. Use <code>&lt;pre&gt;&lt;code&gt;</code> instead.</p></li>
 </ul>
 <h3 data-number="0.10.2" id="markdown-notes"><span class="header-section-number">0.10.2</span> Markdown notes</h3>
 <ul>
  <li>This is quite a forgiving format. Some people embed HTML in the Markdown, and the HTML used suffers from some 
    of the issues discussed in this document. These are <em>much</em> harder to spot. The HTML checker can't 
    really help unless it's run on the output from Pandoc.</li>
 </ul>
 <h3 data-number="0.10.3" id="general-errors"><span class="header-section-number">0.10.3</span> General errors</h3>
 <ul>
  <li><p>Spelling is often an issue in notes. As the notes are processed they are edited in the Vim editor with the 
    spell check option turned on. In most cases spelling problems flagged by Vim are corrected.</p></li>
  <li><p>Grammar and punctuation can also be issues. We do not have very effective grammar checking tools in the note 
    preparation workflow. Modifications may be made to split up extra-long (often <em>comma-spliced</em>) sentences, 
    rationalise the use of capital letters and similar.</p></li>
 </ul>
 <h2 data-number="0.11" id="if-i-notice-an-error-in-my-shows-details-how-can-it-be-fixed"><span class="header-section-number">0.11</span> 
  If I notice an error in my show's details how can it be fixed?</h2>
 <ul>
  <li><p>The HPR administrators can make changes to show titles, summaries, notes and so forth. Ideally send an 
    email to <code>admin</code> at <code><!--% make_sfw(is_sfw, "hobby", "hacker") %-->publicradio.org</code> explaining what the problem is and we'll fix it for you. 
    We'll also ensure that the changes are propagated to the relevant page on archive.org.</p></li>
  <li><p>Don't be tempted to send in your corrections as a comment. Comments are not propagated to archive.org, so people 
    referring to that copy will not see the changes.</p></li>
 </ul>
 <h2 data-number="0.12" id="does-hobbypublicradio.com-have-anything-to-do-with-hpr"><span class="header-section-number">0.12</span> 
  Does <code>hobbypublicradio.com</code> have anything to do with HPR?</h2>
 <ul>
  <li><p>Some environments prevent access to sites which use the word <code>'hacker'</code> or <code>'hackers'</code> 
    in their names (or content in extreme cases). The site names <code>hobbypublicradio.{com,net,org}</code> have been created, 
    which link to the main HPR site, in order to get around this restriction.</p></li>
  <li><p>See the mailing list thread here: 
    <a href="https://lists.hackerpublicradio.com/pipermail/hpr/2015-February/002493.html" class="uri">
      https://lists.hackerpublicradio.com/pipermail/hpr/2015-February/002493.html</a></p></li>
 </ul>
 <h2 data-number="0.13" id="how-can-i-talk-to-other-hpr-hosts-and-listeners"><span class="header-section-number">0.13</span> 
  How can I talk to other HPR hosts and listeners?</h2>
 <ul>
  <li>You have a number of choices:
    <ul>
      <li>The mailing list <a href="mailto:hpr@hackerpublicradio.org" class="email">hpr@hackerpublicradio.org</a> is where various 
        policy matters are discussed and announcements made. You need to be a member of the list to post to it. 
        Visit the <a href="<!--% absolute_url(baseurl,'/maillist') %-->" ><em>listinfo page</em></a> to sign up.</li>
      <li>You can join the <strong>#oggcastplanet</strong> channel on IRC. 
        Visit the <a href="http://webchat.freenode.net/?channels=oggcastplanet">freenode.net</a> network to sign up.</li>
      <li>A number of HPR messages may be found on Twitter and 
        <a href="https://infosec.exchange/@hpr">Mastodon</a>.</li>
      <li>There is a <a href="https://t.me/+6fEhQrf5IEc4ZGU8">chat group on Telegram</a></li>
      <li>An HPR tradition exists where we record a 26-hour show at the turn of the year celebrating the 
        arrival of the New Year around the world. We use Mumble to record the show and anyone can connect 
        to the Mumble server and speak to other HPR listeners and hosts. The recording is used to make multiple 
        shows which are released when they are ready.</li>
    </ul></li>
 </ul>
 <h2 data-number="0.15" id="faq_anonymous_post"><span class="header-section-number">0.15</span> I'd like to post a show but I would 
  rather not have my email address published on the site.?</h2>
 <p>
 The mail is just a way for us to get back to you if there was an issue posting the show.
 </p>
 <p>
 If you trust the janitors to know your real email we can just use an alias for you on the web site and have it 
 forward the email to you automatically. That runs the risk that were the redirect list compromised then your 
 real email would get exposed. 
 </p>
 <p>
 If you prefer, we can use the janitor email for your shows with your own host id. Then if any emails come in we can manually 
 forward them at some point. The risk is that you are trusting the janitors to protect your email but again it could be compromised.
 </p>
 <p>
 In both cases we would do our best to protect your email but we can't guarantee anything.
 </p>
 <p>
 The other option is to use an a throwaway email, like <a href="https://www.guerrillamail.com/">https://www.guerrillamail.com/</a> 
 for your show. This will be up for enough time to get the key necessary for to post the show. 
 However keep in mind that we will be very suspicious of any submission done this way and will be checking it in detail, 
 so expect delays in processing.
 </p>
 </article>
 </div>
@@ -18,6 +18,7 @@
 			<!--% hosts = DBI.tie('hosts', 'hostid') %-->
 			<!--% this_host = hosts.$id %-->
 			<!--% page_title = "HPR ~ Host: " _ this_host.host %-->
 			<h2 class="title">Correspondent</h2>
 			<div id="host" class="lane">
 				<div id="host_id">
@@ -1,5 +1,6 @@
 <!--% PROCESS 'shared-utils.tpl.html' %-->
 <!--% PROCESS 'shared-avatar.tpl.html' %-->
 <!--% page_title = "HPR ~ Hosts/Correspondents" %-->
 	<h2 class="title">Correspondents</h2>
 	<p>For more information on how to become a Correspondent see our <a href="<!--% absolute_url(baseurl) %-->../about.html#so_you_want_to_record_a_podcast">contribute</a></center> page. To add a logo here, either email one to admin at hpr or setup your email on <a href="https://en.gravatar.com/">Gravatar</a>. To protect your browsing privacy we gather the images every hour and serve them directly from HPR.<p />
 <!--% USE DBI(constants.driver) %-->
@@ -1,3 +1,4 @@
 <!--% page_title = "HPR ~ Download all the episodes" %-->
 <article>
 	<header>
        <h1>Download Archive</h1>
@@ -10,6 +10,7 @@
 <!--% FOREACH episode IN episode_result %-->
    <!--% in_window = ( episode.id > episode.latest || episode.id < ( episode.latest - 20 ) ? 0 : 1 ) %-->
 <!--% episode_navigation = step_navigation(baseurl,episode) %-->
 <!--% page_title = "HPR" _ zero_pad_left(episode.id) _ "::" _ episode.title %--> 
 <article>
 	<header>
 		<h1>hpr<!--% zero_pad_left(episode.id) %--> :: <!--% episode.title %--></h1>
@@ -1,5 +1,6 @@
 <!--% PROCESS 'shared-episode-summary.tpl.html' %-->
 <!--% PROCESS "queries-episodes.tpl.html" %-->
 <!--% page_title = "HPR ~ All the shows" %-->
 	<h1>Complete Archive of Shows.</h1>
        <p>
        All this information is available to the public. Scrape if you wish but if we can format the data for you then we're happy to help.
@@ -1,19 +1,4 @@
 <!--% PROCESS 'shared-utils.tpl.html' %-->
-<div class="lane stack">
+<!--% IF date.format(date.now, '%m') == 11 || date.format(date.now, '%j') == 1 %-->
-	<article>
+	<!--% PROCESS 'content-new_year_show_announcement.tpl.html' %-->
-		<header>
+<!--% END %-->
 			<h2 class="title"><a href="/eps/hpr3246/index.html">The Fourteenth Annual 26 Hour New Year's Eve Show</a> 	</h2>
 		</header>
 		<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 Year's Eve 2025-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 Year" and talk about whatever they want. 
 		We will leave the recording going until at least 2026-01-01 12:00 UTC (7:00 AM EST), and keep recording until the conversation stops.</p>
 		<p>
 		So please stop in. Say "Hi" and maybe join in the conversation with other HPR listeners and contributors. It's always a good time!!<br>
 		<a href="https://hackerpublicradio.org/eps/hpr3246/index.html">More Information…</a>
 		</p>
 	</article>
 </div>
@@ -35,8 +35,8 @@
 	<!--% delta = date.calc.N_Delta_YMD(2005,9,19, date.format(date.now, '%Y'),date.format(date.now, '%m'),date.format(date.now, '%d')) %-->
 	<section id="welcome">
-		<p>Hacker Public Radio is a technology focused podcast that releases shows every weekday Monday to Friday. Our shows are produced by listeners like you and can be on any topic that is of interest to hackers, makers, hobbyists, etc. We are a welcoming community that offers positive feedback and encourages respectful debate.</p>
+		<p><!--% make_sfw(is_sfw, "Hobby", "Hacker") %--> Public Radio is a technology focused podcast that releases shows every weekday Monday to Friday. Our shows are produced by listeners like you and can be on any topic that is of interest to <!--% make_sfw(is_sfw, "hobbyists", "hackers, hobbyists") %-->, makers, etc. We are a welcoming community that offers positive feedback and encourages respectful debate.</p>
-<!--% INCLUDE 'content-index-announcement.tpl.html' %-->
+<!--% PROCESS 'content-index-announcement.tpl.html' %-->
 		<div id="call_for_shows">
 			<!--% display_call_for_shows() %-->
 		</div>
@@ -44,7 +44,7 @@
  <section id="podcast_lane">
 	  <header><h2>The Podcast</h2></header>
 	  <div class="lane">
-	  <a class="lane-button" href="<!--% absolute_path(baseurl) %-->about.html#recording_a_podcast">
+	  <a class="lane-button" href="<!--% absolute_path(baseurl) %-->contribute.html">
 			<img src="<!--% absolute_path(baseurl) %-->images/icons/mic-fill.svg" alt="" height="110">
 			<p>Record</p>
 	  </a>
@@ -0,0 +1,112 @@
 <!--% PROCESS 'shared-utils.tpl.html' %-->
 <h1><u>The <!--% get_new_year_show_ordinal_year %--> Annual 26 Hour New Year's Eve Show</u></h1>
 <h2>Welcome every <a href="https://www.timeanddate.com/counters/multicountdown.html">TimeZone</a>!</h2>
 <p>
 <em>If you keep talking, we'll keep recording.</em>
 </p>
 <p>For those who don't know, on New Year's Eve <!--% get_new_year_show_start() %-->, we will have a recording going on the HPR Mumble server for anyone to come on and say "Happy New Year" and talk about whatever they want. 
 We will leave the recording going until at least <!--% get_new_year_show_end() %-->, and keep recording until the conversation stops.</p>
 <p>
 So please stop in. Say "Hi" and maybe join in the conversation with other HPR listeners and contributors. It's always a good time!!<br />
 </p>
 <h1>Listen to the live stream</h1>
 <p>
 <!--% IF ((date.format(date.now, '%m') == 12 && date.format(date.now, '%d') > 28) || date.format(date.now, '%j') == 1) %-->
 	<img src="images/livestream.png" /><br />
 	<audio controls autoplay>
 		<source src="https://files.shownotes.ooguy.com/stream" type="audio/mpeg" >
 	</audio> <br />
 	<a href="https://files.shownotes.ooguy.com/stream">https://files.shownotes.ooguy.com/stream</a><br />
 	<a href="https://hackerpublicradio.org/live">https://hackerpublicradio.org/live</a><br />
 <!--% ELSE %-->
 	<audio controls preload="none">
 		<source src="<!--% absolute_path(baseurl) %-->promos/hpr-nye-promo.ogg" type="audio/ogg">
 	</audio>
 <!--% END %-->	
 </p>
 <h1>Join the conversation on Mumble</h1>
 <h2>Ground Rules</h2>
 <h3>Use Push to Talk, and a Headset</h3>
 <p>With so many people on the chat, you must use push to talk. 
 You also need to use a Headset so the audio of the room is not fed back. 
 If there is a problem with your setup, then please drop and listen to the stream. 
 Trying to correct poor audio in post is a lot of work, that someone else will have to do.</p>
 <h3>Be Polite</h3>
 <p>When you enter the room please do not interrupt ongoing conversations. 
 Wait for a pause in the conversation and say Hi.
 It's quite common for people you might not know to join as they wish to speak with other people in the room. 
 They may have been waiting all year for the chance to meet, so please give people the space to have these conversations.</p>
 <h3>Do not announce the Time Zones</h3>
 <p>As there are so <a moz-do-not-send="true" href="https://en.wikipedia.org/wiki/Time_zone">many Time Zones</a> there is no need to interrupt the conversation to announce every one. 
 If you are joining from a time zone that is currently switching to the New Year, then please wait for a pause and wish people Happy New Year.</p>
 <h3>Don't Fill Dead Air</h3>
 <p>This is a relaxed meet-up, and not a traditional "Radio Broadcast". 
 If there are no conversations going on at a given time, don't feel the need to "fill dead air". 
 Before the recording is posted as a podcast the <a href="https://manual.audacityteam.org/man/truncate_silence.html">silences will be truncated</a>.</p>
 <h3>Do not monopolise the conversation</h3>
 <p>Please be mindful that you (or your beverage of choice) may be speaking too much ;-).</p>
 <h3>You are a Guest</h3>
 <p>Be respectful, and remember that attendance on the New Year Show does not <a href="https://hub.hackerpublicradio.org/calendar.php">constitute a show</a>.</p>
 <h3>CC-BY-SA</h3>
 <p>The recording will be released as a podcast on HPR under a <a rel="license" href="https://creativecommons.org/licenses/by-sa/4.0/"> Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</a> license. 
 The recordings will be released mid year, when there is a lull in submissions.</p>
 <h2>Mumble Setup</h2>
 <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 />
 <p>Get the Android Client Mumla <a href="https://f-droid.org/packages/se.lublin.mumla">https://f-droid.org/packages/se.lublin.mumla</a></p>
 <p>Then join the Server: <strong>chatter.skyehaven.net</strong><br />
 Port: <strong>64738</strong><br />
 Channel: <strong>HPR</strong></p>
 <p><strong>Use Push to Talk</strong>. With so many people hands free is not an option.</p>
 <p>For those who have never used Mumble before, see this <a href="https://hackerpublicradio.org/mumble-howto">how-to explaining the setup of the desktop Mumble client</a>, 
 or listen to <a href="https://hackerpublicradio.org/eps.php?id=3503">hpr3503 :: Configuring Mumble</a>.</p>
 <h3>Video Only (no audio) server</h3>
 <p>
 For those who wish to see the video of some of the participants we have a jitsi server.<br />
 <a href="https://jitsi.minnix.dev/hprnye">https://jitsi.minnix.dev/hprnye</a><br />
 <strong>Please make sure your mic is muted!</strong>
 </p>
 <h3>Add to the Show-notes</h2>
 <p>
 <strong>Please help fill out the show notes</strong><br />
 <a href="https://shownotes.lugcast.mywire.org/p/hpr-nye-2026">https://shownotes.lugcast.mywire.org/p/hpr-nye-2026</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>
 <h2>History</h2>
 <p>Suggested by <a href="https://hackerpublicradio.org/correspondents/0128.html">pokey</a> in 2011.
 As podcasting tends to be a one way conversation, he thought it would be nice to get all the FLOSS, Linux, Free Culture, podcasters and Listeners in one place to get together and chat in person.
 Initially it was planned to be just a few hours, but we kept missing members from other parts of the world. 
 The show was extended to welcome ever time zone to the New Year, which actually turns out to be <a href="https://en.wikipedia.org/wiki/List_of_UTC_offsets">38 Timezones</a>, over 26 Hours.</p>
 <p>So we will record for at least 26 Hours, but will keep the recording going for an "After Show".
 Some years the after show has been even longer than the show itself.
 While this is on the HPR Site, it is entirely a community initiative which is supported heavily by the fine folks over at the <a href="https://linuxlugcast.com/">LinuxLugCast</a>, with the Mumble Server been provided by <a href="https://hackerpublicradio.org/correspondents/0228.html">Delwin</a>.</p>
@@ -0,0 +1,30 @@
 <!--% PROCESS 'shared-utils.tpl.html' %-->
 <div class="lane stack">
 	<article>
 		<header>
 			<h2 class="title"><a href="<!--% absolute_path(baseurl) %-->new_year.html">The <!--% get_new_year_show_ordinal_year %--> Annual 26 Hour New Year's Eve Show</a></h2>
 		</header>
 		<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 Year's Eve <!--% get_new_year_show_start() %-->, we will have a recording going on the HPR Mumble server for anyone to come on and say "Happy New Year" and talk about whatever they want. 
 		We will leave the recording going until at least <!--% get_new_year_show_end() %-->, and keep recording until the conversation stops.</p>
 		<p>
 		So please stop in. Say "Hi" and maybe join in the conversation with other HPR listeners and contributors. It's always a good time!!<br>
 <!--% IF date.format(date.now, '%m') == 11 || date.format(date.now, '%d') < 29 %-->
 		<audio controls preload="none">
 			<source src="<!--% absolute_path(baseurl) %-->promos/hpr-nye-promo.ogg" type="audio/ogg">
 		</audio>
 <!--% ELSE %-->
 		<img src="images/livestream.png" /><br />
 		<audio controls autoplay>
 			<source src="https://files.shownotes.ooguy.com/stream" type="audio/mpeg" >
 		</audio> <br />
 		<a href="https://files.shownotes.ooguy.com/stream">https://files.shownotes.ooguy.com/stream</a><br />
 		<a href="https://hackerpublicradio.org/live">https://hackerpublicradio.org/live</a><br />
 <!--% END %-->	
 		</p>
 		<p><a href="<!--% absolute_path(baseurl) %-->new_year.html">More information…</a></p>
 	</article>
 </div>
@@ -1,3 +1,4 @@
 <!--% page_title = "HPR ~ Find a show" %-->
 <section id="search">
 	<header>
 		<h1>Search HPR.</h1>
@@ -1,6 +1,7 @@
 <!--% PROCESS 'shared-utils.tpl.html' %-->
 <!--% PROCESS "queries-series.tpl.html" %-->
 <!--% USE DBI(constants.driver) %-->
 <!--% page_title = "HPR ~ Show series" %-->
 <h1 class="title">In-Depth Series</h1>
 <div class="lane stack">
 <!--% FOREACH series IN DBI.query(query_episodes) %-->
@@ -6,6 +6,7 @@
 %-->
 <!--% series_result = query_series.execute(id) %-->
 <!--% FOREACH series IN series_result %-->
 <!--% page_title = "HPR ~ Series: " _ series.name %-->
 <h1 class="title">In-Depth Series: <!--% series.name %--></h1>
 <ul>
 	<li>Number of episodes: <!--% series.number_of_episodes %--></li>
@@ -1,4 +1,5 @@
 <!--% PROCESS 'shared-utils.tpl.html' %-->
 <!--% page_title = "HPR ~ Sitemap" %-->
 <h1>Sitemap</h1>
  <ul>
    <li><a href="<!--% hub_baseurl %-->calendar.php"><strong>⇧Upload⇧</strong></a> ← Upload Your Show</li>
@@ -1,3 +1,4 @@
 <!--% page_title = "HPR ~ Subscribe to our feeds" %-->
 <h1>RSS Syndication</h1>
    <h2>Subscribe to our Feeds</h2>
  <p>
@@ -51,9 +52,9 @@
    Use this feed to get the archived episodes. The feed themselves run over 15Mb in size and so use them to download the archived episodes and when you are up to date switch back to the Two Week Feeds listed above.
  </p>
  <ul>
-    <li><a href="<!--% absolute_path(baseurl) %-->hpr_total_opus_rss.php">opus feed</a> Warning over 62G</li>
+    <li><a href="<!--% absolute_path(baseurl) %-->hpr_total_opus_rss.php">opus feed</a> Warning over 64G</li>
-    <li><a href="<!--% absolute_path(baseurl) %-->hpr_total_ogg_rss.php">ogg feed</a> Warning over 71G</li>
+    <li><a href="<!--% absolute_path(baseurl) %-->hpr_total_ogg_rss.php">ogg feed</a> Warning over 68G</li>
-    <li><a href="<!--% absolute_path(baseurl) %-->hpr_total_rss.php">mp3 feed</a> Warning over 70G</li>
+    <li><a href="<!--% absolute_path(baseurl) %-->hpr_total_rss.php">mp3 feed</a> Warning over 72G</li>
  </ul>
 </article>
 <article>
@@ -133,5 +134,7 @@
  <li>mp3:<br>
  <code>curl '<!--% absolute_path(baseurl) %-->eps/hpr[0001-<!--% episode.latest %-->].mp3' -o "hpr#1.mp3"</code></li>
  </ul>
 </article>
 </div>
@@ -46,6 +46,7 @@
 <!--% episode_result = query_episodes.execute(id, id, id, id, id) %-->
 <!--% FOREACH episode IN episode_result %-->
 <!--% episode_navigation = step_navigation(baseurl,episode,"twt") %-->
 <!--% page_title = "TWT" _ episode.id _ "::" _ episode.title %-->
 <article>
 	<header>
 		<h1><!--% episode.id %--> :: <!--% episode.title %--></h1>
@@ -1,9 +1,18 @@
 <!--% PROCESS 'shared-utils.tpl.html' %-->
 <!--% USE date %-->
 <!--% page_title = make_sfw(is_sfw, "Hobby", "Hacker") _ " Public Radio (HPR) ~ The Technology Community Podcast" %-->
 <!--% WRAPPER page 
 		# The default page_title variable set above can be overridden
 		# in each individual $content template (i.e. templates/conten-<template name>.tpl.html)
 		# processed below.
 %-->
 	<!--% PROCESS $content %--> 
 <!--% END %-->
 <!--% BLOCK page %-->
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-  <title>Hacker Public Radio ~ The Technology Community Podcast</title>
+	<title><!--% page_title %--></title>
  <!--% IF baseurl %-->
  <base href="<!--% baseurl %-->">
  <!--% END %-->
@@ -11,12 +20,12 @@
  <meta http-equiv="X-Clacks-Overhead" content="GNU Terry Pratchett" />
  <meta http-equiv="last-modified" content="<!--% format_feed_date(date.now) %-->">
  <meta name="keywords" content="Technology, Tech News, Education, Training" />
-  <meta name="description" content="Hacker Public Radio is a podcast that releases shows every weekday Monday through Friday. Our shows are produced by the community (you) and can be on any topic that is of interest to hackers and hobbyists." />
+  <meta name="description" content="<!--% make_sfw(is_sfw, "Hobby", "Hacker") %--> Public Radio is a podcast that releases shows every weekday Monday through Friday. Our shows are produced by the community (you) and can be on any topic that is of interest to <!--% make_sfw(is_sfw, "makers", "hackers") %--> and hobbyists." />
-  <link rel="shortcut icon" href="/hpr.ico" >
+  <link rel="shortcut icon" href="<!--% absolute_url(baseurl) %-->hpr.ico" >
-  <link rel="alternate" type="application/rss+xml" title="Hacker Public Radio Opus RSS" href="<!--% absolute_path(baseurl) %-->hpr_opus_rss.php" />
+  <link rel="alternate" type="application/rss+xml" title="<!--% make_sfw(is_sfw, "Hobby", "Hacker") %--> Public Radio Opus RSS" href="<!--% absolute_path(baseurl) %-->hpr_opus_rss.php" />
-  <link rel="alternate" type="application/rss+xml" title="Hacker Public Radio Ogg Vorbis RSS" href="<!--% absolute_path(baseurl) %-->hpr_ogg_rss.php" />
+  <link rel="alternate" type="application/rss+xml" title="<!--% make_sfw(is_sfw, "Hobby", "Hacker") %--> Public Radio Ogg Vorbis RSS" href="<!--% absolute_path(baseurl) %-->hpr_ogg_rss.php" />
-  <link rel="alternate" type="application/rss+xml" title="Hacker Public Radio MP3 RSS" href="<!--% absolute_path(baseurl) %-->hpr_mp3_rss.php" />
+  <link rel="alternate" type="application/rss+xml" title="<!--% make_sfw(is_sfw, "Hobby", "Hacker") %--> Public Radio MP3 RSS" href="<!--% absolute_path(baseurl) %-->hpr_mp3_rss.php" />
-  <link rel="alternate" type="application/rss+xml" title="Hacker Public Radio Comments RSS" href="<!--% absolute_path(baseurl) %-->comments.rss" />
+  <link rel="alternate" type="application/rss+xml" title="<!--% make_sfw(is_sfw, "Hobby", "Hacker") %--> Public Radio Comments RSS" href="<!--% absolute_path(baseurl) %-->comments.rss" />
  <link rel="license" title="CC BY-SA 4.0"  href="https://creativecommons.org/licenses/by-sa/4.0/" />
  <link href="/css/hpr.css" rel="stylesheet" />
  <!--[if IE]>
@@ -41,7 +50,7 @@
  <hgroup id="title">
 	  <h1 id="site_acronym"><a href="<!--% absolute_path(baseurl) %-->index.html">HPR</a></h1>
      <p id="site_name">
-        <a href="<!--% absolute_path(baseurl) %-->correspondents/index.html">H</a>acker
+        <a href="<!--% absolute_path(baseurl) %-->correspondents/index.html">H</a><!--% make_sfw(is_sfw, "obby", "acker") %-->
        <a href="<!--% absolute_path(baseurl) %-->comments_viewer.html">P</a>ublic
        <a href="<!--% absolute_path(baseurl) %-->syndication.html">R</a>adio
      </p>
@@ -54,7 +63,8 @@
 </div>
 </header>
 <main id="main_content" role="main">
-<!--% INCLUDE $content %-->
+<!--% content %-->
 <!--% page_title = "acck" %-->
 </main>
 <footer role="contentinfo">
  <hr class="no-css">
@@ -70,3 +80,4 @@
 </footer>
 </body>
 </html>
 <!--% END %-->
@@ -134,3 +134,57 @@
    <!--% END %-->
 	<span><a href="<!--% absolute_path(baseurl) %-->eps/<!--% folder %--><!--% zero_pad_left(links.latest) %-->/index.html" rel="last" aria-label="latest episode">Latest<span class="no-css"> &gt;&gt;</span><!--% INSERT $arrow_last %--></a></span></nav>
 <!--% END %-->
 <!--% MACRO get_new_year_show_start BLOCK %-->
 <!--% start_year = date.format(date.now, '%Y') %-->	
 <!--% IF date.format(date.now, '%m') != 12 || date.format(date.now, '%j') == 1 %-->
 	<!--% start_year = start_year - 1 %-->
 <!--% END %-->
 	<time datetime="<!--% start_year %-->-12-31T10:00Z"><!--% start_year %-->-12-31 10:00 UTC (5:00 AM EST)</time>
 <!--% END %--> 
 <!--% MACRO get_new_year_show_end BLOCK %-->
 <!--% end_year = date.format(date.now, '%Y') %-->	
 <!--% IF date.format(date.now, '%m') == 12 || date.format(date.now, '%j') == 1 %-->
 	<!--% end_year = end_year + 1 %-->
 <!--% END %-->
 	<time datetime="<!--% end_year %-->-01-01T12:00Z"><!--% end_year %-->-01-01 12:00 UTC (7:00 AM EST)</time>
 <!--% END %-->
 <!--% MACRO get_new_year_show_ordinal_year BLOCK %-->
 <!--% ordinal_year = date.format(date.now, '%Y') - 2011 %-->
 <!--% IF date.format(date.now, '%m') != 12 || date.format(date.now, '%j') == 1 %-->
 	<!--% ordinal_year = ordinal_year - 1 %-->
 <!--% END %-->
 <!--% years.0 = 'th'
 	  years.1 = 'st'
 	  years.2 = 'nd'
 	  years.3 = 'rd'
 	  years.4 = 'th'
 	  years.5 = 'th'
 	  years.6 = 'th'
 	  years.7 = 'th'
 	  years.8 = 'th'
 	  years.9 = 'th'
 	  years.14 = 'Fourteenth'
 	  years.15 = 'Fifteenth' 
 	  years.16 = 'Sixteenth' 
 	  years.17 = 'Seventeenth' 
 	  years.18 = 'Eighteenth' 
 	  years.19 = 'Nineteenth' 
 	  years.20 = 'Twentieth'
 	  years.30 = 'Thirtieth'
 	  years.40 = 'Fortieth' 
 	  years.50 = 'Fiftieth' %-->
 <!--% index = ordinal_year % 10 %-->
 <!--% IF ordinal_year < 21 || (index == 0 && ordinal_year < 51) %-->
 	<!--% years.$ordinal_year %-->
 <!--% ELSE %-->
 <!--% ordinal_year %--><sup><!--% years.$index %--></sup>
 <!--% END %-->
 <!--% END %-->
 <!--% MACRO make_sfw(swf, sfw_text, nsfw_text) BLOCK %-->
 <!--% IF swf == 0 %--><!--% sfw_text %-->
 <!--% ELSE %--><!--% nsfw_text %-->
 <!--% END %--><!--% END %-->
Author	SHA1	Message	Date
rho_n	0eefb633a5	Merge pull request '[i335] docker image for site generator' (#336 ) from i335_docker-image-for-site-generator into main Reviewed-on: #336 Reviewed-by: norrist <norrist@josh@dao-mail.com>	2026-05-28 12:32:50 +00:00
rho_n	b246f2c70f	Merge branch 'main' into i335_docker-image-for-site-generator	2026-05-28 12:32:09 +00:00
ken_fallon	a7e1c2f050	Updating documentation	2026-05-28 13:28:49 +02:00
ken_fallon	640606b8ab	Updating documentation	2026-05-27 17:49:45 +02:00
ken_fallon	37bc952aa3	Updated about page	2026-05-27 09:36:07 +02:00
ken_fallon	a73c038743	Split out about and contribute	2026-05-26 07:45:28 +02:00
ken_fallon	47446fc385	Reordered about	2026-05-25 15:37:26 +02:00
ken_fallon	69dc0cf8f0	Adding policies to about page	2026-05-25 15:25:57 +02:00
ken_fallon	6e6467f51b	Fixed link	2026-05-25 14:48:38 +02:00
ken_fallon	138c2e7946	Update templates/content-about.tpl.html Add droops interview and add link to gittea	2026-05-25 11:20:58 +00:00
ken_fallon	8420bb75a3	Update templates/content-syndication.tpl.html	2026-05-24 08:20:41 +00:00
rho_n	e1be81a4ad	Fix Docker build instruction example	2026-05-19 13:57:26 -04:00
rho_n	fd577942e6	Update Docker build instructions	2026-05-17 19:31:49 -04:00
rho_n	3cc4a6b5d3	Fix cpanm call in run layer	2026-05-17 12:01:40 -04:00
rho_n	47b2c588b8	Add instructions for building and running Docker images	2026-05-17 11:39:40 -04:00
rho_n	5bdda3c1ef	Set env to perl Instead of calling perl directly from /usr/bin, set environment so that the current default perl program is called.	2026-05-17 10:32:04 -04:00
rho_n	7cea36879c	Add a Dockerfile which builds a site-generator app This builds the container with the needed Perl modules, templates, and a default configuration file.	2026-05-17 10:09:33 -04:00
rho_n	abd1937fb6	Merge pull request 'Toggle New Year show announcement' (#334 ) from i324_new-year-show-automation into main Reviewed-on: #334	2026-03-01 12:43:22 +00:00
rho_n	4750a08456	Toggle New Year show announcement Show link to promo audio between Nov 1 and Dec 28. Show link to live stream between Dec 29 and Jan 1.	2026-02-28 11:17:39 -05:00
rho_n	e56592152f	Merge pull request '[I332] Dynamically set page titles' (#333 ) from i332_Dynamically-set-page-titles into main Reviewed-on: #333	2026-02-03 00:08:38 +00:00
rho_n	5d4a7ad639	Merge branch 'main' into i332_Dynamically-set-page-titles	2026-02-02 19:03:46 -05:00
ken_fallon	6e07ee5e0a	Update templates/content-about.tpl.html There is now no limit	2026-02-02 08:58:43 +00:00
ken_fallon	bdf48827f0	Update site.cfg The logic seems to be switched https://en.wikipedia.org/wiki/Boolean_data_type where a 0 = true and 1 = false. Should this not be the other way around where 0 = false = off, and 1 = true = on. Setting default to 1 as the site is now switched to Hobby public radio, and the robot picks up the default config.	2026-02-02 08:54:43 +00:00
ken_fallon	27920e7b9f	Merge pull request 'Allow for generation of Hobby Public Radio' (#279 ) from i274-hacker-to-hobbyist into main Reviewed-on: #279	2026-02-01 15:18:45 +00:00
rho_n	a9b757232f	Add an individual html title to various pages	2026-01-31 14:16:44 -05:00
rho_n	ef4302f8d4	Allow html title to be set dynamically Each page content template can set a page_title variable.	2026-01-31 14:13:29 -05:00
rho_n	4e9bc7e6c2	Set config to generate hobbypublicradio	2026-01-30 16:16:32 -05:00
rho_n	8c70c83261	Update page template with selection for hobbypublicradio	2026-01-30 16:10:24 -05:00
rho_n	95ad45c6e3	Update about page with selection for hobbypublicradio	2026-01-30 16:09:19 -05:00
rho_n	9e711c6620	Merge branch 'main' into i274-hacker-to-hobbyist	2026-01-29 21:01:40 -05:00
ken_fallon	079b4be448	revert `988c6f8593` revert Update templates/content-index.tpl.html Try and hack in the new year show	2026-01-02 10:05:40 +00:00
ken_fallon	988c6f8593	Update templates/content-index.tpl.html Try and hack in the new year show	2026-01-01 10:28:56 +00:00
ken_fallon	b1da08572f	revert `dca0945932` revert Update templates/content-index.tpl.html The new year show is missing	2026-01-01 10:28:03 +00:00
ken_fallon	dca0945932	Update templates/content-index.tpl.html The new year show is missing	2026-01-01 10:21:49 +00:00
ken_fallon	63c25d2f19	Update templates/content-new_year.tpl.html More fixes	2025-12-30 12:35:48 +00:00
ken_fallon	c2ad703409	Update templates/content-new_year.tpl.html Ground rules are important	2025-12-30 12:28:59 +00:00
ken_fallon	b1f0420526	Update templates/content-new_year_show_announcement.tpl.html remove the prom	2025-12-30 12:25:35 +00:00
ken_fallon	175bf2dd57	Update templates/content-new_year_show_announcement.tpl.html Changes as we go live for nye show	2025-12-30 12:19:32 +00:00
ken_fallon	fbff5bc6a1	Update templates/content-new_year.tpl.html Updates to support new urls as we go live	2025-12-30 12:18:30 +00:00
rho_n	ea85c3de61	Merge pull request '[i324] New Year Show automated announcement' (#328 ) from i324_New-Year_Show into main Reviewed-on: #328	2025-12-26 16:22:21 +00:00
rho_n	ad21bb045c	Handle all future ordinal years for New Year show	2025-12-17 22:22:26 -05:00
rho_n	1cc9211e95	Automatically show the New Year Show announcement Insert the New Year Show announcement on the front page from Dec 1st through Jan 1st.	2025-12-16 19:01:33 -05:00
rho_n	fc12c7ae5c	Add MACRO to get ordinal year of the new year show Calculate the ordinal value of difference between the current year and 2011 (the first year of the New Year Show)	2025-12-16 19:01:33 -05:00
rho_n	6a64ebd95e	Fix grammer	2025-12-16 19:01:33 -05:00
rho_n	c349abfded	Calculate the start and end dates for the New Year show	2025-12-16 19:01:33 -05:00
ken_fallon	30e4f6a4d8	Update templates/content-new_year.tpl.html Changes so the live links are not visable	2025-12-16 11:55:32 +00:00
rho_n	e43386ac95	Merge pull request 'i324_New-Year_Show_template' (#327 ) from i324_New-Year_Show into main Reviewed-on: #327	2025-12-16 03:52:06 +00:00
rho_n	2f273d61dd	Add new year's eve information page Add template file and update front page announcement to link to the page.	2025-12-15 22:40:33 -05:00
rho_n	57d5989b29	Update announcement links to HPR New Year's Eve show promo audio	2025-12-15 09:36:10 -05:00
rho_n	292e501f69	Merge pull request 'Add missing small HPR logo file for RSS feeds' (#326 ) from i323_HPR-podcast-feeds-missing-microphone-logo into main Reviewed-on: #326	2025-12-13 23:11:58 +00:00
rho_n	fc1dedf4b2	Allow for generation of Hobby Public Radio	2025-09-11 12:55:24 -04:00
`@@ -1,4 +1,4 @@`
	`#!/usr/bin/perl`	`#!/usr/bin/env perl`

	`# {{{ POD documentation`	`# {{{ POD documentation`