siru 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a129c8c8137e9ef0ffef0839973bbf761105a083edbbd3ba1b519e61a521dfbe
+  data.tar.gz: 8341a02414f843007b01dba2527c6d6a21ef96c0dd447eb4eb91353200e50e23
+SHA512:
+  metadata.gz: f4d9b74fa3257a7ecb91b1ff0b188949cfa2db8b6012957e3e7735f64a0d37648cea45d6cbb00a6adf4bed78a1c18f685112fd7f3710060d18a526c1e34f6879
+  data.tar.gz: 2afb22464e6303caee943ddfc2d2dc24ec35df002be29b6f07f4bafbeefa4e0c13c5ccb11fc896931aea948cb8ff7f40e29c5852656684f54c242819adb34e4c

data/Gemfile

@@ -0,0 +1,19 @@
+source 'https://rubygems.org'
+
+gem 'redcarpet', '~> 3.6'
+gem 'liquid', '~> 5.4'
+gem 'toml', '~> 0.3'
+gem 'sassc', '~> 2.4'
+gem 'listen', '~> 3.8'
+gem 'webrick', '~> 1.8'
+gem 'front_matter_parser', '~> 1.0'
+gem 'fileutils'
+gem 'pathname'
+gem 'yaml'
+gem 'base64'
+gem 'logger'
+
+group :development do
+  gem 'rspec', '~> 3.12'
+  gem 'rubocop', '~> 1.56'
+end

data/README.md

@@ -0,0 +1,164 @@
+# Siru
+
+Siru is a static site generator inspired by [Hugo](https://gohugo.io/), built with Ruby.
+
+## Features
+- Markdown content rendering
+- Theme support
+- Live server with reload
+
+## Installation
+
+### Via APT Repository (Ubuntu/Debian)
+
+```bash
+# Add the repository
+echo "deb [trusted=yes arch=amd64] https://raw.githubusercontent.com/timappledotcom/siru-apt-repo/main/ stable main" | sudo tee /etc/apt/sources.list.d/siru.list
+
+# Update package list
+sudo apt update
+
+# Install Siru
+sudo apt install siru
+```
+
+### Via .deb Package
+
+```bash
+wget https://github.com/timappledotcom/siru/releases/download/v0.2.0/siru_0.2.0_all.deb
+sudo dpkg -i siru_0.2.0_all.deb
+```
+
+### Via Flatpak
+
+```bash
+flatpak install --user siru-0.2.0.flatpak
+```
+
+## Usage
+
+1. **Create a new site**
+   ```
+   siru new [sitename]
+   ```
+
+2. **Create a new post**
+   
+   **Quick method (auto-generates and opens in editor):**
+   ```
+   siru new post "My Post Title"
+   siru new post "My Draft Post" --draft
+   ```
+   
+   This command will:
+   - Create a new markdown file in `content/posts/`
+   - Generate a filename from the title (e.g., "my-post-title.md")
+   - Add proper front matter with title, date, and draft status
+   - Open the file in your default editor (set via `$EDITOR` or `$VISUAL`)
+   
+   **Manual method:**
+   - Navigate to the `content/posts/` directory.
+   - Create a new Markdown file with TOML or YAML front matter:
+   
+   ```toml
+   +++
+   title = "My Awesome Post"
+   date = "2025-07-14"
+   draft = true
+   +++
+   
+   Content goes here.
+   ```
+
+3. **Create a new page**
+   - Navigate to the `content/` directory (not inside `posts`).
+   - Create a new Markdown file:
+
+   ```toml
+   +++
+   title = "About Us"
+   date = "2025-07-14"
+   draft = true
+   +++
+
+   About us content.
+   ```
+
+4. **Build the site**
+   ```
+   cd [sitename]
+   siru build
+   ```
+
+5. **Serve the site**
+   ```
+   siru serve
+   ```
+
+### Drafts
+
+- **Draft Mode**: To include draft posts in your build or serve, add the `--draft` option.
+
+```bash
+siru build --draft
+siru serve --draft
+```
+
+- **Draft Status**: Posts with `draft = true` in their front matter will not be published unless the `--draft` option is used.
+
+## Configuration
+
+Siru sites are configured through a `config.toml` file in the root directory:
+
+```toml
+baseURL = "https://yoursite.com/"
+languageCode = "en-us"
+title = "My Awesome Site"
+theme = "paper"
+
+[params]
+color = "linen"  # Theme color: linen, wheat, gray, light
+bio = "Welcome to my blog!"
+twitter = "yourusername"
+github = "yourusername"
+mastodon = "https://mastodon.social/@yourusername"
+bluesky = "yourusername.bsky.social"
+```
+
+## Front Matter
+
+Siru supports both TOML and YAML front matter:
+
+### TOML Front Matter
+```toml
++++
+title = "Post Title"
+date = "2025-07-14"
+draft = false
+tags = ["ruby", "static-site"]
+summary = "A brief summary of the post"
++++
+```
+
+### YAML Front Matter
+```yaml
+---
+title: "Post Title"
+date: "2025-07-14"
+draft: false
+tags: ["ruby", "static-site"]
+summary: "A brief summary of the post"
+---
+```
+
+### Available Front Matter Fields
+- `title`: Post/page title
+- `date`: Publication date
+- `draft`: Whether the content is a draft (true/false)
+- `tags`: Array of tags for the post
+- `summary`: Brief description (used in post lists)
+- `slug`: Custom URL slug (optional)
+
+## License
+
+This project is licensed under the terms of the [GPL-3.0 license](LICENSE).

data/bin/siru

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/siru'
+
+require 'optparse'
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Usage: siru [options] [command]"
+  
+  opts.separator ""
+  opts.separator "Commands:"
+  opts.separator "    new SITENAME        Create a new site"
+  opts.separator "    new post TITLE      Create a new post"
+  opts.separator "    build               Build the site"
+  opts.separator "    serve               Serve the site locally"
+  opts.separator "    help                Show this help"
+  opts.separator ""
+  opts.separator "Options:"
+  
+  opts.on("-p", "--port PORT", "Port to serve on (default: 3000)") do |port|
+    options[:port] = port.to_i
+  end
+  
+  opts.on("-w", "--watch", "Watch for changes and rebuild") do
+    options[:watch] = true
+  end
+  
+  opts.on("-d", "--draft", "Include draft posts") do
+    options[:draft] = true
+  end
+  
+  opts.on("-h", "--help", "Show this help") do
+    puts opts
+    exit
+  end
+end.parse!
+
+command = ARGV[0]
+
+case command
+when 'new'
+  subcommand = ARGV[1]
+  case subcommand
+  when 'post'
+    post_title = ARGV[2..-1].join(' ')
+    if post_title.empty?
+      puts "Error: Please provide a post title"
+      puts "Usage: siru new post TITLE"
+      exit 1
+    end
+    Siru::CLI.new_post(post_title, options)
+  else
+    # Treat as site name for backward compatibility
+    site_name = subcommand
+    if site_name.nil?
+      puts "Error: Please provide a site name or 'post' subcommand"
+      puts "Usage: siru new SITENAME"
+      puts "       siru new post TITLE"
+      exit 1
+    end
+    Siru::CLI.new_site(site_name)
+  end
+when 'build'
+  Siru::CLI.build(options)
+when 'serve'
+  Siru::CLI.serve(options)
+when 'help', nil
+  puts "Siru - A Hugo-inspired static site generator"
+  puts ""
+  puts "Usage: siru [command] [options]"
+  puts ""
+  puts "Commands:"
+  puts "  new SITENAME        Create a new site"
+  puts "  new post TITLE      Create a new post"
+  puts "  build               Build the site"
+  puts "  serve               Serve the site locally"
+  puts "  help                Show this help"
+  puts ""
+  puts "Options:"
+  puts "  -p, --port PORT     Port to serve on (default: 3000)"
+  puts "  -w, --watch         Watch for changes and rebuild"
+  puts "  -d, --draft         Include draft posts"
+  puts "  -h, --help          Show this help"
+else
+  puts "Unknown command: #{command}"
+  puts "Run 'siru help' for usage information"
+  exit 1
+end

data/lib/siru/builder.rb

@@ -0,0 +1,126 @@
+module Siru
+  class Builder
+    def initialize(site, options = {})
+      @site = site
+      @options = options
+      @output_dir = 'public'
+    end
+    
+    def build
+      puts "Building site..."
+      
+      # Clean output directory
+      FileUtils.rm_rf(@output_dir)
+      FileUtils.mkdir_p(@output_dir)
+      
+      # Copy static files
+      copy_static_files
+      
+      # Build pages
+      build_home_page
+      build_post_pages
+      
+      puts "Site built successfully in #{@output_dir}/"
+    end
+    
+    def clean
+      FileUtils.rm_rf(@output_dir)
+      puts "Cleaned output directory: #{@output_dir}"
+    end
+    
+    private
+    
+    def copy_static_files
+      # Copy theme static files
+      @site.theme.static_files.each do |file|
+        relative_path = file.gsub(@site.theme.path + '/static/', '')
+        output_path = File.join(@output_dir, relative_path)
+        
+        FileUtils.mkdir_p(File.dirname(output_path))
+        FileUtils.cp(file, output_path)
+      end
+      
+      # Copy site static files
+      static_dir = 'static'
+      if Dir.exist?(static_dir)
+        Dir.glob(File.join(static_dir, '**', '*')).each do |file|
+          next unless File.file?(file)
+          
+          relative_path = file.gsub(static_dir + '/', '')
+          output_path = File.join(@output_dir, relative_path)
+          
+          FileUtils.mkdir_p(File.dirname(output_path))
+          FileUtils.cp(file, output_path)
+        end
+      end
+    end
+    
+    def build_home_page
+      variables = {
+        'site' => site_variables,
+        'posts' => @site.posts.map { |post| post_variables(post) },
+        'page_title' => 'Home',
+        'bg_color' => color_for_theme
+      }
+      
+      content = @site.theme.render_layout('index', variables)
+      html = @site.theme.render_layout('baseof', variables.merge('content' => content))
+      
+      File.write(File.join(@output_dir, 'index.html'), html)
+    end
+    
+    def build_post_pages
+      @site.posts.each do |post|
+        variables = {
+          'site' => site_variables,
+          'post' => post_variables(post),
+          'page_title' => post.title,
+          'bg_color' => color_for_theme
+        }
+        
+        content = @site.theme.render_layout('single', variables)
+        html = @site.theme.render_layout('baseof', variables.merge('content' => content))
+        
+        # Create directory structure
+        post_dir = File.join(@output_dir, 'posts', post.slug)
+        FileUtils.mkdir_p(post_dir)
+        
+        File.write(File.join(post_dir, 'index.html'), html)
+      end
+    end
+    
+    def site_variables
+      {
+        'title' => @site.title,
+        'base_url' => @site.base_url,
+        'language_code' => @site.language_code,
+        'params' => @site.params
+      }
+    end
+    
+    def post_variables(post)
+      {
+        'title' => post.title,
+        'date' => post.date,
+        'slug' => post.slug,
+        'url' => post.url,
+        'summary' => post.summary,
+        'tags' => post.tags,
+        'rendered_content' => post.rendered_content,
+        'content' => post.content
+      }
+    end
+    
+    def color_for_theme
+      color_map = {
+        'linen' => '#faf8f1',
+        'wheat' => '#f8f5d7',
+        'gray' => '#fbfbfb',
+        'light' => '#fff',
+        'catppuccin-mocha' => '#1e1e2e'
+      }
+      
+      color_map[@site.params['color']] || color_map['linen']
+    end
+  end
+end

data/lib/siru/cli.rb

@@ -0,0 +1,155 @@
+module Siru
+  class CLI
+    def self.new_site(name)
+      puts "Creating new site: #{name}"
+      
+      # Get the original working directory from environment variable or current directory
+      original_dir = ENV['CD'] || Dir.pwd
+      target_dir = File.expand_path(name, original_dir)
+      
+      FileUtils.mkdir_p(target_dir)
+      Dir.chdir(target_dir) do
+        # Create directory structure
+        %w[content content/posts static themes public].each do |dir|
+          FileUtils.mkdir_p(dir)
+        end
+        
+        # Create config file
+        config = {
+          'baseURL' => 'http://localhost:3000/',
+          'languageCode' => 'en-us',
+          'title' => name.capitalize,
+          'theme' => 'paper',
+          'params' => {
+            'color' => 'linen',
+            'bio' => 'A blog powered by Siru',
+            'disableHLJS' => true,
+            'disablePostNavigation' => true,
+            'monoDarkIcon' => true,
+            'math' => true,
+            'localKatex' => false
+          }
+        }
+        
+        File.write('config.toml', TOML::Generator.new(config).body)
+        
+        # Create sample post
+        sample_post = <<~POST
+          +++
+          title = "Hello Siru"
+          date = "#{Date.today.strftime('%Y-%m-%d')}"
+          draft = false
+          +++
+          
+          Welcome to your new Siru site!
+          
+          This is your first post. Edit or delete it and start blogging!
+        POST
+        
+        File.write('content/posts/hello-siru.md', sample_post)
+        
+        # Copy theme files
+        siru_gem_dir = File.expand_path('../../..', __FILE__)
+        source_theme_dir = File.join(siru_gem_dir, 'themes', 'paper')
+        target_theme_dir = File.join('themes', 'paper')
+        
+        if Dir.exist?(source_theme_dir)
+          FileUtils.cp_r(source_theme_dir, 'themes/')
+          puts "Theme 'paper' copied successfully"
+        else
+          puts "Warning: Theme 'paper' not found in #{source_theme_dir}"
+        end
+        
+        puts "Site created successfully!"
+        puts "To get started:"
+        puts "  cd #{name}"
+        puts "  siru serve"
+      end
+    end
+    
+    def self.build(options = {})
+      # Get the original working directory from environment variable or current directory
+      original_dir = ENV['CD'] || Dir.pwd
+      config_path = File.join(original_dir, 'config.toml')
+      
+      unless File.exist?(config_path)
+        puts "Error: Not in a Siru site directory. Run 'siru new SITENAME' first."
+        exit 1
+      end
+      
+      Dir.chdir(original_dir) do
+        config = Config.load
+        site = Site.new(config, options)
+        builder = Builder.new(site, options)
+        builder.build
+      end
+    end
+    
+    def self.serve(options = {})
+      # Get the original working directory from environment variable or current directory
+      original_dir = ENV['CD'] || Dir.pwd
+      config_path = File.join(original_dir, 'config.toml')
+      
+      unless File.exist?(config_path)
+        puts "Error: Not in a Siru site directory. Run 'siru new SITENAME' first."
+        exit 1
+      end
+      
+      Dir.chdir(original_dir) do
+        config = Config.load
+        site = Site.new(config, options)
+        server = Server.new(site, options)
+        server.start
+      end
+    end
+    
+    def self.new_post(title, options = {})
+      # Get the original working directory from environment variable or current directory
+      original_dir = ENV['CD'] || Dir.pwd
+      config_path = File.join(original_dir, 'config.toml')
+      
+      unless File.exist?(config_path)
+        puts "Error: Not in a Siru site directory. Run 'siru new SITENAME' first."
+        exit 1
+      end
+      
+      # Generate filename from title
+      filename = title.downcase.gsub(/\s+/, '-').gsub(/[^a-z0-9\-]/, '') + '.md'
+      filepath = File.join(original_dir, 'content', 'posts', filename)
+      
+      # Check if file already exists
+      if File.exist?(filepath)
+        puts "Error: Post '#{filepath}' already exists."
+        exit 1
+      end
+      
+      # Create the posts directory if it doesn't exist
+      FileUtils.mkdir_p(File.dirname(filepath))
+      
+      # Generate post content
+      date = Date.today.strftime('%Y-%m-%d')
+      draft = options[:draft] ? 'true' : 'false'
+      
+      # Clean up the title (remove any surrounding quotes)
+      clean_title = title.gsub(/^["']|["']$/, '')
+      
+      post_content = <<~POST
+        +++
+        title = "#{clean_title}"
+        date = "#{date}"
+        draft = #{draft}
+        +++
+        
+        Write your post content here.
+      POST
+      
+      # Write the file
+      File.write(filepath, post_content)
+      puts "Created new post: #{filepath}"
+      
+      # Open in editor
+      editor = ENV['EDITOR'] || ENV['VISUAL'] || 'nano'
+      system("#{editor} #{filepath}")
+    end
+  end
+end

data/lib/siru/config.rb

@@ -0,0 +1,92 @@
+module Siru
+  class Config
+    class ConfigError < StandardError; end
+    
+    attr_reader :data
+    
+    def self.load(path = 'config.toml', strict: false)
+      new(path, strict: strict)
+    end
+    
+    def initialize(path = 'config.toml', strict: false)
+      @path = path
+      @strict = strict
+      @data = load_config
+    end
+    
+    def [](key)
+      @data[key]
+    end
+    
+    def []=(key, value)
+      @data[key] = value
+    end
+    
+    def fetch(key, default = nil)
+      @data.fetch(key, default)
+    end
+    
+    def get(key)
+      @data[key]
+    end
+    
+    def param(key)
+      return nil unless @data['params']
+      @data['params'][key]
+    end
+    
+    def params
+      @data['params'] || {}
+    end
+    
+    # Dynamic attribute access for config keys
+    def method_missing(method_name, *args, &block)
+      if args.empty? && @data.key?(method_name.to_s)
+        @data[method_name.to_s]
+      else
+        super
+      end
+    end
+    
+    def respond_to_missing?(method_name, include_private = false)
+      @data.key?(method_name.to_s) || super
+    end
+    
+    private
+    
+    def load_config
+      unless File.exist?(@path)
+        if @strict
+          raise ConfigError, "Configuration file #{@path} not found"
+        else
+          return default_config
+        end
+      end
+      
+      case File.extname(@path)
+      when '.toml'
+        TOML.load_file(@path)
+      when '.yaml', '.yml'
+        YAML.load_file(@path)
+      else
+        raise ConfigError, "Unsupported config format: #{@path}"
+      end
+    rescue Parslet::ParseFailed => e
+      raise ConfigError, "Error parsing TOML config: #{e.message}"
+    rescue Psych::SyntaxError => e
+      raise ConfigError, "Error parsing YAML config: #{e.message}"
+    end
+    
+    def default_config
+      {
+        'baseURL' => 'http://localhost:3000/',
+        'languageCode' => 'en-us',
+        'title' => 'My Siru Site',
+        'theme' => 'paper',
+        'params' => {
+          'color' => 'linen'
+        }
+      }
+    end
+  end
+end