hpr_generator/site.cfg

# Configure the Perl DBI driver to allow the templates communicate 
# with the database.
# dbi:<driver name [SQLite, CSV, ADO, mSQL, etc.]>:<database name>
# For more information on Perl Template Toolkit see: 
# http://template-toolkit.org/docs/manual/index.html
[DBI]
# Configuration settings for SQLite
database: sqlite
driver: dbi:SQLite:hpr.db 

# Configure the location of the templates and the generated HTML
[app_paths]
templates_path: ./templates:./public_html/images/icons
output_path: ./public_html

# Configure the root template page which pulls in the navigation and 
# content templates used by each page. An optional baseurl property may 
# be defined. This is useful when opening files directly from local 
# filesystem to allow relative paths to work.
[root_template]
content: page.tpl.html
#baseurl: OPTIONAL [i.e. file://<full path to local website directory>]
http_baseurl: http://hackerpublicradio.org/
hub_baseurl: https://hub.hackerpublicradio.org/
media_baseurl: https://hub.hackerpublicradio.org/ccdn.php?filename=/eps/hpr$eps_id/
generator_name: The HPR Robot
generator_email: robot.nospam@nospam.hackerpublicradio.org

# Configure the navigation menu and the content templates for each page 
# of the site:
#
# [page_name] REQUIRED
# navigation: REQUIRED <name of navigation template>
# content: REQUIRED <name of page content template>

# Configure filename if default name is not desired 
# (Default is "ROOT/[page_name].html"):
#
# filename: OPTIONAL <relative path from ROOT -- optional>
# * <directory path> -- Must end in forward slash. File will be created 
#                       in this path with the default naming scheme.
# * <file name> -- May include a relative path. Should include the file 
#                  extension. May have [id] marker in path or name which 
#                  will be substituted with a padded page id.

# Configure pages which use the same content template:
#
# multipage: OPTIONAL true | false (DEFAULT = false)  

[index]
navigation: navigation-main.tpl.html
content: content-index.tpl.html

[about]
navigation: navigation-about.tpl.html
content: content-about.tpl.html

[correspondents]
navigation: navigation-about.tpl.html
content: content-correspondents.tpl.html
filename: correspondents/index.html

[correspondent]
navigation: navigation-about.tpl.html
content: content-correspondent.tpl.html
multipage: true
filename: correspondents/[id].html

[series]
navigation: navigation-get-shows.tpl.html
content: content-series.tpl.html
filename: series/index.html

[series_episode]
navigation: navigation-get-shows.tpl.html
content: content-series_episode.tpl.html
multipage: true
filename: series/[id].html

[episodes]
navigation: navigation-get-shows.tpl.html
content: content-episodes.tpl.html
filename: eps/index.html

[episode]
navigation: navigation-get-shows.tpl.html
content: content-episode.tpl.html
multipage: true
filename: eps/hpr[id]/index.html

[download]
navigation: navigation-get-shows.tpl.html
content: content-download.tpl.html

[syndication]
navigation: navigation-get-shows.tpl.html
content: content-syndication.tpl.html

[search]
navigation: navigation-main.tpl.html
content: content-search.tpl.html

[sitemap]
navigation: navigation-about.tpl.html
content: content-sitemap.tpl.html

[tags]
navigation: navigation-main.tpl.html
content: content-tags.tpl.html

[twt_episode]
navigation: navigation-get-shows.tpl.html
content: content-twt_episode.tpl.html
multipage: true
filename: eps/twt[id]/index.html

[mumble-howto]
navigation: navigation-about.tpl.html
content: content-mumble-howto.tpl.html

[contact]
navigation: navigation-about.tpl.html
content: content-contact.tpl.html

[promote]
navigation: navigation-about.tpl.html
content: content-promote.tpl.html 

[comments_viewer]
navigation: navigation-about.tpl.html
content: content-comments_viewer.tpl.html

[hpr_ogg]
root_template: rss.tpl.xml
content: rss-hpr.tpl.xml
filename: hpr_ogg.rss
media_file_extension: ogg

[hpr_mp3]
root_template: rss.tpl.xml
content: rss-hpr.tpl.xml
filename: hpr_mp3.rss
media_file_extension: mp3
audio_mime_type: mpeg

[hpr_spx]
root_template: rss.tpl.xml
content: rss-hpr.tpl.xml
filename: hpr_spx.rss
media_file_extension: spx

[hpr_total_ogg]
root_template: rss.tpl.xml
content: rss-hpr_total.tpl.xml
filename: hpr_total_ogg.rss
media_file_extension: ogg

[hpr_total_mp3]
root_template: rss.tpl.xml
content: rss-hpr_total.tpl.xml
filename: hpr_total_mp3.rss
media_file_extension: mp3
audio_mime_type: mpeg

[hpr_total_spx]
root_template: rss.tpl.xml
content: rss-hpr_total.tpl.xml
filename: hpr_total_spx.rss
media_file_extension: spx

[comments]
root_template: rss-comments.tpl.xml
filename: comments.rss
Configure database connection in config file Pass the db configuration info to the page templates via the template constants feature. 2022-06-29 10:42:10 -04:00			`# Configure the Perl DBI driver to allow the templates communicate`
			`# with the database.`
			`# dbi:<driver name [SQLite, CSV, ADO, mSQL, etc.]>:<database name>`
Changes to get the site working 2023-06-17 22:04:35 +02:00			`# For more information on Perl Template Toolkit see:`
			`# http://template-toolkit.org/docs/manual/index.html`
Configure database connection in config file Pass the db configuration info to the page templates via the template constants feature. 2022-06-29 10:42:10 -04:00			`[DBI]`
Fix database instructions in configuration file Add back instructions for SQLite 2023-03-03 22:40:53 -05:00			`# Configuration settings for SQLite`
Changes to get the site working 2023-06-17 22:04:35 +02:00			`database: sqlite`
			`driver: dbi:SQLite:hpr.db`
Configure database connection in config file Pass the db configuration info to the page templates via the template constants feature. 2022-06-29 10:42:10 -04:00
Add template and HTML folder configuration options Allow user to set the path for the website templates and output folders in the site.cfg file. 2023-03-09 20:25:25 -05:00			`# Configure the location of the templates and the generated HTML`
			`[app_paths]`
Add arrow icon path to generator templates path 2025-10-31 09:59:00 -04:00			`templates_path: ./templates:./public_html/images/icons`
Add template and HTML folder configuration options Allow user to set the path for the website templates and output folders in the site.cfg file. 2023-03-09 20:25:25 -05:00			`output_path: ./public_html`

Configure root template page in config file Currently the root template is page.tpl.html. 2022-06-29 11:03:32 -04:00			`# Configure the root template page which pulls in the navigation and`
Add baseurl feature Allow an optional base url to be included in generation of html files. 2022-07-31 19:25:56 -04:00			`# content templates used by each page. An optional baseurl property may`
			`# be defined. This is useful when opening files directly from local`
			`# filesystem to allow relative paths to work.`
Configure root template page in config file Currently the root template is page.tpl.html. 2022-06-29 11:03:32 -04:00			`[root_template]`
			`content: page.tpl.html`
Add baseurl feature Allow an optional base url to be included in generation of html files. 2022-07-31 19:25:56 -04:00			`#baseurl: OPTIONAL [i.e. file://<full path to local website directory>]`
Setting up static RSS feeds site-generator: Changed the routine used to generate entities in 'HTML::Entities'; see filter function 'xml_entity' site.cfg: Added root variable 'http_baseurl' which defines the base URL using 'http' templates/rss.tpl.xml: RSS template defining the channel and inserting the 'item' definitions; adjusted to be in step with the PHP version. templates/shared-item.tpl.xml: RSS template used for each 'item' in an RSS feed; contains a call to 'HTML::Strip' which turns off the addition of spaces when removing tags; adjusted to be in step with the PHP version. templates/shared-utils.tpl.html: Macro collection used by other templates; addition of temporay macro 'display_explicit_feed_2' which generates 'Yes/No' strings to be in step with the PHP version. 2024-05-23 20:14:42 +01:00			`http_baseurl: http://hackerpublicradio.org/`
Changes to get the site working 2023-06-17 22:04:35 +02:00			`hub_baseurl: https://hub.hackerpublicradio.org/`
Update site.cfg Changed the mediaurl to point to the CCDN. 2024-10-22 12:10:21 +00:00			`media_baseurl: https://hub.hackerpublicradio.org/ccdn.php?filename=/eps/hpr$eps_id/`
Changes to get the site working 2023-06-17 22:04:35 +02:00			`generator_name: The HPR Robot`
			`generator_email: robot.nospam@nospam.hackerpublicradio.org`
Configure root template page in config file Currently the root template is page.tpl.html. 2022-06-29 11:03:32 -04:00
Initial add of site-generator app and config file A Perl program which uses Template Toolkit to generate static html files for Hacker Public Radio. Signed-off-by: Roan Horning <roan.horning@gmail.com> 2022-06-28 05:25:36 -04:00			`# Configure the navigation menu and the content templates for each page`
			`# of the site:`
Add episodes page to configuration file 2022-08-06 10:51:32 -04:00			`#`
			`# [page_name] REQUIRED`
			`# navigation: REQUIRED <name of navigation template>`
			`# content: REQUIRED <name of page content template>`
Allow defining of filename via configuration file 2022-07-28 21:59:38 -04:00
			`# Configure filename if default name is not desired`
			`# (Default is "ROOT/[page_name].html"):`
			`#`
			`# filename: OPTIONAL <relative path from ROOT -- optional>`
			`# * <directory path> -- Must end in forward slash. File will be created`
			`# in this path with the default naming scheme.`
			`# * <file name> -- May include a relative path. Should include the file`
			`# extension. May have [id] marker in path or name which`
			`# will be substituted with a padded page id.`

Allow multiple pages to be generated from one template Feature to allow generation of host and episode pages. 2022-07-28 22:04:15 -04:00			`# Configure pages which use the same content template:`
			`#`
			`# multipage: OPTIONAL true \| false (DEFAULT = false)`
Initial add of site-generator app and config file A Perl program which uses Template Toolkit to generate static html files for Hacker Public Radio. Signed-off-by: Roan Horning <roan.horning@gmail.com> 2022-06-28 05:25:36 -04:00
			`[index]`
Add about and index page templates 2022-07-01 22:07:06 -04:00			`navigation: navigation-main.tpl.html`
Initial add of site-generator app and config file A Perl program which uses Template Toolkit to generate static html files for Hacker Public Radio. Signed-off-by: Roan Horning <roan.horning@gmail.com> 2022-06-28 05:25:36 -04:00			`content: content-index.tpl.html`

			`[about]`
			`navigation: navigation-about.tpl.html`
			`content: content-about.tpl.html`

			`[correspondents]`
			`navigation: navigation-about.tpl.html`
			`content: content-correspondents.tpl.html`
Allow defining of filename via configuration file 2022-07-28 21:59:38 -04:00			`filename: correspondents/index.html`
Initial add of site-generator app and config file A Perl program which uses Template Toolkit to generate static html files for Hacker Public Radio. Signed-off-by: Roan Horning <roan.horning@gmail.com> 2022-06-28 05:25:36 -04:00
Allow multiple pages to be generated from one template Feature to allow generation of host and episode pages. 2022-07-28 22:04:15 -04:00			`[correspondent]`
			`navigation: navigation-about.tpl.html`
			`content: content-correspondent.tpl.html`
			`multipage: true`
Add episodes page to configuration file 2022-08-06 10:51:32 -04:00			`filename: correspondents/[id].html`
Initial implementation of series page 2022-08-02 21:57:56 -04:00
			`[series]`
			`navigation: navigation-get-shows.tpl.html`
			`content: content-series.tpl.html`
			`filename: series/index.html`
Add generation of individual series pages 2022-08-05 15:51:59 -04:00
Rename page series_shows to series_episode Align name with more standard naming scheme. 2022-08-06 12:14:47 -04:00			`[series_episode]`
Add generation of individual series pages 2022-08-05 15:51:59 -04:00			`navigation: navigation-get-shows.tpl.html`
Rename page series_shows to series_episode Align name with more standard naming scheme. 2022-08-06 12:14:47 -04:00			`content: content-series_episode.tpl.html`
Add generation of individual series pages 2022-08-05 15:51:59 -04:00			`multipage: true`
			`filename: series/[id].html`
Implement full show index page 2022-08-05 17:44:58 -04:00
			`[episodes]`
			`navigation: navigation-get-shows.tpl.html`
			`content: content-episodes.tpl.html`
Add episodes page to configuration file 2022-08-06 10:51:32 -04:00			`filename: eps/index.html`

Add page episode 2022-08-07 14:09:44 -04:00			`[episode]`
			`navigation: navigation-get-shows.tpl.html`
			`content: content-episode.tpl.html`
			`multipage: true`
			`filename: eps/hpr[id]/index.html`
Add page syndication 2022-08-07 23:47:40 -04:00
Add Download Options page Implement template file and add download page to site.cfg 2024-10-13 17:02:05 -04:00			`[download]`
			`navigation: navigation-get-shows.tpl.html`
			`content: content-download.tpl.html`

Add page syndication 2022-08-07 23:47:40 -04:00			`[syndication]`
			`navigation: navigation-get-shows.tpl.html`
			`content: content-syndication.tpl.html`
Add page contribute 2022-08-08 20:53:04 -04:00
Add page search 2022-08-08 21:07:34 -04:00			`[search]`
			`navigation: navigation-main.tpl.html`
			`content: content-search.tpl.html`
Add page help_out 2022-08-08 22:00:24 -04:00
Add page sitemap 2022-08-13 13:12:45 -04:00			`[sitemap]`
			`navigation: navigation-about.tpl.html`
			`content: content-sitemap.tpl.html`
Initial implementation of HPR RSS feeds template Add templates and macros to create main HPR OGG feed. 2022-08-17 17:12:47 -04:00
Fixed link to Tags. Get episode ID and episode tags from eps. Generate the Tags page by looping through the tags, order by their first character. Added tags page to the config. 2023-05-01 00:50:01 +10:00			`[tags]`
			`navigation: navigation-main.tpl.html`
			`content: content-tags.tpl.html`

Change variable names to twt_... 2025-11-02 00:58:51 -04:00			`[twt_episode]`
Integrate twat episodes Add twat shows to the full episodes index, the host pages. Add individule twat episodes. 2022-09-17 17:28:39 -04:00			`navigation: navigation-get-shows.tpl.html`
Change variable names to twt_... 2025-11-02 00:58:51 -04:00			`content: content-twt_episode.tpl.html`
Integrate twat episodes Add twat shows to the full episodes index, the host pages. Add individule twat episodes. 2022-09-17 17:28:39 -04:00			`multipage: true`
Change Today with a Techie folder name Change name to twt$eps_id Fix media_path to call Today with a Techie shows from the CCDN. 2025-01-21 23:47:07 -05:00			`filename: eps/twt[id]/index.html`
Integrate twat episodes Add twat shows to the full episodes index, the host pages. Add individule twat episodes. 2022-09-17 17:28:39 -04:00
Add page mumble-howto 2022-10-16 18:12:05 -04:00			`[mumble-howto]`
			`navigation: navigation-about.tpl.html`
			`content: content-mumble-howto.tpl.html`

Add Contact page Implement template file and add reference in site.cfg 2024-10-13 17:22:18 -04:00			`[contact]`
			`navigation: navigation-about.tpl.html`
			`content: content-contact.tpl.html`
Add page mumble-howto 2022-10-16 18:12:05 -04:00
Add Promote HPR page Implement the template file and add reference to site.cfg. 2024-10-13 17:39:10 -04:00			`[promote]`
			`navigation: navigation-about.tpl.html`
			`content: content-promote.tpl.html`

Implement comments_viewer page 2023-02-24 20:42:01 -05:00			`[comments_viewer]`
			`navigation: navigation-about.tpl.html`
			`content: content-comments_viewer.tpl.html`

Fixing invalid links in the templates. 2023-09-03 17:51:03 +02:00			`[hpr_ogg]`
			`root_template: rss.tpl.xml`
			`content: rss-hpr.tpl.xml`
			`filename: hpr_ogg.rss`
			`media_file_extension: ogg`

			`[hpr_mp3]`
			`root_template: rss.tpl.xml`
			`content: rss-hpr.tpl.xml`
			`filename: hpr_mp3.rss`
			`media_file_extension: mp3`
			`audio_mime_type: mpeg`

			`[hpr_spx]`
			`root_template: rss.tpl.xml`
			`content: rss-hpr.tpl.xml`
			`filename: hpr_spx.rss`
			`media_file_extension: spx`

			`[hpr_total_ogg]`
			`root_template: rss.tpl.xml`
			`content: rss-hpr_total.tpl.xml`
			`filename: hpr_total_ogg.rss`
			`media_file_extension: ogg`

			`[hpr_total_mp3]`
			`root_template: rss.tpl.xml`
			`content: rss-hpr_total.tpl.xml`
			`filename: hpr_total_mp3.rss`
			`media_file_extension: mp3`
			`audio_mime_type: mpeg`

			`[hpr_total_spx]`
			`root_template: rss.tpl.xml`
			`content: rss-hpr_total.tpl.xml`
			`filename: hpr_total_spx.rss`
			`media_file_extension: spx`
Add comments feed template 2022-10-08 08:52:47 -04:00
			`[comments]`
			`root_template: rss-comments.tpl.xml`
			`filename: comments.rss`