Eln chemotion

.github/workflows/localisation.yml

@@ -29,7 +29,7 @@ jobs:
                   java-version: "17"
 
             - name: Install dependencies
-              run: npm install
+              run: npm ci || npm install
 
             - name: Write translations
               run: npm run write-translations

.gitignore

@@ -21,7 +21,7 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 yarn.lock
-package-lock.json
+# package-lock.json
 # config for staging
 docusaurus.config.js
 .Rproj.user

docs/10_domains/60_synthetic_chemistry.mdx

@@ -16,43 +16,43 @@ During the synthesis of a desired compound, all steps, such as planning, realisa
 
 ## Data Types
 
-In synthetic chemistry different types of research data can be obtained. In general, this data is not limited to characterisation of synthesised products. A typical experiment starts with its design and planning, followed by carrying out the procedure in a laboratory setting. During realisation of an experiment, observations, experimental conditions, and yields are documented. Ideally, this manually collected research data is recorded digitally in an [Electronic Lab Notebooks (ELN)](/docs/eln/).
+In synthetic chemistry different types of research data can be obtained. In general, this data is not limited to characterisation of synthesised products. A typical experiment starts with its design and planning, followed by carrying out the procedure in a laboratory setting. During realisation of an experiment, observations, experimental conditions, and yields are documented. Ideally, this manually collected research data is recorded digitally in an [Electronic Lab Notebooks (ELN)](/docs/eln).
 
-The synthesis of a specific product is followed by analysing its properties. Regarding data collection, both manually determined and digital data can be obtained. Observations and results of analytical methods with no digital output (i.e., no data files) can be added manually to the ELN entry of the experiment, which include for example melting/boiling point, optical rotation, TLC Rf values, or refraction index. Digital data are obtained from analytical instruments, e.g., NMR, IR, MS. These data can be uploaded seamlessly from the analytical devices to an ELN and analysed therein. An overview on file extensions, file sizes and converters for several analytical methods is given in the table below. It is recommended to save raw data files in [proprietary file formats](/docs/format_standards/) alongside interoperable [open file formats](/docs/format_standards/) by using converters or the software of the analytical device. If no specific open format is currently available, export as .txt or .csv is recommended.
+The synthesis of a specific product is followed by analysing its properties. Regarding data collection, both manually determined and digital data can be obtained. Observations and results of analytical methods with no digital output (i.e., no data files) can be added manually to the ELN entry of the experiment, which include for example melting/boiling point, optical rotation, TLC Rf values, or refraction index. Digital data are obtained from analytical instruments, e.g., NMR, IR, MS. These data can be uploaded seamlessly from the analytical devices to an ELN and analysed therein. An overview on file extensions, file sizes and converters for several analytical methods is given in the table below. It is recommended to save raw data files in [proprietary file formats](/docs/format_standards) alongside interoperable [open file formats](/docs/format_standards) by using converters or the software of the analytical device. If no specific open format is currently available, export as .txt or .csv is recommended.
 
-Overall, [metadata](/docs/metadata/) should always be included when collecting and [storing](/docs/data_storage/) data to allow understanding of the research data in the long term.
+Overall, [metadata](/docs/metadata) should always be included when collecting and [storing](/docs/data_storage) data to allow understanding of the research data in the long term.
 
 ## ELNs and Other Tools
 
 For effective data management, software tools should be selected in a uniform manner within a project or research group with the aim to [organize](/docs/data_organisation)
 and streamline workflows. This involves establishing clear usage guidelines, including metadata templates drawn from minimum information standards for a given method, where available.
-These should be outlined in a [data management plan (DMP)](/docs/dmp) for each project. NFDI4Chem provides an [RDMO template](https://rdmo.nfdi4chem.de/) specifically tailored to the needs of chemists.
+These should be outlined in a [data management plan (DMP)](/docs/dmp) for each project. NFDI4Chem provides an [RDMO template](https://rdmo.nfdi4chem.de) specifically tailored to the needs of chemists.
 
-If you want your data to comply with the [FAIR principles](/docs/fair/) it can be very tedious and extremely time consuming if you try to apply the FAIR principles to your data retrospectively if your existing workflows involve a large degree of analogue documentation (e.g. paper lab notebooks). The reality is that you need tools to take care of certain aspects of the FAIR principles automatically so you don’t have to apply them manually each time. [Electronic Lab Notebooks (ELNs)](/docs/eln/) are very powerful tools that can help you with this. Depending on what ELN you use, the [metadata](/docs/metadata/) can be automatically assigned in both human and [machine-readable formats](/docs/format_standards/). Furthermore, some ELNs can automatically generate interoperable [open file formats](/docs/format_standards/#chemistry_formats) for your analytical data. Choosing the right ELN can be challenging and this process should be thought about and carried out carefully. You can find out more on [how to choose the right ELN here](/docs/choose_eln/):
+If you want your data to comply with the [FAIR principles](/docs/fair) it can be very tedious and extremely time consuming if you try to apply the FAIR principles to your data retrospectively if your existing workflows involve a large degree of analogue documentation (e.g. paper lab notebooks). The reality is that you need tools to take care of certain aspects of the FAIR principles automatically so you don’t have to apply them manually each time. [Electronic Lab Notebooks (ELNs)](/docs/eln) are very powerful tools that can help you with this. Depending on what ELN you use, the [metadata](/docs/metadata) can be automatically assigned in both human and [machine-readable formats](/docs/format_standards). Furthermore, some ELNs can automatically generate interoperable [open file formats](/docs/format_standards/#chemistry_formats) for your analytical data. Choosing the right ELN can be challenging and this process should be thought about and carried out carefully. You can find out more on [how to choose the right ELN here](/docs/choose_eln):
 
 <ElnFinder subDisc="Synthetic chemistry" />
 
-A tool to help you find the right ELN is the so-called [ELN finder](https://eln-finder.ulb.tu-darmstadt.de/home) which is a searchable online repository for many different ELNs. It is important to note that not one size fits all and that one ELN may be appropriate for one research group, another ELN may be more appropriate for a different research group. Within NFDI4Chem, Chemotion ELN is the reference instance (find out more here in our [knowledge base article overview of Chemotion](/docs/chemotion_eln/)). This means that our developments in automatically applying the FAIR data principles to research data are implemented in Chemotion first.
+A tool to help you find the right ELN is the so-called [ELN finder](https://eln-finder.ulb.tu-darmstadt.de/home) which is a searchable online repository for many different ELNs. It is important to note that not one size fits all and that one ELN may be appropriate for one research group, another ELN may be more appropriate for a different research group. Within NFDI4Chem, Chemotion ELN is the reference instance (find out more here in our [knowledge base article overview of Chemotion](/docs/chemotion)). This means that our developments in automatically applying the FAIR data principles to research data are implemented in Chemotion first.
 
 Chemotion is especially suitable for synthetic chemistry as it originally started out as an ELN for synthetic chemistry but has now been extended to a wider array of scientific disciplines through its [LabIMotion extension](https://chemotion.net/docs/labimotion).
 
 ## Publishing Data
 
-[Publishing research data](/docs/data_publishing/) is important in order to allow for the reuse of data by other researchers or for machine learning. Especially for machine learning, it is crucial that the data is published in a structured and standardised way. Where can you publish your data? Open access [data repositories](/docs/repositories/) are a good solution to provide your data for reuse by others. Choosing the right repository is crucial and as a general rule of thumb it is better to deposit your data in data-specific or discipline-specific repositories as these enforce more standardisation in how the data are published thus allowing for better machine-readability.
+[Publishing research data](/docs/data_publishing) is important in order to allow for the reuse of data by other researchers or for machine learning. Especially for machine learning, it is crucial that the data is published in a structured and standardised way. Where can you publish your data? Open access [data repositories](/docs/repositories) are a good solution to provide your data for reuse by others. Choosing the right repository is crucial and as a general rule of thumb it is better to deposit your data in data-specific or discipline-specific repositories as these enforce more standardisation in how the data are published thus allowing for better machine-readability.
 
-In order to reach as many researchers as possible, choosing the right repository can be crucial (more on this in the [article on choosing the right repository](/docs/choose_repository/)).
+In order to reach as many researchers as possible, choosing the right repository can be crucial (more on this in the [article on choosing the right repository](/docs/choose_repository)).
 
 Above you can see a modified version of our decision tree from our guide how to choose the right repository. Here is a table giving an overview of what data fits into what repository:
 
 {/* prettier-ignore-start */}
 | Data type | Data format | Suggested Repository | Criteria for selection |
 | :---- | :---- | :---- | :---- |
-| Nuclear Magnetic Resonance | Bruker XWIN-NMR format (zip), [JCAMP-DX](https://knowledgebase.nfdi4chem.de/knowledge_base/docs/JCAMP-DX/) | [**Chemotion**](https://www.chemotion-repository.net/welcome) | Passing basic checks, curation |
-| Nuclear Magnetic Resonance | Bruker XWIN-NMR format, JOEL format NMReData, nmrML, ISA JSON | [**nmrXiv**](https://docs.nmrxiv.org/) | Validations / Minimum information reporting standards |
-| Molecules and their properties, identification, reactions and experimental investigations | mass spectrometry: JCAMP-DX, [mzMl](https://knowledgebase.nfdi4chem.de/knowledge_base/docs/mzML/), mzXML (open, visualisable and processable), RAW for selected mass data types (processed and converted in JCAMP-DX), IR and Raman: JCAMP-DX, XRD: JCAMP-DX, UV/VIS: JCAMP-DX, Cyclic voltammetry: JCAMP-DX. \*Chemotion repo offers the option to convert data from different file formats into JCAMP-DX. | [**Chemotion**](https://www.chemotion-repository.net/welcome) | Passing basic checks, curation |
-| Inorganic crystal structures | Crystallographic Information File (CIF) | [**ICSD**](https://icsd.fiz-karlsruhe.de/) | Crystal structure data available |
-| Organic and metal-organic crystal structures | Crystallographic Information File (CIF) but other supporting file formats accepted | [**CSD**](https://www.ccdc.cam.ac.uk/structures/) | Cell parameters (single crystal), full coordinates (powder), in CIF format |
-| Organic, inorganic and metal-organic crystal structure data | primarily Crystallographic Information File (CIF) but other supporting file formats accepted | [**joint CCDC/FIZ Access Structures ServiceD**](https://www.ccdc.cam.ac.uk/structures//) | At least one CIF file must be included in the submission and structure factor data for all structures should be provided (if possible) |
+| Nuclear Magnetic Resonance | Bruker XWIN-NMR format (zip), [JCAMP-DX](https://knowledgebase.nfdi4chem.de/knowledge_base/docs/JCAMP-DX) | [**Chemotion**](https://www.chemotion-repository.net/welcome) | Passing basic checks, curation |
+| Nuclear Magnetic Resonance | Bruker XWIN-NMR format, JOEL format NMReData, nmrML, ISA JSON | [**nmrXiv**](https://docs.nmrxiv.org) | Validations / Minimum information reporting standards |
+| Molecules and their properties, identification, reactions and experimental investigations | mass spectrometry: JCAMP-DX, [mzMl](https://knowledgebase.nfdi4chem.de/knowledge_base/docs/mzML), mzXML (open, visualisable and processable), RAW for selected mass data types (processed and converted in JCAMP-DX), IR and Raman: JCAMP-DX, XRD: JCAMP-DX, UV/VIS: JCAMP-DX, Cyclic voltammetry: JCAMP-DX. \*Chemotion repo offers the option to convert data from different file formats into JCAMP-DX. | [**Chemotion**](https://www.chemotion-repository.net/welcome) | Passing basic checks, curation |
+| Inorganic crystal structures | Crystallographic Information File (CIF) | [**ICSD**](https://icsd.fiz-karlsruhe.de) | Crystal structure data available |
+| Organic and metal-organic crystal structures | Crystallographic Information File (CIF) but other supporting file formats accepted | [**CSD**](https://www.ccdc.cam.ac.uk/structures) | Cell parameters (single crystal), full coordinates (powder), in CIF format |
+| Organic, inorganic and metal-organic crystal structure data | primarily Crystallographic Information File (CIF) but other supporting file formats accepted | [**joint CCDC/FIZ Access Structures ServiceD**](https://www.ccdc.cam.ac.uk/structures/) | At least one CIF file must be included in the submission and structure factor data for all structures should be provided (if possible) |
 | Generic data from all disciplines of chemistry, all data that do not fit in the disciplinary repositories | format-independent | [**RADAR4Chem**](https://www.radar-service.eu/de) | Validation against metadata schema |
 {/* prettier-ignore-end */}
 
@@ -64,4 +64,4 @@ While for some data types & workflows it may be obvious how to comply with the F
 
 Many old devices do not put out open-data formats and some devices have no digital output at all which makes good RDM more challenging though not impossible given the right tools (e.g. Chemotion’s [ChemConverter](https://chemotion.net/docs/services/chemconverter) which automatically generates open file formats from analytical devices which are not capable of outputting them).
 
-One of the biggest challenges to RDM in Chemistry at the moment is the lack of inter-ELN interoperability. This means that it is very challenging if not impossible to transfer data between different ELNs. This makes it especially challenging for interdisciplinary collaborations where collaborating groups use different ELNs. There are, however, efforts underway to establish inter-ELN interoperability such as the [ELN consortium](https://github.com/TheELNConsortium/) of which Chemotion is a member.
+One of the biggest challenges to RDM in Chemistry at the moment is the lack of inter-ELN interoperability. This means that it is very challenging if not impossible to transfer data between different ELNs. This makes it especially challenging for interdisciplinary collaborations where collaborating groups use different ELNs. There are, however, efforts underway to establish inter-ELN interoperability such as the [ELN consortium](https://github.com/TheELNConsortium) of which Chemotion is a member.