##################
User Documentation
##################

As ``ipyaladin`` brings the ``Aladin Lite`` software into python notebooks, some commands
are similar to the original software. When this is the case, this documentation might redirect
towards ``Aladin Lite``'s own documentation.

*************************************
Initialization options for the widget
*************************************

The widget is represented by a python class, :py:class:`ipyaladin.widget.Aladin`. This class has arguments
that allow to chose which buttons or functionalities will be available in the widget.
These **cannot** be edited later.

.. the CSV is generated by conf.py, and grabs all traits with only_init=True don't edit it manually!

.. csv-table:: Initialization options
    :file: init_options.csv
    :header: "Argument";"Default Value";"Description"
    :delim: ;

.. nbgallery::
    ../_collections/notebooks/02_Base_Commands
    ../_collections/notebooks/03_Functions

*****************************
Adding elements to the widget
*****************************

.. nbgallery::
    ../_collections/notebooks/04_Importing_Tables
    ../_collections/notebooks/05_Display_a_MOC
    ../_collections/notebooks/09_Displaying_Shapes

***************************************************
Retrieving information from the current widget view
***************************************************

.. nbgallery::
    ../_collections/notebooks/11_Extracting_information_from_the_view.ipynb

************
Advanced use
************

``ipyaladin`` can be combined with widgets from the ``ipywidgets`` library to create 
interactive cell outputs.

.. nbgallery::
    ../_collections/notebooks/06_Linked-widgets
    ../_collections/notebooks/07_on-click-callback
    ../_collections/notebooks/08_Rectangular-selection
    ../_collections/notebooks/10_Advanced-GUI