mirror of
https://github.com/Wivik/vinyl-records-collection-theme.git
synced 2024-11-22 07:33:41 +01:00
137 lines
2.9 KiB
Markdown
137 lines
2.9 KiB
Markdown
# Vinyl Records Collection Theme
|
|
|
|
A [Hugo](https://gohugo.io) theme made to present your vinyl records collection to the world.
|
|
|
|
## Like demo
|
|
|
|
https://vinyl.zedas.fr
|
|
|
|
## Quick start
|
|
|
|
Create your new Hugo site.
|
|
|
|
```bash
|
|
hugo new site my-vinyl-records-collection
|
|
```
|
|
|
|
Add this theme to your project :
|
|
|
|
```bash
|
|
## Clone directly
|
|
git clone https://github.com/Wivik/vinyl-records-collection-theme themes/vinyl-records-collection-theme
|
|
|
|
## Or use as a sub module
|
|
git 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.
|
|
|
|
```bash
|
|
rm <your hugo site folder>/archetypes/default.md
|
|
```
|
|
|
|
Update the configuration file and add :
|
|
|
|
```yaml
|
|
theme: vinyl-records-collection-theme
|
|
|
|
taxonomies:
|
|
band: band
|
|
genres: genres
|
|
label: label
|
|
year: year
|
|
format: format
|
|
```
|
|
|
|
Or if you use the Toml format :
|
|
|
|
```toml
|
|
theme = 'vinyl-records-collection-theme'
|
|
|
|
[taxonomies]
|
|
band = 'band'
|
|
genres = 'genres'
|
|
label = 'label'
|
|
year = 'year'
|
|
format = 'format'
|
|
|
|
```
|
|
|
|
## Create your first record
|
|
|
|
Create a new content file with hugo :
|
|
|
|
```bash
|
|
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.
|
|
|
|
Example :
|
|
|
|
```markdown
|
|
---
|
|
# Mandatory parts :
|
|
title: "Disc7"
|
|
date: 2023-08-19T23:31:17+02:00
|
|
draft: true
|
|
|
|
# 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
|
|
genres:
|
|
- To sort
|
|
|
|
## Cover image : will be displayed in the album list and top page.
|
|
## Display a default one unless you change this value.
|
|
cover:
|
|
|
|
# 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 !
|
|
# pictures:
|
|
# - 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.
|
|
---
|
|
|
|
|
|
```
|
|
|
|
## License
|
|
|
|
Vinyl Records Collection Theme is [licensed under MIT](LICENSE).
|
|
|
|
## Maintenance and contribution
|
|
|
|
This theme is maintained by Seb, the original author.
|
|
|
|
If you wish to contribute, fork this repository and open a pull-request. Any contribution is welcome !
|
|
|
|
## Support
|
|
|
|
If you like this project and was useful for you, please consider supporting its development. This theme is made by a coffee-lover, so you can just :
|
|
|
|
[](https://ko-fi.com/I2I1CL34H)
|
|
|