Skip to content
Snippets Groups Projects
Commit e406f556 authored by Séamus O'Sullivan's avatar Séamus O'Sullivan
Browse files

Fix broken links for protocols pages.

parent 9dc53656
No related branches found
No related tags found
1 merge request!24Substitute relative paths with absolute links.
...@@ -14,7 +14,7 @@ How to share your magnetic resonance imaging protocols ...@@ -14,7 +14,7 @@ How to share your magnetic resonance imaging protocols
--- ---
![open-protocols](../../img/img-open-mrprot-flow.png) ![open-protocols]({% link img/img-open-mrprot-flow.png %})
## Purpose ## Purpose
...@@ -32,7 +32,7 @@ Available here: [http://open.win.ox.ac.uk/protocols/](http://open.win.ox.ac.uk/p ...@@ -32,7 +32,7 @@ Available here: [http://open.win.ox.ac.uk/protocols/](http://open.win.ox.ac.uk/p
Training guides are available for WIN members and external users. Access the guides below or via the left navigation menu. Training guides are available for WIN members and external users. Access the guides below or via the left navigation menu.
[![For WIN members](../../img/btn-win.png)](../protocols/protocols_guide_internal-how-1) [![For external researchers](../../img/btn-external.png)](../protocols/protocols_guide_external) [![For WIN members]({% link img/btn-win.png %})]({% link docs/protocols/protocols_guide_internal-how-1.md %}) [![For external researchers]({% link img/btn-external.png %})]({% link docs/protocols/protocols_guide_external.md %})
<!-- ## Citation <!-- ## Citation
......
...@@ -22,7 +22,7 @@ A guide for external researchers on how to use the Open WIN MR protocols databas ...@@ -22,7 +22,7 @@ A guide for external researchers on how to use the Open WIN MR protocols databas
## For external researchers ## For external researchers
External researchers are able to search the database for MR protocols which research teams have chosen to make openly available. These may be deposited to support publications as supplementary methods material, or they may form the main body of research in sequence development. External researchers are able to search the database for MR protocols which research teams have chosen to make openly available. These may be deposited to support publications as supplementary methods material, or they may form the main body of research in sequence development.
![gif - external](../../../img/img-protocols/gif_external.gif) ![gif - external]({% link img/img-protocols/gif_external.gif %})
### 1. Access the MR Protocols database ### 1. Access the MR Protocols database
Available here: [http://open.win.ox.ac.uk/protocols/](http://open.win.ox.ac.uk/protocols/) Available here: [http://open.win.ox.ac.uk/protocols/](http://open.win.ox.ac.uk/protocols/)
......
...@@ -13,7 +13,7 @@ nav_order: 2 ...@@ -13,7 +13,7 @@ nav_order: 2
--- ---
<!-- ![open-protocols](../../../img/img-open-mrprot-flow.png) --> <!-- ![open-protocols]({% link img/img-open-mrprot-flow.png %}) -->
## Contents ## Contents
...@@ -50,7 +50,7 @@ You might want to add a statement such as "available for re-use, but I'm unable ...@@ -50,7 +50,7 @@ You might want to add a statement such as "available for re-use, but I'm unable
Only WIN members (as determined by SSO authentication) are able to deposit protocols in the database. Only WIN members (as determined by SSO authentication) are able to deposit protocols in the database.
![gif-log in](../../../img/img-protocols/gif_login.gif) ![gif-log in]({% link img/img-protocols/gif_login.gif %})
To log in: To log in:
1. Go to [https://open.win.ox.ac.uk/protocols/](https://open.win.ox.ac.uk/protocols/) 1. Go to [https://open.win.ox.ac.uk/protocols/](https://open.win.ox.ac.uk/protocols/)
...@@ -63,7 +63,7 @@ To log in: ...@@ -63,7 +63,7 @@ To log in:
Protocols are saved to individual user profiles. Protocols are saved to individual user profiles.
![gif - add new protocol](../../../img/img-protocols/gif_add-protocol.gif) ![gif - add new protocol]({% link img/img-protocols/gif_add-protocol.gif %})
1. Once you are logged in, you will see the `Add Protocol` icon. 1. Once you are logged in, you will see the `Add Protocol` icon.
2. Click on `Add Protocol`, and you will be taken to the `Add new protocol` page. 2. Click on `Add Protocol`, and you will be taken to the `Add new protocol` page.
...@@ -81,7 +81,7 @@ You can enter details about your protocol which are relevant to the study as a w ...@@ -81,7 +81,7 @@ You can enter details about your protocol which are relevant to the study as a w
NOTE: If you are publishing customised pulse sequences, please be sure to indicate your willingness and requirements for sharing them (see [3.4.1 Custom Sequences](#3-4-1-custom-sequences) below). NOTE: If you are publishing customised pulse sequences, please be sure to indicate your willingness and requirements for sharing them (see [3.4.1 Custom Sequences](#3-4-1-custom-sequences) below).
![gif - top details](../../../img/img-protocols/gif_top-details.gif) ![gif - top details]({% link img/img-protocols/gif_top-details.gif %})
### 3.1 Project, hardware and species ### 3.1 Project, hardware and species
Some fields of this section are autmatically retrieved from your pdf and other ones have to be added by selecting the appropriate items from the dropdown menus like: Some fields of this section are autmatically retrieved from your pdf and other ones have to be added by selecting the appropriate items from the dropdown menus like:
...@@ -141,7 +141,7 @@ You can add details specific to individual sequences. These details may make the ...@@ -141,7 +141,7 @@ You can add details specific to individual sequences. These details may make the
Each of the sections below should be completed for each sequence. Each of the sections below should be completed for each sequence.
![gif - sequence details](../../../img/img-protocols/gif_sequence-details.gif) ![gif - sequence details]({% link img/img-protocols/gif_sequence-details.gif %})
### 5.1 Sequence name ### 5.1 Sequence name
This is identified from the pdf. You can update it or add any additional context where necessary. This is identified from the pdf. You can update it or add any additional context where necessary.
...@@ -181,4 +181,4 @@ Add any references which are relevant to this protocol for example the accompany ...@@ -181,4 +181,4 @@ Add any references which are relevant to this protocol for example the accompany
We recommend that you consider using the [CRediT](https://casrai.org/credit/) system for identifying individual author contributions. You may wish to order authors alphabetically. We recommend that you consider using the [CRediT](https://casrai.org/credit/) system for identifying individual author contributions. You may wish to order authors alphabetically.
![gif - references](../../../img/img-protocols/gif_references.gif) ![gif - references]({%link img/img-protocols/gif_references.gif %})
...@@ -13,7 +13,7 @@ nav_order: 3 ...@@ -13,7 +13,7 @@ nav_order: 3
--- ---
<!-- ![open-protocols](../../../img/img-open-mrprot-flow.png) --> <!--![open-protocols]({% link img/img-open-mrprot-flow.png %}) -->
We suggest using the free tool Zenodo for creating a Digital Object Identifier (DOI) for your protocol. This will allow others to cite your protocol independently from other work in the study and add contributors who may not be named elsewhere. We suggest using the free tool Zenodo for creating a Digital Object Identifier (DOI) for your protocol. This will allow others to cite your protocol independently from other work in the study and add contributors who may not be named elsewhere.
......
...@@ -13,12 +13,12 @@ nav_order: 4 ...@@ -13,12 +13,12 @@ nav_order: 4
--- ---
<!-- ![open-protocols](../../../img/img-open-mrprot-flow.png) --> <!--![open-protocols]({% link img/img-open-mrprot-flow.png %})-->
If you are using the protocols database to track changes made to your protocol while piloting, you can amend the entry and create a new version that can be reviewed at any point. If you are using the protocols database to track changes made to your protocol while piloting, you can amend the entry and create a new version that can be reviewed at any point.
![gif - update](../../../img/img-protocols/gif_update.gif) ![gif - update]({% link img/img-protocols/gif_update.gif %})
1. Go to `my protocols` and find the entry you would like to update. 1. Go to `my protocols` and find the entry you would like to update.
2. Select if you are adding a new protocol pdf file (`Update with new protocol file`) or making changes to other parts of the entry (`Update keeping existing protocol file`) 2. Select if you are adding a new protocol pdf file (`Update with new protocol file`) or making changes to other parts of the entry (`Update keeping existing protocol file`)
......
...@@ -13,7 +13,7 @@ nav_order: 5 ...@@ -13,7 +13,7 @@ nav_order: 5
--- ---
<!-- ![open-protocols](../../../img/img-open-mrprot-flow.png) --> <!--![open-protocols]({% link img/img-open-mrprot-flow.png %})-->
You can track how many times your protocol has been viewed and downloaded from the `Engagement Statistics` panel. Views and downloads are separated into internal to Oxford (users have logged in with an SSO) or external. When reporting on the impact of your entry, remember to also include the Zenodo views and downloads statistics, if you have used Zenodo to create a DOI. You can track how many times your protocol has been viewed and downloaded from the `Engagement Statistics` panel. Views and downloads are separated into internal to Oxford (users have logged in with an SSO) or external. When reporting on the impact of your entry, remember to also include the Zenodo views and downloads statistics, if you have used Zenodo to create a DOI.
...@@ -15,20 +15,20 @@ Why you should consider using the WIN MR protocols database to record and share ...@@ -15,20 +15,20 @@ Why you should consider using the WIN MR protocols database to record and share
--- ---
<!-- ![open-protocols](../../../img/img-open-mrprot-flow.png) --> <!--![open-protocols]({% link img/img-open-mrprot-flow.png %}) -->
*The MR protocol database has been developed to share MR protocols internally across WIN as well as externally. The database provides access to standard protocols and to the latest experimental protocols uploaded by WIN members. The database facilitates sharing your MR sequence within and between research groups and helps you to keep track of updates using version control. Each deposited protocol contains all information necessary to reproduce that sequence on an appropriately licensed scanner, allowing yourself and others to have a permanent and full record of your data acquisition methodology.* *The MR protocol database has been developed to share MR protocols internally across WIN as well as externally. The database provides access to standard protocols and to the latest experimental protocols uploaded by WIN members. The database facilitates sharing your MR sequence within and between research groups and helps you to keep track of updates using version control. Each deposited protocol contains all information necessary to reproduce that sequence on an appropriately licensed scanner, allowing yourself and others to have a permanent and full record of your data acquisition methodology.*
## Benefits ## Benefits
### Version control ![version-control](../../../img/icon-version-control.png) ### Version control ![version-control]({% link img/icon-version-control.png %})
The MR Protocols database is version controlled, so WIN members are invited to upload their protocols during piloting to keep track of optimisation and final versions. Comments and notes can be added to each entry so you can keep well structured documentation about why certain decisions were made. You can also link database entries with acquired data held on the [Open Data](../../data) server The MR Protocols database is version controlled, so WIN members are invited to upload their protocols during piloting to keep track of optimisation and final versions. Comments and notes can be added to each entry so you can keep well structured documentation about why certain decisions were made. You can also link database entries with acquired data held on the [Open Data]({% link docs/data.md %}) server.
### Citable research output ![doi](../../../img/icon-doi.png) ### Citable research output ![doi]({% link img/icon-doi.png %})
Versions (with minor and major edits) can be assigned a digital object identifier (DOI) using the [Oxford Research Archive (ORA) Data repository](https://deposit.ora.ox.ac.uk) using the stable link provided by the MR Protocols database. Once a DOI has been created, your MR protocol becomes a citable object which you can add to your list of research outputs. Versions (with minor and major edits) can be assigned a digital object identifier (DOI) using the [Oxford Research Archive (ORA) Data repository](https://deposit.ora.ox.ac.uk) using the stable link provided by the MR Protocols database. Once a DOI has been created, your MR protocol becomes a citable object which you can add to your list of research outputs.
### Reproducible methods detail ![reproduce](../../../img/icon-reproduce.png) ### Reproducible methods detail ![reproduce]({% link img/icon-reproduce.png %})
Depositing your MR protocol in the database is as simple as uploading the sequence pdf available from the scanner console, or alternatively you can upload the .exar file used by our [Siemens scanners](https://www.win.ox.ac.uk/about/facilities). Sequences' details are captured from either document and parsed into a unified machine readable and searchable format. You can upload a single sequence or all sequences used in a single imaging session (a protocol) together. Depositing your MR protocol in the database is as simple as uploading the sequence pdf available from the scanner console, or alternatively you can upload the .exar file used by our [Siemens scanners](https://www.win.ox.ac.uk/about/facilities). Sequences' details are captured from either document and parsed into a unified machine readable and searchable format. You can upload a single sequence or all sequences used in a single imaging session (a protocol) together.
......
...@@ -14,4 +14,4 @@ nav_exclude: true ...@@ -14,4 +14,4 @@ nav_exclude: true
--- ---
![open-protocols](../../../img/img-open-mrprot-flow.png) ![open-protocols]({% link img/img-open-mrprot-flow.png %})
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment