Help:Standard article: Difference between revisions

From Hydrogenaudio Knowledgebase
No edit summary
No edit summary
Line 1: Line 1:
<!-- This is a standard article guideline. Please use it for creating
<!-- This is a standard article guideline. Please use it for creating
articles in this wiki.-->
articles in this wiki.-->
{{stub}}
<font style="color:red; font-weight:bold;">This is a guideline. Please use it for creating articles in this wiki.</font>
<font style="color:red; font-weight:bold;">This is a guideline. Please use it for creating articles in this wiki.</font>


The aim of this guideline is to provide ways to standardize articles in this wiki. Every article should abide to the ''general'' structure below:
The aim of this guideline is to provide ways to standardize articles in this wiki. Every article should abide to the ''general'' structure below (in wiki code):


<pre>
<pre>
Line 41: Line 40:


'''Introduction'''<br />
'''Introduction'''<br />
Every article should start with a summary of the topic detailed in the article. This is the very first thing to be written before any section.
Every article should start with a ''summary of the topic'' detailed in the article. This is the very first thing to be written before any section.


''Example:''
''Example:''
Line 51: Line 50:


'''Lead sections'''<br />
'''Lead sections'''<br />
An article may have any number or lead sections. Within these sections you should put any relevant information about the section topic including pictures, media files, formulas etc.
An article may have any number or ''lead sections''. Within these sections you should put any relevant information about the section topic including pictures, media files, formulas etc.


''Example:''
''Example:''
Line 68: Line 67:
Musepack-MPC inside the various q-levels/presets and the --ms x switch.
Musepack-MPC inside the various q-levels/presets and the --ms x switch.
Vorbis in its presets, 1 example above q6 the "lossless stereo coupling".
Vorbis in its presets, 1 example above q6 the "lossless stereo coupling".
|}
'''Subsections'''<br />
Use subsections whenever necessary to make information easily readable.
''Example:''
{|style="padding: 3px;"|
|-
|style="border: 1px solid #DDDDDD; font-family:courier new;"|
<nowiki>==Recommended encoder settings==</nowiki>
This section describes the Hydrogenaudio recommended settings to be used with LAME for highest quality MP3 encoding.
These settings require LAME 3.94 or later. LAME 3.97beta3 is the recommended version.
Avoid using alpha (a) versions of LAME. More often than not those are exclusively for testing purposes. Use them only if you want to help developers with feedback.
(...)
<nowiki>===VBR (variable bitrate) settings===</nowiki>
<nowiki>'''[[VBR]]:''' ''variable bitrate mode. Use variable bitrate modes when the goal is to achieve a fixed level of quality using the lowest possible bitrate.''</nowiki>
VBR is best used to target a specific quality level, instead of a specific bitrate. The final file size of a VBR encode is less predictable than with ABR, but the quality is usually better.
|}
|}

Revision as of 02:03, 20 September 2006

This is a guideline. Please use it for creating articles in this wiki.

The aim of this guideline is to provide ways to standardize articles in this wiki. Every article should abide to the general structure below (in wiki code):

Introduction

==Lead section #1==
This is the lead section of the article.

===Subsection #1.1===
This is a subsection of the article.

====Subsection #1.2====
This is a sub-subsection of the article.

==Lead section #2==
This is the lead section of the article.

===Subsection #2.1===
This is a subsection of the article.

====Subsection #2.2====
This is a sub-subsection of the article.

==See also==
See also section.

==Notes and references==
Notes and references section.

==Further reading and bibliography==
Reading and bibliography section.

==External links==
External links section.

Introduction
Every article should start with a summary of the topic detailed in the article. This is the very first thing to be written before any section.

Example:

'''Joint stereo''' coding methods try to increase the coding efficiency when encoding stereo signals by exploiting commonalties between the left and right channel signal.

Lead sections
An article may have any number or lead sections. Within these sections you should put any relevant information about the section topic including pictures, media files, formulas etc.

Example:

==Additional information==

Some more details, history and examples about joint stereo & mid/side coding:

mid/side can be lossless like obviously in Lossless formats Flac, Wavpack, Monkey's Audio (ape) etc., but in lossy encoders the encoder tries to do the best to minimize all losses in perception. And here the encoder has not only to deal with stereo modes, but also with mids, highs etc. etc. So, regarding lossy formats like MP3 (Lame, Fraunhofer, Xing), Musepack (MPC), Vorbis etc., the mid/side coding might be even mathematical lossless, might be perceptual lossless (=transparent), or not so lossless at all at low bitrates. So, it depends in the lossy formats about the quality of mid/side (js) coding. From obvious bad sounding bugs like in some old Fraunhofer mp3 ("Radium hack"), not so optimized perfomance like in mp3-Xing, up to the optimized js-modes in mp3-Lame, which offer frame-dependent stereo or mid/side coding to achieve maximum qualities. And advanced formats like mp3-lame, Musepack-MPC or Vorbis-ogg offer increasing js(mid/side//stereo)qualities in increasing general quality (q) levels, examples: Mp3-Lame inside the presets eg. -V quality levels, with different -msfix values up to the "nssafejoint" mode in 320 kbit cbr. Musepack-MPC inside the various q-levels/presets and the --ms x switch. Vorbis in its presets, 1 example above q6 the "lossless stereo coupling".

Subsections
Use subsections whenever necessary to make information easily readable.

Example:

==Recommended encoder settings==

This section describes the Hydrogenaudio recommended settings to be used with LAME for highest quality MP3 encoding.

These settings require LAME 3.94 or later. LAME 3.97beta3 is the recommended version.

Avoid using alpha (a) versions of LAME. More often than not those are exclusively for testing purposes. Use them only if you want to help developers with feedback.

(...)

===VBR (variable bitrate) settings===

'''[[VBR]]:''' ''variable bitrate mode. Use variable bitrate modes when the goal is to achieve a fixed level of quality using the lowest possible bitrate.''

VBR is best used to target a specific quality level, instead of a specific bitrate. The final file size of a VBR encode is less predictable than with ABR, but the quality is usually better.