القائمة
Preview the backend_to_ml mdBook locally — single language or all three. Triggered when the user mentions "preview", "serve", "build", "show me the book", or "all three languages".
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | mdbook-preview |
| description | Preview the backend_to_ml mdBook locally — single language or all three. Triggered when the user mentions "preview", "serve", "build", "show me the book", or "all three languages". |
backend_to_ml is a 3-language book, but mdbook serve only serves the default language (uz). Two main options below.
export PATH="$HOME/.cargo/bin:$PATH"
mdbook --version # should print mdbook v0.4.X
If mdbook is missing: cargo install mdbook mdbook-i18n-helpers.
The fastest, most common option — Uzbek only:
mdbook serve --open
src/*.md changes/ru/ and /en/ URLs return 404 (only the default language is built)Different port: mdbook serve --port 4000.
Stop with Ctrl+C.
To see all three languages:
# 1. Build them
mdbook build
MDBOOK_BOOK__LANGUAGE=ru mdbook build -d book/ru
MDBOOK_BOOK__LANGUAGE=en mdbook build -d book/en
# 2. Fix canonical URLs (.md → .html)
./scripts/fix-canonical-urls.sh
# 3. Static server
cd book && python3 -m http.server 3000
URLs:
http://localhost:3000/ — Uzbek (default)http://localhost:3000/ru/ — Russianhttp://localhost:3000/en/ — EnglishNo hot reload — rebuild after each change. Use this when you specifically need to check the translated output.
MDBOOK_BOOK__LANGUAGE=ru mdbook serve --port 3001
Serves Russian as the default at / with live reload.
/preview — option 1 (uz, live reload)/preview-all — option 2 (all 3, no hot reload)/build-check — builds only, no server (CI-style verification)book/ is in .gitignore — never committedtheme/lang-switcher.js adds the 🇺🇿/🇷🇺/🇬🇧 button to every pagetheme/head.hbs injects hreflang and canonical URL meta tags (SEO)https://backendtoml.milliytech.uz — deployed via .github/workflows/deploy.ymlWrite a new chapter for the backend_to_ml book — 10-section format, code-first style. Triggered when the user mentions "new chapter", "yangi bob", "month-XX", "new section", or asks to add content.
Run the backend_to_ml translation pipeline (extract → translate → apply → validate). Triggered when the user mentions .po, gettext, msgstr, fuzzy, sync-translations, translate-with-ai, validate-translation, or after writing new src/*.md content.