## Clone directlygit clone https://github.com/Wivik/vinyl-records-collection-theme themes/vinyl-records-collection-theme
## Or use as a sub modulegit submodule add https://github.com/Wivik/vinyl-records-collection-theme themes/vinyl-records-collection-theme
This theme use a specific archetype, so delete or rename the default one.
rm <your hugo site folder>/archetypes/default.md
Update the configuration file :
baseurl: <your site URL>languageCode: 'en-us'title: 'My Vinyl Records Collection'author: <Your Name>theme: vinyl-records-collection-themetaxonomies:
artist: artistgenres: genreslabel: labelyear: yearformat: format
Or if you use the Toml format :
baseurl = '<your site URL>'languageCode = 'en-us'title = 'My Vinyl Records Collection'author = '<Your Name>'theme = 'vinyl-records-collection-theme'[taxonomies]
artist = 'artist'genres = 'genres'label = 'label'year = 'year'format = 'format'
Create your first record
Create a new content file with hugo :
hugo new an-album-name.md
Open the newly created file, the archetype will basically tell you what you need to do to finish the job.
# Mandatory parts :
# Optional parts that you still should fill in order to sort your collection
## Label : name of the label that published the record
label: Record's Label
## The band's name
band: Record's Band
## The genres this record is classified into
- To sort
## Cover image : will be displayed in the album list and top page.
## Display a default one unless you change this value.
# More optional details you can use for your collection.
## A quick description of your record. Markdown is supported
# description: |
# This is a great album.
## Disc format : 45rpm, 33rpm, 78rpm or size if you prefer.
# format: 33rpm
## Any supplementary pictures you want to display.
## These pictures should be in the site asset folder :
## <your hugo site>/assets
## If you put them into a sub-folder, don't forget it in the path !
# - this-album/pict.jpg
## The publish year
# year: 1990
## Below the metadata block, you can write some content such as a review or anything else you want. It'll be displayed in the album page.
The most comprehensive documentation of the support content is directly written in the archetype.
The CSS file is mostly variabilized and can be overloaded suing a custom.css file that will be loaded after the default style.
│ └── css
│ └── custom.css # 2. customize the color there└── themes
│ ├── css
│ │ ├── custom.css ## 1. copy this file to the site assets folder, in a 'css' sub-folder │ │ └── style.css
You can change the background image of the header and the footer, also the default record image, by adding your own one in the site assets folder.
│ └── img
│ └── back-header.jpg # will have the priority over the one in the template└── themes
│ └── img
│ ├── back-footer.jpg
│ ├── back-header.jpg
│ └── default.png
The theme expects the header and footer to be in jpg format, while the default record image is expected to be in png.