egoroff.spb.ru

Personal website and blog platform built with Rust backend and Vue.js frontend.

Overview

This is the source code for egoroff.spb.ru, a personal website that includes:

• Blog with posts and announcements
• Portfolio section
• Apache documentation viewer
• Admin interface for content management
• Search functionality
• IndieWeb support (Micropub, Webmention)

Architecture

The project consists of several components:

Backend (Rust)

• egoroff: Main CLI application with server and migration commands
• kernel: Core business logic and data models
• server: HTTP server with REST API and template rendering
• migrate: Data migration utilities

Frontend (Vue.js)

• ui: Vue 2 application with TypeScript
• Modern UI with Bootstrap and FontAwesome icons
• Admin interface for content management
• Responsive design

Documentation

• apache: Apache documentation in XML format with XSLT stylesheets
• templates: Template files for various content types

Technologies

Backend

• Rust with Tokio async runtime
• SQLite for data storage
• Askama for template rendering
• Tower for HTTP middleware
• Serde for serialization

Frontend

• Vue.js 2 with TypeScript
• Bootstrap 4 for styling
• FontAwesome for icons
• Axios for HTTP requests
• Vue Router for navigation

DevOps

• Docker for containerization
• Python build scripts for documentation processing
• Node.js for frontend build process

Prerequisites

• Rust (latest stable)
• Node.js (LTS)
• Python 3
• Docker (optional)

Building

Local Development

1. Build the backend:

   cd egoroff
   cargo build

2. Build the frontend:

   cd ui
   npm install
   npm run build

3. Build Apache documentation:

   python3 build.py

Docker Build

docker build -t egoroff/egoroff .

Running

Local Development

1. Start the server:

   cd egoroff
   cargo run -- server

2. For development with migration:

   cargo run --features migrating -- server

Docker

docker run -p 4200:4200 -p 4201:4201 egoroff/egoroff server

Configuration

The application uses environment variables for configuration:

• EGOROFF_HTTP_PORT: HTTP port (default: 4200)
• EGOROFF_HTTPS_PORT: HTTPS port (default: 4201)
• EGOROFF_DATA_DIR: Data storage directory
• EGOROFF_HOME_DIR: Home directory

Features

Blog

• Markdown support for posts
• Tags and categories
• RSS/Atom feeds
• Social sharing

Portfolio

• Project showcase
• Download section
• Apache documentation viewer

Admin Interface

• Post management (create, edit, delete)
• Download management
• User management
• Content preview

IndieWeb Support

• Micropub endpoint for posting
• Webmention support
• Microformats markup

Search

• Full-text search across posts
• Real-time search results
• Search result highlighting

Development

Project Structure

egoroff.spb.ru/
├── egoroff/           # Rust workspace
│   ├── egoroff/      # Main CLI application
│   ├── kernel/       # Core business logic
│   ├── server/       # HTTP server
│   └── migrate/      # Migration utilities
├── ui/               # Vue.js frontend
├── apache/           # Apache documentation
├── templates/        # Template files
├── static/           # Static assets
└── build.py          # Build script

Available Commands

• cargo run -- server: Start the web server
• cargo run -- version: Show version information
• cargo run --features migrating -- migrate: Run data migrations

Code Quality

The project enforces strict Rust linting:

• No unsafe code allowed
• Comprehensive error handling
• Async/await patterns
• Type safety throughout

License

This project is licensed under the terms specified in the LICENSE.txt file.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Contact

For questions or issues, please open an issue on GitHub or contact the maintainer.