From f1ae6f40d7acffea1f7e2b40152173ab2624355b Mon Sep 17 00:00:00 2001
From: Tieqiong Zhang
Date: Thu, 22 Aug 2024 21:28:18 -0400
Subject: [PATCH] incorporate manual into deploying docs
---
doc/manual/extractEquations.py | 2 +-
doc/manual/fixHTMLCode.py | 2 +-
doc/manual/{ => html}/pdfgui.html | 50 +-
doc/manual/html/readme.txt | 2 +
doc/{manual => source}/images/Makefile | 0
doc/{manual => source}/images/eq-01.png | Bin
doc/{manual => source}/images/eq-02.png | Bin
doc/{manual => source}/images/fig2-01.png | Bin
doc/{manual => source}/images/fig2-02.png | Bin
doc/{manual => source}/images/fig2-03.png | Bin
doc/{manual => source}/images/fig2-04.png | Bin
doc/{manual => source}/images/fig2-05.png | Bin
doc/{manual => source}/images/fig2-06.png | Bin
doc/{manual => source}/images/fig2-07.png | Bin
doc/{manual => source}/images/fig2-08.png | Bin
doc/{manual => source}/images/fig2-09.png | Bin
doc/{manual => source}/images/fig2-10.png | Bin
doc/{manual => source}/images/fig2-11.png | Bin
doc/{manual => source}/images/fig3-01.png | Bin
doc/{manual => source}/images/fig3-02.png | Bin
doc/{manual => source}/images/fig3-03.png | Bin
doc/{manual => source}/images/fig3-04.png | Bin
doc/{manual => source}/images/fig3-05.png | Bin
doc/{manual => source}/images/fig3-06.png | Bin
doc/{manual => source}/images/fig3-07.png | Bin
doc/{manual => source}/images/fig3-08.png | Bin
doc/{manual => source}/images/fig3-09.png | Bin
doc/{manual => source}/images/fig3-10.png | Bin
doc/{manual => source}/images/fig4-01.png | Bin
doc/{manual => source}/images/fig4-02.png | Bin
.../images/originals/fig2-01.png | Bin
.../images/originals/fig2-01.xcf | Bin
.../images/originals/fig2-02.png | Bin
.../images/originals/fig2-03.png | Bin
.../images/originals/fig2-04.png | Bin
.../images/originals/fig2-05.png | Bin
.../images/originals/fig2-06.png | Bin
.../images/originals/fig2-07.png | Bin
.../images/originals/fig2-08.png | Bin
.../images/originals/fig2-09.png | Bin
.../images/originals/fig2-10.png | Bin
.../images/originals/fig2-11.png | Bin
.../images/originals/fig3-01.png | Bin
.../images/originals/fig3-02.png | Bin
.../images/originals/fig3-03.png | Bin
.../images/originals/fig3-04.png | Bin
.../images/originals/fig3-05.png | Bin
.../images/originals/fig3-06.png | Bin
.../images/originals/fig3-07.png | Bin
.../images/originals/fig3-08.png | Bin
.../images/originals/fig3-09.png | Bin
.../images/originals/fig3-10.png | Bin
.../images/originals/fig4-01.png | Bin
.../images/originals/fig4-02.png | Bin
doc/source/index.rst | 5 +-
doc/source/manual.rst | 16 +
.../manual_resources/Doping data series.zip | Bin 0 -> 226194 bytes
.../Nanoparticle structure.zip} | Bin 974246 -> 1114976 bytes
doc/source/manual_resources/Ni data.zip | Bin 0 -> 54796 bytes
.../Temperature data series.zip | Bin 0 -> 407331 bytes
.../manual_resources}/tui_mno_bond_lengths.py | 0
doc/source/tutorial.rst | 7 +-
doc/tutorial/1050K.gr | 2062 --------
doc/tutorial/1100K.gr | 2062 --------
doc/tutorial/1150K.gr | 2062 --------
doc/tutorial/300K.gr | 2062 --------
doc/tutorial/550K.gr | 2062 --------
doc/tutorial/650K.gr | 2062 --------
doc/tutorial/700K.gr | 2062 --------
doc/tutorial/720K.gr | 2062 --------
doc/tutorial/730K.gr | 2062 --------
doc/tutorial/740K.gr | 2062 --------
doc/tutorial/750K.gr | 2062 --------
doc/tutorial/800K.gr | 2062 --------
doc/tutorial/880K.gr | 2062 --------
doc/tutorial/980K.gr | 2062 --------
doc/tutorial/CdSe-3nm.gr | 4634 ----------------
doc/tutorial/CdSe-bulk.gr | 4635 -----------------
doc/tutorial/CdSe-wurtzite.stru | 33 -
doc/tutorial/Ni-neutron.gr | 2054 --------
doc/tutorial/Ni-xray.gr | 2134 --------
doc/tutorial/Ni.stru | 33 -
doc/tutorial/lcmo-template.ddp3 | Bin 130900 -> 0 bytes
doc/tutorial/lmo-template.ddp3 | Bin 195012 -> 0 bytes
doc/tutorial/x000t010q35.gr | 2007 -------
doc/tutorial/x004t010q35.gr | 2007 -------
doc/tutorial/x012t010q35.gr | 2007 -------
doc/tutorial/x016t010q35.gr | 2007 -------
doc/tutorial/x020t010q35.gr | 2007 -------
doc/tutorial/x024t010q35.gr | 2007 -------
doc/tutorial/x028t010q35.gr | 2007 -------
91 files changed, 52 insertions(+), 56472 deletions(-)
rename doc/manual/{ => html}/pdfgui.html (99%)
create mode 100644 doc/manual/html/readme.txt
rename doc/{manual => source}/images/Makefile (100%)
rename doc/{manual => source}/images/eq-01.png (100%)
rename doc/{manual => source}/images/eq-02.png (100%)
rename doc/{manual => source}/images/fig2-01.png (100%)
rename doc/{manual => source}/images/fig2-02.png (100%)
rename doc/{manual => source}/images/fig2-03.png (100%)
rename doc/{manual => source}/images/fig2-04.png (100%)
rename doc/{manual => source}/images/fig2-05.png (100%)
rename doc/{manual => source}/images/fig2-06.png (100%)
rename doc/{manual => source}/images/fig2-07.png (100%)
rename doc/{manual => source}/images/fig2-08.png (100%)
rename doc/{manual => source}/images/fig2-09.png (100%)
rename doc/{manual => source}/images/fig2-10.png (100%)
rename doc/{manual => source}/images/fig2-11.png (100%)
rename doc/{manual => source}/images/fig3-01.png (100%)
rename doc/{manual => source}/images/fig3-02.png (100%)
rename doc/{manual => source}/images/fig3-03.png (100%)
rename doc/{manual => source}/images/fig3-04.png (100%)
rename doc/{manual => source}/images/fig3-05.png (100%)
rename doc/{manual => source}/images/fig3-06.png (100%)
rename doc/{manual => source}/images/fig3-07.png (100%)
rename doc/{manual => source}/images/fig3-08.png (100%)
rename doc/{manual => source}/images/fig3-09.png (100%)
rename doc/{manual => source}/images/fig3-10.png (100%)
rename doc/{manual => source}/images/fig4-01.png (100%)
rename doc/{manual => source}/images/fig4-02.png (100%)
rename doc/{manual => source}/images/originals/fig2-01.png (100%)
rename doc/{manual => source}/images/originals/fig2-01.xcf (100%)
rename doc/{manual => source}/images/originals/fig2-02.png (100%)
rename doc/{manual => source}/images/originals/fig2-03.png (100%)
rename doc/{manual => source}/images/originals/fig2-04.png (100%)
rename doc/{manual => source}/images/originals/fig2-05.png (100%)
rename doc/{manual => source}/images/originals/fig2-06.png (100%)
rename doc/{manual => source}/images/originals/fig2-07.png (100%)
rename doc/{manual => source}/images/originals/fig2-08.png (100%)
rename doc/{manual => source}/images/originals/fig2-09.png (100%)
rename doc/{manual => source}/images/originals/fig2-10.png (100%)
rename doc/{manual => source}/images/originals/fig2-11.png (100%)
rename doc/{manual => source}/images/originals/fig3-01.png (100%)
rename doc/{manual => source}/images/originals/fig3-02.png (100%)
rename doc/{manual => source}/images/originals/fig3-03.png (100%)
rename doc/{manual => source}/images/originals/fig3-04.png (100%)
rename doc/{manual => source}/images/originals/fig3-05.png (100%)
rename doc/{manual => source}/images/originals/fig3-06.png (100%)
rename doc/{manual => source}/images/originals/fig3-07.png (100%)
rename doc/{manual => source}/images/originals/fig3-08.png (100%)
rename doc/{manual => source}/images/originals/fig3-09.png (100%)
rename doc/{manual => source}/images/originals/fig3-10.png (100%)
rename doc/{manual => source}/images/originals/fig4-01.png (100%)
rename doc/{manual => source}/images/originals/fig4-02.png (100%)
create mode 100644 doc/source/manual.rst
create mode 100644 doc/source/manual_resources/Doping data series.zip
rename doc/{tutorial/CdSe-nano.ddp3 => source/manual_resources/Nanoparticle structure.zip} (72%)
create mode 100644 doc/source/manual_resources/Ni data.zip
create mode 100644 doc/source/manual_resources/Temperature data series.zip
rename doc/{tutorial => source/manual_resources}/tui_mno_bond_lengths.py (100%)
delete mode 100644 doc/tutorial/1050K.gr
delete mode 100644 doc/tutorial/1100K.gr
delete mode 100644 doc/tutorial/1150K.gr
delete mode 100644 doc/tutorial/300K.gr
delete mode 100644 doc/tutorial/550K.gr
delete mode 100644 doc/tutorial/650K.gr
delete mode 100644 doc/tutorial/700K.gr
delete mode 100644 doc/tutorial/720K.gr
delete mode 100644 doc/tutorial/730K.gr
delete mode 100644 doc/tutorial/740K.gr
delete mode 100644 doc/tutorial/750K.gr
delete mode 100644 doc/tutorial/800K.gr
delete mode 100644 doc/tutorial/880K.gr
delete mode 100644 doc/tutorial/980K.gr
delete mode 100644 doc/tutorial/CdSe-3nm.gr
delete mode 100644 doc/tutorial/CdSe-bulk.gr
delete mode 100644 doc/tutorial/CdSe-wurtzite.stru
delete mode 100644 doc/tutorial/Ni-neutron.gr
delete mode 100644 doc/tutorial/Ni-xray.gr
delete mode 100644 doc/tutorial/Ni.stru
delete mode 100644 doc/tutorial/lcmo-template.ddp3
delete mode 100644 doc/tutorial/lmo-template.ddp3
delete mode 100644 doc/tutorial/x000t010q35.gr
delete mode 100644 doc/tutorial/x004t010q35.gr
delete mode 100644 doc/tutorial/x012t010q35.gr
delete mode 100644 doc/tutorial/x016t010q35.gr
delete mode 100644 doc/tutorial/x020t010q35.gr
delete mode 100644 doc/tutorial/x024t010q35.gr
delete mode 100644 doc/tutorial/x028t010q35.gr
diff --git a/doc/manual/extractEquations.py b/doc/manual/extractEquations.py
index ce3a9819..8a5923c0 100644
--- a/doc/manual/extractEquations.py
+++ b/doc/manual/extractEquations.py
@@ -11,7 +11,7 @@
# constants
rc = {
- "directory": "images", # output directory
+ "directory": "../source/images", # output directory
"resolution": 72, # equation images resolution
"eqns": [], # list of raw equation codes
"tmpdir": None, # temporary directory
diff --git a/doc/manual/fixHTMLCode.py b/doc/manual/fixHTMLCode.py
index 0ec4b70a..0495fa40 100644
--- a/doc/manual/fixHTMLCode.py
+++ b/doc/manual/fixHTMLCode.py
@@ -12,7 +12,7 @@
# constants
rc = {
- "directory": "images", # directory with equation images
+ "directory": "../source/images", # directory with equation images
}
eqmark = ""
diff --git a/doc/manual/pdfgui.html b/doc/manual/html/pdfgui.html
similarity index 99%
rename from doc/manual/pdfgui.html
rename to doc/manual/html/pdfgui.html
index 24219aeb..5c4a963f 100644
--- a/doc/manual/pdfgui.html
+++ b/doc/manual/html/pdfgui.html
@@ -1069,7 +1069,7 @@ 2.2 Creating a simple fit using a preexisting structure file
exercise a preexisting structure file Ni.stru is to be loaded.
-
+
Figure 2.1: PDFgui window with fit tree and Plot Control panels to the left and
current action panel to the right. The fit tree panel features the current fit
@@ -1103,7 +1103,7 @@ 2.2 Creating a simple fit using a preexisting structure file
were collected at 300 K.
-
+
Figure 2.2: Appearance of a PDFgui window after a PDF dataset is loaded. The Fit
Tree panel features the current fit, loaded Ni structure, and loaded Ni PDF
@@ -1137,7 +1137,7 @@ 2.2 Creating a simple fit using a preexisting structure file
rightmost “quick-plot” button in the tool bar.
-
+
Figure 2.3: Adjusting data set related configuration.
@@ -1168,7 +1168,7 @@
2.2 Creating a simple fit using a preexisting structure file
Figure 2.4.
-
+
Figure 2.4: Setting up the refinement parameters and constraints.
@@ -1187,7 +1187,7 @@
2.2 Creating a simple fit using a preexisting structure file
-
+
Figure 2.5: Setting up the refinement parameters and constraints.
@@ -1210,7 +1210,7 @@
2.2 Creating a simple fit using a preexisting structure file
that the parameter assignment is done correctly.
-
+
Figure 2.6: Reviewing the fit parameters and conditions.
@@ -1231,7 +1231,7 @@
2.2 Creating a simple fit using a preexisting structure file
illustrated in Figure 2.7.
-
+
Figure 2.7: While the refinement is running, the refinement progress is
displayed in the PDFfit2 Output panel.
@@ -1252,7 +1252,7 @@ 2.2 Creating a simple fit using a preexisting structure file
may make it difficult to reproduce the fit.
-
+
Figure 2.8: Updating the set of initial values of refined parameters.
@@ -1267,13 +1267,13 @@
2.2 Creating a simple fit using a preexisting structure file
fitting is in progress, the content will be updated after each fit iteration.
-
+
Figure 2.9: An example of PDFgui plotting capabilities: displaying a fit.
-
+
Figure 2.10: An example of PDFgui plotting capabilities: displaying a parameter.
@@ -1284,7 +1284,7 @@
2.2 Creating a simple fit using a preexisting structure file
file, or saved along with the entire project for future reference.
-
+
Figure 2.11: Using “Journal” feature can be a convenient way for taking notes.
@@ -1406,7 +1406,7 @@
3.1 Building structure model using crystal symmetry
sites with the proper symmetry.
-
+
Figure 3.1: Expanding the unit cell using space group information.
@@ -1435,7 +1435,7 @@
3.1 Building structure model using crystal symmetry
identical to these described in Creating a simple fit using a preexisting structure file.
-
+
Figure 3.2: Setting up symmetry constraints to be used in a refinement.
@@ -1472,7 +1472,7 @@
3.2 Calculating PDF from a structure
set is loaded, as shown in Figure 3.3.
-
+
Figure 3.3: An example of the calculation configuration panel.
@@ -1582,7 +1582,7 @@
3.3.1 Multistage fitting
parameter is not yet refined. An example of this is shown in Figure 3.4.
-
+
Figure 3.4: An example of linked fits. The output of a converged fit will
be fed into the succeeding fit in the sequence as an input.
@@ -1678,7 +1678,7 @@ 3.3.2 Sequential fitting of incremental r-series
is done, you can review the results using the plot control.
-
+
Figure 3.5: Appearance of the setup panel for specifying an incremental r-series
fit conditions.
@@ -1741,7 +1741,7 @@ 3.3.3 Sequential fitting of temperature series
The data can be ordered by temperature by clicking the “Temperature” header.
-
+
Figure 3.6: Setting up a T-series sequential refinement for LaMnO3. Ordering
by temperature will ensure that the fits are linked correctly.
@@ -1768,7 +1768,7 @@ 3.3.3 Sequential fitting of temperature series
the plot of Uiso(20) vs T.
-
+
Figure 3.7: Displaying the refinement results as a function of external
parameter: T-series refinement of LaMnO3, example of isotropic ADP of
@@ -1828,7 +1828,7 @@ 3.3.4 Sequential fitting of doping series
previous example.
-
+
Figure 3.8: After loading of the Ca-doping data series of LaMnO3 system, proper
doping assignment needs to be carried out, as the doping levels introspected
@@ -1872,7 +1872,7 @@ 3.3.4 Sequential fitting of doping series
sequential refinement of the doping series.
-
+
Figure 3.9: Sequence of refined parameters, such as lattice constants, can be
plotted vs doping using PDFgui plotting facilities. Figure features lattice
@@ -2049,7 +2049,7 @@ 3.4 Nanoparticle structure
Quantitative size-dependent structure and strain determination of CdSe nanoparticles using atomic pair distribution function analysis.
-
+
Figure 3.10: Fitting the structure of a nanoparticle: 3nm CdSe
nanoparticle example.
@@ -2141,7 +2141,7 @@ 4.1 PDF plotting
-
+
Figure 4.1: Plotting window featuring Rw vs refinement step for Ni example.
The basic functionality for manipulating the plot is provided through icons
@@ -2185,7 +2185,7 @@ 4.2 Displaying the structure
An example Ni structure visualization with AtomEye is shown in Figure 4.2.
-
+
Figure 4.2: Using AtomEye functionality (if installed on your system) for 3D
visualization of the initial and refined PDF structures: example of Ni
@@ -2511,7 +2511,7 @@ Renamed variables
(float Å^-1, default 0 Å^-1, qsig in PDFFIT)
PDF Gaussian dampening envelope due to limited Q-resolution.
Not applied when equal to zero. The Gaussian envelope is of the form
-
+
- Dataset: qbroad
@@ -2627,7 +2627,7 @@ 5.4 PDF peak width
the motion can be strongly correlated leading to a sharpening of the first
peak(s) in the observed PDF. PDFfit2 provides three different correction terms
for the PDF peak width. The final width is given by
-
+
Here the primed sigma is the peak width without correlation, which is
computed from the anisotropic displacement parameters. The first two terms
correct for the effects of correlated motion. Within the scope of the users
diff --git a/doc/manual/html/readme.txt b/doc/manual/html/readme.txt
new file mode 100644
index 00000000..e1100ec8
--- /dev/null
+++ b/doc/manual/html/readme.txt
@@ -0,0 +1,2 @@
+This directory need to be relativly the same as doc/build/html/manual from
+doc/source/_static/images
diff --git a/doc/manual/images/Makefile b/doc/source/images/Makefile
similarity index 100%
rename from doc/manual/images/Makefile
rename to doc/source/images/Makefile
diff --git a/doc/manual/images/eq-01.png b/doc/source/images/eq-01.png
similarity index 100%
rename from doc/manual/images/eq-01.png
rename to doc/source/images/eq-01.png
diff --git a/doc/manual/images/eq-02.png b/doc/source/images/eq-02.png
similarity index 100%
rename from doc/manual/images/eq-02.png
rename to doc/source/images/eq-02.png
diff --git a/doc/manual/images/fig2-01.png b/doc/source/images/fig2-01.png
similarity index 100%
rename from doc/manual/images/fig2-01.png
rename to doc/source/images/fig2-01.png
diff --git a/doc/manual/images/fig2-02.png b/doc/source/images/fig2-02.png
similarity index 100%
rename from doc/manual/images/fig2-02.png
rename to doc/source/images/fig2-02.png
diff --git a/doc/manual/images/fig2-03.png b/doc/source/images/fig2-03.png
similarity index 100%
rename from doc/manual/images/fig2-03.png
rename to doc/source/images/fig2-03.png
diff --git a/doc/manual/images/fig2-04.png b/doc/source/images/fig2-04.png
similarity index 100%
rename from doc/manual/images/fig2-04.png
rename to doc/source/images/fig2-04.png
diff --git a/doc/manual/images/fig2-05.png b/doc/source/images/fig2-05.png
similarity index 100%
rename from doc/manual/images/fig2-05.png
rename to doc/source/images/fig2-05.png
diff --git a/doc/manual/images/fig2-06.png b/doc/source/images/fig2-06.png
similarity index 100%
rename from doc/manual/images/fig2-06.png
rename to doc/source/images/fig2-06.png
diff --git a/doc/manual/images/fig2-07.png b/doc/source/images/fig2-07.png
similarity index 100%
rename from doc/manual/images/fig2-07.png
rename to doc/source/images/fig2-07.png
diff --git a/doc/manual/images/fig2-08.png b/doc/source/images/fig2-08.png
similarity index 100%
rename from doc/manual/images/fig2-08.png
rename to doc/source/images/fig2-08.png
diff --git a/doc/manual/images/fig2-09.png b/doc/source/images/fig2-09.png
similarity index 100%
rename from doc/manual/images/fig2-09.png
rename to doc/source/images/fig2-09.png
diff --git a/doc/manual/images/fig2-10.png b/doc/source/images/fig2-10.png
similarity index 100%
rename from doc/manual/images/fig2-10.png
rename to doc/source/images/fig2-10.png
diff --git a/doc/manual/images/fig2-11.png b/doc/source/images/fig2-11.png
similarity index 100%
rename from doc/manual/images/fig2-11.png
rename to doc/source/images/fig2-11.png
diff --git a/doc/manual/images/fig3-01.png b/doc/source/images/fig3-01.png
similarity index 100%
rename from doc/manual/images/fig3-01.png
rename to doc/source/images/fig3-01.png
diff --git a/doc/manual/images/fig3-02.png b/doc/source/images/fig3-02.png
similarity index 100%
rename from doc/manual/images/fig3-02.png
rename to doc/source/images/fig3-02.png
diff --git a/doc/manual/images/fig3-03.png b/doc/source/images/fig3-03.png
similarity index 100%
rename from doc/manual/images/fig3-03.png
rename to doc/source/images/fig3-03.png
diff --git a/doc/manual/images/fig3-04.png b/doc/source/images/fig3-04.png
similarity index 100%
rename from doc/manual/images/fig3-04.png
rename to doc/source/images/fig3-04.png
diff --git a/doc/manual/images/fig3-05.png b/doc/source/images/fig3-05.png
similarity index 100%
rename from doc/manual/images/fig3-05.png
rename to doc/source/images/fig3-05.png
diff --git a/doc/manual/images/fig3-06.png b/doc/source/images/fig3-06.png
similarity index 100%
rename from doc/manual/images/fig3-06.png
rename to doc/source/images/fig3-06.png
diff --git a/doc/manual/images/fig3-07.png b/doc/source/images/fig3-07.png
similarity index 100%
rename from doc/manual/images/fig3-07.png
rename to doc/source/images/fig3-07.png
diff --git a/doc/manual/images/fig3-08.png b/doc/source/images/fig3-08.png
similarity index 100%
rename from doc/manual/images/fig3-08.png
rename to doc/source/images/fig3-08.png
diff --git a/doc/manual/images/fig3-09.png b/doc/source/images/fig3-09.png
similarity index 100%
rename from doc/manual/images/fig3-09.png
rename to doc/source/images/fig3-09.png
diff --git a/doc/manual/images/fig3-10.png b/doc/source/images/fig3-10.png
similarity index 100%
rename from doc/manual/images/fig3-10.png
rename to doc/source/images/fig3-10.png
diff --git a/doc/manual/images/fig4-01.png b/doc/source/images/fig4-01.png
similarity index 100%
rename from doc/manual/images/fig4-01.png
rename to doc/source/images/fig4-01.png
diff --git a/doc/manual/images/fig4-02.png b/doc/source/images/fig4-02.png
similarity index 100%
rename from doc/manual/images/fig4-02.png
rename to doc/source/images/fig4-02.png
diff --git a/doc/manual/images/originals/fig2-01.png b/doc/source/images/originals/fig2-01.png
similarity index 100%
rename from doc/manual/images/originals/fig2-01.png
rename to doc/source/images/originals/fig2-01.png
diff --git a/doc/manual/images/originals/fig2-01.xcf b/doc/source/images/originals/fig2-01.xcf
similarity index 100%
rename from doc/manual/images/originals/fig2-01.xcf
rename to doc/source/images/originals/fig2-01.xcf
diff --git a/doc/manual/images/originals/fig2-02.png b/doc/source/images/originals/fig2-02.png
similarity index 100%
rename from doc/manual/images/originals/fig2-02.png
rename to doc/source/images/originals/fig2-02.png
diff --git a/doc/manual/images/originals/fig2-03.png b/doc/source/images/originals/fig2-03.png
similarity index 100%
rename from doc/manual/images/originals/fig2-03.png
rename to doc/source/images/originals/fig2-03.png
diff --git a/doc/manual/images/originals/fig2-04.png b/doc/source/images/originals/fig2-04.png
similarity index 100%
rename from doc/manual/images/originals/fig2-04.png
rename to doc/source/images/originals/fig2-04.png
diff --git a/doc/manual/images/originals/fig2-05.png b/doc/source/images/originals/fig2-05.png
similarity index 100%
rename from doc/manual/images/originals/fig2-05.png
rename to doc/source/images/originals/fig2-05.png
diff --git a/doc/manual/images/originals/fig2-06.png b/doc/source/images/originals/fig2-06.png
similarity index 100%
rename from doc/manual/images/originals/fig2-06.png
rename to doc/source/images/originals/fig2-06.png
diff --git a/doc/manual/images/originals/fig2-07.png b/doc/source/images/originals/fig2-07.png
similarity index 100%
rename from doc/manual/images/originals/fig2-07.png
rename to doc/source/images/originals/fig2-07.png
diff --git a/doc/manual/images/originals/fig2-08.png b/doc/source/images/originals/fig2-08.png
similarity index 100%
rename from doc/manual/images/originals/fig2-08.png
rename to doc/source/images/originals/fig2-08.png
diff --git a/doc/manual/images/originals/fig2-09.png b/doc/source/images/originals/fig2-09.png
similarity index 100%
rename from doc/manual/images/originals/fig2-09.png
rename to doc/source/images/originals/fig2-09.png
diff --git a/doc/manual/images/originals/fig2-10.png b/doc/source/images/originals/fig2-10.png
similarity index 100%
rename from doc/manual/images/originals/fig2-10.png
rename to doc/source/images/originals/fig2-10.png
diff --git a/doc/manual/images/originals/fig2-11.png b/doc/source/images/originals/fig2-11.png
similarity index 100%
rename from doc/manual/images/originals/fig2-11.png
rename to doc/source/images/originals/fig2-11.png
diff --git a/doc/manual/images/originals/fig3-01.png b/doc/source/images/originals/fig3-01.png
similarity index 100%
rename from doc/manual/images/originals/fig3-01.png
rename to doc/source/images/originals/fig3-01.png
diff --git a/doc/manual/images/originals/fig3-02.png b/doc/source/images/originals/fig3-02.png
similarity index 100%
rename from doc/manual/images/originals/fig3-02.png
rename to doc/source/images/originals/fig3-02.png
diff --git a/doc/manual/images/originals/fig3-03.png b/doc/source/images/originals/fig3-03.png
similarity index 100%
rename from doc/manual/images/originals/fig3-03.png
rename to doc/source/images/originals/fig3-03.png
diff --git a/doc/manual/images/originals/fig3-04.png b/doc/source/images/originals/fig3-04.png
similarity index 100%
rename from doc/manual/images/originals/fig3-04.png
rename to doc/source/images/originals/fig3-04.png
diff --git a/doc/manual/images/originals/fig3-05.png b/doc/source/images/originals/fig3-05.png
similarity index 100%
rename from doc/manual/images/originals/fig3-05.png
rename to doc/source/images/originals/fig3-05.png
diff --git a/doc/manual/images/originals/fig3-06.png b/doc/source/images/originals/fig3-06.png
similarity index 100%
rename from doc/manual/images/originals/fig3-06.png
rename to doc/source/images/originals/fig3-06.png
diff --git a/doc/manual/images/originals/fig3-07.png b/doc/source/images/originals/fig3-07.png
similarity index 100%
rename from doc/manual/images/originals/fig3-07.png
rename to doc/source/images/originals/fig3-07.png
diff --git a/doc/manual/images/originals/fig3-08.png b/doc/source/images/originals/fig3-08.png
similarity index 100%
rename from doc/manual/images/originals/fig3-08.png
rename to doc/source/images/originals/fig3-08.png
diff --git a/doc/manual/images/originals/fig3-09.png b/doc/source/images/originals/fig3-09.png
similarity index 100%
rename from doc/manual/images/originals/fig3-09.png
rename to doc/source/images/originals/fig3-09.png
diff --git a/doc/manual/images/originals/fig3-10.png b/doc/source/images/originals/fig3-10.png
similarity index 100%
rename from doc/manual/images/originals/fig3-10.png
rename to doc/source/images/originals/fig3-10.png
diff --git a/doc/manual/images/originals/fig4-01.png b/doc/source/images/originals/fig4-01.png
similarity index 100%
rename from doc/manual/images/originals/fig4-01.png
rename to doc/source/images/originals/fig4-01.png
diff --git a/doc/manual/images/originals/fig4-02.png b/doc/source/images/originals/fig4-02.png
similarity index 100%
rename from doc/manual/images/originals/fig4-02.png
rename to doc/source/images/originals/fig4-02.png
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 4821eb80..08740bd2 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -17,8 +17,8 @@ or neutron diffraction data and comes with built in graphical and structure
visualization capabilities.
PDFgui is a friendly interface to the PDFfit2 refinement engine, with many
-powerful extensions. To get started, please open the manual (:download:`html <../manual/pdfgui.html>`
-/:download:`pdf <../manual/pdfgui.pdf>`) from the help menu or follow the :ref:`quick_start`.
+powerful extensions. To get started, please open the :ref:`manual`
+(:download:`pdf <../manual/pdfgui.pdf>`) from the help menu or follow the :ref:`tutorial`.
=======
Authors
@@ -89,6 +89,7 @@ Table of contents
license
release
+ manual
Package API
=======
diff --git a/doc/source/manual.rst b/doc/source/manual.rst
new file mode 100644
index 00000000..9667d818
--- /dev/null
+++ b/doc/source/manual.rst
@@ -0,0 +1,16 @@
+.. _manual:
+
+Manual
+======
+
+Resources used
+--------------
+
+- :download:`Ni data `
+- :download:`Temperature data series `
+- :download:`Doping data series `
+- :download:`tui Mn-O script `
+- :download:`Nanoparticle structure `
+
+.. raw:: html
+ :file: ../manual/html/pdfgui.html
diff --git a/doc/source/manual_resources/Doping data series.zip b/doc/source/manual_resources/Doping data series.zip
new file mode 100644
index 0000000000000000000000000000000000000000..ad2213c06ecdaa30beebcae8004289cdebb8fe19
GIT binary patch
literal 226194
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