Personal Notebook and Blogging Platform with Hugo

github repo

A personal notebook and blogging platform built with Hugo and the Anubis theme. It offers a minimalist and responsive design tailored for capturing ideas, reflections, and personal articles efficiently.


Features

  • Minimalist, responsive design using the Anubis Hugo theme
  • Dark mode support with automatic and manual toggling
  • Pagination and archive support for posts
  • Taxonomies: categories, tags, and series
  • Social icons and RSS feed integration
  • Multiple comment system support: Disqus, Isso, Utteranc.es
  • Google Analytics integration
  • Custom CSS and JavaScript support
  • Multilingual support with translations
  • Copy code button for code blocks
  • Related posts display (Read Next section)
  • Math typesetting support via KaTeX
  • Hidden posts accessible only by direct link
  • Webmentions and SEO optimizations

Tech Stack

  • Hugo (extended version) static site generator
  • Anubis Hugo theme
  • HTML, CSS, JavaScript
  • Google Analytics for tracking
  • Optional comment systems: Disqus, Isso, Utteranc.es

Getting Started

Prerequisites

Installation

Clone the repository:

git clone https://github.com/justin-napolitano/bbc.git
cd bbc

Add the Anubis theme as a git submodule:

git submodule add https://github.com/mitrichius/hugo-theme-anubis.git themes/anubis

Running the site locally

hugo server -D

Visit http://localhost:1313 in your browser to view the site.

Building for production

hugo

The generated static site will be located in the public/ directory.

Project Structure

bbc/
├── archetypes/          # Content archetypes for new posts
├── assets/              # Asset files like CSS and JS
├── config.yaml          # Site configuration file
├── content/             # Markdown content files (posts, pages)
├── layouts/             # Hugo layout templates
├── public/              # Generated static site output
├── resources/           # Hugo resource files
├── static/              # Static files served as-is
├── themes/              # Hugo themes (Anubis as submodule)
├── README.md            # Project documentation

Future Work / Roadmap

  • Enhance multilingual support and translations
  • Integrate additional comment system options
  • Improve SEO and webmention features
  • Add more customizable theme options
  • Automate deployment workflows
  • Expand documentation with usage examples and contribution guidelines

hjkl / arrows · / search · :family · :tag · :datefrom · :dateto · ~/entries/slug · Ctrl+N/Ctrl+P for suggestions · Ctrl+C/Ctrl+G to cancel
entries 201/201 · entry -/-
:readyentries 201/201 · entry -/-