hpr_generator/README.md

41 lines
1.6 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
* 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.
* Install the needed Perl modules using preferred method (distribution packages, CPAN, etc.)
* GetOpt
* Pod::Usage
* Config::Std
* Template
* DBI
2022-06-27 01:36:01 +00:00
## Usage
Generate two specific pages:
`site-generator index about`
Generate the whole site:
`site-generator ALL`
2022-06-27 01:36:01 +00:00
## Support
Please [submit an Issue](https://gitlab.com/roan.horning/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://gitlab.com/roan.horning/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 merge request](https://gitlab.com/roan.horning/hpr_generator/-/merge_requests) or send a patch.
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://gitlab.com/roan.horning/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://gitlab.com/roan.horning/hpr_generator/-/issues),
and add the label "**Feature Request**".
2022-06-27 01:36:01 +00:00
## Authors and acknowledgment
* Roan "Rho`n" Horning
2022-06-27 01:36:01 +00:00