/gelati-sugarfree

A+ Retrofitted Blogger/Blogspot v2 Template

Primary LanguageJavaScriptMIT LicenseMIT

Gelati Sugarfree

A+ Retrofitted Blogger/Blogspot v2 Template

  • To see it in action:
    • News\Glitch - Get a glimpse and some inspiration from this "Real world" News-Blog, showing a customized Theme.
    • Gelati Sugarfree - Afterwards consult the basic examples from the Project's Demo-Blog, showing the default Theme.
  • Further Infos: Documentation and About

Gelati Sugarfree https://www.flaticon.com/authors/smalllikeart/


Getting Started

Please consult Gelati Sugarfree's Quick Setup Guide regarding Installation, Configuration and Customization before Importing one of the available Blog-Themes.

Features and Usage

  • Although optional, you might consider to import the provided Demo-Content which provides representational examples regarding Gelati Sugarfree's Features and Usage.
  • Feel free to delete or unplublish unnecessary Posts, Pages and Labels after you got a grasp on its internals and mechanics.

Demo-Content Preperation

  • For a correct functionality of NumberedPagination: Some of the provided Demo-Content Posts contain Jump-Break directives, an optional feature Blogger/Blogpost utilizes to - among other non-performance related usecases - ease performance impacts when generating IndexType Blog-Views with Post-content exceeding a certain amount of textual data.

The Blogger/Blogpost Post-Editor allows to insert a Jump-Break directive which will be represented by the following inline-expression:

<!--more-->
Unfortunately, whenever exporting content in Blogger/Blogspot these expressions get converted to plain <a>-Tags:
<a name='more'> resp. &lt;a name='more'&gt;
So, afterwards after you have imported such content in Blogger/Blogspot you have to manual replace all occurences of "ill-converted" Jump-Breaks to their correct inline-expression with the help of Post-Editor.

  • For a correct presentation of the PopularPosts widget your current published Posts need to have a certain amount of views. Especially in case of starting from scratch, please do ensure you have actually viewed at least numItemsToShow of your favorite Posts a certain amount of times to generate actual views.

Final Notes

As stated in Gelati Sugarfree's Advanced Setup Guide

  • For use-cases, including custom domain usage, you are good to go, even when using hosted Assets as referenced in the provided Blog-Themes.
  • If you want to self-host these static assets feel free to download Blog-Resources, provided pre-built here on GitHub.

If you followed these steps and everything worked well you might already have a working instance of Gelati Sugarfree 🎉.




Optional Stuff

Just in case you want to re-build Blog-Resources on your own, e.g.

  • check local built-code against Gelati Sugarfree's provided or hosted Blog-Resources
  • employ the provided Blogpost-Style toolchain

see the following cPanel based examples.

Get Gelati Sugarfree

Terminal

$ cd ~/workspace
$ git clone... (or git pull)
$ cd gelati-sugarfree

Build Blog-Resources

Start Node.js App

  • Example settings:
    example.com/blogresources /home/examplecom/workspace/gelati-sugarfree/blog-resources

Terminal

$ source /home/examplecom/nodevenv/workspace/gelati-sugarfree/blog-resources/10/bin/activate && cd /home/examplecom/workspace/gelati-sugarfree/blog-resources

$ npm install

$ npm run build:js
$ npm run build:images
$ npm run build:css

$ deactivate

Stop Node.js App

Build Blogpost-Style

Start Node.js App

  • Example settings:
    example.com/blogpoststyle /home/examplecom/workspace/gelati-sugarfree/blogpost-style

Terminal

$ source /home/examplecom/nodevenv/workspace/gelati-sugarfree/blogpost-style/10/bin/activate && cd /home/examplecom/workspace/gelati-sugarfree/blogpost-style

$ npm install

$ npm run rultor

$ deactivate

Stop Node.js App

Check local-built /dist/ against cloned /dist/

Terminal

$ cd ~/workspace/gelati-sugarfree

$ git status

    On branch master
    Your branch is up to date with 'origin/master'.

    Changes not staged for commit:
    (use "git add <file>..." to update what will be committed)
    (use "git restore <file>..." to discard changes in working directory)
            modified:   blog-resources/dist/images/customized_icon.png
            modified:   blog-resources/dist/images/icon.png

    Untracked files:
    (use "git add <file>..." to include in what will be committed)
            blog-resources/tmp/
            blogpost-style/tmp/

    no changes added to commit (use "git add" and/or "git commit -a")