Skip to content

BenjaminWatts/watts-wrong

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

73 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Watt's Wrong? - UK Energy Policy Analysis

Build and Deploy Build Assets Website License: MIT

🚧 DRAFT IN PROGRESS - WORK IN PROGRESS 🚧

A comprehensive guide to what's wrong with Britain's electricity and energy system - covering grid infrastructure, renewable energy policies, market failures, and policy chaos. Perfect for energy professionals, policymakers, and anyone interested in understanding UK energy dysfunction.

⚠️ IMPORTANT NOTICE: This book is currently a DRAFT IN PROGRESS. Content is being actively developed and may contain incomplete sections, placeholder text, or information that requires verification. Please check back regularly for updates and improvements.

Build and Deploy Build Assets Deploy to GitHub Pages

πŸ“– Read Online

🌐 Read the book online - Complete with interactive table of contents, chapter navigation, and mobile-optimized reading experience.

🎯 Target Audience

  • Energy Professionals seeking comprehensive understanding beyond their specialty
  • Policy Makers analyzing UK energy system failures and opportunities
  • Researchers & Students studying energy policy, economics, and regulation
  • Industry Stakeholders understanding market dynamics and regulatory challenges
  • Concerned Citizens wanting to understand Britain's energy system problems

πŸ” Key Topics Covered

  • Grid Infrastructure - Transmission constraints, regional disparities, and connectivity issues
  • Renewable Energy Policy - Feed-in tariffs, ROCs, CFD mechanisms, and subsidy chaos
  • Market Failures - Price caps, electricity levies, smart meter rollout problems
  • Policy Inconsistencies - Brexit impacts, regulatory fragmentation, and political instability
  • Consumer Issues - Energy poverty, billing problems, and market manipulation
  • Future Challenges - Energy storage, grid balancing, and transition planning

πŸ“š Table of Contents

πŸ“₯ Download Latest Builds

All formats can be built locally using the provided scripts:

πŸš€ Quick Downloads

πŸ“₯ Direct Download Links - Ready to read formats

Format Description Download Link File Size
🌐 Website Read online with full formatting 🌐 Read Online -
πŸ“š EPUB For most e-readers and mobile devices ⬇️ Download EPUB 3.2 MB
πŸ“± MOBI For Amazon Kindle devices ⬇️ Download MOBI 275 KB
πŸ“„ PDF For printing and desktop reading ⬇️ Download PDF 3.5 MB

πŸ”„ Auto-Build System: All downloads are automatically built and updated on every commit using a pre-commit hook. No manual builds required!

πŸ“‹ How to Download

Option 1: Build Locally (Recommended)

  1. Clone this repository: git clone https://github.com/benjaminwatts/watts-wrong.git
  2. Install dependencies: npm install
  3. Build all formats: npm run build:complete
  4. Find your files in the dist/ directory

Option 2: Download Built Files

The built files are available in the dist/ directory:

  • EPUB: dist/watts-wrong.epub - For most e-readers
  • MOBI: dist/watts-wrong.mobi - For Kindle devices
  • Website: dist/website/ - Read online in your browser

πŸ’‘ For PDF generation, you'll need LaTeX installed: brew install --cask mactex (macOS) or sudo apt-get install texlive-full (Ubuntu/Debian)

πŸ“š Table of Contents

Introduction

Part 1: The Generation Mess

Part 2: The Grid & Infrastructure Problems

Part 3: The Consumer & Market Failures

Part 4: The Policy & Pricing Chaos

Part 5: The Human Factor

Conclusion

πŸš€ Quick Start

Reading Online

Simply browse the chapters above or visit the GitHub Pages site for the best reading experience.

Building for Kindle/EPUB/PDF/Audiobook/Website

To build the book for different formats:

# Install dependencies
npm install

# Build EPUB
npm run build:epub

# Build Kindle (MOBI)
npm run build:kindle

# Build PDF
npm run build:pdf

# Build Audiobook
npm run build:audiobook

# Build Website
npm run build:website

# Build all formats
npm run build:complete

The built files will be available in the dist/ directory.

πŸ“ Contributing

This book is written in Markdown format. To contribute:

  1. Fork the repository
  2. Create a feature branch
  3. Edit the Markdown files in the chapters/ directory
  4. Run pre-commit run --all-files for spelling checks
  5. Submit a pull request

πŸ”§ Chapter Development Priorities

🚨 High Priority - Needs Significant Work

πŸ”„ Medium Priority - Needs Enhancement

βœ… Good Quality - Minor Improvements Needed

βœ… Recently Created

πŸ› οΈ Development

Project Structure

watts-wrong/
β”œβ”€β”€ chapters/          # Markdown chapter files
β”œβ”€β”€ assets/           # Images, diagrams, CSS files
β”œβ”€β”€ scripts/          # Build scripts
β”œβ”€β”€ dist/             # Built output files
β”œβ”€β”€ README.md         # This file (also serves as online reader)
└── package.json      # Build dependencies

Adding New Chapters

  1. Create a new Markdown file in the chapters/ directory
  2. Follow the naming convention: XX-chapter-title.md
  3. Update the table of contents in this README
  4. The build scripts will automatically include new chapters

πŸ”§ Build System

The build system uses:

  • Pandoc: For converting Markdown to EPUB/MOBI/PDF
  • Node.js: For build automation
  • Build Scripts: For automated local builds and deployments
  • Text-to-Speech: For generating audiobooks (local and cloud options)
  • CSS Styling: For consistent formatting across all formats

πŸš€ Local Builds

Run these commands to build all formats:

  • βœ… Website build: npm run build:website
  • βœ… EPUB generation: npm run build:epub
  • βœ… MOBI generation: npm run build:kindle
  • βœ… PDF generation: npm run build:pdf (requires LaTeX)
  • βœ… Audiobook creation: npm run build:audiobook
  • βœ… All formats at once: npm run build:complete

πŸ“± Publishing

GitHub Pages

The book automatically deploys to GitHub Pages when you push to the main branch.

Kindle Publishing

  1. Build the MOBI file: npm run build:kindle
  2. Upload to Kindle Direct Publishing (KDP)
  3. Follow Amazon's publishing guidelines

PDF Publishing

  1. Prerequisite: Install LaTeX first:
    • macOS: brew install --cask mactex
    • Ubuntu/Debian: sudo apt-get install texlive-full
    • Windows: Install MiKTeX from https://miktex.org/
  2. Build the PDF: npm run build:pdf
  3. Perfect for:
    • Printing and physical distribution
    • Academic submissions
    • Professional presentations
    • Offline reading

Audiobook Publishing

  1. Build the audiobook: npm run build:audiobook
  2. Choose your TTS provider:
    • Local: Free, uses system TTS (macOS: say, Linux: espeak)
    • Cloud: High quality, paid services (Azure, Google, ElevenLabs, OpenAI)
  3. Upload to audiobook platforms (Audible, etc.)

πŸ“„ License

This work is licensed under the MIT License - feel free to use, modify, and distribute as long as you include the original license and attribution.

🌟 Features

  • πŸ“± Responsive Design - Optimized for all devices
  • 🎧 Audiobook Generation - Multiple TTS options (local and cloud)
  • πŸ“š Multi-format Export - EPUB, MOBI, PDF, and website
  • πŸ€– Automated Builds - Build scripts handle everything locally
  • πŸ“– Markdown Source - Easy to contribute and modify
  • 🌐 GitHub Pages - Instant online publishing

Built with ❀️ using Markdown and open source tools

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •