Updates from previous repo
FAQ/FAQ.mkd, FAQ/Makefile: this version of the FAQ is now out of date and probably should be deleted. InternetArchive/repair_item: script to upload missing shows after tie out errors during the normal upload; still under development. InternetArchive/update_state: script to update show state in the 'reservations' table in the database. Uses the CMS interface. Link_Checker/scan_links: under development. Not currently usable. Miscellaneous/fix_tags: audio metadata manipulation script. Recently added to this repo for convenience. Updates for 'experimental::try', the official Perl try/catch. PostgreSQL_Database/add_hosts_to_show, PostgreSQL_Database/hpr_schema_2.pgsql, PostgreSQL_Database/nuke_n_pave.sh: an old experimental Pg database to take over from the previous MySQL version (from before 2023). Kept for reference; never implemented.
This commit is contained in:
55
FAQ/FAQ.mkd
55
FAQ/FAQ.mkd
@@ -1,9 +1,11 @@
|
||||
[%# FAQ.mkd 2020-09-26 14:26:49 version: 0.0.3 -%]
|
||||
[%# FAQ.mkd <2021-04-01 15:17:14> version: 0.0.5 -%]
|
||||
[% USE date -%]
|
||||
---
|
||||
title: Hacker Public Radio FAQ (draft)
|
||||
title: Hacker Public Radio FAQ (draft) [% date.format(date.now,"%F") %]
|
||||
subtitle: A collection of questions and answers with links to the HPR site
|
||||
author: HPR Contributors
|
||||
...
|
||||
[%# {{{ Links %]
|
||||
[% about = "http://hackerpublicradio.org/about.php" -%]
|
||||
[% reqslot = "http://hackerpublicradio.org/request_a_slot.php" -%]
|
||||
[% needtoknow = "http://hackerpublicradio.org/stuff_you_need_to_know.php" -%]
|
||||
@@ -15,32 +17,34 @@ author: HPR Contributors
|
||||
[% maillist = "http://hackerpublicradio.org/maillist" -%]
|
||||
[% freenode = "http://webchat.freenode.net/?channels=oggcastplanet" -%]
|
||||
[% podrec = "http://hackerpublicradio.org/series.php?id=75" -%]
|
||||
[% tags = "http://hackerpublicradio.org/tags.php" -%]
|
||||
[%# }}} %]
|
||||
|
||||
# Hacker Public Radio FAQ {.unnumbered}
|
||||
# Hacker Public Radio FAQ [% date.format(date.now,"%F") %] {.unnumbered}
|
||||
|
||||
## What is Hacker Public Radio?
|
||||
|
||||
- Hacker Public Radio (HPR) is an Internet Radio show (podcast) that releases
|
||||
shows every weekday Monday through Friday.
|
||||
shows (episodes) every weekday Monday through Friday.
|
||||
|
||||
- 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 shows can be, nor on the topic you can cover as long
|
||||
restriction on how long shows 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]([% index %]). We also allow for a [series]([% series %]) of
|
||||
shows so that hosts can go into more detail on a topic.
|
||||
our [Archive]([% index %]). We also allow for shows to be grouped into
|
||||
[series]([% series %]) so that hosts can go into more detail on a topic.
|
||||
|
||||
- Look at the [*About HPR*]([% about %]) page for a full description of *The HPR
|
||||
Community*, *Free Culture*, *Governance* and our *Patrons*.
|
||||
|
||||
- A recent question on the mailing list asks if HPR is a Content Publication
|
||||
- A question on the mailing list in 2020 asked if HPR is a Content Publication
|
||||
Network like YouTube, or is it a Podcast that random people contribute to? Or
|
||||
to put it another way, is the host addressing the Internet in general or the
|
||||
HPR Audience?
|
||||
- The consensus of opinion is that HPR is a Podcast contributed to by the
|
||||
community.
|
||||
community, not a Content Publication Network.
|
||||
|
||||
## What is a show?
|
||||
|
||||
@@ -81,7 +85,7 @@ author: HPR Contributors
|
||||
- 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 [*calendar*]([% calendar %]) page to do this. You need to have
|
||||
your show ready to upload before you do this though.
|
||||
your show ready to upload before you reserve a slot though.
|
||||
|
||||
## Can I submit a show made for another podcast?
|
||||
|
||||
@@ -115,13 +119,30 @@ author: HPR Contributors
|
||||
- Tags
|
||||
- Audio
|
||||
|
||||
## What are tags?
|
||||
|
||||
- We are trying to maintain a collection of tags to allow people to find shows
|
||||
on the same (or similar) topic.
|
||||
|
||||
- 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: [Tag summary]([% tags %])
|
||||
|
||||
- Some examples are: <b>android</b>, <b>creative commons</b> and
|
||||
<b>gaming</b>.
|
||||
|
||||
- Are there any tags that are best avoided?
|
||||
|
||||
## Is it OK if I don't include notes with my show?
|
||||
|
||||
- No, please don't do that. It is important to provide good show notes for
|
||||
- **Please don't do that**. It is important to provide good show notes for
|
||||
reasons described on the [*Picking a slot for your show*]([% reqslot %])
|
||||
page:
|
||||
- They provide the listeners with more information on the topic
|
||||
- They ensure your show gets posted on time
|
||||
- They provide the listeners with more information on the topic your show
|
||||
is covering
|
||||
- They ensure your show gets posted on time (the volunteers don't have to
|
||||
make notes for you)
|
||||
- They encourage people to download your show
|
||||
- They allow your show to be indexed by search engines
|
||||
- They make your show accessible to the deaf and hard of hearing
|
||||
@@ -135,8 +156,8 @@ author: HPR Contributors
|
||||
- We don't listen to the audio before posting a show to the website, so we
|
||||
don't change the content.
|
||||
|
||||
- Unless you have done so and told us, we add an introduction to the audio
|
||||
announcing what it is. Similarly we add an *outro*. This is not
|
||||
- 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 *outro*. This is not
|
||||
<u>editing</u> since we don't change the content.
|
||||
|
||||
- We may make changes to the show title, summary or tags. Usually these are
|
||||
@@ -147,8 +168,8 @@ author: HPR Contributors
|
||||
- Depending on the form the show notes take we may modify these.
|
||||
- If what is submitted is plain text we convert it to Markdown in order to
|
||||
generate HTML.
|
||||
- If the notes are one of the permitted markup formats (mostly Markdown)
|
||||
we may adjust this to ensure that valid HTML is generated.
|
||||
- If the notes are one of the permitted markup formats (mostly Markdown
|
||||
flavours) we may adjust this to ensure that valid HTML is generated.
|
||||
- If the notes are HTML we run them through an HTML checker and correct
|
||||
any mistakes it highlights.
|
||||
- We may correct spelling, grammar and punctuation if this clarifies
|
||||
|
Reference in New Issue
Block a user