def body():
from . import ScoreWizard
d = {}
action = ScoreWizard.instances()[0].actionCollection.scorewiz
d['key'] = help.shortcut(action)
d['menu'] = help.menu(_("menu title", "Tools"), _("Setup New Score..."))
return _("""\
<p>
The Score Setup Wizard ({key}) in {menu} is designed
to quickly setup a LilyPond music score.
</p>
<p>
In the first tab, <em>Titles and Headers</em>, you can enter titling
information.
</p>
<p>
In the second tab, <em>Parts</em>, you can compose your score out of many
available part types.
Doubleclick a part type to add it to your score (or click Add).
Select the part in the score list to change some settings for the selected part,
if desired.
Many parts, especially Choir, have powerful options to set up the score the way
you want it.
</p>
<p>
In the third tab, <em>Score settings</em>, global score properties and
preferences can be set.
</p>
<p>
Click the Preview button to get a preview with some example music filled in.
Click OK to copy the generated LilyPond source text to the editor.
</p>
<h3>Multiple pieces or movements</h3>
<p>
A special and powerful feature of the <em>Parts</em> tab is hidden in the
"Containers" category in the part types list.
</p>
<p>
This category contains the Score, Book and Bookpart types, with which you
can setup a LilyPond document containing multiple scores or even books.
You may add Score, Bookpart or Book entries to the score view.
They can be nested: a Score can be added to a Bookpart or Book but you can't
add a Book to a Bookpart or a Score.
</p>
<p>
Then you can add musical parts.
If you want to create multiple scores with exact the same parts, you can just
add the parts to the top level of the score view, and then the scores, without
adding musical parts to the scores.
The scores will then use the parts in the top level of the score.
</p>
""").format(**d)
def body():
import panelmanager
ac = panelmanager.PanelManager.instances()[0].snippettool.actionCollection
key_snippets = help.shortcut(ac.snippettool_activate)
return _("""\
<p>
With the snippets manager you can store often used pieces of text called
"snippets", and easily paste them into the text editor.
</p>
<p>
The snippets manager can be activated via the menu {menu_snippets} or
by pressing {key_snippets}.
</p>
<p>
Snippets can be searched by browsing the list or by typing some characters
in the search entry.
Snippets can also have keyboard shortcuts applied to them.
Some snippets have a special mnemonic (short name) which you can also type
in the search entry to select the snippet. Pressing the Return key will then
apply the snippet to the text editor and hide the snippets manager.
</p>
<p>
Add new snippets using {key_add}. Edit the selected snippet with {key_edit}.
Remove selected snippets using {key_delete}. Warning: this cannot be undone!
</p>
<p>
Snippets can also be put in the menu (see {link}).
And finally, there are snippets which can include or alter selected text.
Some snippets do this by using special variables, while others are small
scripts written in Python.
</p>
""").format(link = edit.snippet_edit_help.link(),
menu_snippets = help.menu(_("menu title", "Insert"), _("Snippets...")),
key_snippets = key_snippets,
key_add = help.shortcut(QKeySequence(Qt.Key_Insert)),
key_edit = help.shortcut(QKeySequence(Qt.Key_F2)),
key_delete = help.shortcut(QKeySequence(Qt.CTRL + Qt.Key_Delete)))
def body():
import lyrics
ac = lyrics.Lyrics.instances()[0].actionCollection
d = {
'hyphen': "<code> -- </code>",
'example': "<code>a -- men</code>",
'key_hyphen': help.shortcut(ac.lyrics_hyphenate),
'menu_hyphen': help.menu(_("menu title", "Tools"), _("Lyrics")),
'menu_settings': help.menu(_("menu title", "Edit"), _("Preferences")),
}
return _("""\
<p>
Frescobaldi can automatically place hyphens '{hyphen}' inside texts to make
those texts usable as lyrics.
It can use hyphenation dictionaries of OpenOffice.org, Scribus, etc.
</p>
<p>
To use this feature you must first select the text you want to hyphenate. Then
press {key_hyphen} or choose {menu_hyphen}.
In the dialog that appears, select the language.
Click OK or press Enter to have the hyphenation take place.
</p>
<p>
A small limitation is that word processor hyphenation dictionaries often don't
want to break a word right after the first letter (e.g. '{example}'), because that
does not look nice in word processor texts. So it can happen that you
have to add some hyphens after the first letter of such lyrics.
</p>
<p>
There is also a command to remove hyphenation. This can be useful if you have a
stanza of lyrics that you just want to display as a markup below the music.
Under {menu_settings} you can enter a list of directories to search for
hyphenation pattern files.
</p>
""").format(**d)
