fix doc and add instructions, fix #23

README.rst

@@ -267,3 +267,14 @@ Will output:
  }
  }
  }
+
+Command line
+==============================================================================
+
+Documentation can be built with Sphinx:
+
+.. code-block::
+
+ $ cd doc
+ $ pip install -r requirements.txt
+ $ make html

doc/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line.
 SPHINXOPTS =
-SPHINXBUILD = python3.6 -msphinx
+SPHINXBUILD = python3 -msphinx
 SPHINXPROJ = luaparser
 SOURCEDIR = source
 BUILDDIR = build

doc/requirements.txt

@@ -0,0 +1,3 @@
+sphinx
+sphinx_rtd_theme
+sphinxcontrib-napoleon

doc/source/conf.py

@@ -20,6 +20,9 @@
 # import sys
 # sys.path.insert(0, os.path.abspath('.'))
 
+import os
+import sys
+sys.path.insert(0, os.path.abspath('../..'))
 
 # -- General configuration ------------------------------------------------
 
@@ -63,7 +66,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -93,7 +96,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# html_static_path = ['_static']
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.