Acblog

Overview

AcBlog is an open source extensible static and dynamic blog system. It offers a range of features including WebAssembly and SignalR support, single page app architecture, markdown rendering, LaTeX math rendering, media links, password protection, visitor statistics, comments, archives, sitemap, feeds, search, Docker deployment, and more.

Features

• WebAssembly & SignalR: AcBlog is based on WebAssembly and SignalR, allowing for efficient and real-time communication between the client and server.
• Single Page App: AcBlog utilizes a single page app architecture, providing a seamless and interactive user experience.
• Installable & Offline: The blog can be installed as a standalone application and accessed offline.
• Static & Dynamic Backend: AcBlog supports both static-file and dynamic server backends, providing flexibility and scalability.
• Post Category & Keywords: Organize blog posts by categories and add keywords for better searchability.
• Markdown Rendering: AcBlog renders Markdown syntax for easy content creation.
• LaTeX Math Rendering: Write complex mathematical equations using LaTeX syntax, which is rendered by AcBlog.
• Diagram Rendering: Easily create diagrams using supported syntax and have them rendered in the blog.
• Media Links: Embed media links such as images and videos within blog posts.
• Password Protection: Protect selected blog posts or pages with password authentication.
• Table of Contents: Generate a table of contents for long blog posts to improve readability.
• Slides: Create interactive slide presentations within your blog.
• Custom Pages & Layout: Customize the layout and design of your blog pages.
• Visitor Statistic: Track and analyze visitor statistics to gain insights into blog performance.
• Comments: Allow readers to leave comments on blog posts.
• Archives with Timeline: Display archives with a timeline view for easy navigation.
• Sitemap: Generate a sitemap to improve search engine visibility.
• Feeds (Atom & RSS): Offer Atom and RSS feeds for easy subscription to blog updates.
• Search: Enable a powerful search functionality with Open Search support.
• Docker Deployment: Easily deploy AcBlog using Docker containers.
• SDK: Utilize AcBlog's SDK to communicate with the AcBlog server and customize functionalities.

Frontend

1. Use AcBlog's WebAssembly client docker image.
2. Apply settings through volume configuration.

For GitHub Pages hosting, use the wasm-ghpages-generate-action for easier deployment.

Backend - Static

1. Use AcBlog's SDK to generate the static backend.
2. For GitHub Pages hosting, use the static-backend-generate-action for automated generation.

Backend - Dynamic

1. Use AcBlog's API server docker image.
2. Deploy the API server using docker-compose.

Make sure to restart the API container after initializing the database.

SDK

1. Install .NET SDK 5.0, NodeJS 12.x, and npm.
2. Install Gulp and Libman.
3. Restore dependencies.
4. Add NuGet source: StardustDL's NUGET feeds.
5. Build the project.
6. Test and benchmark as needed.

Dependencies include .NET & ASP.NET, Entity Framework, ant-design-blazor, scriban, RazorComponents.Markdown, loment, and listat.

Summary

AcBlog is a feature-rich open source blog system that leverages WebAssembly and SignalR for a dynamic and interactive user experience. It offers various functionalities such as markdown rendering, LaTeX math rendering, media links, password protection, visitor statistics, comments, archives, sitemap, feeds, Docker deployment, and more. With its extensible architecture and SDK, AcBlog provides flexibility for customization and easy integration with existing systems. The installation process involves setting up the frontend, choosing between static and dynamic backends, and utilizing the SDK for further customization and development.