https://github.com/adrienjoly/album-shelf

💿 Collection of music records I love, maintained with Jekyll on Github Pages
https://github.com/adrienjoly/album-shelf

collection jekyll music static-site

Last synced: 28 days ago
JSON representation

💿 Collection of music records I love, maintained with Jekyll on Github Pages

• Host: GitHub
• URL: https://github.com/adrienjoly/album-shelf
• Owner: adrienjoly
• License: mit
• Created: 2018-06-10T09:36:42.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-12-13T08:29:50.000Z (about 1 year ago)
• Last Synced: 2024-11-24T17:41:50.655Z (about 1 month ago)
• Topics: collection, jekyll, music, static-site
• Language: JavaScript
• Homepage: https://adrienjoly.com/album-shelf
• Size: 3.64 MB
• Stars: 7
• Watchers: 2
• Forks: 2
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# album-shelf

`album-shelf` is a static web page to display and explore my collection of music records.

Screenshot from [adrienjoly.com/album-shelf](https://adrienjoly.com/album-shelf):

![collection of albums screenshot](./docs/screenshot.png)

It uses Jekyll to render the list in HTML from a YAML data file (see [`albums.yaml`](./_data/albums.yaml)) and Github-pages to make it accessible to the public.

If you want to have a similar page for your own album collection, feel free to fork this repository and replace my list of albums by yours!

## Features

### Search and add an album from Spotify

```

$ npm run add:spotify-album

```

### Add saved albums from the user's Spotify library

```

$ npm run add:spotify-saved-abums

```

### Add albums from the user's playlists on Spotify

```

$ npm run add:spotify-playlists

```

## How to publish my own collection?

> Notice: In order to create and publish your collection, you need to have a Github account, to be familiar with `git` and with the use of the command line.

Follow these steps:

1. fork this repository into your own Github account;

2. update your copy of `_config.yml` to fill your name and Google Analytics ID;

3. edit your copy of `albums.yaml`;

4. test your changes locally by running `npm install`, then `npm start`;

5. commit and push your changes to your fork repository (e.g. using `git push`);

6. activate Github-pages on your `master` branch, as displayed below:

![go to the settings tab of your repo](./docs/github-repo-settings.png)

![activate github-pages on your master branch](./docs/github-repo-pages.png)

7. browse your collection on `http://.github.io/album-shelf`. 👌