Documentation | Details on windows builds (#54)

[ita2048 ita2048 (@ita2048)]

ita2048 ita2048 created an issue: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/issues/54



1. There is "./" missing at the start of the command https://gitlab.rtems.org/rtems/docs/rtems-docs/-/blob/main/README.md?ref_type=heads&plain=1#L539
2. On Windows, `WAF_NO_PREFORK` is no longer necessary after upgrading to waf 2.1.4 https://gitlab.rtems.org/rtems/docs/rtems-docs/-/blob/main/README.md?ref_type=heads&plain=1#L296
3. On Windows the build can be much more simple, and only four commands are needed from msys:

```shell
python3 -m venv sphinx # python 3.12.7 from msys
. sphinx/bin/activate
pip install sphinx sphinxcontrib-bibtex sphinxcontrib-jquery sphinx-rtd-theme
./waf configure clean build install --prefix=/foo
```

4. On Windows, the `--singlehtml` can be built after installing `inliner`:

```shell
pacman install unzip # required for `npm install`
install nvm from https://github.com/nvm-sh/nvm
nvm install --lts
npm install -g inliner

. sphinx/bin/activate
./waf configure clean build install --prefix=/foo --singlehtml
```

-- 
View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/issues/54
You're receiving this email because of your account on gitlab.rtems.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/bugs/attachments/20241112/3a712d1d/attachment-0001.htm>