Manifold Atlas:References

Revision as of 15:39, 26 March 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 {{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 not, you can [[Manifold Atlas:Bibliography|create a new reference]] at the bibliography page as explained [[Manifold Atlas:References#Creating new references|below]]. == Citing references == *To '''cite''' a document simply type <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> <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;"> ... \cite{Freedman1982|Theorem 1.3}. </pre> <!-- Simply connected, smooth 5-dimensional h-cobordisms are homeomorphic to products --> == The reference section == * The reference list is '''automatically generated'''. Please create a section entitlded '''References''' at the end of each page containing the following command <pre> {{#RefList:}} </pre> == Creating new references by hand == * 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. == 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 \cite{Adams1966}. 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 there is no reference, please give an argument for your correction. If you are unsure about a point, raise it in a Comments section or on the discussion page. 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 references

You may also wish to add a section for External references, e.g. External references.

• Please place the External references section immediately before the References section.
• External references need to be added by hand in the usual way as links to external URLs.

4 Creating new references

• You can create new references 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 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