feat(docs): migrate from .md to .rst (#4129)

docs/widgets/tabview.rst

@@ -0,0 +1,91 @@
+Tabview (lv_tabview)
+====================
+
+Overview
+********
+
+The Tab view object can be used to organize content in tabs. The Tab
+view is built from other widgets:
+
+- Main container: `lv_obj </widgets/obj>`__
+- Tab buttons: `lv_btnmatrix </widgets/btnmatrix>`__
+- Container for the tabs: `lv_obj </widgets/obj>`__
+- Content of the tabs: `lv_obj </widgets/obj>`__
+
+The tab buttons can be positioned on the top, bottom, left and right
+side of the Tab view.
+
+A new tab can be selected either by clicking on a tab button or by
+sliding horizontally on the content.
+
+Parts and Styles
+****************
+
+There are no special parts on the Tab view but the ``lv_obj`` and
+``lv_btnnmatrix`` widgets are used to create the Tab view.
+
+Usage
+*****
+
+Create a Tab view
+-----------------
+
+:cpp:expr:`lv_tabview_create(parent, tab_pos, tab_size)` creates a new empty
+Tab view. ``tab_pos`` can be ``LV_DIR_TOP/BOTTOM/LEFT/RIGHT`` to
+position the tab buttons to a side. ``tab_size`` is the height (in case
+of ``LV_DIR_TOP/BOTTOM``) or width (in case of ``LV_DIR_LEFT/RIGHT``)
+tab buttons.
+
+Add tabs
+--------
+
+New tabs can be added with :cpp:expr:`lv_tabview_add_tab(tabview, "Tab name")`.
+This will return a pointer to an `lv_obj </widgets/obj>`__ object where
+the tab’s content can be created.
+
+Rename tabs
+-----------
+
+A tab can be renamed with
+:cpp:expr:`lv_tabview_rename_tab(tabview, tab_id, "New Name")`.
+
+Change tab
+----------
+
+To select a new tab you can:
+
+- Click on its tab button
+- Slide horizontally
+- Use :cpp:expr:`lv_tabview_set_act(tabview, id, LV_ANIM_ON)` function
+
+Get the parts
+-------------
+
+:cpp:expr:`lv_tabview_get_content(tabview)` returns the container for the tabs,
+:cpp:expr:`lv_tabview_get_tab_btns(tabview)` returns the Tab buttons object
+which is a `Button matrix </widgets/btnmatrix>`__.
+
+Events
+******
+
+-  :cpp:enumerator:`LV_EVENT_VALUE_CHANGED` Sent when a new tab is selected by sliding
+   or clicking the tab button. :cpp:expr:`lv_tabview_get_tab_act(tabview)`
+   returns the zero based index of the current tab.
+
+Learn more about :ref:`events`.
+
+Keys
+****
+
+Keys have effect only on the tab buttons (Button matrix). Add manually
+to a group if required.
+
+Learn more about :ref:`indev_keys`.
+
+Example
+*******
+
+.. include:: ../examples/widgets/tabview/index.rst
+
+API
+***