some doc fixes (AMReX-Astro#1468)

this adds dollar math and copybutton
also removes the vestiges of "starkiller"

Author: zingale

requirements.txt

@@ -9,3 +9,5 @@ jupyter>=1.0.0
 ipywidgets>=7.1.2
 numpy>=1.13.3
 sphinx-prompt
+sphinx-math-dollar
+sphinx-copybutton

sphinx_docs/rp.py

@@ -5,17 +5,17 @@
 import textwrap
 
 MAIN_HEADER = """
-+---------------------------------------+---------------------------------------------------------+--------------------+
-| parameter                             | description                                             | default value      |
-+=======================================+=========================================================+====================+
++---------------------------------------+---------------------------------------------------------+------------------------------+
+| parameter                             | description                                             | default value                |
++=======================================+=========================================================+==============================+
 """
 
 SEPARATOR = """
-+---------------------------------------+---------------------------------------------------------+--------------------+
++---------------------------------------+---------------------------------------------------------+------------------------------+
 """
 
 ENTRY = """
-| {:37} | {:55} | {:18} |
+| {:37} | {:55} | {:28} |
 """
 
 WRAP_LEN = 55

sphinx_docs/source/basics.rst

@@ -1,6 +1,6 @@
-*****************
-StarKiller Basics
-*****************
+*********************
+Microphysics Overview
+*********************
 
 Getting Started (Standalone)
 ============================
@@ -133,5 +133,7 @@ solvers (ODE integration for the network and Newton-Raphson root
 finding for the EOS) is separated from the specific implementations of
 the microphysics.
 
-**All quantities are assumed to be in CGS units**, unless otherwise
-specified.
+.. note::
+
+   All quantities are assumed to be in CGS units, unless otherwise
+   specified.

sphinx_docs/source/conf.py

@@ -48,12 +48,14 @@ def get_version():
 # ones.
 extensions = ['sphinx.ext.autodoc',
     'sphinx.ext.mathjax',
+    'sphinx_math_dollar',
     'sphinx.ext.viewcode',
     'sphinxcontrib.bibtex',
     'nbsphinx',
     'numpydoc',
     'IPython.sphinxext.ipython_console_highlighting',
     'sphinx.ext.githubpages',
+    'sphinx_copybutton',
     'sphinx-prompt',
     'sphinx_rtd_theme',
     'breathe']
@@ -116,7 +118,14 @@ def get_version():
 
 
 # -- Options for MathJax
-mathjax3_config = {'tex': {'macros': {}}}
+mathjax3_config = {}
+
+mathjax3_config["tex"] = {
+    "inlineMath": [['\\(', '\\)']],
+    "displayMath": [["\\[", "\\]"]],
+  }
+
+mathjax3_config["tex"]["macros"] = {}
 
 with open('mathsymbols.tex', 'r') as f:
     for line in f:

sphinx_docs/source/preface.rst

@@ -2,7 +2,7 @@
 Preface
 *******
 
-Welcome to the StarKiller Microphysics!
+Welcome to the AMReX-Astro Microphysics!
 
 In this User’s Guide we describe the microphysics modules designed to
 enable simulations of stellar explosions.