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:
Dave Morriss
2024-06-14 16:00:04 +01:00
parent 38abbcdd39
commit 50edeccc88
12 changed files with 1874 additions and 146 deletions

View File

@@ -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 &mdash; 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