Simplify layout removing "VTKBook" from the URL

This commit updates the Makefile/make.bat to expect the sources to
be in the "VTKBook" directory.

Author: jcfr

Makefile

@@ -5,7 +5,7 @@
 # from the environment for the first two.
 SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = .
+SOURCEDIR     = VTKBook
 BUILDDIR      = _build
 
 # Put it first so that "make" without argument is like "make help".

about_page.md VTKBook/about_page.mdabout_page.md renamed to VTKBook/about_page.md

@@ -12,10 +12,10 @@ A markdown version of the VTK textbook is also a work-in-progress. The goal is t
 
 The markdown chapters started with the textbook PDF. We used a PDF to HTML Converter followed by an HTML to Markdown converter. The resulting Markdown file requires lots of hand editing, but much of this editing is repetitive. For the most part we did not edit the text. This means that Tcl in-line code still remains. Also API changes and new features in VTK are not included. A rewrite of the text is a much larger effort and may happen in the future.
 
-We did add code to link figure references to the figures. We used a set of [standard templates](VTKBook/Figures/FigureTemplates.txt) to caption the figures. We also link all references to VTK classes to their Doxygen documentation.
+We did add code to link figure references to the figures. We used a set of [standard templates](Figures/FigureTemplates.txt) to caption the figures. We also link all references to VTK classes to their Doxygen documentation.
 
 We handle two special cases:
 
-1) Equations - Berhdard Meehan encoded all of the 100 equations in the text into [Latex equations](VTKBook/Figures/Equations.txt).
+1) Equations - Berhdard Meehan encoded all of the 100 equations in the text into [Latex equations](Figures/Equations.txt).
 
 2) Figures - We used the [VTKBookFigures](https://kitware.github.io/vtk-examples/site/VTKBookFigures) to populate all of the figures generated by C++ or Tcl examples. Since Tcl is no longer supported, We translated the Tcl to C++ and Python. Also, Andrew Maclean created Python examples for all of the VTKBookFigures. Some figures do not have associated code, so we captured those figures from the PDF using screen captures.

citing.md VTKBook/citing.mdciting.md renamed to VTKBook/citing.md

@@ -8,9 +8,9 @@
 
 from datetime import date
 
-project = 'VTK Book'
-copyright = f'1993-{date.today().year}, VTK Book Authors and Contributors'
-author = 'VTK Book Authors and Contributors'
+project = "VTK Book"
+copyright = f"1993-{date.today().year}, VTK Book Authors and Contributors"
+author = "VTK Book Authors and Contributors"
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
@@ -22,24 +22,20 @@
     "myst_parser",
 ]
 
-myst_enable_extensions = [ 
+myst_enable_extensions = [
     "amsmath",
     "dollarmath", # support latex equation inside $ $
     "linkify", # convert bare links to hyperlinks
 ]
 myst_heading_anchors = 7
 
-templates_path = ['_templates']
+templates_path = ["_templates"]
 exclude_patterns = [
-    "_build",
     "Thumbs.db",
     ".DS_Store",
-    "README.md",
-    "VTKBook/Figures/README.md",
+    "Figures/README.md",
 ]
 
-
-
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
@@ -49,4 +45,4 @@
     "use_repository_button": True,
 }
 html_title = "VTK Book"
-html_static_path = ['_static']
+html_static_path = ["_static"]

conf.py VTKBook/conf.pyconf.py renamed to VTKBook/conf.py

@@ -7,8 +7,19 @@ resources for the fourth edition of the  [VTK textbook](https://vtk.org/vtk-text
 ```{toctree}
 :maxdepth: 1
 :caption: Contents
-:glob:
 about_page
 citing
-VTKBook/*
+00Preface.md
+01Chapter1.md
+02Chapter2.md
+03Chapter3.md
+04Chapter4.md
+05Chapter5.md
+06Chapter6.md
+07Chapter7.md
+08Chapter8.md
+09Chapter9.md
+10Chapter10.md
+11Chapter11.md
+12Chapter12.md
 ```

index.md VTKBook/index.mdindex.md renamed to VTKBook/index.md

@@ -7,7 +7,7 @@ REM Command file for Sphinx documentation
 if "%SPHINXBUILD%" == "" (
 	set SPHINXBUILD=sphinx-build
 )
-set SOURCEDIR=.
+set SOURCEDIR=VTKBook
 set BUILDDIR=_build
 
 %SPHINXBUILD% >NUL 2>NUL