Skip to content

Commit be196a1

Browse files
committed
updated README
1 parent 49be07b commit be196a1

File tree

2 files changed

+90
-1
lines changed

2 files changed

+90
-1
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# NMRforMD
1+
# NMRDfromMD
22

33
Dipolar Nuclear Magnetic Resonance from Molecular Dynamics
44
(NMRDfromMD) simulations is a Python toolkit designed for the computation of

developers/README.md

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,89 @@
1+
# NMRforMD - developer section
2+
3+
<a href="webp">
4+
<img src="../docs/source/figures/logo/logo-b.png" align="right" width="30%"/>
5+
</a>
6+
7+
## How to
8+
9+
If you intend to make modification to the code, please raise an issue or send me an email
10+
first. Then, fork the repository, apply your changes, then make a pull request
11+
that will be reviewed.
12+
13+
## Build the documentation
14+
15+
Clone the repository as follow:
16+
17+
``` bash
18+
git clone https://github.com/simongravelle/nmrformd.git --recurse-submodule
19+
```
20+
21+
Build the documentation locally from the [docs](docs/) folder by typing:
22+
23+
``` bash
24+
pip3 install -r requirements.txt
25+
make clean
26+
make html
27+
```
28+
29+
## Publish new pip version (1)
30+
31+
Publish a new pip version by following those
32+
[instructions](https://gist.github.com/arsho/fc651bfadd8a0f42be72156fd21bd8a9).
33+
34+
1 - if necessary, update *docs/source/conf.py*, *CITATION.cff*, and *setup.py*
35+
36+
2 - Create source distribution using
37+
38+
``` bash
39+
python3 setup.py sdist
40+
```
41+
42+
3 - Create a new release on Github using the generated tar.gz file located in dist/
43+
44+
4 - Update the link in setup.py
45+
46+
5 - Create wheel using:
47+
48+
``` bash
49+
python3 setup.py bdist_wheel
50+
```
51+
52+
6 - Upload to pypi using (with the appropriate number):
53+
54+
``` bash
55+
twine upload dist/nmrformd-0.1.0*
56+
```
57+
58+
![Powered by MDAnalysis](https://img.shields.io/badge/powered%20by-MDAnalysis-orange.svg?logoWidth=16&logo=data:image/x-icon;base64,AAABAAEAEBAAAAEAIAAoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJD+XwCY/fEAkf3uAJf97wGT/a+HfHaoiIWE7n9/f+6Hh4fvgICAjwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACT/yYAlP//AJ///wCg//8JjvOchXly1oaGhv+Ghob/j4+P/39/f3IAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAJH8aQCY/8wAkv2kfY+elJ6al/yVlZX7iIiI8H9/f7h/f38UAAAAAAAAAAAAAAAAAAAAAAAAAAB/f38egYF/noqAebF8gYaagnx3oFpUUtZpaWr/WFhY8zo6OmT///8BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgICAn46Ojv+Hh4b/jouJ/4iGhfcAAADnAAAA/wAAAP8AAADIAAAAAwCj/zIAnf2VAJD/PAAAAAAAAAAAAAAAAICAgNGHh4f/gICA/4SEhP+Xl5f/AwMD/wAAAP8AAAD/AAAA/wAAAB8Aov9/ALr//wCS/Z0AAAAAAAAAAAAAAACBgYGOjo6O/4mJif+Pj4//iYmJ/wAAAOAAAAD+AAAA/wAAAP8AAABhAP7+FgCi/38Axf4fAAAAAAAAAAAAAAAAiIiID4GBgYKCgoKogoB+fYSEgZhgYGDZXl5e/m9vb/9ISEjpEBAQxw8AAFQAAAAAAAAANQAAADcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAjo6Mb5iYmP+cnJz/jY2N95CQkO4pKSn/AAAA7gAAAP0AAAD7AAAAhgAAAAEAAAAAAAAAAACL/gsAkv2uAJX/QQAAAAB9fX3egoKC/4CAgP+NjY3/c3Nz+wAAAP8AAAD/AAAA/wAAAPUAAAAcAAAAAAAAAAAAnP4NAJL9rgCR/0YAAAAAfX19w4ODg/98fHz/i4uL/4qKivwAAAD/AAAA/wAAAP8AAAD1AAAAGwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALGxsVyqqqr/mpqa/6mpqf9KSUn/AAAA5QAAAPkAAAD5AAAAhQAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADkUFBSuZ2dn/3V1df8uLi7bAAAATgBGfyQAAAA2AAAAMwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB0AAADoAAAA/wAAAP8AAAD/AAAAWgC3/2AAnv3eAJ/+dgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA9AAAA/wAAAP8AAAD/AAAA/wAKDzEAnP3WAKn//wCS/OgAf/8MAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAIQAAANwAAADtAAAA7QAAAMAAABUMAJn9gwCe/e0Aj/2LAP//AQAAAAAAAAAA)
59+
![readthedoc](https://readthedocs.org/projects/nmrformd/badge/?version=latest)
60+
61+
## Publish new pip version (2)
62+
63+
This instruction are from [this page](https://gist.github.com/arsho/fc651bfadd8a0f42be72156fd21bd8a9).
64+
65+
Install last version using
66+
67+
```bash
68+
pip install -e .
69+
```
70+
71+
1 - Update version in conf.py
72+
73+
2 - Update CITATION.cff
74+
75+
3 - Update setup.py
76+
77+
4 - Update CHANGELOG
78+
79+
5 - Create source distribution using python3 setup.py sdist
80+
81+
6 - Create a new release on Github using the generated tar.gz file
82+
83+
7 - Update the link in setup.py
84+
85+
8 - Create wheel using python3 setup.py bdist_wheel
86+
87+
9 - Upload to pypi using twine upload dist/nmrformd-0.1.0* \
88+
89+

0 commit comments

Comments
 (0)