OVMS3-idf/docs/README.md

# Documentation Source Folder

This folder contains source files of **ESP-IDF documentation** available in [English](https://docs.espressif.com/projects/esp-idf/en/latest/) and [中文](https://docs.espressif.com/projects/esp-idf/zh_CN/latest/).

The sources do not render well in GitHub and some information is not visible at all.

Use actual documentation generated within about 20 minutes on each commit:

# Hosted Documentation

* English: https://docs.espressif.com/projects/esp-idf/en/latest/
* 中文: https://docs.espressif.com/projects/esp-idf/zh_CN/latest/

The above URLs are all for the master branch latest version. Click the drop-down in the bottom left to choose a stable version or to download a PDF.


# Building Documentation

* Install `make` and `doxygen` for your platform (`make` may already be installed as an ESP-IDF prerequisite).
* Change to either the docs/en or docs/zh_CN subdirectory and run `make html`
* `make` will probably prompt you to run a python pip install step to get some other Python-related prerequisites. Run the command as shown, then re-run `make html` to build the docs.

## For MSYS2 MINGW32 on Windows

If using Windows and the MSYS2 MINGW32 terminal, run this command before running "make html" the first time:

```
pacman -S doxygen mingw-w64-i686-python-pillow
```

Note: Currently it is not possible to build docs on Windows without using a Unix-on-Windows layer such as MSYS2 MINGW32.
Replace all DOS line endings with Unix Command run was: git ls-tree -r HEAD --name-only \| xargs dos2unix 2018-07-04 23:01:03 +00:00			`# Documentation Source Folder`

			`This folder contains source files of ESP-IDF documentation available in [English](https://docs.espressif.com/projects/esp-idf/en/latest/) and [中文](https://docs.espressif.com/projects/esp-idf/zh_CN/latest/).`

			`The sources do not render well in GitHub and some information is not visible at all.`

			`Use actual documentation generated within about 20 minutes on each commit:`

			`# Hosted Documentation`

			`* English: https://docs.espressif.com/projects/esp-idf/en/latest/`
			`* 中文: https://docs.espressif.com/projects/esp-idf/zh_CN/latest/`

			`The above URLs are all for the master branch latest version. Click the drop-down in the bottom left to choose a stable version or to download a PDF.`


doc: Fix doc builds on Windows MINGW32, add some doc build documentation Using "find" doesn't work properly in MINGW32 Python, even if a MINGW32 find.exe is on the PATH... 2018-10-24 05:21:48 +00:00			`# Building Documentation`

			* Install `make` and `doxygen` for your platform (`make` may already be installed as an ESP-IDF prerequisite).
			* Change to either the docs/en or docs/zh_CN subdirectory and run `make html`
			* `make` will probably prompt you to run a python pip install step to get some other Python-related prerequisites. Run the command as shown, then re-run `make html` to build the docs.

			`## For MSYS2 MINGW32 on Windows`

			`If using Windows and the MSYS2 MINGW32 terminal, run this command before running "make html" the first time:`

			```
windows: Update other MSYS2 package names to all be Python 3 2020-06-04 08:39:20 +00:00			`pacman -S doxygen mingw-w64-i686-python-pillow`
doc: Fix doc builds on Windows MINGW32, add some doc build documentation Using "find" doesn't work properly in MINGW32 Python, even if a MINGW32 find.exe is on the PATH... 2018-10-24 05:21:48 +00:00			```

			`Note: Currently it is not possible to build docs on Windows without using a Unix-on-Windows layer such as MSYS2 MINGW32.`