hpr_generator/README.md

80 lines
3.2 KiB
Markdown
Raw Normal View History

2022-06-27 01:36:01 +00:00
# hpr_generator
Static web page generator for the Hacker Public Radio website.
2022-06-27 01:36:01 +00:00
## Installation
* Clone or download this repository
* With SQLite
2023-10-06 14:47:09 +00:00
* Create the sqlite3 database from the hpr.sql MySQL dump file available on
hackerpublicradio.org. 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.
2023-10-06 14:47:09 +00:00
* An "update-hpr.sh" helper script is available in the utils directory. This
script will download the hpr.sql file, convert it to the SQLite hpr.db file,
and regenerate the website using the site-generator.
1. `cd` into the root of the project directory
2. Run `./utils/update-hpr.sh`
2023-10-06 14:47:09 +00:00
* 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.
* With MySQL
* Create database hpr_hpr in the MySQL server from HPR dump file.
- ``sudo mysql --host=localhost < hpr.sql``
* Create a user that will be used by the site-generator.
- Suggested username: hpr-generator
- ``CREATE USER 'hpr-generator'@'localhost' IDENTIFIED BY '<password>';``
* Limit the user's privileges to EXECUTE and SELECT
- ``GRANT SELECT ON hpr_hpr.* TO 'hpr-generator'@'localhost';``
- ``GRANT EXECUTE ON `hpr_hpr`.* TO 'hpr-generator'@'localhost';``
* Install the needed Perl modules using preferred method (distribution packages, CPAN, etc.)
2024-09-08 13:05:34 +00:00
* Getopt::Long
* Pod::Usage
* Config::Std
* Template
* Template::Plugin::File
* Template::Plugin::DBI
2023-10-06 14:47:09 +00:00
* Template::Plugin::Date
* Template::Plugin::HTML::Strip
* DBI
* Tie::DBI
2024-09-08 13:05:34 +00:00
* DBD::SQLite or DBD::mysql
* Date::Calc
2023-10-06 14:47:09 +00:00
* Text::CSV_XS
* HTML::Entities
* See the [Getting Started](GETTING_STARTED.md) tutorial for more details on
installing the HPR generator.
2023-10-06 14:47:09 +00:00
2022-06-27 01:36:01 +00:00
## Usage
Generate two specific pages:
2023-10-06 14:47:09 +00:00
`site-generator index about`
Generate the whole site:
2023-10-06 14:47:09 +00:00
`site-generator --all`
2022-06-27 01:36:01 +00:00
2022-08-02 16:56:01 +00:00
Generate pages based on the same template:
`site-generator correspondent=1,3,5..10`
2022-06-27 01:36:01 +00:00
## Support
Please [submit an Issue](https://repo.anhonesthost.net/HPR/hpr_generator/issues),
and add the label "**Help Request**" for help running or installing the site-generator.
2022-06-27 01:36:01 +00:00
For discussing HPR site generation in general, please [submit an Issue](https://repo.anhonesthost.net/HPR/hpr_generator/issues) and add the label "**General Discussion**".
2022-06-27 01:36:01 +00:00
## Contributing
Happy to take any contributions or suggestions.
2022-06-27 01:36:01 +00:00
To contribute code or documentation, please create a fork of the project and [submit a pull request](https://repo.anhonesthost.net/HPR/hpr_generator/pulls) 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.
2022-06-27 01:36:01 +00:00
If you have found an error in the code or the generated HTML, please [submit an Issue](https://repo.anhonesthost.net/HPR/hpr_generator/issues),
and add the label "**Bug Found**".
2022-06-27 01:36:01 +00:00
To make a suggestion, please [submit an Issue](https://repo.anhonesthost.net/HPR/hpr_generator/issues),
and add the label "**Feature Request**".
2022-06-27 01:36:01 +00:00
## Authors and acknowledgment
2023-10-06 14:47:09 +00:00
* Roan "Rho`n" Horning
2024-06-21 15:43:57 +00:00
* Dave Morriss
2023-03-14 00:47:59 +00:00
* gordons
* Ken Fallon
2023-10-06 14:47:09 +00:00
* norrist
2024-06-21 15:43:57 +00:00