User:רנדום/CiteNG

The CiteNG extension provides advanced citation capabilities, extending those provided by the Cite extension, and is fully compatible with it.

Basic Usage Example
As said above, CiteNG is fully compatible with Cite.

Pointer
A pointer is a tag that points to a named definition. Editors place pointers in the article to cite or reference a source. A pointer is created by placing the   tag anywhere in the text. A pointer tag must specify the name attribute, and must not have a tag body (i.e. ). A pointer tag with no name or empty name attribute generates an error; a pointer tag with a tag body becomes an Inline Definition.

A pointer tag is rendered for display with a Pointer Rendering Template. The default rendering template replaces the original tag with a super-script numeric label (i.e. [ 1 ]) that links to the named definition. If a rendering template isn't specified, it is inherited from the definition to which this pointer points to.

Syntax
Example:

 

Definition

 * Named Definition
 * Anonymous Definition
 * Typed Definition
 * Inline Definition
 * Group
 * Pointer Rendering Template
 * Definition Rendering Template
 * Group Rendering Template
 * Style

Group

 * reference
 * group
 * pointer-renderer
 * definition-renderer
 * group-renderer
 * style

Syntax 1
The Moon is Earth's only natural satellite and is the fifth largest satellite in the Solar System. It is the largest moon in the Solar System relative to the size of its planet, a quarter the diameter of Earth and 1/81 its mass, and is the second densest satellite after Io. It is in synchronous rotation with Earth, always showing the same face; the near side is marked with dark volcanic maria among the bright ancient crustal highlands and prominent impact craters.



Syntax 2
The Moon is Earth's only natural satellite and is the fifth largest satellite in the Solar System. It is the largest moon in the Solar System relative to the size of its planet, a quarter the diameter of Earth and 1/81 its mass, and is the second densest satellite after Io. It is in synchronous rotation with Earth, always showing the same face; the near side is marked with dark volcanic maria among the bright ancient crustal highlands and prominent impact craters.



Syntax 3
The Moon is Earth's only natural satellite and is the fifth largest satellite in the Solar System. It is the largest moon in the Solar System relative to the size of its planet, a quarter the diameter of Earth and 1/81 its mass, and is the second densest satellite after Io. It is in synchronous rotation with Earth, always showing the same face; the near side is marked with dark volcanic maria among the bright ancient crustal highlands and prominent impact craters.



Zbale
In CiteNG, a Reference has two parts: the Reference Definition and zero or more Reference Pointers. A reference definition describes a previously published work, and is usually placed within a Definition Group, at the foot of the article. A reference pointer is placed within the article body, and is used to point to a reference definition.

Reference Definition
Technically speaking, a reference definition has three main properties:

In-place and Out-of-place Definition
An in-place definition is a reference definition that is placed somewhere within the article text

In this style, the reference is declared within the article body. This style is easy to use, but makes it hard to maintain the declarations, as they are scattered in the text in no particular order. When the article is rendered, the declaration is considered as if it was declared within a named Reference Declaration Block, matched by the group attribute. If a group attribute is not specified, it defaults to "_anonymous_". Likewise, an unnamed reference declaration block defaults to "_anonymous_".

For example, the following two styles are equivalent: {| class="wikitable" style="width:100%;" ! style="width:50%;" | Definition within the article ! Definition in a reference declaration block Blah ... ... blah blah
 * style="vertical-align:top;" |
 * style="vertical-align:top;" |

Reference Pointer
A Reference Pointer ("pointer" for short) is a tag that points to a named Reference Declaration. Editors place this tag in the article to cite a source. A pointer tag is rendered for display using a Rendering Template. The rendering template will usually replace the original tag with a link to the appropriate reference declaration, thus allowing the reader to view the source with a mouse click.

Syntax:

Short Syntax
For ease of use, the following additional short syntax is supported. Note that this syntax is only supported for reference pointers. In XML terms, is actually.

Syntax:

Reference Declaration
A Reference Declaration ("declaration" for short") is a tag that defines the content of a reference. Declarations can be placed anywhere in the text (in-place), but it's best if they are placed within a Reference Declaration Block. A declaration must be named for a pointer (or pointers) to point on it. Unnamed declarations cannot be pointed at by pointers. When a declaration is placed within the article, it can be grouped to a named reference declaration block, thus providing control on the location of the declaration within the rendered article. A declaration can optionally have a label, which is the human-readable name of the declaration. Usually, the Harvard Referencing format is used for labels (i.e., "Darwin 1846"), but any text will do. Reference declarations are rendered using a rendering template.

In-place Declarations
In this style, the reference is declared within the article body. This style is easy to use, but makes it hard to maintain the declarations, as they are scattered in the text in no particular order. When the article is rendered, the declaration is considered as if it was declared within a named Reference Declaration Block, matched by the group attribute. If a group attribute is not specified, it defaults to "_anonymous_". Likewise, an unnamed reference declaration block defaults to "_anonymous_".

For example, the following two styles are equivalent: {| class="wikitable" style="width:100%;" ! style="width:50%;" | Definition within the article ! Definition in a reference declaration block Blah ... ... blah blah
 * style="vertical-align:top;" |
 * style="vertical-align:top;" |

Named Declaration
Syntax: Blah ... ... blah blah

Unnamed Declaration
Syntax: Blah ... ... blah blah

Pointer Renderer
A Pointer Renderer is a template that transforms a Reference Pointer tag (i.e., ) to wiki markup text. Several such templates are provided, each generates a different wiki text. The following table lists the parameters that are set when this template is invoked:

Template:Ref:Pointer:LabelRenderer
 |

Template:Ref:Pointer:SupIndexRenderer
 |&lt;nowiki&gt;[&lt;/nowiki&gt;&lt;nowiki&gt;]&lt;/nowiki&gt;

Template:Ref:Pointer:SupIndexedLabelRenderer
 |&lt;nowiki&gt;[&lt;/nowiki&gt; &lt;nowiki&gt;]&lt;/nowiki&gt;

Declaration Renderer
A Declaration Renderer is a template that transforms a Reference Declaration tag (i.e., blah blah ) to wiki markup text. This template is called at least once for every declaration. If more than one reference pointers point to a declaration, this template is called once for each pointer, usually linking the declaration to each of its pointers. The following table lists the parameters that are set when this template is invoked:

Template:Ref:Declaration:DefaultRenderer
.&amp;nbsp;

Notes, Citations and References
Java is a programming language originally developed by Sun Microsystems and released in 1995 as a core component of Sun Microsystems' Java platform. The language derives much of its syntax from C and C++ but has a simpler object model and fewer low-level facilities. Java applications are typically compiled to bytecode that can run on any Java virtual machine (JVM) regardless of computer architecture. Sun's trademark license for usage of the Java brand insists that all implementations be "compatible".