From b4448caf16ecf2d9d81f99e8aa3e57a53aee7945 Mon Sep 17 00:00:00 2001 From: Dave Morriss Date: Sat, 9 Sep 2023 17:54:19 +0100 Subject: [PATCH 01/57] Fixing 'absolute_url' MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit site-generator: Added all the modules that the script and the templates use to make it explicit what is required. templates/shared-utils.tpl.html: Added a new TT² macro called 'absolute_url' which takes two arguments, the base and the path or relative URL. It's fairly primitive but seems to work. templates/content-about.tpl.html, templates/content-recording.tpl.html, templates/content-request_a_slot.tpl.html, templates/content-requested_topics.tpl.html, templates/page.tpl.html: All calls to 'absolute_url' changed to use two arguments, and the link definitions adjusted to match this change. --- site-generator | 7 + templates/content-about.tpl.html | 138 ++++++++++---------- templates/content-recording.tpl.html | 10 +- templates/content-request_a_slot.tpl.html | 10 +- templates/content-requested_topics.tpl.html | 6 +- templates/page.tpl.html | 2 +- templates/shared-utils.tpl.html | 14 ++ 7 files changed, 104 insertions(+), 83 deletions(-) diff --git a/site-generator b/site-generator index 71ec176..405c849 100755 --- a/site-generator +++ b/site-generator @@ -116,8 +116,15 @@ use Pod::Usage; use Config::Std; use Text::CSV_XS; use HTML::Entities qw(encode_entities_numeric); +use Date::Calc; +use DBI; +use DBD::SQLite; +use Tie::DBI; use Template; +use Template::Plugin::Date; +use Template::Plugin::DBI; use Template::Plugin::HTML::Strip; + use Data::Dumper; exit main(); diff --git a/templates/content-about.tpl.html b/templates/content-about.tpl.html index e3d7f1e..a9df034 100644 --- a/templates/content-about.tpl.html +++ b/templates/content-about.tpl.html @@ -1,40 +1,40 @@ -

Welcome to HPR.

- +

Welcome to HPR.

+ -

About HPR.

+

About HPR.

-

The HPR Community.

-

What differentiates HPR from other podcasts is that the shows are crowd sourced from the community - fellow listeners like you. There is no restriction on how long the show can be, nor on the topic you can cover as long as they are not spam and "are of interest to Hackers". If you want to see what topics have been covered so far just have a look at our Archive. We also allow for a series of shows so that hosts can go into more detail on a topic.

+

The HPR Community.

+

What differentiates HPR from other podcasts is that the shows are crowd sourced from the community - fellow listeners like you. There is no restriction on how long the show can be, nor on the topic you can cover as long as they are not spam and "are of interest to Hackers". If you want to see what topics have been covered so far just have a look at our Archive. We also allow for a series of shows so that hosts can go into more detail on a topic.

-

You can download/listen to the shows here or you can subscribe to the show in your favorite podcatching client to automatically get our new shows as soon as they are available. You can copy and redistribute the shows for free provided you adhere to the Creative Commons Attribution Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) License.

+

You can download/listen to the shows here or you can subscribe to the show in your favorite podcatching client to automatically get our new shows as soon as they are available. You can copy and redistribute the shows for free provided you adhere to the Creative Commons Attribution Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) License.

-

History.

-

Hacker Public Radio (HPR) is an Internet Radio show (podcast) that releases shows every weekday Monday through Friday. HPR has a long lineage going back to Radio FreeK America, Binary Revolution Radio & Infonomicon, and it is a direct continuation of Twatech radio. Please listen to StankDawg's "Introduction to HPR" for more information.

+

History.

+

Hacker Public Radio (HPR) is an Internet Radio show (podcast) that releases shows every weekday Monday through Friday. HPR has a long lineage going back to Radio FreeK America, Binary Revolution Radio & Infonomicon, and it is a direct continuation of Twatech radio. Please listen to StankDawg's "Introduction to HPR" for more information.

-

Free Culture.

+

Free Culture.

Hacker Public Radio is dedicated to sharing knowledge. We do not accept donations so please consider supporting our patrons. If you listen to HPR, then we would love you to contribute one show a year. Our shows are by default released under a Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. All the software we use is Free software. All the code we develop is published in our gitlab repository. All the media is available via the feeds. We are going through an audit process to release the website code as well.

-

Governance.

-

HPR is entirely community driven. Policy decisions are proposed and discussed on the Mailing list, which is open to anyone to join. Mailing list discussions are brought to the attention of the listening community on the first Monday of the month in the HPR Community News show. This show is also open to anyone to participate in. The schedule for the Community News shows can be downloaded as an iCal calendar containing recording dates for the next 12 months. A reminder is also sent to the mailing list in the week before the recording.

-

Our hosting is kindly provided to us by Josh Knapp from AnHonestHost.com, and he has the last word in issues related to site security. A changing team of volunteers called the "admins" or "Janitors", deal with the day to day operation of HPR. Acting as the first point of contact, processing the shows, coordinating policy discussions, removing spam, updating the website, etc. They are contactable via the email account admin @ HPR. They have no more say over policy than anyone else. Anyone who has shown a long term dedication to the project and is trusted by the community, can become an admin. +

Governance.

+

HPR is entirely community driven. Policy decisions are proposed and discussed on the Mailing list, which is open to anyone to join. Mailing list discussions are brought to the attention of the listening community on the first Monday of the month in the HPR Community News show. This show is also open to anyone to participate in. The schedule for the Community News shows can be downloaded as an iCal calendar containing recording dates for the next 12 months. A reminder is also sent to the mailing list in the week before the recording.

+

Our hosting is kindly provided to us by Josh Knapp from AnHonestHost.com, and he has the last word in issues related to site security. A changing team of volunteers called the "admins" or "Janitors", deal with the day to day operation of HPR. Acting as the first point of contact, processing the shows, coordinating policy discussions, removing spam, updating the website, etc. They are contactable via the email account admin @ HPR. They have no more say over policy than anyone else. Anyone who has shown a long term dedication to the project and is trusted by the community, can become an admin.

-

See the section stuff you need to know for more information.

+

See the section stuff you need to know for more information.

Recent Policy Changes

-

Please support our Patrons.

+

Please support our Patrons.

Our hosting is kindly provided by Josh from AnHonestHost.com. We would appreciate it if you could donate to help reduce his costs in funding the hosting. He is also accepting bitcoins to 1KsxJr9HtsdaUeU7yaV9bk9bQi21UPBtUq

@@ -52,14 +52,14 @@
-

Contact.

+

Contact.

We are always looking for more hosts...

Don't forget to introduce yourself in your show.

-

4. Upload your show.

+

4. Upload your show.

Once you have your audio ready you can post your show by going to the Calendar page or press the ⇧Upload⇧ button.

@@ -149,12 +149,12 @@ More Information.

-

.

Questions ? +

.

Questions ?

Got any questions not covered here, then just email "admin" at "", and we’ll get in touch with you with all you need to know about getting your show published.
You can chat with other podcasters using IRC in the #oggcastplanet channel on the freenode.net network. Follow us on identi.ca (use the tag !hpr) and on Twitter (use the tag #hpr). We have a Facebook and LinkedIn group, so please join and spread the word.

-

.

Still Nervous +

.

Still Nervous

Fellow listeners like yourself contribute the shows and so we all know how hard it is to do that first show. You're probably worried that we won't like the topic. Well don't be, have a look at our archive to see how diverse the contributions have been. You're probably worried about the quality of your audio, that you sound funny, that English isn't your native language, that you suffer from a speech impediment, that your show has loads of ummms and awws in it, well don't be. We have plenty of hosts that fall into all these categories but continue to produce great shows.

@@ -173,7 +173,7 @@
-

Requested topics.

+

Requested topics.

This is a list of topics that have been requested by the community. Feel free to add it to the list by emailing admin at hpr or by tweeting us on @HPR.

0.3 Can I submit a show made for another podcast?

@@ -783,7 +783,7 @@

-

Download Archive.

+

Download Archive.

Please be aware that our Archive exceeds 62Gb (Ogg: 21Gb, Spx: 16Gb, mp3: 25Gb). We are happy for you to download them, but please make sure that you are not going to incur additional bandwidth charges on your side.

@@ -208,7 +208,8 @@
  • We use UTF-8 end to end.
  • Your show will be heard by an International Audience.
  • We also need reserve shows.
    • -
  • You will no longer be allowed to edit HPR pages on Wikipedia.
    • +
  • You will no longer be allowed to edit HPR pages on + Wikipedia.

    • 2. Select a Topic.

    @@ -227,14 +228,14 @@ Please select more detailed information on how to record a show:

    Don't forget to introduce yourself in your show.

    @@ -246,7 +247,7 @@ After you have selected a date you will be redirected to the request page, 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 GPG 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.

    - More Information. + More Information.

    .

    Questions ? @@ -256,10 +257,20 @@

    .

    Still Nervous

    - Fellow listeners like yourself contribute the shows and so we all know how hard it is to do that first show. You're probably worried that we won't like the topic. Well don't be, have a look at our Archive to see how diverse the contributions have been. You're probably worried about the quality of your audio, that you sound funny, that English isn't your native language, that you suffer from a speech impediment, that your show has loads of ummms and awws in it, well don't be. We have plenty of hosts that fall into all these categories but continue to produce great shows. + Fellow listeners like yourself contribute the shows and so we all know how hard it is to do that first show. + You're probably worried that we won't like the topic. + Well don't be, have a look at our Archive to see how diverse + the contributions have been. You're probably worried about the quality of your audio, that you sound funny, + that English isn't your native language, that you suffer from a speech impediment, + that your show has loads of ummms and awws in it, well don't be. + We have plenty of hosts that fall into all these categories but continue to produce great shows.

    - At the end of the day the show is about the content and not the quality of the audio. That's not to say we won't help you with ways to improve the audio if you wish, or narrate your script if you can't or won't record it yourself. Drop into the IRC channel #oggcastplanet where there are people who will help.
    + At the end of the day the show is about the content and not the quality of the audio. + That's not to say we won't help you with ways to improve the audio if you wish, or narrate your script if you can't + or won't record it yourself. + Drop into the IRC channel #oggcastplanet where there are + people who will help.

    Our Mottos

    @@ -268,7 +279,9 @@
    It ain't a show unless it's on the server.
    If you tell us you are doing a show, then you owe us a show.
    -

    You don't need anyones permission to upload a show, but if you have any questions then drop into the #oggcastplanet channel on libera.chat and chat with a live person 24/7. +

    You don't need anyones permission to upload a show, but if you have any questions then drop into the + #oggcastplanet channel on libera.chat + and chat with a live person 24/7.

    @@ -299,7 +312,8 @@
  • How to do knitting
  • How to build a house
  • Bitcoin howto hpr0788
    • -
  • How to solder hpr1037, hpr1047
    • +
  • How to solder hpr1037, + hpr1047
  • How to weld
  • How to fix a car
  • Reviews of stream playing software, (for linuxheads who don't want to keep a browser tab open all the time)
    • @@ -335,39 +349,43 @@
    -

    Stuff you need to know.

    +

    Stuff you need to know.

    This is some important information that you will need to know before uploading to HPR.

    -

    You will no longer be allowed to edit HPR pages on Wikipedia.

    +

    You will no longer be allowed to edit HPR pages on Wikipedia + .

    Once you upload a show, you will no longer be allowed to create or edit pages relating to Hacker Public Radio in Wikipedia.
    - See our FAQ about the HPR Wikipedia page for more information. + See our FAQ about the HPR Wikipedia page for more information.

    -

    All policy decisions are made by the HPR Community.

    +

    All policy decisions are made by the HPR Community + .

    The community decides the HPR policies. Please join the HPR Mailing List to participate.

    -

    HPR will stop as a project if there are not enough shows.

    +

    HPR will stop as a project if there are not enough shows + .

    Hacker Public Radio is dedicated to sharing knowledge. We release about 260 shows a year, which is probably more than all of the other FOSS podcasts put together. - If you listen to HPR, then we would love you to contribute one show a year. + If you listen to HPR, then we would love you to + contribute one show a year. Remember once that all the reserve shows have been used up and there are no more shows in the queue, HPR as a project will stop.

    -

    Support our Patrons.

    +

    Support our Patrons.

    Our hosting is kindly provided to us by Josh Knapp from AnHonestHost.com, and The Internet Archive at Archive.org. We encourage you to support our Patrons. Over the years kind people have donated services and supported equipment for our conferences.

    -

    We do not syndicate non HPR Shows.

    +

    We do not syndicate non HPR Shows.

    HPR is founded on the principle of Hackers sharing knowledge. For this reason we are only releasing material created exclusively for HPR. @@ -378,51 +396,71 @@ There you can introduce the content and explain why it is important, providing links to where we can get more information etc., and then include one example episode.

    -

    You are agreeing to license your show CC-BY-SA.

    +

    You are agreeing to license your show + CC-BY-SA.

    - All our shows are now released under a Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) 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. + All our shows are now released under a + Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) + 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 link for more information.

    -

    You have permission to redistribute your show in its entirety.

    +

    You have permission to redistribute your show in its entirety + .

    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 Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) 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 other copyrighted content, even if it is made available under fair use, or by arranged permission. + Try to avoid using any content in your show that can not be redistributed under a + Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) + 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 other copyrighted content, + even if it is made available under fair use, or by arranged permission.

    -

    The audio of your show will not be moderated.

    +

    The audio of your show will not be + moderated.

    We do not vet, edit, moderate or in any way censor any of the audio you submit, we trust you to do that. - 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. + 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.
    We do transcode the audio into different formats.

    Please note that this only relates to the audio you upload. - The rest of the meta-data (branding/summaries/tags/show notes/etc.), are managed by the HPR Community, and may be edited. - The show hpr2210 :: On Freedom of Speech and Censorship describes the agreed approach to this topic. + The rest of the meta-data (branding/summaries/tags/show notes/etc.), are managed by the HPR Community, + and may be edited. + The show hpr2210 :: On Freedom of Speech and Censorship + describes the agreed approach to this topic.

    -

    Your show will be signaled as containing explicit content.

    +

    Your show will be signaled as containing explicit content + .

    - 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. + 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 inoffensive in every region of the world then you can signal that when you upload the show. + If you feel that your show will be considered inoffensive in every region of the world + then you can signal that when you upload the show.

    - 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 short warning at the very beginning of the show before the intro, to allow listeners time to switch off the episode should they so desire. + 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 short warning at the very beginning of the show before the intro, + to allow listeners time to switch off the episode should they so desire.

    - hpr2210 :: On Freedom of Speech and Censorship describes the agreed approach to this topic. + hpr2210 :: On Freedom of Speech and Censorship + describes the agreed approach to this topic.

    -

    You determine when your show will be released.

    +

    You determine when your show will be released.

    The HPR Schedule is entirely community driven and we recommend that you 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. @@ -430,7 +468,7 @@ Once the slots have been allocated it is not possible to move them.

    -

    All reservations need to be approved.

    +

    All reservations need to be approved.

    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.

    @@ -452,38 +490,49 @@

    -

    We use UTF-8 end to end.

    +

    We use UTF-8 end to end.

    See the video "Characters, Symbols and the Unicode Miracle - Computerphile" for an interesting background to ASCII and UTF-8.
    -

    Keep accessibility in mind.

    +

    Keep accessibility in mind.

    - 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. + 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 <pre> tags)
    Include descriptive language in any link texts.
    - Avoid structures like: "For accessibility information click here"
    - Rather use: "For more information click our accessibility page"
    + Avoid structures like: "For accessibility information click + here"
    + Rather use: "For more information click our + accessibility page"

    -

    Your show will be heard by an International Audience.

    +

    Your show will be heard by an International Audience + .

    - 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 YYYY-MM-DD iso8601 format, and abbreviations using the NATO phonetic alphabet. + 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 YYYY-MM-DD iso8601 format, + and abbreviations using the NATO phonetic alphabet. 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. + 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:

    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 Wikipedia

    - An xkcd cartoon showing ISO 8601 + An xkcd cartoon showing ISO 8601

    -

    Feed the reserve queue.

    +

    Feed the reserve queue.

    - The reserve queue is intended only to be used in the cases where there is still a gap in the schedule 24 hours 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 guidelines. + The reserve queue is intended only to be used in the cases where there is still a gap in the schedule 24 hours 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 guidelines.

    @@ -504,17 +553,21 @@

    On this page you will find information on how to record a podcast. Our golden rule is Any audio is better than no audio. so keep that in mind. Don't forget to introduce yourself in your show.

    -

    Recording with a portable media player.

    +

    Recording with a portable media player + .

    Many of today's portable media players 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 (WAV or FLAC), 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.

    - Then just record your show, request a slot, and we'll do the rest. + Then just record your show, request a slot, and we'll do the rest.

    -

    Recording with a portable media player.

    +

    Recording with a portable media player.

    - Some of our hosts recommend Android Audio Recorder on my android phone. It's available on F-Droid and Google Play. These are the recommended settings: + Some of our hosts recommend Android Audio Recorder on my android phone. + It's available on F-Droid + and Google Play. + These are the recommended settings:

    -

    Recording/Editing using your Computer.

    +

    Recording/Editing using your Computer.

    - The majority of podcasters use Audacity. 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. + The majority of podcasters use Audacity. + 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.

    Audacity Can Record

    -
    Audacity is a free, easy-to-use and multilingual audio editor and recorder for Windows, Mac OS X, GNU/Linux and other operating systems.
    +
    Audacity is a free, easy-to-use and multilingual audio editor and recorder for + Windows, Mac OS X, GNU/Linux and other operating systems.

    When you have finished editing your podcast you can export it. @@ -547,15 +603,21 @@ Audacity Export Settings

    -

    Recording Interviews with the Phone.

    +

    Recording Interviews with the Phone.

    - If you want to record a one-to-one interview with someone then you can use Skype in conjunction with Skype Call Recorder. 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 portable media player. + If you want to record a one-to-one interview with someone then you can use + Skype in conjunction with Skype Call Recorder. + 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 portable media player.

    -

    Recording round table discussions.

    +

    Recording round table discussions.

    - If you would like to record with multiple participants then you can use Mumble. Connect to chatter.skyehaven.net Port: 64738 .
    - Walk through the audio wizard and then pop into the Hacker Public Radio room. Once you are ready press the recording button, select multichannel and then start. That will record multiple tracks, one for each participant which you can edit and then submit. + If you would like to record with multiple participants then you can use Mumble. + Connect to chatter.skyehaven.net Port: 64738 .
    + Walk through the audio wizard and then pop into the Hacker Public Radio room. + Once you are ready press the recording button, select multichannel and then start. That will record multiple tracks, one for each participant which you can edit and then submit.
    Kwisher made a Mumble tutorial which you might find useful and Delwin has produced a number of short shows on how to configure the audio quality.

    @@ -563,18 +625,18 @@ Audacity Can Record

    -

    Avoid Bedding/background music.

    +

    Avoid Bedding/background music.

    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 truncate silence from working correctly.
    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.

    -

    We mix down to Mono.

    +

    We mix down to Mono.

    We will by default mix down your show to one channel mono and we will transcode 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.

    -

    No need to add Metadata to the file.

    +

    No need to add Metadata to the file.

    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.

    @@ -582,7 +644,7 @@
    -

    Please promote HPR.

    +

    Please promote HPR.

    Feel free to use the promotional material to spread the word in your podcasts, or have them played on to other shows.

    General HPR promotion

    @@ -639,14 +701,19 @@

    @@ -714,34 +781,42 @@ Select the series if any that your show is a part of.
  • Tags: Optional
    - Add a list of comma separated tags. Pick the most important words from the shownotes. These are used to find shows via the tags page. + Add a list of comma separated tags. Pick the most important words from the shownotes. + These are used to find shows via the tags page.
  • Upload Method: Optional
    You have the choice of the following options:

    - 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. + 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. 
           eps/hpr9999/full_shownotes.html
       eps/hpr9999/other-file.pdf
       eps/hpr9999/yet-other-file.c
       ...
    - 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. + 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.

    • - Press submit and your show will be sent to the HPR Volunteers to be processed. Keep an eye on the calendar for when it is posted. + Press submit and your show will be sent to the HPR Volunteers to be processed. + Keep an eye on the calendar 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.

    @@ -766,18 +841,27 @@

    Frequently Asked Questions

    0.1 What is Hacker Public Radio?

    0.2 What is a show?

    -

    0.3 Can I submit a show made for another podcast?

    +

    0.3 + Can I submit a show made for another podcast?

    -

    0.4 What defines a show as being "Produced for Hacker Public Radio"?

    +

    0.4 + What defines a show as being "Produced for Hacker Public Radio"?

    -

    0.5 What are the mandatory elements of an HPR show?

    +

    0.5 + What are the mandatory elements of an HPR show?

    -

    Download Archive.

    +

    Download Archive.

    Please be aware that our Archive exceeds 62Gb (Ogg: 21Gb, Spx: 16Gb, mp3: 25Gb). We are happy for you to download them, but please make sure that you are not going to incur additional bandwidth charges on your side.

    @@ -224,7 +224,7 @@ The first thing you will need to do is decide on a topic for your show. You might already have an idea but if not you can have a look at our Archive page for examples of shows people have recorded in the past. You can also look at our - Requested Topics, or our + Requested Topics, or our Series page to see if you can add your knowledge to the pool.

    @@ -242,14 +242,14 @@ on how to record a show:

    Don't forget to introduce yourself in your show.

    @@ -267,7 +267,7 @@ so you may wish to use an email address that has an associated public key available on public key servers.

    - More Information. + More Information.

    Questions ?.

    @@ -385,40 +385,40 @@
    -

    Stuff you need to know.

    +

    Stuff you need to know.

    This is some important information that you will need to know before uploading to HPR.

    You will no longer be allowed to edit HPR pages on Wikipedia - .

    + .

    Once you upload a show, you will no longer be allowed to create or edit pages relating to Hacker Public Radio in Wikipedia.
    - See our FAQ about + See our FAQ about the HPR Wikipedia page for more information.

    All policy decisions are made by the HPR Community - .

    + .

    The community decides the HPR policies. Please join the HPR Mailing List to participate.

    HPR will stop as a project if there are not enough shows - .

    + .

    Hacker Public Radio is dedicated to sharing knowledge. We release about 260 shows a year, which is probably more than all of the other FOSS podcasts put together. If you listen to HPR, then we would love you to - contribute + contribute one show a year. Remember once that all the reserve shows have been used up and there are no more shows in the queue, HPR as a project will stop.

    -

    Support our Patrons.

    +

    Support our Patrons.

    Our hosting is kindly provided to us by Josh Knapp from AnHonestHost.com, and The Internet Archive at Archive.org. @@ -426,7 +426,7 @@ Over the years kind people have donated services and supported equipment for our conferences.

    -

    We do not syndicate non HPR Shows.

    +

    We do not syndicate non HPR Shows.

    HPR is founded on the principle of Hackers sharing knowledge. For this reason we are only releasing material created exclusively for HPR. @@ -441,7 +441,7 @@

    You are agreeing to license your show - CC-BY-SA.

    + CC-BY-SA.

    All our shows are now released under a Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) @@ -451,7 +451,7 @@

    You have permission to redistribute your show in its entirety - .

    + .

    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 @@ -463,7 +463,7 @@

    The audio of your show will not be - moderated.

    + moderated.

    We do not vet, edit, moderate or in any way censor any of the audio you submit, we trust you to do that. Aside from checking snippets for audio quality/spam checking, @@ -484,7 +484,7 @@

    Your show will be signaled as containing explicit content - .

    + .

    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. @@ -504,7 +504,7 @@ describes the agreed approach to this topic.

    -

    You determine when your show will be released.

    +

    You determine when your show will be released.

    The HPR Schedule is entirely community driven and we recommend that you pick the date or show number as then you know when your show will be released. @@ -513,7 +513,7 @@ Once the slots have been allocated it is not possible to move them.

    -

    All reservations need to be approved.

    +

    All reservations need to be approved.

    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. @@ -541,12 +541,12 @@

    -

    We use UTF-8 end to end.

    +

    We use UTF-8 end to end.

    See the video "Characters, Symbols and the Unicode Miracle - Computerphile" for an interesting background to ASCII and UTF-8.
    -

    Keep accessibility in mind.

    +

    Keep accessibility in mind.

    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. @@ -555,13 +555,13 @@ Include descriptive language in any link texts.
    Avoid structures like: "For accessibility information click - here"
    + here"
    Rather use: "For more information click our - accessibility page"
    + accessibility page"

    Your show will be heard by an International Audience - .

    + .

    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. @@ -580,7 +580,7 @@ title="ISO 8601 was published on 06/05/88 and most recently amended on 12/01/04." alt="An xkcd cartoon showing ISO 8601" />

    -

    Feed the reserve queue.

    +

    Feed the reserve queue.

    The reserve queue is intended only to be used in the cases where there is still a gap in the schedule 24 hours 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. @@ -607,7 +607,7 @@ so keep that in mind. Don't forget to introduce yourself in your show.

    Recording with a portable media player - .

    + .

    Many of today's portable media players support recording audio out of the box. Search for "Voice Recorder", to see if there is an application for your smartphone. @@ -618,11 +618,11 @@ and so long as it's audible we'll take it.

    - Then just record your show, request a slot, + Then just record your show, request a slot, and we'll do the rest.

    -

    Recording with a portable media player.

    +

    Recording with a portable media player.

    Some of our hosts recommend Android Audio Recorder on my android phone. It's available on F-Droid @@ -637,7 +637,7 @@ -

    Recording/Editing using your Computer.

    +

    Recording/Editing using your Computer.

    The majority of podcasters use Audacity. First set the Project Rate to 44100Hz, then you can either record your show in Audacity itself or @@ -663,7 +663,7 @@ Audacity Export Settings

    -

    Recording Interviews with the Phone.

    +

    Recording Interviews with the Phone.

    If you want to record a one-to-one interview with someone then you can use Skype in conjunction with Skype Call Recorder. @@ -672,7 +672,7 @@ record with a portable media player.

    -

    Recording round table discussions.

    +

    Recording round table discussions.

    If you would like to record with multiple participants then you can use Mumble. Connect to chatter.skyehaven.net Port: 64738 .
    @@ -688,7 +688,7 @@ Audacity Can Record

    -

    Avoid Bedding/background music.

    +

    Avoid Bedding/background music.

    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, @@ -698,13 +698,13 @@ Others are hard of hearing and backing music makes it difficult to understand the text.

    -

    We mix down to Mono.

    +

    We mix down to Mono.

    We will by default mix down your show to one channel mono and we will transcode 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.

    -

    No need to add Metadata to the file.

    +

    No need to add Metadata to the file.

    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.

    @@ -793,7 +793,7 @@