more formatting fixes

Author: AndrewAnnex

docs/Makefile

@@ -19,11 +19,12 @@ ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 # the i18n builder cannot share the environment and doctrees with the others
 I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+.PHONY: help clean html serve dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
 
 help:
 	@echo "Please use \`make <target>' where <target> is one of"
 	@echo "  html       to make standalone HTML files"
+	@echo "  serve      to clean, build HTML, and serve locally"
 	@echo "  dirhtml    to make HTML files named index.html in directories"
 	@echo "  singlehtml to make a single large HTML file"
 	@echo "  pickle     to make pickle files"
@@ -49,6 +50,9 @@ help:
 clean:
 	rm -rf $(BUILDDIR)/*
 
+serve: clean html
+	python -m http.server -d $(BUILDDIR)/html
+
 html:
 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
 	@echo

docs/_static/css/pyscript_editor.css

@@ -46,7 +46,7 @@ py-editor::part(editor) {
     padding: 0.5em 1em;
 }
 
-/* Run button: nudge it to sit inside the highlight box */
+/* Run button: border-radius only; margin-top is injected into shadow DOM via JS */
 py-editor::part(run-button) {
     border-radius: 0 0 4px 0;
 }

docs/basics.rst

@@ -38,7 +38,7 @@ explanatory error message.
 A simple example program
 ------------------------
 
-The following calls the SPICE function :py:meth:`spiceypy.spiceypy.tkvrsn` which outputs the version
+The following calls the SPICE function :py:func:`spiceypy.tkvrsn <spiceypy.spiceypy.tkvrsn>` which outputs the version
 of cspice that SpiceyPy is wrapping.
 
 .. py-editor::