Yoctolio

What is this project

A strip down static site generator, the idea is to generate a simple single page portfolio using information collected in csv files.

How to use it

Add video content

The first step needed to add content on your portifolio is to create a file at the following path : config/config.txt

As well as the config/categories.txt file with the following content :

csv 1, directing 2, editing

The words directing and editing can be changed and any category can be added as long as their id (the number in front of the name) is uniq.

Inside this file you can now add one line per section on the index page of the portfolio :

Name of the section, file_name_of_the_section.txt

Yoctolio will now generate a section called Name of the section, the videos you wish to include in this section need to be listed in the file you defined. In this case config/file_name_of_the_section.txt

To add a video you need to follow this pattern :

Name of the video, youtube_url, category_number, year

Where :

• Name of the video is self explenatory
• youtube_url is the full youtube url example : https://www.youtube.com/watch?v=79T8c0vW0ik
• category the id of the category of the video
• year the year of the production example : 2021

Changing the template

The default templates are visible in the project repository, to create your own you can simply create a templates folder with an index.html inside and it will be used by default.

Adding a page

If you want another page you can create a folder at the following path templates/pages containing any html page that will be included in you portfolio.

Adding assets

Whenever you want to include css, js, images or any asset to you projects you can simply create a folder at the following path templates/assets, the content of this folder will be copied to public/assets during compilation.

Adding partials

A partial is a small html snippet that can be easilly reused in different pages and template, it can be useful for header, footer, navigation...

To add partials to your porfolio you need to create the folder templates/partials, then inside create any html file. To call a partial from a page of the index.html you just have to include the following snippet : {{!partial_name}}.

So if you create templates/partials/footer.html it is called by using {{!footer}} in any template.