Skip to content

BesrourMS/clean-blog

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 

Clean-Blog

A clean, Bootstrap blog theme for Pico CMS Designed by Start Bootstrap

Installation under Pico CMS >= 2.0

  • Download the zip file from this location : https://github.com/BesrourMS/clean-blog and unzip it.
  • Copy the folder 'clean-blog-master/clean-blog/' to '/themes'.
  • Backup your '/content' directory somewhere else.
  • Delete all files and folders present in '/content'.
  • Copy the contents of 'clean-blog-master/content-sample' to '/content'.
  • Edit '/config/config.yml' and put this line by replacing previous one: 'theme: clean-blog'
  • Install the 'Pico Pagination Plugin', which allows to show several pages of articles titles. Go to this page to download and install it : https://github.com/rewdy/Pico-Pagination . It is basically just copying one file, very easy.
  • You can now test your blog in your browser it should be showing up properly.

Installation under Pico CMS < 2.0

Download the clean-blog folder, upload it in the themes folder of your pico installation and change the following setting within your config.php:

 $config['theme'] = 'clean-blog';
 $config['pages_order_by'] = 'date';
 $config['pages_order'] = 'desc';

You must add these custom settings in your config file

$config['author'] = 'Your Name';
$config['facebook'] = 'https://www.facebook.com/YourPage';
$config['twitter'] = '@username';

Install the Pico Pagination Plugin, which allows to show several pages of articles titles. Go to this page to download and install it : https://github.com/rewdy/Pico-Pagination . It is basically just copying one file, very easy.Then so you must add this setting to config.php

$config['pagination_limit'] = 4;

Copy index.md & post.md from content-sample to your content folder and change the meta data

Customization

  • Change the title of the main page by editing the '/config/config.yml' file, in the 'site_title' field
  • Change the desecription that goes just below that title by editing the '/content/index.md' file, in the 'Tagline' field
  • Change the main web page description meta tag by editing the '/content/index.md’ file, in the 'Description' field
  • Change the top picture by adding the picture, with size of 1900x994 pixels, in the '/themes/clean-blog/img' directory. Then, edit the '/content/index.md' file, and for the 'Img :' field put this complete line instead: Img: themes/clean-blog/img/your-picture.jpg You can also simply put an URL of a picture if needed.
  • No modification to the '/content/index.md' file except the YML header will be shown, only the articles list is shown
  • You can edit the 'Copyright' information at the botton of the articles list page by editing the '/themes/clean-blog/index.twig' file, in the 'copyright text-muted’ class at the very bottom of the file.
  • Change the number of articles shown in the list on the first page by putting this snippet at the end of your '/config/config.yml’ file (here set to 4):
##
# Pico Pagination Plugin
pagination_limit: 4
  • Activate URL rewriting
rewrite_url: true

Adding a new blog article

  • You can create a new blog article by copying the '/content/blog.md’ file to a new file called 'blog-2021-03-04_Article_title.md’.
  • You need to edit that new file by putting the right date in the 'Date :’ field in the YAML header (between the '---' lines at the top of the file), in USA style of writing (e.g. 07 June 2021). This is very important as it will order the articles by desscending date.
  • You also need to edit the 'Title’ and 'Description’ of this new file, which both will be displayed on the blog articles list. You can also add a picture if needed in the 'Img’ field.
  • Add as many articles as you need by creating one such new file per article.
  • There is no need to restart anything, your blog and article should now be displayed properly, and the list of articles be updated too.

Demo : link

Screenshot

Clean-Blog-Screenshot