norrist
/
hpr_generator
forked from rho_n/hpr_generator
1
0
Fork 0
Code Pull Requests Activity

Merge pull request 'The links to the page itself were not working - used to quickly add links to about page to questions' (#179) from I121_Fix_anchor_links_on_about_page into main 

Reviewed-on: rho_n/hpr_generator#179
This commit is contained in:
Ken Fallon 2023-12-20 11:58:50 +00:00
parent eba235c503 130f603748
commit 7d8af97f7d
1 changed files with 38 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
templates/content-about.tpl.html
View File

@ -179,14 +179,14 @@
Please select <a href="recording.php">more detailed information</a> on how to record a show:
</p>
<ul>
<li>Recording with a <a href="#portable_media_player">portable media player</a>.</li>
<li>Recording with a <a href="#smart_phone">smart phone</a>.</li>
<li><a href="#editing">Recording/Editing</a> using your Computer.</li>
<li>Recording Interviews with the <a href="#phone_interviews">Phone</a>.</li>
<li>Recording <a href="#round_table">round table</a> discussions.</li>
<li>Avoid <a href="#background_music">Bedding/background</a> music.</li>
<li>We mix down to <a href="#encoding">Mono</a>.</li>
<li>No need to add <a href="#no_metadata">Metadata</a> to the file.</li>
<li>Recording with a <a href="about.html#portable_media_player">portable media player</a>.</li>
<li>Recording with a <a href="about.html#smart_phone">smart phone</a>.</li>
<li><a href="about.html#editing">Recording/Editing</a> using your Computer.</li>
<li>Recording Interviews with the <a href="about.html#phone_interviews">Phone</a>.</li>
<li>Recording <a href="about.html#round_table">round table</a> discussions.</li>
<li>Avoid <a href="about.html#background_music">Bedding/background</a> music.</li>
<li>We mix down to <a href="about.html#encoding">Mono</a>.</li>
<li>No need to add <a href="about.html#no_metadata">Metadata</a> to the file.</li>
</ul>
<p>Don't forget to <strong>introduce yourself</strong> in your show.</p>
@ -287,24 +287,24 @@
<hr />
<h1 id="agreement">Stuff you need to know<a href="#agreement">.</a></h1>
<h1 id="agreement">Stuff you need to know<a href="about.html#agreement">.</a></h1>
<p>
This is some important information that you will need to know before uploading to HPR.
</p>
<h2 id="wikipedia">You will no longer be allowed to edit HPR pages on Wikipedia<a href="#wikipedia">.</a></h2>
<h2 id="wikipedia">You will no longer be allowed to edit HPR pages on Wikipedia<a href="about.html#wikipedia">.</a></h2>
<p>
Once you upload a show, you will no longer be allowed to create or edit pages relating to <a href="https://en.wikipedia.org/wiki/Hacker_Public_Radio">Hacker Public Radio</a> in <a href="https://en.wikipedia.org/wiki/Wikipedia:FAQ/Organizations">Wikipedia</a>.<br />
See our <a href="#faq_wikipedia">FAQ about the HPR Wikipedia page</a> for more information.
See our <a href="about.html#faq_wikipedia">FAQ about the HPR Wikipedia page</a> for more information.
</p>
<h2 id="mailinglist">All policy decisions are made by the HPR Community<a href="#mailinglist">.</a></h2>
<h2 id="mailinglist">All policy decisions are made by the HPR Community<a href="about.html#mailinglist">.</a></h2>
<p>
The community decides the HPR policies.
Please join the <a href="<!--% absolute_url(baseurl,'/maillist') %-->">HPR Mailing List</a> to participate.
</p>
<h2 id="no_shows_no_hpr">HPR will stop as a project if there are not enough shows<a href="#no_shows_no_hpr">.</a></h2>
<h2 id="no_shows_no_hpr">HPR will stop as a project if there are not enough shows<a href="about.html#no_shows_no_hpr">.</a></h2>
<p>
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.
@ -312,14 +312,14 @@
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.
</p>
<h2 id="patrons">Support our Patrons<a href="#patrons">.</a></h2>
<h2 id="patrons">Support our Patrons<a href="about.html#patrons">.</a></h2>
<p>
Our hosting is kindly provided to us by <a href="<!--% absolute_path(baseurl) %-->correspondents/0174.html">Josh Knapp</a> from <a href="https://anhonesthost.com/hosting/shared-hosting">AnHonestHost.com</a>, and The Internet Archive at <a href="https://archive.org/donate/">Archive.org</a>.
We encourage you to support our Patrons.
Over the years kind people have donated services and supported equipment for our conferences.
</p>
<h2 id="syndication">We do not syndicate non HPR Shows<a href="#syndication">.</a></h2>
<h2 id="syndication">We do not syndicate non HPR Shows<a href="about.html#syndication">.</a></h2>
<p>
HPR is founded on the principle of Hackers sharing knowledge.
For this reason we are only releasing material created exclusively for HPR.
@ -330,20 +330,20 @@
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.
</p>
<h2 id="license">You are agreeing to license your show CC-BY-SA<a href="#license">.</a></h2>
<h2 id="license">You are agreeing to license your show CC-BY-SA<a href="about.html#license">.</a></h2>
<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>
<h2 id="permission">You have permission to redistribute your show in its entirety<a href="#permission">.</a></h2>
<h2 id="permission">You have permission to redistribute your show in its entirety<a href="about.html#permission">.</a></h2>
<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 other copyrighted content, even if it is made available under fair use, or by arranged permission.
</p>
<h2 id="not_moderated">The audio of your show will not be moderated<a href="#not_moderated">.</a></h2>
<h2 id="not_moderated">The audio of your show will not be moderated<a href="about.html#not_moderated">.</a></h2>
<p>
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.
@ -359,7 +359,7 @@
</p>
<h2 id="explicit">Your show will be signaled as containing explicit content<a href="#explicit">.</a></h2>
<h2 id="explicit">Your show will be signaled as containing explicit content<a href="about.html#explicit">.</a></h2>
<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.
@ -374,7 +374,7 @@
<a href="<!--% absolute_path(baseurl) %-->eps/hpr2210/index.html">hpr2210 :: On Freedom of Speech and Censorship</a> describes the agreed approach to this topic.
</p>
<h2 id="schedule">You determine when your show will be released<a href="#schedule">.</a></h2>
<h2 id="schedule">You determine when your show will be released<a href="about.html#schedule">.</a></h2>
<p>
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.
@ -382,7 +382,7 @@
Once the slots have been allocated it is not possible to move them.
</p>
<h2 id="reserving">All reservations need to be approved<a href="#reserving">.</a></h2>
<h2 id="reserving">All reservations need to be approved<a href="about.html#reserving">.</a></h2>
<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>
@ -404,22 +404,22 @@
</ul>
</p>
<h2 id="utf8">We use UTF-8 end to end<a href="#utf8">.</a></h2>
<h2 id="utf8">We use UTF-8 end to end<a href="about.html#utf8">.</a></h2>
<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>
<h2 id="accessibility">Keep accessibility in mind<a href="#accessibility">.</a></h2>
<h2 id="accessibility">Keep accessibility in mind<a href="about.html#accessibility">.</a></h2>
<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)
<br />
Include descriptive language in any link texts.
<br />
Avoid structures like: <em>"For accessibility information click <a href="#accessibility">here</a>"</em><br />
Rather use: <em>"For more information click our <a href="#accessibility">accessibility page</a>"</em><br />
Avoid structures like: <em>"For accessibility information click <a href="about.html#accessibility">here</a>"</em><br />
Rather use: <em>"For more information click our <a href="about.html#accessibility">accessibility page</a>"</em><br />
</p>
<h2 id="international">Your show will be heard by an International Audience<a href="#international">.</a></h2>
<h2 id="international">Your show will be heard by an International Audience<a href="about.html#international">.</a></h2>
<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>.
@ -433,7 +433,7 @@
<a href="https://xkcd.com/1179/"><img src="../images/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>
<h1 id="reserve_queue">Feed the reserve queue<a href="#reserve_queue">.</a></h1>
<h1 id="reserve_queue">Feed the reserve queue<a href="about.html#reserve_queue">.</a></h1>
<p>
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.
</p>
@ -456,7 +456,7 @@
<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="#portable_media_player">.</a></h2>
<h2 id="portable_media_player">Recording with a portable media player<a href="about.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>
@ -464,7 +464,7 @@
Then just record your show, <a href="<!--% absolute_url(baseurl) %-->about.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="#smart_phone">.</a></h2>
<h2 id="smart_phone">Recording with a portable media player<a href="about.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>
@ -476,7 +476,7 @@
</ul>
<h2 id="editing">Recording/Editing using your Computer<a href="#editing">.</a></h2>
<h2 id="editing">Recording/Editing using your Computer<a href="about.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>
@ -499,12 +499,12 @@
<img width="600" 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="#phone_interviews">.</a></h2>
<h2 id="phone_interviews">Recording Interviews with the Phone<a href="about.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="#round_table">.</a></h2>
<h2 id="round_table">Recording round table discussions<a href="about.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.
@ -515,18 +515,18 @@
<img width="600" 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="#background_music">.</a></h2>
<h2 id="background_music">Avoid Bedding/background music<a href="about.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="#encoding">.</a></h2>
<h2 id="encoding">We mix down to Mono<a href="about.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="#">.</a></h2>
<h2 id="no_metadata">No need to add Metadata to the file<a href="about.html#">.</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>
@ -588,7 +588,7 @@
</p>
<ul>
<li id="email"><strong>email:</strong> <em>already populated</em><br />
See notes <a href="#requesting_slot">above</a><br />
See notes <a href="about.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>
@ -737,7 +737,7 @@
<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="#what-are-the-mandatory-elements-of-an-hpr-show">below</a>.</p></li>
<li><p>Each show is expected to have certain mandatory attributes listed <a href="about.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,'about.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="http://hackerpublicradio.org/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>
@ -802,7 +802,7 @@
<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="#if-i-notice-an-error-in-my-shows-details-how-can-it-be-fixed">fixing errors after upload</a>).</p></li>
<li><p>We may make changes to a show's metadata if the host requests it (see the item on <a href="about.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>