Esta página aún no se ha traducido - se muestra la versión en 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.

  1. IntroductionWhat bx-sites is, who it's for, and what this course covers.
  2. InstallationInstalling the BoxLang runtime and the bx-sites module itself.
  3. Creating a New SiteScaffold a real project with bxSites new, then build and serve it locally.
  4. Content OrganizationHow docs/ maps to your site's nav and URLs, and how pages link to each other.
  5. Page FrontmatterThe small YAML block at the top of a page - title, order, tags, and more.
  6. Markdown ExtensionsAdmonitions, content tabs, code annotations, and diagrams - on top of standard Markdown.
  7. Content BlocksCards, buttons, steppers, and more - a family of rich blocks Markdown alone doesn't have.
  8. TablesGFM pipe tables, always on, with automatic responsive scroll and visualizer recipes.
  9. Images & IconsAutomatic responsive image variants, and icons from eight bundled libraries.
  10. Variables & Magic FunctionsReusable {{ variables }}, and small BoxLang helper functions callable the same way.
  11. Data FilesReusable structured data - a team roster, a pricing table - reachable from every page.
  12. Loops & Conditionals::: for and ::: if - looping and branching over data, straight in Markdown.
  13. Interactivity with Alpine.jsCopy buttons, live filters, and sortable tables - with no extra setup.
  14. Choosing a ThemeTen built-in themes, and how to override or write your own.
  15. SearchA static search index, on by default - plus Algolia and Pagefind as drop-in alternatives.
  16. OpenAPI DocumentationAn interactive Swagger UI widget for a full spec, or a single operation inline.
  17. Blog, Versioning & i18nA by-convention blog, snapshotting a release's docs, and translating into other languages.
  18. Redirects & Site StructureKeep an old URL working after you move, rename, or restructure a page.
  19. Plugins & CLI ProvidersExtending bx-sites with a BoxLang module of your own - build hooks and new commands.
  20. Building, Deploying & PublishingShip the site you've built - to any host, or straight to bxSites Cloud.
Editar esta página Descargar Markdown Última actualización Sep 11, 2026, 7:11:15 PM