deploy: dffe295

Avogadro · Nov 24, 2023 · e9a526a · e9a526a
1 parent 52c507e
commit e9a526a
Show file tree

Hide file tree

Showing 39 changed files with 100 additions and 155 deletions.
diff --git a/.doctrees/docs/getting-started/drawing-molecules.doctree b/.doctrees/docs/getting-started/drawing-molecules.doctree
diff --git a/.doctrees/docs/getting-started/making-selections.doctree b/.doctrees/docs/getting-started/making-selections.doctree
diff --git a/.doctrees/docs/tools/draw-tool.doctree b/.doctrees/docs/tools/draw-tool.doctree
diff --git a/.doctrees/docs/tools/selection-tool.doctree b/.doctrees/docs/tools/selection-tool.doctree
diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
diff --git a/_images/3319fb45-a4fd-4648-a2e0-11c0f3e51d72.png b/_images/3319fb45-a4fd-4648-a2e0-11c0f3e51d72.png
diff --git a/_images/3552dc0d-842c-45ac-895f-470df38a100f.png b/_images/3552dc0d-842c-45ac-895f-470df38a100f.png
diff --git a/_images/3b084771-e8cb-497f-86cf-595a38516ad6.png b/_images/3b084771-e8cb-497f-86cf-595a38516ad6.png
diff --git a/_images/60e63e32-ca96-495d-8238-bfa03b2cf0f8.png b/_images/60e63e32-ca96-495d-8238-bfa03b2cf0f8.png
diff --git a/_images/88dce68b-0801-44fe-bf0a-711fe4d79717.png b/_images/88dce68b-0801-44fe-bf0a-711fe4d79717.png
diff --git a/_images/920ffd71-e049-4985-8321-4add7cd04bf2.png b/_images/920ffd71-e049-4985-8321-4add7cd04bf2.png
diff --git a/_images/97584b85-bc1c-4ae0-8666-6db7fe255fc7.png b/_images/97584b85-bc1c-4ae0-8666-6db7fe255fc7.png
diff --git a/_images/a64918a4-9158-427c-92d3-f70839c39b7f.png b/_images/a64918a4-9158-427c-92d3-f70839c39b7f.png
diff --git a/.../df25a76f-030a-4414-bb0c-ae2ca98c1f78.png → .../ada26872-ede7-4601-bd4e-d790c10ad614.png b/.../df25a76f-030a-4414-bb0c-ae2ca98c1f78.png → .../ada26872-ede7-4601-bd4e-d790c10ad614.png
diff --git a/_images/d8a2035c-15e6-47b1-a6fd-3903ea7c1599.png b/_images/d8a2035c-15e6-47b1-a6fd-3903ea7c1599.png
diff --git a/_images/drag-to-build.png b/_images/drag-to-build.png
diff --git a/_images/draw-tool.png b/_images/draw-tool.png
diff --git a/_images/e87cd104-b0a5-4b7a-80bd-562252aed8b6.png b/_images/e87cd104-b0a5-4b7a-80bd-562252aed8b6.png
diff --git a/_images/e90a230d-8b65-4f23-93a6-cfb628709bf4.png b/_images/e90a230d-8b65-4f23-93a6-cfb628709bf4.png
diff --git a/_images/ef00012d-e09d-400d-b1e7-387b9e0d59ee.png b/_images/ef00012d-e09d-400d-b1e7-387b9e0d59ee.png
diff --git a/_images/f394d0be-61bc-46ec-ab0f-5bb1ae905293.png b/_images/f394d0be-61bc-46ec-ab0f-5bb1ae905293.png
diff --git a/_images/fc2cc0bf-ef17-49c4-9e48-44e5f9c971bc.png b/_images/fc2cc0bf-ef17-49c4-9e48-44e5f9c971bc.png
diff --git a/_images/first-carbon.png b/_images/first-carbon.png
diff --git a/_images/pick-an-element.png b/_images/pick-an-element.png
diff --git a/_images/tutorial-adjust-hydrogens.png b/_images/tutorial-adjust-hydrogens.png
diff --git a/_images/tutorial-bond-order.png b/_images/tutorial-bond-order.png
diff --git a/_images/tutorial-co2-step1.png b/_images/tutorial-co2-step1.png
diff --git a/_images/tutorial-co2-step3.png b/_images/tutorial-co2-step3.png
diff --git a/_images/tutorial-water.png b/_images/tutorial-water.png
diff --git a/_sources/docs/getting-started/drawing-molecules.md.txt b/_sources/docs/getting-started/drawing-molecules.md.txt
@@ -7,33 +7,33 @@ You can also use the new [template tool](template-tool) which makes it easier
 to attach functional groups or assemble inorganic / organometallic complexes.
 ```
 
-![Screenshot of the draw tool](../../_static/draw-tool.png")
+![Screenshot of the draw tool](../../_static/draw-tool.png)
 
 Left clicking on the display will allow you to begin your journey into molecule creation. A left click will generate a carbon atom. A right click will delete the atom.
 
-![](../../_static/first-carbon.png")
+![](../../_static/first-carbon.png)
 
 Left clicking the initial atom and dragging your mouse will generate a bond to another carbon atom.
 
-![](../../_static/drag-to-build.png")
+![](../../_static/drag-to-build.png)
 
 Avogadro uses carbon as the default element. A different element can be selected through the "Element" drop down menu. Typing the atomic symbol (e.g., "O" for Oxygen, "A-s" for Arsenic) is a shortcut for changing the selected element.
 
-![](../../_static/pick-an-element.png")
+![](../../_static/pick-an-element.png)
 
 Let's say you wanted to create water. You can either type in "O", or select "Oxygen (8)" from the drop down menu, and then click on the black display.
 
 Left clicking on an atom that has already been generated will also change the element. In this case, clicking on the initial carbon atom changed it into an oxygen atom.
 
-![](../../_static/tutorial-water.png")
+![](../../_static/tutorial-water.png)
 
 If the "Adjust Hydrogens" box is checked, hydrogen atoms in the molecule will be automatically adjusted to satisfy valency (as shown above).
 
-![](../../_static/tutorial-adjust-hydrogens.png")
+![](../../_static/tutorial-adjust-hydrogens.png)
 
 Bond order is changed through the "Bond Order" drop down menu, or by typing the numbers "1", "2", or "3". Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond.
 
-![](../../_static/tutorial-bond-order.png")
+![](../../_static/tutorial-bond-order.png)
 
 ```{tip} **New in 2.0**
 The default bond order is "Automatic," and will adjust with the length of the bond.
@@ -43,12 +43,12 @@ The default bond order is "Automatic," and will adjust with the length of the bo
 
 Begin drawing the "O-C-O" structure. After the structure is drawn, all you need to do is left click on the bonds. Left clicking on the bonds will create a double bond (shown below).
 
-![](../../_static/tutorial-co2-step1.png")
-![](../../_static/tutorial-co2-step2.png")
-![](../../_static/tutorial-co2-step3.png")
+![](../../_static/tutorial-co2-step1.png)
+![](../../_static/tutorial-co2-step2.png)
+![](../../_static/tutorial-co2-step3.png)
 
 Once you've created your molecule, you can optimize it's geometry through the extensions menu. Selecting the "Extensions" menu, and clicking "Optimize Geometry" will provide your molecule with proper bond lengths and angles.
 
-![](../../_static/ada26872-ede7-4601-bd4e-d790c10ad614.png")
+![](../../_static/ada26872-ede7-4601-bd4e-d790c10ad614.png)
 
 You now know the basics of drawing a molecule in Avogadro!
diff --git a/_sources/docs/getting-started/making-selections.md.txt b/_sources/docs/getting-started/making-selections.md.txt
@@ -18,4 +18,4 @@ Clicking and dragging your cursor is another way molecules, or fragments of mole
 
 ![](../../_static/tutorial-select-drag.png)
 
-More information on selections can be found in the ["Tools" section](tools) and the "Select" menu.
+More information on selections can be found in the ["Tools" section](tools) and the ["Select" menu](select-menu).
diff --git a/_sources/docs/tools/draw-tool.md.txt b/_sources/docs/tools/draw-tool.md.txt
@@ -2,61 +2,53 @@
 
 # Draw Tool
 
-## 1. Creating a Molecule
+Molecules are built and edited with the [draw tool](draw-tool), which allows a "free-hand" sketch of new molecules.
 
-Molecules can be built and edited with the draw tool.
+```{tip} **New in 2.0**
+You can also use the new [template tool](template-tool) which makes it easier
+to attach functional groups or assemble inorganic / organometallic complexes.
+```
 
-![](../../_static/creating-a-molecule%20%281%29.png)
+![Screenshot of the draw tool](../../_static/draw-tool.png)
 
-## 2.
+Left clicking on the display will allow you to begin your journey into molecule creation. A left click will generate a carbon atom. A right click will delete the atom.
 
-You can begin creating a molecule by left clicking on the black display. This will generate a carbon atom. Right clicking on the atom will delete it.
+![](../../_static/first-carbon.png)
 
-![](../../_static/920ffd71-e049-4985-8321-4add7cd04bf2.png)
+Left clicking the initial atom and dragging your mouse will generate a bond to another carbon atom.
 
-## 3.
+![](../../_static/drag-to-build.png)
 
-Left clicking and dragging the mouse will generate a bond to another carbon atom.
+Avogadro uses carbon as the default element. A different element can be selected through the "Element" drop down menu. Typing the atomic symbol (e.g., "O" for Oxygen, "A-s" for Arsenic) is a shortcut for changing the selected element.
 
-![](../../_static/f394d0be-61bc-46ec-ab0f-5bb1ae905293.png)
+![](../../_static/pick-an-element.png)
 
-## 4.
-
-Avogadro uses carbon as the default element. A different element can be selected through the "Element" drop down menu. Typing the atomic symbol \(e.g., "A-s" for Arsenic\) is a shortcut for changing the selected element.
-
-![](../../_static/a64918a4-9158-427c-92d3-f70839c39b7f.png)
-
-## 5.
-
-Let's say you wanted to create water. You can either type in "O", or select "Oxygen \(8\)" from the drop down menu, and then click on the black display.
+Let's say you wanted to create water. You can either type in "O", or select "Oxygen (8)" from the drop down menu, and then click on the black display.
 
 Left clicking on an atom that has already been generated will also change the element. In this case, clicking on the initial carbon atom changed it into an oxygen atom.
 
-![](../../_static/e87cd104-b0a5-4b7a-80bd-562252aed8b6.png)
+![](../../_static/tutorial-water.png)
 
-## 6.
+If the "Adjust Hydrogens" box is checked, hydrogen atoms in the molecule will be automatically adjusted to satisfy valency (as shown above).
 
-If the "Adjust Hydrogens" box is checked, hydrogen atoms in the molecule are automatically adjusted to satisfy valency \(as shown above\).
+![](../../_static/tutorial-adjust-hydrogens.png)
 
-![](../../_static/60e63e32-ca96-495d-8238-bfa03b2cf0f8.png)
+Bond order is changed through the "Bond Order" drop down menu, or by typing the numbers "1", "2", or "3". Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond.
 
-## 7.
+![](../../_static/tutorial-bond-order.png)
 
-Bond order is changed through the "Bond Order" drop down menu, or by typing the numbers "1", "2", or "3". Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond, and the atom it's bonded to.
+```{tip} **New in 2.0**
+The default bond order is "Automatic," and will adjust with the length of the bond.
+```
 
-![](../../_static/d8a2035c-15e6-47b1-a6fd-3903ea7c1599.png)
+### Creating Carbon Dioxide
 
-## 8.
+Begin drawing the "O-C-O" structure. After the structure is drawn, all you need to do is left click on the bonds. Left clicking on the bonds will create a double bond (shown below).
 
-Creating Carbon Dioxide:
-
-Begin drawing the "O-C-O" structure. After the structure is drawn, all you need to do is left click on the bonds. Left clicking on the bonds will create a double bond \(shown below\).
-
-![](../../_static/e90a230d-8b65-4f23-93a6-cfb628709bf4.png)
-
-## 9.
+![](../../_static/tutorial-co2-step1.png)
+![](../../_static/tutorial-co2-step2.png)
+![](../../_static/tutorial-co2-step3.png)
 
 Once you've created your molecule, you can optimize it's geometry through the extensions menu. Selecting the "Extensions" menu, and clicking "Optimize Geometry" will provide your molecule with proper bond lengths and angles.
 
-![](../../_static/df25a76f-030a-4414-bb0c-ae2ca98c1f78.png)
-
+![](../../_static/ada26872-ede7-4601-bd4e-d790c10ad614.png)
diff --git a/_sources/docs/tools/selection-tool.md.txt b/_sources/docs/tools/selection-tool.md.txt
@@ -2,33 +2,20 @@
 
 The selection tool allows the indiviual selection of atoms, bonds, or fragments.
 
-![](../../_static/fc2cc0bf-ef17-49c4-9e48-44e5f9c971bc.png)
+![](../../_static/tutorial-select-tool.png)
 
-There are three types of selection modes: "Atom/Bond", "Residue", and "Molecule".
-
-The "Atom/Bond" selection mode provides you with the ability to select a single atom within a molecule. This is achieved by left clicking the atom. Pressing down the "Shift" button on your keyboard allows the selection of multiple atoms.
+The select provides you with the ability to select a single atom within a molecule. This is achieved by left clicking the atom. Press and holding the "shift" key allows for the selection of multiple atoms.
 
 Right clicking on the black display will clear the selection made.
 
-![](../../_static/ef00012d-e09d-400d-b1e7-387b9e0d59ee.png)
-
-The "Residue" selection mode will select an entire residue within the molecule, by clicking on a single atom in the residue.
-
-![](../../_static/3b084771-e8cb-497f-86cf-595a38516ad6.png)
-
-The "molecule" selection mode will select the entire molecule by clicking on an atom. Double clicking the molecule will also select the entire molecule.
-
-![](../../_static/3319fb45-a4fd-4648-a2e0-11c0f3e51d72.png)
-
-Molecules can also be selected by clicking and dragging your cursor across the display.
-
-![](../../_static/3552dc0d-842c-45ac-895f-470df38a100f.png)
+![](../../_static/tutorial-select-atom.png)
 
-Clicking on "Add Center of Atoms" will display a black ball where the center of the molecule is found.
+You can also double-click on an atom to select all atoms connected in that fragment or molecule.
 
-![](../../_static/97584b85-bc1c-4ae0-8666-6db7fe255fc7.png)
+![](../../_static/tutorial-select-all.png)
 
-Clicking on the "Add Center of Mass" will display a black ball where the center of mass of the molecule is found.
+Clicking and dragging your cursor is another way molecules, or fragments of molecules can be selected.
 
-![](../../_static/88dce68b-0801-44fe-bf0a-711fe4d79717.png)
+![](../../_static/tutorial-select-drag.png)
 
+More information on selections can be found in the ["Select" menu](select-menu).
diff --git a/docs/getting-started/drawing-molecules.html b/docs/getting-started/drawing-molecules.html
@@ -514,20 +514,20 @@ <h1>Drawing Molecules<a class="headerlink" href="#drawing-molecules" title="Link
 You can also use the new <a class="reference internal" href="../tools/template-tool.html#template-tool"><span class="std std-ref">template tool</span></a> which makes it easier
 to attach functional groups or assemble inorganic / organometallic complexes.</p>
 </div>
-<p><img alt="Screenshot of the draw tool" src="_static/draw-tool.png%22" /></p>
+<p><img alt="Screenshot of the draw tool" src="../../_images/draw-tool.png" /></p>
 <p>Left clicking on the display will allow you to begin your journey into molecule creation. A left click will generate a carbon atom. A right click will delete the atom.</p>
-<p><img alt="" src="_static/first-carbon.png%22" /></p>
+<p><img alt="" src="../../_images/first-carbon.png" /></p>
 <p>Left clicking the initial atom and dragging your mouse will generate a bond to another carbon atom.</p>
-<p><img alt="" src="_static/drag-to-build.png%22" /></p>
+<p><img alt="" src="../../_images/drag-to-build.png" /></p>
 <p>Avogadro uses carbon as the default element. A different element can be selected through the “Element” drop down menu. Typing the atomic symbol (e.g., “O” for Oxygen, “A-s” for Arsenic) is a shortcut for changing the selected element.</p>
-<p><img alt="" src="_static/pick-an-element.png%22" /></p>
+<p><img alt="" src="../../_images/pick-an-element.png" /></p>
 <p>Let’s say you wanted to create water. You can either type in “O”, or select “Oxygen (8)” from the drop down menu, and then click on the black display.</p>
 <p>Left clicking on an atom that has already been generated will also change the element. In this case, clicking on the initial carbon atom changed it into an oxygen atom.</p>
-<p><img alt="" src="_static/tutorial-water.png%22" /></p>
+<p><img alt="" src="../../_images/tutorial-water.png" /></p>
 <p>If the “Adjust Hydrogens” box is checked, hydrogen atoms in the molecule will be automatically adjusted to satisfy valency (as shown above).</p>
-<p><img alt="" src="_static/tutorial-adjust-hydrogens.png%22" /></p>
+<p><img alt="" src="../../_images/tutorial-adjust-hydrogens.png" /></p>
 <p>Bond order is changed through the “Bond Order” drop down menu, or by typing the numbers “1”, “2”, or “3”. Bonds are added by left clicking on a bond that has already been created. Right clicking on a bond deletes the bond.</p>
-<p><img alt="" src="_static/tutorial-bond-order.png%22" /></p>
+<p><img alt="" src="../../_images/tutorial-bond-order.png" /></p>
 <div class="admonition tip">
 <p class="admonition-title">Tip</p>
 <p><strong>New in 2.0</strong>
@@ -536,11 +536,11 @@ <h1>Drawing Molecules<a class="headerlink" href="#drawing-molecules" title="Link
 <section id="creating-carbon-dioxide">
 <h2>Creating Carbon Dioxide<a class="headerlink" href="#creating-carbon-dioxide" title="Link to this heading">#</a></h2>
 <p>Begin drawing the “O-C-O” structure. After the structure is drawn, all you need to do is left click on the bonds. Left clicking on the bonds will create a double bond (shown below).</p>
-<p><img alt="" src="_static/tutorial-co2-step1.png%22" />
-<img alt="" src="_static/tutorial-co2-step2.png%22" />
-<img alt="" src="_static/tutorial-co2-step3.png%22" /></p>
+<p><img alt="" src="../../_images/tutorial-co2-step1.png" />
+<img alt="" src="_static/tutorial-co2-step2.png" />
+<img alt="" src="../../_images/tutorial-co2-step3.png" /></p>
 <p>Once you’ve created your molecule, you can optimize it’s geometry through the extensions menu. Selecting the “Extensions” menu, and clicking “Optimize Geometry” will provide your molecule with proper bond lengths and angles.</p>
-<p><img alt="" src="_static/ada26872-ede7-4601-bd4e-d790c10ad614.png%22" /></p>
+<p><img alt="" src="../../_images/ada26872-ede7-4601-bd4e-d790c10ad614.png" /></p>
 <p>You now know the basics of drawing a molecule in Avogadro!</p>
 </section>
 </section>

diff --git a/docs/getting-started/making-selections.html b/docs/getting-started/making-selections.html
@@ -516,7 +516,7 @@ <h1>Making Selections<a class="headerlink" href="#making-selections" title="Link
 <p><img alt="" src="../../_images/tutorial-select-all.png" /></p>
 <p>Clicking and dragging your cursor is another way molecules, or fragments of molecules can be selected.</p>
 <p><img alt="" src="../../_images/tutorial-select-drag.png" /></p>
-<p>More information on selections can be found in the <a class="reference internal" href="../tools/index.html#tools"><span class="std std-ref">“Tools” section</span></a> and the “Select” menu.</p>
+<p>More information on selections can be found in the <a class="reference internal" href="../tools/index.html#tools"><span class="std std-ref">“Tools” section</span></a> and the <a class="reference internal" href="#select-menu"><span class="xref myst">“Select” menu</span></a>.</p>
 </section>
Original file line number	Diff line number	Diff line change
Expand Up		@@ -18,4 +18,4 @@ Clicking and dragging your cursor is another way molecules, or fragments of mole

		![](../../_static/tutorial-select-drag.png)

		More information on selections can be found in the ["Tools" section](tools) and the "Select" menu.
		More information on selections can be found in the ["Tools" section](tools) and the ["Select" menu](select-menu).