41 lines
2.7 KiB
Markdown
41 lines
2.7 KiB
Markdown
# RuDS
|
|
|
|
RuDS is a native Rust blogging desktop application and the successor to bDS2. It manages local projects from authoring through preview, static-site generation, integrity checks, and publishing while preserving the existing bDS filesystem and SQLite formats.
|
|
|
|
The project is under active development. Core blogging workflows are broadly available; remaining core work and optional extensions are tracked separately.
|
|
|
|
## Available Features
|
|
|
|
- Native Iced desktop workspace with localized menus, tabs, sidebars, dialogs, tasks, and embedded Wry previews.
|
|
- Post and translation authoring with draft/published lifecycle, metadata, tags, categories, links, media, and batch gallery-image import.
|
|
- Media import, thumbnails, metadata translations, filters, validation, and post assignment.
|
|
- Template and Lua script management using a custom Ropey/Syntect/Cosmic Text editor and the documented, bDS2-signature-compatible project-scoped [`bds` host API](docs/scripting/API_REFERENCE.md) across utilities, rendered macros, and Blogmark transforms.
|
|
- SQLite and filesystem persistence with frontmatter, sidecars, rebuild, metadata diff/repair, and FTS5 search.
|
|
- Markdown/Liquid rendering with native macros, multilingual routes, feeds, sitemap, Pagefind, and incremental site generation through cancellable section task groups.
|
|
- Local preview in the app or system browser.
|
|
- Optional one-shot AI translation, description, analysis, taxonomy, and language-detection operations using online or local OpenAI-compatible endpoints with airplane-mode gating.
|
|
- SSH-agent-based SCP or rsync publishing.
|
|
- Site, media, and translation validation plus `ruds://new-post` Blogmark capture and Lua transforms; bDS2 keeps its separate `bds2://` bookmarklet protocol.
|
|
|
|
RuDS uses no JavaScript application runtime and loads no CSS or JavaScript from CDNs. The preview is served by the Rust application and displayed by the operating-system webview.
|
|
|
|
## Repository Map
|
|
|
|
- `crates/bds-core` — data, engines, rendering, AI, publishing, and Lua
|
|
- `crates/bds-editor` — reusable syntax-highlighting editor
|
|
- `crates/bds-ui` — desktop application and platform integration
|
|
- `crates/bds-cli` — planned automation CLI
|
|
- `specs` — authoritative Allium behavior specifications
|
|
- `fixtures` — compatibility projects and generated-site fixtures
|
|
- `locales` — UI and native-menu translations
|
|
|
|
## Plans and References
|
|
|
|
- [Core plan and current status](RUST_PLAN_CORE.md)
|
|
- [Extension plan and current status](RUST_PLAN_EXTENSION.md)
|
|
- [Specification index](SPECIFICATION_INDEX.md)
|
|
- [UI style guide](docs/UI_STYLE_GUIDE.md)
|
|
- `../bDS2` — reference implementation when an Allium contract is ambiguous
|
|
|
|
Contributor workflow and project invariants are documented in [AGENTS.md](AGENTS.md).
|