calibre - en to ja translation catalogue (36 entries)

en: Snippets
ja: スニペット

en: The calibre E-book editor supports *snippets*. A snippet is a piece of text that is either re-used often or contains a lot of redundant text. The editor allows you to insert a snippet with only a few key strokes. For example, suppose you often find yourself inserting link tags when editing HTML files, then you can simply type ``<a`` in the editor and press |ct|. The editor will expand it to::
ja: calibre の電子書籍エディタは *スニペット* をサポートしています。スニペットとは頻繁に再利用されたり冗長なテキストを多数含むテキストのひとつです。エディタを使用すると、ほんの数回のキーストロークだけでスニペットを挿入できます。たとえば HTML ファイルを編集しているときに頻繁にリンクタグを挿入しているとします。このとき ``<a`` とだけエディタに入力して |ct| を押します。するとエディタはそれを次のように展開します::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link.
ja: それだけでなくカーソルが置かれた状態で ``filename`` という単語が選択されるため、エディタの優れた自動補完機能を使って実際のファイル名を簡単に入力することができます。ファイル名の入力が終わったらもう一度 |ct| を押せばカーソルは ``<a>`` タグの間に移動するので、リンクのテキストを簡単に入力できます。テキストの入力が終わったら再び |ct| を押せば、タグを閉じた後の場所に移動します。

en: The snippets system in the editor is very sophisticated, there are a few built-in snippets and you can create your own to suit your editing style.
ja: エディタのスニペットシステムは非常に洗練されています。いくつかのビルトインスニペットがあり、編集スタイルに合わせて自分で作成することもできます。

en: The following discussion of the built-in snippets should help illustrate the power of the snippets system.
ja: ビルトインスニペットに関する以下の解説で、スニペットシステムがいかに強力であるかが明らかになるでしょう。

en: You can also use snippets in the text entry fields in the :guilabel:`Search & replace` panel, however, placeholders (using |ct| to jump around) will not work.
ja: スニペットは :guilabel:`検索 & 置換` パネルのエントリフィールドでも利用できますが、プレースホルダ (|ct| を使った移動) は機能しません。

en: The built-in snippets
ja: ビルトインスニペット

en: The built-in snippets are described below. Note that you can override them by creating your own snippets with the same trigger text.
ja: ビルトインのスニペットを以下に説明します。ただし同じトリガテキストを用いて自分でスニペットを作成することにより、上書きすることができます。

en: Inserting filler text [Lorem]
ja: フィラーテキストを挿入 [Lorem]

en: The first built-in snippet, and the simplest is used to insert filler text into a document. The filler text is taken from `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ a philosophical work by Cicero (translated to English). To use it simply type ``Lorem`` in an HTML file and press |ct|. It will be replaced by a couple of paragraphs of filler.
ja: 最初のスニペット、そしてもっとも単純なスニペットはドキュメントにフィラーテキストを挿入するのに使用されるものです。フィラーテキストにはキケロによる哲学的な作品である `De finibus bonorum et malorum <https://en.wikipedia.org/wiki/De_finibus_bonorum_et_malorum>`_ (英訳版) を使用します。これを使用するには HTML ファイルに ``Lorem`` とだけ入力して |ct| を押します。こうすると、いくつかの段落で置き換わります。

en: The definition of this snippet is very simple, the trigger text is defined as ``Lorem`` and the template is defined simply as the literal text to be inserted. You can easily customize it to use your favorite form of filler text.
ja: このスニペットの定義は非常に簡単で、トリガーテキストに ``Lorem`` を定義し、テンプレートにはただ単に挿入される直訳テキストだけが定義されています。好みのフィラーテキストを使うよう、簡単にカスタマイズ可能です。

en: Inserting a self-closing HTML tag [<>]
ja: HTML の自己終了タグを挿入 [<>]

en: Now let's look at a simple example of the powerful concept of *placeholders*. Say you want to insert the self-closing tag ``<hr/>``. Just type ``<>``, and press |ct|, the editor will expand the snippet to::
ja: では、強力な概念である *プレースホルダ* の簡単な例を見てみましょう。自己終了タグの ``<hr/>`` を挿入したいとします。``<>`` とだけ入力して |ct| を押せば、エディタはスニペットを次のように展開します::

en: Here, the ``|`` symbol represents the current cursor position. You can then type ``hr`` and press |ct| to move the cursor to after the end of the tag. This snippet is defined as::
ja: ここで、 ``|`` 記号が現在のカーソル位置を表します。次に `hr`` を入力してから |ct| を押すとカーソルがタグの終了位置の後ろに移動します。このスニペットは次のように定義されます::

en: Placeholders are simply the dollar ($) sign followed by a number. When the snippet is expanded by pressing |ct| the cursor is positioned at the first placeholder (the placeholder with the lowest number). When you press |ct| again the cursor jumps to the next placeholder (the placeholder with the next higher number).
ja: プレースホルダは、ドル記号 ($) の後ろに数字がついたものです。スニペットが |ct| を押すことにより展開されると、カーソルは最初のプレースホルダーの位置 (最も数字の小さいプレースホルダ) に移動します。再度 |ct| を押すとカーソルは次のプレースホルダ (その次に数字の小さいプレースホルダ) に移動します。

en: Inserting an HTML link tag [<a]
ja: HTML リンクタグを挿入 [<a]

en: HTML link tags all share a common structure. They have an ``href`` attribute and some text between the opening and closing tags. A snippet to make typing them more efficient will introduce us to some more features of placeholders. To use this snippet, simply type ``<a`` and press |ct|. The editor will expand this to::
ja: HTML のリンクタグはすべて同じ構造を共有しています。どれにも ``href`` 属性と、開始タグと終了タグの間にテキストがあります。それをもっと効率的に入力するためのスニペットで、プレースホルダの機能をいくつかさらに紹介します。このスニペットを使用するには、``<a`` とだけ入力してから |ct| を押します。エディタはこれを次のように展開します::

en: Not only that, the word ``filename`` will be selected, with the cursor placed over it, so that you can easily type in the real filename, using the editor's nifty :ref:`editor_auto_complete` feature. And once you are done typing the filename, press |ct| again and the cursor will jump to the position in between the ``<a>`` tags so you can easily type in the text for the link. After you are done typing the text, press |ct| again to jump to the point after the closing tag.  This snippet is defined as::
ja: それだけでなくカーソルが置かれた状態で ``filename`` という単語が選択されるため、エディタの優れた自動補完機能を使って実際のファイル名を簡単に入力することができます。ファイル名の入力が終わったらもう一度 |ct| を押せばカーソルは ``<a>`` タグの間に移動するので、リンクのテキストを簡単に入力できます。テキストの入力が終わったら再び |ct| を押せば、タグを閉じた後の場所に移動します。このスニペットは次のように定義します::

en: There are a couple of new features here. First the ``$1`` placeholder has become more complex. It now includes some *default text* (the word ``filename``). If a placeholder contains default text, the default text is substituted for the placeholder when the snippet is expanded. Also when you jump to a placeholder with default text using |ct|, the default text is selected. In this way, you can use default text to act as a reminder to you to fill in important parts of the template. You can specify default text for a placeholder by using the syntax: ``${<number>:default text}``.
ja: いくつか新しい機能が出てきました。まず ``$1`` がより複雑になりました。ここではデフォルトのテキスト (``filename`` という単語) を含んでいます。プレイスホルダがデフォルトのテキストを含むとき、スニペットが展開されるときにそのデフォルトテキストが使用されます。また、デフォルトテキストのまま |ct| で使って移動すると、デフォルトテキストが選択されます。テンプレートの重要な部分を埋めるときには、このようにすればデフォルトテキストをリマインダーとして利用するすることが可能です。プレースホルダのデフォルトテキストは次の構文で指定できます: ``${<number>:default text}``

en: The other new feature is that the second placeholder has an asterisk after it (``${2*}``). This means that any text that was selected before expanding the template is substituted for the placeholder. To see this in action, select some text in the editor, press |ct|, type ``<a`` and press |ct| again, the template will be expanded to::
ja: もうひとつの新しい機能は、2 番目のプレースホルダの後ろにアスタ理数がついていること (``${2*}``) です。これはテンプレートを展開する前に選択されていたテキストがプレースホルダに使用されることを意味します。この動作を見てみるには、エディタの中で何かテキストを選択し、|ct| を押してから ``<a`` と入力し、もう一度 |ct| を押します。するとテンプレートは次のように展開されます::

en: Inserting a HTML image tag [<i]
ja: HTML 画像タグを挿入 [<i]

en: This is very similar to inserting an HTML link, as we saw above. It allows you to quickly input an ``<img src="filename" alt="description" />`` tag and jump between the ``src`` and ``alt`` attributes::
ja: これは上で説明した HTML リンクの挿入と非常によく似ています。これにより ``<img src="filename" alt="description" />`` タグを簡単に入力し、``src`` および ``alt`` 属性の間に飛びます::

en: Insert an arbitrary HTML tag [<<]
ja: 任意の HTML タグを挿入 [<<]

en: This allows you to insert an arbitrary full HTML tag (or wrap previously selected text in the tag). To use it, simply type ``<<`` and press |ct|. The editor will expand it to::
ja: これにより任意の HTML タグを挿入できます (または以前選択したテキストをタグで囲みます)。これを使うには、``<<`` と入力してから |ct| を押してください。エディタが次のように展開します::

en: Type the tag name, for example: ``span`` and press |ct|, that will result in::
ja: タグ名、たとえば ``span`` を入力してから |ct| を押すと、次のようになります::

en: You will note that the closing tag has been automatically filled with ``span``. This is achieved with yet another feature of placeholders, *mirroring*. Mirroring simply means that if you specify the sample placeholder more than once in a template, the second and all later positions will be automatically filled in with whatever you type in the first position, when you press |ct|. The definition for this snippet is::
ja: 終了タグが自動的に ``span`` となったことにお気づきでしょう。これはプレースホルダのさらに別の機能である *ミラーリング* により実現されます。ミラーリングは、サンプルのプレースホルダをテンプレート中で複数回指定したとき、2 回目以降の位置は |ct| を押したときに自動的に最初に入力したもので埋められることを意味します。このスニペットの定義は次のようになります::

en: As you can see, the first placeholder ($1) has been specified twice, the second time in the closing tag, which will simply copy whatever you type in the opening tag.
ja: ご覧のとおり、最初のプレースホルダ ($1) は 2 回指定されており、2 回目は終了タグの中で指定されているため、開始タグに入力したものがそのままコピーされます。

en: Inserting an arbitrary HTML tag with a class attribute [<c]
ja: クラス属性つきの任意の HTML タグを挿入 [<c]

en: This is very similar to the insert arbitrary tag example above, except that it assumes that you want to specify a class for the tag::
ja: これは任意のタグを挿入する上記の例と非常によく似ていますが、タグにクラスを指定することを前提としている点が異なります::

en: This will allow you to first type the tag name, press |ct|, type the class name, press |ct| type the contents of the tag and press |ct| one last time to jump out of the tag. The closing tag will be auto-filled.
ja: これにより最初にタグ名を入力し、|ct| を押し、クラス名を入力し、|ct| を押してタグの内容を入力し、最後にもう一度 |ct| を押してタグの外側に移動します。終了タグは自動で入力されます。

en: Creating your own snippets
ja: スニペットを作成

en: Snippets really shine because you can create your own to suit your editing style. To create your own snippets go to :guilabel:`Edit->Preferences->Editor settings->Manage snippets` in the editor. This will pop-up an easy to use dialog to help you create your own snippets. Simply click the :guilabel:`Add snippet` button and you will see a dialog that looks like:
ja: スニペットは非常に優れていて、編集スタイルに合わせて独自のものを作成できます。自分のスニペットを作成するにはエディタの :guilabel:`編集->環境設定->エディタ設定->スニペットの管理` へ行きます。これにより使いやすいダイアログがポップアップ表示され、自分のスニペットを作れます。:guilabel:`スニペットを追加` ボタンをクリックすると、次のようなダイアログが表示されます:

en: The create your own snippets tool
ja: 自分のスニペットツールを作成

en: First give your snippet a name, something descriptive, to help identify the snippet in the future. Then specify the *trigger*. A trigger is simply the text that you have to type in the editor before pressing |ct| in order to expand the snippet.
ja: まずスニペットの名前を入力します。後で何のスニペットか識別しやすいよう、わかりやすい名前をつけましょう。次に *トリガ* を指定します。トリガは、スニペットを展開するために |ct| を押す前に入力する必要のあるテキストのことです。

en: Then specify the snippet template. You should start with one of the examples above and modify it to suit your needs. Finally, specify which file types you want the snippet to be active for. This way you can have multiple snippets with the same trigger text that work differently in different file types.
ja: 次にスニペットのテンプレートを指定します。上記の例を必要に応じて変更することから始めるとよいでしょう。最後にスニペットを有効にしたいファイルタイプを指定します。このようにすることで、ファイルタイプごとに同じトリガで違う動作をするスニペットを作成できます。

en: The next step is to test your newly created snippet. Use the :guilabel:`Test` box at the bottom. Type in the trigger text and press |ct| to expand the snippet and jump between placeholders.
ja: 次のステップは新しく作成したスニペットをテストすることです。下部にある :guilabel:`テスト` ボックスを利用してください。トリガテキストを入力してから |ct| を押し、スニペットを展開してプレースホルダの間に移動します。
