PKB-theme Demo

Setup

Setting up GitHub Pages

July 1, 2023 documentation github-pages , setup , documentation
A comprehensive guide to set up GitHub Pages with PKB-theme

Setting up GitHub Pages with PKB-theme

This guide explains how to set up GitHub Pages for your PKB-theme repository.

Important Files

  • _config.yml - Main Jekyll configuration file
  • Gemfile - Ruby dependencies for GitHub Pages
  • index.md - Your homepage content
  • _layouts/ - Theme layout files
  • assets/ - Static files like CSS, images, etc.

Setup Steps

  1. Configure _config.yml

    • Ensure your _config.yml has the correct theme settings:
    remote_theme: username/PKB-theme

  2. Enable GitHub Pages

Self-Hosted Analytics for PKB-theme

June 1, 2023 documentation analytics , privacy , self-hosted ...
A comprehensive guide for implementing privacy-focused, FOSS analytics in your PKB-theme site

Self-Hosted Analytics for PKB-theme

This guide helps you implement visitor analytics for your PKB-theme using privacy-respecting, FOSS (Free and Open Source Software) solutions. Unlike commercial analytics platforms that collect excessive data and track users across sites, these tools focus on essential metrics while respecting user privacy.

Analytics Solutions Comparison

SolutionTechnologiesSizePrivacy FeaturesComplexityKey AdvantagesLimitations
PlausibleElixir/PostgreSQL<1KBNo cookies, GDPR compliantEasyLightweight script, simple dashboardLimited segmentation compared to Matomo
UmamiNext.js/PostgreSQL~2KBNo cookies, GDPR compliantEasyEasy deployment options, multiple usersFewer features than Matomo
MatomoPHP/MySQL~20KBConfigurable tracking, opt-outMediumFeature-rich, similar to GARequires more resources
Fathom LiteGo/SQLite~1KBMinimal data collectionEasyExtremely lightweightLimited features
ShynetPython/Django~0KB*Can work without JSMediumWorks with JS disabledLess intuitive interface

*Shynet can use tracking pixels instead of JavaScript