Adding API documentation made on sphinx

[TOsmanov]

Summary

API Documentation generated made on sphinx.
Generated with using sphinx-apidoc and sphinx-autodoc.
Used theme read the docs.
The color of the theme read the docs is partially changed to match the color of the main site.
Added nojekyll file for website correct work on the github pages (read more).

• A button has been added to the documentation site to go to the site with API documentation
• Visual compliance with the documentation site.
• Footer contains the necessary information.
• Update site/README.md.
• |n and |s in the comments replace on \n and spaces before generation (using docstring preprocessing).
• excluded members beginning with _ .

Preview: https://tosmanov.github.io/datumaro/api/

Current issues:

1. Needs to update the workflows. I used the following commands:

     pip install Sphinx==4.2.0
     pip install sphinx-rtd-theme==1.0.0
     sphinx-build -a -n site\source site\static\api
   

2. Have to fixed warnings arising during generation sphinx-autodoc
3. Not added versioning with use sphinx-versioning
4. Most modules have no documentation

---

List of the problems that require editing comments in source code:

datumaro.plugins.openvino_plugin.launcher and datumaro.plugins.accuracy_checker_plugin.* sections make without using autodoc, therefore not have bases and source links

Attributable with a space in the name are not displayed sphinx-autodoc. For example plugins/mot_format.py lines 24, 28, 29 (https://tosmanov.github.io/datumaro/api/api/datumaro.plugins.html#module-datumaro.plugins.mot_format)

https://tosmanov.github.io/datumaro/api/api/plugins/sampler/datumaro.plugins.sampler.sampler.html#datumaro.plugins.sampler.sampler.Sampler
Notes has no line break

https://tosmanov.github.io/datumaro/api/api/plugins/plugins/datumaro.plugins.splitter.html#datumaro.plugins.splitter.Split
Examples has no line break

https://tosmanov.github.io/datumaro/api/api/plugins/plugins/datumaro.plugins.splitter.html#datumaro.plugins.splitter._ClassificationSplit
Notes incorrect line wrapping
Examples has no line break

https://tosmanov.github.io/datumaro/api/api/plugins/plugins/datumaro.plugins.splitter.html#datumaro.plugins.splitter._InstanceSpecificSplit
Example incorrect line wrapping

https://tosmanov.github.io/datumaro/api/api/plugins/plugins/datumaro.plugins.transforms.html#datumaro.plugins.transforms.ProjectLabels
Examples has no line break

https://tosmanov.github.io/datumaro/api/api/plugins/plugins/datumaro.plugins.transforms.html#datumaro.plugins.transforms.Rename
Examples incorrect interpretation :

https://tosmanov.github.io/datumaro/api/api/util/util/datumaro.util.annotation_util.html#datumaro.util.annotation_util.make_label_id_mapping
Returns incorrect line wrapping

https://tosmanov.github.io/datumaro/api/api/util/util/datumaro.util.image.html#datumaro.util.image.load_image_meta_file
incorrect line wrapping

https://tosmanov.github.io/datumaro/api/api/util/util/datumaro.util.mask_tools.html#datumaro.util.mask_tools.paint_mask
incorrect line wrapping

https://tosmanov.github.io/datumaro/api/api/util/util/datumaro.util.mask_tools.html#datumaro.util.mask_tools.mask_to_polygons
Args: is displayed as Parameters:

https://tosmanov.github.io/datumaro/api/api/util/util/datumaro.util.mask_tools.html#datumaro.util.mask_tools.crop_covered_segments
Args: is displayed as Parameters:
[ has incorrect highlight

https://tosmanov.github.io/datumaro/api/api/util/util/datumaro.util.os_util.html#datumaro.util.os_util.generate_next_name
Inputs has no line break

---

How to test

Checklist

• I submit my changes into the develop branch
• I have added description of my changes into CHANGELOG
• I have updated the documentation accordingly
• I have added tests to cover my changes
• I have linked related issues

License

• I submit my code changes under the same MIT License that covers the project.
  Feel free to contact the maintainers if that's a concern.
• I have updated the license header for each file (see an example below)

# Copyright (C) 2021 Intel Corporation
#
# SPDX-License-Identifier: MIT

[zhiltsov-max]

I see such fragments:

Can we do anything about the "The syntax is" part?

[zhiltsov-max]

Can we move the sections below to the plugins? These are all plugins. The same is for algorithms and components

[zhiltsov-max]

Can we add missing class definitions in modules?

There is no Dataset class, nor Project, but they're really important. The operations module is almost empty, but it has many useful functions and classes. Please, check for them.

[TOsmanov]

Planned fixes:

• in rise add apply
• add fields for classes in annotation, datasetitem, errors and everything announced with the attrs decorator
• remove _shape
• add __init__ members
• in convert add apply and convert
• add undoc-members to all classes
• add __iter__ to dataset
• add to .environment. Environment property, make_*, load_plugins
• in datumaro.components.extractor.Importer, datumaro.components.annotation and datumaro.components.project fix display parameters
• in plugin return all files
• plugins.accuracy_checker_plugin, datumaro.plugins.openvino_plugin.launcher fix display, but make without autodoc
• remove private-members everywhere except for the list of included members

[zhiltsov-max]

Ok, looks almost finished.

Please move

From "utilities" to "plugins"

[nmanovic]

@TOsmanov , @zhiltsov-max , let's merge in the current status. If we find any problems, it will be possible to fix them in the future.