LightGBM/docs
Guolin Ke 5d3a3ea47e fix metric alias (#2273)
* fix metric alias

* fix format

* updated docs

* simplify alias in objective function

* move the alias parsing to config.cpp

* updated docs

* fix multi-class aliases

* updated regression aliases in docs

* fixed trailing space
2019-07-25 17:31:58 +03:00
..
_static [docs] added download artifacts badge (#1883) 2018-12-08 12:38:14 +08:00
.linkcheckerrc [ci] add OpenMPI link to ignore list (#2227) 2019-06-13 10:08:25 +08:00
Advanced-Topics.rst Add Cost Effective Gradient Boosting (#2014) 2019-04-04 10:35:11 +08:00
C-API.rst [ci][docs] generate docs for C API (#2059) 2019-05-05 14:54:37 +03:00
Development-Guide.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
Experiments.rst [docs] Small aesthetic improvements to RTD docs (#2060) 2019-03-26 22:55:17 +03:00
FAQ.rst [ci][docs] updated fix for OpenMP conflicts (#2166) 2019-05-12 14:19:53 +03:00
Features.rst [ci] hotfixes (#2132) 2019-04-26 22:06:49 +08:00
GPU-Performance.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
GPU-Targets.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
GPU-Tutorial.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
GPU-Windows.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
Installation-Guide.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
Key-Events.md [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
Makefile [docs] fixed building at Python 2.x (#997) 2017-10-30 11:44:08 +08:00
Parallel-Learning-Guide.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
Parameters-Tuning.rst [docs] Edits for grammer and clarity (#1389) 2018-05-26 22:14:38 +03:00
Parameters.rst fix metric alias (#2273) 2019-07-25 17:31:58 +03:00
Python-API.rst [python] added plot_split_value_histogram function (#2043) 2019-05-01 23:05:16 +09:00
Python-Intro.rst [docs] remove duplicated param in Python-Intro.rst (#2181) 2019-05-18 20:51:55 +03:00
Quick-Start.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
README.rst [docs] updated Microsoft GitHub URL (#2152) 2019-05-08 13:51:28 +08:00
conf.py [ci][docs] generate docs for C API (#2059) 2019-05-05 14:54:37 +03:00
gcc-Tips.rst [ci][docs] updated temp fix for warning written to stderr, fixed conda permissions and updated bench link (#1849) 2018-11-21 19:59:55 +03:00
index.rst [ci][docs] generate docs for C API (#2059) 2019-05-05 14:54:37 +03:00
make.bat [docs] fixed building at Python 2.x (#997) 2017-10-30 11:44:08 +08:00
requirements.txt [ci][docs] generate docs for C API (#2059) 2019-05-05 14:54:37 +03:00
requirements_base.txt [ci][docs] generate docs for C API (#2059) 2019-05-05 14:54:37 +03:00

README.rst

Documentation
=============

Documentation for LightGBM is generated using `Sphinx <http://www.sphinx-doc.org/>`__
and `Breathe <https://breathe.readthedocs.io/>`__, which works on top of `Doxygen <http://www.doxygen.nl/index.html>`__ output.

List of parameters and their descriptions in `Parameters.rst <./Parameters.rst>`__
is generated automatically from comments in `config file <https://github.com/microsoft/LightGBM/blob/master/include/LightGBM/config.h>`__
by `this script <https://github.com/microsoft/LightGBM/blob/master/helpers/parameter_generator.py>`__.

After each commit on ``master``, documentation is updated and published to `Read the Docs <https://lightgbm.readthedocs.io/>`__.

Build
-----

You can build the documentation locally. Just install Doxygen and run in ``docs`` folder

.. code:: sh

    pip install -r requirements.txt
    make html

If you faced any problems with Doxygen installation or you simply do not need documentation for C code,
it is possible to build the documentation without it:

.. code:: sh

    pip install -r requirements_base.txt
    export C_API=NO || set C_API=NO
    make html