Instructions to build/test the documentation.

[ghost]

Setup mdbook

• Install rust and cargo
• Install mdbook via cargo install mdbook
• Add /.cargo/bin to $PATH

Preview the docs

git clone --recursive https://github.com/OpenBangla/manual.git && cd manual mdbook serve obk-docs (For the English version) mdbook serve obk-docs-bn (For the Bangla version

After that, goto http://localhost:3000/ in a browser

[ghost]

For anyone having Bangla font issues in VSCode/VSCodium

Install the Noto Sans Bengali fonts from your distro repos if you're using VSC native or inside of a toolbox/distrobox container. I am still finding a solution for the Flatpak versions. Edit : Install Bangla language packs on your host system for Flatpaks to work too.

After that, set VSC to use the noto sans bengali font by putting the following in your settings.json file

{
    "editor.fontLigatures": true,
    "editor.fontFamily": "'Droid Sans Mono', 'monospace','Noto Sans Bengali'"
}

You can also optionally just add 'Noto Sans Bengali' to Settings > Text Editor > Fonts like the following

(It is an extremely weird issue, as no other App, whether native, inside of a toolbox, or flatpak, in my system has any issues whatsoever properly displaying Bangla) Edit: I used to always check Bangla language support to enabled in the Fedora installer, recently had to do a reinstall and forgot to check that box, in Fedora, installing the "langpacks-bn" package suffices, even though noto sans bengali fonts were installed on my system by default on a vanilla install.