Jump to content

Help:Contributing: Difference between revisions

From LilyPond wiki
No edit summary
Mention requirements for “official” snippets
 
(One intermediate revision by one other user not shown)
Line 6: Line 6:
Some explanatory text.
Some explanatory text.


<lilypond version="2.24.0">
<lilypond version="2.24">
{ c'^"a note!" }
{ c'^"a note!" }
</lilypond>
</lilypond>
Line 15: Line 15:
:: Some explanatory text.
:: Some explanatory text.
::
::
:: <lilypond version="2.24.0">
:: <lilypond version="2.24">
{ c'^"a note!" }
{ c'^"a note!" }
</lilypond>
</lilypond>
Line 22: Line 22:
First, describe what the snippet does and how to use it. Use [https://www.mediawiki.org/wiki/Help:Formatting wikitext markup] like <code><nowiki>''italic''</nowiki></code> for ''italic'', <code><nowiki>'''bold'''</nowiki></code> for '''bold''' and <code><nowiki><code>\command</code></nowiki></code> for <code>\command</code>.
First, describe what the snippet does and how to use it. Use [https://www.mediawiki.org/wiki/Help:Formatting wikitext markup] like <code><nowiki>''italic''</nowiki></code> for ''italic'', <code><nowiki>'''bold'''</nowiki></code> for '''bold''' and <code><nowiki><code>\command</code></nowiki></code> for <code>\command</code>.


The LilyPond snippet goes between <code><nowiki><lilypond version="..."></nowiki></code> and <code><nowiki></lilypond></nowiki></code>. The <code>version</code> parameter is the LilyPond version used to compile the snippet. A <code>\version</code> statement with this version will also be added automatically, so don't repeat it in the snippet code. You can use any LilyPond version (it will be automatically downloaded if needed), but you should generally use the latest stable LilyPond version, unless your snippet specifically requires a newer development version.
The LilyPond snippet goes between <code><nowiki><lilypond version="..."></nowiki></code> and <code><nowiki></lilypond></nowiki></code>.
 
The <code>version</code> parameter is the LilyPond version used to compile the snippet. A <code>\version</code> statement with this version will also be added automatically, so don't repeat it in the snippet code. In almost all cases, you should put the major and minor number of the latest stable release series of LilyPond, e.g., 2.24. This will automatically select the latest micro release in that series, e.g., 2.24.4. However, in case your example specifically requires a newer development version, you can put that specific version here, e.g., 2.25.27 (it will be automatically downloaded on the wiki if needed).


If you need to demonstrate page layout features, use the <code>full</code> keyword to prevent cropping, like this: <code><nowiki><lilypond version="..." full></nowiki></code>.
If you need to demonstrate page layout features, use the <code>full</code> keyword to prevent cropping, like this: <code><nowiki><lilypond version="..." full></nowiki></code>.
'''Please be careful while editing snippets that are tagged with the category “Included in the official documentation”!'''  There are special requirements so that they can be used seamlessly in LilyPond's documentation.  See [[:Category:Included in the official documentation]] for more information.

Latest revision as of 07:11, 10 December 2025

You can edit without an account, but this is encouraged if you do more than a handful of edits so that other editors can recognize you and discuss with you in case of need.

To create a new page, type the title in the search box, then click on the red link. A simple page can be structured as follows:

Some explanatory text.

<lilypond version="2.24">
{ c'^"a note!" }
</lilypond>

This renders like this:

Some explanatory text.
\version "2.24"

{ c'^"a note!" }


First, describe what the snippet does and how to use it. Use wikitext markup like ''italic'' for italic, '''bold''' for bold and <code>\command</code> for \command.

The LilyPond snippet goes between <lilypond version="..."> and </lilypond>.

The version parameter is the LilyPond version used to compile the snippet. A \version statement with this version will also be added automatically, so don't repeat it in the snippet code. In almost all cases, you should put the major and minor number of the latest stable release series of LilyPond, e.g., 2.24. This will automatically select the latest micro release in that series, e.g., 2.24.4. However, in case your example specifically requires a newer development version, you can put that specific version here, e.g., 2.25.27 (it will be automatically downloaded on the wiki if needed).

If you need to demonstrate page layout features, use the full keyword to prevent cropping, like this: <lilypond version="..." full>.

Please be careful while editing snippets that are tagged with the category “Included in the official documentation”! There are special requirements so that they can be used seamlessly in LilyPond's documentation. See Category:Included in the official documentation for more information.