Help:Contents: Difference between revisions
No edit summary |
No edit summary |
||
(5 intermediate revisions by 3 users not shown) | |||
Line 6: | Line 6: | ||
=== Molecule-related pages === | === Molecule-related pages === | ||
MolWiki.org among other information also contains pages related to particular molecules. The naming convention for such pages is based on the [http://en.wikipedia.org/wiki/Hill_system Hill system]. The total name for a molecule-related page should be constructed as a chemical formula according to the Hill system and an index number, which makes this page unique. Example: [[C10H17B-1]]. Index numbers are used for distinguishing different [http://en.wikipedia.org/wiki/Structural_isomer structural isomers]. Different conformers belonging to the same structural isomer are described in one article. | MolWiki.org among other information also contains pages related to particular molecules. The naming convention for such pages is based on the [http://en.wikipedia.org/wiki/Hill_system Hill system]. The total name for a molecule-related page should be constructed as a chemical formula according to the Hill system and an index number, which makes this page unique. Example: [[C10H17B-1]].<br/>Index numbers are used for distinguishing different [http://en.wikipedia.org/wiki/Structural_isomer structural isomers]. Different conformers belonging to the same structural isomer are described in one article.<br/>It is also reasonable to create an additional page with human-readable name corresponding to the compound, which [http://www.mediawiki.org/wiki/Help:Redirects redirects] to the main page of the molecule. Example: [[3-Methyl-1-boraadamantane]].<br/> | ||
You can find a 'copy/paste' template for your new article here: [[Help:MolTemplate]] | |||
=== Source code === | === Source code === | ||
To publish source code with highlighted syntax use code tags with indication of the language type: <pre>< | To publish source code with highlighted syntax use code tags with indication of the language type: | ||
<pre> | |||
<syntaxhighlight lang="your_language"> | |||
Your source code goes here... | Your source code goes here... | ||
</ | </syntaxhighlight> | ||
</pre> | |||
The following example is for Fortran: | The following example is for Fortran: | ||
<pre> | <pre> | ||
< | <syntaxhighlight lang="fortran"> | ||
C A Simple program | C A Simple program | ||
program hello | program hello | ||
print *, "Hello World!" | print *, "Hello World!" | ||
end program hello | end program hello | ||
</ | </syntaxhighlight> | ||
</pre> | </pre> | ||
The result is | The result is | ||
< | <syntaxhighlight lang="fortran"> | ||
C A Simple program | C A Simple program | ||
program hello | program hello | ||
print *, "Hello World!" | print *, "Hello World!" | ||
end program hello | end program hello | ||
</ | </syntaxhighlight> | ||
=== Mathematical formulae === | === Mathematical formulae === | ||
Line 48: | Line 52: | ||
=== Molecular structures === | === Molecular structures === | ||
MolWiki.org has a Jmol extension, which can be used to show molecular structures interactively. | MolWiki.org has a Jmol extension, which can be used to show molecular structures interactively. You can upload an XYZ file and visualize it as: | ||
<pre> | <pre> | ||
< | <jmol> | ||
<jmolApplet> | |||
<uploadedFileContents>C26NH28.xyz</uploadedFileContents> | |||
</jmolApplet> | |||
</jmol> | |||
</pre> | </pre> | ||
The example produces the following | The example produces the following: <br /> | ||
< | <jmol> | ||
<jmolApplet> | |||
<uploadedFileContents>C26NH28.xyz</uploadedFileContents> | |||
</jmolApplet> | |||
</jmol> | |||
<br /> | <br /> | ||
You can also | You can also do this without uploading a file. Instead, paste molecular data right in the text of the page. The following example | ||
<pre> | <pre> | ||
<jmol> | <jmol> | ||
Line 98: | Line 110: | ||
</jmolApplet> | </jmolApplet> | ||
</jmol> | </jmol> | ||
Sometimes structures defined in [http://wiki.jmol.org/index.php/File_formats/Coordinates#XYZ XYZ] format are visualized by Jmol with some missing bonds. In this case it is better to define structure in [http://wiki.jmol.org/index.php/File_formats/Coordinates#MOL_and_SD_.28Symyx_MDL.29 MOL] format like this: | |||
<pre> | |||
<jmol> | |||
<jmolApplet> | |||
<inlineContents> | |||
1 | |||
OpenBabel06141312083D | |||
13 12 0 0 0 0 0 0 0 0999 V2000 | |||
0.0001 0.0000 -0.6042 P 0 0 0 0 0 0 0 0 0 0 0 0 | |||
1.6159 -0.3009 0.2804 C 0 0 0 0 0 0 0 0 0 0 0 0 | |||
2.0189 -1.2740 -0.0163 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
2.3421 0.4621 -0.0161 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
1.5107 -0.2814 1.3713 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-1.0685 -1.2489 0.2803 C 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-2.1129 -1.1107 -0.0158 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-0.7715 -2.2593 -0.0167 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-0.9986 -1.1680 1.3712 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-0.5474 1.5497 0.2804 C 0 0 0 0 0 0 0 0 0 0 0 0 | |||
0.0941 2.3852 -0.0159 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-1.5711 1.7973 -0.0165 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-0.5121 1.4486 1.3712 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
1 6 1 0 0 0 0 | |||
1 10 1 0 0 0 0 | |||
1 2 1 0 0 0 0 | |||
2 5 1 0 0 0 0 | |||
3 2 1 0 0 0 0 | |||
4 2 1 0 0 0 0 | |||
6 9 1 0 0 0 0 | |||
7 6 1 0 0 0 0 | |||
8 6 1 0 0 0 0 | |||
10 13 1 0 0 0 0 | |||
11 10 1 0 0 0 0 | |||
12 10 1 0 0 0 0 | |||
</inlineContents> | |||
</jmolApplet> | |||
</jmol> | |||
</pre> | |||
The structure is then visualized with all explicitly defined bonds: | |||
<jmol> | |||
<jmolApplet> | |||
<inlineContents> | |||
1 | |||
OpenBabel06141312083D | |||
13 12 0 0 0 0 0 0 0 0999 V2000 | |||
0.0001 0.0000 -0.6042 P 0 0 0 0 0 0 0 0 0 0 0 0 | |||
1.6159 -0.3009 0.2804 C 0 0 0 0 0 0 0 0 0 0 0 0 | |||
2.0189 -1.2740 -0.0163 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
2.3421 0.4621 -0.0161 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
1.5107 -0.2814 1.3713 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-1.0685 -1.2489 0.2803 C 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-2.1129 -1.1107 -0.0158 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-0.7715 -2.2593 -0.0167 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-0.9986 -1.1680 1.3712 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-0.5474 1.5497 0.2804 C 0 0 0 0 0 0 0 0 0 0 0 0 | |||
0.0941 2.3852 -0.0159 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-1.5711 1.7973 -0.0165 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
-0.5121 1.4486 1.3712 H 0 0 0 0 0 0 0 0 0 0 0 0 | |||
1 6 1 0 0 0 0 | |||
1 10 1 0 0 0 0 | |||
1 2 1 0 0 0 0 | |||
2 5 1 0 0 0 0 | |||
3 2 1 0 0 0 0 | |||
4 2 1 0 0 0 0 | |||
6 9 1 0 0 0 0 | |||
7 6 1 0 0 0 0 | |||
8 6 1 0 0 0 0 | |||
10 13 1 0 0 0 0 | |||
11 10 1 0 0 0 0 | |||
12 10 1 0 0 0 0 | |||
</inlineContents> | |||
</jmolApplet> | |||
</jmol> | |||
Conversion from XYZ to MOL format can be easily done by using the [http://openbabel.org OpenBabel] program: | |||
$ babel file.xyz file.mol | |||
== Participating in discussion == | == Participating in discussion == | ||
Each article has a dedicated discussion page where you can ask questions, find more information on the topic and talk to other people. [http://www.mediawiki.org/wiki/Help:Talk_pages More information] about discussion pages is on MediaWiki site. | Each article has a dedicated discussion page where you can ask questions, find more information on the topic and talk to other people. [http://www.mediawiki.org/wiki/Help:Talk_pages More information] about discussion pages is on MediaWiki site. |
Latest revision as of 20:37, 26 September 2017
Editing pages
The most detailed explanation is given on the corresponding page of MediaWiki. In MolWiki.org the most important principles are:
- Please follow the general practice of good scientific writing.
- Prove your statements by including references to peer reviewed journals.
- Use preview functionality as much as possible! Try not to save changes just for testing purposes.
MolWiki.org among other information also contains pages related to particular molecules. The naming convention for such pages is based on the Hill system. The total name for a molecule-related page should be constructed as a chemical formula according to the Hill system and an index number, which makes this page unique. Example: C10H17B-1.
Index numbers are used for distinguishing different structural isomers. Different conformers belonging to the same structural isomer are described in one article.
It is also reasonable to create an additional page with human-readable name corresponding to the compound, which redirects to the main page of the molecule. Example: 3-Methyl-1-boraadamantane.
You can find a 'copy/paste' template for your new article here: Help:MolTemplate
Source code
To publish source code with highlighted syntax use code tags with indication of the language type:
<syntaxhighlight lang="your_language"> Your source code goes here... </syntaxhighlight>
The following example is for Fortran:
<syntaxhighlight lang="fortran"> C A Simple program program hello print *, "Hello World!" end program hello </syntaxhighlight>
The result is
C A Simple program
program hello
print *, "Hello World!"
end program hello
Mathematical formulae
You can include formulae by using
<math></math>
tags and LaTeX syntax. The example
<math> \operatorname{erfc}(x) = \frac{2}{\sqrt{\pi}} \int_x^{\infty} e^{-t^2}\,dt = \frac{e^{-x^2}}{x\sqrt{\pi}}\sum_{n=0}^\infty (-1)^n \frac{(2n)!}{n!(2x)^{2n}} </math>
produces the following output:
<math>
\operatorname{erfc}(x) = \frac{2}{\sqrt{\pi}} \int_x^{\infty} e^{-t^2}\,dt = \frac{e^{-x^2}}{x\sqrt{\pi}}\sum_{n=0}^\infty (-1)^n \frac{(2n)!}{n!(2x)^{2n}}
</math>
You can click on the formula to enlarge it.
Molecular structures
MolWiki.org has a Jmol extension, which can be used to show molecular structures interactively. You can upload an XYZ file and visualize it as:
<jmol> <jmolApplet> <uploadedFileContents>C26NH28.xyz</uploadedFileContents> </jmolApplet> </jmol>
The example produces the following:
<jmol>
<jmolApplet> <uploadedFileContents>C26NH28.xyz</uploadedFileContents> </jmolApplet>
</jmol>
You can also do this without uploading a file. Instead, paste molecular data right in the text of the page. The following example
<jmol> <jmolApplet> <inlineContents> 11 test F 0.000000000000 -0.000000000000 -1.685455090782 C 0.000000000000 -0.000000000000 -0.385040888542 N -1.006202819407 1.006202819407 0.139899574177 O -1.068429240123 2.026449428610 -0.506881519565 O -1.600251840223 0.695487106176 1.148009747048 N -0.368295793263 -1.374498612670 0.139899574177 O -1.220742064599 -1.938511578398 -0.506881519565 O 0.197816418158 -1.733602299174 1.148009747048 N 1.374498612670 0.368295793263 0.139899574177 O 2.289171304722 -0.087937850212 -0.506881519565 O 1.402435422065 1.038115192997 1.148009747048 </inlineContents> </jmolApplet> </jmol>
creates the window with structure:
<jmol>
<jmolApplet> <inlineContents> 11 test F 0.000000000000 -0.000000000000 -1.685455090782 C 0.000000000000 -0.000000000000 -0.385040888542 N -1.006202819407 1.006202819407 0.139899574177 O -1.068429240123 2.026449428610 -0.506881519565 O -1.600251840223 0.695487106176 1.148009747048 N -0.368295793263 -1.374498612670 0.139899574177 O -1.220742064599 -1.938511578398 -0.506881519565 O 0.197816418158 -1.733602299174 1.148009747048 N 1.374498612670 0.368295793263 0.139899574177 O 2.289171304722 -0.087937850212 -0.506881519565 O 1.402435422065 1.038115192997 1.148009747048 </inlineContents> </jmolApplet>
</jmol>
Sometimes structures defined in XYZ format are visualized by Jmol with some missing bonds. In this case it is better to define structure in MOL format like this:
<jmol> <jmolApplet> <inlineContents> 1 OpenBabel06141312083D 13 12 0 0 0 0 0 0 0 0999 V2000 0.0001 0.0000 -0.6042 P 0 0 0 0 0 0 0 0 0 0 0 0 1.6159 -0.3009 0.2804 C 0 0 0 0 0 0 0 0 0 0 0 0 2.0189 -1.2740 -0.0163 H 0 0 0 0 0 0 0 0 0 0 0 0 2.3421 0.4621 -0.0161 H 0 0 0 0 0 0 0 0 0 0 0 0 1.5107 -0.2814 1.3713 H 0 0 0 0 0 0 0 0 0 0 0 0 -1.0685 -1.2489 0.2803 C 0 0 0 0 0 0 0 0 0 0 0 0 -2.1129 -1.1107 -0.0158 H 0 0 0 0 0 0 0 0 0 0 0 0 -0.7715 -2.2593 -0.0167 H 0 0 0 0 0 0 0 0 0 0 0 0 -0.9986 -1.1680 1.3712 H 0 0 0 0 0 0 0 0 0 0 0 0 -0.5474 1.5497 0.2804 C 0 0 0 0 0 0 0 0 0 0 0 0 0.0941 2.3852 -0.0159 H 0 0 0 0 0 0 0 0 0 0 0 0 -1.5711 1.7973 -0.0165 H 0 0 0 0 0 0 0 0 0 0 0 0 -0.5121 1.4486 1.3712 H 0 0 0 0 0 0 0 0 0 0 0 0 1 6 1 0 0 0 0 1 10 1 0 0 0 0 1 2 1 0 0 0 0 2 5 1 0 0 0 0 3 2 1 0 0 0 0 4 2 1 0 0 0 0 6 9 1 0 0 0 0 7 6 1 0 0 0 0 8 6 1 0 0 0 0 10 13 1 0 0 0 0 11 10 1 0 0 0 0 12 10 1 0 0 0 0 </inlineContents> </jmolApplet> </jmol>
The structure is then visualized with all explicitly defined bonds:
<jmol>
<jmolApplet> <inlineContents>
1
OpenBabel06141312083D
13 12 0 0 0 0 0 0 0 0999 V2000 0.0001 0.0000 -0.6042 P 0 0 0 0 0 0 0 0 0 0 0 0 1.6159 -0.3009 0.2804 C 0 0 0 0 0 0 0 0 0 0 0 0 2.0189 -1.2740 -0.0163 H 0 0 0 0 0 0 0 0 0 0 0 0 2.3421 0.4621 -0.0161 H 0 0 0 0 0 0 0 0 0 0 0 0 1.5107 -0.2814 1.3713 H 0 0 0 0 0 0 0 0 0 0 0 0 -1.0685 -1.2489 0.2803 C 0 0 0 0 0 0 0 0 0 0 0 0 -2.1129 -1.1107 -0.0158 H 0 0 0 0 0 0 0 0 0 0 0 0 -0.7715 -2.2593 -0.0167 H 0 0 0 0 0 0 0 0 0 0 0 0 -0.9986 -1.1680 1.3712 H 0 0 0 0 0 0 0 0 0 0 0 0 -0.5474 1.5497 0.2804 C 0 0 0 0 0 0 0 0 0 0 0 0 0.0941 2.3852 -0.0159 H 0 0 0 0 0 0 0 0 0 0 0 0 -1.5711 1.7973 -0.0165 H 0 0 0 0 0 0 0 0 0 0 0 0 -0.5121 1.4486 1.3712 H 0 0 0 0 0 0 0 0 0 0 0 0 1 6 1 0 0 0 0 1 10 1 0 0 0 0 1 2 1 0 0 0 0 2 5 1 0 0 0 0 3 2 1 0 0 0 0 4 2 1 0 0 0 0 6 9 1 0 0 0 0 7 6 1 0 0 0 0 8 6 1 0 0 0 0 10 13 1 0 0 0 0 11 10 1 0 0 0 0 12 10 1 0 0 0 0 </inlineContents> </jmolApplet>
</jmol> Conversion from XYZ to MOL format can be easily done by using the OpenBabel program:
$ babel file.xyz file.mol
Participating in discussion
Each article has a dedicated discussion page where you can ask questions, find more information on the topic and talk to other people. More information about discussion pages is on MediaWiki site.
Bibliography
MolWiki.org has a central repository for references. You can find it in Special:SpecialPages in category BibManager. Whenever you want to cite an article check first the repository if it contains already the corresponding entry. If not, then you have to add a new entry manually or import it as BibTeX string automatically. Note, that only registered users can add new or edit existing entries. Each entry has its own unique id called Citation, which is then used for making automatic references in articles of MolWiki.org. This id should be defined manually upon creation of a new entry. The ids are written as a composition of the name of first author of an article, the capital letters of journal (or book, ...) name and the year of publication. For example BergerZFN2009. More examples can be found in overview of BibManager entries.
When you want to cite a paper in text use bib tag as in example:
<bib id="BergerZFN2009" />
which automatically produces a link like <bib id="BergerZFN2009" />.