Summary of changes:
* Add a test for trailing whitespace, remove all trailling whitespace
* Add a test for broken URLs in docs, fix all broken URLs and permanent redirects
* Switch sphinx doc build to strict (warnings to errors) and nitpicky (broken links to warnings). Fix all sphinx warnings.
* Deploy docs from any commit to [kwant/kwant](https://gitlab.kwant-project.org/kwant/kwant) to https://test.kwant-project.org/doc/dev
* Deploy docs from any commit to master at kwant/kwant to https://kwant-project.org/doc/dev
* Deploy docs from any tag release tag (so anything that is vX.Y.Z) at kwant/kwant to https://kwant-project.org/doc/X.Y
... | ... |
@@ -15,7 +15,7 @@ cite the main paper that introduces Kwant: |
15 | 15 |
C. W. Groth, M. Wimmer, A. R. Akhmerov, X. Waintal, |
16 | 16 |
*Kwant: a software package for quantum transport*, |
17 | 17 |
`New J. Phys. 16, 063065 (2014) |
18 |
- <http://iopscience.iop.org/1367-2630/16/6/063065/article>`_. |
|
18 |
+ <https://iopscience.iop.org/1367-2630/16/6/063065/article>`_. |
|
19 | 19 |
|
20 | 20 |
|
21 | 21 |
Other references we ask you to consider |
1 | 1 |
new file mode 100644 |
... | ... |
@@ -0,0 +1,38 @@ |
1 |
+============ |
|
2 |
+Citing Kwant |
|
3 |
+============ |
|
4 |
+ |
|
5 |
+We provide Kwant as free software under a :doc:`BSD license <license>` as a |
|
6 |
+service to the physics community. If you have used Kwant for work that has |
|
7 |
+lead to a scientific publication, please mention the fact that you used it |
|
8 |
+explicitly in the text body. For example, you may add |
|
9 |
+ |
|
10 |
+ *the numerical calculations were performed using the Kwant code* |
|
11 |
+ |
|
12 |
+to the description of your numerical calculations. In addition, we ask you to |
|
13 |
+cite the main paper that introduces Kwant: |
|
14 |
+ |
|
15 |
+ C. W. Groth, M. Wimmer, A. R. Akhmerov, X. Waintal, |
|
16 |
+ *Kwant: a software package for quantum transport*, |
|
17 |
+ `New J. Phys. 16, 063065 (2014) |
|
18 |
+ <http://iopscience.iop.org/1367-2630/16/6/063065/article>`_. |
|
19 |
+ |
|
20 |
+ |
|
21 |
+Other references we ask you to consider |
|
22 |
+--------------------------------------- |
|
23 |
+ |
|
24 |
+If you have profited from the quantum transport functionality of Kwant, please |
|
25 |
+also cite the upcoming paper that describes the relevant algorithms. The |
|
26 |
+reference will also be added here once it is available. |
|
27 |
+ |
|
28 |
+Kwant owes much of its current performance to the use of the `MUMPS |
|
29 |
+<http://graal.ens-lyon.fr/MUMPS/>`_ library for solving systems of sparse linear |
|
30 |
+equations. If you have done high-performance calculations, we suggest citing |
|
31 |
+ |
|
32 |
+ P. R. Amestoy, I. S. Duff, J. S. Koster, J. Y. L’Excellent, SIAM. J. Matrix |
|
33 |
+ Anal. & Appl. 23 (1), 15 (2001). |
|
34 |
+ |
|
35 |
+Finally, if you use the routine for generation of circular ensembles of random |
|
36 |
+matrices, please cite |
|
37 |
+ |
|
38 |
+ \F. Mezzadri, Notices Am. Math. Soc. 54, 592 (2007). |