Bryan W. Weber
4ff4b78d5e
[Sphinx] Fix spurious warnings in __init__ docs
...
This has been bugging me for years, and I'm very happy to have finally
fixed it! To debug this, I used the -vv output from sphinx-build to
inspect what autodoc was doing. autodoc seemed to have no problem
reading the source, but it was indeed generating reST with unmatched
emphasis and strong markers. Although it really seems like autodoc
should be able to handle this case, apparently it can't. Then, I was
reading the autodoc documentation when I noticed this idea of an event
handler, a function that gets called whenever a particular event
happens. I realized I could get in and munge the docstring text to
replace any unescaped splats with escaped ones.
2021-02-12 16:57:15 -05:00
Bryan W. Weber
4947fa6a4f
[Doc] Fix NumPy intersphinx location
...
Use pathlib to read configuration file for Cantera's current version.
This avoids leaving the file handle open.
2021-02-12 16:57:15 -05:00
Raymond Speth
4f265d11a7
[Doc] Fix missing Python class member documentation
...
Sphinx 1.8 deprecated the 'autodoc_default_flags' option. It appears
to have stopped working without warning in more recent versions.
2021-02-09 22:18:20 -05:00
Ingmar Schoegl
9b53599d01
Happy New Year!
2021-01-18 17:02:15 -05:00
Bryan W. Weber
28baede600
[Doc] KaTeX version is no longer configurable
...
The KaTeX version is no longer configurable in the sphinxcontrib-katex
extension. There is now a Python script in the website repository
api-docs folder that can bump the KaTeX version in the built
documentation to match the version supplied by sphinxcontrib-katex.
2020-06-26 18:00:38 -04:00
Ingmar Schoegl
028a054c60
Happy New Year!
2020-01-03 17:09:28 -05:00
Bryan W. Weber
1d62ec0439
[Doc] Add documentation for ctml2yaml script
...
Add intersphinx extension to auto-link to Python docs. Bump KaTeX
version.
2019-12-01 21:07:44 -05:00
Ray Speth
d6da006e3e
[SCons] Only build the Python package for Python 3.x
2018-09-19 17:59:59 -04:00
Bryan W. Weber
045f3d37bf
[Doc] Fix CSS font specification for Alabaster theme
...
The font themes must be specified as a string rather than a list.
2018-08-10 11:20:31 -04:00
Bryan W. Weber
dbc3df1687
Switch Sphinx docs to KaTeX instead of MathJax
2018-07-29 17:47:14 -04:00
Bryan W. Weber
e8d28b0e89
Redo layout.html to match the style of and to add links to the main site
...
We need to replace most of the Sphinx-defaults with things that look
like our new Nikola website and that link to places in the Nikola
website.
2018-07-29 17:47:14 -04:00
Bryan W. Weber
3052701250
Remove Mathjax todo that has already been done
2018-07-29 17:47:14 -04:00
Bryan W. Weber
0d20b50543
[Doc] Add Donation link to sidebar
2018-02-10 11:53:24 -05:00
Bryan W. Weber
e6b4761c6b
Happy New Year!
2018-02-10 11:53:22 -05:00
Bryan W. Weber
e846505f57
[Doc] Use Sphinx Mathjax extension
2018-02-08 16:41:08 -05:00
Ray Speth
6546c08f29
Bump version and copyright year for 2.3.0 release
2017-01-12 14:00:35 -05:00
Ray Speth
5fbe2303ca
[Python] Fix test suite to work with Python 3.2
...
The u'foo' syntax which can be used in Python 2.7 and 3.3+ does not work with
Python 3.2.
2016-06-24 17:15:14 -04:00
Bryan W. Weber
848650f4fb
[Doc] Fix copyright year
2016-02-06 07:44:09 -05:00
Ray Speth
6994d56587
[Doc] Sphinx reads version info from config.h
2015-06-14 20:00:54 -04:00
Ray Speth
430c59634a
[Doc] Extend sphinxdoc theme instead of overwriting CSS file
...
Overwriting the CSS file caused styles to fall out-of-date with the HTML
generated by newer versions of Sphinx. This way, we just need to maintain a few
customizations to the base theme.
2015-06-12 18:34:44 -04:00
Ray Speth
416490ad7a
Bump version to 2.2.0
2015-06-04 18:41:20 -04:00
Ray Speth
772427014a
Bump version to 2.2.0b1
2015-05-11 17:23:37 -04:00
Ray Speth
a3ec8c0848
[Doc] Use https for MathJax CDN
...
This is needed to make MathJax work when loading the documentation over an https
URL, since some browsers block scripts from non-https sites when loading a page
over https.
2015-05-07 11:29:22 -04:00
Ray Speth
18e2ab7c8d
[Python/Doc] Document Reaction and derived classes
2015-05-05 11:34:07 -04:00
Bryan W. Weber
f4041d6fb2
[Doc] Add the ability to pseudo-autodocument MATLAB code to the SConscript file
2014-07-18 14:32:53 +00:00
Ray Speth
b5e540c903
[Python] Remove the legacy Python module
2013-12-09 01:35:08 +00:00
Ray Speth
6b68564245
Bump trunk version to 2.2a
2013-12-09 01:33:58 +00:00
Ray Speth
957c88fcff
Bump version to 2.1.0
2013-10-24 02:40:14 +00:00
Ray Speth
7683677cac
Bump version to 2.1.0b3
2013-09-01 00:33:55 +00:00
Ray Speth
4d88fa8e34
Bump version to 2.1.0b2
2013-08-02 23:31:36 +00:00
Ray Speth
e65cd38214
Bump version to 2.1.0b1
2013-07-23 15:53:31 +00:00
Ray Speth
ab7775e67e
[Cython] Fix Python 2.6 compatibility issues with sys.version_info
...
The "major" attribute is a new feature in Python 2.7.
2013-07-18 22:39:26 +00:00
Ray Speth
5a722f9608
Added docstrings to Cython ThermoPhase class
2012-09-06 19:58:50 +00:00
Ray Speth
0c904bebfa
Added infrastructure for using Sphinx to document the new Python module
...
This includes adding the sphinx_cmd option to SCons, which can be set to the
Python 3 version of sphinx-build as necessary.
2012-09-06 19:58:13 +00:00
Ray Speth
5bb6edb133
Bump version number of development version (trunk)
2012-07-10 16:25:39 +00:00
Ray Speth
f3c3f47bc5
Incremented version number (2.0.0b3)
2012-06-05 19:56:26 +00:00
Ray Speth
095f43c1eb
Added modified CSS for Sphinx documentation
...
This CSS (from Matplotlib) adds thick lines before each documented
class and thin lines at the start of each documented method.
2012-04-04 18:46:16 +00:00
Ray Speth
3938a6bfa7
Moved Matlab input tutorial into Sphinx documentation
2012-04-04 18:46:11 +00:00
Ray Speth
e6a5abdfae
Added header logo to documentation
2012-04-04 18:45:31 +00:00
Ray Speth
3acf30b3aa
Moved build directories for docs to make relative links consistent
2012-04-04 18:45:26 +00:00
Ray Speth
c44ef99775
Added doxylink Sphinx extension for creating links to Doxygen docs
2012-03-30 23:46:48 +00:00
Ray Speth
d573ae6625
Configured Sphinx to use MathJax 2.0
2012-03-15 19:51:09 +00:00
Ray Speth
b4ceb7da2e
Reformatted the Python docstrings to work better with Sphinx
...
This means that the docstrings are now parsed as reStructuredText.
2012-03-13 17:34:47 +00:00
Ray Speth
09d9ded2e7
Added templates for using Sphinx to generate the Python module docs
2012-03-13 17:34:38 +00:00