work on universal tree items

Author: briantoby

.github/workflows/test_builddocsite.yml

@@ -7,7 +7,7 @@
 # Also the tutorials.html file and the */data/index.html files are
 #     created by running scripts/makeGitTutorial
 
-# this is a test version that creates draft help pages from the MDhelp directory
+# this is a development version that creates draft help pages from the MDhelp directory
 
 name: test MD help w/build GSAS-II web site
 
@@ -97,7 +97,7 @@ jobs:
           mv _gsas2/GSASII/help ./help
       - name: Get rid of the rest of the GSAS-II files & other stuff not needed on web
         run: |
-          rm -rf _gsas2 webdocs scripts MDtutorials
+          rm -rf _gsas2 webdocs scripts MDtutorials MDhelp
         
       - name: Upload artifact  # creates zip file with website contents
         uses: actions/upload-pages-artifact@v3

MDhelp/.gitignore

@@ -1 +1,3 @@
 site
+pyproject.toml
+uv.lock

MDhelp/README.md

@@ -13,11 +13,12 @@ additional links that need to be added:
       60 docs/applicationwindow.md
      191 docs/mainmenu.md 
       95 docs/others.md 
+      10 docs/datatree.md
+     165 docs/commontreeitems.md
 
 These files have had only minor editing. A few need to be broken up:
 
-    170 docs/cluster.md
-     157 docs/datatree.md
+     170 docs/cluster.md
      445 docs/histgramtree.md
      154 docs/image.md
       59 docs/pairdistribution.md

MDhelp/docs/applicationwindow.md

@@ -17,7 +17,7 @@ The leftmost entries in the GSAS-II menu provide access to many features of GSAS
 Different information is displayed in the Data Editing Window, depending on which section of the [data tree](#Data_tree) is selected. For example, clicking on the "Notebook" entry of the data tree brings up the [Notebook editing window](#TBD), as documented elsewhere.
 
 <a name="Plots"></a>
-## GSAS-II Plots Window
+## GSAS-II Graphics Window
 
 This window presents all the graphical material as a multipage tabbed set of plots utilizing the matplotlib python package. Each page containing a graph or plot has a tool bar with these controls:
 

MDhelp/docs/commontreeitems.md

@@ -357,7 +357,7 @@ Actions to reposition the rigid body in either mode are:
 
 This tab is used to control settings used for a texture study of a material. This type of characterization usually requires diffraction data recorded with multiple detector orientations (the number of orientations will depend on sample and material symmetry). Do not confuse this with applying a [preferred orientation correction](./phase.md#preferred_orientation) (found in the ["Data" tab](#data)) in a structural study. The sample orientation relative to the detector axes is specified here and the detector orientation is specified for each histogram as goniometer omega, chi, phi and azimuth values (details below). These values must be specified.
 
-Texture analysis using GSAS-II employs spherical harmonics modeling, as described by Bunge, "Texture Analysis in Materials Science" (1982), and implemented by Von Dreele, J. Appl. Cryst., 30, 517-525 (1997) in GSAS. The even part of the orientation distribution function (ODF) via the general axis equatio
+Texture analysis using GSAS-II employs spherical harmonics modeling, as described by Bunge, "Texture Analysis in Materials Science" (1982), and implemented by Von Dreele, J. Appl. Cryst., 30, 517-525 (1997) in GSAS. The even part of the orientation distribution function (ODF) via the general axis equation
 
 $$
 A(x,y) = 1 + \sum_{L=2}^{N_L}{\frac{4\pi}{2L+1}} \sum_{m=-L}^{L} \sum_{n=-L}^{L} C_L^{mn} k_L^m(y) k_L^n(h)

MDhelp/docs/datatree.md

@@ -6,7 +6,8 @@ nav:
   - GUI components: applicationwindow.md
   - Main menu: mainmenu.md
   - Data tree items:
-    - Standard items: datatree.md
+    - Data tree overview: datatree.md
+    - Universal items: commontreeitems.md
     - Powder (PWDR): histgramtree.md
     - Images: image.md
     - PDF: pairdistribution.md
@@ -45,6 +46,7 @@ markdown_extensions:
 
 extra_javascript: 
   - https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML
+#  - https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js # MathJax library from CDN
 
 #local build settings from https://www.mkdocs.org/user-guide/deploying-your-docs/#local-files