saicaca/fuwari
Fuwari
Fuwari is a static site theme and markdown content framework designed for personal blog publishing. It provides a responsive visual template that renders markdown posts with a built-in dark mode and customizable colors.
The project distinguishes itself through a set of markdown extensions that add rich UI elements to articles, including callout blocks, dynamic repository cards that fetch live data via API, and advanced code styling with diff support and line numbering. It also includes a full-text site search mechanism to allow visitors to locate specific information across the blog's content.
The framework covers broader capabilities for content organization through tags and categories, the generation of automatic tables of contents, and the production of standardized RSS feeds for content syndication. A command-line utility is provided to automate the creation of new post files.
Features
- Blogging Platforms - Provides a complete framework for publishing personal blogs using markdown files and static site generation.
- Static Site Generators - Compiles markdown files and metadata into a standalone set of static HTML files for fast delivery.
- Static Site Themes - Ships as a responsive visual template for Hugo to render markdown posts with built-in dark mode.
- Markdown Extensions - Implements extended markdown features including callout blocks, dynamic repository cards, and advanced code styling.
- Markdown Renderers - Transforms custom markdown syntax into complex UI components like callout blocks and repository cards during build.
- Markdown Site Publishing - Transforms collections of markdown files into a structured, navigable web presence using metadata.
- Visual UI Extensions - Adds rich visual elements like callout blocks, repository cards, and advanced code styling to standard Markdown articles.
- Static Site Templating - Provides a pre-configured visual design for static sites with integrated search and smooth page transitions.
- Frontmatter - Uses structured YAML metadata embedded in file headers to organize categories, tags, and publication dates.
- Metadata-Based Organization - Categorizes blog posts using tags, categories, and publication dates to structure the site content.
- Markdown and Syntax Highlighting - Supports extended markdown features including embedded videos and advanced syntax-highlighted code blocks.
- Content Organization - Manages the structural organization of posts through tags, categories, and generated tables of contents.
- Table of Contents - Generates navigational lists of headings for long-form posts to allow quick jumping to specific sections.
- RSS Feed Generation - Produces standardized XML files from post metadata to enable content syndication via feed readers.
- Full Text Search - Provides a searchable interface using specialized indexing of page content to locate specific blog posts.
- Search Indexers - Implements a full-text search mechanism and indexing to allow visitors to locate specific information across the site.
- Callouts - Implements stylized information blocks such as notes, tips, and warnings to highlight content within posts.
- Code Diff Visualizers - Provides syntax highlighting for code differences to visually indicate additions and removals.
- CSS Variable Theming - Implements light and dark modes by updating global CSS variables to change the visual identity.
- Repository Cards - Embeds dynamic components that fetch and display live repository data from an external API.
- Site Theming - Allows for the customization of site-wide visual styles, colors, and banners to establish a unique brand identity.
- Theme Customization - Includes a system for adjusting the site's visual identity via configurable colors and a light/dark mode toggle.
- Code Formatting - Ships themed frames for rendering source code with support for line numbering and custom starting lines.
