Manifold Atlas:References
m (→External links section) |
|||
(47 intermediate revisions by one user not shown) | |||
Line 1: | Line 1: | ||
− | {{DISPLAYTITLE:{{NAMESPACE}}: {{PAGENAME}}}} | + | {{DISPLAYTITLE:{{NAMESPACE}}: {{PAGENAME}}}}<nonumbers/> |
<!--The wiki software does not provide a dedicated bibliography or reference sytem. As long as there is no simple and satisfying solution availble, we ask authors to adhere to the following steps in order to create references.--> | <!--The wiki software does not provide a dedicated bibliography or reference sytem. As long as there is no simple and satisfying solution availble, we ask authors to adhere to the following steps in order to create references.--> | ||
<!--The atlas does not yet provide a dedicated bibliography. For the present we ask authors to create references as follows.--> | <!--The atlas does not yet provide a dedicated bibliography. For the present we ask authors to create references as follows.--> | ||
− | == The | + | == The bibliography == |
− | + | If the reference you need is already in the [[Manifold Atlas:Bibliography|bibliography]] then you can simply [[Manifold Atlas:References#Citing references|cite it]] as explained below. | |
− | * If | + | |
+ | If you need to create a new reference there are two possibilities. | ||
+ | * If the work to be referred to is reviewed at either [http://ams.mpim-bonn.mpg.de/mathscinet/search.html MathSciNet] or [http://www.zentralblatt-math.org/zmath/ Zentralblat] or if it is stored on the [http://de.arxiv.org/multi?group=math&%2Ffind=Search arXiv] then you can [http://manifoldatlas.uni-bonn.de/converter create the reference automatically]. | ||
+ | * In general you can create a reference by hand starting from the create box at the top of the [[Manifold Atlas:Bibliography|Biblography page]]: | ||
+ | ** in this case please read the [[Manifold Atlas:References#Bibliographic conventions|bibliographic conventions]] below. | ||
== Citing references == | == Citing references == | ||
− | + | To '''cite''' a document simply type either of the following equivalent commands: | |
− | * The convention for citation names in the Manifold Atlas is: | + | * <tt><nowiki>\cite{Author&...&AuthorYear}</nowiki></tt> |
− | + | * <tt><nowiki>\cite{Author&...&AuthorYear}</nowiki></tt> | |
− | + | ||
+ | The convention for '''citation names''' in the Manifold Atlas is: | ||
+ | * '''full author family names''' separated by '''&''' and followed by the '''date of publication'''. | ||
+ | |||
+ | An example citation with generating text is: | ||
<wikitex><blockquote>The group of homotopy $n$-spheres is finite for $n \neq 3$ {{cite|Kervaire&Milnor1963}}.</blockquote></wikitex> | <wikitex><blockquote>The group of homotopy $n$-spheres is finite for $n \neq 3$ {{cite|Kervaire&Milnor1963}}.</blockquote></wikitex> | ||
<pre style="white-space:normal;"> | <pre style="white-space:normal;"> | ||
− | + | ... {{cite|Kervaire&Milnor1963}}. | |
</pre> | </pre> | ||
+ | <!--The group of homotopy $n$-spheres is finite for $n \neq 3$--> | ||
− | + | To refer to a specific part of a source type <tt><nowiki>{{cite|reference|part}}</nowiki></tt>. For example: | |
− | <wikitex><blockquote> | + | <wikitex><blockquote>Simply connected, smooth 5-dimensional h-cobordisms are homeomorphic to products \cite{Freedman1982|Theorem 1.3}. </blockquote></wikitex> |
<pre style="white-space:normal;"> | <pre style="white-space:normal;"> | ||
− | + | ... \cite{Freedman1982|Theorem 1.3}. | |
</pre> | </pre> | ||
+ | === Direct citing === | ||
+ | If you wish to directly cite a reference without adding it to the reference section or in a context where there is no reference section using the following: | ||
+ | * <tt><nowiki>{{citeD|Milnor1956}}</nowiki></tt> creates the following link {{CiteD|Milnor1956}} | ||
+ | * <tt><nowiki>{{citeD|Milnor1956|Your choice of link text}}</nowiki></tt> creates the following link {{citeD|Milnor1956|Your choice of link text}} | ||
+ | In both case, the reference is added to the reference section. | ||
− | == | + | === Open references === |
− | * The reference | + | If you type a reference, e.g. <tt><nowiki>{{cite|Milnor1957}}</nowiki></tt> into a page containing the <tt><nowiki>{{#RefList:}}</nowiki></tt> command and the reference you type is not in the bibliography into a page containing the command then the following occurs. |
− | <pre | + | * The reference will appear as a blue link in your text '''and''' |
− | + | * The reference will appear as an [[Manifold Atlas:Wiki syntax#Hyperlinks#open link|open link]] in the Reference section: | |
+ | ** if you do not have time to create a reference, this is acceptable Atlas-practice for referencing in the short-term provided the reference name is correctly formed. | ||
+ | |||
+ | == The Reference section == | ||
+ | * All pages which cite references should finish with a section entitled '''References'''. | ||
+ | * It is best to generate the reference list automatically : simply place the following command as the sole text in the Reference section: | ||
+ | <pre style="white-space:normal;"> | ||
{{#RefList:}} | {{#RefList:}} | ||
+ | </pre> | ||
+ | == External links section == | ||
+ | You may also wish to add a section for '''External links''', e.g. [[Exotic spheres#External links|External links]]. | ||
+ | * Please place the External links section immediately following the References section. | ||
+ | * External links to most web-sites need be added by hand in the usual way as links to [[Manifold Atlas:Wiki syntax#Hyper links#External links|external URLs]]. | ||
+ | * For external links to the [http://www.encyclopediaofmath.org/index.php/Main_Page Encyclopedia of Mathematics] and [[Wikipedia:Main page|Wikipedia]] please use the following standard forms | ||
+ | <pre> | ||
+ | * The Encylopedia of Mathematics article on | ||
+ | [http://www.encyclopediaofmath.org/index.php/Page_name link text] | ||
+ | * The Wikipedia page about [[Wikipedia:Page_name|link text]] | ||
+ | </pre> | ||
+ | * If you do externally link to a Wikipedia page, please also consider editing the Wikipedia page by adding a link to the Atlas page in the External links section of the Wikipedia page. A standard form follows: | ||
+ | <pre> | ||
+ | == External links == | ||
+ | ... | ||
+ | *[http://www.map.mpim-bonn.mpg.de/Page_name link text] at the Manifold Atlas | ||
</pre> | </pre> | ||
== Creating new references == | == Creating new references == | ||
− | * | + | * If the document for the reference is reviewed on [http://ams.mpim-bonn.mpg.de/mathscinet/ MathSciNet] or stored on [http://de.arxiv.org/ the arXiv] then you can generate a reference to it [http://manifoldatlas.uni-bonn.de/converter automatically]. |
− | * Type the author names(s) followed by the publication year of the article into the box: e.g. '''Freedman1982''' or '''Kervaire&Milnor1963'''. | + | * You can create new references by hand in the box at the top of the [[Manifold Atlas:Bibliography|bibliography page]]: |
− | + | ** Type the author names(s) followed by the publication year of the article into the box: | |
− | * You will arrive at a new template page for the reference: follow the instructions in the template using the [[Manifold Atlas:References#Bibilographic conventions|conventions]] below. | + | **e.g. '''Freedman1982''' or '''Kervaire&Milnor1963'''. |
+ | ** You will arrive at a new template page for the reference: follow the instructions in the template using the [[Manifold Atlas:References#Bibilographic conventions|conventions]] below. | ||
== Bibliographic conventions == | == Bibliographic conventions == | ||
Line 40: | Line 77: | ||
* In particular, if a reference is available online please hyperlink the title of the reference to its online source. | * In particular, if a reference is available online please hyperlink the title of the reference to its online source. | ||
+ | |||
+ | * Make sure that the source-code for the reference concludes with the text: <tt><nowiki><noinclude>[[Category:Bibliography]]</noinclude></nowiki></tt>. | ||
+ | |||
+ | == Writing about references == | ||
+ | Each reference lives on its own template page. This page can contain further mathematical comments on the work cited: | ||
+ | * ensure that further writing appears inside the command <tt><nowiki><noinclude> ... </noinclude></nowiki></tt>: | ||
+ | * see for example [[Template:Davis&Pearson2003|Davis&Pearson2003]]. | ||
+ | There is also a discussion page if you wish to make less formal points about the work or to open a discussion about the work. | ||
+ | |||
+ | If you know of corrections to statements in a work, please create a section | ||
+ | * <nowiki> == Corrections == </nowiki> | ||
+ | and add your corrections. Where possible give references to the literature for corrections and '''only include corrections of which you are 100% certain'''. If you are unsure about a point, raise it in a Comments section or on the discussion page. | ||
+ | |||
+ | Please '''sign your correction''' by adding <nowiki>~~~~</nowiki> on a seperate line at the end of your correction. | ||
+ | * see for example [[Template:Davis&Pearson2003|Davis&Pearson2003]]. | ||
+ | |||
+ | If you wish to make some general comments on the work cited, please create a section | ||
+ | * <nowiki> == Comments == </nowiki> | ||
+ | and make your comments. | ||
== References == | == References == | ||
{{#RefList:}} | {{#RefList:}} |
Latest revision as of 18:06, 12 March 2013
Contents |
The bibliography
If the reference you need is already in the bibliography then you can simply cite it as explained below.
If you need to create a new reference there are two possibilities.
- If the work to be referred to is reviewed at either MathSciNet or Zentralblat or if it is stored on the arXiv then you can create the reference automatically.
- In general you can create a reference by hand starting from the create box at the top of the Biblography page:
- in this case please read the bibliographic conventions below.
Citing references
To cite a document simply type either of the following equivalent commands:
- {{cite|Author&...&AuthorYear}}
- \cite{Author&...&AuthorYear}
The convention for citation names in the Manifold Atlas is:
- full author family names separated by & and followed by the date of publication.
An example citation with generating text is:
The group of homotopy -spheres is finite for [Kervaire&Milnor1963].
... {{cite|Kervaire&Milnor1963}}.
To refer to a specific part of a source type {{cite|reference|part}}. For example:
Simply connected, smooth 5-dimensional h-cobordisms are homeomorphic to products [Freedman1982, Theorem 1.3].
... {{cite|Freedman1982|Theorem 1.3}}.
Direct citing
If you wish to directly cite a reference without adding it to the reference section or in a context where there is no reference section using the following:
- {{citeD|Milnor1956}} creates the following link [Milnor1956]
- {{citeD|Milnor1956|Your choice of link text}} creates the following link [Milnor1956, Your choice of link text]
In both case, the reference is added to the reference section.
Open references
If you type a reference, e.g. {{cite|Milnor1957}} into a page containing the {{#RefList:}} command and the reference you type is not in the bibliography into a page containing the command then the following occurs.
- The reference will appear as a blue link in your text and
- The reference will appear as an open link in the Reference section:
- if you do not have time to create a reference, this is acceptable Atlas-practice for referencing in the short-term provided the reference name is correctly formed.
The Reference section
- All pages which cite references should finish with a section entitled References.
- It is best to generate the reference list automatically : simply place the following command as the sole text in the Reference section:
{{#RefList:}}
External links section
You may also wish to add a section for External links, e.g. External links.
- Please place the External links section immediately following the References section.
- External links to most web-sites need be added by hand in the usual way as links to external URLs.
- For external links to the Encyclopedia of Mathematics and Wikipedia please use the following standard forms
* The Encylopedia of Mathematics article on [http://www.encyclopediaofmath.org/index.php/Page_name link text] * The Wikipedia page about [[Wikipedia:Page_name|link text]]
- If you do externally link to a Wikipedia page, please also consider editing the Wikipedia page by adding a link to the Atlas page in the External links section of the Wikipedia page. A standard form follows:
==<sectioncount/> External links == ... *[http://www.map.mpim-bonn.mpg.de/Page_name link text] at the Manifold Atlas
Creating new references
- If the document for the reference is reviewed on MathSciNet or stored on the arXiv then you can generate a reference to it automatically.
- You can create new references by hand in the box at the top of the bibliography page:
- Type the author names(s) followed by the publication year of the article into the box:
- e.g. Freedman1982 or Kervaire&Milnor1963.
- You will arrive at a new template page for the reference: follow the instructions in the template using the conventions below.
Bibliographic conventions
- When creating a reference, please follow the conventions established by the following examples: journal article, book.
- In particular, if a reference is available online please hyperlink the title of the reference to its online source.
- Make sure that the source-code for the reference concludes with the text: <noinclude>[[Category:Bibliography]]</noinclude>.
Writing about references
Each reference lives on its own template page. This page can contain further mathematical comments on the work cited:
- ensure that further writing appears inside the command <noinclude> ... </noinclude>:
- see for example Davis&Pearson2003.
There is also a discussion page if you wish to make less formal points about the work or to open a discussion about the work.
If you know of corrections to statements in a work, please create a section
- == Corrections ==
and add your corrections. Where possible give references to the literature for corrections and only include corrections of which you are 100% certain. If you are unsure about a point, raise it in a Comments section or on the discussion page.
Please sign your correction by adding ~~~~ on a seperate line at the end of your correction.
- see for example Davis&Pearson2003.
If you wish to make some general comments on the work cited, please create a section
- == Comments ==
and make your comments.
References
- [Freedman1982] M. H. Freedman, The topology of four-dimensional manifolds, J. Differential Geom. 17 (1982), no.3, 357–453. MR679066 (84b:57006) Zbl 0528.57011
- [Kervaire&Milnor1963] M. A. Kervaire and J. W. Milnor, Groups of homotopy spheres. I, Ann. of Math. (2) 77 (1963), 504–537. MR0148075 (26 #5584) Zbl 0115.40505