kdmurrayhpr/hpr_generator
0
0
Fork 0
forked from rho_n/hpr_generator
Code Pull Requests Activity
HPR static site generator
155 Commits 5 Branches 2 Tags 45 MiB
HTML 83.1%
Perl 6.3%
Shell 4.1%
Awk 4%
CSS 2.5%
64ae9c4f86
Go to file
Roan Horning 64ae9c4f86
Refactor media_baseurl MACRO to media_basepath MACRO 
Prevent name collision with media_basepath root_template/page property
of same name. Also fix application of trailing forward slash to path
based on existence of baseurl property.
2022-10-01 13:18:35 -04:00
_sql/sqlite Fix test data insertion script 2022-07-12 22:41:12 -04:00
public_html Add page Will my show be of interest to hackers 2022-08-17 21:30:54 -04:00
templates Refactor media_baseurl MACRO to media_basepath MACRO 2022-10-01 13:18:35 -04:00
LICENSE Change license to AGPLV3 2022-07-13 23:16:44 -04:00
README.md Add command line option all 2022-08-19 22:19:50 -04:00
site-generator Add MACRO media_baseurl 2022-09-18 16:18:05 -04:00
site.cfg Integrate twat episodes 2022-09-17 17:28:39 -04:00

README.md

hpr_generator

Static web page generator for the Hacker Public Radio website.

Installation

  • Clone or download this repository
  • Create the sqlite3 database from the files in the _sql directory. The default name for the database file is "hpr.db" and should be located in the root of the project directory. The name and location can be set in the site.cfg file.
  • Two sql helper scripts are available to generate an empty database or a database filled with test data.
    • For an empty database: cat Create_Database_Empty.sql | sqlite3 hpr.db
    • For a database with test data: cat Create_Database_Test.sql | sqlite3 hpr.db
  • SQLite v3.8.3 or greater is recommended. CTE WITH clauses are used in some template queries. Must convert WITH clauses to sub-queries when using earlier versions of SQLite.
  • Install the needed Perl modules using preferred method (distribution packages, CPAN, etc.)
    • GetOpt
    • Pod::Usage
    • Config::Std
    • Template
    • Template::Plugin::File
    • Template::Plugin::DBI
    • DBI
    • Tie::DBI
    • DBD::SQLite
    • Date::Calc

Usage

Generate two specific pages: site-generator index about

Generate the whole site: site-generator --all

Generate pages based on the same template: site-generator correspondent=1,3,5..10

Support

Please submit an Issue, and add the label "Help Request" for help running or installing the site-generator.

For discussing HPR site generation in general, please submit an Issue and add the label "General Discussion".

Contributing

Happy to take any contributions or suggestions.

To contribute code or documentation, please create a fork of the project and submit a pull request or send a patch. If an issue exists that is related to your patch, please assign the issue to yourself, or if it is already assigned to someone else, please coordinate with them to minimize duplicated efforts.

If you have found an error in the code or the generated HTML, please submit an Issue, and add the label "Bug Found".

To make a suggestion, please submit an Issue, and add the label "Feature Request".

Authors and acknowledgment

  • Roan "Rho`n" Horning