Tutorial guidelines¶
Steps in GUI tutorials¶
For steps in tutorials use the rst-class:: steps
.
Example:
.. rst-class:: steps
| Optionally some context here
| **1.** The first step, e.g. click on **Edit → Builder**
| **2.** The seconf step.
Result:
GUI icons¶
In the Tutorials, you can refer to some GUI buttons/icons by using the following substitutions (these substitutions are defined in global_conf.py
, but that you have to initialize it in the conf.py
of your specific project. See the Tutorials/conf.py
).
Icon |
Substitution |
Name |
---|---|---|
|InfoBtn| |
More-info button |
|
|MoreBtn| |
Details |
|
|SCMMenu| |
SCM menu |
|
|Search| |
Search box |
|
|PointerTool| |
Pointer tool |
|
|CTool| |
Carbon tool |
|
|OTool| |
Oxygen tool |
|
|HTool| |
Hydrogen tool |
|
|XTool| |
Element tool |
|
|StructTool| |
Structure tool |
|
|CrystalTool| |
Periodic structure tool |
|
|SymmTool| |
Symmetrize tool |
|
|BondTool| |
Bond tool |
|
|PeriodicViewTool| |
Periodic display |
|
|SliceTool| |
Slice tool |
|
|PreOptimTool| |
Pre-optimizer button |
|
|ADFPanel| |
ADF panel |
|
|ADFviaAMSPanel| |
ADF via AMS panel |
|
|BANDPanel| |
BAND panel |
|
|ConformersPanel| |
Conformers panel |
|
|DFTBPanel| |
DFTB panel |
|
|MMPanel| |
MM panel |
|
|MopacPanel| |
Mopac panel |
|
|QMMMPanel| |
QMMM panel |
|
|QuantumESPRESSOPanel| |
Quantum ESPRESSO panel |
|
|QuildPanel| |
Quild panel |
|
|ReaxFFPanel| |
ReaxFF panel |
|
|ForceFieldPanel| |
ForceField panel |
|
|VASPPanel| |
VASP panel |
|
|AddButton| |
Add button |
|
|DeleteButton| |
Delete button |
Example:
.. rst-class:: steps
| In **ADFInput**
| **1.** Switch to the **BAND panel**: |ADFPanel| **→** |BANDPanel|
| **2.** In the **search box** |Search| search for ``Diamond`` and select **Crystal → C**
Result:
Conventions for step descriptions¶
How to phrase common tasks:
-1