Manifold Atlas:References

Revision as of 10:25, 11 August 2010

1 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.

2 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 ${{DISPLAYTITLE:{{NAMESPACE}}: {{PAGENAME}}}} <!--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 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 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 == *To '''cite''' a document simply type <tt><nowiki>\cite{Author&...&AuthorYear}</nowiki></tt> or equivalently <tt>&#92;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: <wikitex><blockquote>The group of homotopy $n$-spheres is finite for $n \neq 3$ {{cite|Kervaire&Milnor1963}}.</blockquote></wikitex> <pre style="white-space:normal;"> ... {{cite|Kervaire&Milnor1963}}. </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>Simply connected, smooth 5-dimensional h-cobordisms are homeomorphic to products \cite{Freedman1982|Theorem 1.3}. </blockquote></wikitex> <pre style="white-space:normal;"> ... &#92;cite{Freedman1982|Theorem 1.3}. </pre> === Open references === 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 tyep 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 [[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:}} </pre> === External links === You may also wish to add a section for '''External links''', e.g. [[Exotic spheres#External references|External links]]. * Please place the External links section immediately following the References section. * External links need to be added by hand in the usual way as links to [[Manifold Atlas:Wiki syntax#Hyper links#External links|external URLs]]. == 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]. * 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: **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 == * When creating a reference, please follow the conventions established by the following examples: [{{fullurl:Template:Kervaire&Milnor1963|action=edit}} journal article], [{{fullurl:Template:Moise1977|action=edit}} 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: <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 == {{#RefList:}}n$-spheres is finite for $n \neq 3$ [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}.

2.1 Open references

If you type a reference, e.g. {{cite|Milnor1957}} into a page containing the {{#RefList:}} command and the reference you tyep 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.

3 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:}}

3.1 External links

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 need to be added by hand in the usual way as links to external URLs.

4 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.

5 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>.

6 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.

7 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