Documentation website for multilingual (v0.4.0), a programming language that supports writing code in 17 human languages with one formal semantic core and Python/WASM backends.
Live site: https://multilingualprogramming.github.io/docs/ Main project: https://github.com/johnsamuelwrites/multilingual
This repository contains the Jekyll site source for the documentation portal, including:
- Getting Started guides
- Language Guide (syntax, keywords, control flow, async/generators)
- Reference docs (operators, numerals, builtins, datetime, compatibility)
- WASM backend docs (installation, architecture, performance, troubleshooting)
- Design and architecture documents
- Extension and contribution guides
getting-started/language-guide/reference/wasm/codegen/design/extending/contributing/_layouts/,_includes/,assets/
Prerequisites:
- Python 3.x
- Ruby 3.x
- Bundler
Install the Python package used by the docs tests:
pip install -r requirements-build.txt
Install dependencies:
bundle install
Start the site locally:
bundle exec jekyll serveOpen:
Build static output:
bundle exec jekyll build- Site configuration and navigation are defined in
_config.yml. - Homepage content is in
index.md. - Sidebar/navigation rendering uses templates in
_includes/and_layouts/.
- Edit or add markdown pages in the relevant section folder.
- Update
_config.ymlnavigation entries when adding new pages. - Run
bundle exec jekyll serveand verify pages render correctly. - Submit a pull request.
The stable docs-test baseline for multilingualprogramming is pinned in requirements-build.txt, and a scheduled compatibility workflow also checks the latest published package and upstream main.
For multilingual EN/FR documentation operations (metadata model, localized routing, snippets, CI checks, and Pages-safe deploy), see contributing/multilingual-docs.md.
For language/runtime contribution workflow, see contributing/ and the main repository.
Licensed under the terms in LICENSE.