Questa pagina non è ancora stata tradotta - viene mostrata la versione in English.
Tutorial Course
A guided, 20-lesson walkthrough from install to a deployed site.
Getting Started with bx-sites
The fastest way to learn bx-sites end to end - twenty short lessons, in order, each building on the last. Every lesson is short on purpose, with a link out to the full guide wherever a topic goes deeper than a lesson can cover.
Your progress through the course - which lessons you've read, and where to pick back up - is remembered right in this browser as you go.
- IntroductionWhat bx-sites is, who it's for, and what this course covers.
- InstallationInstalling the BoxLang runtime and the bx-sites module itself.
- Creating a New SiteScaffold a real project with bxSites new, then build and serve it locally.
- Content OrganizationHow docs/ maps to your site's nav and URLs, and how pages link to each other.
- Page FrontmatterThe small YAML block at the top of a page - title, order, tags, and more.
- Markdown ExtensionsAdmonitions, content tabs, code annotations, and diagrams - on top of standard Markdown.
- Content BlocksCards, buttons, steppers, and more - a family of rich blocks Markdown alone doesn't have.
- TablesGFM pipe tables, always on, with automatic responsive scroll and visualizer recipes.
- Images & IconsAutomatic responsive image variants, and icons from eight bundled libraries.
- Variables & Magic FunctionsReusable {{ variables }}, and small BoxLang helper functions callable the same way.
- Data FilesReusable structured data - a team roster, a pricing table - reachable from every page.
- Loops & Conditionals::: for and ::: if - looping and branching over data, straight in Markdown.
- Interactivity with Alpine.jsCopy buttons, live filters, and sortable tables - with no extra setup.
- Choosing a ThemeTen built-in themes, and how to override or write your own.
- SearchA static search index, on by default - plus Algolia and Pagefind as drop-in alternatives.
- OpenAPI DocumentationAn interactive Swagger UI widget for a full spec, or a single operation inline.
- Blog, Versioning & i18nA by-convention blog, snapshotting a release's docs, and translating into other languages.
- Redirects & Site StructureKeep an old URL working after you move, rename, or restructure a page.
- Plugins & CLI ProvidersExtending bx-sites with a BoxLang module of your own - build hooks and new commands.
- Building, Deploying & PublishingShip the site you've built - to any host, or straight to bxSites Cloud.