remove references to html-offline and only produce the offline viewable html manual

doc/Makefile

@@ -29,14 +29,13 @@ endif
 
 SPHINXEXTRA = -j $(shell $(PYTHON) -c 'import multiprocessing;print(multiprocessing.cpu_count())')
 
-.PHONY: help clean-all clean clean-spelling epub mobi rst html html-offline pdf spelling anchor_check style_check
+.PHONY: help clean-all clean clean-spelling epub mobi rst html pdf spelling anchor_check style_check
 
 # ------------------------------------------
 
 help:
 	@echo "Please use \`make <target>' where <target> is one of"
 	@echo "  html          create HTML doc pages in html dir"
-	@echo "  html-offline  create offline viewable HTML doc pages in html-offline dir"
 	@echo "  pdf           create Developer.pdf and Manual.pdf in this dir"
 	@echo "  fetch         fetch HTML and PDF files from LAMMPS web site"
 	@echo "  epub          create ePUB format manual for e-book readers"
@@ -55,12 +54,12 @@ clean-all: clean
 	rm -rf $(BUILDDIR)/docenv $(BUILDDIR)/doctrees $(BUILDDIR)/mathjax
 
 clean: clean-spelling
-	rm -rf html epub latex html-offline
+	rm -rf html epub latex
 
 clean-spelling:
 	rm -rf spelling
 
-html: $(ANCHORCHECK)
+html: $(ANCHORCHECK) $(MATHJAX)
 	@(\
 		. $(VENV)/bin/activate ;\
 		sphinx-build $(SPHINXEXTRA) -b html -c utils/sphinx-config -d $(BUILDDIR)/doctrees $(RSTDIR) html ;\
@@ -85,40 +84,10 @@ html: $(ANCHORCHECK)
 	@rm -rf html/USER/.[sg]*
 	@rm -rf html/USER/*/.[sg]*
 	@rm -rf html/USER/*/*.[sg]*
+	@mkdir -p html/_static/mathjax
+	@cp -r $(MATHJAX)/es5 html/_static/mathjax/
 	@echo "Build finished. The HTML pages are in doc/html."
 
-
-html-offline: $(ANCHORCHECK) $(MATHJAX)
-	@(\
-		. $(VENV)/bin/activate ;\
-		sphinx-build $(SPHINXEXTRA)  -D mathjax_path=mathjax/es5/tex-mml-chtml.js \
-			-b html -c utils/sphinx-config -d $(BUILDDIR)/doctrees $(RSTDIR) html-offline ;\
-		echo "############################################" ;\
-		rst_anchor_check src/*.rst ;\
-		python utils/check-packages.py -s ../src -d src ;\
-		env LC_ALL=C grep -n '[^ -~]' $(RSTDIR)/*.rst ;\
-		python utils/check-styles.py -s ../src -d src ;\
-		echo "############################################" ;\
-		deactivate ;\
-	)
-	-rm html/searchindex.js
-	@rm -rf html-offline/_sources
-	@rm -rf html-offline/PDF
-	@rm -rf html-offline/USER
-	@rm -rf html-offline/JPG
-	@cp -r src/PDF html-offline/PDF
-	@cp -r src/USER html-offline/USER
-	@mkdir -p html-offline/JPG
-	@cp `grep -A2 '\.\. image::' src/*.rst | grep ':target:' | sed -e 's,.*:target: JPG/,src/JPG/,' | sort | uniq` html-offline/JPG/
-	@rm -rf html-offline/PDF/.[sg]*
-	@rm -rf html-offline/USER/.[sg]*
-	@rm -rf html-offline/USER/*/.[sg]*
-	@rm -rf html-offline/USER/*/*.[sg]*
-	@echo "Build finished. The HTML pages are in doc/html-offline."
-	@mkdir -p html-offline/_static/mathjax
-	@cp -r $(MATHJAX)/es5 html-offline/_static/mathjax/
-
-
 spelling: $(VENV) utils/sphinx-config/false_positives.txt
 	@(\
 		. $(VENV)/bin/activate ;\
@@ -232,7 +201,7 @@ $(VENV):
 	)
 
 $(MATHJAX):
-	@git clone https://github.com/mathjax/MathJax.git mathjax
+	@git clone --depth 1 https://github.com/mathjax/MathJax.git mathjax
 
 $(TXT2RST) $(ANCHORCHECK): $(VENV)
 	@( \

doc/src/Manual_build.rst

@@ -9,7 +9,6 @@ sub-directories and optionally 2 PDF files and 2 e-book format files:
 
    src             # content files for LAMMPS documentation
    html            # HTML version of the LAMMPS manual (see html/Manual.html)
-   html-offline    # Offline viewable HTML version of the LAMMPS manual (see html/Manual.html)
    tools           # tools and settings for building the documentation
    Manual.pdf      # large PDF version of entire manual
    Developer.pdf   # small PDF with info about how LAMMPS is structured
@@ -31,21 +30,16 @@ a. You can "fetch" the current HTML and PDF files from the LAMMPS web
    changes (but your source code will not, unless you update your local
    repository).
 
-b. You can build the HTML and PDF files yourself, by typing "make html"
+b. You can build the HTML or PDF files yourself, by typing "make html"
-   or "make html-offline" followed by "make pdf".  This requires various
+   or "make pdf".  This requires various tools including Sphinx, git,
-   tools including Sphinx, which the build process will attempt to
+   and the MathJax javascript library, which the build process will attempt
-   download and install automatically into a virtual environment in the
+   to download automatically into a virtual environment in the folder
-   folder doc/docenv, if not already available. This download is
+   doc/docenv and the folder mathjax, respectively, if not already available.
-   required only once.  The default HTML version in the html folder
+   This download is required only once, unless you type "make clean-all".
-   requires internet access to view the embedded math expressions.  To
+   After that, viewing and  processing of the documentation can be done
-   be able to view the math offline, some extra data and javascript code
+   without internet access.  To generate the PDF version of the manual,
-   needs to be downloaded and the HTML generation needs to be changed to
+   the PDFLaTeX software and several LaTeX packages are required as well.
-   reference them.  When typing "make html-offline" this is done
+   However, those cannot be installed automatically at the moment.
-   automatically.  Same as for the sphinx tool and its extensions, this
-   download is required only once.  After that also the processing of
-   the documentation can be done without internet access.  To generate
-   the PDF version of the manual, additionally the PDFLaTeX software and
-   several LaTeX packages are required.
 
 ----------
 
@@ -59,7 +53,6 @@ the doc directory.
    Documentation Build Options:
 
    make html          # generate HTML in html dir using Sphinx
-   make html-offline  # generate offline viewable HTML in html-offline dir using Sphinx
    make pdf           # generate 2 PDF files (Manual.pdf,Developer.pdf)
                       #   in doc dir via htmldoc and pdflatex
    make fetch         # fetch HTML doc pages and 2 PDF files from web site

doc/utils/sphinx-config/conf.py

@@ -210,6 +210,9 @@ if 'epub' in sys.argv:
 else:
   html_math_renderer = 'mathjax'
 
+# use relative path for mathjax, so it is looked for in the
+# html tree and the manual becomes readable when offline 
+mathjax_path = 'mathjax/es5/tex-mml-chtml.js'
 # -- Options for LaTeX output ---------------------------------------------
 
 latex_elements = {

doc/utils/sphinx-config/false_positives.txt

@@ -1638,6 +1638,7 @@ Masuhiro
 Matchett
 Materias
 mathbf
+mathjax
 matlab
 matplotlib
 Matsubara