Commit Graph

669 Commits

Author SHA1 Message Date
Ray Speth
60ea75af4a [Doc] Transfer legacy2yaml tutorial 2023-10-22 08:08:57 -05:00
Ray Speth
dc17c373e3 [Doc] Transfer YAML error handling guide 2023-10-22 08:08:57 -05:00
Ray Speth
f7c12cc2eb [Doc] Transfer YAML tutorial 2023-10-22 08:08:57 -05:00
Ray Speth
597b505036 [Doc] Transfer YAML "Defining Phases" guide 2023-10-22 08:08:57 -05:00
Ray Speth
33519432ac [Doc] Transfer ThermoBuild tutorial 2023-10-22 08:08:57 -05:00
Ray Speth
03ee315afa [Doc] Add revised ck2yaml tutorial
Mostly drawn from the corresponding page in cantera-website, with
some updates and removing content covered in the reference guide.
2023-10-22 08:08:57 -05:00
Ray Speth
de77fa3c14 [Doc] Use cards for Examples landing page 2023-10-09 16:40:37 -04:00
Ray Speth
134fce72e4 [Doc] Avoid needing two lines for header links 2023-10-09 16:40:37 -04:00
Ray Speth
eaed836915 [Doc] Simplify addition of "Community" link 2023-10-09 16:40:37 -04:00
Ray Speth
10f6158a07 Enable sphinx-copybutton extension 2023-10-09 16:40:37 -04:00
Ray Speth
a7021138a1 Migrate compilation docs into Sphinx/MyST 2023-10-09 16:40:37 -04:00
Ray Speth
3cebba3773 [Doc] Add more stub pages to the Sphinx docs 2023-10-09 16:40:37 -04:00
Ray Speth
4c4e9db03b Use higher-res icon in Doxygen title area 2023-10-09 16:40:37 -04:00
Ray Speth
d496314cc7 Set favicon for Sphinx and Doxygen docs 2023-10-09 16:40:37 -04:00
Ray Speth
3416eba3b8 [Doc] Add admonitions redirecting users to stable docs 2023-10-09 16:40:37 -04:00
Ray Speth
b30db6a8b6 [Doc] Reorganize Sphinx index pages and convert to MyST 2023-10-09 16:40:37 -04:00
Ray Speth
582f04a755 [Doc] Update to pydata-sphinx-theme 0.14 and fix some styling issues 2023-10-09 16:40:37 -04:00
Ray Speth
c96e470e61 Add Python tutorial as a MyST notebook
Adds dependency on myst-nb, which is currently pinned to Sphinx<6
2023-10-09 16:40:37 -04:00
Ray Speth
2767d00e53 [Doc] Add bibliography to Sphinx docs 2023-10-09 16:40:37 -04:00
Ray Speth
b463f001bb [Doc] Fix syntax error in cantera.bib 2023-10-09 16:40:37 -04:00
Ray Speth
8084eae338 [Doc] Create skeleton for revised layout 2023-10-09 16:40:37 -04:00
Ray Speth
221ae6a5c2 [Doc] Use 'python' instead of 'cython' for filenames and refs
Partially addresses Cantera/cantera-website#229
2023-10-09 16:40:37 -04:00
Ray Speth
c533ca90bb [Doc] Flatten output directory structure
Copy Doxygen output into a subdirectory of Sphinx so the Sphinx
index can be the full site index.

Partially addresses Cantera/cantera-website#229
2023-10-09 16:40:37 -04:00
Ray Speth
70b08041e2 [Doc] Create structure for "science" docs
Use LatticePhase as an initial trial for moving scientific model docs
into Sphinx using MyST.
2023-10-09 16:40:37 -04:00
Ray Speth
d896104e10 Remove previous/next page links from Sphinx docs 2023-10-09 16:40:37 -04:00
Ray Speth
38a0b13dfb Reformat "Reference" landing page
Put C++ API documentation on an equal footing
2023-10-09 16:40:37 -04:00
Ray Speth
5821dceef5 Enable MyST usage in Sphinx 2023-10-09 16:40:37 -04:00
Ray Speth
d62dc233c9 Modify Doxygen navbar to link to Sphinx docs 2023-10-09 16:40:37 -04:00
Ray Speth
3903cacf30 [Examples] Embed fixed temperature file for burner-stabilized flame 2023-10-03 11:23:39 -04:00
Ray Speth
7ac1b9d780 Set order of sample sub-galleries 2023-10-03 11:23:39 -04:00
Ray Speth
553d5def17 [SCons] Use logging option to adjust Sphinx logging 2023-10-03 11:23:39 -04:00
Ray Speth
6f95c67936 [Doc,CI] Update keyword checking for new syntax 2023-10-03 11:23:39 -04:00
Ray Speth
d959103237 [Doc] Add separate top-level pages for examples and reference docs 2023-10-03 11:23:39 -04:00
Ray Speth
899b354572 Generate plots for examples where this requires the --plot option 2023-10-03 11:23:39 -04:00
Ray Speth
faadf015ee Add Matlab examples to sphinx-gallery 2023-10-03 11:23:39 -04:00
Ray Speth
6eb4f08907 Add clib example to sphinx-gallery 2023-10-03 11:23:39 -04:00
Ray Speth
732e7e89fa Add Fortran examples to sphinx-gallery 2023-10-03 11:23:39 -04:00
Ray Speth
f720a573db [Doc] Add C++ examples to sphinx-gallery 2023-10-03 11:23:39 -04:00
Ray Speth
c49c95d666 [Doc] Add remaining Python examples to sphinx-gallery
Introduce a monkey patch to avoid executing specific examples that
won't run under sphinx-gallery.
2023-10-03 11:23:39 -04:00
Ray Speth
d005585e4d [Doc] Remove secondary sidebar from example pages
This sidebar usually only had a "get page source" link, which isn't
very useful for autogenerated pages.
2023-10-03 11:23:39 -04:00
Ray Speth
868678de5d Set py:currentmodule to enable link resolution 2023-10-03 11:23:39 -04:00
Ray Speth
305f4ed90c [Doc] Link code in Python examples to API docs 2023-10-03 11:23:39 -04:00
Ray Speth
4ad5642237 [Doc] Hide note about download link location 2023-10-03 11:23:39 -04:00
Ray Speth
9db15111b6 [Doc] Use sphinx-tags to enable finding examples by tag 2023-10-03 11:23:39 -04:00
Ray Speth
6c0b9b80fc [Doc] Build Sphinx docs and run gallery samples in build dir
Sphinx-gallery creates new .rst files alongside existing manually
maintained documentation, and runs the samples in-place, generating
their output files in the source tree. Moving this all to the build
directory lets us keep the repo clean.
2023-10-03 11:23:39 -04:00
Ray Speth
666f4d474c [Doc] Minimal working sphinx-gallery integration
This includes just the Python "kinetics" examples to start
2023-10-03 11:23:39 -04:00
Ingmar Schoegl
bc8ebe8d48 [sphinx] Switch note to seealso admonitions 2023-09-10 22:37:38 -05:00
Ingmar Schoegl
363fe2cf73 [docs] Update ck2yaml.rst 2023-09-09 18:15:48 -05:00
Ray Speth
ab46f66601 Remove deprecated Python code 2023-08-26 19:03:02 -07:00
Ray Speth
309bf34a73 Remove code deprecated in Cantera 3.0
This takes care of simple removals of deprecated methods/classes
2023-08-26 19:03:02 -07:00