From dc6c96f5bb462262e7240c2cd2005ea628309476 Mon Sep 17 00:00:00 2001 From: Ken Fallon Date: Sun, 31 May 2026 21:12:13 +0200 Subject: [PATCH] Documentation update --- templates/content-about.tpl.html | 4 + templates/content-contribute.tpl.html | 415 ++++++++++++++++---------- 2 files changed, 259 insertions(+), 160 deletions(-) diff --git a/templates/content-about.tpl.html b/templates/content-about.tpl.html index efe67f8..4a987e2 100644 --- a/templates/content-about.tpl.html +++ b/templates/content-about.tpl.html @@ -29,6 +29,7 @@
  • Community Content Distribution Network
  • Developer team
  • (Re)Creating a HPR page on wikipedia
    • +
  • Help the Free Culture Podcasts Project
  • Please support our Supporters
  • Contact
    • @@ -250,6 +251,7 @@ We also appreciate help improving the documentation. Developer Information page.

    +

    (Re)Creating a HPR page on wikipedia.

    Once someone contributes to Public Radio, the Wikipedia rules prevent us from editing a page. @@ -270,6 +272,8 @@ And of course the fact that Wikipedia itself references us as a source We have given many talks at conferences, and have been interviewed on other podcasts. We also have been featured in the press.

    +

    Help the Free Culture Podcasts Project.

    +

    The Free Culture Podcasts Project is a umbrella site run by the Hacker Public Radio community. We prefer to attend booths as the Free Culture Podcasts project so we can not only hilight HPR, but also other podcasts that release their shows under the Creatitive Commons deed.

    Please support our Supporters.

    diff --git a/templates/content-contribute.tpl.html b/templates/content-contribute.tpl.html index cf9e8ad..1379d18 100644 --- a/templates/content-contribute.tpl.html +++ b/templates/content-contribute.tpl.html @@ -16,11 +16,11 @@

  • Your show will be heard by an International Audience
  • Pick a Topic
    • +
  • Recording a Podcast
    • @@ -187,6 +187,43 @@ which describes the agreed approach to this topic. You can pick a day, or put it in the reserve pool and let the Janitors use it there are free slots.

    +
    +Your email will be made public. +

    +The mail is just a way for us to get back to you if there was an issue posting the show. +This email address will be published on the HPR website and will be given out in the feeds, +so please use a public email address for this purpose. +

    +

    +Where we publish it we pad it with dot nospam at-sign nospam dot. +For example hpr@example.com becomes hpr.nospam@nospam.example.com. +

    +

    +If you do not want to have your email exposed, please contact the admin@hpr team to arrange a alias. +If you trust the janitors to know your real email, +then we can just use an alias for you on the web site. +Any inbound mail to that alias will be automatically forwarded to your personal email. +That runs the risk that were the redirect list compromised then your real email would get exposed. +We would do our best to protect your email but we can't guarantee anything. +

    +

    +The other option is to use an a throwaway email, like +https://www.guerrillamail.com/ +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. +

    + +
    +You IP Address and User Agent will logged.. +

    +The information we log is sent at the end of the emails we send to you. +Your IP address is linked to your show until it is posted. +Once we verify the show is a genuine contribution we remove the reference. +

    +
    +
    We use UTF-8 end to end.
    See the video "Characters, Symbols and the Unicode Miracle - @@ -249,32 +286,233 @@ If you have any questions please join one of our ">How I got into tech series. +First tell us your name, +how you found out about HPR, +and the begin with your earliest introduction to tech. +Cover all the systems you used, +and mention all the people +and events who had a role in shaping your journey. +We will make sure you get lots of suggestions for your next submission in the comments for your show, +and in the next HPR Community News monthly overview. +

    +

    +You can see in our +Complete Episode Overview page +that we a wide variety of topics, ranging from "OMG I just learned/broke/hacked/discovered/etc, this cool thing and no one in my house gets it", +to in depth series where a particular topic can be explored in more detail. +

    +

    +To find a overview of the topics you can also search by keyword on our +tags page. +

    -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 Archive page for examples of shows people have recorded in the past. -

    +

    We maintain a page of requested topics that have been sent in by the community. Feel free to add it to the list via the contact channels.

    - -Requested Topics, or our -Series page to see if you can add your knowledge to the pool. -

    If you are worried that your show may not be of interest to Hackers then you can click here to check if it is.

    -

    -If you can't think of anything to talk about then please just record a show telling us -how you got into tech -as a way to introducing yourself to the community. -

    + +
    +
    +
    +

    ↑ Go to top

    +

    Recording a Podcast

    +
    +

    +On this page you will find information on how to record a podcast.

    + +
    +FLAC is best, we accept the rest. +

    +Our recommended setting for recording is 44100 Hz, 24 bit depth, saved as Lossless FLAC Level 8 (best). +

    +

    +If your recording setup can't do that, then pick a lossless format, with the highest sample rate you can. +If you only have access to a lossfull format like mp3, then please send that in as is. +

    +

    +For more tips see the In-Depth Series: Podcasting HowTo. +

    +
    + +
    +Any audio is better than no audio. +

    +We all want to produce the best quality we can. +We encourage you to record using the best equipment you have. +However if the show is audible then that is sufficient. +The show hpr2627 :: Home Phone Setup!! is a perfect example of this. +

    +
    + +
    +Procrastination is the enemy. +

    +If it's taking too long to edit the episode then you are less likely to submit the show. +Send this show in, and employ your lessons learned in the next one. +

    +

    +A rule of thumb is to never spend more time editing than recording. +

    +
    + +
    +Introduce yourself in each show. +

    +Don't forget to introduce yourself in your show. +We have hundreds of hosts and thousands of episodes. +While you may have done many shows, people randomly listen to shows, +so this may be the first time to hear your voice. +

    +

    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. +

    + +

    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: +

    +
      +
    • Recording Source - Unprocessed
      • +
    • Sample Rate - 44.1 kHz
      • +
    • Encoding - .flac
      • +
    • Audio Channels - Mono
      • +
    + + +

    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. +

    +

    +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.
    + +

    +When you have finished editing your podcast you can export it. +

    +
      +
    1. Confirm that the Project Rate is set to 44100 Hz (bottom left).
      2. +
    2. File -> Export and select FLAC File.
      3. +
    3. Click Options... to reveal FLAC Export Setup.
      4. +
    4. Set Level to 8 (best).
      5. +
    5. Set Bit depth to 24.
      6. +
    +

    +Audacity Export Settings +

    + +

    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. +

    + +

    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. +
    +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. +

    +

    +Audacity Can Record +

    + +

    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 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.

    +

    +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. +

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    3. Record your show.

    @@ -303,8 +541,6 @@ After you have selected a date you will be redirected to the 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. @@ -435,8 +671,7 @@ so you may wish to use an email address that has an associated public key availa Once 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 therefore 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. + that you can access quickly.

    The audio of your show will not be moderated, however the information provided in the upload form @@ -490,125 +725,7 @@ and chat with a live person 24/7.

    -
    -
    -
    -

    ↑ Go to top

    -

    Recording a Podcast

    -
    -

    -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 - .

    -

    -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. -

    -

    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: -

    -
      -
    • Recording Source - Unprocessed
      • -
    • Sample Rate - 44.1 kHz
      • -
    • Encoding - .flac
      • -
    • Audio Channels - Mono
      • -
    - - -

    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. -

    -

    -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.
    - -

    -When you have finished editing your podcast you can export it. -

    -
      -
    1. Confirm that the Project Rate is set to 44100 Hz (bottom left).
      2. -
    2. File -> Export and select FLAC File.
      3. -
    3. Click Options... to reveal FLAC Export Setup.
      4. -
    4. Set Level to 8 (best).
      5. -
    5. Set Bit depth to 24.
      6. -
    -

    -Audacity Export Settings -

    - -

    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. -

    - -

    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. -
    -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. -

    -

    -Audacity Can Record -

    - -

    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 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.

    -

    -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. -

    -
    @@ -967,28 +1084,6 @@ Your show information is used to process the media files, on the website, in the -

    0.15 I'd like to post a show but I would - rather not have my email address published on the site.?

    -

    -The mail is just a way for us to get back to you if there was an issue posting the show. -

    -

    -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. -

    -

    -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. -

    -

    -In both cases we would do our best to protect your email but we can't guarantee anything. -

    -

    -The other option is to use an a throwaway email, like https://www.guerrillamail.com/ -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.