Rowboat Music is a Hugo theme for music sites.
An example site is available which demonstrates all of the different features.
Although Rowboat Music does not require a particular organization of music, you should place normal musical releases in the "releases" section. This way, a list of the most recent releases will appear on the homepage.
By default, up to five releases are listed. Set the recentReleaseCount site parameter to a different number to change how many are listed.
You can add cover art as a page resource named cover.xyz where .xyz is any file extension such as .png or .jpg.
Adding a page resource is perhaps the simplest way to add cover art, but there are a few different ways to do it. These are listed in order of priority (higher-priority items override lower-priority ones).
- Add a
customcoverparameter to the front matter. This should be the path to an image file, relative to the base of the site (refer to the relURL function). - Add a
coverofparameter to the front matter. This should be the path to another page (cross reference) to use the same cover art as that page. (Be careful when using this option because it is possible to create an infinite loop.) - Add a page resource named
cover.xyzwhere.xyzis any file extension. (This is the method mentioned previously.) - Add cover art to the parent page using one of the methods mentioned. Subpages will inherit the cover art unless it is overridden.
References are lists of links to other pages, such as a track list for an album. Different reference types can be defined, such as tracks, parts, works in progress, and so on.
(More detailed documentation is needed. For now, refer to the example site for information on using the reference system.)
This theme uses Semantic Versioning. The API refers to page and site parameters, layouts (including partials), overall page structure, and class names (for styling). Backwards compatibility does not mean that the appearance or markup will necessarily remain the same, but rather that parameters, custom layouts, and custom styles should still work as intended.
Rowboat Music is available under the MIT License. Refer to LICENSE.txt for details.
Files under the static directory are dedicated to the public domain under Creative Common CC0 1.0 Universal. (A copy is available in LICENSE-STATIC.txt.) The intent of this dedication is to allow users to create a site using this theme without having to provide a copy of the license: These files are copied, not output from a program, so the license would apply if not for this dedication.