diff --git a/docs/tutorials/synthesis-experiment.md b/docs/tutorials/synthesis-experiment.md new file mode 100644 index 0000000..dab0221 --- /dev/null +++ b/docs/tutorials/synthesis-experiment.md @@ -0,0 +1,91 @@ +--- +sidebar_position: 7 +title: Creating a synthesis experiment (chemistry) +--- + +This tutorial will show you how to use eLabFTW for registering chemistry experiments. + +:::note +There might be several ways to approach this. We're just showing you one way to do it. +::: + +## Creating a template + +It is a good idea to start by creating an Experiment Template for Synthesis experiments. Before that, let's create an Experiment Category: "Synthesis". + +### Add a category + +Go to "Experiments categories" page from the menu: + +
+ Experiment categories menu +
Experiment categories menu
+
+ +Click the "Create" button and add a category: "Synthesis". + +
+ Create experiment category +
Create experiment category
+
+ +### Add a template + +Next, go to "Experiments templates" page and create a new Experiment Template. + +
+ Experiment template menu +
Experiment template menu
+
+ + +Name it "Basic synthesis" or something similar. + +
+ Create experiment template +
Create experiment template
+
+ +Set the Category to "Synthesis" by clicking the first "Not set" above the title. + +
+ Set category +
Set category
+
+ +Now use the Main Text and the Custom fields to describe what you expect to have in your experiment. You can have a table, you can have links to compounds, ask the user to log various parameters such as pH or temperature. + +
+ Custom fields +
Custom fields
+
+ +## Creating the experiment + +Once you're satisfied with your template, create an experiment from that template. Click the "Create" button from the Experiments page, add a title and select the template: + +
+ Create experiment from template +
Create experiment from template
+
+ +Then fill the Custom fields and Main Text with information about the experiment. + + +## Using the Structure Editor + +From the Tools menu, select the "Chemical Structure Editor". + +This editor allows you to draw a reaction. You can then save the reaction as RXN file and attach that file to your experiment (we're working on making this step easier without having to download the file). + +
+ Chemical structure editor +
Chemical structure editor
+
+ +You can also export it in PNG so you can have the image in the Main text and display it from the main page by toggling the main content: + +
+ Listing reactions +
Listing reactions
+
diff --git a/static/img/tuto-syn-change-category.webp b/static/img/tuto-syn-change-category.webp new file mode 100644 index 0000000..18f7ed9 Binary files /dev/null and b/static/img/tuto-syn-change-category.webp differ diff --git a/static/img/tuto-syn-create-category.webp b/static/img/tuto-syn-create-category.webp new file mode 100644 index 0000000..1215f7f Binary files /dev/null and b/static/img/tuto-syn-create-category.webp differ diff --git a/static/img/tuto-syn-create-from-template.webp b/static/img/tuto-syn-create-from-template.webp new file mode 100644 index 0000000..e16de9e Binary files /dev/null and b/static/img/tuto-syn-create-from-template.webp differ diff --git a/static/img/tuto-syn-create-tpl.webp b/static/img/tuto-syn-create-tpl.webp new file mode 100644 index 0000000..70cef4e Binary files /dev/null and b/static/img/tuto-syn-create-tpl.webp differ diff --git a/static/img/tuto-syn-custom-fields.webp b/static/img/tuto-syn-custom-fields.webp new file mode 100644 index 0000000..e41935d Binary files /dev/null and b/static/img/tuto-syn-custom-fields.webp differ diff --git a/static/img/tuto-syn-editor.webp b/static/img/tuto-syn-editor.webp new file mode 100644 index 0000000..76491bb Binary files /dev/null and b/static/img/tuto-syn-editor.webp differ diff --git a/static/img/tuto-syn-exp-cat-menu.webp b/static/img/tuto-syn-exp-cat-menu.webp new file mode 100644 index 0000000..e1e7ba7 Binary files /dev/null and b/static/img/tuto-syn-exp-cat-menu.webp differ diff --git a/static/img/tuto-syn-exp-tpl-menu.webp b/static/img/tuto-syn-exp-tpl-menu.webp new file mode 100644 index 0000000..538e86e Binary files /dev/null and b/static/img/tuto-syn-exp-tpl-menu.webp differ diff --git a/static/img/tuto-syn-show.webp b/static/img/tuto-syn-show.webp new file mode 100644 index 0000000..e2d728e Binary files /dev/null and b/static/img/tuto-syn-show.webp differ